SocialCrawl

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

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
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
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
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 lists every other call.

How it works

  1. Search the brand across platforms with search everywhere.
  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, 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.

Sentiment adds nothing to the bill. The default labels, sentiment among them, never add 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 and Instagram username checker show who holds a name today.

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 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 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 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.