# Brand monitoring (/docs/use-cases/brand-monitoring) Hear every mention of a brand across platforms, and the reaction under each post. Brand monitoring on SocialCrawl starts with one search across many platforms. You send the brand name, read the ranked mentions, and next time ask only for what is new. A schedule can then send the new mentions to you. ## Start with a template - [Brand and topic listening templates](/docs/templates.md#brand-and-topic-listening): Tested programs for brand listening, share of voice, account mentions and news coverage. - [Brand mention monitoring](/docs/recipes/brand-mention-monitoring.md): The cookbook: collect mentions of a brand and keep each one once. ## Run your first request This request searches the last seven days for a well-known drinks brand. `dry_run=1` makes it free: it returns the plan, the platforms it would ask and the price, and runs nothing. **cURL** ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/search/everywhere?query=Liquid%20Death&period=7d&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": "Liquid Death", "period": "7d", "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", "Liquid Death"); url.searchParams.set("period", "7d"); 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` lists 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. **Search** the brand across platforms with [search everywhere](/docs/engines/search-everywhere.md). 2. **Keep** the `data.next.watermark` the answer returns, and send it back as `since_watermark` to get only rows you have not seen. 3. **Schedule** the search as a [watch](/docs/search/everywhere.md#watches), so the new mentions reach you without polling. ## Why teams choose SocialCrawl **One search covers many platforms.** Social platforms, forums, news and the web are asked in one request, and `since_watermark` returns [only what is new](/docs/search/everywhere.md#5-only-what-is-new-since_watermark). **Sentiment adds nothing to the bill.** The default labels, sentiment among them, [never add credits](/docs/credits.md#labels-add-no-credits). **The price is known first.** `dry_run=1` prices the search before you spend anything. ## Find accounts and ads that use your brand's name The same tools can look for accounts and ads that carry your brand's name. Start with the `account-mentions` template, which finds who mentions, replies to or tags an account, and the `web-page-change-alert` template for a page you want watched. The free [TikTok username checker](/tools/tiktok-username-checker) and [Instagram username checker](/tools/instagram-username-checker) show who holds a name today. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/prism/mentions?handle=nasa&since=2026-11-01" \ -H "x-api-key: sc_your_key_here" ``` 1. **Search** for accounts and advertisers that carry the name with `tiktok/search/users`, `google/adlibrary/advertisers/search` and `tiktok/adlibrary/search` with `advertiser_name`. 2. **Watch** for new ones with a [Monitor](/docs/engines/monitors.md) or a watch. 3. **Keep** each row's source URL and time as your record. This covers brands, products, organizations and people in a public role, about that role. It never covers private individuals, as [Terms section 7.2](/legal/terms-and-conditions) sets out. It searches and watches only, and it makes no judgment of impersonation and no takedown request. ## Questions ### What does it cost to watch one brand? A watch bills each scheduled search at the price of the same search, with no charge for scheduling. A dry run of the watch shows what one fire and 30 days cost before you create it. [Volume costs](/docs/volume-costs.md#three-monthly-examples) works through a month of hourly searches for one brand. ### How do I get only new mentions, with what people say under them? Send the last answer's watermark as `since_watermark`, and the rows you already have are left out. For the comments and replies under one post, send its URL to `prism/comments`, listed with the [per-object composites](/docs/prism.md#per-object-workhorses). ## Related - [Market research](/docs/use-cases/market-research.md): Read what people say about a topic across platforms. - [Reviews and reputation](/docs/use-cases/reviews-and-reputation.md): Collect reviews from shops, maps and app stores. - [Brand monitoring API](/solutions/brand-monitoring-api): How teams use SocialCrawl to track a brand.