The Agentic Product Protocol (APP) is an interaction model and open standard for connecting AI agents and product data providers to enable seamless product discovery and comparison.
The specification is maintained by the community and is currently in draft.
- For retailers & marketplaces - Make your product catalog discoverable and searchable by AI agents while maintaining control of your inventory and pricing data.
- For AI agents - Enable product discovery and comparison in your application, providing users with comprehensive product information and merchant offers.
- For comparison platforms - Expose your aggregated product data through a standardized interface that AI agents can consume.
Learn more at the Agentic Product Protocol documentation.
<repo-root>/
├── rfcs/
│ └── rfc.*.md
│
├── spec/
│ ├── openapi/
│ │ └── openapi.*.yaml
│ │
│ └── json-schema/
│ └── schema.*.json
│
├── examples/
│ └── examples.*.json
│
├── changelog/
│ └── *.md
│
├── MAINTAINERS.md
├── CONTRIBUTING.md
├── LICENSE
└── README.md
| Spec Type | Latest Version | Description |
|---|---|---|
| RFC (Markdown) | rfcs/ | Human-readable design doc with rationale, flows, and rollout plan. |
| OpenAPI (YAML) | spec/openapi/ | Machine-readable HTTP API spec for integrating product endpoints. |
| JSON Schema | spec/json-schema/ | Data models for products, offers, and search results. |
| Examples | examples/ | Sample requests, responses. |
| Changelog | changelog/ | API version history and breaking changes. |
The Agentic Product Protocol provides standardized endpoints for:
- Product Search - Search and filter products with rich query capabilities
- Product Listing - Retrieve detailed product information with merchant offers
- Category Discovery - Browse product hierarchies and categories
To start building with APP:
- Review this repo's OpenAPI specs and JSON Schemas.
- Implement the required endpoints on your product data platform.
- Test using the examples provided in this repo.
- Register your implementation with AI agent platforms.
| Area | Resource |
|---|---|
| Product Search Spec | spec/openapi/openapi.product_search.yaml |
| Product Listing Spec | spec/openapi/openapi.product_listing.yaml |
We welcome contributions! See CONTRIBUTING.md for:
- Branching model
- Pull request guidelines
- Spec versioning and review process
All changes must include:
- Updated OpenAPI / JSON Schemas
- New or updated examples
- Changelog entry in
changelog/unreleased.md
AI agents can search across your entire product catalog using natural language queries, with support for filtering by price, category, brand, availability, and more.
Provide comprehensive merchant offers with pricing, shipping costs, stock status, and delivery times, enabling AI agents to help users find the best deals.
Expose detailed product attributes including descriptions, images, ratings, reviews, and technical specifications in a standardized format.
- Authentication - All endpoints require Bearer token authentication
- Rate Limiting - Implement appropriate rate limits to prevent abuse
- Data Privacy - Follow applicable data protection regulations (GDPR, CCPA, etc.)
- PII Handling - Minimize collection of personally identifiable information
Licensed under the Apache 2.0 License.