# RSS and Atom Feed Reader — Keyword Search

> RSS and Atom Feed Reader — Keyword Search is a paid API for AI agents from feed-reader.x402tookit.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-02).

Fetches an RSS or Atom feed and returns only the items whose title, summary, author, or categories match a given keyword or phrase.

## Facts

- Endpoint: GET https://feed-reader.x402tookit.com/feed-search?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rss-and-atom-feed-reader-keyword-search-6f4cdd63
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__z1EHXWYFc-PGRNNctnmx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rss-and-atom-feed-reader-keyword-search-6f4cdd63
```

Example prompt: Search the Hacker News RSS feed at https://news.ycombinator.com/rss for any items mentioning 'artificial intelligence' and return the top 10 matches.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Fetch an RSS or Atom feed and return the items whose title, summary, author or categories contain a keyword or phrase.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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",
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rss-and-atom-feed-reader-keyword-search-6f4cdd63/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from feed-reader.x402tookit.com](https://www.zero.xyz/host/feed-reader.x402tookit.com/llms.txt)