Loading...
Loading...
Quick start guide for the StorageD API. Full reference coming soon.
Sign up at /signup. Then go to Dashboard → API Keys → Create Key. Your key will look like: sk_live_a1b2c3d4e5f6...
curl -H "X-API-Key: sk_live_YOUR_KEY" \ "https://api.storaged.io/gw/v1/domains/example.com"
Header: X-API-Key: sk_live_...
Query: ?api_key=sk_live_...
Bearer: Authorization: Bearer <jwt_token>
/gw/v1/domains/{domain}Lookup a single domain by namecurl -H "X-API-Key: sk_live_..." https://api.storaged.io/gw/v1/domains/example.com
/gw/v1/searchSearch domains with filters (domain, cms, geo_country, status, server, tld, etc.)curl -H "X-API-Key: sk_live_..." "https://api.storaged.io/gw/v1/search?cms=WordPress&geo_country=DE&status=200&limit=10"
/gw/v1/statsGet database statistics (domain count, uptime, version)curl -H "X-API-Key: sk_live_..." https://api.storaged.io/gw/v1/stats
/gw/v1/agg/{category}Aggregations: zone, tld, cms, server, geo_country, geo_asn, issuer_o, status, etc.curl -H "X-API-Key: sk_live_..." "https://api.storaged.io/gw/v1/agg/cms?top=20"
/gw/v1/exportCreate an export job (CSV, JSON, Parquet)curl -X POST -H "X-API-Key: sk_live_..." -H "Content-Type: application/json" -d '{"filters":{"cms":"WordPress","geo_country":"DE"},"format":"csv"}' https://api.storaged.io/gw/v1/export/gw/v1/export/{id}Get export job statuscurl -H "X-API-Key: sk_live_..." https://api.storaged.io/gw/v1/export/abc123
/gw/v1/export/{id}/downloadDownload completed export filecurl -H "X-API-Key: sk_live_..." https://api.storaged.io/gw/v1/export/abc123/download -o export.csv
/gw/v1/domains/batchLookup multiple domains at once (up to 10,000)curl -X POST -H "X-API-Key: sk_live_..." -d '{"domains":["example.com","google.com"]}' https://api.storaged.io/gw/v1/domains/batch| Field | Type | Description |
|---|---|---|
| domain | string | Full domain name |
| zone | string | TLD zone (com, de, io...) |
| tld | string | Top-level domain |
| http_status | int | HTTP response status code |
| title | string | HTML page title |
| web_server | string | Raw Server header |
| web_server_name | string | Normalized server name |
| ip_addresses | []string | Resolved IP addresses |
| cert_issuer_o | string | SSL cert issuer organization |
| cert_subject_cn | string | SSL cert subject CN |
| cert_san_dns | []string | SSL SAN DNS names |
| cert_not_before | datetime | SSL cert valid from |
| cert_not_after | datetime | SSL cert valid until |
| geo_country | string | GeoIP country code |
| geo_region | string | GeoIP region |
| geo_city | string | GeoIP city |
| geo_asn | int | Autonomous System Number |
| geo_org | string | ASN organization |
| cms_name | string | Detected CMS/technology |
| cms_version | string | CMS version if detected |
| cms_is_cms | bool | Has detected CMS |
| hosting_platform | string | Hosting platform (Blogger, GitHub Pages...) |
| is_subdomain | bool | Is a subdomain |
| is_platform_subdomain | bool | Is a platform subdomain |
| is_infrastructure | bool | Infrastructure domain |
Rate limits are per API key, per day (UTC). Check response headers:
X-RateLimit-Limit: 10000 X-RateLimit-Remaining: 9543