SocialCrawl
View more

Reviews and reputation

Collect reviews from shops, maps and app stores, and read the trend and the mood.

Collect what customers write about a business, a product or an app, and see whether the mood is improving. Every review source answers in the same review schema, so one table holds them all.

Start with a template

Run your first request

Find the business first. The search returns its Trustpilot domain, which the reviews call takes.

cURL
curl "https://www.socialcrawl.dev/v1/trustpilot/business-search?query=monzo" \
  -H "x-api-key: sc_your_key_here"
Python
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/trustpilot/business-search",
    params={"query": "monzo"},
    headers={"x-api-key": "sc_your_key_here"},
)
for row in response.json()["data"]["items"]:
    print(row["author"]["id"], row["author"]["display_name"])
TypeScript
const response = await fetch(
  "https://www.socialcrawl.dev/v1/trustpilot/business-search?query=monzo",
  { headers: { "x-api-key": "sc_your_key_here" } },
);
const { data } = await response.json();
for (const row of data.items) console.log(row.author.id, row.author.display_name);

The search matches businesses, not products, so send a name rather than a domain. This call costs 1 credit. Price it first, for free, with GET /v1/utility/estimate?id=trustpilot/business-search&query=monzo. Endpoint pricing lists every review call.

Each result is one business. Its Trustpilot domain is in author.id, and its total review count is in author.posts_count. Pass that domain to GET /v1/trustpilot/reviews, which returns the most recent or the most relevant reviews up to a fixed depth. For a longer history, POST /v1/trustpilot/reviews/history collects them in a background job, and the Trustpilot page explains how to read it.

How it works

  1. Find the business, product or app on each review source.
  2. Collect its reviews from the date you last looked, with since, for example GET /v1/trustpilot/reviews?domain=www.monzo.com&sort=recency&since=2026-11-01.
  3. Read the mood from the sentiment label each review already carries, or follow the sentiment analysis cookbook to use your own model.

Why teams choose SocialCrawl

One review schema. Ratings, text, reviewer and the owner's replies come back in the same fields from every source, as the review schema shows.

A date window on every list. since and until work on every review list, so a daily run reads only what is new (date windows).

Free sentiment. Default labels, sentiment among them, add no credits to a call.

Questions

What do 1,000 reviews cost?

It depends on the source's price and how many reviews one page holds. Volume costs works it out for Yelp reviews and the other lists people pull most. For any other source, price your exact request first with dry_run=1 or the free estimate above.

On this page