{"uid":"cap_dmWAeyS4-RbTeJjmw8pCD","slug":"forest-factory-api-structured-page-extraction-566f37fa","name":"Forest Factory API – Structured Page Extraction","description":"Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.","url":"https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/page/structured?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","maxLength":2048,"minLength":1,"description":"Public HTTP(S) URL to inspect, resolve, or compare."}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"title":"example","jsonld":{"entities":[],"blocks_seen":0,"type_counts":[],"entity_count":0,"blocks_parsed":0,"malformed_blocks":0},"robots":"example","language":"example","truncated":false,"open_graph":{"url":"example","type":"example","title":"example","description":"example"},"source_url":"example","description":"example","canonical_url":"example","rendered_javascript":false},"meta":{"cache":"miss","provider":"safe-http","checked_at":"2026-01-01T00:00:00.000Z","duration_ms":0},"version":"1","capability":"web.page-structured"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_j89EmlvH8NqEsrGf6DN0K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a public URL and returns structured metadata including title, description, Open Graph tags, JSON-LD entities, robots directives, language, and canonical URL.","exampleAgentPrompt":"Can you fetch the structured metadata for https://example.com/product/123 — I need the page title, description, Open Graph info, and any JSON-LD entities it has?","exampleUseCases":[{"title":"SEO audit of a landing page","prompt":"Pull the structured metadata from https://mystore.com/spring-sale — I want to check the title, description, canonical URL, and whether it has any JSON-LD markup."},{"title":"Entity extraction from a news article","prompt":"Fetch https://www.bbc.com/news/technology-12345678 and extract any JSON-LD entities mentioned — I want to know what types of structured data the page declares."},{"title":"Open Graph preview before sharing","prompt":"Check https://techcrunch.com/2024/05/01/ai-startup-funding and tell me what Open Graph title, description, and URL it returns so I can preview what it'll look like when shared on social media."}],"resultDescription":"A JSON object containing: page title, meta description, canonical URL, source URL, language, robots directives, Open Graph metadata (url, type, title, description), JSON-LD block data (entity count, entity list, type counts, parse stats), a truncated flag, whether JavaScript was rendered, and request metadata including cache status, provider, checked_at timestamp, and duration in milliseconds.","failureModes":["URL is not publicly accessible (private/firewalled) — may return error or empty data","Malformed or non-HTTP(S) URL fails input validation","Page has no structured metadata — returns empty Open Graph and JSON-LD fields","JavaScript-rendered content not captured (rendered_javascript: false)","Payment not signed — returns HTTP 402 with x402 PAYMENT-REQUIRED challenge","Timeout fetching slow or large pages — duration_ms may be high or call may fail","Truncated response if page content exceeds limits (truncated: true)"],"whenToPreferThis":"Choose this endpoint when you need a single structured, machine-readable snapshot of a webpage's metadata — including Open Graph, JSON-LD entities, canonical URL, and language — without needing to parse raw HTML yourself. Prefer this over raw scraping when you want clean, normalized metadata fields ready for downstream use. It is especially useful for SEO analysis, link preview generation, entity extraction, and content enrichment pipelines where speed and structure matter more than full-page rendering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:43:27.089Z","isFirstParty":false,"canonicalSlug":"forest-factory-api-structured-page-extraction-566f37fa"}