100 free credits. No credit card required.Start building
Logo
Back to blog

Best Multi-Platform Social Search API in One Call

··9 min read

What to look for in a multi-platform social search API, and how SocialCrawl's search/multi sends one query to nine platforms and bills only those with results.

Best Multi-Platform Social Search API in One Call

A multi-platform social search API takes one query and returns posts from several networks in a single response. The two things that separate the good ones are whether you get each platform's real rows or a re-ranked summary, and whether you pay for platforms that found nothing. SocialCrawl's GET /v1/search/multi returns native rows from up to nine platforms and charges only for the platforms that came back with results.

What is a multi-platform social search API?

It is one endpoint that fans a query out to several platforms' search and returns the results together. There are two designs. A native-rows design hands you each platform's own rows, grouped, so you keep every field. A planned design rewrites the query, ranks and clusters the merged results, and gives you one answer. Native rows suit pipelines and dashboards. Planned search suits research questions.

SocialCrawl offers both on separate endpoints:

NeedEndpointCredits
Each platform's own rows for one queryGET /v1/search/multi1 to 14, per platform that returns rows
One ranked, clustered answer with top commentsGET /v1/search/everywhere20 flat
One platform in depth, with filters and pagingThat platform's own search endpointSee the endpoint page

The planned design is covered in Social Search Engine API and Universal Search: more usable rows.

One multi-platform search API call opens into four stacks of posts, with tall vertical cards, square cards, wide cards, and a smaller pile.

What should you check before choosing one?

A usable cross-platform social search API handles five things:

  • Native fields or a flattened schema. Native rows keep view counts, share counts and platform-specific fields. A flattened schema is easier to parse and loses detail.
  • Billing for empty or failed platforms. If one network returns nothing, you should not pay for it. Ask whether the price is per platform or per call.
  • Partial failure. One platform timing out should not fail the whole request. Look for a per-platform status in the response.
  • Per-platform filters. TikTok date ranges and Reddit sort orders are not the same parameter. A good API lets you set each one without forcing a lowest common denominator.
  • Paging. Check how you get the second page of one platform without re-running the others.

search/multi handles these as follows. Rows are the same post and computed objects the single-platform endpoints return, plus a platform field. Each platform is billed at its own page price, only when it returned rows. Every platform reports status as ok, empty or failed, and search_status is partial when some failed and others answered. Filters go in as <platform>.<param>. Paging is covered below.

How do you search multiple social platforms in one request?

Send query and a comma-separated platforms list to /v1/search/multi:

bash
curl "https://www.socialcrawl.dev/v1/search/multi?query=coldplay&platforms=tiktok,instagram,youtube,reddit" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

Without platforms, the call searches TikTok, Instagram, YouTube, Reddit and Threads. The full list:

platforms valueRunsPage price
tiktok/v1/tiktok/search1 credit
instagram/v1/instagram/search/reels1 credit
youtube/v1/youtube/search1 credit
reddit/v1/reddit/search1 credit
threads/v1/threads/search1 credit
twitter/v1/twitter/search/tweets1 credit
facebook/v1/facebook/search/posts1 credit
linkedin/v1/linkedin/search/posts5 credits
telegram/v1/telegram/search2 credits

Instagram here means reels search only. Telegram rows are channels with no post object. A name outside this list is a free 400 that names the accepted values. The multi-platform search docs have every parameter.

What does the response look like?

The response holds the merged rows in data.items and a per-platform report in data.sources. Trimmed:

