# BirkinBagStock CLI Quickstart

Public endpoints are CORS-open and require no auth.

## Search inventory
curl -s 'https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&limit=10'

## Print title, price, merchant, buy_url with jq
curl -s 'https://birkinbagstock.com/api/v1/inventory?limit=5' | jq -r '.results[] | [.title, .price, .merchant, .buy_url] | @tsv'

## Best-value feed
curl -s 'https://birkinbagstock.com/data/best-value-birkins.json'

## Dataset metadata and citation
curl -s 'https://birkinbagstock.com/data/dataset-metadata.json'

## Matched repeat-listing index
curl -s 'https://birkinbagstock.com/data/birkin-price-appreciation-index.json'

## Spec price history
curl -s 'https://birkinbagstock.com/data/price-history/birkin-30-gold-togo.json'

## Spec alternatives
curl -s 'https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8'

## Listing alternatives
curl -s 'https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6'

## Source-page index for crawlers and retrievers
curl -s 'https://birkinbagstock.com/data/source-index.json' | jq -r '.groups[] | [.slug, .item_count, .page_count, .href] | @tsv'

## Spec-index navigation
curl -s 'https://birkinbagstock.com/data/spec-index.json' | jq -r '.links[] | [.group, .label, .url] | @tsv' | head

## News locale index
curl -s 'https://birkinbagstock.com/data/news-locales.json' | jq -r '.locales[] | [.code, .label, .api_url, .html_url] | @tsv'

## Python
```python
import requests
r = requests.get('https://birkinbagstock.com/api/v1/inventory', params={'size': 30, 'color': 'Black', 'limit': 5})
for bag in r.json()['results']:
    print(bag['title'], bag['price'], bag['buy_url'])
```

## JavaScript
```js
const r = await fetch('https://birkinbagstock.com/api/v1/inventory?sort=best&limit=8');
const { results } = await r.json();
console.table(results.map(b => ({ title: b.title, price: b.price, buy: b.buy_url })));
```

OpenAPI: https://birkinbagstock.com/openapi.yaml
Agent manifest: https://birkinbagstock.com/agents.json