# Get started

Ziffi is one API for cross-brand product discovery, pricing, and commerce. It sits over every Shopify brand in the Ziffi graph, so you search, read, price, and buy products across brands through a single, consistent interface. Build a shopping app, a price comparison, a recommendation widget, or an AI shopping agent on top of it.

The API has a free tier you can call right now with no key. Sign up for an API key to get a higher rate limit and to attribute usage to your app.

**Base URL**

```text
https://dev.ziffi.xyz
```

## Your first call

Search across every brand. No key required.

```bash
curl "https://dev.ziffi.xyz/v1/search?q=vitamin+c+serum&limit=3"
```

```python
import httpx
r = httpx.get("https://dev.ziffi.xyz/v1/search", params={"q": "vitamin c serum", "limit": 3})
for card in r.json()["data"]:
    print(card["brand"], "-", card["title"], card["price_min_minor"])
```

```javascript
const r = await fetch("https://dev.ziffi.xyz/v1/search?q=vitamin+c+serum&limit=3");
const { data } = await r.json();
console.log(data.map(c => `${c.brand} - ${c.title}`));
```

## Read the response

Every response is wrapped in the same envelope. Read your results from `data`.

```json
{
  "data": [
    { "id": "…", "product_uid": "sha:…", "title": "…", "brand": "…",
      "price_min_minor": 39900, "currency": "INR", "in_stock": true }
  ],
  "tier": "graph",
  "as_of": "2026-07-07T18:00:00Z",
  "provenance": { "engine": "hybrid" }
}
```

Prices are integer minor units. `39900` with currency `INR` means `399.00`. See [The response envelope](#/envelope).

## Next steps

- [Search products](#/search): modes, filters, and facets.
- [Get a product](#/product): full detail, variants, reviews.
- [Build an AI agent](#/agents): connect the MCP server to ChatGPT or Claude.
- [Authentication](#/authentication): when and how to send a key.