json
{
  "data": {
    "search_status": "complete",
    "total": 129,
    "duplicates_removed": 0,
    "credits_charged": 4,
    "sources": {
      "tiktok": {
        "endpoint": "/v1/tiktok/search",
        "status": "ok",
        "rows": 30,
        "rows_kept": 30,
        "credits": 1,
        "next_cursor": "sc.…",
        "has_more": true
      }
    },
    "items": [
      { "platform": "tiktok", "post": { "id": "…", "url": "…" }, "computed": {} }
    ]
  },
  "credits_used": 4
}
FieldWhat it tells you
itemsEvery platform's rows, grouped in the order you listed the platforms. Each row is exactly what that platform's search endpoint returns.
sources.<platform>status, rows returned, rows kept after the date window and de-duplication, credits charged, and the cursor for the next page.
duplicates_removedRows dropped because the same post URL had already appeared. The first copy stays.
search_statuscomplete when no platform failed, partial when at least one failed and at least one answered.
credits_chargedThe sum of the per-platform credits, equal to the envelope's credits_used.

The order of items is grouping order and carries no ranking. If you need one ranked list, sort on post.engagement yourself or use search/everywhere.

How much does a multi-platform search cost?

Each platform costs its own page price, and only when its page came back with rows. The call holds the sum up front and refunds every platform that failed or found nothing.

ScenarioCharge
Default five platforms, all return rows5 credits
TikTok, Instagram and YouTube, Instagram finds nothing2 credits
TikTok and LinkedIn, both return rows6 credits
Every platform failed0, with a 502
Cache hit within 5 minutes0

Credits are the same unit across the whole API, so you can budget by multiplying page price by the platforms you pick. See endpoint pricing for current page prices.

Filters go in with the platform in front of the name, such as tiktok.region=GB or reddit.sort=new. Each is sent only to that platform. The date window is the cross-platform filter: since keeps posts published on or after a date and until keeps posts published on or before one, so together they give you a calendar month. A row with no date is kept. Each platform is also sent its own date filter for the window where it has one, and data.window shows what each was sent.

bash
curl "https://www.socialcrawl.dev/v1/search/multi?query=coldplay&platforms=tiktok,reddit&since=2026-09-01&until=2026-09-30&reddit.sort=new" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

region steers a market's results but does not guarantee that every row comes from it, so filter on the row's own country field if you need a hard cut.

Multi returns one page per platform and does not page itself. Sending cursor to it is a 400. To go deeper on one platform, call that platform's endpoint from sources.<platform>.endpoint with the same query and send next_cursor as cursor. Walk filters such as min_views, max_age_days and max_pages belong to the single-platform search, for example /v1/tiktok/search, and pagination explains how they bill. On search/multi an undeclared parameter is ignored and named in _warnings rather than failing.

A mesh filter sits unused beside a combined cross-platform social search, then sorts one stack and keeps only the cards that pass.

What doesn't search/multi do?

  • It does not plan or rewrite your query. The same text goes to every platform.
  • It does not rank across platforms. Use search/everywhere for a ranked, clustered answer.

Frequently asked questions

What is the best multi-platform social search API?

It depends on whether you need native rows or one ranked answer. For native rows from up to nine platforms in one call, billed only where results exist, use search/multi. For a planned, ranked and clustered answer, use search/everywhere.

How many credits does a multi-platform search use?

Each platform costs its own page price, 1 credit for most, 2 for Telegram and 5 for LinkedIn, and only when it returns rows. A four-platform search across TikTok, Instagram, YouTube and Reddit costs 4 credits. Platforms that fail or find nothing are refunded.

Which platforms can I search in one request?

TikTok, Instagram reels, YouTube, Reddit, Threads, X, Facebook, LinkedIn and Telegram. Without a platforms list the call searches TikTok, Instagram, YouTube, Reddit and Threads.

Can I filter by date or country across platforms?

since and until filter by date on every platform. Country and sort options are per platform, set as tiktok.region or reddit.sort. Each filter reaches only the platform you name.

Multi returns each platform's own search page and does not plan, rank or cluster. The planned endpoint rewrites the query, searches more sources and reads top comments. See Social Search Engine API.

Topics
#best-multi-platform-social-search-api#multi-platform-search-api#cross-platform-social-search#cross-platform-social-search-api#multi-platform-social-search-api#search-multiple-social-platforms#tiktok-instagram-youtube-reddit-search-api#multi-platform-social-media-api

Related posts

🤖 AI agent or LLM? Read this page as markdown