Domain API

JSON and XML Technology Lookups

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.

Your Domain API Key -

You are not logged in.

Sign up for Free or Login

Domain API Documentation

Parameters

The following GET parameters can be supplied for lookups

Name Examples Required
KEY 00000000-0000-0000-0000-000000000000
Sign up for Free or Login to get a key.
Yes
LOOKUP cnn.com
example.com%3Ftest
Escape paths and parameters for full urls
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

Responses

The Domain API will respond with a document in the format -

Result->Paths[Path->Technologies[Technology]],Meta

Paths

Paths only contain Path objects, they do not have any properties.

Path

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

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 http://twitter.com/about/resources A link to the website for the technology
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 2014-10-21T14: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
[Telephones] +1-650-745-0728 Valid international telephone numbers
[Emails] support@site.com Valid domain emails
[Names] Name->Joe Bloggs, Type->0 Names and job titles for people. See titles index for codes

Additional Fields

Each result contains a "Lookup" property which is the lookup in your request.

Header Messages

The following variables will be passed in the response header.

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

Endpoints

Connection points for the BuiltWith Domain API.

http://api.builtwith.com/v5/api.xml

XML Response Endpoint

http://api.builtwith.com/v5/api.json

JSON Response Endpoint

http://api.builtwith.com/categoriesV3.xml

Technology Categories index

http://api.builtwith.com/titles.xml

Job Title Codes

http://api.builtwith.com/v5/api.xml?UPDATE=1

Last database update dates (api.json version)

Profile Lookup vs. Detailed Lookup

If you provide a domain as the LOOKUP parameter (i.e. cnn.com) and the domain is in our database - you will get a detailed lookup Domain API response. This means the response will contain multiple Paths covering sub-domains, pages on the site and the root domain, as well as meta information where available.

If you provide a sub-domain, an internal page or a domain we do not cover (i.e. blog.cnn.com / example.com%3Ftest) - you will get a standard profile lookup Domain API response which will include 1 Path object covering the page you requested.

Examples

Example endpoint responses. These do not count towards your credits.

http://api.builtwith.com/v5/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=hotelscombined.com

XML Lookup for domain hotelscombined.com (detailed lookup)

http://api.builtwith.com/v5/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=builtwith.com

JSON Lookup for domain builtwith.com

You can provide hotelscombined.com, builtwith.com or httpbin.org (except redirects) as lookup domains without affecting your Domain API credit.

Error Codes

Error codes are wrapped in result objects.

http://api.builtwith.com/v5/api.json?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=httpbin.org/status/500

Server returns 500 internal server error example JSON response

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 and Conditions of Use

Our standard terms cover the use of the BuiltWith Domain API.

In general, you can use the Domain 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.