100 free credits — no credit card required.Start building
Logo
Use case

Social listening API across every platform

Track a brand, product or topic everywhere people discuss it. One call fans out across social, forums, news and the open web, and every result comes back on the same schema.

/v1/search

One query, every source

  • GET /v1/search/everywhere
  • GET /v1/reddit/omni-search
  • GET /v1/twitter/ai-search
  • GET /v1/prism/brand-mentions

A social listening API lets you track every public mention of a brand, product or topic across social platforms, forums and news from a single request. SocialCrawl fans one query out across 46 platforms and returns ranked results on one shared schema, so you never write a separate integration per network.

What teams build with it

Every one of these is a shipped pattern, not a roadmap item. The endpoint chain under each card is the actual call sequence.

One query, every network

Send a keyword once and get ranked results from social, forums, news and the open web together. This is the call most listening products are built on, and it doubles as a router: run it first, see which source is hot, then drill into that platform directly.

Endpoint chainsearch/everywhere -> post -> comments

Deep Reddit mention sweeps

Boolean queries with cursor pagination, then the full comment tree on anything that matters. No Reddit OAuth to configure.

Endpoint chainreddit/omni-search -> reddit/post/comments

Grounded X search

Ask a question with date filters and handle include or exclude, and get an AI-grounded answer with the posts behind it.

Endpoint chaintwitter/ai-search -> twitter/tweet

Date-ranged mention tracking

Track one entity across networks over a window, grouped by day, so you can see the shape of a spike rather than just its size.

Endpoint chainprism/brand-mentions (date-ranged)

Threads and emerging networks

Search Threads with start and end dates. Useful where a market has moved off the older networks.

Endpoint chainthreads/search -> threads/post

News as one more lane

Localised news search with language and region controls, sitting beside the social lanes instead of in a separate tool.

Endpoint chaingoogle_news/search -> web/scrape

How the social listening API works

Four calls cover the whole job. Start broad, then go deep only where the first pass found something.

Reads are priced in credits. Empty result sets are not billed on list endpoints, and failed upstream calls are refunded automatically.

  1. GET /v1/search/everywhere

    Fan out across every source

    One query, a lookback window, and an optional source filter. Returns ranked results from social, forums, news and the web on one schema.

    flat rate per call
  2. GET /v1/reddit/omni-search

    Sweep Reddit properly

    Boolean operators and deep cursor pagination. This is where most long-form brand opinion actually lives.

    per page
  3. GET /v1/prism/brand-mentions

    Track the entity over time

    Pass a date range and optional daily grouping to turn scattered mentions into a time series.

    per call
  4. POST /v1/prism/comments

    Pull the comment tree

    Hand any post URL from any platform to one endpoint and get its comments and replies back on the shared schema.

    flat rate per call

Compared with the usual setup

Most teams either buy a per-channel listening seat or stitch together several scrapers. Here is what changes.

CapabilitySocialCrawlTypical setup
CoverageOne key covers 46 platforms including forums, news and the open web.Priced per channel, so coverage tends to stop at two or three networks.
Response shapeOne shared schema across every source, so downstream code is written once.A different response shape per vendor, normalised by hand.
Comment depthFull comment and reply trees available on the same key.Top-level comments only, or a separate product.
Pricing modelNever-expire credit packs, priced per call, with refunds on upstream failures.Annual seat licences, often per channel.
Getting startedFree credits on signup and a runnable call in the first minute.Sales call, then onboarding.
Building a product on topPermitted for transformed, customer-facing views. The terms say so in writing.Usually restricted or negotiated case by case.

Social listening API questions

What is a social listening API?

A social listening API returns public posts, comments and articles that mention a keyword, brand or topic, as structured data you can store and analyse. It replaces the dashboards sold as social listening tools with a programmable feed you own.

Which platforms can I monitor?

SocialCrawl covers 46 platforms and 375 endpoints, including Reddit, X, TikTok, Instagram, YouTube, Facebook, Threads, LinkedIn, Hacker News, Google News and the open web. One API key covers all of them.

Can I search several platforms with one request?

Yes. The universal search endpoint fans a single query out across every source in parallel and returns one ranked, deduplicated result set on the shared schema. You can also scope it to specific sources when you only want a subset.

Do I need OAuth or a developer account per platform?

No. You authenticate once with a SocialCrawl API key. There is no per-platform OAuth app, no review process and no separate credentials to rotate.

How do I track mentions over time rather than once?

Pass a date range and optional daily grouping to the brand mention endpoint, or re-run a standing query on your own schedule and store the results. Repeat lookups of the same entity are the most common production pattern on the API.

How much does social listening cost?

Reads are priced in credits from never-expire packs, so you pay per call rather than per seat or per channel. Signup includes 100 free credits, and there is no card required to start.

Can I build a product on top of this data?

Yes, for transformed views shown to your own users. Our terms permit dashboards and derived products, and restrict raw passthrough or bulk redistribution. If you are unsure where your design sits, ask us before you build.

Start listening in one call

100 free credits on signup. No card, no sales call, no per-channel pricing.

Request
curl -G "https://socialcrawl.dev/v1/search/everywhere" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  --data-urlencode "query=your brand name" \
  --data-urlencode "lookback_days=7"
curl -G "https://socialcrawl.dev/v1/reddit/omni-search" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  --data-urlencode 'query="your brand" AND (review OR alternative)'

Both calls run against live data. Swap the key and the query and they work as written.