API Documentation
Everything you need to query the AgentRank index programmatically. The public API is free — no key required.
Base URL
https://agentrank-ai.com Free tier 100 req/min per IP — no key needed
Pro tier 10,000 req/day — API key required
Format JSON. All endpoints are GET unless noted.
Quick Start
First API call in 5 minutes. No key required to start.
Authentication
How to get and use an API key. Free vs Pro access.
Rate Limits
Free tier: 100 req/min per IP. Pro: 10,000 req/day.
API Reference
All endpoints — search, lookup, movers, batch, and more.
SDK Reference
TypeScript/JavaScript SDK — @agentrank/sdk.
Embed & Badges
Live score widgets for READMEs and websites.
Endpoints at a glance
Method Path Description Auth
GET /api/v1/search Search tools, skills, and agents Free GET /api/v1/tool/{id} Get full detail for one tool Free GET /api/v1/movers Biggest rank changes this week Free GET /api/v1/new-tools Newly indexed tools Free GET /api/v2/search Search with rank history Pro GET /api/v2/tool/{id} Tool detail with full rank history Pro POST /api/v2/batch Batch lookup up to 50 tools Pro GET /api/v1/stats Index-wide counts and averages Free Get an API key
The free tier requires no key. For Pro access (10,000 req/day, rank history, batch endpoint), get a key from the pricing page.
Keys look like: ark_pro_a1b2c3d4e5f6...
Pass the key in the Authorization header:
HTTP
Authorization: Bearer ark_pro_your_key_here