InternetData
Database v2

Metadata

GET
/api/v2/database/metadata

Poll this to decide whether today's build is worth fetching: it carries updated and entries without downloading anything.

No format parameter - one document describes every format the database is built in.

Authorization

apikey<token>

?apikey=<key>. Convenient in a browser or a curl one-liner, which is how a database is usually fetched; prefer a header elsewhere.

This is the same v2 key as the other two schemes. A v1 credential is a different vocabulary and fails validation here, as it would anywhere.

In: query

Query Parameters

id*string

Database identifier (e.g. vpn_ip_v1, resproxy_provider_v1).

Match^[a-zA-Z0-9_]+$

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://internetdata.io/api/v2/database/metadata?id=vpn_ip_v1"
{
  "id": "string",
  "update_freq": "string",
  "updated": "2026-09-04",
  "entries": 0,
  "schema": {
    "property1": [
      {
        "name": "string",
        "type": "string",
        "description": "string"
      }
    ],
    "property2": [
      {
        "name": "string",
        "type": "string",
        "description": "string"
      }
    ]
  },
  "sample": {
    "property1": [
      {}
    ],
    "property2": [
      {}
    ]
  },
  "size": {
    "property1": 0,
    "property2": 0
  }
}
{
  "rc": "string"
}
{
  "rc": "string"
}
{
  "rc": "string"
}
{
  "rc": "string"
}