Scrape Brand

Extract a website's brand identity in the Scraper API: colors, typography, logos, icons, social links, and metadata as JSON, with optional HTML, screenshot, and ZIP page bundles.

Overview

Selecting Scrape Brand in the Scraper API Use Case panel extracts the brand identity of a website from a single URL. The result is a brand JSON that describes how the site looks and who is behind it: 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.

The only input is the target URL. You choose how much of the page to keep alongside the brand JSON with the Page bundle option.

Practical Applications

Design System Bootstrapping: Pull a site's colors, fonts, and button styles to seed a theme, design tokens, or a style guide.
Brand-Aware AI Generation: Give AI agents and generators the exact palette, typography, and logo of a brand so their output matches it.
Lead Enrichment & CRM: Enrich company records with logos, favicons, social profiles, and descriptions from a domain.
Competitor Brand Monitoring: Track changes to a competitor's palette, typography, or messaging over time.
Page Archiving & Offline Review: Save a self-contained copy of a page with its assets and screenshots for audits or design review.

Page Bundle

Option	Returns	Typical duration
None	Brand JSON only. The fastest option.	A few seconds
Clean	Brand JSON, plus the HTML, screenshots, and a ZIP of the page without scripts.	About a minute
Full	Same as Clean, with the page scripts kept in the ZIP.	About a minute

Set the option with the bundle query parameter: bundle=none, bundle=clean, or bundle=full.

Job ID

Every brand scrape returns a job ID. You can find it in the Result tab of the Scraper API and in data.job_id of the API response. Use it to read the brand again or download its files later without scraping the page again.

Default Parameters

Parameter	Description
action=brand-scraping	Used by this use case to extract the brand of the page.
bundle	Page bundle to return: `none`, `clean`, or `full`. (Default to `none`)
url	The URL-encoded target URL.

Example

Request

Scrape the brand of https://mrscraper.com/ with Page bundle set to None.

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/"}'

To return the page bundle as well, change bundle=none to bundle=clean or bundle=full.

Response

The request waits until the job settles, then returns:

Field	Description
`job_id`	Job ID, used to read the brand again or download its files.
`status`	Job status, such as `succeeded`.
`url`	The URL you requested.
`final_url`	The URL the page ended on, after redirects.
`brand`	The brand JSON.
`error`	Error message, if the job failed.
`html_url`	Path to download the page HTML.
`bundle_url`	Path to download the ZIP bundle. `null` for None.
`screenshot_url`	Path to download the viewport screenshot. `null` for None.
`full_screenshot_url`	Path to download the full-page screenshot. `null` for None.

Response

