Search many platforms for keywords or a description, keep a date window, judge every row and return the posts, in one call or as a background run.

Comma-separated searches (up to 6 run in the call; more continue in the background). Each runs once on each platform. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

One search phrase, never split on commas. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

What kept rows must be about, 3 to 2,000 characters. A persona or a question goes here, never in keywords.

Comma-separated brands; each is its own group, searched by its name and labelled with the mention judgment. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

One brand (an alias for a one-item brands). (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

Comma-separated platforms, in order: tiktok, instagram, youtube, reddit, twitter, threads, facebook, linkedin, pinterest, bluesky, hackernews, forums, quora, github, news, web, telegram, naver, xiaohongshu, douyin, ebay, amazon, aliexpress, gumtree, tiktokshop, walmart.

A named platform set instead of platforms: consumer (default), b2b, travel, apps, news, commerce, creators, korea.

Nd (1 to 365), yesterday, this_week, last_week, this_month, last_month, last_quarter, this_year or ytd.

First day kept, YYYY-MM-DD (inclusive). Not combined with period.

Last day kept, YYYY-MM-DD (inclusive). Not combined with period.

Alias for since.

Alias for until.

IANA time zone of the window's calendar (default UTC).

posts (default), accounts, communities or items. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

Kept rows returned per group (default 50, at most 100 in one call).

The most the run may spend (default 50 on this call). The run pauses at it and never overspends.

quick (at most 3 fast platforms, 15 s), standard (default) or deep (background).

true answers the plan of searches and the estimate of credits and seconds, free, and starts nothing.

ISO 3166 codes: keep rows whose row or author country is one of these; also picks the news edition.

ISO 3166 codes: drop rows from these countries.

keep (default) or drop rows whose country is unknown, when country is sent. A geo.country guessed with confidence below 0.3 (from language or currency, say) counts as unknown, so a kept row can show such a guess for another country.

The place the listings, places and web searches look in: a place name or lat,lng. It filters no other rows.

ISO 639 codes: keep rows in these languages and plan searches in them.

Drop rows with fewer views.

Drop rows with fewer likes.

Drop rows with fewer comments.

Drop rows whose author has fewer followers.

Drop rows whose author has more followers.

true keeps only rows by verified authors.

Keep only rows showing these media: video, image, carousel or text.

Keep authors who posted within this many days.

Keep only rows linking to these domains.

Drop rows containing any of these terms.

Comma-separated strings or URL prefixes a kept row must contain; without keywords they are searched. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

keep (default; counted apart) or drop rows with no date.

keep (default), undated or drop rows whose date the platform did not publish and the lane estimated.

drop (default) or keep rows dated outside the window, marked in_window false. Needs a window.

Drop rows whose text has fewer characters (0 to 200), before judging.

Domains searched on the web source, up to 20, or auto to find the sites that hold the topic; web is added when you send no platforms or preset, and an explicit platform set must include web.

filter (default: drop off-topic rows), score (keep every row with its score) or off.

The relevance score a kept row needs, 0 to 1 (default 0.5).

Judgments to add to each row, each billed: mention (needs brands), intent, niche, sponsored_model, stance (judgments.stance { label, confidence } toward the group's brand, else its keywords, else its context; uncertain apart in summary.stance), or none. With view=accounts, fit, role and account_kind judge accounts (the default).

Accounts only: keep accounts of these roles (seller, reseller, buyer, warner, reviewer, promoter, other); adds the role judgment.

Keep only rows with these intents: switching, complaint, recommendation, question, purchase_intent or selling (implies label=intent).

Accounts only: keep accounts of these kinds (individual_creator, brand_or_business, media_or_publisher, fan_or_repost_page, cannot_tell); adds the account_kind judgment.

Accounts only: keep accounts that target these countries (ISO 3166); adds its judgment.

keep (default), exclude or only rows flagged or disclosed as sponsored.

Up to 5 questions of your own, as JSON keyed by the answer's id, judged on every account (and every row with view=posts); a question about a sensitive trait of a person is a free 400.

Kept rows per keyword (counts in summary.by_keyword).

Extra data: author_country, body (full text of the top kept articles, pages and threads), raw (each platform's own row), instagram_views, dropped (dropped rows in results.jsonl and state=dropped reads), commenters (with comments=inline), interest (data.interest: how much each keyword was searched over time, per group); with view=accounts, authors, contacts (opt-in) and audience (a TikTok creator's follower aggregates).

With include=body: rows whose full text is read (default 10; at most 50 on the GET and 5,000 on the POST).

off (default), inline (reads the comments under each group's top posts into a comments block on the row, billed in by_stage.comments) or bulk (data.comments_job lists those posts as ready prism/comments calls).

With comments=inline: posts read per group, 1 to 50 (default 3), taken in turn from each platform and ranked by comment count.

With comments=inline: the most comments read from each post, 1 to 200 (default 20).

comments (default: rank posts by comment count, by views where a platform reports none) or views (rank every post by views).

With comments=inline: drop replies shorter than this many characters (fetched counts them, items holds the kept ones).

With comments=inline on view=posts: comment labels (sentiment, spam, question, purchase_intent, complaint, toxic, low_quality, injection), billed at the comment endpoint's label price.

Accounts only: posts read per account when activity is needed, 1 to 100 (default 12); one call reads at most 12.

relevance (default), recent, engagement, views or views_per_follower; accounts fit, followers, engagement or recent.

representative spreads rows across authors and platforms (with max_per_author, max_per_platform).

With sample=representative: the most rows per author.

With sample=representative: the most rows per platform.

evidence (default), compact or text.

Keep only these keys per row (a dotted name keeps one leaf).

full (default), omit or hash the author on every row.

Adds text_translated in this language (1 credit per started 1,000 characters).

The token in data.next.continue_url: buys the next platform pages of the searches that reported more. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

The watermark from an earlier run's data.next.watermark: only rows newer than it.

Comma-separated seeds to resolve to their own accounts instead of a topic (implies mode=resolve and view=accounts). Each entry is a domain or URL (notion.so: a company with that domain, named from it), Name:domain (BMW Group:bmwgroup.com), or a name alone (Trevor Noah, searched as a person). A name and a domain written any other way is a free 400 whose did_you_mean is the Name:domain form. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

Comma-separated handles: keep only rows by these authors (up to 100 here; store longer lists with POST /v1/prism/discover/inputs). (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

The id from POST /v1/prism/discover/inputs, in place of a long authors list. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

filter (default): search and keep the rows by the listed authors; walk: read each listed author's own posts in the window instead, and keep the ones about the subject.

A brand's own accounts: a handle or profile URL, optionally after a platform (instagram:zomato) and, with several brands, after the brand (zomato:instagram:zomato). Adds the account's own posts (owned_post) and, on Instagram, its tagged posts. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

Accounts whose mentions you want (@handle): posts and replies that mention them on X, Reddit and Instagram, by the @handle (u/handle on Reddit) or by a link to the account's profile or one of its posts. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

Comma-separated hashtags searched on each platform's hashtag lane. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

Lane kinds per platform: posts (default), hashtags; Reddit and X comments; Naver corpora blog, cafe, kin, news, webkr; web search or sites, discover_sites and walk; a brand's owned posts, Instagram tagged posts, ads and reviews; listings, places and communities; Telegram messages (the search inside the channels its channel search finds). search_in.<platform> sets one platform.

With search_in=reviews: the review sites searched (default trustpilot, google, tripadvisor, app_store, google_play; also yelp, amazon, g2).

search (the ordinary keyword run), resolve (seeds resolved to their accounts; seeds imply it) or board (each platform's trend boards for country; view=items with country and no subject implies it). (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

0 (default) to 3 extra searches planned per keyword per language.

With expand above 0: keywords (default: the extra searches are planned from your keywords) or suggestions (also from each keyword's YouTube and TikTok search suggestions, 1 credit each).

With sites=auto: how many of the sites found are searched, 1 to 20 (default 5).

With search_in.web=walk: pages walked per site and keyword, 1 to 500 (default 50).

Pages per search, 1 (default) to 10; above 3 the run continues in the background.

Days the run and its rows stay readable, 1 to 30 (default 7).

Seconds this call may take, 10 to 96 (default 40, quick 15).

auto (default: over budget continues in the background), true (always background) or false (422 NEEDS_ASYNC over budget).

true bypasses cached search pages, at full price.

true starts a new run even when an identical one exists.

Evidence ids or account keys already held: never returned again.

pagination.next_cursor of an earlier answer: the next page of that run's stored rows, free. (one of: keywords, query, brands, brand, hashtags, contains, seeds, authors, author_list_id, mentions_of, brand_handles, cursor, continue, view, mode; at least one required)

GET only: stored rows per page with cursor, 1 to 100 (default 50).

Send no-cache to bypass the response cache and force a live fetch. Billed at the normal endpoint cost; the fresh result is written back to cache for the next caller. Only the no-cache directive triggers this. See the Response Schema guide for details.

Optional UUID that makes the request safely retriable. The key is reserved atomically per account before billing. A concurrent retry receives 409 IDEMPOTENCY_IN_PROGRESS with a Retry-After of 1 second while the original is young, growing to a quarter of the time it has been running (at most 30); a crashed reservation expires after 5 minutes. A replay keeps the cached payload immutable except for billing metadata: credits_used becomes 0, idempotent_replay becomes true, and credits_remaining is refreshed to the current balance. A known current balance appears in both the body and X-Credits-Remaining header; no balance row resolves to 0. On a transient lookup failure, body credits_remaining is null and X-Credits-Remaining is omitted. Completed outcomes expire after 24 hours. If the claim store is unavailable, the request fails closed before billing. GET endpoints do not combine idempotent replay with Server-Sent Events: use Accept: application/json when sending this header. The unsupported key-plus-SSE combination is rejected before billing.