docs / trustpilot
Trustpilot
Company reviews, ratings and profiles.
base /trustpilot/v112 endpoints
post
/trustpilot/v1/company/reviews1 creditGet a company's Trustpilot reviews and its full profile from trustpilot.com — TrustScore, star rating, total review count, 5-to-1-star rating distribution, business categories, and every review with rating, title, text, date, verified status, likes and the company's reply. Newest first; optionally filter by star rating.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| company | required | — | The company's website domain (e.g. gossby.com), its Trustpilot review-page URL, or its Trustpilot page slug. |
| maxReviews = 200 | optional | 1–20000 | How many reviews to return (1–20000). More reviews take longer. |
| sort = most_relevant | optional | most_relevant · recency | How to order reviews. |
| date_posted = any | optional | any · last_12_months · last_6_months · last_3_months · last_30_days | Only reviews from this time range. |
| rating | optional | — | Only reviews with these star ratings. A single value or a comma-separated list, e.g. '5' or '4,5'. |
| verified = false | optional | — | Only verified reviews. |
| with_replies = false | optional | — | Only reviews that have an owner reply. |
| query | optional | — | Only reviews matching this keyword/phrase. |
| languages = all | optional | — | Only reviews written in this language (ISO code, e.g. 'en', 'de'); 'all' for every language. |
| includeCompany = true | optional | — | Include the company profile alongside the reviews. |
| page = 1 | optional | 1–500 | Page number (1–500; Trustpilot serves at most 500 pages per view). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/company/details1 creditThe full Trustpilot company profile WITHOUT reviews (cheaper than company/reviews when you only need the listing) → TrustScore, star rating, total reviews, 5-to-1-star distribution, category rankings (e.g. #2 of 26 in Bank), contact info (address, phone, website, email), what customers talk about most (AI topic summaries), the AI review summary and the company description. By company domain.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| company | required | — | The company's website domain (e.g. gossby.com), its Trustpilot review-page URL, or its Trustpilot page slug. |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/category/browse1 creditList the companies in a Trustpilot category (20/page) → each company's name, domain, TrustScore, review count and location. Also returns the category's size and subcategories, plus the newest companies and the recently-reviewed companies in that category — all in one call.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| categoryId | required | animals_pets · animal_health · animal_parks_zoo · cats_dogs · horses_riding · pet_services · pet_stores · beauty_wellbeing · cosmetics_makeup · hair_care_styling · personal_care · salons_clinics · tattoos_piercings · wellness_spa · yoga_meditation · business_services · administration_services · associations_centers · hr_recruiting · import_export · it_communication · office_space_supplies · print_graphic_design · research_development · sales_marketing · shipping_logistics · wholesale · construction_manufactoring · architects_engineers · building_materials · chemicals_plastic · construction_services · contractors_consultants · factory_equipment · garden_landscaping · industrial_supplies · manufacturing · production_services · tools_equipment · education_training · colleges_universities · courses_classes · education_services · language_learning · music_theater_classes · school_high_school · specials_schools · vocational_training · electronics_technology · appliances_electronics · audio_visual · computers_phones · internet_software · repair_services · events_entertainment · adult_entertainment · childrens_entertainment · clubbing_nightlife · events_venues · gambling · gaming · museums_exibits · music_movies · theater_opera · wedding_party · food_beverages_tobacco · agriculture_produce · asian_grocery_stores · bakery_pastry · beer_wine · beverages_liquor · candy_chocolate · coffee_tea · food_production · fruits_vegetables · grocery_stores_markets · lunch_catering · meat_seafood_eggs · smoking_tobacco · health_medical · clinics · dental_services · diagnostics_testing · doctors_surgeons · health_equipment · hospital_emergency · medical_specialists · mental_health · pharmacy_medicine · physical_aids · pregnancy_children · therapy_senior_health · vision_hearing · hobbies_crafts · art_handicraft · astrology_numerology · fishing_hunting · hobbies · metal_stone_glass_work · music_instruments · needlework_knitting · outdoor_activities · painting_paper · home_garden · bathroom_kitchen · cultural_goods · decoration_interior · energy_heating · fabric_stationary · furniture_stores · garden_pond · home_garden_services · home_goods_stores · home_improvements · home_services · cleaning_service_providers · craftsman · house_services · house_sitting_security · moving_storage · plumbing_sanitation · repair_service_providers · legal_services_government · customs_toll · government_department · law_enforcement · lawyers_attorneys · legal_service_providers · libraries_archives · municipal_department · registration_services · media_publishing · books_magazines · media_information · photography · video_sound · money_insurance · accounting_tax · banking_money · credit_debt_services · insurance · investments_wealth · real_estate · public_local_services · employment_career · funeral_memorial · housing_associations · kids_family · military_veteran · nature_environment · professional_organizations · public_services_welfare · religious_institutions · shelters_homes · waste_management · restaurants_bars · african_pacific_cuisine · bars_cafes · chinese_korean_cuisine · european_cuisine · general_restaurants · japanese_cuisine · mediterranean_cuisine · middle_eastern_cuisine · north_south_american_cuisine · southeast_asian_cuisine · takeaway · vegetarian_diet · shopping_fashion · accessories · clothing_underwear · clothing_rental_repair · costume_wedding · jewelry_watches · malls_marketplaces · sports · ball_games · bat-and-ball_games · bowls_lawn_sports · dancing_gymnastics · equipment_associations · extreme_sports · fitness_weight_lifting · golf_ultimate · hockey_ice_skating · martial_arts_wrestling · outdoor_winter_sports · shooting_target_sports · swimming_water_sports · tennis_racquet_sports · travel_vacation · accomodations_lodging · activities_tours · airlines_air_travel · hotels · travel_agencies · utilities · energy_power · oil_fuel · water_utilities · vehicles_transportation · air_water_transport · airports_parking · auto_parts_wheels · bicycles · cars_trucks · motorcycle_powersports · other_vehicles_trailers · taxis_public_transport · vehical_rental · vehicle_repair_fuel | Trustpilot category. Pick from the list (full 2-level taxonomy) — or type any deeper category slug from a trustpilot.com/categories/<slug> URL; those work too. |
| page = 1 | optional | 1–500 | Page number (1–500; Trustpilot serves at most 500 pages per view). |
| cursor | optional | — | Next page: pass the previous response's meta.pagination.next_cursor (the 'Next' button does this automatically). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/category/companies1 creditList the companies in a Trustpilot category (20/page), ranked → each company's name, domain, TrustScore, review count, categories and location. Paginate with page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| categoryId | required | — | A Trustpilot category id/slug, e.g. 'electronics_technology', 'restaurants_bars' (or a trustpilot.com/categories/<slug> URL). |
| page = 1 | optional | 1–500 | Page number (1–500; Trustpilot serves at most 500 pages per view). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/category/recently-reviewed1 creditThe companies in a Trustpilot category that were reviewed most recently → name, domain, TrustScore, review count and location.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| categoryId | required | — | A Trustpilot category id/slug, e.g. 'electronics_technology', 'restaurants_bars' (or a trustpilot.com/categories/<slug> URL). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/category/newest1 creditThe newest companies added to a Trustpilot category → name, domain, TrustScore, review count and location.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| categoryId | required | — | A Trustpilot category id/slug, e.g. 'electronics_technology', 'restaurants_bars' (or a trustpilot.com/categories/<slug> URL). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/category/details1 creditDetails of a Trustpilot category → its display name, the number of businesses in it, and its subcategories.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| categoryId | required | — | A Trustpilot category id/slug, e.g. 'electronics_technology', 'restaurants_bars' (or a trustpilot.com/categories/<slug> URL). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/category/search1 creditSearch Trustpilot categories by keyword → matching categories with their id and display name (feed a categoryId into category/companies).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | A keyword to find matching Trustpilot categories. |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/company/search1 creditSearch Trustpilot for companies by name (10 matches/page) → each match's name, domain, TrustScore, star rating, review count, categories and location. Filter by minimum TrustScore and minimum review count. Also returns matching categories.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | The company name/keyword to search for. |
| min_rating = any | optional | any · 3 · 4 · 4.5 | Only companies with at least this TrustScore. |
| min_review_count = any | optional | any · 25 · 50 · 100 · 250 · 500 | Only companies with at least this many reviews. |
| page = 1 | optional | 1–500 | Page number (1–500; Trustpilot serves at most 500 pages per view). |
| cursor | optional | — | Next page: pass the previous response's meta.pagination.next_cursor (the 'Next' button does this automatically). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/consumer/details1 creditA Trustpilot consumer's public profile → display name, country, number of reviews written, and review statistics. By consumer id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| consumer_id | required | — | The Trustpilot consumer id (from a review's consumer, or a trustpilot.com/users/… URL). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/consumer/reviews1 creditEvery review a Trustpilot consumer has written across all companies → each review's company, rating, title, text and date. Paginate with page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| consumer_id | required | — | The Trustpilot consumer id (from a review's consumer, or a trustpilot.com/users/… URL). |
| page = 1 | optional | 1–500 | Page number (1–500; Trustpilot serves at most 500 pages per view). |
| cursor | optional | — | Next page: pass the previous response's meta.pagination.next_cursor (the 'Next' button does this automatically). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
post
/trustpilot/v1/reviewer/profile1 creditAlias of consumer/details + consumer/reviews: a reviewer's profile AND every review they have written. By consumer id.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| consumer_id | required | — | The Trustpilot consumer id (from a review's consumer, or a trustpilot.com/users/… URL). |
| page = 1 | optional | 1–500 | Page number (1–500; Trustpilot serves at most 500 pages per view). |
| cursor | optional | — | Next page: pass the previous response's meta.pagination.next_cursor (the 'Next' button does this automatically). |
| locale = en-US | optional | da-DK · de-AT · de-CH · de-DE · en-AU · en-CA · en-GB · en-IE · en-NZ · en-US · es-ES · fi-FI · fr-BE · nl-BE · fr-FR · it-IT · ja-JP · nb-NO · nl-NL · pl-PL · pt-BR · pt-PT · sv-SE | Trustpilot country/locale (the website footer's country selector). en-US is fully served today; other locales are accepted and currently resolve to the en-US view (per-locale routing is being added). |
Example request · company/reviews
curl -X POST https://api.reefapi.com/trustpilot/v1/company/reviews \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"company":"amazon.com","maxReviews":40}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}