API Getting Started
The BenchGecko API provides free programmatic access to AI model data, benchmark scores, pricing, and economy indicators.
Quick Start
No API key required for the free tier. Just make HTTP requests:
# Get top 5 models by benchmark score
curl "https://benchgecko.ai/api/v1/models?sort=score&limit=5"
# Compare two models
curl "https://benchgecko.ai/api/v1/compare?models=gpt-5-chat,claude-opus-4-6"
# Get pricing for a specific model
curl "https://benchgecko.ai/api/v1/pricing/gpt-5-chat"
Python
import requests
# Fetch top models
response = requests.get("https://benchgecko.ai/api/v1/models", params={
"sort": "score",
"limit": 10
})
models = response.json()
for model in models["data"]:
print(f"{model['name']}: {model['average_score']} avg, ${model['input_price']}/M in")
JavaScript
const response = await fetch("https://benchgecko.ai/api/v1/models?sort=score&limit=10");
const { data } = await response.json();
data.forEach(model => {
console.log(`${model.name}: ${model.average_score} avg, $${model.input_price}/M in`);
});
Rate Limits
| Tier | Limit | Authentication |
|---|---|---|
| Free | 100 requests/hour | None (attribution required) |
| Authenticated | 1,000 requests/hour | API key in header |
Response Format
All responses follow a consistent JSON structure:
{
"data": [...],
"meta": {
"total": 974,
"page": 1,
"per_page": 20
}
}
Next Steps
- API Endpoints -- complete endpoint reference
- API Examples -- real-world usage patterns
- BenchGecko -- explore the platform