Discovery API

Programmatic access to the GXO registry for discovering brands and their ACP-compliant product feeds.

Base URL

curl
https://feeds.gxo.dev/v1

Endpoints

GET /index.json

Returns a list of all brands in the registry with their feed URLs.

curl
curl https://feeds.gxo.dev/v1/index.json

GET /brands/:slug

Returns detailed information about a specific brand.

curl
curl https://feeds.gxo.dev/v1/brands/acme-electronics

GET /feeds/:brand/products.json

Returns the full product feed for a brand in JSON format.

curl
curl https://feeds.gxo.dev/v1/feeds/acme-electronics/products.json

GET /feeds/:brand/products.ndjson

Returns the product feed in newline-delimited JSON format for streaming.

curl
curl https://feeds.gxo.dev/v1/feeds/acme-electronics/products.ndjson

Rate Limits

  • 60 requests per minute per IP
  • 1,000 requests per hour per IP
  • 10,000 requests per day per IP

Response Headers

  • X-ACP-Version - ACP specification version
  • Cache-Control - Caching directives
  • X-RateLimit-Remaining - Remaining requests
Discovery API | GXO Feeds