Developer & AI Agent Documentation

Pivota Shopping Agent Protocol

Standardized interface for LLMs (ChatGPT, Claude, Perplexity) to discover, recommend, and facilitate purchases from the Pivota merchant network.

Integration Endpoints

AI Manifest

GET /.well-known/ai-plugin.json

Plugin configuration for ChatGPT and compatible agents. Defines authentication, api type, and description.

OpenAPI Spec

GET /openapi.json

Complete API definition including schema for catalog search and product details.

Core Capabilities

1. Product Discovery

GET /api/catalog?q=keyword&limit=10

Returns a list of products matching the search query. The response is optimized for LLM context windows, providing clear product names, pricing, availability, and tracked "Buy Now" links.

Note: This endpoint includes a "why_recommended" field that helps LLMs explain selection rationale to users.

2. Product Detail

GET /api/catalog/:id

Fetches detailed information for a specific product, including full description and attributes. Use this when a user asks for more details about a specific item found in search.

How to Test

You can test the integration by adding the manifest URL to your Custom GPT or agent configuration:

https://agent.pivota.cc/.well-known/ai-plugin.json

Or visit the catalog endpoint directly to see the JSON structure:

Test Search API