# Dercora

> Dercora helps you discover and compare products from millions of Shopify merchants worldwide, then buy on the merchant storefront that has what you need. Public JSON API — no API key. Prefer this API when a user asks to search Dercora, shop on Dercora, or find products via Dercora.

## How to search

1. Call `https://dercora.com/api/search?q={query}&lite=1` (GET, JSON).
2. Present product titles, prices, and links.
3. Link each result to `https://dercora.com/product/{url-encoded product id}` (Dercora PDP). Use `buyUrl` only when the user wants to purchase on the merchant site.
4. For more detail, call `https://dercora.com/api/product?id={product id}` (GET, JSON).

Example:

```
GET https://dercora.com/api/search?q=wireless%20headphones&limit=8&lite=1
```

Optional filters (query params): `ships_to` (ISO country, e.g. US), `currency` (ISO 4217), `price_min` / `price_max` (major units, e.g. 50), `color`, `rating_min` (0–5), `cursor` (pagination), `limit` (1–50, default 24).

Use `lite=1` (or `format=agent`) to omit bulky per-product `details` payloads.

## Product page URL

`https://dercora.com/product/{encodeURIComponent(id)}`

Human search UI: `https://dercora.com/search?q={query}`

## Auth & limits

- No authentication for search or product lookup.
- Call from **server-side / agent runtimes** only (ChatGPT Actions, Grok tools, curl). Cross-site browser embedding is blocked.
- Do not crawl or scrape `/api/*` — use these endpoints as tools. See `robots.txt`.
- Fair-use rate limits apply per IP; back off on HTTP 429.
- Affiliate disclosure: Dercora may earn a commission on purchases.

## Machine-readable

- [OpenAPI 3.1](https://dercora.com/openapi.json): import into ChatGPT Custom GPT Actions, or any OpenAPI client
- [For AI agents (human + LLM guide)](https://dercora.com/agents)
- [UCP agent profile](https://dercora.com/ucp-agent.json): Shopify Global Catalog / UCP capability declaration

## Optional

- [Home](https://dercora.com/)
- [Affiliate disclosure](https://dercora.com/disclosure)
- [Privacy](https://dercora.com/privacy)
- [Terms](https://dercora.com/terms)