BuiltWith Domain API

JSON and XML Feeds for Website Technology Profiles

Introduction

The BuiltWith Domain API provides XML and JSON access to the technology information of a website which includes all technical information as found on detailed lookups at builtwith.com and additional meta data where available.

The general access method is as follows -
https://api.builtwith.com/v12/api.[xml|json]?KEY=[YOUR KEY]&LOOKUP=[DOMAIN]

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 Single Domain
https://api.builtwith.com/v12/api.xml?KEY=[YOUR KEY]&LOOKUP=hotelscombined.com

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

Get Multiple Domains Example

Provide multiple LOOKUP domains as a CSV (up to 16)
https://api.builtwith.com/v12/api.xml?KEY=[YOUR KEY]&LOOKUP=hotelscombined.com,builtwith.com

Get Specific Page Profile Example

Providing an internal URL or subdomain will get that specific page technology profile. Ensure you encode the LOOKUP parameter.
https://api.builtwith.com/v12/api.json?KEY=[YOUR KEY]&LOOKUP=hotelscombined.com%2FPlace%2FHawaii.htm

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
Escape paths and parameters for full urls

Multi-Lookup Option
When doing RAW domain lookups, you can parse up to 16 domains at once as a CSV. For example cnn.com,about.com,builtwith.com - this dramatically improves throughput.
Yes
HIDETEXT yes
This will hide technology description, link, tag and category fields.
No
HIDEDL yes
This will hide technology description and link fields (but keep tag and categories).
No
LIVEONLY yes
This will only return technologies we consider to be live.
No
NOMETA yes
No meta data (like address, names etc..) will be returned. Improves performance.
No
NOATTR yes
No attributes data will be returned. Improves performance.
No

Response Object

The Domain API will respond with a document in the format -
Result->Paths[Path->Technologies[Technology]],Meta,Attributes

Results

Results is the top level response that identifies the lookup.

Name Example Description
Lookup hotelscombined.com The domain that was looked up.
Result The technology lookup Explained below.
Meta Meta object explained below. All of the meta data we have associated with this domain.
Attributes Attributes object explained below. All of the attribute data we have associated with this domain.
FirstIndexed 2012-07-29T14:00:00Z (xml)
1378422000000 (json)
The earliest index point for this entire domain.
LastIndexed 2014-07-29T14:00:00Z (xml)
1378822000000 (json)
The most recent index point for this entire domain.
Paths

Path is a result from a URL or collection of sub-pages on a domain if the Url field is "dd".

Name Example Description
Domain disney.com The root domain
Url dd A value of dd means this path technology data is built from multiple sub-pages and is only relevant for domain only based lookups.
SubDomain blog A subdomain of the domain, for example a value of blog and a domain of disney.com is the profile for blog.disney.com
FirstIndexed 2012-07-29T14:00:00Z (xml)
1378422000000 (json)
The earliest index point for this particular path.
LastIndexed 2014-07-29T14:00:00Z (xml)
1378822000000 (json)
The most recent index point for this particular path.
Technology

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.
FirstDetected 2012-07-29T14:00:00Z (xml)
1378422000000 (json)
The date the technology was first detected on the site by BuiltWith.
LastDetected 2018-04-30T14:00:00Z (xml)
1378422000000 (json)
The date the technology was last detected on the site by BuiltWith. See the update endpoint for last data run.
Meta

Meta data found on the lookup website - detailed lookups only will return meta data if found.

Name Example Description
CompanyName Rodale Inc. A valid incorporated company name
City San Francisco A valid city name for supported countries
Postcode 94105 A valid zip/postal code
State CA A valid state/country
Country US ISO 3166-1 alpha-2 country code for address
Vertical Technology and Computing One of these categories or blank.
[Telephones] +1-650-745-0728 Valid international telephone numbers
[Emails] support@site.com Valid domain emails
[Social] https://twitter.com/website Social presence
[Names] Name->Joe Bloggs
Type->0
Email->joe.bloggs@twitter.com
Names, emails and job titles for people. See titles index for codes
Attributes

Attribute data found on the specific domain - detailed lookups only will return attribute data if found.

Name Example Description
MJRank 2312 Majestic Rank to 1m
MJTLDRank 323 Majestic Rank for TLD of Domain to 1m
RefSN 21 Referring Subnets to Domain from Majestic
RefIP 212 Referring IPs to Domain from Majestic
TTFB 0 Seconds to First Byte (not implemented yet)
Sitemap 211 Amount of sites in an indexable sitemap
GTMTags 8 Amount of tags being loaded by Google Tag Manager
QubitTags 8 Amount of tags being loaded by Qubit Tag Manager
TealiumTags 4 Amount of tags being loaded by Tealium Tag Manager
AdobeTags 1 Amount of tags being loaded by Adobe Tag Manager
CDimensions 10 Amount of custom dimensions created by Google Analytics
CGoals 20 Amount of custom goals created by Google Analytics
CMetrics 20 Amount of custom metrics created by Google Analytics
SourceBytes 0 Size of document (not implemented)
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.