Extract Structured Data API

open_graph, twitter_card and dublin_core contain the page's Open Graph, Twitter Card and Dublin Core meta tags. json_ld and microdata contain its JSON-LD and microdata, and breadcrumbs its breadcrumb trail.

API Examples

Open Graph meta tags

JSON Example

{
  ...
  "open_graph": {
    "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/e/e4/Latte_and_dark_coffee.jpg/1280px-Latte_and_dark_coffee.jpg",
    "image_width": "1200",
    "image_height": "750",
    "title": "Coffee - Wikipedia",
    "type": "website"
  }
}

JSON-LD blocks

JSON Example

{
  ...
  "json_ld": [
    {
      "@context": "https://schema.org",
      "@type": "Article",
      "name": "Coffee",
      "url": "https://en.wikipedia.org/wiki/Coffee",
      "sameAs": "http://www.wikidata.org/entity/Q8486",
      "mainEntity": "http://www.wikidata.org/entity/Q8486",
      "author": {
        "@type": "Organization",
        "name": "Contributors to Wikimedia projects"
      },
      "publisher": {
        "@type": "Organization",
        "name": "Wikimedia Foundation, Inc.",
        "logo": {
          "@type": "ImageObject",
          "url": "https://www.wikimedia.org/static/images/wmf-hor-googpub.png"
        }
      },
      "datePublished": "2004-04-18T21:41:42Z",
      "dateModified": "2026-05-22T10:42:14Z",
      "image": "https://upload.wikimedia.org/wikipedia/commons/e/e4/Latte_and_dark_coffee.jpg",
      "headline": "brewed beverage made from seeds of Coffea genus"
    }
  ]
}

Breadcrumbs

JSON Example

{
  ...
  "breadcrumbs": [
    {
      "position": 1,
      "title": "Home",
      "link": "https://books.toscrape.com/index.html",
      "serpapi_extract_link": "https://serpapi.com/search.json?device=desktop&engine=extract&url=https%3A%2F%2Fbooks.toscrape.com%2Findex.html"
    },
    {
      "position": 3,
      "title": "Books",
      "link": "https://books.toscrape.com/catalogue/category/books_1/index.html",
      "serpapi_extract_link": "https://serpapi.com/search.json?device=desktop&engine=extract&url=https%3A%2F%2Fbooks.toscrape.com%2Fcatalogue%2Fcategory%2Fbooks_1%2Findex.html"
    },
    {
      "position": 5,
      "title": "Poetry",
      "link": "https://books.toscrape.com/catalogue/category/books/poetry_23/index.html",
      "serpapi_extract_link": "https://serpapi.com/search.json?device=desktop&engine=extract&url=https%3A%2F%2Fbooks.toscrape.com%2Fcatalogue%2Fcategory%2Fbooks%2Fpoetry_23%2Findex.html"
    },
    {
      "position": 7,
      "title": "A Light in the Attic"
    }
  ]
}

Open Graph metadata

JSON Example

{
  ...
  "open_graph": {
    "locale": "en_GB",
    "locale_alternate": "sv_SE",
    "url": "https://www.europeana.eu/en",
    "title": "Discover Europe’s digital cultural heritage",
    "description": "Search, save and share art, books, films and music from thousands of cultural institutions",
    "type": "website",
    "image": "https://images.ctfassets.net/i01duvb6kq77/7q6wzSixWlUeOVchVeyn0D/2e6cc6c8adee7f29a116999fe590e70d/europeanmap_europeana__1_.png?w=1200&h=630&fit=fill&f=face&fm=webp&q=40"
  }
  ...
}

Price Offers

JSON Example

{
  ...
  "price_offers": [
    {
      "position": 1,
      "title": "A Light in the Attic",
      "currency": "GBP",
      "price": "£51.77",
      "extracted_price": 51.77,
      "description": "A Light in the Attic £51.77 In stock (22 available) Warning! This is a demo website for web scraping purposes. Prices and ratings here were randomly assigned and have no real meaning.",
      "source": "html-explicit"
    }
  ],
  ...
}

JSON Structure Overview

{
  ...
  "open_graph": {
    "title": "String - Content of the og:title meta tag",
    "type": "String - Content of the og:type meta tag",
    "image": "String - Content of the og:image meta tag",
    "property_name": "String - Content of any other og:* meta tag (e.g. 'description', 'site_name', 'image_width')"
  },
  "twitter_card": {
    "card": "String - Content of the twitter:card meta tag",
    "property_name": "String - Content of any other twitter:* meta tag (e.g. 'site', 'title', 'image_alt')"
  },
  "dublin_core": {
    "title": "String - Content of the DC.title meta tag",
    "property_name": "String - Content of any other DC.* or DCTERMS.* meta tag (e.g. 'creator', 'date', 'subject')"
  },
  "json_ld": "Array - JSON-LD blocks of the page, as parsed JSON",
  "microdata": [
    {
      "type": "String - itemtype of the item",
      "properties": "Hash - itemprop names and their values. Nested items have the same structure"
    },
    ...
  ],
  "breadcrumbs": [
    {
      "position": "Integer - Position of the breadcrumb",
      "title": "String - Title of the breadcrumb",
      "link": "String - Link of the breadcrumb",
      "serpapi_extract_link": "String - Extract API link for extracting this URL next"
    },
    ...
  ],
  ...
}