Introduction
The BuiltWith Domain Live API does a comprehensive technology search across the domain you provide us, this includes indexing internal pages, subdomains, tag managers, ads.txt and technology versions on the site live.
The general access method is as follows -
https://api.builtwith.com/dlv2/api.json?KEY=[YOUR KEY]&LOOKUP=[DOMAIN]
![Domain Live Explained]()
Domain API vs. Domain Live API
The Domain API uses our database to provide current and historical technology usage information. Our database is built over time - the last time we fully indexed the site can be between 1 minute to 30 days depending on the
quality of the website. See our Data Coverage for more information. Our systems also determine the level of detail we put into indexing a website based on what is initially returned.
The Domain Live API does an entire site lookup on the Domain/Sub Domain or Url you provide almost immediately and does not discriminate against the level of detail we put into providing the lookup based on the initial data returned.
Authentication
You must provide your API key in each lookup. See the examples for how this works.
Login or Create a Free Account to get your API key.
Get Domain Example
JSON Get Domain
https://api.builtwith.com/dlv2/api.json?KEY=[YOUR KEY]&LOOKUP=builtwith.com
High Throughput
Domain Live is a low speed endpoint due to us relying on third party website loading. It typically takes around 8 to 16 seconds to bring back a profile. For much higher throughput we recommend the Dedicated Domain Live API endpoint.
Reference
GET Request Parameters
| Name |
Examples |
Required |
| KEY |
Login or Create a Free Account to get your API key.
This is your key, use this for lookups.
|
Yes |
| LOOKUP |
cnn.com
example.com%3Ftest
pets.wayfair.com
Escape paths and parameters for full urls
How different LOOKUPS Work
Root domains (i.e. example.com) - index root domain, internal pages and subdomains
Subdomains (i.e. sub.example.com) - index subdomain, subdomain internal pages
Internal URL (i.e. example.com/test.html) - index specific URL only
|
Yes |
Response Object
Lookups are not responsive - they take for as long as it takes us to index the homepage, internal pages and subdomains of the site.
![DLv2 Schema]()
You can download the DLv2 JSON Schema with documentation here - dlv2.schema.json
Code Examples
JSON/XML have integrations in all modern programming languages. Here's some StackOverflow topics for various languages - Python, C#, Java, PHP, C++, TSQL and Ruby.
Error Codes
Note error messages in this format cannot be guaranteed, your implementation should also consider non-200 response codes as errors. The Lookup property will be null (json) or not provided (xml) if the error is server related. View all potential well-formed error codes.
Terms of Use
Our standard terms cover the use all of our APIs.
In general, you can use the API to enhance your product in many ways. The only limitation is you cannot resell the data as-is or provide duplicate functionality to builtwith.com and its associated services.