Trustpilot
API integration

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.