curl --request POST \
  --url https://api.hydrafetch.com/v1/web/structured \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "url": "https://example.com",
  "maxAge": 302400000,
  "cacheOnly": true,
  "storeInCache": true,
  "preferStructure": true,
  "async": true,
  "onlyMainContent": true,
  "includeTags": [
    "article",
    "main"
  ],
  "excludeTags": [
    ".ad",
    "#comments"
  ],
  "removeBase64Images": true,
  "blockAds": true,
  "dismissCookies": true,
  "dismissPopups": true,
  "render": true,
  "includeLinks": true,
  "waitFor": 15000,
  "timeout": 50500,
  "location": {
    "country": "us",
    "languages": [
      "en-US",
      "en"
    ]
  },
  "headers": {},
  "method": "GET",
  "body": "{\"limit\":25,\"offset\":0}"
}
'

import requests

url = "https://api.hydrafetch.com/v1/web/structured"

payload = {
    "url": "https://example.com",
    "maxAge": 302400000,
    "cacheOnly": True,
    "storeInCache": True,
    "preferStructure": True,
    "async": True,
    "onlyMainContent": True,
    "includeTags": ["article", "main"],
    "excludeTags": [".ad", "#comments"],
    "removeBase64Images": True,
    "blockAds": True,
    "dismissCookies": True,
    "dismissPopups": True,
    "render": True,
    "includeLinks": True,
    "waitFor": 15000,
    "timeout": 50500,
    "location": {
        "country": "us",
        "languages": ["en-US", "en"]
    },
    "headers": {},
    "method": "GET",
    "body": "{\"limit\":25,\"offset\":0}"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://example.com',
    maxAge: 302400000,
    cacheOnly: true,
    storeInCache: true,
    preferStructure: true,
    async: true,
    onlyMainContent: true,
    includeTags: ['article', 'main'],
    excludeTags: ['.ad', '#comments'],
    removeBase64Images: true,
    blockAds: true,
    dismissCookies: true,
    dismissPopups: true,
    render: true,
    includeLinks: true,
    waitFor: 15000,
    timeout: 50500,
    location: {country: 'us', languages: ['en-US', 'en']},
    headers: {},
    method: 'GET',
    body: JSON.stringify('{"limit":25,"offset":0}')
  })
};

