developer-api-regions.md
APIs.io API
Geographic regions grouping providers across the catalog.
/regions
The region taxonomy — geographic groupings of providers across the catalog. Filter by free text; sort by provider or API count.
q
string · maxLength: 1024
Free-text query over name and description (and tags where applicable).
sort
string · enum · maxLength: 1024
Sort order.
Enum values: provider_count
api_count
name
Default: provider_count
fields
string[] · maxItems: 1000 · style: form
Sparse fieldset — comma-separated property names to return.
page
integer · min: 1 · max: 1000000
1-based page number.
Default: 1
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200400
List and filter regions.
meta
Meta · required
Pagination and echoed-query metadata for collection responses.
data
Region[] · maxItems: 1000 · required
/regions/{slug}
Returns a single region by slug, including its aliases, name patterns, counts, and the member providers ranked by score.
slug
string · maxLength: 1024 · required
Region slug (e.g. southeast-asia).
fields
string[] · maxItems: 1000 · style: form
Sparse fieldset — comma-separated property names to return.
200404
Get one region, with its ranked providers.
slug
string · maxLength: 1024 · required
name
string · maxLength: 1024 · required
short
string · maxLength: 1024
One-line summary.
description
string · maxLength: 20000
aliases
string[] · maxItems: 1000
name_patterns
string[] · maxItems: 1000
Country/nationality strings used to infer regional membership.
provider_count
integer · max: 1000
api_count
integer · max: 1000
providers
RankedProvider[] · maxItems: 1000
Member providers, ranked by score. Returned on the single-region endpoint; omitted from list responses by default.
/regions/{slug}/leaders
Returns the highest-composite-scoring member providers of a region.
slug
string · maxLength: 1024 · required
Region slug (e.g. europe).
limit
integer · min: 1 · max: 100
Items per page.
Default: 25
200404
A page of the region's top providers.