{
  "data": {
    "job_id": "<job_id>",
    "status": "succeeded",
    "url": "https://mrscraper.com/",
    "final_url": "https://mrscraper.com/",
    "brand": {
      "colors": {
        "background": "#050606",
        "button": {
          "background": "#00b7ff",
          "border_color": "#020617",
          "border_radius": "12px",
          "color": "#020617",
          "font_family": "Poppins, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", sans-serif",
          "font_weight": "600",
          "padding": "12px",
          "text": "Accept all",
          "text_transform": "none"
        },
        "color_scheme": "normal",
        "css_variables": {
          "--color-accent": {
            "hex": "#06b6d4",
            "value": "#06b6d4"
          },
          "--color-black": {
            "hex": "#000000",
            "value": "#000"
          },
          "--color-cyan-100": {
            "hex": "#cffafe",
            "value": "#cffafe"
          },
          "--color-cyan-200": {
            "hex": "#a5f3fc",
            "value": "#a5f3fc"
          },
          "--color-cyan-300": {
            "hex": "#67e8f9",
            "value": "#67e8f9"
          },
          "--color-cyan-400": {
            "hex": "#22d3ee",
            "value": "#22d3ee"
          },
          "--color-cyan-50": {
            "hex": "#ecfeff",
            "value": "#ecfeff"
          },
          "--color-cyan-500": {
            "hex": "#00b7ff",
            "value": "#00b7ff"
          },
          "--color-cyan-600": {
            "hex": "#0891b2",
            "value": "#0891b2"
          },
          "--color-cyan-700": {
            "hex": "#0e7490",
            "value": "#0e7490"
          },
          "--color-cyan-800": {
            "hex": "#155e75",
            "value": "#155e75"
          },
          "--color-cyan-900": {
            "hex": "#164e63",
            "value": "#164e63"
          },
          "--color-footer-from": {
            "hex": "#15212d",
            "value": "#15212d"
          },
          "--color-footer-to": {
            "hex": "#082e36",
            "value": "#082e36"
          },
          "--color-gray-100": {
            "hex": "#f3f4f6",
            "value": "#f3f4f6"
          },
          "--color-gray-200": {
            "hex": "#e5e7eb",
            "value": "#e5e7eb"
          },
          "--color-gray-300": {
            "hex": "#d1d5db",
            "value": "#d1d5db"
          },
          "--color-gray-400": {
            "hex": "#9ca3af",
            "value": "#9ca3af"
          },
          "--color-gray-500": {
            "hex": "#6b7280",
            "value": "#6b7280"
          },
          "--color-gray-600": {
            "hex": "#4b5563",
            "value": "#4b5563"
          },
          "--color-gray-700": {
            "hex": "#374151",
            "value": "#374151"
          },
          "--color-gray-800": {
            "hex": "#1f2937",
            "value": "#1f2937"
          },
          "--color-gray-900": {
            "hex": "#111827",
            "value": "#111827"
          },
          "--color-gray-950": {
            "hex": "#030712",
            "value": "#030712"
          },
          "--color-ink": {
            "hex": "#0d1625",
            "value": "#0d1625"
          },
          "--color-page": {
            "hex": "#050606",
            "value": "#050606"
          },
          "--color-panel": {
            "hex": "#0d1117",
            "value": "#0d1117"
          },
          "--color-primary-300": {
            "hex": "#67e8f9",
            "value": "#67e8f9"
          },
          "--color-primary-400": {
            "hex": "#22d3ee",
            "value": "#22d3ee"
          },
          "--color-primary-500": {
            "hex": "#00b7ff",
            "value": "#00b7ff"
          },
          "--color-primary-600": {
            "hex": "#0891b2",
            "value": "#0891b2"
          },
          "--color-primary-700": {
            "hex": "#0e7490",
            "value": "#0e7490"
          },
          "--color-slate-100": {
            "hex": "#f1f5f9",
            "value": "#f1f5f9"
          },
          "--color-slate-200": {
            "hex": "#e2e8f0",
            "value": "#e2e8f0"
          },
          "--color-slate-300": {
            "hex": "#cbd5e1",
            "value": "#cbd5e1"
          },
          "--color-slate-400": {
            "hex": "#94a3b8",
            "value": "#94a3b8"
          },
          "--color-slate-50": {
            "hex": "#f8fafc",
            "value": "#f8fafc"
          },
          "--color-slate-600": {
            "hex": "#475569",
            "value": "#475569"
          },
          "--color-slate-700": {
            "hex": "#334155",
            "value": "#334155"
          },
          "--color-slate-800": {
            "hex": "#1e293b",
            "value": "#1e293b"
          },
          "--color-slate-900": {
            "hex": "#0f172a",
            "value": "#0f172a"
          },
          "--color-slate-950": {
            "hex": "#020617",
            "value": "#020617"
          },
          "--color-surface": {
            "hex": "#0e1219",
            "value": "#0e1219"
          },
          "--color-tile": {
            "hex": "#171e28",
            "value": "#171e28"
          },
          "--color-white": {
            "hex": "#ffffff",
            "value": "#fff"
          },
          "--tw-ring-offset-color": {
            "hex": "#ffffff",
            "value": "#fff"
          }
        },
        "link": "#f1f5f9",
        "palette": [
          {
            "hex": "#050606",
            "roles": [
              "background",
              "text"
            ],
            "share": 0.953
          },
          {
            "hex": "#9ca3af",
            "roles": [
              "text"
            ],
            "share": 0.011
          },
          {
            "hex": "#171e28",
            "roles": [
              "background"
            ],
            "share": 0.01
          },
          {
            "hex": "#ffffff",
            "roles": [
              "text",
              "border",
              "background"
            ],
            "share": 0.01
          },
          {
            "hex": "#0d1625",
            "roles": [
              "text",
              "background"
            ],
            "share": 0.007
          },
          {
            "hex": "#f1f5f9",
            "roles": [
              "text",
              "background"
            ],
            "share": 0.004
          },
          {
            "hex": "#0a0a0f",
            "roles": [
              "background"
            ],
            "share": 0.001
          },
          {
            "hex": "#00b7ff",
            "roles": [
              "background",
              "text"
            ],
            "share": 0.001
          },
          {
            "hex": "#cbd5e1",
            "roles": [
              "text"
            ],
            "share": 0.001
          },
          {
            "hex": "#1f2937",
            "roles": [
              "border"
            ],
            "share": 0
          },
          {
            "hex": "#e5e7eb",
            "roles": [
              "text"
            ],
            "share": 0
          },
          {
            "hex": "#1e2d37",
            "roles": [
              "background"
            ],
            "share": 0
          },
          {
            "hex": "#22d3ee",
            "roles": [
              "text"
            ],
            "share": 0
          },
          {
            "hex": "#06b6d4",
            "roles": [
              "text"
            ],
            "share": 0
          },
          {
            "hex": "#000000",
            "roles": [
              "text"
            ],
            "share": 0
          },
          {
            "hex": "#020617",
            "roles": [
              "text"
            ],
            "share": 0
          }
        ],
        "text": "#000000",
        "theme": null,
        "tile": null
      },
      "contact": {
        "emails": [],
        "phones": []
      },
      "description": "Turn any website into structured JSON with plain-English prompts or a visual recorder. Schedule jobs, send data to your database. Start free, 1,000 tokens.",
      "icons": {
        "all": [
          {
            "color": null,
            "rel": "apple-touch-icon",
            "sizes": "180x180",
            "type": null,
            "url": "https://mrscraper.com/apple-touch-icon.png"
          },
          {
            "color": null,
            "rel": "icon",
            "sizes": "32x32",
            "type": "image/png",
            "url": "https://mrscraper.com/favicon-32x32.png"
          },
          {
            "color": null,
            "rel": "icon",
            "sizes": "16x16",
            "type": "image/png",
            "url": "https://mrscraper.com/favicon-16x16.png"
          },
          {
            "color": null,
            "rel": "shortcut icon",
            "sizes": null,
            "type": null,
            "url": "https://mrscraper.com/favicon-32x32.png"
          },
          {
            "color": "#0d1625",
            "rel": "mask-icon",
            "sizes": null,
            "type": null,
            "url": "https://mrscraper.com/safari-pinned-tab.svg"
          },
          {
            "color": null,
            "rel": "manifest",
            "sizes": "192x192",
            "type": "image/png",
            "url": "https://mrscraper.com/android-chrome-192x192.png"
          },
          {
            "color": null,
            "rel": "manifest",
            "sizes": "512x512",
            "type": "image/png",
            "url": "https://mrscraper.com/android-chrome-512x512.png"
          }
        ],
        "apple_touch_icon": "https://mrscraper.com/apple-touch-icon.png",
        "favicon": "https://mrscraper.com/favicon-32x32.png",
        "mask_icon": {
          "color": "#0d1625",
          "rel": "mask-icon",
          "sizes": null,
          "type": null,
          "url": "https://mrscraper.com/safari-pinned-tab.svg"
        }
      },
      "language": "en",
      "logo": {
        "source": "json-ld",
        "url": "https://mrscraper.com/images/logo-blue.png"
      },
      "logos": [
        {
          "source": "json-ld",
          "url": "https://mrscraper.com/images/logo-blue.png"
        },
        {
          "alt": null,
          "height": 24,
          "source": "header-home-link",
          "url": "data:image/svg+xml;charset=utf-8,%3Csvg%20class%3D%22w-auto%20h-5%20sm%3Ah-6%22%20viewBox%3D%220%200%20875%20153%22%20fill%3D%22none%22%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%3E%20%3Cpath%20d%3D%22M0%200%20C4.38502646%203.27945662%208.21896254%207.05250177%2012%2011%20C12.61359375%2011.6290625%2013.2271875%2012.258125%2013.859375%2012.90625%20C24.77288348%2024.83235205%2030.17152578%2040.77890526%2030.09765625%2056.80859375%20C30.09443359%2058.04931641%2030.09121094%2059.29003906%2030.08789062%2060.56835938%20C30.07951172%2061.84517578%2030.07113281%2063.12199219%2030.0625%2064.4375%20C30.05798828%2065.74138672%2030.05347656%2067.04527344%2030.04882812%2068.38867188%20C30.03709261%2071.59246777%2030.0191587%2074.7962399%2030%2078%20C25.38%2078%2020.76%2078%2016%2078%20C15.98582031%2076.00839844%2015.97164063%2074.01679687%2015.95703125%2071.96484375%20C15.68613819%2053.60431441%2015.26197714%2037.93778995%203%2023%20C2.23816406%2022.01386719%201.47632812%2021.02773438%200.69140625%2020.01171875%20C-1.96829292%2016.84385751%20-5.07318294%2014.56231859%20-8.5625%2012.375%20C-9.1716626%2011.98892578%20-9.7808252%2011.60285156%20-10.40844727%2011.20507812%20C-17.94741788%206.59341649%20-26.14779892%203.66809065%20-35%203%20C-35.63679688%202.9484375%20-36.27359375%202.896875%20-36.9296875%202.84375%20C-51.05533352%202.22284248%20-64.68079579%207.12401356%20-75.3125%2016.3125%20C-89.72788375%2030.15034434%20-94.16418243%2044.3960524%20-94.625%2064%20C-94.66325652%2065.36069998%20-94.70231248%2066.72137774%20-94.7421875%2068.08203125%20C-94.83596839%2071.38780764%20-94.9190513%2074.6938845%20-95%2078%20C-99.62%2078%20-104.24%2078%20-109%2078%20C-109.50727766%2051.95974688%20-108.28323842%2028.89473524%20-89.4375%208.875%20C-65.19654394%20-14.15757003%20-28.35228637%20-18.2831141%200%200%20Z%20%22%20fill%3D%22%231BD0EF%22%20transform%3D%22translate(109%2C11)%22%20class%3D%22fill-%5B%231BD0EF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M0%200%20C4.95%200%209.9%200%2015%200%20C15.4125%201.258125%2015.825%202.51625%2016.25%203.8125%20C17.55846117%207.28944377%2018.58720872%209.2418954%2022%2011%20C25.26098083%2012.02144175%2028.28447006%2012.13756286%2031.69140625%2012.17578125%20C32.80193359%2012.19962891%2033.91246094%2012.22347656%2035.05664062%2012.24804688%20C37.36635754%2012.29050964%2039.67630548%2012.32203057%2041.98632812%2012.34179688%20C51.55857695%2012.57876101%2060.039235%2014.04520664%2067.375%2020.5625%20C71.88499263%2025.49936436%2076%2032.16869391%2076%2039%20C72.04%2040.32%2068.08%2041.64%2064%2043%20C63.443125%2042.071875%2062.88625%2041.14375%2062.3125%2040.1875%20C59.20347249%2035.9020837%2056.12749992%2034.01499999%2051%2033%20C49.00845072%2032.8874122%2047.01398299%2032.82233134%2045.01953125%2032.7890625%20C43.85486328%2032.76070312%2042.69019531%2032.73234375%2041.49023438%2032.703125%20C39.05808854%2032.65145966%2036.62577622%2032.60706785%2034.19335938%2032.5703125%20C26.34723028%2032.36303996%2019.03385726%2032.05317883%2012.58984375%2027.17578125%20C12.04457031%2026.56089844%2011.49929687%2025.94601563%2010.9375%2025.3125%20C10.36902344%2024.68988281%209.80054687%2024.06726563%209.21484375%2023.42578125%20C8.81394531%2022.95527344%208.41304688%2022.48476562%208%2022%20C7.34644531%2022.59748047%207.34644531%2022.59748047%206.6796875%2023.20703125%20C-0.08412178%2029.22418626%20-5.90494025%2032.07925524%20-14.98046875%2032.17578125%20C-16.14513672%2032.19962891%20-17.30980469%2032.22347656%20-18.50976562%2032.24804688%20C-20.94188457%2032.29067031%20-23.37422791%2032.32210654%20-25.80664062%2032.34179688%20C-32.83388851%2032.50809938%20-39.03313179%2032.97866699%20-45%2037%20C-46.74338617%2038.93792328%20-47.78006956%2040.66622003%20-49%2043%20C-52.96%2041.68%20-56.92%2040.36%20-61%2039%20C-59.61559367%2030.69356205%20-55.92403034%2023.50199821%20-49.04760742%2018.34936523%20C-41.05788248%2013.08416793%20-33.17232578%2012.4428638%20-23.8125%2012.4375%20C-13.48289286%2012.54586808%20-13.48289286%2012.54586808%20-4%209%20C-1.63433042%205.92462955%20-0.95327374%203.81309495%200%200%20Z%20%22%20fill%3D%22%231BD0EF%22%20transform%3D%22translate(62%2C85)%22%20class%3D%22fill-%5B%231BD0EF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M0%200%20C14.78669703%20-0.58561176%2025.43363984%200.39597013%2037.4375%209.9375%20C39%2012%2039%2012%2038.9375%2014.375%20C37.8587282%2017.39556105%2036.51190999%2020.17338567%2035%2023%20C31.619024%2022.56374503%2029.00950376%2021.54154424%2026%2020.03125%20C20.71150664%2017.64410892%2015.67840529%2017.13352603%209.9375%2016.75%20C8.97650391%2016.67265625%208.01550781%2016.5953125%207.02539062%2016.515625%20C4.68469904%2016.32930129%202.34246042%2016.16258173%200%2016%20C0%2010.72%200%205.44%200%200%20Z%20%22%20fill%3D%22%231BD0EF%22%20transform%3D%22translate(77%2C54)%22%20class%3D%22fill-%5B%231BD0EF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M0%200%20C2.93541736%202.21946191%203.80586845%203.75551459%204.37109375%207.37890625%20C4.57248865%2011.47393588%204.31647412%2014.32577253%202.5625%2018.0625%20C-1.10202646%2020.83323952%20-4.45566287%2021.29213596%20-9%2021%20C-12.670261%2019.43818681%20-13.7727373%2018.34089404%20-16%2015%20C-16.70764306%2010.14523949%20-16.709087%206.19811251%20-14.1875%201.9375%20C-9.87585601%20-1.88138467%20-5.29701283%20-1.34815669%200%200%20Z%20%22%20fill%3D%22%231BD0EF%22%20transform%3D%22translate(46%2C53)%22%20class%3D%22fill-%5B%231BD0EF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M211.052%20118.813L187.102%2040.8361H186.545C186.638%2042.6927%20186.777%2045.4776%20186.963%2049.1907C187.148%2052.9039%20187.334%2056.8956%20187.519%2061.1657C187.705%2065.3431%20187.798%2069.1491%20187.798%2072.5838V118.813H169V19.3924H197.684L221.217%2095.4199H221.634L246.559%2019.3924H275.243V118.813H255.61V71.7483C255.61%2068.5921%20255.656%2064.9718%20255.749%2060.8873C255.935%2056.8028%20256.074%2052.9503%20256.167%2049.33C256.353%2045.6168%20256.492%2042.8319%20256.585%2040.9753H256.028L230.407%20118.813H211.052Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M341.156%2041.393C342.177%2041.393%20343.384%2041.4395%20344.776%2041.5323C346.169%2041.6251%20347.283%2041.7644%20348.118%2041.95L346.587%2061.4442C345.937%2061.2586%20344.962%2061.1193%20343.662%2061.0265C342.456%2060.8408%20341.388%2060.748%20340.46%2060.748C337.768%2060.748%20335.169%2061.1193%20332.662%2061.862C330.156%2062.5118%20327.881%2063.5793%20325.839%2065.0646C323.89%2066.5499%20322.312%2068.5457%20321.105%2071.0521C319.991%2073.4657%20319.434%2076.4826%20319.434%2080.103V118.813H298.687V42.7855H314.421L317.485%2055.596H318.459C319.945%2052.9967%20321.801%2050.6296%20324.029%2048.4945C326.257%2046.3594%20328.81%2044.6421%20331.687%2043.3425C334.658%2042.0429%20337.814%2041.393%20341.156%2041.393Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M422.21%2091.2425C422.21%2097.0908%20420.772%20102.196%20417.894%20106.559C415.016%20110.922%20410.839%20114.311%20405.362%20116.724C399.978%20119.045%20393.387%20120.205%20385.589%20120.205C382.154%20120.205%20378.766%20119.973%20375.424%20119.509C372.175%20119.045%20369.019%20118.395%20365.956%20117.56C362.985%20116.631%20360.154%20115.517%20357.462%20114.218V94.5844C362.196%2096.6266%20367.07%2098.5297%20372.082%20100.293C377.188%20101.964%20382.247%20102.8%20387.26%20102.8C390.695%20102.8%20393.433%20102.336%20395.476%20101.407C397.611%20100.479%20399.142%2099.2259%20400.071%2097.6478C401.092%2096.0697%20401.602%2094.2595%20401.602%2092.2172C401.602%2089.7108%20400.72%2087.5758%20398.957%2085.812C397.286%2084.0482%20395.011%2082.4237%20392.134%2080.9384C389.256%2079.3603%20385.96%2077.6894%20382.247%2075.9256C379.927%2074.8117%20377.42%2073.5121%20374.728%2072.0268C372.036%2070.4487%20369.437%2068.5457%20366.93%2066.3178C364.517%2063.997%20362.521%2061.2122%20360.943%2057.9631C359.365%2054.7141%20358.576%2050.8153%20358.576%2046.2666C358.576%2040.3255%20359.922%2035.2663%20362.614%2031.089C365.399%2026.8188%20369.298%2023.5698%20374.31%2021.3419C379.416%2019.114%20385.403%2018%20392.273%2018C397.471%2018%20402.391%2018.6034%20407.033%2019.8102C411.767%2021.017%20416.687%2022.7343%20421.793%2024.9622L414.97%2041.393C410.421%2039.5365%20406.337%2038.0976%20402.716%2037.0765C399.096%2036.0553%20395.383%2035.5448%20391.577%2035.5448C388.977%2035.5448%20386.75%2035.9625%20384.893%2036.798C383.036%2037.6335%20381.597%2038.7938%20380.576%2040.2791C379.648%2041.7644%20379.184%2043.5281%20379.184%2045.5704C379.184%2047.8911%20379.88%2049.887%20381.273%2051.5579C382.665%2053.136%20384.754%2054.6677%20387.539%2056.153C390.323%2057.6382%20393.805%2059.402%20397.982%2061.4442C403.088%2063.8578%20407.404%2066.3642%20410.932%2068.9634C414.552%2071.5627%20417.337%2074.626%20419.286%2078.1536C421.236%2081.6811%20422.21%2086.0441%20422.21%2091.2425Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M469.523%20120.205C462.004%20120.205%20455.599%20118.859%20450.307%20116.167C445.016%20113.382%20440.978%20109.112%20438.193%20103.357C435.408%2097.6014%20434.016%2090.2214%20434.016%2081.2169C434.016%2071.934%20435.594%2064.3684%20438.75%2058.5201C441.906%2052.6718%20446.269%2048.3553%20451.839%2045.5704C457.502%2042.7855%20464%2041.393%20471.333%2041.393C476.532%2041.393%20481.034%2041.9036%20484.84%2042.9247C488.739%2043.9459%20492.127%2045.1526%20495.005%2046.5451L488.878%2062.5582C485.629%2061.2586%20482.566%2060.191%20479.688%2059.3556C476.903%2058.5201%20474.118%2058.1024%20471.333%2058.1024C467.713%2058.1024%20464.696%2058.9843%20462.282%2060.748C459.869%2062.4189%20458.059%2064.9718%20456.852%2068.4065C455.738%2071.7483%20455.181%2075.9721%20455.181%2081.0777C455.181%2086.0905%20455.784%2090.2678%20456.991%2093.6097C458.291%2096.8587%20460.147%2099.3187%20462.561%20100.99C464.974%20102.568%20467.899%20103.357%20471.333%20103.357C475.696%20103.357%20479.549%20102.8%20482.89%20101.686C486.232%20100.479%20489.481%2098.8546%20492.638%2096.8123V114.496C489.481%20116.539%20486.14%20117.977%20482.612%20118.813C479.177%20119.741%20474.814%20120.205%20469.523%20120.205Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M552.606%2041.393C553.627%2041.393%20554.834%2041.4395%20556.227%2041.5323C557.619%2041.6251%20558.733%2041.7644%20559.568%2041.95L558.037%2061.4442C557.387%2061.2586%20556.412%2061.1193%20555.113%2061.0265C553.906%2060.8408%20552.838%2060.748%20551.91%2060.748C549.218%2060.748%20546.619%2061.1193%20544.112%2061.862C541.606%2062.5118%20539.332%2063.5793%20537.289%2065.0646C535.34%2066.5499%20533.762%2068.5457%20532.555%2071.0521C531.441%2073.4657%20530.884%2076.4826%20530.884%2080.103V118.813H510.137V42.7855H525.871L528.935%2055.596H529.909C531.395%2052.9967%20533.251%2050.6296%20535.479%2048.4945C537.707%2046.3594%20540.26%2044.6421%20543.138%2043.3425C546.108%2042.0429%20549.264%2041.393%20552.606%2041.393Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M601.839%2041.2538C612.05%2041.2538%20619.848%2043.4817%20625.232%2047.9375C630.709%2052.3005%20633.447%2059.0307%20633.447%2068.128V118.813H618.966L614.928%20108.509H614.371C612.236%20111.201%20610.008%20113.429%20607.687%20115.193C605.459%20116.956%20602.86%20118.21%20599.889%20118.952C597.012%20119.788%20593.438%20120.205%20589.168%20120.205C584.712%20120.205%20580.674%20119.37%20577.053%20117.699C573.526%20115.935%20570.741%20113.29%20568.699%20109.762C566.656%20106.142%20565.635%20101.593%20565.635%2096.1161C565.635%2088.0399%20568.467%2082.0988%20574.129%2078.2928C579.792%2074.394%20588.286%2072.2589%20599.611%2071.8876L612.839%2071.4698V68.128C612.839%2064.1363%20611.772%2061.2122%20609.637%2059.3556C607.594%2057.499%20604.717%2056.5707%20601.003%2056.5707C597.29%2056.5707%20593.67%2057.1277%20590.142%2058.2416C586.615%2059.2627%20583.087%2060.5624%20579.56%2062.1405L572.737%2048.0768C576.821%2045.9417%20581.324%2044.2708%20586.244%2043.064C591.256%2041.8572%20596.455%2041.2538%20601.839%2041.2538ZM604.763%2083.8626C598.079%2084.0482%20593.438%2085.255%20590.839%2087.4829C588.239%2089.7108%20586.94%2092.635%20586.94%2096.2553C586.94%2099.4115%20587.868%20101.686%20589.725%20103.078C591.581%20104.378%20593.995%20105.028%20596.965%20105.028C601.421%20105.028%20605.181%20103.728%20608.244%20101.129C611.308%2098.4368%20612.839%2094.6772%20612.839%2089.8501V83.5841L604.763%2083.8626Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M697.015%2041.393C705.555%2041.393%20712.471%2044.7349%20717.762%2051.4186C723.053%2058.0095%20725.699%2067.7566%20725.699%2080.66C725.699%2089.2931%20724.446%2096.5802%20721.939%20102.521C719.433%20108.37%20715.998%20112.779%20711.635%20115.75C707.272%20118.72%20702.213%20120.205%20696.458%20120.205C692.837%20120.205%20689.681%20119.741%20686.989%20118.813C684.39%20117.885%20682.162%20116.678%20680.305%20115.193C678.449%20113.707%20676.824%20112.129%20675.432%20110.458H674.318C674.689%20112.222%20674.968%20114.079%20675.153%20116.028C675.339%20117.885%20675.432%20119.741%20675.432%20121.598V152.232H654.684V42.7855H671.533L674.457%2052.6718H675.432C676.824%2050.6296%20678.495%2048.773%20680.445%2047.1021C682.394%2045.3383%20684.715%2043.9459%20687.407%2042.9247C690.192%2041.9036%20693.394%2041.393%20697.015%2041.393ZM690.331%2057.9631C686.71%2057.9631%20683.833%2058.7058%20681.698%2060.191C679.563%2061.6763%20677.985%2063.9506%20676.963%2067.014C676.035%2069.9846%20675.525%2073.7442%20675.432%2078.2928V80.5207C675.432%2085.4407%20675.896%2089.618%20676.824%2093.0527C677.752%2096.3946%20679.331%2098.9474%20681.558%20100.711C683.786%20102.475%20686.803%20103.357%20690.609%20103.357C693.766%20103.357%20696.365%20102.475%20698.407%20100.711C700.449%2098.9474%20701.981%2096.3482%20703.002%2092.9135C704.023%2089.4788%20704.534%2085.3014%20704.534%2080.3815C704.534%2072.9551%20703.373%2067.3853%20701.053%2063.6721C698.825%2059.8661%20695.251%2057.9631%20690.331%2057.9631Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M774.13%2041.393C781.185%2041.393%20787.219%2042.7391%20792.232%2045.4311C797.337%2048.1232%20801.283%2052.022%20804.067%2057.1277C806.852%2062.2333%20808.245%2068.4993%20808.245%2075.9256V85.9512H759.231C759.416%2091.7995%20761.134%2096.3946%20764.383%2099.7364C767.725%20103.078%20772.32%20104.749%20778.168%20104.749C783.088%20104.749%20787.544%20104.285%20791.535%20103.357C795.527%20102.336%20799.658%20100.804%20803.928%2098.7617V114.775C800.215%20116.631%20796.27%20117.977%20792.092%20118.813C788.008%20119.741%20783.041%20120.205%20777.193%20120.205C769.581%20120.205%20762.851%20118.813%20757.003%20116.028C751.155%20113.15%20746.559%20108.834%20743.218%20103.078C739.876%2097.3229%20738.205%2090.0822%20738.205%2081.3562C738.205%2072.4445%20739.69%2065.0646%20742.661%2059.2163C745.724%2053.2752%20749.948%2048.8194%20755.332%2045.8489C760.716%2042.8783%20766.982%2041.393%20774.13%2041.393ZM774.269%2056.153C770.277%2056.153%20766.936%2057.4526%20764.243%2060.0518C761.644%2062.651%20760.113%2066.6891%20759.648%2072.1661H788.751C788.751%2069.1027%20788.194%2066.3642%20787.08%2063.9506C786.058%2061.5371%20784.48%2059.6341%20782.345%2058.2416C780.21%2056.8492%20777.518%2056.153%20774.269%2056.153Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3Cpath%20d%3D%22M867.538%2041.393C868.559%2041.393%20869.766%2041.4395%20871.158%2041.5323C872.551%2041.6251%20873.665%2041.7644%20874.5%2041.95L872.968%2061.4442C872.318%2061.2586%20871.344%2061.1193%20870.044%2061.0265C868.837%2060.8408%20867.77%2060.748%20866.842%2060.748C864.15%2060.748%20861.55%2061.1193%20859.044%2061.862C856.537%2062.5118%20854.263%2063.5793%20852.221%2065.0646C850.271%2066.5499%20848.693%2068.5457%20847.487%2071.0521C846.373%2073.4657%20845.816%2076.4826%20845.816%2080.103V118.813H825.068V42.7855H840.803L843.866%2055.596H844.841C846.326%2052.9967%20848.183%2050.6296%20850.411%2048.4945C852.639%2046.3594%20855.191%2044.6421%20858.069%2043.3425C861.04%2042.0429%20864.196%2041.393%20867.538%2041.393Z%22%20class%3D%22fill-%5B%23FFFFFF%5D%22%3E%3C%2Fpath%3E%20%3C%2Fsvg%3E",
          "width": 137
        },
        {
          "source": "og:image",
          "url": "https://mrscraper.com/og.png"
        }
      ],
      "manifest": {
        "background_color": "#0d1625",
        "display": "standalone",
        "name": "MrScraper",
        "short_name": "MrScraper",
        "theme_color": "#0d1625",
        "url": "https://mrscraper.com/site.webmanifest"
      },
      "meta": {
        "og": {
          "og:description": "Turn any website into structured JSON with plain-English prompts or a visual recorder. Schedule jobs, send data to your database. Start free, 1,000 tokens.",
          "og:image": "https://mrscraper.com/og.png",
          "og:image:alt": "MrScraper: Web Scraping API for Structured Data",
          "og:image:height": "837",
          "og:image:secure_url": "https://mrscraper.com/og.png",
          "og:image:width": "1489",
          "og:locale": "en",
          "og:site_name": "MrScraper",
          "og:title": "MrScraper: Web Scraping API for Structured Data",
          "og:type": "website",
          "og:url": "https://mrscraper.com"
        },
        "twitter": {
          "twitter:card": "summary_large_image",
          "twitter:creator": "@MrScraper_",
          "twitter:description": "Turn any website into structured JSON with plain-English prompts or a visual recorder. Schedule jobs, send data to your database. Start free, 1,000 tokens.",
          "twitter:domain": "https://mrscraper.com",
          "twitter:image": "https://mrscraper.com/og.png",
          "twitter:image:alt": "MrScraper: Web Scraping API for Structured Data",
          "twitter:image:height": "837",
          "twitter:image:width": "1489",
          "twitter:site": "@MrScraper_",
          "twitter:title": "MrScraper: Web Scraping API for Structured Data"
        }
      },
      "name": "MrScraper",
      "organization": {
        "address": null,
        "alternate_names": [
          "MrScraper"
        ],
        "contact_point": null,
        "legal_name": null,
        "logo": "https://mrscraper.com/images/logo-blue.png",
        "name": "MrScraper",
        "same_as": [],
        "url": "https://mrscraper.com"
      },
      "social": {
        "x": "https://twitter.com/MrScraper_"
      },
      "title": "MrScraper: Web Scraping API for Structured Data",
      "typography": {
        "body": {
          "background": "#050606",
          "border_radius": "0px",
          "color": "#000000",
          "font_family": "Poppins, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", sans-serif",
          "font_size": "16px",
          "font_weight": "400",
          "letter_spacing": "normal",
          "line_height": "24px",
          "selector": "body",
          "text_transform": "none"
        },
        "button": {
          "font_family": "Poppins, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", sans-serif",
          "font_weight": "600",
          "text_transform": "none"
        },
        "fonts": [
          {
            "family": "Poppins",
            "loaded": true,
            "sources": [
              "https://mrscraper.com/_astro/poppins-devanagari-400-normal.CJDn6rn8.woff2",
              "https://mrscraper.com/_astro/poppins-devanagari-400-normal.CqVvlrh5.woff",
              "https://mrscraper.com/_astro/poppins-latin-ext-400-normal.by3JarPu.woff2",
              "https://mrscraper.com/_astro/poppins-latin-ext-400-normal.DaBSavcJ.woff",
              "https://mrscraper.com/_astro/poppins-latin-400-normal.cpxAROuN.woff2",
              "https://mrscraper.com/_astro/poppins-latin-400-normal.BOb3E3N0.woff",
              "https://mrscraper.com/_astro/poppins-devanagari-500-normal.BIdkeU1p.woff2",
              "https://mrscraper.com/_astro/poppins-devanagari-500-normal.DMPDjHtT.woff"
            ],
            "styles": [
              "normal"
            ],
            "weights": [
              "400",
              "500",
              "600",
              "700"
            ]
          }
        ],
        "headings": [
          {
            "background": null,
            "border_radius": "0px",
            "color": "#ffffff",
            "font_family": "Poppins, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", sans-serif",
            "font_size": "48px",
            "font_weight": "300",
            "letter_spacing": "normal",
            "line_height": "60px",
            "selector": "h1",
            "text_transform": "none"
          },
          {
            "background": null,
            "border_radius": "0px",
            "color": "#000000",
            "font_family": "Poppins, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", sans-serif",
            "font_size": "16px",
            "font_weight": "400",
            "letter_spacing": "normal",
            "line_height": "24px",
            "selector": "h2",
            "text_transform": "none"
          },
          {
            "background": null,
            "border_radius": "0px",
            "color": "#ffffff",
            "font_family": "Poppins, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, \"Fira Sans\", \"Droid Sans\", \"Helvetica Neue\", sans-serif",
            "font_size": "20px",
            "font_weight": "600",
            "letter_spacing": "normal",
            "line_height": "28px",
            "selector": "h3",
            "text_transform": "none"
          }
        ],
        "providers": []
      },
      "url": "https://mrscraper.com/"
    },
    "error": null,
    "html_url": "/brand?id=<job_id>&output=html",
    "bundle_url": null,
    "screenshot_url": null,
    "full_screenshot_url": null
  },
  "message": "brand job settled"
}

