{"uid":"cap_7u9BwGkHIxewjoMc_fgZ5","slug":"agentread-first-seen-587fe58f","name":"agentread /first-seen","description":"Read a URL your own fetch failed on and get the page text back, or a verdict explaining why it cannot be read. Built for agents that just got a 403, 429, empty body or JS shell.","url":"https://agentread.midi-thumb.workers.dev/first-seen?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type"],"properties":{"type":{"const":"http"},"method":{"const":"POST"}},"additionalProperties":true},"output":{"type":"object","additionalProperties":true}}},"responseSchema":{"type":"json","example":{"is_new":false,"age_hours":3.2,"first_seen":"2026-10-27T18:00:00Z"}},"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_h8trpLdwK0Fjs75bWuIG8","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":"Checks whether a URL has been seen before by the agentread service and returns its first-seen timestamp and age.","exampleAgentPrompt":"Has agentread ever seen https://example.com/article before, and if so when was it first seen and how old is it?","exampleUseCases":[{"title":"Deduplicating agent web fetches","prompt":"Before I process this article at https://techcrunch.com/2024/01/15/some-story, check if agentread has already seen it and tell me how many hours ago it was first fetched."},{"title":"Freshness check before scraping","prompt":"I'm about to scrape https://news.ycombinator.com/item?id=12345 — first tell me if agentread has ever seen this URL and when, so I know whether I'm getting stale cached data."},{"title":"Auditing URL discovery timeline","prompt":"When did agentread first encounter https://docs.openai.com/api-reference? I want to know if it's a newly discovered page or one that's been in the system for a while."}],"resultDescription":"Returns a JSON object with three fields: is_new (boolean indicating if this is the first encounter), age_hours (decimal hours since first seen), and first_seen (ISO 8601 timestamp of first encounter).","failureModes":["URL not yet in agentread system — may return is_new: true with no age_hours","Malformed or missing input URL causes validation error","Payment not received or insufficient USDC causes 402 rejection","Cloudflare Worker timeout on high load"],"whenToPreferThis":"Use this endpoint when you need to know whether a URL has previously been fetched by the agentread service, especially to avoid redundant scraping, assess content freshness, or audit discovery timelines. Not suitable for actually fetching page content — use the main agentread read endpoint for that.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:03.663Z","isFirstParty":false,"canonicalSlug":"agentread-first-seen-587fe58f"}