{"uid":"cap_dZig8aTqzy3xGMB0Mqtfb","slug":"x402-agent-data-utility-research-bundle-92bb8142","name":"X402 Agent Data Utility – Research Bundle","description":"Pay-per-request data tools for AI agents.","url":"https://x402.feld-feder.at/v1/research/bundle","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","title":"WebUrlRequest","required":["url"],"properties":{"url":{"type":"string","title":"Url","maxLength":4096,"minLength":1}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"ResponseEnvelope[ResearchBundleData]","required":["data"],"properties":{"ok":{"type":"boolean","const":true,"title":"Ok","default":true},"data":{"type":"object","title":"ResearchBundleData","required":["document","host","site","document_links","sources","partial_errors"],"properties":{"host":{"anyOf":[{"type":"object","title":"HostInspectionResult","required":["target_url","dns","tls","http","warnings"],"properties":{"dns":{"type":"object","title":"HostDnsResult","required":["hostname","port","addresses"],"properties":{"port":{"type":"integer","title":"Port","maximum":65535,"minimum":1},"hostname":{"type":"string","title":"Hostname"},"addresses":{"type":"array","items":{"type":"string"},"title":"Addresses"}},"additionalProperties":false},"tls":{"anyOf":[{"type":"object","title":"HostTlsResult","required":["protocol","cipher","alpn_protocol","peer_address","certificate"],"properties":{"cipher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cipher"},"protocol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Protocol"},"certificate":{"type":"object","title":"HostTlsCertificate","required":["subject","issuer","serial_number","not_before","not_after","subject_alt_names"],"properties":{"issuer":{"type":"array","items":{"type":"array","maxItems":2,"minItems":2,"prefixItems":[{"type":"string"},{"type":"string"}]},"title":"Issuer"},"subject":{"type":"array","items":{"type":"array","maxItems":2,"minItems":2,"prefixItems":[{"type":"string"},{"type":"string"}]},"title":"Subject"},"not_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Not After"},"not_before":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Not Before"},"serial_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Serial Number"},"subject_alt_names":{"type":"array","items":{"type":"string"},"title":"Subject Alt Names"}},"additionalProperties":false},"cipher_bits":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Cipher Bits","default":null},"peer_address":{"type":"string","title":"Peer Address"},"alpn_protocol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alpn Protocol"}},"additionalProperties":false},{"type":"null"}]},"http":{"anyOf":[{"type":"object","title":"WebInspectionResult","required":["requested_url","final_url","retrieved_at","status_code","content_type","content_bytes","content_hash","redirect_count","duration_ms","headers"],"properties":{"headers":{"type":"array","items":{"type":"object","title":"InspectionHeader","required":["name","value"],"properties":{"name":{"type":"string","title":"Name"},"value":{"type":"string","title":"Value"}},"additionalProperties":false},"title":"Headers"},"final_url":{"type":"string","title":"Final Url"},"duration_ms":{"type":"number","title":"Duration Ms","minimum":0},"status_code":{"type":"integer","title":"Status Code","maximum":599,"minimum":100},"content_hash":{"type":"string","title":"Content Hash","pattern":"^sha256:[0-9a-f]{64}$"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"retrieved_at":{"type":"string","title":"Retrieved At","format":"date-time"},"content_bytes":{"type":"integer","title":"Content Bytes","minimum":0},"requested_url":{"type":"string","title":"Requested Url"},"redirect_count":{"type":"integer","title":"Redirect Count","minimum":0}},"additionalProperties":false},{"type":"null"}]},"warnings":{"type":"array","items":{"type":"string"},"title":"Warnings"},"target_url":{"type":"string","title":"Target Url"}},"additionalProperties":false},{"type":"null"}]},"site":{"anyOf":[{"type":"object","title":"SiteDiscoveryResult","required":["source","robots_url","robots_allowed","feed_urls","sitemap_urls","page_urls","warnings"],"properties":{"source":{"type":"object","title":"SiteDiscoverySource","required":["requested_url","final_url","retrieved_at","status_code","content_type","content_hash","redirect_count"],"properties":{"final_url":{"type":"string","title":"Final Url"},"status_code":{"type":"integer","title":"Status Code","maximum":299,"minimum":200},"content_hash":{"type":"string","title":"Content Hash","pattern":"^sha256:[0-9a-f]{64}$"},"content_type":{"enum":["application/xhtml+xml","text/html"],"type":"string","title":"Content Type"},"retrieved_at":{"type":"string","title":"Retrieved At","format":"date-time"},"requested_url":{"type":"string","title":"Requested Url"},"redirect_count":{"type":"integer","title":"Redirect Count","minimum":0}},"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"},"title":"Warnings"},"feed_urls":{"type":"array","items":{"type":"string"},"title":"Feed Urls"},"page_urls":{"type":"array","items":{"type":"string"},"title":"Page Urls"},"robots_url":{"type":"string","title":"Robots Url"},"sitemap_urls":{"type":"array","items":{"type":"string"},"title":"Sitemap Urls"},"robots_allowed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Robots Allowed"}},"additionalProperties":false},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","title":"ResearchBundleSource","required":["component","requested_url","final_url","retrieved_at","status_code","content_type","content_hash","redirect_count"],"properties":{"component":{"enum":["html","host_http","site"],"type":"string","title":"Component"},"final_url":{"type":"string","title":"Final Url"},"status_code":{"type":"integer","title":"Status Code"},"content_hash":{"type":"string","title":"Content Hash"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"retrieved_at":{"type":"string","title":"Retrieved At","format":"date-time"},"requested_url":{"type":"string","title":"Requested Url"},"redirect_count":{"type":"integer","title":"Redirect Count"}},"additionalProperties":false},"title":"Sources"},"document":{"type":"object","title":"HtmlToolDocument","required":["markdown","metadata","links"],"properties":{"links":{"type":"array","items":{"type":"object","title":"HtmlToolLink","required":["url","classification"],"properties":{"url":{"type":"string","title":"Url"},"classification":{"enum":["internal","external"],"type":"string","title":"Classification"}},"additionalProperties":false},"title":"Links"},"markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Markdown"},"metadata":{"type":"object","title":"HtmlToolMetadata","required":["title","language","canonical_url","open_graph","json_ld"],"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"json_ld":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Json Ld"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"open_graph":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Open Graph"},"canonical_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Url"}},"additionalProperties":false}},"additionalProperties":false},"document_links":{"type":"array","items":{"type":"string"},"title":"Document Links"},"partial_errors":{"type":"array","items":{"type":"object","title":"ResearchBundlePartialError","required":["component","code","message"],"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"component":{"enum":["host","site"],"type":"string","title":"Component"}},"additionalProperties":false},"title":"Partial Errors"}},"additionalProperties":false},"cache":{"anyOf":[{"type":"object","title":"CacheInfo","required":["hit"],"properties":{"hit":{"type":"boolean","title":"Hit"},"age_seconds":{"type":"integer","title":"Age Seconds","default":0,"minimum":0}}},{"type":"null"}],"default":null},"source":{"anyOf":[{"type":"object","title":"SourceInfo","required":["requested_url","final_url","retrieved_at"],"properties":{"final_url":{"type":"string","title":"Final Url"},"status_code":{"anyOf":[{"type":"integer","maximum":599,"minimum":100},{"type":"null"}],"title":"Status Code","default":null},"content_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Hash","default":null},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type","default":null},"retrieved_at":{"type":"string","title":"Retrieved At","format":"date-time"},"requested_url":{"type":"string","title":"Requested Url"},"redirect_count":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Redirect Count","default":null}}},{"type":"null"}],"default":null},"_payment":{"anyOf":[{"type":"object","title":"PaymentInfo","required":["amount_usdc","network"],"properties":{"network":{"type":"string","title":"Network"},"amount_usdc":{"anyOf":[{"type":"number","minimum":0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Amount Usdc"},"transaction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction","default":null}}},{"type":"null"}],"default":null},"warnings":{"type":"array","items":{"type":"object","title":"WarningInfo","required":["code","message"],"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"}}},"title":"Warnings"},"provenance":{"type":"array","items":{"type":"string"},"title":"Provenance"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"host":null,"site":null,"sources":[],"document":{"links":[],"markdown":"# Example","metadata":{"title":"Example","json_ld":[],"language":"en","open_graph":[],"canonical_url":"https://example.com"}},"document_links":[],"partial_errors":[]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5iWHzfJrmmIKR9Zgc5QxX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a research bundle for a given URL, returning structured page content, metadata, links, and markdown extraction in a single pay-per-request call.","exampleAgentPrompt":"Can you fetch the full research bundle for https://openai.com/blog — I need the page markdown, title, canonical URL, Open Graph tags, JSON-LD, and all the links on the page?","exampleUseCases":[{"title":"Competitive research page extraction","prompt":"Pull the research bundle for https://anthropic.com/index — I need the markdown content, page title, Open Graph metadata, and all outbound links so I can analyze what they're highlighting."},{"title":"SEO metadata audit for a landing page","prompt":"Fetch the research bundle for https://mycompany.com/product and give me the canonical URL, language, JSON-LD structured data, and Open Graph tags — I'm doing an SEO audit."},{"title":"News article content extraction","prompt":"Get me the full research bundle for https://techcrunch.com/2024/05/01/some-article — I need the markdown body, title, and all the links referenced in the piece."}],"resultDescription":"Returns a JSON object with 'ok' status and a 'data' object containing: host and site identifiers, a list of sources, a document object with markdown-rendered page content and metadata (title, language, canonical URL, JSON-LD, Open Graph), a list of document links, and any partial errors encountered during fetching.","failureModes":["URL is unreachable or returns non-200 status — may result in empty document or partial_errors populated","Private or paywalled pages may return empty or partial content","Malformed or non-HTML URLs may yield no markdown or metadata","Payment failure (insufficient USDC) blocks the request before execution","Rate limiting or network timeouts may cause incomplete responses"],"whenToPreferThis":"Choose this endpoint when you need a single-call research bundle combining markdown extraction, page metadata, Open Graph, JSON-LD, and link enumeration from a URL — especially in agent workflows where minimizing round trips matters. It is well-suited for pay-per-use agent pipelines using the x402 micropayment protocol at $0.025 USDC per call, making it cost-effective for one-off or infrequent page lookups rather than bulk crawling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:39:40.347Z","isFirstParty":false}