Website data API

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"
The response

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
200 OK ยท application/json
{
  "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
  }
}
Reference

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

NameTypeDescription
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.

Open the reference

Use cases

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.

Pricing

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.

5,000requests a month
5005,00050,000250,000
5,000websites read for contacts
5,000brand lookups

One credit is one request that returns data. Requests that return nothing are free.

Best fit
Builder pack
12,000 credits, one-time payment
$29once
  • $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
Start with 100 free credits

See all packs and what a credit buys

FAQ

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

More APIs on the same key

Make your first request in a minute

Sign in, copy your key and call an endpoint. Your account starts with 100 free credits.