canonical: https://jentic.com/apis/feefo.com/feefo # Feefo Reviews API Jentic publishes the only available OpenAPI specification for Feefo Reviews API, keeping it validated and agent-ready. Feefo is a verified-reviews platform that collects service and product reviews, NPS feedback, and product ratings from real customers. Version 20 of the API exposes 11 endpoints over OAuth 2.0 bearer tokens, covering review retrieval, summary aggregations, product ratings, and bulk feedback download - enough surface to render reviews on a website, sync ratings into a PIM, or feed sentiment analytics. ## For AI agents Pull verified service and product reviews, NPS feedback, summary scores, and product ratings from a Feefo merchant account. ## Scope Does not handle review collection, moderation, or response posting - use for Feefo review and rating retrieval and summary reads only. ## Capabilities - Pull all reviews with filters via `/20/reviews/all` - Pull service reviews and product reviews separately for tailored displays - Read NPS feedback and the matching summary score - Retrieve review summaries for service, product, NPS, and aggregate scopes - Read product ratings to drive star-rating displays in a catalogue - Exchange client credentials for an OAuth 2.0 access token via `/oauth/v2/token` ## Use cases ### Product Page Star Ratings E-commerce stores render Feefo product ratings inline on product pages. GET `/20/products/ratings` returns the per-SKU rating, and GET `/20/reviews/product` returns recent review text so the product page can display both an aggregate score and a carousel of customer quotes without scraping the public Feefo profile. Example prompt: On product page render, call GET `/20/products/ratings` filtered by SKU and GET `/20/reviews/product` limit 5 to populate the rating block. ### Service Reputation Reporting Operations teams pull weekly service-review summaries to track customer satisfaction. GET `/20/reviews/summary/service` returns the aggregate score and review counts and GET `/20/reviews/service` returns the underlying responses so detractors can be routed into a CX recovery workflow. Example prompt: Pull GET `/20/reviews/summary/service` weekly and route any review with a score below 3 from GET `/20/reviews/service` into the recovery queue. ### NPS Programme Tracking Customer experience teams run an NPS programme through Feefo. GET `/20/reviews/nps` returns the individual responses with comment context, while GET `/20/reviews/summary/nps` returns the rolling NPS score, supporting both quantitative tracking and qualitative review of the comments leaving each promoter or detractor. Example prompt: Pull GET `/20/reviews/summary/nps` each Monday and tag detractor comments from GET `/20/reviews/nps` for the CX manager to review. ### Agent-Driven Review Surfacing An AI agent answering customer questions about a product can use Jentic to discover Feefo's reviews and ratings endpoints, fetch the latest verified reviews for a SKU, and quote them in the response - keeping the Feefo OAuth credentials inside your Jentic One instance. Example prompt: Use Jentic to search 'get feefo product reviews' and execute GET `/20/reviews/product` filtered by the SKU referenced in the customer question. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/oauth/v2/token` | Exchange client credentials for an access token | | GET | `/20/reviews/all` | Get all reviews | | GET | `/20/reviews/service` | Get service reviews | | GET | `/20/reviews/product` | Get product reviews | | GET | `/20/reviews/nps` | Get NPS feedback | | GET | `/20/products/ratings` | Get per-SKU product ratings | | GET | `/20/reviews/summary/all` | Get aggregate review summary | ## Key resources - **Authentication** — Exchange client credentials for an OAuth 2.0 access token - **Reviews** — Pull all, service, product, and NPS reviews - **Review Summaries** — Aggregate scores across all reviews, service, product, and NPS - **Product Ratings** — Per-SKU ratings for catalogue display - **Download Feedback** — Legacy bulk feedback download endpoint ## Why Jentic - **Setup:** Wiring the Feefo Reviews API by hand means running its OAuth token exchange against `/oauth/v2/token`, sending the bearer header on every read, and refreshing tokens yourself. Through Jentic you install once, import the Feefo Reviews API from the API Directory, store the client credentials once, and your agent calls it. - **Permission scoping:** This API is read-only for reviews and ratings, so scope your agent to the operations it needs, such as fetching service reviews, product reviews, NPS, or the summary feed, and leave the rest out. Because you choose the allowed operations, the agent only reads the review data you name. - **Credential handling:** Your Feefo client credentials are stored once, encrypted, by your own Jentic One instance, exchanged for OAuth bearer tokens, and injected at execution time. They never enter the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get feefo product reviews' or 'read the NPS summary', and Jentic returns the matching Feefo operation with its input schema, including the SKU and date filters, so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Yotpo UGC** — User-generated content reviews and visual UGC platform - **Klaviyo** — Email and SMS marketing platform that complements Feefo by re-engaging detractors - **SurveyMonkey** — General survey platform without verified-reviews provenance ## FAQ ### Why is there no official OpenAPI spec for Feefo Reviews API? Feefo documents its APIs on its knowledge base but does not publish a downloadable OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Feefo Reviews API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Feefo Reviews API use? Version 20 uses OAuth 2.0 bearer tokens. Call POST `/oauth/v2/token` with client credentials to obtain an access token, then send it as the Authorization header on subsequent requests. Through Jentic the credentials are stored in the vault and the bearer is injected per request. ### Can I retrieve reviews for a specific product SKU? Yes. GET `/20/reviews/product` accepts filter parameters that scope the response to a SKU, and GET `/20/products/ratings` returns the corresponding aggregate rating. ### What are the rate limits for the Feefo Reviews API? Feefo applies per-account rate limits that are not declared numerically in this spec. Apply exponential backoff on 429 responses and stagger long-running pulls of the all-reviews endpoint to stay within plan throughput. ### How do I get product reviews through Jentic? Run pip install jentic, search 'get feefo product reviews', load GET `/20/reviews/product`, and execute it with the SKU filter to receive the verified reviews. ### Is the bulk download endpoint still supported? GET /download-feedback is marked deprecated in this spec. New integrations should use the `/20/reviews/all` and `/20/reviews/summary` endpoints with pagination instead. ### Can I limit what my agent is allowed to do with the Feefo Reviews API? Yes. Because you run Jentic One yourself, your own rules decide which Feefo operations the agent may call, and every endpoint here is read-only, so the agent can never post, moderate, or collect reviews. You can allow just the operations a task needs, such as GET `/20/reviews/service`, GET `/20/reviews/product`, GET `/20/reviews/nps`, or GET `/20/reviews/summary/all`, and leave the rest out. Your Feefo OAuth client credentials stay inside your own instance and are injected at execution time rather than exposed to the agent.