InternetDB API
InternetDB API — keyless JSON API
InternetDB API. The InternetDB API enables fast lookups of open ports for specific IP addresses, providing insights into the devices using those addresses. It also includes vulnerability metadata to help users assess potential security risks associated with the IPs.
GET https://internetdb.shodan.io/openapi.json
{
"openapi": "3.0.2",
"info": {
"title": "InternetDB",
"description": "Fast IP lookups to get information about open ports",
"version": "1.0.0"
},
"paths": {
"/{ip}": {
"get": {
"summary": "Info",
"description": "Get the open ports, vulnerabilities and other information for an IP",
"operationId": "info__ip__get",
"parameters": [
{
"required": true,
"schema": {
"title": "Ip",
"type": "string"
},
"name": "ip",
"in": "path"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Host"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"HTTPValidationError": {
"title": "HTTPValidationError",
"type": "object",
"properties": {
"detail": {
"title": "Detail",
"type": "array",
"items": {
"$ref": "#/components/schemas/ValidationError"
}
}
}
},
"Host": {
"title": "Host",
"required": [
"cpes",
"hostnames"
],
"type": "object",
"properties": {
"cpes": {
"title": "Cpes",
"type": "array",
"items": {
"type": "string"
}
},
"hostnames": {
"title": "Hostnames",
"type": "array",
"items": {
"type": "string"
}
},
"ip": {
"title": "Ip",
"type": "string"
},
"ports": {
"title": "Ports",
"type": "array",
"items": {
"type": "integer"
}
},
"tags": {
"title": "Tags",
"type": "array",
"items": {
"type": "string"
}
},
"vulns": {
"title": "Vulns",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"ValidationError": {
"title": "ValidationError",
"required": [
"loc",
"msg"
],
"type": "object",
"properties": {
"loc": {
"title": "Location",
"type": "array",
"items": {
"type": "string"
}
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
}
}
}
}
}curl "https://internetdb.shodan.io/openapi.json"const res = await fetch("https://internetdb.shodan.io/openapi.json");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://internetdb.shodan.io/openapi.json")
print(res.json())/openapi.jsonPROBEDInternetDB API — keyless JSON API
/openapi.json?limit=5Paginated variant with limit parameter.
We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.
Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.
InternetDB API: common questions
Is InternetDB API free to use?
Yes — InternetDB API is a free developer tools API. Free tier: Free — limits not published. Whether the free tier allows commercial use is unclear — check the provider docs.
Does InternetDB API need an API key?
No — InternetDB API needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).
Can I call InternetDB API from the browser?
Yes — InternetDB API returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.
Is InternetDB API up right now?
As of our last scheduled check, InternetDB API is healthy with 100% uptime over 90 days and a 133 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.