Back to Apis

Tags

developer-api-tags.md

latest2.9 KB
Original Source

APIs.io API

APIs.io API

Tags

The tag taxonomy, with network-wide ranking metadata.


List and rank tags.

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

/tags

The tag taxonomy with network-wide ranking metadata (composite, frequency, breadth, quality_lift, band). Default sort is by composite score.

List and rank tags. › query Parameters

q ​string · maxLength: 1024

Free-text query over name and description (and tags where applicable).

band ​string · enum · maxLength: 1024

Filter by quality band.

Enum values: strong

healthy

stale

weak

min_api_count ​integer · min: 0 · max: 1000

Only tags applied to at least this many APIs.

sort ​string · enum · maxLength: 1024

Enum values: composite

frequency

breadth

quality_lift

api_count

provider_count

name

Default: composite

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 rank tags. › Responses

200

A page of tags.

TagList

metaMeta · required

Pagination and echoed-query metadata for collection responses.

dataTag[] · maxItems: 1000 · required


Get one tag, with its linked providers, APIs, and neighbors.

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

/tags/{slug}

Returns a single tag by slug, including its network-wide ranking metadata, name variants, neighbor tags, and the providers and APIs it is applied to.

Get one tag, with its linked providers, APIs, and neighbors. › path Parameters

slug ​string · maxLength: 1024 · required

Tag slug (e.g. messaging).

Get one tag, with its linked providers, APIs, and neighbors. › query Parameters

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

Sparse fieldset — comma-separated property names to return.

Get one tag, with its linked providers, APIs, and neighbors. › Responses

200404

The tag.

Tag

slug ​string · maxLength: 1024 · required

name ​string · maxLength: 1024 · required

composite ​number · max: 1000000000

Composite ranking score.

band ​string · enum · maxLength: 1024

Enum values: strong

healthy

stale

weak

frequency ​number · max: 1000000000

breadth ​number · max: 1000000000

quality_lift ​number · max: 1000000000

provider_count ​integer · max: 1000

api_count ​integer · max: 1000

variants ​string[] · maxItems: 1000

neighborsTagRef[] · maxItems: 1000

Related tags.

providersProvider[] · maxItems: 1000

apis ​object[] · maxItems: 1000


APIsIndustries