Back to Apis

Areas

developer-api-areas.md

latest3.4 KB
Original Source

APIs.io API

APIs.io API

Areas

The API Evangelist areas taxonomy — curated topic collections (authentication, webhooks, payments, …), each a scored provider index with its own site. Pro.


List and filter areas (Pro).

GET https://apis.io/api/v1

/areas

The API Evangelist areas taxonomy — curated topic collections (authentication, webhooks, payments, …), each a scored provider index with its own site. Filter by free text; sort by provider count. Pro tier.

List and filter areas (Pro). › query Parameters

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

List and filter areas (Pro). › Responses

200400403

List and filter areas.

AreaList

metaMeta · required

Pagination and echoed-query metadata for collection responses.

dataArea[] · maxItems: 1000 · required


Get one area, with its ranked providers (Pro).

GET https://apis.io/api/v1

/areas/{slug}

Returns a single area by slug, including its description, site link, counts, and the member providers ranked by score. Pro tier.

Get one area, with its ranked providers (Pro). › path Parameters

slug ​string · maxLength: 1024 · required

Area slug (e.g. authentication).

Get one area, with its ranked providers (Pro). › query Parameters

fields ​string[] · maxItems: 1000 · style: form

Sparse fieldset — comma-separated property names to return.

Get one area, with its ranked providers (Pro). › Responses

200403404

Get one area, with its ranked providers.

Area

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

area_url ​string · uri · maxLength: 2048

The area's dedicated site.

Example: https://authentication.apievangelist.com

area_host ​string · maxLength: 1024

icon ​string · maxLength: 1024

provider_count ​integer · max: 1000

api_count ​integer · max: 1000

providersRankedProvider[] · maxItems: 1000

Member providers, ranked by score. Returned on the single-area endpoint; omitted from list responses by default.


Top-rated providers in a curated area.

GET https://apis.io/api/v1

/areas/{slug}/leaders

Returns the highest-composite-scoring member providers of a curated API Evangelist area.

Top-rated providers in a curated area. › path Parameters

slug ​string · maxLength: 1024 · required

Area slug (e.g. authentication).

Top-rated providers in a curated area. › query Parameters

limit ​integer · min: 1 · max: 100

Items per page.

Default: 25

Top-rated providers in a curated area. › Responses

200404

A page of the area's top providers.


RegionsSynthesis