# Market research (/docs/use-cases/market-research) Read what people say about a topic across platforms, countries and languages. Ask one question across many platforms and read the ranked answers. Then narrow them by country or language, and find the accounts and communities that drive the topic. ## Start with a template - [Search a topic on several platforms](/docs/templates.md#brand-and-topic-listening): The topic-across-platforms and forum-discussions templates, tested and ready to download. - [Monthly brand reaction](/docs/recipes/monthly-brand-reaction.md): The cookbook: how people reacted to a brand and its competitors last month. ## Run your first request This request asks a buying question across platforms. `dry_run=1` makes it free: it returns the plan and the price, and searches nothing. **cURL** ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/search/everywhere?query=best+noise+cancelling+headphones&format=compact&dry_run=1" \ -H "x-api-key: sc_your_key_here" ``` **Python** ```python title="Python" import json import urllib.parse import urllib.request params = urllib.parse.urlencode({ "query": "best noise cancelling headphones", "format": "compact", "dry_run": 1, }) url = "https://www.socialcrawl.dev/v1/search/everywhere" req = urllib.request.Request( url + "?" + params, headers={"x-api-key": "sc_your_key_here"}, ) with urllib.request.urlopen(req) as res: data = json.load(res)["data"] print(data["estimate"]["formula"]) print(data["plan"]["sources"]) ``` **TypeScript** ```typescript title="TypeScript" const url = new URL("https://www.socialcrawl.dev/v1/search/everywhere"); url.searchParams.set("query", "best noise cancelling headphones"); url.searchParams.set("format", "compact"); url.searchParams.set("dry_run", "1"); const res = await fetch(url, { headers: { "x-api-key": "sc_your_key_here" } }); const { data } = await res.json(); console.log(data.estimate.formula); console.log(data.plan.sources); ``` `data.estimate` is the price of the real search, and `data.plan.sources` names the platforms it would ask. Remove `dry_run` to run it. [Endpoint pricing](/docs/endpoint-pricing.md) lists every other call. ## How it works 1. **Ask** one question across platforms with [search everywhere](/docs/engines/search-everywhere.md). 2. **Narrow** the answer by country and language where an endpoint supports it. 3. **Find** the accounts and communities behind the topic with [Discover](/docs/engines/discover.md), and keep the run to read again later. ## Why teams choose SocialCrawl **One question reaches many platforms at one price.** Search everywhere charges a flat price per search, whatever the number of platforms it asks, as [its billing section](/docs/search/everywhere.md#billing) shows. **A stored run is free to read again.** Every search made with a key is [stored as a run](/docs/search/everywhere.md#how-stored-runs-work), and paging or re-reading it costs nothing. **A finished report is one program.** The [monthly brand reaction](/docs/recipes/monthly-brand-reaction.md) cookbook turns a month of posts about a brand and its competitors into a report. ## Questions ### Does a search ask the platforms, or an index? Each platform is asked at the time of your call, so nothing comes from an archive built earlier. A repeat of the same search inside a short window is served from a shared cache for free. [Freshness windows](/docs/caching.md#freshness-windows) lists each window. ### How far back can I go? Every list whose rows carry a date takes `since` and `until`, and the window is applied to each page before it is returned. [Date window on every list](/docs/history.md#use-since-and-until) explains the rules and the spellings it accepts. ### How do I find the accounts and communities behind a topic? Run Discover over the topic and read the accounts it ranks. The [accounts behind a topic](/docs/recipes/accounts-behind-a-topic.md) and [communities and accounts](/docs/recipes/communities-and-accounts.md) cookbooks show the full runs. ### Can I filter by country and language? On many endpoints, yes. `country` and `region` do different jobs on different platforms, and [Country and region](/docs/data-availability.md#country-and-region) says which job each one does. The [rows by country](/docs/recipes/discover-rows-by-country.md) cookbook keeps a Discover run to one market. ### What does a monthly report on a brand cost? The [monthly brand reaction](/docs/recipes/monthly-brand-reaction.md) cookbook prices the run with a free dry run first. `max_credits` caps the whole run, so it never spends more than you approve. ## Related - [Brand monitoring](/docs/use-cases/brand-monitoring.md): Hear every mention of a brand across platforms. - [Trend detection](/docs/use-cases/trend-detection.md): Watch trending feeds, sounds and hashtags as they rise. - [Market research API](/solutions/market-research-api): How teams use SocialCrawl for market and consumer research.