# APIs.guru OpenAPI Directory Search

> APIs.guru OpenAPI Directory Search is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches the APIs.guru open directory for public API providers by domain name, returning their available APIs with metadata including spec URLs, versions, categories, and descriptions.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/apis-guru-openapi-directory?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apis-guru-openapi-directory-search-a21abf78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O-xRbZz2rdHvwUgVbNpLd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability apis-guru-openapi-directory-search-a21abf78
```

Example prompt: Can you look up the APIs.guru directory for 'twilio' and tell me what APIs are listed for them, including the OpenAPI spec URLs and categories?

## When to prefer this

Use this endpoint when you need to programmatically discover OpenAPI/Swagger specification URLs and metadata for known API providers by domain name. It is ideal for agent workflows that need to fetch a spec before calling or analyzing an API. Prefer it over scraping APIs.guru directly since this wrapper is a paid-access, agent-friendly JSON API. Not suitable for searching by category or keyword without a domain name hint.

## Known failure modes

- Query string shorter than 2 or longer than 60 characters returns a validation error
- No matching providers returns an empty results array with count 0
- Provider exists in APIs.guru but has not been indexed recently, so data may be stale
- Limit parameter out of range (must be 1–25) may return an error or be clamped
- Upstream APIs.guru service unavailable causes a proxy error

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the search query, total count of matched providers, source URL, timestamp, and an array of results. Each result includes the provider ID, API title, preferred version, OpenAPI spec URL, description, categories, openapiVersion, and added/updated timestamps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Provider domain or part of it, 2 to 60 characters (e.g. stripe, twilio)"
      },
      "limit": {
       "type": "string",
       "description": "APIs to return, 1 to 25 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "1forge",
  "source": "https://api.apis.guru/v2/providers.json",
  "results": [
   {
    "id": "1forge.com",
    "added": "2017-05-30T08:34:14.000Z",
    "title": "1Forge Finance APIs",
    "specUrl": "https://api.apis.guru/v2/specs/1forge.com/0.0.1/swagger.json",
    "updated": "2017-06-27T16:49:57.000Z",
    "provider": "1forge.com",
    "categories": [
     "financial"
    ],
    "description": "Stock and Forex Data and Realtime Quotes",
    "openapiVersion": "2.0",
    "preferredVersion": "0.0.1"
   }
  ],
  "checkedAt": "2026-10-23T09:37:39.899Z",
  "providersMatched": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apis-guru-openapi-directory-search-a21abf78/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)
