Skip to content
cresvaDevelopers

Storefront API

Every operation this API exposes, one page each. The pages are generated from an OpenAPI document that lives beside the routes, and a test there fails in both directions: when a route has no entry, and when an entry has no route.

35 of these 48 operations need no credential at all. An agent that has just found a storefront holds no key for it, so a storefront that demanded one before it would say what it sells could never be found by the agents it exists to serve.

Rate limits

10No keyper minute, per IP
60Public keyper minute
300Secret keyper minute
10000Per brandper minute, all callers

Enforced per minute. There is no daily or monthly limit of any kind. These four numbers reach this page from the same constants the limiter reads, so a change to the limiter changes this page or fails the build.

Discovery

Finding a storefront and reading what it supports.

GET/{brandId}
The storefront's own description of itselfno key · 10/min
GET/{brandId}/discovery
Protocol discovery for this brandno key · 10/min
GET/{brandId}/docs
Documentation for this storefront, HTML or JSON by Acceptno key · 10/min
GET/{brandId}/quickstart/{guide}
A named quickstart guideno key · 10/min

Catalogue

Reading products. There is no write path.

GET/{brandId}/products
List the catalogueno key · 10/min
GET/{brandId}/products/{productId}
One productno key · 10/min
GET/{brandId}/search
Keyword searchno key · 10/min
GET/{brandId}/compare
Compare two or more productsno key · 10/min
GET/{brandId}/recommend
Related products for one productno key · 10/min
GET/{brandId}/reviews/{productId}
Reviews for one productno key · 10/min
POST/{brandId}/query
Structured agent queryno key · 10/min

Pricing

Prices and price holds.

POST/{brandId}/pricing
Price a set of productspublic key · 60/min
GET/{brandId}/pricing/hold
Read a price holdpublic key · 60/min
POST/{brandId}/pricing/hold
Take a price holdsecret key · 300/min

Offers

Offers, claims and bundles.

GET/{brandId}/offers
List active offersno key · 10/min
GET/{brandId}/offers/{offerId}
One offerno key · 10/min
POST/{brandId}/offers/{offerId}/claim
Claim an offersecret key · 300/min
GET/{brandId}/bundles
List bundlesno key · 10/min
GET/{brandId}/bundles/for-product/{productId}
Bundles containing one productno key · 10/min

Negotiation

Agreeing a price.

POST/{brandId}/negotiate
Agent to agent price negotiationsecret key · 300/min

Checkout

The purchase path. The buyer pays the merchant.

POST/{brandId}/checkout/sessions
Open a checkout sessionsecret key · 300/min
GET/{brandId}/checkout/sessions/{sessionId}/status
Has the buyer paid yetsecret key · 300/min
POST/{brandId}/checkout/sessions/{sessionId}/complete
Complete the session and get a link for the buyer to paysecret key · 300/min

Transactions

Reading and closing an order.

POST/{brandId}/transactionswithdrawn
WITHDRAWN. Returns 410 Gone.no key · 10/min
GET/{brandId}/transactions/{transactionId}
Read one transactionno key · 10/min
POST/{brandId}/transactions/{transactionId}/confirm
Confirm a transactionsecret key · 300/min
POST/{brandId}/transactions/{transactionId}/cancel
Cancel a transactionsecret key · 300/min
POST/{brandId}/transactions/{transactionId}/confirmation-window/confirm
Close the confirmation window earlysecret key · 300/min
POST/{brandId}/transactions/{transactionId}/confirmation-window/dispute
Record a dispute within the confirmation windowsecret key · 300/min
GET/{brandId}/fulfillment
Fulfillment information for this storefrontno key · 10/min

Trust

Scores, signals, feedback and certification.

GET/trust/compare
Compare trust scores across brandsno key · 10/min
GET/{brandId}/trust
The trust score, its components, and how much was measuredno key · 10/min
GET/{brandId}/trust/signals
The signals behind the trust scoreno key · 10/min
GET/{brandId}/trust/network
The federated trust viewno key · 10/min
GET/{brandId}/trust/network/category
Trust across a categoryno key · 10/min
POST/{brandId}/trust/network/compare
Compare trust across brandsno key · 10/min
GET/{brandId}/certification
The storefront's certification, if anyno key · 10/min
GET/{brandId}/feedback
Read feedback for this storefrontno key · 10/min
POST/{brandId}/feedback
Submit feedbackpublic key · 60/min

Feeds

The catalogue reshaped for a named platform.

GET/{brandId}/platforms/google/feed
The catalogue in Google Merchant shapeno key · 10/min
GET/{brandId}/platforms/meta/catalog
The catalogue in Meta catalog shapeno key · 10/min
GET/{brandId}/platforms/openai/openapi
A ChatGPT tailored OpenAPI document for this brandno key · 10/min
GET/{brandId}/platforms/perplexity/config
Perplexity configuration for this brandno key · 10/min

Platform

Not brand scoped.

GET/health
Liveness of the storefront surfaceno key · 10/min
GET/docs
Generic HTML documentation, with {brandId} placeholdersno key · 10/min

SDK

Generated quickstarts.

GET/sdk/curl
A ready to run cURL quickstartno key · 10/min
GET/sdk/javascript
A JavaScript quickstartno key · 10/min
GET/sdk/python
A Python quickstartno key · 10/min

Generated from the storefront OpenAPI document at growthagents 269d7898b, sha256 047fe4d301258100, copied 2026-09-16. Responses were captured against production on 2026-09-16: 30 of 32 operations that need no key, with a recorded reason for each one that could not be called.