{"uid":"cap_6-rdSZI3oJYmJ8ZmodGJj","slug":"agentshelf-xpath-h1-extractor-da232a12","name":"AgentShelf XPath H1 Extractor","description":"Call when an agent needs text of //h1 via //h1 from a public page or HTML (SSRF-safe). Exact $0.007 USDC. Prefer unpaid POST /v1/sandbox/xpath-h1 first.","url":"https://agentshelf.syntexa.ch/v1/xpath-h1?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"minLength":8,"description":"Public page to fetch. The selector or profile is fixed by the SKU. Provide url or html."},"html":{"type":"string","examples":["<!doctype html><html lang=\"en\"><head><title>Hello</title>\n<meta name=\"description\" content=\"Desc\"><meta property=\"og:title\" content=\"OG\">\n<link rel=\"canonical\" href=\"https://example.com/\"><link rel=\"icon\" href=\"/favicon.ico\">\n</head><body><h1>Hello</h1><a href=\"https://example.com/a\">A</a></body></html>"],"maxLength":200000,"minLength":1,"description":"HTML to extract from locally. Provide html or url. When both are set, html is used."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fPINUNEW7dDttRReAoIkO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts the text content of H1 heading elements from a public webpage URL or raw HTML using the XPath expression //h1","exampleAgentPrompt":"Can you pull the H1 heading text from https://example.com for me?","exampleUseCases":[{"title":"SEO heading audit for a site","prompt":"What is the H1 heading on https://www.acmecorp.com/about — I want to check whether our SEO team updated it correctly."},{"title":"Extracting headline from raw HTML","prompt":"I have this raw HTML snippet from a competitor's page — can you extract the H1 heading text from it so I can compare their headline to ours?"},{"title":"Monitoring page title changes","prompt":"Check https://shop.brandname.com/product/widget-pro and tell me what the H1 heading says right now so I can log it for our weekly change-tracking report."}],"resultDescription":"Returns the text content of all H1 elements found on the page or in the provided HTML, extracted using the XPath selector //h1. If a URL is provided, the service fetches the page (SSRF-safe) and returns matched heading text. If raw HTML is provided directly, it parses and returns the H1 text without any network request.","failureModes":["URL is unreachable or returns a non-200 status — extraction fails with an error","No H1 element present on the page — returns empty result","SSRF-blocked URL (private IP ranges, metadata endpoints) — rejected for security","HTML input exceeds 200,000 character limit — request rejected","URL shorter than 8 characters or longer than 2048 characters — validation error","Malformed HTML that cannot be parsed — may return empty or partial results"],"whenToPreferThis":"Choose this endpoint when you need specifically H1 heading text from a page and want a lightweight, purpose-built extractor rather than a full DOM scraper. It is ideal for SEO audits, page title monitoring, or content comparison workflows where only the primary heading matters. Use it over the CSS selector endpoint when XPath-based H1 extraction is sufficient and you want to minimize cost ($0.007 USDC). For broader element extraction needs, prefer the CSS selector sibling endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:47:15.358Z","isFirstParty":false,"canonicalSlug":"agentshelf-xpath-h1-extractor-da232a12"}