Read the Brand Again

Use the job ID to fetch a brand you already scraped:

Request

curl 'https://api.mrscraper.com/neo/brand?id=<job_id>' \
  -H 'x-api-token: {MRSCRAPER_API_TOKEN}'

The response has the same shape as the scrape response, with "message": "brand found".

Download Files

Add the output parameter to download a file from the job:

Output	File
`html`	The page HTML.
`bundle`	The ZIP bundle of the page.
`screenshot`	A screenshot of the visible viewport.
`screenshot_full`	A screenshot of the full page.

In the Scraper API, the same four files are available to download as ZIP Bundle, HTML, Screenshot, and Full Page Screenshot.

Note

A job scraped with None only has the HTML to download. Jobs scraped with Clean or Full have all four files.

Download the screenshot

curl 'https://api.mrscraper.com/neo/brand?id=<job_id>&output=screenshot' \
  -H 'x-api-token: {MRSCRAPER_API_TOKEN}' \
  -o screenshot.jpg

Download the ZIP bundle

curl 'https://api.mrscraper.com/neo/brand?id=<job_id>&output=bundle' \
  -H 'x-api-token: {MRSCRAPER_API_TOKEN}' \
  -o brand.zip

Screenshot of https://mrscraper.com/ :

ZIP Bundle Contents

