BuiltWith Social API

Introduction Authentication Get Social Example Get Broad Example Supported Social Media URLs Reference API Libraries Code Examples Error Codes Terms of Use

Introduction

Get XML and JSON results of websites associated with social media URLs.

The general access method is as follows -
https://api.builtwith.com/social1/api.[xml|json]?KEY=[YOUR KEY]&LOOKUP=[social-media-profile-url]

Authentication

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

Get Social Example

XML Get Based on Single Social Profile
https://api.builtwith.com/social1/api.xml?KEY=[YOUR KEY]&LOOKUP=linkedin.com/builtwith

JSON Get Single Domain
https://api.builtwith.com/social1/api.json?KEY=[YOUR KEY]&LOOKUP=linkedin.com/builtwith

Get Broad Social Example

By providing a more broad identifier for lookup we will search all social media profiles.

XML Get Based on Single Social Profile
https://api.builtwith.com/social1/api.xml?KEY=[YOUR KEY]&LOOKUP=builtwith

JSON Get Single Domain
https://api.builtwith.com/social1/api.json?KEY=[YOUR KEY]&LOOKUP=builtwith

Supported Social Media URLs

Twitter
Example: twitter.com/builtwith
Facebook
Example: facebook.com/builtwith
LinkedIn
Example: linkedin.com/company/builtwith
Google
Example: google.com/+builtwith
Pinterest
Example: pinterest.com/builtwith
GitHub
Example: github.com/builtwith
Instagram
Example: instagram.com/builtwith
Vk
Example: vk.com/builtwith
Vimeo
Example: vimeo.com/builtwith
Youtube
Example: youtube.com/user/builtwith
TikTok
Example: tiktok.com/@builtwith
Threads
Example: threads.net/@builtwith
X
Example: x.com/builtwith
Weibo
Example: weibo.com/builtwith

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
LOOKUP	linkedin.com/builtwith builtwith Social Media Profile or Broad match that you'd like to lookup Multi-Lookup Option You can lookup 16 attributes at a time - seperate them with a comma. For example overstock,builtwith - this dramatically improves throughput.	Yes

Responses

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


Root[Socials->Social->Results[Result]]

Social

Identifier is the sub-option in the identifers array.

Name	Example	Description
Name	overstock	The social link that was looked up (excluding link).
Results	Results explained below	Explained below

Result

A social URL matcher result.

Name	Example	Description
SocialUrl	https://instagram.com/overstock	The social network match we found
Domains	Domains explained below	Explained below

Domain

The domains that match the social profile.

Name	Example	Description
Root	wayfair.com	The root domain linked to the social network
BuiltWithRank	769 -1 for out of top 1m sites	A rank that can help filter out any junk domains in the result set

API Libraries

Node.js NPM
https://www.npmjs.com/package/builtwith-api
NPM package by Zach Caceres - https://github.com/zcaceres/builtwith-api
Microsoft .NET Nuget
https://www.nuget.org/packages/BuiltWith/
C# package by BuiltWith Pty Ltd - https://github.com/builtwith/BuiltWith-C-Client-API

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 you cannot resell the data as-is or provide duplicate functionality to builtwith.com and its associated services.