Directory API
Search live APIs, read one listing, and list categories. Public, no authentication.
- Public
- GET only
On this page
List APIs
GET
/v1/directory/apisNoneLive, listed APIs, with optional search and category filter.
Query parameters
| Name | Type | Default | Description |
|---|---|---|---|
q | string, 1–100 chars | — | Case-insensitive match on name, description or slug. % and _ match literally. |
category | string | — | One category slug: ai-ml, data, finance, geo, weather, media, search, developer, other. |
sort | popular · price · newest | popular | popular: most paid calls in 30 days. price: cheapest first. newest: most recently created. |
limit | integer, 1–100 | 20 | Page size. |
cursor | string | — | next_cursor from the previous page, with the same sort. |
Example
curl 'https://api.example.com/v1/directory/apis?q=weather&category=weather&sort=price&limit=1'{
"data": [
{
"slug": "weather-forecasts",
"name": "Weather forecasts",
"description": "Hourly and daily forecasts for any city, as JSON.",
"category": "weather",
"gateway_url": "https://gateway.example.com/v1/weather-forecasts",
"price": { "amount": "13000", "decimals": 6, "currency": "USDC" },
"provider_price": { "amount": "10000", "decimals": 6, "currency": "USDC" },
"platform_fee": { "amount": "3000", "decimals": 6, "currency": "USDC" },
"methods": null,
"success_policy": { "mode": "non_empty_2xx" },
"created_at": "2026-11-15T09:30:00.000Z",
"stats_30d": {
"paid_calls": 412,
"failed_calls": 9,
"success_rate": 0.9786,
"unique_payers": 37,
"volume": { "amount": "5356000", "decimals": 6, "currency": "USDC" },
"median_latency_ms": 184,
"computed_at": "2026-11-16T10:05:00.000Z"
}
}
],
"next_cursor": "WyJwcmljZSIsIjEwMDAwIiwi…"
}Get an API
GET
/v1/directory/apis/{slug}NoneOne live, listed API.
| Path parameter | Description |
|---|---|
slug | The API's slug. |
curl 'https://api.example.com/v1/directory/apis/weather-forecasts'200 returns a DirectoryApi. 404 not_found for an unknown slug, or an API that is a draft, launching, paused or hidden.
The DirectoryApi object
| Field | Type | Description |
|---|---|---|
slug | string | Unique identifier and gateway path. |
name | string | Display name. |
description | string | What the API returns. |
category | string | Category slug. |
gateway_url | string | Where to call it: {gateway origin}/v1/{slug}. |
price | Money | What a caller pays per call: provider price plus platform fee. |
provider_price | Money | The provider's share per call. |
platform_fee | Money | NODRA's fee per call. |
methods | string[] | null | Accepted methods; null means GET, POST, PUT, PATCH, DELETE. |
success_policy | object | The billing rule: { mode: "non_empty_2xx" | "any_2xx" } or { mode: "json_field", json_pointer }. |
created_at | string | When the API was registered. |
stats_30d | object | null | null until NODRA has computed stats for the API. |
stats_30d.paid_calls | integer | Settled calls in the last 30 days. |
stats_30d.failed_calls | integer | Paid attempts the provider failed or answered unbillably. |
stats_30d.success_rate | number | null | paid_calls / (paid_calls + failed_calls), 4 decimals. null with no calls. |
stats_30d.unique_payers | integer | Distinct paying wallets. |
stats_30d.volume | Money | Total paid by callers. |
stats_30d.median_latency_ms | integer | null | Median provider response time. |
stats_30d.computed_at | string | When these stats were computed. They lag live traffic by a few minutes. |
{
"slug": "weather-forecasts",
"name": "Weather forecasts",
"description": "Hourly and daily forecasts for any city, as JSON.",
"category": "weather",
"gateway_url": "https://gateway.example.com/v1/weather-forecasts",
"price": { "amount": "13000", "decimals": 6, "currency": "USDC" },
"provider_price": { "amount": "10000", "decimals": 6, "currency": "USDC" },
"platform_fee": { "amount": "3000", "decimals": 6, "currency": "USDC" },
"methods": null,
"success_policy": { "mode": "non_empty_2xx" },
"created_at": "2026-11-15T09:30:00.000Z",
"stats_30d": {
"paid_calls": 412,
"failed_calls": 9,
"success_rate": 0.9786,
"unique_payers": 37,
"volume": { "amount": "5356000", "decimals": 6, "currency": "USDC" },
"median_latency_ms": 184,
"computed_at": "2026-11-16T10:05:00.000Z"
}
}List categories
GET
/v1/directory/categoriesNoneEvery category in a fixed order, including empty ones.
{
"data": [
{ "slug": "ai-ml", "name": "AI and machine learning", "api_count": 3 },
{ "slug": "data", "name": "Data and analytics", "api_count": 0 },
…
{ "slug": "other", "name": "Other", "api_count": 1 }
]
}