BuiltWith Lists API

JSON and XML Technology Usage Lists

Introduction

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

The general access method is as follows -
https://api.builtwith.com/lists2/api.[xml|json]?KEY=[YOUR KEY]&TECH=[TECHNOLOGY NAME]

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 List

XML Get List of sites using Shopify Example
https://api.builtwith.com/lists2/api.xml?KEY=[YOUR KEY]&TECH=Shopify

JSON Get List of sites using Magento Example
https://api.builtwith.com/lists2/api.json?KEY=[YOUR KEY]&TECH=Magento

Get List with Meta

XML Get List of sites using Optimizely with Meta
https://api.builtwith.com/lists2/api.xml?KEY=[YOUR KEY]&TECH=Optimizely&META=yes

Get Recent

JSON Get List of sites using Optimizely Recently (since 30 Days Ago)
https://api.builtwith.com/lists2/api.xml?KEY=[YOUR KEY]&TECH=Optimizely&SINCE=30%20Days%20Ago

Get TLD

XML Get List of sites using Magento in .UK TLD
https://api.builtwith.com/lists2/api.xml?KEY=[YOUR KEY]&TECH=Magento&TLD=uk

Reference

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 separated 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
SPEND 50|10000
low|high - Gets results with an estimated web technology spend in USD per month in this bracket
No
A 1|1000000
low|high - Gets results with an Alexa rank between the values provided - maxium value is 1,000,000.
No
Q 1|1000000
low|high - Gets results with an Quantcast rank between the values provided - maxium value is 1,000,000.
No

Responses

The Lists API will send responses in the format -
List2(NextOffset,Results[D],Errors[Error])

List2

List2 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 occurred 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.
FI 1495580400 Epoch seconds website was first indexed.
LI 1495580400 Epoch seconds website was last indexed.
FD 1495580400 Epoch seconds technology was first detected.
LD 1495580400 Epoch seconds technology was last detected.
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

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.