{"uid":"cap_ZfgJfIOhSL6l0FhwCw9QP","slug":"agentshelf-xpath-h2-extractor-894d05ea","name":"AgentShelf XPath H2 Extractor","description":"Call when an agent needs text of //h2 via //h2 from a public page or HTML (SSRF-safe). Exact $0.008 USDC. Prefer unpaid POST /v1/sandbox/xpath-h2 first.","url":"https://agentshelf.syntexa.ch/v1/xpath-h2?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.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lv7U19SVgjmrhLrs68ipN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","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 all H2 elements from a public web page URL or provided HTML using XPath, with SSRF protection.","exampleAgentPrompt":"Can you pull out all the H2 headings from https://example.com/blog/article so I can see what sections it has?","exampleUseCases":[{"title":"Blog post section outline","prompt":"Grab all the H2 headings from https://techcrunch.com/2024/01/ai-trends so I can see how the article is structured."},{"title":"Competitor page analysis","prompt":"Extract all H2 headings from this HTML I have — I want to see what sections a competitor's landing page uses to structure their content."},{"title":"SEO heading audit","prompt":"Pull all the H2 tags from https://mysite.com/services so I can check whether our section headings are keyword-optimized."}],"resultDescription":"A list of text strings, each representing the inner text of an H2 element found on the page or in the provided HTML, returned in document order and de-duplicated or raw depending on the service's behavior.","failureModes":["URL is unreachable or returns non-200 status — extraction fails with an error","URL points to an internal/private IP (SSRF attempt) — blocked by SSRF protection","HTML or URL exceeds size limits — request rejected","Page contains no H2 elements — returns empty list","Malformed HTML input — parser may return partial or empty results","Payment not included or insufficient — 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you specifically need H2-level headings from a page and want a targeted, low-cost extraction rather than a full heading outline. Prefer the free sandbox variant (/v1/sandbox/xpath-h2) when available. Use the paid endpoint when the sandbox is unavailable or rate-limited. Choose this over a full-heading-outline endpoint when only H2s are needed and you want to minimize cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:52:42.721Z","isFirstParty":false,"canonicalSlug":"agentshelf-xpath-h2-extractor-894d05ea"}