# Reviews and reputation (/docs/use-cases/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 - [Every review, then new ones](/docs/recipes/every-review-and-new-ones.md): The cookbook: collect a business - [Commerce and reviews templates](/docs/templates.md#commerce-and-reviews): Reviews of a local business, an app, or one product across retailers, as ready programs. - [Reputation in one call](/docs/prism.md#brand-health): Blend review sites and app stores into one weighted score with themed pros and cons. ## Run your first request Find the business first. The search returns its Trustpilot domain, which the reviews call takes. **cURL** ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/trustpilot/business-search?query=monzo" \ -H "x-api-key: sc_your_key_here" ``` **Python** ```python title="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** ```typescript title="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](/docs/endpoint-pricing.md) 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](/docs/trustpilot.md) 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](/docs/recipes/sentiment-analysis.md) 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](/docs/schema/review.md) 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](/docs/history.md#use-since-and-until)). **Free sentiment.** Default labels, sentiment among them, [add no credits](/docs/credits.md#labels-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](/docs/volume-costs.md#what-do-1000-rows-cost) 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. ## Related - [Commerce and prices](/docs/use-cases/commerce-and-prices.md): Compare products, prices and reviews across retailers. - [Brand monitoring](/docs/use-cases/brand-monitoring.md): Hear every mention of a brand across platforms. - [Review monitoring API](/solutions/review-monitoring-api): How teams use SocialCrawl to track reviews over time.