{"openapi":"3.1.0","info":{"title":"BenchGecko API","version":"1.0.0","summary":"AI models, prices per provider, benchmarks and Gecko Tests, as JSON.","description":"Read-only public API of BenchGecko (https://benchgecko.ai). Every JSON response carries source, url, as_of, license, attribution and cite fields. Data BenchGecko collects or measures itself (provider prices, price history, Gecko Tests, mindshare, GPU rental) is CC BY 4.0. Benchmark scores are aggregated from public leaderboards and keep their original source. Attribution required: \"Source: BenchGecko\" with a link. Free tier: 100 requests per day. Remote MCP server: https://benchgecko.ai/api/mcp.","contact":{"name":"BenchGecko","url":"https://benchgecko.ai/api-docs"},"license":{"name":"CC BY 4.0 (BenchGecko collected data)","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://benchgecko.ai"}],"externalDocs":{"description":"API docs","url":"https://benchgecko.ai/api-docs"},"tags":[{"name":"Models","description":"Live model catalog, scores and prices"},{"name":"Pricing","description":"Price history and per-provider offers"},{"name":"Gecko Tests","description":"BenchGecko's own tests (CC BY 4.0)"},{"name":"Exports","description":"Open data CSV exports (CC BY 4.0)"}],"paths":{"/api/v1/models":{"get":{"tags":["Models"],"operationId":"listModels","summary":"List or search models","parameters":[{"name":"q","in":"query","required":false,"description":"Search by name, slug or lab (returns ranked matches)","schema":{"type":"string"}},{"name":"provider","in":"query","required":false,"description":"Filter by provider slug, e.g. anthropic","schema":{"type":"string"}},{"name":"open_source","in":"query","required":false,"description":"Only open weights models","schema":{"type":"string","enum":["true"]}},{"name":"sort","in":"query","required":false,"description":"Sort order","schema":{"type":"string","enum":["avg_score","pricing_input","release_date","context_window"],"default":"avg_score"}},{"name":"limit","in":"query","required":false,"description":"Page size (max 200)","schema":{"type":"integer","default":50,"maximum":200}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Models","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"data":{"type":"array","items":{"type":"object"}},"meta":{"type":"object"}},"additionalProperties":true}}}}}}},"/api/v1/models/{slug}":{"get":{"tags":["Models"],"operationId":"getModel","summary":"Core facts for one model","description":"BenchGecko score and rank, list price, price at every provider, benchmark scores with sources, Gecko Tests grades, as-of dates.","parameters":[{"name":"slug","in":"path","required":true,"description":"Model slug","schema":{"type":"string"},"example":"claude-opus-5-5"}],"responses":{"200":{"description":"Model facts","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"slug":{"type":"string"},"name":{"type":"string"},"provider":{"type":"object"},"benchgecko_score":{"type":["object","null"]},"list_price":{"type":"object"},"providers":{"type":"array","items":{"type":"object"}},"cheapest_provider":{"type":["object","null"]},"scores":{"type":"array","items":{"type":"object"}},"gecko_tests":{"type":["object","null"]},"links":{"type":"object"}},"additionalProperties":true}}}},"404":{"description":"Unknown model"}}}},"/api/v1/compare":{"get":{"tags":["Models"],"operationId":"compareModels","summary":"Compare 2 to 6 models","parameters":[{"name":"models","in":"query","required":true,"description":"Comma separated model slugs","schema":{"type":"string"},"example":"claude-opus-5-5,gpt-5-5"}],"responses":{"200":{"description":"Comparison","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"models":{"type":"array","items":{"type":"object"}},"benchmarks":{"type":"array","items":{"type":"object"}}},"additionalProperties":true}}}}}}},"/api/v1/benchmarks":{"get":{"tags":["Models"],"operationId":"listBenchmarks","summary":"Benchmarks with their top 10 models","parameters":[{"name":"category","in":"query","required":false,"description":"Benchmark category, e.g. coding","schema":{"type":"string"}}],"responses":{"200":{"description":"Benchmarks","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"data":{"type":"array","items":{"type":"object"}}},"additionalProperties":true}}}}}}},"/api/v1/price-history/{slug}":{"get":{"tags":["Pricing"],"operationId":"getPriceHistory","summary":"List price history of one model","description":"One row per recorded change, USD per 1M tokens. Plain array by default (source in headers); add envelope=1 for the wrapped form.","parameters":[{"name":"slug","in":"path","required":true,"description":"Model slug","schema":{"type":"string"},"example":"deepseek-v4-pro"},{"name":"envelope","in":"query","required":false,"description":"Wrap in the standard envelope","schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"Price history","content":{"application/json":{"schema":{"oneOf":[{"type":"array","items":{"type":"object"}},{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"data":{"type":"array","items":{"type":"object"}}},"additionalProperties":true}]}}}}}}},"/api/v1/gecko-tests":{"get":{"tags":["Gecko Tests"],"operationId":"listGeckoTests","summary":"All Gecko Tests with headlines, scorecard top line and latest findings","responses":{"200":{"description":"Gecko Tests index","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"}},"additionalProperties":true}}}}}}},"/api/v1/gecko-tests/{test}":{"get":{"tags":["Gecko Tests"],"operationId":"getGeckoTest","summary":"Results of one Gecko Test, or the scorecard","parameters":[{"name":"test","in":"path","required":true,"schema":{"type":"string","enum":["who-are-you","world-map","censorship-index","knowledge-horizon","tokenizer-tax","same-model-different-host","model-drift-index","scorecard"]}}],"responses":{"200":{"description":"Per-model results","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"headline":{"type":["string","null"]},"results":{"type":"array","items":{"type":"object"}}},"additionalProperties":true}}}},"404":{"description":"Unknown test"}}}},"/api/lab/{test}":{"get":{"tags":["Gecko Tests"],"operationId":"getGeckoTestDataset","summary":"Full open dataset of a Gecko Test: items, runs and every model answer","parameters":[{"name":"test","in":"path","required":true,"schema":{"type":"string","enum":["who-are-you","censorship-index","knowledge-horizon","tokenizer-tax","same-model-different-host","model-drift"]}}],"responses":{"200":{"description":"Dataset","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"items":{"type":"array"},"runs":{"type":"array"}},"additionalProperties":true}}}}}}},"/api/v1/findings":{"get":{"tags":["Gecko Tests"],"operationId":"listFindings","summary":"Latest findings from the Gecko Tests and price data","parameters":[{"name":"limit","in":"query","required":false,"description":"Max items (50)","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Findings","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"},"data":{"type":"array","items":{"type":"object"}}},"additionalProperties":true}}}}}}},"/api/scorecard":{"get":{"tags":["Gecko Tests"],"operationId":"getScorecardCompact","summary":"Gecko Scorecard, compact form (grades per model)","responses":{"200":{"description":"Scorecard","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"}},"additionalProperties":true}}}}}}},"/api/spotlight":{"get":{"tags":["Gecko Tests"],"operationId":"getSpotlight","summary":"The single latest finding (or null)","responses":{"200":{"description":"Latest finding","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"BenchGecko"},"url":{"type":"string","format":"uri","description":"Canonical BenchGecko page for this data"},"as_of":{"type":["string","null"],"description":"Date (YYYY-MM-DD) of the freshest data point in the response"},"license":{"type":"string"},"attribution":{"type":"string","description":"Use \"Source: BenchGecko\" with a link to url"},"cite":{"type":"string","description":"Ready-made citation text"}},"additionalProperties":true}}}}}}},"/api/v1/export/{dataset}":{"get":{"tags":["Exports"],"operationId":"exportDataset","summary":"Open data CSV export (CC BY 4.0)","description":"BenchGecko collected data only. Mirrored daily to https://github.com/BenchGecko/datasets.","parameters":[{"name":"dataset","in":"path","required":true,"schema":{"type":"string","enum":["price-history","provider-offers","price-changes","company-facts","mindshare-daily","gpu-rental-daily","world-map"]}}],"responses":{"200":{"description":"CSV","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/api/v1/search":{"get":{"tags":["Models"],"operationId":"search","summary":"Search models, providers, benchmarks, agents, MCP servers, skills and glossary terms","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"type","in":"query","required":false,"description":"Restrict to one type","schema":{"type":"string","enum":["model","provider","benchmark","agent","mcp","skill","glossary"]}},{"name":"limit","in":"query","required":false,"description":"Max results (50)","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"meta":{"type":"object"}}}}}}}}}}}