BuiltWith Lists 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/lists11/api.[xml|json|txt|csv|tsv]?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/lists11/api.xml?KEY=[YOUR KEY]&TECH=Shopify

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

Get List with Meta

XML Get List of sites using Optimizely with Meta
https://api.builtwith.com/lists11/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/lists11/api.xml?KEY=[YOUR KEY]&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/lists11/api.xml?KEY=[YOUR KEY]&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

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 (-).	Yes
META	yes Brings back meta data with the results, which includes names, titles, social links, addresses, emails, telephone numbers, traffic ranks etc.	No
COUNTRY	br 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
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
ALL	yes Gets all sites including historical - cannot be used with SINCE.	No

Responses

The Lists API will send responses in the 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.

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.
Results[R9]	Result objects explain below.	All of the results for this lookup.

Results

Results contain R9 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.
LOS	shop.ycombinator.com	Array of the locations on the site where this was detected recently
FD	1495580400	Epoch seconds technology was first detected.
LD	1495580400	Epoch seconds technology was last detected.
S	323	Monthly technology spend average is USD.
SKU	1021	The amount of unqiue produts we find on the eCommerce portion of the site.
R	5000	Estimated sales revenue for eCommerce sites.
F	5000	Social followers
E	100	Employee count
A	657	Page Rank Top 100m Traffic Rank.
Q	565	Tranco Top 1m Traffic Rank.
M	854	Majestic Top 1m Link Rank.
U	5460	Umbrella Top 1m Traffic Rank.
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]	x.com/website	Social presence
[Titles]	CEO President	Title for people at the company

Sample Code

• Node.js Lists API Sample

  https://github.com/builtwith/listapidemo
  NPM package by BuiltWith - https://github.com/builtwith/listapidemo