Quickstart guides

Everything uses Basic auth: the password is your API key, the username stays empty (-u :KEY). Full reference: API docs.

Logged into the console? Try buttons appear here and run each request against your own account.

1. First call Try

curl -u :YOUR_API_KEY https://api.repuso.com/public/v1/hello

2. Connect a profile Try search

Pick the platform - it fills the type for you:

Search a business by name to find its profile, then add it:

curl -u :KEY -X POST https://api.repuso.com/public/v1/profiles/discover \
  -H 'Content-Type: application/json' \
  -d '{"name": "Joes Pizza Brooklyn", "platforms": ["tripadvisor"]}'

curl -u :KEY -X POST https://api.repuso.com/public/v1/profiles/add \
  -H 'Content-Type: application/json' \
  -d '{"type": "tripadvisor", "url": "https://www.tripadvisor.com/Hotel_Review-..."}'

The first crawl collects the review history in the background; after that the profile refreshes daily. Prefer point-and-click? Profiles (and webhooks) can also be created and managed in the console - no code needed.

3. Fetch reviews Try

curl -u :KEY 'https://api.repuso.com/public/v1/reviews/get?rating=4,5&limit=25'

4. React to new reviews with webhooks

curl -u :KEY -X POST https://api.repuso.com/public/v1/webhooks/add \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://yourapp.com/hooks/repuso", "events": ["review.created", "rating.changed"]}'

Store the whsec_ secret from the response and verify the X-Repuso-Signature header: v1 = HMAC-SHA256("<t>.<raw body>", secret). Answer with any 2xx within 10 seconds; failures retry on a backoff schedule. Webhook endpoints, event selection and payload samples are also manageable in the console.

5. Track a rating over time Try

curl -u :KEY 'https://api.repuso.com/public/v1/profiles/rating_history/512?days=90'

6. Use it from your AI tools (MCP)

The API doubles as an MCP server, so an assistant can add profiles, fetch reviews, tag them, track ratings and configure webhooks conversationally.

In Claude (web and desktop), install Repuso from the connector directory - one click, sign in, nothing to paste. Setup.

In Claude Code, Cursor, VS Code, Zed, Codex or Gemini CLI, point the client at the MCP endpoint with your API key:

claude mcp add --transport http repuso https://api.repuso.com/public/v1/mcp \
  --header "Authorization: Basic $(printf ':YOUR_API_KEY' | base64)"

Then just ask: "add our TripAdvisor profile and tag every 1-star review from the last month as 'follow-up'". Per-tool setup for each client is in the AI tool integrations.

Deeper guides

Longer walkthroughs with working code.

• Sync reviews into your own database - cursor pagination, incremental catch-up, and the traps that silently skip rows.
• Send new reviews to Slack - webhooks, signature verification and replay protection.
• Export reviews to a spreadsheet - a one-off CSV, or a Google Sheet that refreshes itself.
• Show reviews with schema markup - valid JSON-LD, and the Google rules that decide whether stars appear.
• Monitor competitor ratings - track any public profile and alert when it moves.

Questions? Support · Privacy · API Terms