find_apis
Paginated, sortable list of APIs across providers — filter by tag, provider, artifact type, industry, region, or rating band. Matching is LEXICAL: q searches the API's own name and description. apis_io_search reports a larger API total for the same q because it also counts every API belonging to a provider whose NAME matched; pass include=["via_provider"] here to get that same union, and meta.query.via_provider says how many rows it added. Use apis_io_search first for a cross-type overview.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free text over name + description. | |
| area | No | ||
| band | No | Rating bands: exemplar, strong, developing, thin, minimal. | |
| page | No | ||
| sort | No | Order results. Default: relevance with a query, composite (quality) when browsing. `demand` = Fortune-1000 adoption, scoped to the query. | |
| tags | No | Tag slugs. On PROVIDERS this is identity — what the company says it does, from its own apis.yml. A resource or operation term (webhook, saml, order, oai-pmh) will correctly match no provider; use find_apis?tags= for those, or find_providers?api_tags= to reach companies whose APIs merely touch it. | |
| view | No | summary (default) returns lean discovery records + *_count for dropped sections; full returns the whole record (use get_api / get_provider for one entity). | summary |
| limit | No | ||
| match | No | any | |
| fields | No | Return exactly these top-level keys (overrides view). | |
| public | No | Only providers callable publicly with no signup (onboarding=open). (providers only) | |
| region | No | ||
| context | No | Optional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable. | |
| include | No | via_provider — also return the APIs of providers whose name matched `q`, the union apis_io_search counts. Needs `q`; adds nothing without one. | |
| pricing | No | Access model — pricing: free, freemium, free-trial, paid, enterprise. (providers only) | |
| resolve | No | When `q` exactly names a tag, apis.io uses it: on PROVIDERS a resource tag (order, webhook, image) replaces the text search with the companies that classify themselves there — 2,182 text matches for "order" become the 92 that claim it; on APIS the tag's members are ADDED to the text matches, never swapped for them. Market tags (payments) and tags almost no company claims are reported and not applied. Set `off` for pure text. The resolution is always echoed as `resolved_tag`. | on |
| try_now | No | Only providers a developer can start using at no cost right now (free/trial + self-serve/open). (providers only) | |
| industry | No | ||
| min_score | No | ||
| providers | No | ||
| onboarding | No | Access model — how to start: open (no key), self-serve, approval. (providers only) | |
| artifact_types | No |