/v1/json endpoint

Structured page data - title, meta tags, OpenGraph, headings, and outbound links.

Language:
POST

/v1/json

5 credits

Parses the page and returns a structured JSON object with all extractable metadata: title, description, OpenGraph tags, canonical URL, heading hierarchy, and up to 100 outbound links.

Request body

fieldtypereqdescription
urlstringyesFull URL to scrape. Must include protocol (https://).
options.maxLinksnumbernoMax outbound links to return. Default: 100.
options.timeoutnumbernoTimeout in ms. Default: 30000. Max: 60000.

Example

curl -X POST https://contextforai.ashutoshswamy.in/v1/json \
  -H "Authorization: Bearer cfai_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Response

200 OK
{
  "url": "https://example.com",
  "title": "Example Domain",
  "description": "This domain is for use in illustrative examples.",
  "canonical": "https://example.com",
  "metadata": {
    "og:title": "Example Domain",
    "og:type": "website"
  },
  "headings": [{ "level": 1, "text": "Example Domain" }],
  "links": [
    { "text": "More information", "href": "https://www.iana.org/domains/example" }
  ],
  "extractedAt": "2026-07-01T10:00:00Z"
}
← Full API reference: authentication, errors, rate limits, billing