Yotpo APIs for AI Agents
AnalyticsWeb AnalyticsStorefrontOfficial Vendor SpecsBearer tokenAPI keyAgent Ready
Yotpo API Catalog
2 APIs across 2 product groups.
Which Yotpo API should I use?
| I want to... | Use | Why |
|---|---|---|
| Read, create, search, or vote on product reviews and ratings | Yotpo UGC API | The UGC API owns reviews, Q&A, product bottom-line ratings, and voting. |
| Read orders, products, customers, and update fulfillments | Yotpo App Developer API | The App Developer API exposes storefront records like orders, products, and fulfillments. |
| Look up product review content | Yotpo UGC API | Product reviews and ratings live in the UGC API, not the storefront API. |
| Look up product records and variants | Yotpo App Developer API | Product listings, variants, and promoted products come from the App Developer API. |
Install Jentic One Beta
Connect the Yotpo APIs to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Yotpo APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fyotpo.com" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fyotpo.com" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Once connected, ask your agent something like: “read Yotpo product reviews and connect them to orders and products”.
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Yotpo by hand means running the UGC API's OAuth token exchange, minting an App Developer API key for the X-Yotpo-Token header, and handling retries on each call yourself. With Jentic One installed you add either Yotpo API from the Jentic directory to your workspace and your agent calls it.
Permission scoping
Yotpo puts review, product, and fulfillment ids in the URL path, so your own rules can pin an agent to specific records and specific operations. Reads like fetching a product's reviews can be allowed while writes such as creating a review or updating a fulfillment stay out unless you add them.
Credential isolation
Each Yotpo credential, the UGC bearer token and the App Developer API key, is stored encrypted by your own Jentic One instance and injected at execution time, so raw secrets never enter the agent's prompt, logs, or context.
FAQs
Specific to using Yotpo APIs through Jentic.
What can an agent do across Yotpo's APIs?
An agent can read and create product reviews, fetch ratings, search review content, and vote on reviews through the UGC API, and read orders, products, customers, variants, and fulfillments and update fulfillment status through the App Developer API. The shared link between them is the product, so review data can be joined to order and product records.
Do the two Yotpo APIs share one credential?
No. The Yotpo UGC API authenticates with a bearer token obtained from its OAuth token exchange, and the Yotpo App Developer API authenticates with an API key in the X-Yotpo-Token header. An agent that spans both needs both credentials configured.
Which Yotpo API should I use for reviews versus orders?
Use the UGC API for reviews, ratings, Q&A, coupons, and email analytics. Use the App Developer API for orders, products, customers, variants, and fulfillments. Product identifiers appear in both, which lets you connect a review to the product and order it belongs to.
Can I combine both Yotpo APIs in one workflow?
Yes. A common pattern is to pull orders and products from the App Developer API and then fetch the matching reviews and ratings from the UGC API, or to check a product rating before updating a fulfillment. Product ids returned by one API are used to query the other.
BOOK A DEMO
Start Connecting APIs to Your AI Agents
Browse thousands of APIs and connect them all to your agent with Jentic One. One layer, one credential — every API your agent needs.
