Skip to content
Sign in
Menu

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/apisNone

Live, listed APIs, with optional search and category filter.

Query parameters

NameTypeDefaultDescription
qstring, 1–100 chars—Case-insensitive match on name, description or slug. % and _ match literally.
categorystring—One category slug: ai-ml, data, finance, geo, weather, media, search, developer, other.
sortpopular · price · newestpopularpopular: most paid calls in 30 days. price: cheapest first. newest: most recently created.
limitinteger, 1–10020Page size.
cursorstring—next_cursor from the previous page, with the same sort.

Example

ShellIllustrative values
curl 'https://api.example.com/v1/directory/apis?q=weather&category=weather&sort=price&limit=1'
JSON200 OKIllustrative values
{
  "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…"
}

Responses

StatusDescription
200{ data: DirectoryApi[], next_cursor: string | null }.
422validation_failed: a bad parameter, or a cursor from another sort.
429rate_limited.

Get an API

GET/v1/directory/apis/{slug}None

One live, listed API.

Path parameterDescription
slugThe API's slug.
ShellIllustrative values
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

FieldTypeDescription
slugstringUnique identifier and gateway path.
namestringDisplay name.
descriptionstringWhat the API returns.
categorystringCategory slug.
gateway_urlstringWhere to call it: {gateway origin}/v1/{slug}.
priceMoneyWhat a caller pays per call: provider price plus platform fee.
provider_priceMoneyThe provider's share per call.
platform_feeMoneyNODRA's fee per call.
methodsstring[] | nullAccepted methods; null means GET, POST, PUT, PATCH, DELETE.
success_policyobjectThe billing rule: { mode: "non_empty_2xx" | "any_2xx" } or { mode: "json_field", json_pointer }.
created_atstringWhen the API was registered.
stats_30dobject | nullnull until NODRA has computed stats for the API.
stats_30d.paid_callsintegerSettled calls in the last 30 days.
stats_30d.failed_callsintegerPaid attempts the provider failed or answered unbillably.
stats_30d.success_ratenumber | nullpaid_calls / (paid_calls + failed_calls), 4 decimals. null with no calls.
stats_30d.unique_payersintegerDistinct paying wallets.
stats_30d.volumeMoneyTotal paid by callers.
stats_30d.median_latency_msinteger | nullMedian provider response time.
stats_30d.computed_atstringWhen these stats were computed. They lag live traffic by a few minutes.
JSONDirectoryApiIllustrative values
{
  "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/categoriesNone

Every category in a fixed order, including empty ones.

JSON200 OKIllustrative values
{
  "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 }
  ]
}