Lists API

JSON and XML Technology Usage Lists

The BuiltWith Lists API provides XML and JSON access to lists of websites using particular web technologies across the entire internet.

Your Lists API Key -

You are not logged in.

Sign up for Free or Login
You need an active Basic / Pro or Enterprise Plan to use Lists API

Lists 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
TECH AB-Tasty
The name of a technology, replaces spaces with dashes (-).

T supports multiple technologies seperated by a | character, the first one is the 'base' of your report and will count towards your usage.

AB-Tasty|Magento as a parameter will bring back sites using AB Tasty AND Magento.
Yes
META yes
Brings back meta data with the results, which includes names, titles, social links, addresses, emails, telephone numbers, traffic ranks etc.
No
OFFSET oQEwEnH2FJuIzeXOEk2T
Gets the next page of results - use the exact value from NextOffset in response. If the value of NextOffset is END there are no more results.
No
SINCE 2016-01-20
Gets live sites using the technology since a certain time, accepts dates and queries i.e. 30 Days Ago or Last January for example.
No
FIRSTBETWEEN January 2016 and July 2016
Gets sites using the technology that first started using it between the timeframes. 'and' is required in the parameter but any date formats can be used i.e. 2010-01-1 and last week or last week and today.
No
LASTBETWEEN January 2012 and December 2012
Gets sites that we last detected using the technology in the past. 'and' is required in the parameter but any date formats can be used i.e. 2010-01-1 and last week or last week and today.
No
TLD com|uk|au
Only return sites that end with a certain TLD, use | to supply multiple OR queries.
No
LOCATION Australia
Get results with have a physical address associated with them. Use | to supply multiple OR queries.
No

Responses

The Lists API will send responses in the format -

List1(NextOffset,Results[D],Errors[Error])

List1

List1 contains the property of the next page of the report (called NextOffset) as well as the array of Results and potentially an array of Errors.

Name Example Description
NextOffset QWrd7gVNwFQCWb This provides an anchor to the next page of results. Provide this under the request parameter OFFSET to get the next page of results. If NextOffSet is END you are at the end of the list.
Errors Error objects Errors that have occured when trying to do the list lookup.
Results[R] Result objects explain below. All of the results for this lookup.

Results

Results contain R objects that are the websites that match your query.

Name Example Description
D ycombinator.com A website that matches the query.
Meta Meta object explain below. Supplied when META=yes parameter is used.

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

Endpoints

Connection points for the BuiltWith Lists API.

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

XML Response Endpoint

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

JSON Response Endpoint

https://api.builtwith.com/v2/api.xml?UPDATE=1

Last database update dates (api.json version)

Examples

Example endpoint responses.

https://api.builtwith.com/lists1/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=Optimizely&META=yes

All live websites using Optimizely including meta data in XML

https://api.builtwith.com/lists1/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=AB-Tasty&SINCE=30%20Days%20Ago

Live websites using AB Tasty first detected in the last 30 days in JSON

https://api.builtwith.com/lists1/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=Magento&TLD=uk

Live websites using Magento which end in .UK XML

https://api.builtwith.com/lists1/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=Shopify&
FIRSTBETWEEN=January%202016%20and%20last%20week

Live websites using Shopify that were first detected between January 2016 and last week in XML

Error Codes

Errors are wrapped as <error>message</error> or [{'error':'message'}] based on request type.

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

Terms and Conditions of Use

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

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