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
The topic-across-platforms and forum-discussions templates, tested and ready to download.
Monthly brand reaction
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 "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"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"])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 lists every other call.
How it works
- Ask one question across platforms with search everywhere.
- Narrow the answer by country and language where an endpoint supports it.
- Find the accounts and communities behind the topic with Discover, 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 shows.
A stored run is free to read again. Every search made with a key is stored as a run, and paging or re-reading it costs nothing.
A finished report is one program. The monthly brand reaction 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 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 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 and communities and accounts 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 says which job each one does. The rows by country cookbook keeps a Discover run to one market.
What does a monthly report on a brand cost?
The monthly brand reaction cookbook prices the run with a free dry run first. max_credits caps the whole run, so it never spends more than you approve.
