inetGeek docs
REST APIReference

Providers

List providers

GET
/providers

Providers with their free tier and entry price, filtered by category, name and by which facts they document. Pass has to also get those facts' values, source and date on each row: has=soc2,sso_saml answers "who documents both". A provider documenting a key does not mean the answer is yes; read the value.

Authorization

headerX-Api-Key<token>

A key from POST /keys, starting igk_. Never send it in the URL.

Query Parameters

category?string

A URL section (analytics) or a category id (web-analytics). Providers also listed there are included.

q?string

Matches the start of an id or part of a name, case-insensitively.

has?string

Comma-separated fact keys every returned provider must document. Valid keys from /facts.

limit?integer

Page size, 1 to 200.

Range1 <= value <= 200
Default50
offset?integer

Rows to skip.

Range0 <= value
Default0

Response Body

A page of providers.

application/json
  1. response
data*array<>
page*
Example Request
curl -X GET 'https://inetgeek.com/api/v1/providers'
Example Response
{  "data": [    {      "id": "string",      "name": "string",      "category": "string",      "section": "string",      "also_in": [        "string"      ],      "url": "http://example.com",      "homepage": "http://example.com",      "best_for": "string",      "free_tier": null,      "entry_price": null,      "facts": {        "property1": null,        "property2": null      }    }  ],  "page": {    "total": 0,    "limit": 0,    "offset": 0  }}
GET
/providers/{id}

Every fact the provider documents, each with its label, value, vendor page and the date it was read, plus its iScore in its canonical category.

Authorization

headerX-Api-Key<token>

A key from POST /keys, starting igk_. Never send it in the URL.

Path Parameters

id*string

A provider id such as plausible. Find ids with /providers?q=.

Match^[a-z0-9-]+$

Response Body

The fact sheet.

application/json
  1. response
data*
Example Request
curl -X GET 'https://inetgeek.com/api/v1/providers/plausible'
Example Response
{  "data": {    "id": "string",    "name": "string",    "category": "string",    "section": "string",    "also_in": [      "string"    ],    "url": "http://example.com",    "homepage": "http://example.com",    "best_for": "string",    "free_tier": null,    "entry_price": null,    "facts": {      "property1": {        "value": null,        "display": "string",        "source_url": "http://example.com",        "verified_at": "string",        "label": "string"      },      "property2": {        "value": null,        "display": "string",        "source_url": "http://example.com",        "verified_at": "string",        "label": "string"      }    },    "iscore": null  }}
GET
/providers/{id}/score

0-100 against its category peers with an 80% interval and rank, six pillars each with its interval, weight and coverage, and every scored criterion with the fact it came from. Report the interval with the number. Not comparable across categories.

Authorization

headerX-Api-Key<token>

A key from POST /keys, starting igk_. Never send it in the URL.

Path Parameters

id*string

A provider id such as plausible. Find ids with /providers?q=.

Match^[a-z0-9-]+$

Query Parameters

category?string

A category id the provider is scored in. Defaults to its canonical category.

Response Body

The score.

application/json
  1. response
data*
Example Request
curl -X GET 'https://inetgeek.com/api/v1/providers/plausible/score'
Example Response
{  "data": {    "overall": 0,    "low": 0,    "high": 0,    "distinct": true,    "rank": 0,    "of": 0,    "category": "string",    "coverage": 0,    "id": "string",    "name": "string",    "caveat": "string",    "pillars": {},    "method": "string",    "computed_at": "string"  }}
GET
/providers/{id}/alternatives

Every other provider scored in the category, best first, each with score and interval, free tier and entry price. Neighbouring ranks whose intervals overlap are an ordering, not a finding (distinct: false).

Authorization

headerX-Api-Key<token>

A key from POST /keys, starting igk_. Never send it in the URL.

Path Parameters

id*string

A provider id such as plausible. Find ids with /providers?q=.

Match^[a-z0-9-]+$

Query Parameters

category?string

A category id the provider is scored in. Defaults to its canonical category.

Response Body

The ranked peers.

application/json
  1. response
data*array<>
subject*
computed_at?string
method?string
Example Request
curl -X GET 'https://inetgeek.com/api/v1/providers/plausible/alternatives'
Example Response
{  "data": [    {      "id": "string",      "name": "string",      "category": "string",      "section": "string",      "also_in": [        "string"      ],      "url": "http://example.com",      "homepage": "http://example.com",      "best_for": "string",      "free_tier": null,      "entry_price": null,      "facts": {        "property1": null,        "property2": null      },      "rank": 0,      "iscore": {        "overall": 0,        "low": 0,        "high": 0,        "distinct": true      }    }  ],  "subject": {    "id": "string",    "name": "string",    "category": "string",    "rank": 0,    "of": 0  },  "computed_at": "string",  "method": "string"}