fetch('https://api.hydrafetch.com/v1/web/structured', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hydrafetch.com/v1/web/structured",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'https://example.com',
    'maxAge' => 302400000,
    'cacheOnly' => true,
    'storeInCache' => true,
    'preferStructure' => true,
    'async' => true,
    'onlyMainContent' => true,
    'includeTags' => [
        'article',
        'main'
    ],
    'excludeTags' => [
        '.ad',
        '#comments'
    ],
    'removeBase64Images' => true,
    'blockAds' => true,
    'dismissCookies' => true,
    'dismissPopups' => true,
    'render' => true,
    'includeLinks' => true,
    'waitFor' => 15000,
    'timeout' => 50500,
    'location' => [
        'country' => 'us',
        'languages' => [
                'en-US',
                'en'
        ]
    ],
    'headers' => [
        
    ],
    'method' => 'GET',
    'body' => '{"limit":25,"offset":0}'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hydrafetch.com/v1/web/structured"

	payload := strings.NewReader("{\n  \"url\": \"https://example.com\",\n  \"maxAge\": 302400000,\n  \"cacheOnly\": true,\n  \"storeInCache\": true,\n  \"preferStructure\": true,\n  \"async\": true,\n  \"onlyMainContent\": true,\n  \"includeTags\": [\n    \"article\",\n    \"main\"\n  ],\n  \"excludeTags\": [\n    \".ad\",\n    \"#comments\"\n  ],\n  \"removeBase64Images\": true,\n  \"blockAds\": true,\n  \"dismissCookies\": true,\n  \"dismissPopups\": true,\n  \"render\": true,\n  \"includeLinks\": true,\n  \"waitFor\": 15000,\n  \"timeout\": 50500,\n  \"location\": {\n    \"country\": \"us\",\n    \"languages\": [\n      \"en-US\",\n      \"en\"\n    ]\n  },\n  \"headers\": {},\n  \"method\": \"GET\",\n  \"body\": \"{\\\"limit\\\":25,\\\"offset\\\":0}\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hydrafetch.com/v1/web/structured")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"https://example.com\",\n  \"maxAge\": 302400000,\n  \"cacheOnly\": true,\n  \"storeInCache\": true,\n  \"preferStructure\": true,\n  \"async\": true,\n  \"onlyMainContent\": true,\n  \"includeTags\": [\n    \"article\",\n    \"main\"\n  ],\n  \"excludeTags\": [\n    \".ad\",\n    \"#comments\"\n  ],\n  \"removeBase64Images\": true,\n  \"blockAds\": true,\n  \"dismissCookies\": true,\n  \"dismissPopups\": true,\n  \"render\": true,\n  \"includeLinks\": true,\n  \"waitFor\": 15000,\n  \"timeout\": 50500,\n  \"location\": {\n    \"country\": \"us\",\n    \"languages\": [\n      \"en-US\",\n      \"en\"\n    ]\n  },\n  \"headers\": {},\n  \"method\": \"GET\",\n  \"body\": \"{\\\"limit\\\":25,\\\"offset\\\":0}\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hydrafetch.com/v1/web/structured")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"https://example.com\",\n  \"maxAge\": 302400000,\n  \"cacheOnly\": true,\n  \"storeInCache\": true,\n  \"preferStructure\": true,\n  \"async\": true,\n  \"onlyMainContent\": true,\n  \"includeTags\": [\n    \"article\",\n    \"main\"\n  ],\n  \"excludeTags\": [\n    \".ad\",\n    \"#comments\"\n  ],\n  \"removeBase64Images\": true,\n  \"blockAds\": true,\n  \"dismissCookies\": true,\n  \"dismissPopups\": true,\n  \"render\": true,\n  \"includeLinks\": true,\n  \"waitFor\": 15000,\n  \"timeout\": 50500,\n  \"location\": {\n    \"country\": \"us\",\n    \"languages\": [\n      \"en-US\",\n      \"en\"\n    ]\n  },\n  \"headers\": {},\n  \"method\": \"GET\",\n  \"body\": \"{\\\"limit\\\":25,\\\"offset\\\":0}\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "url": "https://example.com",
    "finalUrl": "https://example.com/",
    "redirected": false,
    "status": 200,
    "cached": false,
    "metadata": {
      "title": "Example Domain",
      "structure": "markdown",
      "pageType": "article",
      "wordCount": 214,
      "description": "A short summary of the page, as published by the page itself.",
      "language": "en",
      "author": "Jane Doe",
      "siteName": "Example Blog",
      "publishedTime": "2026-01-05",
      "modifiedTime": "2026-02-11",
      "image": "https://example.com/cover.png"
    },
    "warning": "<string>",
    "usage": {
      "creditsUsed": 1,
      "creditsRemaining": 4999,
      "freshness": "fresh"
    },
    "quality": {
      "confidence": 0.94,
      "complete": true,
      "blocked": false
    },
    "markdown": "<string>",
    "html": "<string>",
    "rawHtml": "<string>",
    "links": {
      "internal": [
        "<string>"
      ],
      "external": [
        "<string>"
      ]
    },
    "structured": {
      "entities": [
        {
          "type": "Product",
          "source": "json-ld",
          "properties": {}
        }
      ],
      "jsonLd": [
        {}
      ],
      "microdata": [
        {}
      ],
      "opengraph": [
        {}
      ],
      "appState": [
        "<string>"
      ]
    },
    "summary": "<string>",
    "json": {},
    "brand": {
      "domain": "stripe.com",
      "name": "Stripe",
      "description": "Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.",
      "tagline": "Financial infrastructure to grow your revenue.",
      "assets": [
        {
          "kind": "symbol",
          "variant": "light",
          "url": "https://media.hydrafetch.com/brand/a0/a07c2695173dde0a1ffa.svg",
          "format": "svg",
          "resolution": {
            "width": 180,
            "height": 180,
            "aspectRatio": 1
          },
          "colors": [
            {
              "hex": "#533afd",
              "weight": 0.42,
              "name": "Indigo",
              "role": "primary"
            }
          ],
          "blurhash": "LmGk_aoh4sWHohWEWDt506WD?Sod"
        }
      ],
      "colors": [
        {
          "hex": "#533afd",
          "weight": 0.42,
          "name": "Indigo",
          "role": "primary"
        }
      ],
      "fonts": [
        {
          "family": "Sohne",
          "weight": 1,
          "role": "body"
        }
      ],
      "socials": [
        {
          "platform": "x",
          "url": "https://x.com/stripe",
          "handle": "stripe"
        }
      ],
      "links": {
        "pricing": "https://stripe.com/pricing",
        "blog": "https://stripe.com/blog",
        "careers": "https://stripe.com/jobs",
        "contact": "https://stripe.com/contact",
        "privacy": "https://stripe.com/privacy",
        "terms": "https://stripe.com/legal",
        "docs": "https://docs.stripe.com"
      },
      "sources": {},
      "resolvedAt": "2026-08-22T10:14:03.000Z",
      "queriedDomain": "stripe.co.uk",
      "aliases": [
        "<string>"
      ],
      "naics": {
        "code": "5223",
        "title": "Activities Related to Credit Intermediation",
        "level": "industry_group",
        "sector": {
          "code": "52",
          "title": "Finance and Insurance"
        },
        "confidence": 0.8
      },
      "email": "[email protected]",
      "legalName": "Stripe, Inc.",
      "metaDescription": "Stripe powers online and in-person payment processing for businesses of all sizes.",
      "phone": "+1 888 926 2289",
      "address": {
        "street": "354 Oyster Point Blvd",
        "city": "South San Francisco",
        "region": "CA",
        "postalCode": "94080",
        "country": "US"
      },
      "foundedYear": 2010
    }
  }
}

{
  "jobId": "019f3c09-6fae-740f-9257-10c2b6af7f43",
  "status": "running",
  "poll": "/v1/web/jobs/019f3c09-6fae-740f-9257-10c2b6af7f43"
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "url must be a valid URL"
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing X-API-Key header. Agents: https://hydrafetch.com/auth.md"
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits"
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "WORKSPACE_BANNED",
    "message": "This workspace has been suspended and cannot make API requests."
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Job not found"
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "UPSTREAM_UNREACHABLE",
    "message": "The origin did not respond to any attempt we made."
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "TOO_MANY_REQUESTS",
    "message": "Rate limit exceeded for this workspace and plan."
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "Internal server error"
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "The summary and json formats are not available."
  },
  "meta": {
    "requestId": "019e8a3c-9f0b-7c12-88ab-1d2e3f4a5b6c"
  }
}