--- title: Trustpilot API Integration on Truto slug: trustpilot category: Survey canonical: "https://truto.one/integrations/detail/trustpilot/" --- # Trustpilot API Integration on Truto **Category:** Survey **Status:** Beta ## MCP-ready AI tools Truto exposes 83 tools for Trustpilot that AI agents can call directly. - **get_single_trustpilot_conversation_by_id** — Get a Trustpilot conversation and its related comments by id. Returns: id, commentId, createdAt, author, content. Required: id. - **create_a_trustpilot_conversation_comment** — Create a new comment for a Trustpilot conversation, appending it to the existing list of comments. Returns: commentId, createdAt, author, content. Required: conversation_id. - **get_single_trustpilot_conversation_comment_by_id** — Get a single comment by id for a Trustpilot conversation. Returns: commentId, createdAt, author, content. Required: conversation_id and id (the comment's commentId). - **update_a_trustpilot_conversation_comment_by_id** — Edit a single comment by id in a Trustpilot conversation. Returns: commentId, createdAt, author, content. Required: conversation_id and id (the comment's commentId). - **get_single_trustpilot_public_conversation_by_id** — Get a Trustpilot public conversation and its related comments by id. Returns: id, businessUnitId, consumerId, comments, commentId, createdAt, author, content. Required: id. - **trustpilot_product_reviews_get_summary** — Get a Trustpilot product reviews summary for one or more SKUs of a business unit. Returns: summaries, commentId, createdAt, author, content. Required: business_unit_id, sku. - **list_all_trustpilot_product_reviews** — List Trustpilot product reviews for a business unit. Returns review fields including id, stars, content, consumer, product, attributeRatings, and attachments. Required: business_unit_id. Provide at least one of sku or productUrl. - **trustpilot_product_reviews_list_summaries** — List Trustpilot product reviews summaries for a business unit, with stars average, distribution and count per SKU. Returns: links, summaries, commentId, createdAt, author, content. Required: business_unit_id. Paginated. - **trustpilot_product_reviews_batch_summaries** — Get Trustpilot product reviews summaries for multiple SKUs in one request, including stars average, distribution and count. Returns: summaries, commentId, createdAt, author, content. Required: business_unit_id, skus. - **trustpilot_product_reviews_batch_attribute_summaries** — Get the aggregated Trustpilot attribute ratings for the provided SKUs of a business unit. Returns: summaries, commentId, createdAt, author, content. Required: business_unit_id, skus. - **trustpilot_product_reviews_list_imported** — List imported product reviews for a business unit, filtered by SKU, star rating, and language. Returns: createdAt, stars, content, consumer, source, language. Required: business_unit_id, sku. Paginated — a requested page beyond the available range returns an empty array. - **trustpilot_product_reviews_get_imported_summary** — Get a Trustpilot summary of imported product reviews for one or more SKUs of a business unit, including stars average, star distribution, and review count. Returns: links, numberOfReviews, starsAverage, commentId, createdAt, author, content. Required: business_unit_id, sku. - **trustpilot_product_reviews_create_invitation_link** — Create a Trustpilot product review invitation link to send to a consumer. Returns: reviewLinkId, reviewUrl, commentId, createdAt, author, content. Required: business_unit_id. Specify products either as productIds or as product details in products, but not both. - **list_all_trustpilot_private_product_reviews** — List private product reviews for a Trustpilot business unit, optionally filtered by SKU, language, or review state. Returns each review with id, stars, content, consumer (email included), product, state, conversationId, attributeRatings, and attachments. Required: business_unit_id. Only published reviews are returned unless state is provided. - **get_single_trustpilot_private_product_review_by_id** — Get a single private product review in Trustpilot by id, including private details such as consumer email and reference ID. Returns: id, createdAt, updatedAt, content, commentId, author. Required: id. - **trustpilot_private_product_reviews_create_conversation** — Create a conversation for a Trustpilot product review so it can receive comments. Returns: commentId, createdAt, author, content. Required: review_id. - **trustpilot_business_units_get_profile** — Get company profile information for a Trustpilot business unit by id. Returns: links. Required: business_unit_id. - **trustpilot_business_units_get_web_links** — Get links to a Trustpilot business unit's public profile page, generated for the requested locale. Returns: links. Required: business_unit_id, locale. - **trustpilot_business_units_get_images** — Get the company profile image for a Trustpilot business unit by id. Returns: links. Required: business_unit_id. - **trustpilot_business_units_get_logo** — Get the company logo for a Trustpilot business unit by id, or a specific unit location's logo when locationId is supplied. Returns: links. Required: business_unit_id. - **trustpilot_business_units_get_promotion_box** — Get the company promotion box for a Trustpilot business unit by id. Returns: promotionBoxUrl. Required: business_unit_id. - **trustpilot_business_units_get_header_image** — Get the company header image for a specific Trustpilot business unit. Returns: headerUrl. Required: business_unit_id. - **trustpilot_business_units_search** — Search Trustpilot business units by name, even matching partial names. Returns matching business units with id, displayName, name (identifying and referring), and link. Required: query. - **trustpilot_business_units_list_categories** — List the Trustpilot categories a business unit belongs to. Returns categories. Required: business_unit_id. - **trustpilot_business_units_list_all_reviews** — List all reviews for a Trustpilot business unit. Returns review objects including id, stars, title, text, isVerified, companyReply, consumer, and businessUnit. Required: business_unit_id. This is a public endpoint and won't return customer emails or order IDs. - **trustpilot_business_units_list_reviews** — List the reviews of a Trustpilot business unit. Returns review objects including id, stars, title, text, isVerified, companyReply, consumer, and businessUnit. Required: business_unit_id. - **trustpilot_business_units_list_private_reviews** — List private reviews for a Trustpilot business unit, limited to 100,000 records. Unlike the public reviews endpoint, this includes private details such as the customer's email and order ID. Returns each review's id, stars, title, text, createdAt, isVerified, companyReply, and consumer. Required: business_unit_id. - **get_single_trustpilot_business_unit_by_id** — Get a Trustpilot business unit's public information, including name, URL, and review statistics, by id. Returns: id, displayName, name, websiteUrl, country, numberOfReviews, status, score, badFit, links. Required: id. - **trustpilot_business_units_find** — Find a Trustpilot business unit by its domain name. Returns publicly available information including id, displayName, name, websiteUrl, country, numberOfReviews, and score. Required: name. - **trustpilot_business_units_list_all** — List all Trustpilot business units, including domains with no reviews, each including country information. Returns: id, displayName, name, country, links. - **trustpilot_business_units_get_customer_guarantee** — Get a Trustpilot business unit's Guarantee Box information. Returns: header, teaser, body, display, image, links, message, textColor, backgroundColor, buttonText, buttonColor, buttonTextColor, buttonLink, imageUrl, isPublished. Required: business_unit_id. - **trustpilot_business_units_get_profile_promotion** — Get the key brand messages Promotion Box content for a Trustpilot business unit. Returns: links, title, contactInfoTitle, description, sellingPoints, image, header, message, textColor, backgroundColor, buttonText, buttonColor, buttonTextColor, buttonLink, imageUrl, isPublished. Required: business_unit_id. - **trustpilot_business_units_get_special_deals** — Get the current special deals Promotion Box content for a Trustpilot business unit. Returns: header, message, textColor, backgroundColor, buttonText, buttonColor, buttonTextColor, buttonLink, imageUrl, isPublished. Required: business_unit_id. - **get_single_trustpilot_service_review_by_id** — Get a single Trustpilot service review by id, including its public information (stars, text, consumer, etc.). Returns: id, createdAt, updatedAt, links. Required: id. - **trustpilot_service_reviews_get_private** — Get a single Trustpilot service review by review_id, including private fields such as the number of likes and compliance labels. Returns: id, createdAt, updatedAt, links. Required: review_id. - **trustpilot_service_reviews_list_latest** — List the latest Trustpilot service reviews written in the specified languages. Returns review records with: id, stars, title, text, language, createdAt, consumer, businessUnit. Required: count, language. - **trustpilot_service_reviews_get_web_links** — Get links to a Trustpilot service review's public page on Trustpilot. Returns: links, locale, reviewUrl. Required: review_id, locale. - **trustpilot_service_reviews_get_likes** — List the consumers who have liked a Trustpilot service review. Returns: links. Required: review_id. - **create_a_trustpilot_review_reply** — Post a reply to a Trustpilot service review on behalf of a business user, supplying the reply text and author in the request body. Returns an empty 204 response on success. Required: review_id. - **trustpilot_review_replies_bulk_delete** — Delete the reply to a Trustpilot service review. Returns an empty 204 response on success. Required: review_id. - **list_all_trustpilot_review_tags** — Get all tags on a Trustpilot service review. Returns the review's tags, each with group and value. Required: review_id. - **trustpilot_review_tags_set** — Set the tags on a Trustpilot service review. Use group 'generic' so the tags appear in Trustpilot Business. Returns the review's tags, each with group and value. Required: review_id, tags. - **trustpilot_review_tags_add** — Add tags to a Trustpilot service review. Use group 'generic' so the tags appear in Trustpilot Business. Returns the review's tags, each with group and value. Required: review_id, tags. - **trustpilot_review_tags_remove** — Remove a single tag from a Trustpilot service review, identified by its group and value. Returns an empty 204 response on success. Required: review_id, group, value. - **create_a_trustpilot_find_reviewer_request** — Create a Find Reviewer request for a Trustpilot service review, asking the consumer to supply information such as a reference id. Accepts message and skipNotificationEmailToBusinessUser in the body. Returns the raw HTTP response object documented upstream, with statusCode, reasonPhrase, headers, and isSuccessStatusCode. Required: review_id. - **list_all_trustpilot_products** — List Trustpilot products owned by a business unit, filterable by SKU, group id, and locale. Returns the products array (each with id, sku, title, link, imageLink, price, currency, gtin, mpn, brand, description, productCategory, attributes, variationAttributes, processedImages, groupId and businessUnitId) plus an isLastPage flag. Required: business_unit_id. - **trustpilot_products_batch_upsert** — Batch upsert Trustpilot products for a business unit. Returns: products. Required: business_unit_id and products. - **list_all_trustpilot_catalog_products** — List Trustpilot catalog products with their nested variants for a business unit. Returns: products, isLastPage, matchingProductCount. Required: business_unit_id. Filter by skus, productIds, variantIds, customerProductIds, query, or category; up to 1000 products per page. - **trustpilot_catalog_products_batch_upsert** — Batch upsert Trustpilot catalog products with nested variants in one request, creating, updating, or deleting them. Returns the processed products and a summary with counts (productsCreated, productsUpdated, productsDeleted, variantsCreated, variantsUpdated) and change details. Required: business_unit_id and products. Set isDryRun to true to validate without persisting. - **get_single_trustpilot_catalog_product_by_id** — Get a single Trustpilot catalog product by id with all of its variants nested inside. Returns: productId, businessUnitId, brand, categoryId, customerProductId, content, metadata, variants. Required: id (productId) and business_unit_id. Content and pricing resolve per locale and market; use returnAllLocales/returnAllMarkets to get every stored entry. Cross-business-unit and missing products both… - **delete_a_trustpilot_catalog_product_by_id** — Delete a Trustpilot catalog product by id, cascade-deleting all of its variants in a single transaction. Returns: productId, totalVariantsDeleted, details. Required: id (productId) and business_unit_id. Returns 409 and rejects the entire cascade if any variant under the product has recorded reviews. - **trustpilot_invitations_delete_data** — Delete Trustpilot invitation data for a business unit, either for the specified consumer email addresses or for all data older than a date — the two cannot be combined and the operation is not reversible. Required: business_unit_id plus customerEmails or deleteOlderThan. Returns an empty 204 response on success. - **trustpilot_invitations_create_link** — Generate a unique Trustpilot service review invitation link for a business unit that can be sent to a consumer by email or website; redirectUri takes the user to a product review link after they leave a service review. Returns: id, url. Required: business_unit_id. - **trustpilot_invitations_create_email** — Create Trustpilot email invitation(s) for service and/or product reviews for a business unit. Returns an empty 204 response on success. Required: business_unit_id, consumerEmail, consumerName, locale, referenceNumber, and serviceReviewInvitation.templateId. Hard limits: productReviewInvitation takes products or productSkus, never both; preferredSendTime must be in UTC. - **trustpilot_invitations_list_templates** — List Trustpilot invitation templates available to a business unit, including both default/optimized and custom templates. Returns templates, each with id, name, isDefaultTemplate, locale, language, and type. Required: business_unit_id. - **trustpilot_resources_list_locales** — List all locales supported by Trustpilot, including URLs to each localized Trustpilot site. Returns: locale, language, region, countryId, nativeName, translatedName, tld, consumerWebApp, businessWebApp, legalUrl, commercialUrl, aboutTrustpilotUrl, supportUrl, helpCenterUrl, blog, businessSignupUrl, pressUrl, investorsUrl, jobsUrl, statusPageUrl, isDefaultForLanguage, isSupportedInBusinessWebApp. - **trustpilot_resources_list_countries** — List all countries known to Trustpilot, including each country's name in English. Returns: countryId, country, englishName, locale, translatedName. - **trustpilot_resources_list_images** — List navigational links to all available Trustpilot image resources, including stars, logos, and icons. Returns links, each with href, method, and rel describing an image resource. - **trustpilot_resources_get_star_images** — Get the available Trustpilot star image sizes and URLs for a given star rating. Returns the star128x24, star256x48, star512x96, and starSvg image objects (url, width, height) plus stars. Required: stars. - **trustpilot_resources_get_logos** — Get the available Trustpilot logo image sizes and URLs, for both dark and light backgrounds. Returns darkBackground and lightBackground objects, each with logo72x18, logo144x36, logo288x72, logo576x144, and logoSvg image details. - **trustpilot_resources_get_icons** — Get the Trustpilot icon images for the checkbox icon. Returns the icon image entry image230x230 including its url, width, and height. - **trustpilot_resources_get_star_strings** — Get the Trustpilot text representation of a star rating, such as Excellent. Returns: stars, image230x230. Required: stars, locale. - **trustpilot_consumer_profiles_get_profile** — Get a Trustpilot consumer's profile by consumer id. Returns: id, displayName, about, city, country, locale, gender, hasImage, createdAt, birthYear, profileImage. Required: consumer_id. - **get_single_trustpilot_consumer_profile_by_id** — Get a Trustpilot consumer by id, including the number of reviews the consumer has written and web links. Returns: id, displayName, about, city, country, locale, gender, hasImage, createdAt, birthYear, numberOfReviews, links, profileImage. Required: id. - **trustpilot_consumer_profiles_bulk_get_profiles** — Bulk-fetch Trustpilot consumer profiles for a list of consumer ids in one call. Returns: consumers, notFoundConsumerIds, city, about, displayName, locale, gender, country, id, createdAt, hasImage, birthYear, profileImage. Required: consumerIds. - **trustpilot_consumer_profiles_create_display_name** — Create a valid Trustpilot consumer display name from an input string. Returns an empty 204 response on success. Required: displayName. - **trustpilot_consumer_profiles_validate_display_name** — Validate a Trustpilot consumer display name string. Returns an empty 204 response on success. Required: displayName. - **trustpilot_consumer_profiles_get_web_links** — Get the web links for a Trustpilot consumer by id. Returns: locale, profileUrl, links, city, about, displayName, gender, country, id, createdAt, hasImage, birthYear, profileImage. Required: consumer_id. - **trustpilot_deletions_list_deleted_consumers** — List Trustpilot consumer profiles deleted within a specified date range so you can remove the matching consumer data from your system. Returns: consumerId, deletedAt. Max 1000 per page (default 100). - **trustpilot_deletions_list_deleted_reviews** — List Trustpilot reviews deleted within a specified date range so you can remove the matching review data from your system. Returns: reviewId, deletedAt. Max 1000 per page (default 100). - **trustpilot_deletions_list_deleted_product_reviews** — List Trustpilot product reviews deleted within a specified date range so you can remove the matching product review data from your system. Returns: productReviewId, deletedAt. Max 1000 per page (default 100). - **trustpilot_consumers_list_reviews** — List the reviews written by an individual Trustpilot consumer. Returns each review with id, title, text, stars, language, status, isVerified, businessUnit, consumer, and createdAt. Required: consumer_id. - **list_all_trustpilot_categories** — List Trustpilot categories. Returns: categoryId, displayName, name. - **get_single_trustpilot_category_by_id** — Get details of a specific Trustpilot category by id. Returns: businessUnitCount, parentId, displayName, categoryId, name. Required: id, country. - **trustpilot_categories_list_business_units** — List business units in a Trustpilot category. Returns: businessUnitId, displayName, identifyingName, trustScore, numberOfReviews, rank, location, logoUrl, categories. Rank values are obsolete. Required: category_id. - **list_all_trustpilot_data_solutions_business_units** — List Trustpilot business units via the Data Solutions API, optionally filtered by domain, category, or country. Returns: id, displayName, name, address. - **trustpilot_data_solutions_business_units_list_latest_reviews** — Get the latest reviews for a specific Trustpilot business unit via the Data Solutions API. Returns each review's id, stars, title, text, language, isVerified, createdAt, and consumer (id, displayName). Required: business_unit_id. Accepts limit (1-5). - **trustpilot_business_signup_check_domain_availability** — Check whether a domain is available (unclaimed) in Trustpilot before business signup or claiming a domain. Returns: domainIsAvailable. Required: domain. - **trustpilot_oauth_request_access_token** — Request a Trustpilot access token using the Client Credentials grant with your API key and secret. Returns: access_token, expires_in. Required: grant_type (must be client_credentials). Tokens from this grant cannot be refreshed — re-issue the same request to get a new one. - **trustpilot_oauth_refresh_token** — Refresh a Trustpilot access token by exchanging a refresh token. Returns: access_token, refresh_token. Required: grant_type (must be refresh_token) and refresh_token. Wait until the current access token expires before refreshing — refreshing too often is rejected with HTTP 429. - **trustpilot_oauth_revoke_token** — Revoke a Trustpilot refresh token, which also revokes its related access token. Returns an empty 200 response on success. Required: token (the refresh token to revoke). - **trustpilot_partners_check_permissions** — Check whether a Trustpilot Business customer is eligible to use your Trustpilot partner integration before generating an API key on their behalf. Returns no response body — the eligibility outcome is signaled by the HTTP status code (201 = customer has sufficient rights, 200 = customer lacks rights). Required: partner_id, business_unit_id. The customer must have Partnership Permissions enabled by… - **trustpilot_partners_create_customer_key** — Generate an API key on behalf of a Trustpilot Business customer, creating a PartnerCustomerKey for their business unit. Returns: id, created_at. The customer must have the API module enabled. Required: partner_id, business_unit_id. ## How it works 1. **Link your customer's Trustpilot account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Trustpilot.** The Proxy API is a 1-to-1 mapping of the Trustpilot API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync reviews into helpdesk workflows** — CX and support platforms can pull private reviews with consumer email and reference IDs to auto-create tickets, match reviewers to existing customer records, and let agents reply to Trustpilot directly from their inbox. - **Trigger review invitations from marketing automation** — Email and SMS platforms can generate unique Trustpilot invitation links or queue templated email invitations tied to lifecycle events like order fulfilled or ticket closed, keeping review collection inside the brand's owned channels. - **Enrich storefronts and search with product ratings** — E-commerce search, merchandising, and PDP tools can batch-fetch product review summaries to surface star ratings, review counts, and 'sort by highest rated' functionality on catalog and search pages. - **Feed review data into BI and warehouses** — Analytics platforms can ingest historical service and product reviews along with consumer identifiers and tags to correlate sentiment with LTV, churn, and NPS in downstream dashboards. - **Automate GDPR compliance across systems** — Data platforms can poll Trustpilot's deletion feeds for removed consumers, reviews, and product reviews to scrub matching PII from their own databases and stay compliant with consumer deletion requests. ## What you can build - **Private review-to-ticket sync** — Poll private service and product reviews, match them to internal customers via email or reference ID, and open a support ticket with full review context. - **In-app review reply composer** — Let agents draft and publish replies to Trustpilot reviews from your UI using the review reply endpoint, without opening the Trustpilot dashboard. - **Event-driven invitation engine** — Generate per-consumer invitation links or send templated email invitations when your product detects a triggering event like order delivered or subscription renewed. - **Product catalog sync** — Batch upsert SKUs and variants into Trustpilot's catalog so product reviews map cleanly to the merchant's live inventory. - **AI-driven review tagging** — Run review text through your classifier and write tags like 'Shipping Delay' or 'Product Defect' back to Trustpilot for segmentation and reporting. - **Ratings widget for search and merchandising** — Pull batch product review summaries into your search index to power star badges, review-count filters, and 'highest rated' sort options on storefronts. ## FAQs ### How does authentication work for end users connecting Trustpilot? Trustpilot uses OAuth 2.0. Truto handles the OAuth request, refresh, and revoke flows so your end users authorize once and your app gets long-lived access without you managing tokens or key rotation. ### Can we provision Trustpilot API credentials on behalf of our customers? Yes. Trustpilot's Partner API supports creating customer keys programmatically, which Truto exposes so you can onboard end users without asking them to copy-paste API keys from the Trustpilot Business portal. ### What's the difference between public and private reviews, and which should we use? Public reviews are what's visible on Trustpilot's site. Private reviews additionally expose the consumer's email and any reference/order ID passed at invitation time — this is what you need for identity resolution in CRM, helpdesk, and returns use cases. ### How fresh is the review data we can pull? Trustpilot's API is polling-based rather than webhook-driven for most review resources, so freshness depends on your poll cadence. Truto normalizes pagination and lets you schedule syncs at whatever interval your use case requires. ### Can we send review invitations through our own email or SMS infrastructure? Yes. Use the invitation link endpoint to generate a unique review URL per consumer and embed it in your own branded email or SMS. If you'd rather use Trustpilot's templates, the email invitation endpoint is also supported. ### How do we handle consumer deletion requests for compliance? Trustpilot exposes deletion feeds for consumers, service reviews, and product reviews. You can poll these through Truto and cascade the deletions into your own datastore to stay aligned with GDPR and consumer privacy requests. ## Related reading - [Connect Trustpilot to Claude: Search Business Units & Analyze Ratings](https://truto.one/blog/connect-trustpilot-to-claude-search-business-units-analyze-ratings/) — Learn how to connect Trustpilot to Claude using a managed MCP server. Automate review analysis, search business units, and generate automated replies. - [Connect Trustpilot to ChatGPT: Automate Review Management & Replies](https://truto.one/blog/connect-trustpilot-to-chatgpt-automate-review-management-replies/) — Learn how to build a Trustpilot MCP server to connect ChatGPT to your reviews. Automate replies, tag negative feedback, and send review invites. - [Connect Trustpilot to AI Agents: Sync Catalog Data & Invitations](https://truto.one/blog/connect-trustpilot-to-ai-agents-sync-catalog-data-invitations/) — Learn how to connect Trustpilot to AI agents using Truto's /tools endpoint. Build autonomous workflows for review replies, catalog sync, and invitations.