Brand API
Send a domain and get the brand behind it as JSON: name, logo, icon, colors, fonts, description and social profiles, read from the company's own website.
- 100 free credits
- No card needed
- No scraper to build or maintain
curl "https://pipefetch.com/v1/web/brand?url=stripe.com" \
-H "x-api-key: YOUR_API_KEY"const res = await fetch('https://pipefetch.com/v1/web/brand?url=stripe.com', {
headers: { 'x-api-key': process.env.PIPEFETCH_API_KEY },
});
const { data, credits } = await res.json();import os, requests
res = requests.get(
"https://pipefetch.com/v1/web/brand",
params={"url": "stripe.com"},
headers={"x-api-key": os.environ["PIPEFETCH_API_KEY"]},
)
data = res.json()["data"]What you get
- The logo, as an image address or an inline SVG, and where on the site it was found
- The site icon and the social sharing image
- Primary and secondary brand colors, as hex and RGB
- The fonts the site is set in
- Company name, page title and description
- Social profiles, each with its platform
{
"data": {
"url": "https://stripe.com",
"domain": "stripe.com",
"name": "Stripe",
"title": "Stripe | Financial Infrastructure to Grow Your Revenue",
"description": "Stripe is a financial services platform that helps all types of businesses accept payments, build flexible billing models, and manage money movement.",
"logo": {
"url": "https://images.stripeassets.com/fzn2n1nzq965/1hgcBNd12BfT9VLgbId7By/01d91920114b124fb4cf6d448f9f06eb/favicon.svg",
"format": "svg",
"source": "structured-data"
},
"icon": "https://images.stripeassets.com/fzn2n1nzq965/4vVgZi0ZMoEzOhkcv7EVwK/8cce6fdcf2733b2ec8e99548908847ed/favicon.png?w=180&h=180",
"icons": [
"https://images.stripeassets.com/fzn2n1nzq965/4vVgZi0ZMoEzOhkcv7EVwK/8cce6fdcf2733b2ec8e99548908847ed/favicon.png?w=180&h=180",
"https://images.stripeassets.com/fzn2n1nzq965/4vVgZi0ZMoEzOhkcv7EVwK/8cce6fdcf2733b2ec8e99548908847ed/favicon.png?w=96&h=96"
],
"image": "https://b.stripecdn.com/mkt-ssr-statics/assets/_next/static/media/stripe.37119086.jpg",
"colors": {
"primary": {
"hex": "#533afd",
"rgb": "rgb(83, 58, 253)"
},
"secondary": {
"hex": "#bdb4ff",
"rgb": "rgb(189, 180, 255)"
},
"theme": null
},
"fonts": [
{
"family": "Sohne-Var",
"source": "stylesheet"
},
{
"family": "Sourcecodepro",
"source": "stylesheet"
}
],
"socials": [
{
"platform": "github",
"url": "https://github.com/stripe"
}
],
"twitterHandle": "@stripe",
"images": [
"https://b.stripecdn.com/mkt-ssr-statics/assets/_next/static/media/wave-fallback-desktop-1x.fba6fa88.webp",
"https://images.stripeassets.com/fzn2n1nzq965/vYmk6v8n7oDAwbDpwhjV6/846f9b3e214549b8f14e2b8c8cfe9343/payment-bento-background.jpg?w=860&q=80"
]
},
"credits": {
"used": 1,
"remaining": 99
}
}One GET request
Everything the endpoint accepts. The full reference, with the complete example response, is in the docs.
GET/v1/web/brand
Costs 1 credit per request. Only requests that return data are charged.
Parameters
| Name | Type | Description |
|---|---|---|
urlrequired |
string | Website address or bare domain, such as stripe.com. The site at that host is read; a path is ignored. |
Good to know
- The logo is the one the site states in its structured data, or else the image in its header or home link. logo.source tells you which. A row of customer logos is never mistaken for it.
- A logo drawn as inline SVG comes back as a data: URI, which works wherever an image address does. logo is null when a site draws its logo with CSS only; icon is then the mark to use.
- Colors and fonts are counted in the CSS the home page loads, so they are what the site uses most.
- A website that does not exist or does not answer within 15 seconds answers 404 website_unreachable and costs nothing.
What people build with it
Personalise onboarding
When someone signs up with a work email, show their company's logo and colors from the first screen.
Logos for company lists
Put a logo next to every company in a CRM, a directory or an invoice.
Branded documents
Generate proposals, link previews or email templates in a customer's own colors and fonts.
Design research
Compare the colors and typefaces a set of companies use.
Buy credits once. Use them whenever.
This endpoint costs 1 credit per request, and a request that returns no data costs nothing. Move the slider to see what your volume costs.
One credit is one request that returns data. Requests that return nothing are free.
- $2.42 per 1,000 requests
- About $12.08 a month at this pace
- Lasts about 2.4 months at this pace
- Credits never expire
Questions and answers
How is the logo found?
First in the structured data where a site states its own logo, then in the site's header or the link to its home page. logo.source tells you which. Logos in a row of customers or partners are skipped, so you do not get somebody else's.
What if a site has no logo image?
Some sites draw their logo with CSS only. Then logo is null, and icon, the site icon, is the mark to use.
Do I get the logo file itself?
You get its address, or, for a logo drawn as inline SVG, a data: URI that holds the image. Download it and keep your own copy: Pipefetch does not host the files.
Are the colors the official brand colors?
They are the two colors the home page's CSS uses most, leaving out greys, black and white, with the site's theme color and brand variables counted first. For most sites that is the brand palette, but a site can use an accent color more than its official primary.
Does it work on every website?
It reads the home page as plain HTML, with the stylesheets it links. A site that refuses automated requests answers 404 website_blocked, and one that does not answer within 15 seconds answers 404 website_unreachable. Both are free.
May I use a company's logo?
A logo is usually a trademark of the company it belongs to. Showing it to identify that company, as in a customer list or a CRM, is common practice; other uses can need permission. The API gives you the file, not the rights to it.
What does a request cost?
One request costs 1 credit. Credit packs start at $9 for 3,000 credits, never expire, and a request that returns no data is not charged. New accounts get 100 free credits without a card.
More APIs on the same key
-
1 credit
Website Contacts API
The emails, phone numbers and social profiles a website publishes, with its contact page, address and company name.
GET /v1/web/contacts -
1 credit
YouTube Transcript API
The transcript of any public video with captions, as plain text, timestamped segments, SRT or WebVTT.
GET /v1/youtube/transcript -
1 credit
YouTube Video API
Exact views, likes and comment count, description, tags, chapters and channel for one video.
GET /v1/youtube/video -
1 credit
YouTube Channel API
Subscribers, video count, description, keywords and avatar for a channel, from a handle, id or URL.
GET /v1/youtube/channel -
1 credit
YouTube Channel Videos API
The latest uploads of a channel, newest first, with views, duration and publish time.
GET /v1/youtube/channel/videos -
1 credit
YouTube Shorts API
The Shorts of a channel, newest first, with view counts and thumbnails.
GET /v1/youtube/channel/shorts -
1 credit
YouTube Search API
YouTube search results for a query, with the same sorting and filters the site offers.
GET /v1/youtube/search -
1 credit / 20
YouTube Comments API
Top or newest comments of a video with likes, reply counts, pinned and hearted flags.
GET /v1/youtube/comments -
2 credits
Instagram Profile API
Exact followers, bio, links, account type and engagement of a public Instagram account, with its latest posts and Reels.
GET /v1/instagram/profile
Make your first request in a minute
Sign in, copy your key and call an endpoint. Your account starts with 100 free credits.