Skip to content
Scraper API · Brand

Get the brand details behind a website.

Turn a website URL into useful brand information such as logos, color palette and typography.

  • Colors, typography, logos and icons as JSON
  • Social profiles, contact details and Open Graph metadata
  • Optional HTML, screenshots and a ZIP page bundle

From URL to brand JSON

Brand JSON with the color palette, button styles, CSS variables, fonts and heading styles, logos and icons, social profiles, contact details, organization data, and Open Graph and Twitter metadata.

Request
curl -X POST 'https://api.mrscraper.com/?action=brand-scraping&bundle=none&url=https%3A%2F%2Fmrscraper.com%2F' \
  -H 'x-api-token: {MRSCRAPER_API_TOKEN}' \
  -H 'content-type: application/json' \
  -d '{"url":"https://mrscraper.com/"}'
Response JSON
{
  "data": {
    "job_id": "<job_id>",
    "status": "succeeded",
    "url": "https://mrscraper.com/",
    "final_url": "https://mrscraper.com/",
    "brand": {
      "colors": {
        "background": "#050606",
        "link": "#f1f5f9",
        "text": "#000000"
      },
      "logo": {
        "source": "json-ld",
        "url": "https://mrscraper.com/images/logo-blue.png"
      },
      "name": "MrScraper",
      "typography": {
        "fonts": [
          {
            "family": "Poppins",
            "weights": ["400", "500", "600", "700"]
          }
        ]
      }
    },
    "error": null,
    "html_url": "/brand?id=<job_id>&output=html",
    "bundle_url": null
  },
  "message": "brand job settled"
}

Why teams use it

Reduce manual brand research

One request returns the palette, fonts, logos and social profiles that would otherwise be collected by hand.

Create consistent design inputs

Seed a theme, design tokens or a style guide from a site's colors, fonts and button styles.

Accelerate onboarding and personalization workflows

Enrich company records with logos, favicons, social profiles and descriptions from a single URL.

How it works

  1. 1

    Input the website URL

    The target URL is the only input. Choose a page bundle of none, clean or full.

  2. 2

    Analyze available public page assets and styles

    The scrape reads the colors, CSS variables, fonts, heading styles, logos and icons the page uses.

  3. 3

    Return supported brand data

    The request waits until the job settles, then returns the brand JSON with a job ID.

Example use cases

AI website recreation

Hand an AI website builder the colors, fonts, button styles and logo of an existing site as its starting theme.

Branded creative generation

Give AI agents and generators the exact palette, typography and logo of a brand so their output matches it.

Lead enrichment

Enrich CRM records with logos, favicons, social profiles and descriptions taken from a company domain.

Brand FAQ

Answered from the product documentation.

What does the brand JSON include?

The color palette, button styles, CSS variables, fonts and heading styles, logos and icons, social profiles, contact details, organization data, and Open Graph and Twitter metadata.

What is the difference between the none, clean and full bundles?

None returns the brand JSON only and is the fastest option. Clean adds the HTML, screenshots and a ZIP of the page without scripts. Full is the same as Clean, with the page scripts kept in the ZIP.

Can I read a brand again without scraping the page twice?

Yes. Every brand scrape returns a job ID in data.job_id. Use it to read the brand again or download its files later without scraping the page again.

Which files can I download from a brand job?

The page HTML, the ZIP bundle, a viewport screenshot and a full-page screenshot. A job scraped with None only has the HTML; jobs scraped with Clean or Full have all four files.

What is inside the ZIP page bundle?

A self-contained copy of the page that opens offline: the HTML rewritten to load local assets, the brand JSON, a manifest of every saved asset, viewport and full-page screenshots, and the stylesheets, fonts, images and videos it uses.

Explore Our Products

What people think about scraper icon scraper

Net in hero

The mission to make data accessible to everyone is truly inspiring. With MrScraper, data scraping and automation are now easier than ever, giving users of all skill levels the ability to access valuable data. The AI-powered no-code tool simplifies the process, allowing you to extract data without needing technical skills. Plus, the integration with APIs and Zapier makes automation smooth and efficient, from data extraction to delivery.


I'm excited to see how MrScraper will change data access, making it simpler for businesses, researchers, and developers to unlock the full potential of their data. This tool can transform how we use data, saving time and resources while providing deeper insights.

Adnan Sher

Adnan Sher

Product Hunt user

This tool sounds fantastic! The white glove service being offered to everyone is incredibly generous. It's great to see such customer-focused support.

Harper Perez

Harper Perez

Product Hunt user

MrScraper is a tool that helps you collect information from websites quickly and easily. Instead of fighting annoying captchas, MrScraper does the work for you. It can grab lots of data at once, saving you time and effort.

Jayesh Gohel

Jayesh Gohel

Product Hunt user

Now that I've set up and tested my first scraper, I'm really impressed. It was much easier than expected, and results worked out of the box, even on sites that are tough to scrape!

Kim Moser

Kim Moser

Computer consultant

MrScraper sounds like an incredibly useful tool for anyone looking to gather data at scale without the frustration of captcha blockers. The ability to get and scrape any data you need efficiently and effectively is a game-changer.

Nicola Lanzillot

Nicola Lanzillot

Product Hunt user

Support

Get help from the MrScraper team with your account, billing, or scraping questions.

Questions? Ask our team via live chat 24/5 or just poke us on our official Twitter or our founder. We're always happy to help.

Your choices

Cookie preferences

Necessary cookies keep your selection. Optional categories are disabled until you switch them on.

Strictly necessary

Remembers your privacy selection and keeps the site working.

Always on