API Documentation

Access GS1 Global Product Classification (GPC) data programmatically via our REST API

Base URL

https://api.products.org.ai

Endpoints

GET/{code}.json

Get a product segment, family, class, or brick by GPC code

Example:

curl https://api.products.org.ai/10000000.json Response: { "$type": "Segment", "$id": "https://products.org.ai/10000000", "code": "10000000", "name": "Food/Beverage/Tobacco", "description": "Products that are consumed by humans or animals..." }
GET/all

Get all products (segments, families, classes, and bricks)

Example:

curl https://api.products.org.ai/all Response: [ { "code": "10000000", "name": "Food/Beverage/Tobacco", ... }, ... ]
GET/search?q={query}

Search products by name, description, or code

Example:

curl 'https://api.products.org.ai/search?q=food' Response: { "query": "food", "count": 42, "results": [ { "code": "10000000", "name": "Food/Beverage/Tobacco", ... } ] }
GET/segments

Get all product segments (top-level categories)

Example:

curl https://api.products.org.ai/segments
GET/segments/{code}/families

Get all families within a segment

Example:

curl https://api.products.org.ai/segments/10000000/families

Need more details?

Check out the full API reference for detailed documentation including request/response schemas, authentication, and more.