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

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

band

string · enum

Filter by quality band.

Enum values:

strong

healthy

stale

weak

min_api_count

integer · min: 0

Only tags applied to at least this many APIs.

sort

string · enum

Enum values:

composite

frequency

breadth

quality_lift

api_count

provider_count

name

Default: composite

fields

string[] · style: form

Sparse fieldset — comma-separated property names to return.

page

integer · min: 1

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

Meta · required

Pagination and echoed-query metadata for collection responses.

Tag[] · required

GET/tags

curl https://apis.io/api/v1/tags

Example Responses

{
  "meta": {
    "total": 0,
    "page": 0,
    "limit": 0,
    "pages": 0,
    "query": {}
  },
  "data": [
    {
      "slug": "messaging",
      "name": "Messaging",
      "composite": 0,
      "band": "strong",
      "frequency": 0,
      "breadth": 0,
      "quality_lift": 0,
      "provider_count": 0,
      "api_count": 0,
      "variants": [
        "string"
      ],
      "neighbors": [
        {
          "slug": "slug",
          "name": "name"
        }
      ],
      "providers": [
        {
          "slug": "twilio",
          "name": "name",
          "description": "description",
          "api_count": 0,
          "image": "https://www.example.com/path/to/resource",
          "created": "2024-08-25",
          "common": [
            {
              "type": "type",
              "url": "https://www.example.com/path/to/resource",
              "title": "title"
            }
          ],
          "apis": [
            {
              "name": "name",
              "slug": "slug",
              "description": "description"
            }
          ],
          "tags": [
            "Messaging",
            "Authentication"
          ],
          "score": {
            "composite": 66.3,
            "band": "exemplar",
            "trend": "rising",
            "delta": 0,
            "previous_composite": 0,
            "scored_at": "2024-08-25",
            "schema_version": "0.3",
            "facets": {
              "discoverability": 0,
              "contract_quality": 0,
              "governance": 0,
              "operational_transparency": 0,
              "developer_ergonomics": 0,
              "commercial_clarity": 0
            }
          }
        }
      ],
      "apis": [
        {
          "provider": "provider",
          "slug": "slug",
          "name": "name"
        }
      ]
    }
  ]
}

json

application/json

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 · required

Tag slug (e.g. messaging).

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

fields

string[] · style: form

Sparse fieldset — comma-separated property names to return.

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

The tag.

A tag in the taxonomy, with network-wide ranking metadata.

Tag

slug

string · required

name

string · required

composite

number

Composite ranking score.

band

string · enum

Enum values:

strong

healthy

stale

weak

frequency

number

breadth

number

quality_lift

number

provider_count

integer

api_count

integer

variants

string[]

TagRef[]

Related tags.

Provider[]

object[]

GET/tags/{slug}

curl https://apis.io/api/v1/tags/:slug

Example Responses

{
  "slug": "messaging",
  "name": "Messaging",
  "composite": 0,
  "band": "strong",
  "frequency": 0,
  "breadth": 0,
  "quality_lift": 0,
  "provider_count": 0,
  "api_count": 0,
  "variants": [
    "string"
  ],
  "neighbors": [
    {
      "slug": "slug",
      "name": "name"
    }
  ],
  "providers": [
    {
      "slug": "twilio",
      "name": "name",
      "description": "description",
      "api_count": 0,
      "image": "https://www.example.com/path/to/resource",
      "created": "2024-08-25",
      "common": [
        {
          "type": "type",
          "url": "https://www.example.com/path/to/resource",
          "title": "title"
        }
      ],
      "apis": [
        {
          "name": "name",
          "slug": "slug",
          "description": "description"
        }
      ],
      "tags": [
        "Messaging",
        "Authentication"
      ],
      "score": {
        "composite": 66.3,
        "band": "exemplar",
        "trend": "rising",
        "delta": 0,
        "previous_composite": 0,
        "scored_at": "2024-08-25",
        "schema_version": "0.3",
        "facets": {
          "discoverability": 0,
          "contract_quality": 0,
          "governance": 0,
          "operational_transparency": 0,
          "developer_ergonomics": 0,
          "commercial_clarity": 0
        }
      }
    }
  ],
  "apis": [
    {
      "provider": "provider",
      "slug": "slug",
      "name": "name"
    }
  ]
}

json

application/json

APIs Industries

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

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

band

string · enum

Filter by quality band.

Enum values:

strong

healthy

stale

weak

min_api_count

integer · min: 0

Only tags applied to at least this many APIs.

sort

string · enum

Enum values:

composite

frequency

breadth

quality_lift

api_count

provider_count

name

Default: composite

fields

string[] · style: form

Sparse fieldset — comma-separated property names to return.

page

integer · min: 1

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

Meta · required

Pagination and echoed-query metadata for collection responses.

Tag[] · 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 · required

Tag slug (e.g. messaging).

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

fields

string[] · style: form

Sparse fieldset — comma-separated property names to return.

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

The tag.

A tag in the taxonomy, with network-wide ranking metadata.

Tag

slug

string · required

name

string · required

composite

number

Composite ranking score.

band

string · enum

Enum values:

strong

healthy

stale

weak

frequency

number

breadth

number

quality_lift

number

provider_count

integer

api_count

integer

variants

string[]

TagRef[]

Related tags.

Provider[]

object[]