The ZIP is a self-contained copy of the page that you can open offline:

brand-mrscraper.com.zip

brand-mrscraper.com/
├── index.html           # The page, rewritten to load local assets
├── brand.json           # The brand JSON
├── manifest.json        # Each saved asset with its original URL, MIME type, and size
├── screenshot.jpg       # Viewport screenshot
├── screenshot-full.jpg  # Full-page screenshot
└── assets/              # Stylesheets, fonts, images, and videos (plus scripts with Full)

With bundle=clean, the page's script files are left out. With bundle=full, they are saved as .js files in assets/.

Code Examples

The examples below scrape the brand of https://mrscraper.com/, print it, and download the page HTML with the job ID.

import requests

response = requests.post(
    "https://api.mrscraper.com/?action=brand-scraping&bundle=none&url=https%3A%2F%2Fmrscraper.com%2F",
    headers={"x-api-token": "{MRSCRAPER_API_TOKEN}"},
    json={"url": "https://mrscraper.com/"},
    timeout=300,
)
result = response.json()["data"]
print(result["brand"])

html = requests.get(
    "https://api.mrscraper.com/neo/brand",
    params={"id": result["job_id"], "output": "html"},
    headers={"x-api-token": "{MRSCRAPER_API_TOKEN}"},
)

Tip

Set a generous timeout. None usually answers in a few seconds, but Clean and Full can take about a minute.

Scrape Brand

On this page