Repuso /developers Get API key

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 

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



2. Connect a profile 


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 


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 


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





6. Manage it all from Claude Code (MCP)


The API doubles as an MCP server - connect it once and your AI tool can add profiles, fetch reviews, tag them, track ratings and configure webhooks conversationally:


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'". Works with any MCP client - see the AI tool integrations for Claude, ChatGPT, Cursor and more.



Questions? Support · Privacy · API Terms