includeMetadata=true

Page metadata in one request

Add includeMetadata=true to any request and get the metadata of the page as JSON: title, description, language, canonical URL, Open Graph tags, JSON-LD, links, emails and phone numbers.

Get API key Read the docs

$1 free credit, no card
No subscription
Failed requests are free

One request, structured metadata

Metadata comes in the JSON envelope, next to the format you ask for.

JSON-LD parsed into objects
Every Open Graph tag
No extra charge

curl -G https://api.grabber.sh/fetch \
  -H "Authorization: Bearer $GRABBER_API_KEY" \
  --data-urlencode "url=https://shop.example.com/products/trail-runner-2" \
  -d "formats=links" \
  -d "includeMetadata=true"

Response (data.metadata)

{
  "canonicalUrl": "https://shop.example.com/products/trail-runner-2",
  "title": "Trail Runner 2 | Example Shop",
  "description": "A 240 g trail shoe with a grippy outsole.",
  "languageCode": "en",
  "openGraph": [
    {
      "property": "og:image",
      "content": "https://shop.example.com/img/tr2.jpg"
    }
  ],
  "jsonLd": [
    {
      "@type": "Product",
      "name": "Trail Runner 2",
      "offers": {
        "price": "129.00",
        "priceCurrency": "USD"
      }
    }
  ],
  "emails": [
    "support@example.com"
  ]
}

How it works

1
Send the URL
Call GET /fetch with url, includeMetadata=true and the format you also want.
2
Grabber reads the page
It loads the page and reads its meta tags, Open Graph tags and JSON-LD blocks, and finds emails and phone numbers.
3
Use the fields
Every field is always present: a value the page does not have is null or an empty list.

What people build with it

Link previews

Show a title, description and image for any URL your users paste.

Product data

Read prices, names and availability from the Product JSON-LD that shops publish.

Directories and CRMs

Fill in the name, description and contact details of a company from its own site.

SEO checks

Find pages with a missing description, a wrong canonical URL or broken structured data.

Pricing

Prepaid credit, taken one request at a time. Ask for several formats in one request at the price of one.

Request	Price
A page	$0.001
A page with `js_render=true`	$0.005
Any error	$0
Credit when you sign up	$1, about 1,000 pages

Questions

Something else? The docs cover every parameter and error, and you can reach us from the dashboard.

Which fields do I get?

canonicalUrl, title, description, author, keywords, languageCode, openGraph, jsonLd, links, phones and emails. Every field is always there; one the page does not have is null or an empty list.

Is the JSON-LD parsed?

Yes. Each JSON-LD block on the page comes back as a JSON object, ready to read.

Does metadata cost extra?

No. It is part of the same page load, so a request with metadata costs $0.001, like any other.

Can I use it with unwrap=true?

No. Metadata lives in the JSON envelope, so includeMetadata is ignored when unwrap is true. Leave unwrap off and read data.metadata.

Give your agents the web