{"uid":"cap_oopZPxJ-LzebFUDcLiSEu","slug":"agentservices-url-metadata-extraction-43d7b109","name":"AgentServices URL Metadata Extraction","description":"URL metadata extraction and unfurling","url":"https://api.agentservices.to/v1/metadata","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"query":{"type":"object","properties":{"url":{"type":"string"}}},"method":{"enum":["DELETE","GET","HEAD"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}},"routeTemplate":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_R76mWh0OAkfXnYId3bxc5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts and unfurls metadata from a given URL, returning structured information about the page or resource.","exampleAgentPrompt":"Can you fetch the metadata and link preview info for this URL: https://example.com/article/some-news-story?","exampleUseCases":[{"title":"Link preview before sharing","prompt":"Before I post this link to my team, can you pull the title, description, and any image metadata from https://techcrunch.com/2024/01/ai-trends so I know what the preview will look like?"},{"title":"Enriching a list of URLs with page info","prompt":"I have this product URL — https://shop.example.com/product/widget-pro — can you extract its title and description so I can add it to my catalog?"},{"title":"Verifying article content before citation","prompt":"Can you fetch the metadata from https://nature.com/articles/some-study to confirm the title and author info before I cite it in my report?"}],"resultDescription":"Returns structured metadata extracted from the target URL, typically including page title, description, Open Graph tags, canonical URL, and other link-preview relevant fields parsed from the page's HTML head.","failureModes":["URL is unreachable or returns a non-200 status — metadata not available","Target page blocks bots/crawlers — returns empty or incomplete metadata","URL is malformed or missing — request validation error","Page has no metadata tags — returns minimal or empty fields","Timeout on slow-loading pages — partial or no result"],"whenToPreferThis":"Use this endpoint when you need to quickly extract structured metadata (title, description, Open Graph tags) from a single URL without crawling the full page content. Ideal for link enrichment, preview generation, or populating catalog fields from URLs. Prefer this over a full web scraper when you only need head-level metadata, not body content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:31:52.705Z","isFirstParty":false}