Public API v1
AiDiscovery Developer Platform
Structured AI ecosystem data — models, pricing, search and sources — over REST/JSON; the same data the platform itself uses.
- OpenAPI 3.1
- Read-only
- Source-aware
https://api.aidiscovery.ir/api/v101
Quick Start
Create a key and send your first request in minutes.
Authentication
X-Api-Key header or Authorization: Bearer — the secret is shown exactly once.
To request an API key, email support: info@aidiscovery.ir
# اولین درخواست با کلید API:
curl -H "X-Api-Key: ak_live_YOUR_KEY" \
"https://api.aidiscovery.ir/api/v1/public/models?per_page=3"
Request examples
Real samples from the current contract.
curl -H "X-Api-Key: ak_live_YOUR_KEY" \
"https://api.aidiscovery.ir/api/v1/public/search?q=chatgpt&locale=fa"
{
"data": [
{
"id": "0192f3a1-…",
"slug": "gpt-4o",
"company": { "slug": "openai" },
"status": "released",
"context_window_tokens": 128000,
"updated_at": "2026-10-01T10:00:00+00:00"
}
],
"meta": { "current_page": 1, "per_page": 3, "total": 312, "last_page": 104 },
"links": { "first": "…", "last": "…", "next": "…", "prev": null }
}
02
Endpoint groups
- GETModels — AI and language models
/public/models - GETCompanies — AI ecosystem builders
/public/companies - GETProducts — AI company services
/public/products - GETTools — AI-powered tools
/public/tools - GETPlans — Plans
/public/plans - GETPricing — Pricing
/public/pricing - GETSearch — Search
/public/search - GETContent — Content
/public/articles
03
Why the AiDiscovery API?
One source of truth for humans and machines.
- 01
Same platform data
The API runs on the same canonical data model as the website — no second copy.
- 02
Source-aware
Responses can carry verification and freshness signals (verified / stale / conflicting).
- 03
Multilingual
fa / en / zh / ar via the locale parameter — multilingual search with localized names.
- 04
Tiered access
Free to Enterprise — limits are data, not hardcoded.
- 05
Machine-readable
Compact, predictable JSON; ready for agents and future SDKs.
- 06
ETag / 304
Conditional requests on stable endpoints save bandwidth.
04
Rate limits & tiers
Per-tier rate/quota — straight from live api_tiers data.
| Tier | Req/min | Daily quota | Monthly quota | per_page |
|---|---|---|---|---|
| Free | 30 | 1,000 | 25,000 | 25 |
| Developer | 120 | 20,000 | 500,000 | 50 |
| Pro | 300 | 100,000 | 2,000,000 | 100 |
| Business | 600 | ∞ | 10,000,000 | 100 |
| Enterprise | 1,200 | ∞ | ∞ | 100 |
05
API Changelog
Additions, changes and deprecations — never silent.
Build now
Browse the API reference and changelog and start building right away.
To request an API key, email support: info@aidiscovery.ir