{
  "affiliate_disclosure": "https://buyaigear.com/affiliate-disclosure",
  "auth": {
    "alternative_header": "X-Api-Key: <key>",
    "header": "Authorization: Bearer <key>",
    "keys_from": "https://buyaigear.com/account",
    "optional": true,
    "sign_in": "https://buyaigear.com/login",
    "unknown_key": 401
  },
  "caching": {
    "etag": true,
    "last_modified": true,
    "max_age_seconds": {
      "catalog": 300,
      "changes": 60,
      "models": 3600
    }
  },
  "changelog": [
    {
      "change": "API keys: make one on your account page, send it as Authorization: Bearer, get your own hourly limit",
      "date": "2026-11-06"
    },
    {
      "change": "task endpoints: /recommendations, /compare, /deals, /models/{slug}/hardware",
      "date": "2026-11-06"
    },
    {
      "change": "filters, sorting and cursors on /products; /products/{slug} slimmed with /listings, /models and /history sub-resources; /listings search; exact cursor on /changes; OpenAPI 3.1; prose removed from data responses",
      "date": "2026-11-06"
    },
    {
      "change": "first release",
      "date": "2026-11-06"
    }
  ],
  "contact": {
    "email": "support@buyaigear.com",
    "hello": "https://buyaigear.com/agent/hello?via=api"
  },
  "context_tokens": [
    8192,
    32768
  ],
  "currency": "USD",
  "docs": "https://buyaigear.com/agents",
  "endpoints": [
    {
      "example": "https://buyaigear.com/api/v1/",
      "method": "GET",
      "summary": "this list, the contract and the limits",
      "url": "https://buyaigear.com/api/v1/"
    },
    {
      "example": "https://buyaigear.com/api/v1/products?category=gpu&max_price=1500&sort=price&limit=5",
      "method": "GET",
      "summary": "the catalog, filtered, sorted and paged: category, vendor, platform, memory, price, condition, a model that must fit",
      "url": "https://buyaigear.com/api/v1/products"
    },
    {
      "example": "https://buyaigear.com/api/v1/products/rtx-3090",
      "method": "GET",
      "summary": "one product: specs, prices per channel, cheapest listings, the models that fit, recent daily lows",
      "url": "https://buyaigear.com/api/v1/products/{slug}"
    },
    {
      "example": "https://buyaigear.com/api/v1/products/rtx-5090/listings?q=founders&sort=price&limit=10",
      "method": "GET",
      "summary": "its live eBay listings, filtered and paged",
      "url": "https://buyaigear.com/api/v1/products/{slug}/listings"
    },
    {
      "example": "https://buyaigear.com/api/v1/products/rtx-3090/models",
      "method": "GET",
      "summary": "every reference model on it with the quant it runs at and the estimated speed",
      "url": "https://buyaigear.com/api/v1/products/{slug}/models"
    },
    {
      "example": "https://buyaigear.com/api/v1/products/rtx-3090/history?days=30",
      "method": "GET",
      "summary": "its daily low per day, up to a year",
      "url": "https://buyaigear.com/api/v1/products/{slug}/history"
    },
    {
      "example": "https://buyaigear.com/api/v1/products/rtx-5090/changes?since=2026-11-13T00:00:00Z",
      "method": "GET",
      "summary": "its change feed: new lows, new and ended listings, the same parameters and cursors as /changes",
      "url": "https://buyaigear.com/api/v1/products/{slug}/changes"
    },
    {
      "example": "https://buyaigear.com/api/v1/listings?category=gpu&min_memory_gb=24&max_price=900&limit=10",
      "method": "GET",
      "summary": "live eBay listings across every product, filtered and paged: cheapest 24 GB card under a price in one call",
      "url": "https://buyaigear.com/api/v1/listings"
    },
    {
      "example": "https://buyaigear.com/api/v1/changes?since=2026-11-13T00:00:00Z&type=new_low,new_listing&limit=50",
      "method": "GET",
      "summary": "new lows, new listings and ended listings since a time or cursor",
      "url": "https://buyaigear.com/api/v1/changes"
    },
    {
      "example": "https://buyaigear.com/api/v1/recommendations?model=qwen3.8-27b&budget=2000&limit=5",
      "method": "GET",
      "summary": "machines that run a model under a budget, ranked by price per token per second, speed, price or memory, with why the rest were left out",
      "url": "https://buyaigear.com/api/v1/recommendations"
    },
    {
      "example": "https://buyaigear.com/api/v1/compare?products=rtx-3090,rtx-4090,rtx-5090&model=qwen3.8-27b",
      "method": "GET",
      "summary": "two to four products side by side: specs, prices, fit and speed for a model, and the best in each dimension",
      "url": "https://buyaigear.com/api/v1/compare"
    },
    {
      "example": "https://buyaigear.com/api/v1/deals?days=7&limit=5",
      "method": "GET",
      "summary": "biggest drops, new lows, cheapest per GB and fastest per dollar",
      "url": "https://buyaigear.com/api/v1/deals"
    },
    {
      "example": "https://buyaigear.com/api/v1/models",
      "method": "GET",
      "summary": "the reference models and the memory each needs per quant",
      "url": "https://buyaigear.com/api/v1/models"
    },
    {
      "example": "https://buyaigear.com/api/v1/models/qwen3.8-27b",
      "method": "GET",
      "summary": "one reference model, with the URL that lists the machines it fits",
      "url": "https://buyaigear.com/api/v1/models/{slug}"
    },
    {
      "example": "https://buyaigear.com/api/v1/models/qwen3.8-27b/hardware?limit=5",
      "method": "GET",
      "summary": "every machine that runs a model, fits first then price, with the cheapest at each quant",
      "url": "https://buyaigear.com/api/v1/models/{slug}/hardware"
    },
    {
      "example": "https://buyaigear.com/api/v1/openapi.json",
      "method": "GET",
      "summary": "the OpenAPI 3.1 contract for everything above",
      "url": "https://buyaigear.com/api/v1/openapi.json"
    }
  ],
  "link_policy": "https://buyaigear.com/agents#links",
  "name": "buyaigear API",
  "openapi": "https://buyaigear.com/api/v1/openapi.json",
  "prices": "delivered",
  "privacy": "https://buyaigear.com/privacy",
  "rate_limit": {
    "anonymous_per_hour": 600,
    "keyed_per_hour": 6000,
    "limit_header": "X-RateLimit-Limit",
    "remaining_header": "X-RateLimit-Remaining",
    "retry_header": "Retry-After"
  },
  "terms": "https://buyaigear.com/terms",
  "version": "v1"
}