{"openapi":"3.1.0","info":{"title":"API.SH: Trustpilot","version":"1.0.0","description":"The Trustpilot API from API.SH: public Trustpilot data as clean JSON. Every endpoint is a GET with query parameters and your key in the x-api-key header. Calls that run cost the credits shown (x-credits): successes, and lookups that found nothing (404). Refused calls and errors on our side are free. Docs: https://api.sh/docs · Every platform: https://api.sh/openapi.json","contact":{"name":"API.SH support","email":"support@api.sh","url":"https://api.sh/contact"},"termsOfService":"https://api.sh/legal/terms"},"servers":[{"url":"https://api.api.sh"}],"security":[{"apiKey":[]}],"tags":[{"name":"Account","description":"Your balance, usage, logs and past responses. Free."},{"name":"Trustpilot","description":"7 endpoints (jobs & b2b)","x-slug":"trustpilot","x-domains":["trustpilot.com"]}],"paths":{"/v1/account":{"get":{"operationId":"getAccount","tags":["Account"],"summary":"Balance, plan, spend and spend limits","description":"Credits by bucket (free monthly, plan, pay-as-you-go), the plan, credits spent today and this month (UTC), your spend limits and the key used. Free: costs no credits.","responses":{"200":{"description":"Account","content":{"application/json":{"example":{"success":true,"account":{"id":"8f0c…","status":"active","unlimited":false},"credits":{"total":41250,"free":100,"plan":0,"payg":41150,"free_resets_at":"2026-11-01T00:00:00Z"},"plan":null,"spend":{"today":120,"this_month":3400,"daily_limit":5000,"monthly_limit":null,"period":"UTC"},"key":{"id":"…","name":"production","prefix":"ash_li","created_at":"2026-10-01T00:00:00Z"}}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/usage":{"get":{"operationId":"getAccountUsage","tags":["Account"],"summary":"Usage per day and per endpoint","description":"Calls, errors and credits per UTC day, and the top endpoints by credits. Free. Add output=csv for the daily rows as CSV.","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":90,"default":30}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/account/logs":{"get":{"operationId":"listAccountLogs","tags":["Account"],"summary":"Your calls of the last 30 days","description":"Newest first. Filter by status, route prefix, key or time; page with `before` (the `next` value). Add output=csv|ndjson to download (up to 5,000 rows per request; the next cursor is in the x-next-cursor header). Free.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"status","in":"query","required":false,"description":"ok, error, or an HTTP status like 502.","schema":{"type":"string"}},{"name":"route","in":"query","required":false,"description":"Route prefix, e.g. /tiktok/v1","schema":{"type":"string"}},{"name":"key","in":"query","required":false,"description":"Only calls made with this key id.","schema":{"type":"string","format":"uuid"}},{"name":"since","in":"query","required":false,"description":"ISO time.","schema":{"type":"string","format":"date-time"}},{"name":"before","in":"query","required":false,"description":"Cursor from `next`.","schema":{"type":"string"}},{"$ref":"#/components/parameters/output"}],"responses":{"200":{"description":"Calls","content":{"application/json":{"schema":{"type":"object"}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/results/{request_id}":{"get":{"operationId":"getResult","tags":["Account"],"summary":"Fetch a past response again, free","description":"The exact response a call returned, for 30 days after the call, at no cost. Use the call's x-request-id. Supports output=csv|ndjson.","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The stored response (headers: x-refetch: 1, x-original-time, x-original-route).","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Older than 30 days.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/trustpilot/v1/autocomplete":{"get":{"operationId":"trustpilotAutocomplete","summary":"Trustpilot company suggestions","description":"The search box's company suggestions for what was typed: business id, name, domain, TrustScore, stars, number of reviews, category, logo and review page link.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/trustpilot-autocomplete","tags":["Trustpilot"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"description":"The text typed so far.","schema":{"type":"string"},"example":"amaz"},{"name":"country","in":"query","required":false,"description":"Two-letter country (default US).","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"q":"amaz","country":"US","count":10,"items":[{"id":"4c2fac3f00006400050d5c81","name":"Amazonprime","domain":"amazonprime.com","trust_score":1.3,"stars":1.5,"reviews":5805,"category":"e-Commerce Solution Provider","logo":null,"url":"https://www.trustpilot.com/review/amazonprime.com"},{"id":"5d35c8f97e869e00012bc439","name":"Amazonprimevideo","domain":"amazonprimevideo.com","trust_score":1.1,"stars":1,"reviews":3467,"category":"Movie Streaming Service","logo":null,"url":"https://www.trustpilot.com/review/amazonprimevideo.com"},"… 8 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/trustpilot/v1/categories":{"get":{"operationId":"trustpilotCategories","summary":"Trustpilot categories","description":"Every Trustpilot category with its subcategories. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/trustpilot-categories","tags":["Trustpilot"],"x-credits":1,"parameters":[{"name":"country","in":"query","required":false,"description":"Two-letter country. Accepted for compatibility; Trustpilot's category tree is the same in every country (checked Oct 2026), so the list does not change. To list a country's businesses, pass `country` to `/trustpilot/v1/category`.","schema":{"type":"string"},"example":"US"},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"country":"US","count":22,"categories":[{"id":"animals_pets","name":"Animals & Pets","url":"https://www.trustpilot.com/categories/animals_pets","subcategories":[{"id":"animal_health","name":"Animal Health"},{"id":"animal_parks_zoo","name":"Animal Parks & Zoo"},"… 4 more"]},{"id":"beauty_wellbeing","name":"Beauty & Well-being","url":"https://www.trustpilot.com/categories/beauty_wellbeing","subcategories":[{"id":"cosmetics_makeup","name":"Cosmetics & Makeup"},{"id":"hair_care_styling","name":"Hair Care & Styling"},"… 5 more"]},"… 20 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/trustpilot/v1/category":{"get":{"operationId":"trustpilotCategory","summary":"Trustpilot category","description":"Companies in a category with Trustpilot's filters. Every response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/trustpilot-category","tags":["Trustpilot"],"x-credits":1,"parameters":[{"name":"category","in":"query","required":true,"description":"Category id (see /trustpilot/v1/categories).","schema":{"type":"string"},"example":"bank"},{"name":"country","in":"query","required":false,"description":"Two-letter country.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"relevance (default), reviews_count, latest_review.","schema":{"type":"string","enum":["relevance","reviews_count","latest_review"]}},{"name":"trustscore","in":"query","required":false,"description":"Minimum TrustScore, e.g. 4.0.","schema":{"type":"string"}},{"name":"claimed","in":"query","required":false,"description":"true for claimed profiles only.","schema":{"type":"string"}},{"name":"location","in":"query","required":false,"description":"City or postal code.","schema":{"type":"string"}},{"name":"subcategories","in":"query","required":false,"description":"Comma-separated subcategory ids.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number; `next_page` is null on the last page.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"category":"bank","url":"https://www.trustpilot.com/categories/bank","filters":{"claimed":false,"trustscore":null,"country":"US","subcategories":[],"sort":"most_relevant","location":"","variant":""},"page":1,"total":1177,"total_pages":59,"per_page":20,"next_page":2,"count":20,"businesses":[{"id":"5060f52a00006400051bf99f","name":"Happen Bank","domain":"happen.com","url":"https://www.trustpilot.com/review/happen.com","trust_score":4.7,"stars":4.5,"reviews":14961,"logo":"https://s3-eu-west-1.amazonaws.com/tpd/screenshotlogo-domain/5060f52a00006400051bf99f/198x149.png","location":{"address":"88 Kearny Street, Suite 600","city":"San Francisco","zipCode":"94108","country":"United States"},"contact":{"website":"https://happen.com","email":null,"phone":"+1 555 010 0000"},"categories":["Bank","Financial Institution"],"recommended_in":true,"gambling_related":false},{"id":"5cee98133f0ff4000123e127","name":"opensky®","domain":"openskycc.com","url":"https://www.trustpilot.com/review/openskycc.com","trust_score":4.6,"stars":4.5,"reviews":15071,"logo":"https://s3-eu-west-1.amazonaws.com/tpd/screenshotlogo-domain/5cee98133f0ff4000123e127/198x149.png","location":{"address":"PO Box 660924","city":"Dallas","zipCode":"75266","country":"United States"},"contact":{"website":"https://openskycc.com","email":null,"phone":"+1 555 010 0000"},"categories":["Bank"],"recommended_in":true,"gambling_related":false},"… 18 more"],"seo":{"locale":"en-US","languages":[{"isoLanguage":"da","uri":"https://dk.trustpilot.com","locale":"da-DK"},{"isoLanguage":"de-AT","uri":"https://at.trustpilot.com","locale":"de-AT"},"… 22 more"],"noIndex":false,"canonicalUrl":"https://www.trustpilot.com/categories/bank","currentPage":1,"maxPages":59},"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/trustpilot/v1/company":{"get":{"operationId":"trustpilotCompany","summary":"Trustpilot company","description":"A company's Trustpilot profile and one page of its reviews: name, website, TrustScore, stars, review count, categories, verification, contact, review statistics, logo, claimed and closed flags, location, plus `rating_distribution` (review counts for 1-5 stars and the total), `reviews_last_12_months`, `primary_category`, `category_path`, `country`, `temporarily_closed` and `similar_companies` (id, name, domain, link, TrustScore, stars, review count, logo). Pass `next_page` from the previous response; `next_page` is null on the last page.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/trustpilot-company","tags":["Trustpilot"],"x-credits":1,"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"example":"amazon.com"},{"name":"page","in":"query","required":false,"description":"Page number. Pass `next_page` from the previous response; `next_page` is null on the last page.","schema":{"type":"integer"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"domain":"amazon.com","filters":{},"page":1,"total_pages":1546,"next_page":2,"company":{"id":"46ad346800006400050092d0","name":"Amazon","website":"https://www.amazon.com","trust_score":1.5,"stars":1.5,"review_count":50110,"categories":["Shoe Store","Clothing Store","… 2 more"],"verified":{"verifiedUserIdentity":false,"verifiedByGoogle":false,"verifiedPaymentMethod":false,"verifiedByPersona":false,"verificationDetails":null},"contact":{"email":"","address":"","city":"","country":"GB","phone":"","zipCode":""},"stats":{"hasMultipleLanguages":true,"reviewLanguages":[{"isoCode":"all","reviewCount":47032,"displayName":"all"},{"isoCode":"aa","reviewCount":1,"displayName":"Afar"},"… 38 more"],"ratings":{"total":50110,"one":33874,"two":3029,"three":1872,"four":2425,"five":8910}},"identifying_name":"www.amazon.com","logo":"//s3-eu-west-1.amazonaws.com/tpd/screenshots/46ad346800006400050092d0/198x149.png","claimed":true,"closed":false,"collecting_incentivised_reviews":null,"activity":{"isUsingPaidFeatures":false,"hasSubscription":false,"claimedDate":"2015-02-18T19:08:43.000Z","isClaimed":true,"previouslyClaimed":true,"replyBehavior":{"averageDaysToReply":0,"lastReplyToNegativeReview":null,"negativeReviewsWithRepliesCount":0,"replyPercentage":0,"totalNegativeReviewsCount":7650},"verification":{"verifiedUserIdentity":false,"verifiedByGoogle":false,"verifiedPaymentMethod":false,"verifiedByPersona":false,"verificationDetails":null},"hasBusinessUnitMergeHistory":false,"isUsingAIResponses":false,"hasRecentlyInvitedUsers":false},"location":null,"rating_distribution":{"1":33874,"2":3029,"3":1872,"4":2425,"5":8910,"total":50110},"reviews_last_12_months":8739,"primary_category":"Book Store","category_path":["Media & Publishing","Books & Magazines","… 1 more"],"country":"GB","temporarily_closed":false},"similar_companies":[{"id":"6335ac89378fdbaca36b576b","name":"Temu","domain":"temu.com","url":"https://www.trustpilot.com/review/temu.com","trust_score":1.8,"stars":2,"review_count":56976,"logo":"https://s3-eu-west-1.amazonaws.com/tpd/logos/6335ac89378fdbaca36b576b/0x0.png"},{"id":"46a67b91000064000500910d","name":"Amazon.co.uk","domain":"www.amazon.co.uk","url":"https://www.trustpilot.com/review/www.amazon.co.uk","trust_score":1.4,"stars":1.5,"review_count":34530,"logo":"https://s3-eu-west-1.amazonaws.com/tpd/logos/46a67b91000064000500910d/0x0.png"},"… 6 more"],"reviews":[{"id":"6aeaa668da8a0c2faf51d4eb","title":"ONE STAR no customer obsession ","text":"ONE STAR: Amazon’s Customer Obsession Is Officially a Corporate Fairy Tale\n\nApparently, Amazon’s definition of “Earth’s most customer-centri…","rating":1,"language":"en","likes":0,"published_at":"2026-11-04T05:28:40.000Z","experienced_at":"2026-11-03T00:00:00.000Z","verified":false,"author":"Gayle Cartier","author_country":"US","author_reviews":3,"reply":null,"updated_at":null,"submitted_at":null,"author_id":"687ec0d9192bd3eeaecbe966","author_image":"https://user-images.trustpilot.com/687ec0d9192bd3eeaecbe966/73x73.png","author_verified":false,"source":"Organic","verification":{"isVerified":false,"createdDateTime":"2026-11-04T05:28:40.000Z","reviewSourceName":"Organic","verificationSource":"invitation","verificationLevel":"not-verified","hasDachExclusion":false},"url":"https://www.trustpilot.com/reviews/6aeaa668da8a0c2faf51d4eb"},{"id":"6aea9d0bc3b7b133558ba645","title":"This shopping site is a total scam","text":"This shopping site is a total scam. I ordered shoes and they didn't deliver it in time and gave false and fake promises to me. I chatted wit…","rating":1,"language":"en","likes":0,"published_at":"2026-11-04T04:48:43.000Z","experienced_at":"2026-11-02T00:00:00.000Z","verified":false,"author":"Pujitha Ma","author_country":"US","author_reviews":1,"reply":null,"updated_at":null,"submitted_at":null,"author_id":"6aea9cf8c04fdb580d6d1fd2","author_image":"https://user-images.trustpilot.com/6aea9cf8c04fdb580d6d1fd2/73x73.png","author_verified":false,"source":"Organic","verification":{"isVerified":false,"createdDateTime":"2026-11-04T04:48:43.000Z","reviewSourceName":"Organic","verificationSource":"invitation","verificationLevel":"not-verified","hasDachExclusion":false},"url":"https://www.trustpilot.com/reviews/6aea9d0bc3b7b133558ba645"},"… 18 more"],"total_reviews":30912,"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/trustpilot/v1/reviews":{"get":{"operationId":"trustpilotReviews","summary":"Trustpilot reviews","description":"Pass `next_page` from the previous response; `next_page` is null on the last page.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/trustpilot-reviews","tags":["Trustpilot"],"x-credits":1,"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"example":"amazon.com"},{"name":"page","in":"query","required":false,"description":"Page number. Pass `next_page` from the previous response; `next_page` is null on the last page.","schema":{"type":"integer"}},{"name":"sort","in":"query","required":false,"description":"recency (default) or relevance.","schema":{"type":"string"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"domain":"amazon.com","sort":"recency","filters":{},"page":1,"total_reviews":30912,"total_pages":1546,"next_page":2,"reviews":[{"id":"6aeaa668da8a0c2faf51d4eb","title":"ONE STAR no customer obsession ","text":"ONE STAR: Amazon’s Customer Obsession Is Officially a Corporate Fairy Tale\n\nApparently, Amazon’s definition of “Earth’s most customer-centri…","rating":1,"language":"en","likes":0,"published_at":"2026-11-04T05:28:40.000Z","experienced_at":"2026-11-03T00:00:00.000Z","verified":false,"author":"Gayle Cartier","author_country":"US","author_reviews":3,"reply":null,"updated_at":null,"submitted_at":null,"author_id":"687ec0d9192bd3eeaecbe966","author_image":"https://user-images.trustpilot.com/687ec0d9192bd3eeaecbe966/73x73.png","author_verified":false,"source":"Organic","verification":{"isVerified":false,"createdDateTime":"2026-11-04T05:28:40.000Z","reviewSourceName":"Organic","verificationSource":"invitation","verificationLevel":"not-verified","hasDachExclusion":false},"url":"https://www.trustpilot.com/reviews/6aeaa668da8a0c2faf51d4eb"},{"id":"6aea9d0bc3b7b133558ba645","title":"This shopping site is a total scam","text":"This shopping site is a total scam. I ordered shoes and they didn't deliver it in time and gave false and fake promises to me. I chatted wit…","rating":1,"language":"en","likes":0,"published_at":"2026-11-04T04:48:43.000Z","experienced_at":"2026-11-02T00:00:00.000Z","verified":false,"author":"Pujitha Ma","author_country":"US","author_reviews":1,"reply":null,"updated_at":null,"submitted_at":null,"author_id":"6aea9cf8c04fdb580d6d1fd2","author_image":"https://user-images.trustpilot.com/6aea9cf8c04fdb580d6d1fd2/73x73.png","author_verified":false,"source":"Organic","verification":{"isVerified":false,"createdDateTime":"2026-11-04T04:48:43.000Z","reviewSourceName":"Organic","verificationSource":"invitation","verificationLevel":"not-verified","hasDachExclusion":false},"url":"https://www.trustpilot.com/reviews/6aea9d0bc3b7b133558ba645"},"… 18 more"],"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/trustpilot/v1/search":{"get":{"operationId":"trustpilotSearch","summary":"Trustpilot company search","description":"Companies on Trustpilot matching a name or keyword: id, name, domain, TrustScore, stars, review count, location, categories, logo, profile link, website and contact, with the total. Filter by minimum TrustScore, claimed profiles, minimum review count and city; the answer echoes them as `filters`. `matching_categories` lists the Trustpilot categories that match the query (id, name, parent): the search itself has no category filter or sort, so use `/trustpilot/v1/category` with that id to sort a category's companies by relevance, review count or latest review. Pass `next_page` from the previous response; `next_page` is null on the last page.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/trustpilot-search","tags":["Trustpilot"],"x-credits":1,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"bank"},{"name":"trustscore","in":"query","required":false,"description":"Only companies with at least this TrustScore.","schema":{"type":"string","enum":["3.0","4.0","4.5"]}},{"name":"claimed","in":"query","required":false,"description":"true: only companies that claimed their profile.","schema":{"type":"string","enum":["true"]}},{"name":"min_reviews","in":"query","required":false,"description":"Only companies with at least this many reviews (e.g. 25, 100, 250).","schema":{"type":"integer"}},{"name":"location","in":"query","required":false,"description":"City, e.g. London.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number. Pass `next_page` from the previous response; `next_page` is null on the last page.","schema":{"type":"integer"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"query":"amazon","page":1,"total_pages":57,"next_page":2,"companies":[{"id":"46d72ac0000064000500e9bb","name":"Amazon","domain":"www.amazon.fr","trust_score":1.6,"stars":1.5,"review_count":19697,"location":{"address":null,"city":null,"zipCode":null,"country":"France"},"categories":["Events & Entertainment"],"logo":null,"url":"https://www.trustpilot.com/review/www.amazon.fr","website":null,"contact":{"website":"https://www.amazon.fr","email":null,"phone":null}},{"id":"46ad346800006400050092d0","name":"Amazon","domain":"www.amazon.com","trust_score":1.5,"stars":1.5,"review_count":50110,"location":{"address":null,"city":null,"zipCode":null,"country":"United Kingdom"},"categories":["Book Store","Clothing Store","… 2 more"],"logo":null,"url":"https://www.trustpilot.com/review/www.amazon.com","website":null,"contact":{"website":"https://www.amazon.com","email":null,"phone":null}},"… 8 more"],"total_results":564,"cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}},"/trustpilot/v1/user":{"get":{"operationId":"trustpilotUser","summary":"Trustpilot reviewer profile","description":"A Trustpilot reviewer's public profile: display name, country, number of reviews, reads and likes, verified flag, avatar, and their reviews of companies (rating, title, text, language, likes, published and experience dates, verification, the company reviewed with its Trustpilot link, and the company's reply). Paged.\n\nEvery response includes `credits_used`: the credits this call cost.\n\nPrice: 1 credit per successful call. Docs: https://api.sh/docs/trustpilot-user","tags":["Trustpilot"],"x-credits":1,"parameters":[{"name":"id","in":"query","required":true,"description":"The reviewer id (author_id in /trustpilot/v1/reviews), or a trustpilot.com/users/<id> link.","schema":{"type":"string"},"example":"5c5f1553dd5deaae376401bf"},{"name":"page","in":"query","required":false,"description":"Page number (default 1).","schema":{"type":"integer"}},{"$ref":"#/components/parameters/raw"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/fresh"},{"$ref":"#/components/parameters/output"},{"$ref":"#/components/parameters/records"}],"responses":{"200":{"description":"The data as JSON (or CSV / NDJSON with `output`).","headers":{"x-request-id":{"$ref":"#/components/headers/x-request-id"},"x-credits-used":{"$ref":"#/components/headers/x-credits-used"},"x-credits-remaining":{"$ref":"#/components/headers/x-credits-remaining"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"id":"5c5f1553dd5deaae376401bf","name":"Ian lightfoot","country":"United Kingdom","reviews_count":13,"reads":11,"likes":0,"verified":false,"avatar":"https://user-images.trustpilot.com/default/v1/73x73.png","page":1,"total_pages":1,"next_page":null,"count":12,"reviews":[{"id":"6aea17a16af79ea076ad105b","rating":1,"title":"They never ring door bell just leave…","text":"They never ring door bell just leave out side and say its delivered so bad do not care. ","language":"en","likes":0,"published_at":"2026-11-03T19:19:29.000Z","experienced_at":"2026-11-03T00:00:00.000Z","updated_at":null,"verified":false,"source":"Organic","company":{"id":"46ad346800006400050092d0","name":"Amazon","domain":"www.amazon.com","url":"https://www.trustpilot.com/review/www.amazon.com"},"reply":null},{"id":"6aea167f97761d92a4c56a44","rating":5,"title":"Such a good service everytime i have…","text":"Such a good service everytime i have you, so helpful i wish all my delivery was done by you Such a good service. ","language":"en","likes":0,"published_at":"2026-11-03T19:14:39.000Z","experienced_at":"2026-11-03T00:00:00.000Z","updated_at":null,"verified":true,"source":"InvitationApi","company":{"id":"69c50d31ad626e0c91c49c4e","name":"APC","domain":"apc.co.uk","url":"https://www.trustpilot.com/review/apc.co.uk"},"reply":null},"… 10 more"],"url":"https://www.trustpilot.com/users/5c5f1553dd5deaae376401bf","cached":false,"credits_used":1}},"text/csv":{"schema":{"type":"string"}},"application/x-ndjson":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/E400"},"401":{"$ref":"#/components/responses/E401"},"402":{"$ref":"#/components/responses/E402"},"404":{"$ref":"#/components/responses/E404"},"502":{"$ref":"#/components/responses/E502"},"503":{"$ref":"#/components/responses/E503"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Create keys at https://app.api.sh/keys. Authorization: Bearer <key> also works."}},"parameters":{"raw":{"name":"raw","in":"query","required":false,"description":"0 leaves out the bulky `raw` source blocks (often 10-30x smaller).","schema":{"type":"string","enum":["0","1"]}},"fields":{"name":"fields","in":"query","required":false,"description":"Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.","schema":{"type":"string"}},"fresh":{"name":"fresh","in":"query","required":false,"description":"1 skips the 24-hour cache and fetches live.","schema":{"type":"string","enum":["1"]}},"output":{"name":"output","in":"query","required":false,"description":"csv or ndjson returns the response's records (its main list, or the object as one row) as CSV or NDJSON instead of JSON.","schema":{"type":"string","enum":["json","csv","ndjson"]}},"records":{"name":"records","in":"query","required":false,"description":"With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.","schema":{"type":"string"}}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"string"}},"required":["success","error"]}},"responses":{"E400":{"description":"A parameter is missing or invalid. Not charged (unless the call ran and the source rejected the value; credits_used says).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E401":{"description":"Missing, invalid, revoked or expired API key. Not charged. See https://api.sh/docs/errors#401","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E402":{"description":"Not enough credits, a spend limit you set was reached (`spend_limit`), or the key's monthly credit cap was reached (`key_cap`). Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E404":{"description":"Not found, or not public. A lookup that ran costs the endpoint's price (credits_used says); an unknown route is free.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E502":{"description":"The source site failed this time; retry. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"E503":{"description":"Endpoint paused or temporarily unavailable; may include retry-after. Not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"headers":{"x-request-id":{"description":"The call's id (logs, re-fetch with /v1/results/{id}).","schema":{"type":"string","format":"uuid"}},"x-credits-used":{"description":"Credits charged for this call.","schema":{"type":"integer"}},"x-credits-remaining":{"description":"Balance after the call.","schema":{"type":"integer"}}}},"externalDocs":{"url":"https://api.sh/docs"}}