Relationships API

Find relationships between websites and website IP and tag history.

Get XML and JSON results of relationships between websites that show what sites are linked together, by what and for how long.

Your Relationships API Key -

You are not logged in.

Sign up for Free or Login

Relationship 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
news.ycombinator.com
Domains and sub-domains work with the Relationship API (not internal pages)

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

Responses

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

Relationships[Relationship->Identifiers[Identifer]]

Relationship

Results is the top level response that identifies the lookup.

Name Example Description
Domain hotelscombined.com The domain that was looked up.
Identifers Identifier explained below Explained below

Identifier

Identifiers are the unique codes that are found on the domain and other domains that also have it.

Name Example Description
Type google-analytics The type of identifier See all Types
Value 454517 The value of the identifier - typically the code of the identifier like an IP address or an account id.
First 2013-03-26T13:00:00Z The date we first detected this identifier
Last 2016-04-23T14:00:00Z The date we last detected this identifier
Matches Match explained below Explain below

Match

Matches are other domains that have this identifier.

Name Example Description
Domain com-hotel.com The domain name of the match
First 2013-03-26T13:00:00Z The date we first detected this on the matched domain
Last 2016-04-23T14:00:00Z The date we last detected this on the matched domain
Overlap true If this domain used the identifier at the same time as the lookup Domain

Endpoints

Connection points for the BuiltWith Relationships API.

https://api.builtwith.com/rv1/api.xml

XML Response Endpoint

https://api.builtwith.com/rv1/api.json

JSON Response Endpoint

https://api.builtwith.com/rv1/api.xml?TYPES=1

All potential identifier types (json version)

Examples

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

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

XML Lookup for domain hotelscombined.com

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

JSON Lookup for domain builtwith.com

Error Codes

Error codes are wrapped in result objects.

https://api.builtwith.com/rv1/api.xml?KEY=00000000-0000-0000-0000-000000000000&LOOKUP=junkloo11122.junk

Server with no response lookup

Note error messages in this format cannot be guaranteed, your implementation should also consider non-200 response codes as errors.

Terms and Conditions of Use

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

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