{"openapi":"3.1.0","info":{"title":"getdomaindata.com API","version":"1","description":"Technology and domain intelligence over HTTPS: the technologies a website runs, its hosting and identity fields, and our latest traffic and employee estimates. Bearer-key auth. Metered by domains queried. Docs: https://getdomaindata.com/docs/api","contact":{"email":"contact@getdomaindata.com"},"termsOfService":"https://getdomaindata.com/terms"},"servers":[{"url":"https://getdomaindata.com/api/v1"}],"components":{"securitySchemes":{"bearerKey":{"type":"http","scheme":"bearer","description":"Keys look like gdd_live_ followed by 48 hex characters. Create one on https://getdomaindata.com/account (paid plans). Send it only in the Authorization header, never in a URL."}},"headers":{"X-Quota-Limit":{"description":"Lookups included this month (plan + packs).","schema":{"type":"integer"}},"X-Quota-Remaining":{"description":"Lookups left this month.","schema":{"type":"integer"}},"X-Quota-Reset":{"description":"When the month rolls over.","schema":{"type":"string"}}}},"paths":{"/domain/{domain}":{"get":{"operationId":"domain","summary":"Domain profile","description":"Everything we serve for one hostname: its technologies, network, platform, identity fields, and the latest traffic and employee estimates where we hold them. Costs 1 lookup when we hold it, otherwise free.","security":[{"bearerKey":[]}],"parameters":[{"name":"domain","in":"path","required":true,"description":"A hostname or a URL, for example allbirds.com, shop.example.co.uk or https://www.allbirds.com/pages/about. We drop the scheme, path, port and a leading www. Profiles are per hostname, so a subdomain is its own record.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"domain":"allbirds.com","resolves":true,"technologies":["Amazon SES","Apple","Cloudflare","DigiCert/Azure","DocuSign","Google","Google Tag Manager","HSTS","..."],"network":"Shopify","platform":"shopify","registrar":null,"age_days":null,"country_iso":null,"lang_norm":"en","http_status":null,"redirect_to":null,"traffic":{"estimated_monthly_visits":2079697,"band":"1M-10M","as_of":"2026-09"},"employees":{"apex":"allbirds.com","low":501,"high":2000,"point":null,"as_of":"2026-09-10"},"apps":[{"platform":"shopify","name":"Attentive"},{"platform":"shopify","name":"Elevar Conversion Tracking"},{"platform":"shopify","name":"Redo"}]}}}}},"400":{"description":"bad_domain: We could not read a hostname out of what you sent. No lookup was spent. Send a hostname or a URL. We drop the scheme, path, port and a leading www. before the lookup, so https://www.acme.com/about and acme.com are the same request.","content":{"application/json":{"example":{"error":"bad_domain"}}}},"401":{"description":"invalid_key: The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.","content":{"application/json":{"example":{"error":"invalid_key"}}}},"402":{"description":"quota_exhausted: This month's lookups are spent. Wait for the first of the month, or add a pack from the account page. The API never throttles silently.","content":{"application/json":{"example":{"error":"quota_exhausted"}}}},"403":{"description":"not_a_paid_plan: This account's plan does not include this. Packs need a paid plan. Choose a plan on the pricing page. Retrying will not help. account_suspended: The account behind this key is suspended. Write to contact@getdomaindata.com. Retrying will not help.","content":{"application/json":{"example":{"error":"not_a_paid_plan"}}}},"404":{"description":"not_found: We do not hold that domain or technology. Nothing to retry. A miss spends nothing, up to as many misses a day as your plan has lookups a month.","content":{"application/json":{"example":{"error":"not_found"}}}},"429":{"description":"too_many_failed_auth: Too many requests from your address carried a key we do not recognize. Fix the key, then retry after the Retry-After header. A valid key from the same address still works. rate_limited: Too many lookups this minute for your plan. Back off until the reset time in the body, then retry.","content":{"application/json":{"example":{"error":"too_many_failed_auth"}}}},"503":{"description":"metering_unavailable: The quota or the data could not be read, so nothing was served. Retry in a moment. No lookup was spent.","content":{"application/json":{"example":{"error":"metering_unavailable"}}}}}}},"/domains/batch":{"post":{"operationId":"batch","summary":"Batch profiles","description":"Up to 100 profiles in one call, each with the same fields as the single-domain profile, including the latest traffic and employee estimates. Hostnames we do not hold come back in a missing array. Costs 1 lookup per domain we hold.","security":[{"bearerKey":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"domain":"allbirds.com","resolves":true,"technologies":["Amazon SES","Apple","Cloudflare","DigiCert/Azure","DocuSign","Google","Google Tag Manager","HSTS","..."],"network":"Shopify","platform":"shopify","registrar":null,"age_days":null,"country_iso":null,"lang_norm":"en","http_status":null,"redirect_to":null,"traffic":{"estimated_monthly_visits":2079697,"band":"1M-10M","as_of":"2026-09"},"employees":{"apex":"allbirds.com","low":501,"high":2000,"point":null,"as_of":"2026-09-10"},"apps":[{"platform":"shopify","name":"Attentive"},{"platform":"shopify","name":"Elevar Conversion Tracking"},{"platform":"shopify","name":"Redo"}]}],"missing":["example.invalid"]}}}},"400":{"description":"bad_batch: The body is not {\"domains\": [...]} with 1 to 100 entries we can read as hostnames. No lookup was spent. Send a JSON body with a domains array of at most 100 hostnames or URLs. The response names up to ten entries we could not read, in an invalid array.","content":{"application/json":{"example":{"error":"bad_batch"}}}},"401":{"description":"invalid_key: The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.","content":{"application/json":{"example":{"error":"invalid_key"}}}},"402":{"description":"quota_exhausted: This month's lookups are spent. Wait for the first of the month, or add a pack from the account page. The API never throttles silently.","content":{"application/json":{"example":{"error":"quota_exhausted"}}}},"403":{"description":"not_a_paid_plan: This account's plan does not include this. Packs need a paid plan. Choose a plan on the pricing page. Retrying will not help. account_suspended: The account behind this key is suspended. Write to contact@getdomaindata.com. Retrying will not help.","content":{"application/json":{"example":{"error":"not_a_paid_plan"}}}},"429":{"description":"too_many_failed_auth: Too many requests from your address carried a key we do not recognize. Fix the key, then retry after the Retry-After header. A valid key from the same address still works. rate_limited: Too many lookups this minute for your plan. Back off until the reset time in the body, then retry.","content":{"application/json":{"example":{"error":"too_many_failed_auth"}}}},"503":{"description":"metering_unavailable: The quota or the data could not be read, so nothing was served. Retry in a moment. No lookup was spent.","content":{"application/json":{"example":{"error":"metering_unavailable"}}}}},"requestBody":{"required":true,"content":{"application/json":{"example":{"domains":["allbirds.com","example.invalid"]}}}}}},"/enrich":{"post":{"operationId":"enrich","summary":"Enrichment row","description":"The profile, the latest traffic estimate and the latest employee estimate for one domain as a single flat object, built for tools that map JSON paths onto table columns, such as a spreadsheet. Every key is always present and null where we hold nothing. A hostname we hold nothing on is a 200 with found false, not a 404, so a table run does not stop on it. Costs 1 lookup when we hold it, otherwise free.","security":[{"bearerKey":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"domain":"gymshark.com","found":true,"resolves":true,"platform":"shopify","network":"Shopify","country_iso":null,"lang_norm":"en","technologies":["Adobe","Adobe Acrobat Sign","Afterpay","Algolia","Amazon CloudFront","Amazon Web Services","Anthropic","Apple","Atlassian","Cloudflare","Contentful","Facebook Pixel","GlobalSign","Google","Google Tag Manager","HSTS","HTTP/3","Linkedin Insight Tag","Mailchimp","Meta","Microsoft 365","Mixpanel","mParticle","Next.js","OneTrust","Open Graph","OpenAI","PayPal","Proofpoint","PWA","React","SendGrid","Shopify","Webpack","Zoom"],"technologies_text":"Adobe, Adobe Acrobat Sign, Afterpay, Algolia, Amazon CloudFront, Amazon Web Services, Anthropic, Apple, Atlassian, Cloudflare, Contentful, Facebook Pixel, GlobalSign, Google, Google Tag Manager, HSTS, HTTP/3, Linkedin Insight Tag, Mailchimp, Meta, Microsoft 365, Mixpanel, mParticle, Next.js, OneTrust, Open Graph, OpenAI, PayPal, Proofpoint, PWA, React, SendGrid, Shopify, Webpack, Zoom","technology_count":35,"apps":["Sitemap NoIndex Pro SEO"],"tech_ecommerce":["Shopify"],"tech_payments":["Afterpay","PayPal"],"tech_website_platforms":["Contentful"],"tech_wordpress":null,"tech_analytics":["Google Tag Manager"],"tech_advertising":["Facebook Pixel","Linkedin Insight Tag"],"tech_email_marketing":["Mailchimp"],"tech_marketing":null,"tech_chat_support":null,"tech_sales":null,"tech_forms":null,"tech_business_email":["Microsoft 365","Proofpoint"],"tech_business_collaboration":["Adobe","Atlassian","Zoom"],"tech_communications":["SendGrid"],"tech_hosting":["Amazon Web Services"],"tech_cdn":["Amazon CloudFront","Cloudflare"],"tech_security":["Apple","GlobalSign","HSTS"],"tech_privacy":["OneTrust"],"tech_web_servers":["HTTP/3"],"tech_languages_frameworks":null,"tech_frontend_frameworks":["Next.js","PWA","React"],"tech_javascript_libraries":["Webpack"],"tech_databases":null,"tech_performance":null,"tech_media":null,"tech_social_media_community":["Meta"],"tech_seo":["Google","Open Graph"],"tech_fonts_icons":null,"tech_developer_tools":null,"tech_other":["Adobe Acrobat Sign","Algolia","Anthropic","Mixpanel","mParticle","OpenAI"],"estimated_monthly_visits":12647363,"traffic_band":"10M-100M","traffic_month":"2026-09","estimated_employees_low":501,"estimated_employees_high":2000,"employees_range":"501 to 2,000","employees_as_of":"2026-09-10","employees_apex":"gymshark.com"}}}}},"400":{"description":"bad_domain: We could not read a hostname out of what you sent. No lookup was spent. Send a hostname or a URL. We drop the scheme, path, port and a leading www. before the lookup, so https://www.acme.com/about and acme.com are the same request.","content":{"application/json":{"example":{"error":"bad_domain"}}}},"401":{"description":"invalid_key: The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.","content":{"application/json":{"example":{"error":"invalid_key"}}}},"402":{"description":"quota_exhausted: This month's lookups are spent. Wait for the first of the month, or add a pack from the account page. The API never throttles silently.","content":{"application/json":{"example":{"error":"quota_exhausted"}}}},"403":{"description":"not_a_paid_plan: This account's plan does not include this. Packs need a paid plan. Choose a plan on the pricing page. Retrying will not help. account_suspended: The account behind this key is suspended. Write to contact@getdomaindata.com. Retrying will not help.","content":{"application/json":{"example":{"error":"not_a_paid_plan"}}}},"429":{"description":"too_many_failed_auth: Too many requests from your address carried a key we do not recognize. Fix the key, then retry after the Retry-After header. A valid key from the same address still works. rate_limited: Too many lookups this minute for your plan. Back off until the reset time in the body, then retry.","content":{"application/json":{"example":{"error":"too_many_failed_auth"}}}},"503":{"description":"metering_unavailable: The quota or the data could not be read, so nothing was served. Retry in a moment. No lookup was spent.","content":{"application/json":{"example":{"error":"metering_unavailable"}}}}},"requestBody":{"required":true,"content":{"application/json":{"example":{"input":"https://www.gymshark.com/"}}}}}},"/traffic/{host}":{"get":{"operationId":"traffic","summary":"Traffic estimate with history","description":"Our estimated monthly visits for one hostname, with the month-by-month history behind the current figure. The basic profile already carries the latest figure; use this when you want the series. Costs 1 lookup when we hold it, otherwise free.","security":[{"bearerKey":[]}],"parameters":[{"name":"host","in":"path","required":true,"description":"A hostname or a URL. Estimates are per hostname and do not carry across subdomains; a leading www. is folded into the bare domain, which is the row we hold.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"host":"allbirds.com","estimated_monthly_visits":2079697,"band":"1M-10M","as_of":"2026-09","history":[{"month":"2026-07","visits":2050000},{"month":"2026-08","visits":2110000},{"month":"2026-09","visits":2079697}]}}}}},"400":{"description":"bad_host: Same as bad_domain: nothing hostname-shaped in the input. No lookup was spent. Same rule as bad_domain.","content":{"application/json":{"example":{"error":"bad_host"}}}},"401":{"description":"invalid_key: The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.","content":{"application/json":{"example":{"error":"invalid_key"}}}},"402":{"description":"quota_exhausted: This month's lookups are spent. Wait for the first of the month, or add a pack from the account page. The API never throttles silently.","content":{"application/json":{"example":{"error":"quota_exhausted"}}}},"403":{"description":"not_a_paid_plan: This account's plan does not include this. Packs need a paid plan. Choose a plan on the pricing page. Retrying will not help. account_suspended: The account behind this key is suspended. Write to contact@getdomaindata.com. Retrying will not help.","content":{"application/json":{"example":{"error":"not_a_paid_plan"}}}},"404":{"description":"not_found: We do not hold that domain or technology. Nothing to retry. A miss spends nothing, up to as many misses a day as your plan has lookups a month.","content":{"application/json":{"example":{"error":"not_found"}}}},"429":{"description":"too_many_failed_auth: Too many requests from your address carried a key we do not recognize. Fix the key, then retry after the Retry-After header. A valid key from the same address still works. rate_limited: Too many lookups this minute for your plan. Back off until the reset time in the body, then retry.","content":{"application/json":{"example":{"error":"too_many_failed_auth"}}}},"503":{"description":"metering_unavailable: The quota or the data could not be read, so nothing was served. Retry in a moment. No lookup was spent.","content":{"application/json":{"example":{"error":"metering_unavailable"}}}}}}},"/employees/{host}":{"get":{"operationId":"employees","summary":"Employee estimate","description":"Our estimated headcount for the organization behind a hostname. Keyed by the registrable domain, so every host under an apex returns the same figure. Costs 1 lookup when we hold it, otherwise free.","security":[{"bearerKey":[]}],"parameters":[{"name":"host","in":"path","required":true,"description":"Any hostname or URL under the organization's domain.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"host":"allbirds.com","apex":"allbirds.com","estimated_employees":{"low":501,"high":2000,"point":null},"as_of":"2026-09-10"}}}}},"400":{"description":"bad_host: Same as bad_domain: nothing hostname-shaped in the input. No lookup was spent. Same rule as bad_domain.","content":{"application/json":{"example":{"error":"bad_host"}}}},"401":{"description":"invalid_key: The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.","content":{"application/json":{"example":{"error":"invalid_key"}}}},"402":{"description":"quota_exhausted: This month's lookups are spent. Wait for the first of the month, or add a pack from the account page. The API never throttles silently.","content":{"application/json":{"example":{"error":"quota_exhausted"}}}},"403":{"description":"not_a_paid_plan: This account's plan does not include this. Packs need a paid plan. Choose a plan on the pricing page. Retrying will not help. account_suspended: The account behind this key is suspended. Write to contact@getdomaindata.com. Retrying will not help.","content":{"application/json":{"example":{"error":"not_a_paid_plan"}}}},"404":{"description":"not_found: We do not hold that domain or technology. Nothing to retry. A miss spends nothing, up to as many misses a day as your plan has lookups a month.","content":{"application/json":{"example":{"error":"not_found"}}}},"429":{"description":"too_many_failed_auth: Too many requests from your address carried a key we do not recognize. Fix the key, then retry after the Retry-After header. A valid key from the same address still works. rate_limited: Too many lookups this minute for your plan. Back off until the reset time in the body, then retry.","content":{"application/json":{"example":{"error":"too_many_failed_auth"}}}},"503":{"description":"metering_unavailable: The quota or the data could not be read, so nothing was served. Retry in a moment. No lookup was spent.","content":{"application/json":{"example":{"error":"metering_unavailable"}}}}}}},"/technology/{name}":{"get":{"operationId":"technology","summary":"Technology count","description":"How many domains we detected running one technology. Aggregates only; the domain lists themselves are a download, not an API surface. Costs Free.","security":[{"bearerKey":[]}],"parameters":[{"name":"name","in":"path","required":true,"description":"The technology name exactly as it appears on its page, URL-encoded, for example Google%20Tag%20Manager.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tech":"Shopify","domains":7407815}}}}},"401":{"description":"invalid_key: The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.","content":{"application/json":{"example":{"error":"invalid_key"}}}},"403":{"description":"account_suspended: The account behind this key is suspended. Write to contact@getdomaindata.com. Retrying will not help.","content":{"application/json":{"example":{"error":"account_suspended"}}}},"404":{"description":"not_found: We do not hold that domain or technology. Nothing to retry. A miss spends nothing, up to as many misses a day as your plan has lookups a month.","content":{"application/json":{"example":{"error":"not_found"}}}},"429":{"description":"too_many_failed_auth: Too many requests from your address carried a key we do not recognize. Fix the key, then retry after the Retry-After header. A valid key from the same address still works. rate_limited: Too many lookups this minute for your plan. Back off until the reset time in the body, then retry.","content":{"application/json":{"example":{"error":"too_many_failed_auth"}}}},"503":{"description":"metering_unavailable: The quota or the data could not be read, so nothing was served. Retry in a moment. No lookup was spent.","content":{"application/json":{"example":{"error":"metering_unavailable"}}}}}}},"/meta/technologies":{"get":{"operationId":"catalog","summary":"Technology catalog","description":"The most common technologies in each category, up to 10 a category, with their domain counts. Cache it; it changes with each data release. Costs Free.","security":[{"bearerKey":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"category":"ecommerce","technologies":[{"tech":"Shopify","domains":7407815},{"tech":"WooCommerce","domains":0},"..."]},"..."]}}}},"401":{"description":"invalid_key: The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.","content":{"application/json":{"example":{"error":"invalid_key"}}}},"403":{"description":"account_suspended: The account behind this key is suspended. Write to contact@getdomaindata.com. Retrying will not help.","content":{"application/json":{"example":{"error":"account_suspended"}}}},"429":{"description":"too_many_failed_auth: Too many requests from your address carried a key we do not recognize. Fix the key, then retry after the Retry-After header. A valid key from the same address still works. rate_limited: Too many lookups this minute for your plan. Back off until the reset time in the body, then retry.","content":{"application/json":{"example":{"error":"too_many_failed_auth"}}}},"503":{"description":"metering_unavailable: The quota or the data could not be read, so nothing was served. Retry in a moment. No lookup was spent.","content":{"application/json":{"example":{"error":"metering_unavailable"}}}}}}}},"x-quotas":[{"plan":"Free","lookups":100,"perMinute":30},{"plan":"Pro","lookups":5000,"perMinute":300},{"plan":"Business","lookups":100000,"perMinute":600},{"plan":"Business Plus","lookups":500000,"perMinute":1200}],"x-pack-lookups":25000,"x-changelog":[{"date":"2026-11-09","text":"New: an MCP server at https://getdomaindata.com/mcp, so Claude, ChatGPT and other AI apps can look up domains with a sign-in or an API key. It spends lookups the same way the API does. A Clay setup page is at /docs/api/clay. You now pay for answers: a domain, traffic estimate or employee estimate we do not hold spends nothing, up to a daily ceiling. The monthly allowances went up to 5,000 on Pro, 100,000 on Business and 500,000 on Business Plus, and the free plan now includes 100 lookups a month. /domain and /enrich now list the apps and plugins we detected on a site. Per-minute allowances went up to 300 on Pro, 600 on Business and 1200 on Business Plus. Traffic figures on /domain, /domains/batch, /enrich and /traffic now match the domain pages: the same number, month and band. The per-minute limit now counts lookups, so a batch counts once per domain. Technology counts and the catalog now have their own limit of 60 calls a minute. A failed read now answers 503 and spends nothing. Technology names and the network field are limited to names we have reviewed, so a row can list fewer names and network can be null where it had a value. New errors: not_a_paid_plan, account_suspended and too_many_failed_auth."}]}