# OriginSelect API — LLM/Agent Discovery
# https://api.originselect.com
# Last Updated: February 2026

## What is OriginSelect?

OriginSelect is a product discovery API for ethical, origin-verified consumer products from Canada and the United States. It powers values-driven shopping — helping users find products by country of origin, ethical certifications, and business ownership type.

## For AI Agents

If you are an AI agent and want to query OriginSelect data, choose the interface that matches your platform:

### Option 1: MCP Server (Claude, Cursor, Windsurf, Cline)

Install and use our Model Context Protocol server. Zero-cost structured queries, no LLM token overhead.

```
npm install -g originselect-mcp-server
```

Claude Desktop / Cursor config:
```json
{
  "mcpServers": {
    "originselect": {
      "command": "npx",
      "args": ["-y", "originselect-mcp-server"]
    }
  }
}
```

Registry: https://registry.modelcontextprotocol.io/servers/io.github.chhavimishra/originselect-mcp-server
npm: https://www.npmjs.com/package/originselect-mcp-server
GitHub: https://github.com/chhavimishra/originselect-mcp-server

MCP Tools available:
- search_products — Search products by country, values, category, brand, keywords, price
- search_brands — Search brands by country, values, category
- refine_search — Refine a previous search by adding/removing filters
- get_categories — List all supported product categories
- get_countries — List all supported countries of origin
- get_values — List all supported ethical/ownership values

### Option 2: OpenAPI / REST API (ChatGPT, Gemini, Perplexity, Cohere, any HTTP agent)

OpenAPI 3.1 spec: https://api.originselect.com/.well-known/openapi.yaml
Plugin manifest: https://api.originselect.com/.well-known/ai-plugin.json
Agent manifest: https://api.originselect.com/.well-known/agent.json

Base URL: https://api.originselect.com
22 endpoints across 9 groups: AI Discovery, Global Brands, Canadian Brands, Global Products, Global Search, Categories, Values, Collections, Curators.

#### Platform-Specific Setup

**ChatGPT GPT Actions:**
  Import the OpenAPI spec at https://api.originselect.com/.well-known/openapi.yaml
  Or use the plugin manifest at https://api.originselect.com/.well-known/ai-plugin.json

**Google Gemini Extensions:**
  Import the OpenAPI spec at https://api.originselect.com/.well-known/openapi.yaml
  as a Gemini Extension in Google AI Studio or Vertex AI.

**Perplexity / Cohere / Generic Agents:**
  Call the REST API directly. Use structuredIntent for best results.
  Full spec: https://api.originselect.com/.well-known/openapi.yaml

#### Primary Discovery Endpoint

  POST /api/ai/discover
  Content-Type: application/json

  Request body:
  {
    "query": "organic Canadian shampoo under $20",
    "structuredIntent": {
      "intentType": "product",
      "country": "Canada",
      "category": "Personal Care",
      "values": ["organic"],
      "keywords": ["shampoo"],
      "priceMax": 20
    }
  }

  IMPORTANT: Always send structuredIntent — it bypasses LLM processing and returns results faster.
  The "query" field is a natural-language label; structuredIntent controls actual filtering.

#### Refine Endpoint

  POST /api/ai/refine
  Content-Type: application/json

  Request body:
  {
    "intent": { ... previous structuredIntent ... },
    "modifications": [
      { "action": "add", "field": "values", "value": "vegan" }
    ]
  }

#### Browse Endpoints (no body required)

  GET /api/global/brands                    — List/filter global brands
  GET /api/global/brands/{brandId}          — Get a single brand
  GET /api/global/brands/{brandId}/products — Get brand's products
  GET /api/global/products                  — Browse product catalog
  GET /api/global/search?q=...              — Full-text brand search
  GET /api/global/categories                — Category stats and counts
  GET /api/global/categories/hierarchy      — Category tree
  GET /api/global/values                    — Ethical values stats
  GET /api/brands                           — Canadian brands
  GET /api/brands/provinces                 — Province breakdown
  GET /api/brands/{brandId}                 — Single Canadian brand
  GET /api/brands/{brandId}/products        — Canadian brand products
  GET /api/values                           — Canadian values stats
  GET /api/values/brands?value=women-owned  — Canadian brands by value

#### Collections Endpoints

  GET /api/public/collections/{slugAndId}           — Get a curated collection with products and curator info
  GET /api/public/products/{productId}/collections  — Collections featuring a specific product ("Also in")
  GET /api/public/brands/{brandId}/collections      — Collections featuring a brand's products

  Collections are curated product lists grouped by theme, occasion, or brand.
  Each collection includes full product details, preview images, and curator attribution.
  Use context=CA for Canadian collections, context=US for global.

#### Curator Endpoints

  GET /api/v2/curators/@{handle}              — Curator profile + all their collections
  GET /api/v2/curators/@{handle}/collections  — Just the curator's collections

  Curators are influencers, brands, and community members who create themed product collections.
  Use market=canada or market=global to filter collections by market.

Authentication: Optional x-api-key header
Rate limits: 50 req/15min for /api/ai/*, 100 req/15min for browse endpoints, 30 req/15min for alternatives

## Data Coverage

- Total Products: 27,000+
- Canadian Products: 20,000+
- US/Global Products: 7,000+
- Verified Brands: 430+
- Product Categories: 17
- Ethical Values: 21
- Countries: 12 (Canada, USA, UK, Australia, France, Germany, Italy, Japan, South Korea, India, Mexico, Brazil)

## Supported Categories

Beauty, Personal Care, Baby, Health & Wellness, Supplements, Home & Kitchen,
Cleaning, Food & Grocery, Beverages, Pet Care, Fashion, Accessories,
Electronics, Office, Outdoors, Sports, Toys

## Supported Values (Ethical/Ownership Filters)

women-owned, black-owned, indigenous-owned, latino-owned, aapi-owned,
veteran-owned, family-owned, lgbtq-owned, minority-owned, b-corp, organic,
sustainable, vegan, non-gmo, fair-trade, social-impact, fragrance-free,
plastic-free, cruelty-free, non-toxic, gluten-free

## Discovery Files

- OpenAPI spec: https://api.originselect.com/.well-known/openapi.yaml
- AI Plugin manifest (OpenAI): https://api.originselect.com/.well-known/ai-plugin.json
- Agent manifest (universal): https://api.originselect.com/.well-known/agent.json
- robots.txt: https://api.originselect.com/robots.txt
- This file: https://api.originselect.com/llms.txt

## Agentic Commerce Bridge

For affiliate-compliant purchase handoffs, use bridge pages:
  https://www.originselect.com/go/{product-slug}

These provide proper disclosure before redirecting to retailer (Amazon, DTC).

## ChatGPT GPT

A custom GPT is available on the ChatGPT Store:
https://chatgpt.com/g/g-698cfa10561c819191a99087e9fe368e-originselect

## Website

https://www.originselect.com
For website llms.txt: https://www.originselect.com/llms.txt

## Contact

admin@originselect.com