BuiltWith Domain Live API

Live technology usage for websites

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.

The general access method is as follows -
https://api.builtwith.com/dlv1/api.[xml|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

XML Get Domain
https://api.builtwith.com/dlv1/api.xml?KEY=[YOUR KEY]&LOOKUP=hotelscombined.com

JSON Get Domain
https://api.builtwith.com/dlv1/api.json?KEY=[YOUR KEY]&LOOKUP=builtwith.com

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.overstock.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 do not respond with results immediately for new lookups, they are queued. Revisit the URL you visited to check the status. Response objects will be deleted after 24 hours. Only the initial lookup uses credits - you can keep visiting that endpoint for 0 cost credits for 24 hours. When the status of the response is 'finished' no more technologies will be added to the result.

DLAPI

dlapi is the top level response that identifies the lookup.

Name Example Description
url hotelscombined.com The domain/subdomain/url that was looked up.
Status Status of the request pending - the lookup is queued
finished - the lookup has finished
lastModified 2019-04-04T23:08:26.098Z. The date the lookup was last modified, once this passes 24 hours the result will be deleted - subsequent lookups will use more credits.
results result object explained below All of the groups of URLs returned from the lookup.
Results

The results objects contain the individual URLs where technologies were found.

Name Example Description
url hotelscombined.com
https://hotelscombined.com
https://holidays.hotelscombined.com
All of the groups of URLs returned from the lookup.
techs tech object explained below All of the technologies found at this URL
Techs

A technology is a web technology result found on the site.

Name Example Description
Name Twitter Platform The name of the technology found.
Description This page embeds the twitter platform in one method or another A description of the technology found on the page
Link https://twitter.com/about/resources A link to the website for the technology
IsPremium no Is this a paid-for technology (does it cost money to use this technology - excluding hosting) values can be yes, no or maybe
Tag javascript The base category for the technology. See categories index data for all types.
Categories (Array) Social SDK An array of sub-categories for the tag as listed under main tags on BuiltWith Trends.
Headers

The following variables will be passed in the response header.

Name Example Description
X-API-CREDITS-AVAILABLE 100000000 The amount of lookup credits you have available under your ID.
X-API-CREDITS-USED 162039 The amount of lookup credits that you have used.

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 your cannot resell the data as-is or provide duplicate functionality to builtwith.com and its associated services.