{"uid":"cap__z1EHXWYFc-PGRNNctnmx","slug":"rss-and-atom-feed-reader-keyword-search-6f4cdd63","name":"RSS and Atom Feed Reader — Keyword Search","description":"Fetch an RSS or Atom feed and return the items whose title, summary, author or categories contain a keyword or phrase.","url":"https://feed-reader.x402tookit.com/feed-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"],"type":"string"},"queryParams":{"type":"object","required":["url","q"],"properties":{"q":{"type":"string","description":"Keyword or phrase, 2 to 80 characters, case-insensitive substring match"},"url":{"type":"string","description":"Full https URL of the RSS, Atom or RDF feed, no credentials, default port"},"limit":{"type":"integer","description":"Matches to return, 1 to 50 (default 10), newest first"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"items":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["null","string"]},"link":{"type":["null","string"]},"title":{"type":["null","string"]},"author":{"type":["null","string"]},"summary":{"type":["null","string"]},"updated":{},"enclosure":{},"published":{"type":["null","string"]},"categories":{"type":["array","null"]}}}},"query":{"type":["null","string"]},"format":{"type":["null","string"]},"source":{"type":["null","string"]},"status":{"type":["null","number"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"finalUrl":{"type":["null","string"]},"returned":{"type":["null","number"]},"searched":{"type":["null","number"]},"bytesRead":{"type":["null","number"]},"redirects":{"type":["array","null"]},"disclaimer":{"type":["null","string"]},"matchCount":{"type":["null","number"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"contentType":{"type":["null","string"]},"requestedUrl":{"type":["null","string"]},"formatVersion":{"type":["null","string"]},"truncatedAtLimit":{"type":["boolean","null"]},"contentIsUntrusted":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kBosKNACDwzjut8sv-ARO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches an RSS or Atom feed and returns only the items whose title, summary, author, or categories match a given keyword or phrase.","exampleAgentPrompt":"Search the Hacker News RSS feed at https://news.ycombinator.com/rss for any items mentioning 'artificial intelligence' and return the top 10 matches.","exampleUseCases":[{"title":"Track competitor mentions in industry blog","prompt":"Can you search the TechCrunch RSS feed at https://techcrunch.com/feed/ for any posts that mention 'OpenAI' and show me the 15 most recent ones?"},{"title":"Find podcast episodes by topic","prompt":"Search the RSS feed at https://feeds.simplecast.com/54nAGcIl for episodes that mention 'machine learning' and give me up to 20 results."},{"title":"Monitor news feed for product keyword","prompt":"Pull the Reuters tech news feed at https://feeds.reuters.com/reuters/technologyNews and find all recent articles that mention 'semiconductor' — give me the top 5."}],"resultDescription":"Returns a list of matching feed items (up to the requested limit, newest first), each with title, link, publication date, author, plain-text summary, categories, and enclosure details. Also includes metadata such as total items searched, match count, whether results were truncated, the detected feed format, final resolved URL, and any redirects encountered.","failureModes":["Feed URL is unreachable or returns a non-200 HTTP status — no items returned, error status in response","URL does not point to a valid RSS/Atom/RDF feed — parse error or format mismatch returned","Keyword is fewer than 2 or more than 80 characters — validation error","Limit parameter outside 1–50 range — validation error","Feed is behind authentication or requires credentials — fetch fails","No items match the keyword — empty items array with matchCount of 0","Feed is malformed XML — degraded flag set, partial or no results"],"whenToPreferThis":"Choose this endpoint when you need to find specific items within a known feed URL matching a keyword or phrase, rather than fetching all recent items or validating the feed structure. It is ideal for monitoring feeds for topic mentions, filtering large feeds by subject, or building alerting workflows around specific content. Use sibling endpoints if you need all recent items without filtering, feed metadata/stats, or podcast episode listings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:32:49.062Z","isFirstParty":false,"canonicalSlug":"rss-and-atom-feed-reader-keyword-search-6f4cdd63"}