Lists API

List Credit Usage

You need to login or signup to use the BuiltWith API.

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/lists12/api.[xml|json|txt|csv|tsv]?KEY=00000000-0000-0000-0000-000000000000&TECH=[TECHNOLOGY NAME]

Authentication

You must provide your API key in each lookup. See the examples for how this works.

Your API key is
00000000-0000-0000-0000-000000000000.

Get List

XML Get List of sites using Shopify Example
https://api.builtwith.com/lists12/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=Shopify

JSON Get List of sites using Magento Example
https://api.builtwith.com/lists12/api.json?KEY=00000000-0000-0000-0000-000000000000&TECH=Magento

Get List with Meta

XML Get List of sites using Optimizely with Meta
https://api.builtwith.com/lists12/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=Optimizely&META=yes

Get Recent

JSON Get List of sites using Optimizely Recently (since 30 Days Ago)
https://api.builtwith.com/lists12/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=Optimizely&SINCE=30%20Days%20Ago

Get All Including Historical

XML Get List of sites using Magento including sites historically that have stopped using it
https://api.builtwith.com/lists12/api.xml?KEY=00000000-0000-0000-0000-000000000000&TECH=Magento&ALL=true

Get Mega Technologies (3,000,000+ results)

This is no longer supported - please see Datasets for more information on how to get larger technologies.

Reference
Parameters
The following GET parameters can be supplied for lookups
NameExamplesRequired
KEY00000000-0000-0000-0000-000000000000
This is your key, use this for lookups.
Yes
TECHAB-Tasty
The name of a technology, replaces spaces with dashes (-).
Yes
METAyes
Brings back meta data with the results, which includes names, titles, social links, addresses, emails, telephone numbers, traffic ranks etc.
No
COUNTRYbr
Brings back results which have this TLD extension and/or country address. Use comma for multiple i.e. AU,NZ ISO 3166-1 alpha-2 except UK
No
OFFSEToQEwEnH2FJuIzeXOEk2T
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
SINCE2016-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
ALLyes
Gets all sites including historical - cannot be used with SINCE.
No
Responses
Format: List11(NextOffset,Results[R11])
List5
List5 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.
NameExampleDescription
NextOffsetQWrd7gVNwFQCWbThis 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.
Results[R9]Result objects explained below.All of the results for this lookup.
Results
Results contain R9 objects that are the websites that match your query.
NameExampleDescription
Dycombinator.comA website that matches the query.
LOSshop.ycombinator.comArray of the locations on the site where this was detected recently.
FD1495580400Epoch seconds technology was first detected.
LD1495580400Epoch seconds technology was last detected.
S323Monthly technology spend average is USD.
SKU1021The amount of unqiue produts we find on the eCommerce portion of the site.
R5000Estimated sales revenue for eCommerce sites.
F5000Social followers
E100Employee count
A657Page Rank Top 100m Traffic Rank.
Q565Tranco Top 1m Traffic Rank.
M854Majestic Top 1m Link Rank.
U5460Umbrella Top 1m Traffic Rank.
METAMeta object explained 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.
NameExampleDescription
CompanyNameRodale Inc.A valid incorporated company name
CitySan FranciscoA valid city name for supported countries
Postcode94105A valid zip/postal code
StateCAA valid state/country
CountryUSISO 3166-1 alpha-2 country code for address
VerticalTechnology and ComputingOne of these categories or blank.
[Telephones]+1-650-745-0728Valid international telephone numbers
[Emails]support@site.comValid domain emails
[Social]x.com/websiteSocial presence
[Titles]CEO
President
Title for people at the company
Sample Code
Code Examples

Here are implementation examples in different programming languages for making API requests:

var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.builtwith.com/lists12/api.json" +
                        "?KEY=00000000-0000-0000-0000-000000000000&TECH=Shopify-Plus"),
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}
import requests
url = "https://api.builtwith.com/lists12/api.json"
params = {
    'KEY': '00000000-0000-0000-0000-000000000000',
    'TECH': 'Shopify-Plus'
}
response = requests.get(url, params=params)
print(response.json())
<?php
$url = "https://api.builtwith.com/lists12/api.json";
$params = array(
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'TECH' => 'Shopify-Plus'
);
$url_with_params = $url . '?' . http_build_query($params);
$response = file_get_contents($url_with_params);
$data = json_decode($response, true);
print_r($data);
?>
const https = require('https');
const url = 'https://api.builtwith.com/lists12/api.json?KEY='+
                + '00000000-0000-0000-0000-000000000000&TECH=Shopify-Plus';
https.get(url, (res) => {
    let data = '';
    res.on('data', (chunk) => {
        data += chunk;
    });
    res.on('end', () => {
        console.log(JSON.parse(data));
    });
}).on('error', (err) => {
    console.log('Error: ' + err.message);
});
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class BuiltWithAPI {
    public static void main(String[] args) throws Exception {
        String url = "https://api.builtwith.com/lists12/api.json" +
                    "?KEY=00000000-0000-0000-0000-000000000000&TECH=Shopify-Plus";
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();
        con.setRequestMethod("GET");
        BufferedReader in = new BufferedReader(
            new InputStreamReader(con.getInputStream()));
        String inputLine;
        StringBuffer response = new StringBuffer();
        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();
        System.out.println(response.toString());
    }
}
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.builtwith.com/lists12/api.json')
uri.query = URI.encode_www_form({
    'KEY' => '00000000-0000-0000-0000-000000000000',
    'TECH' => 'Shopify-Plus'
})
response = Net::HTTP.get_response(uri)
data = JSON.parse(response.body)
puts data
package main
import (
    "fmt"
    "io/ioutil"
    "net/http"
)
func main() {
    url := "https://api.builtwith.com/lists12/api.json?KEY=" +
                    "00000000-0000-0000-0000-000000000000&TECH=Shopify-Plus"
    resp, err := http.Get(url)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(body))
}
curl -X GET
 "https://api.builtwith.com/lists12/api.json?KEY=00000000-0000-0000-0000-000000000000&TECH=Shopify-Plus"
Special Domains

We maintain two lists of use for you when looking up domains. Ignore lists and BuiltWith Suffix lists.

Ignore List
This is our own internal list of domains we do not index. They are either blocked, contains too many misleading technologies or too many subdomains with user generated content.

BuiltWith Suffix List
This is based on the Public Suffix List but includes many additional entries for companies with subdomains that should be considered top level domains. This list provides us with better visibility for internal websites for example it brings northernbeaches.nsw.gov.au to the top level over nsw.gov.au.

Ignore Domains (XML, JSON or TXT)
https://api.builtwith.com/ignoresv1/api.json
Suffix Domains (XML, JSON or TXT)
https://api.builtwith.com/suffixv1/api.json
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 you cannot resell the data as-is or provide duplicate functionality to builtwith.com and its associated services.