{"uid":"cap_EKKh-TIou8WaLstJiUcVg","slug":"firstmention-web-search-api-a6d648ae","name":"FirstMention Web Search API","description":"Pay-per-call HTTP APIs, paid with x402 in USDC on Base (eip155:8453): agentkit, api-change-check, basedue, basewatch, chainread, check-sanctions, chgwatch, company-facts, composite, edgar, feednews, pageaudit, solcheck, token-dd, txpreflight, walletcheck, webmd, webread, websearch, x402index. Each operation describes its service.","url":"https://api.firstmention.uk/s/websearch/search?utm_source=zero.xyz","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"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"search query, max 300 chars"},"chars":{"type":"integer","maximum":8000,"minimum":200,"description":"for /brief: markdown chars per page"},"limit":{"type":"integer","maximum":25,"minimum":1},"format":{"enum":["json","md"],"type":"string"},"extract":{"type":"integer","maximum":5,"minimum":0,"description":"for /brief: how many top hits to fetch and convert to markdown"},"sources":{"type":"string","description":"comma list of wiki,hn,github,se"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ok":{"type":"boolean"},"pages":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"clipped":{"type":"boolean"},"markdown":{"type":"string"},"final_url":{"type":"string"},"markdown_chars":{"type":"number"}}}},"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"snippet":{"type":"string"},"rank_score":{"type":"number"}}}},"result_count":{"type":"number"},"sources_used":{"type":"array","items":{"type":"string"}},"pages_extracted":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"query":"x402 payments","results":[{"url":"https://news.ycombinator.com/item?id=1","title":"Show HN: x402 payments","snippet":"Show HN discussion of x402 paid endpoints","sources":["hn","github"],"rank_score":9.2}],"result_count":12,"sources_used":["wiki","hn","github"],"source_errors":{}}},"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_yojuR3kBCo39iBFtFcmq8","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":"Searches across Wikipedia, Hacker News, GitHub, and Stack Exchange to return ranked web results for a given query, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Search for 'x402 payment protocol' across Wikipedia, Hacker News, and GitHub and give me the top 5 results as JSON.","exampleUseCases":[{"title":"Research a technical concept","prompt":"Search for 'zero-knowledge proofs' across Wikipedia and Stack Exchange and show me the top 10 results so I can get up to speed quickly."},{"title":"Find HN community reaction to a product","prompt":"Can you search Hacker News and GitHub for discussions about 'Coinbase AgentKit' and return the top 8 results ranked by relevance?"},{"title":"Aggregate open-source context for a coding task","prompt":"Search GitHub and Stack Exchange for 'Python asyncio rate limiting' and give me up to 15 results in markdown format so I can paste them into my notes."}],"resultDescription":"A JSON object containing a boolean 'ok' flag, the original query string, an array of result objects (each with url, title, snippet, sources array, and rank_score), a total result_count, a sources_used array, and a source_errors field listing any sources that failed.","failureModes":["Missing required 'q' query parameter returns a validation error","Invalid 'sources' value not in wiki/hn/github/se set may be ignored or error","'limit' outside 1-25 range rejected by schema validation","Payment failure via x402 protocol returns 402 Payment Required before any search is performed","Underlying source (e.g. HN, GitHub) temporarily unavailable causes that source to appear in source_errors with partial results still returned","Empty result set returned if no matching documents found across selected sources"],"whenToPreferThis":"Choose this endpoint when you need lightweight, pay-per-call web search across curated open knowledge sources (Wikipedia, Hacker News, GitHub, Stack Exchange) without a subscription or API key — especially in autonomous agent workflows where micropayment via x402 USDC on Base is available and per-call cost must be minimal ($0.01). Prefer this over general-purpose web search APIs when results from developer/technical communities and encyclopedic sources are most relevant, and when markdown output format is useful for direct downstream consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:40:06.446Z","isFirstParty":false,"canonicalSlug":"firstmention-web-search-api-a6d648ae"}