# doc-json Feed Parser

> doc-json Feed Parser is a paid API for AI agents from doc-json.agent-utils.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Fetches an RSS, Atom, or JSON feed URL and returns its items as clean structured JSON including titles, authors, links, summaries, and timestamps.

## Facts

- Endpoint: GET https://doc-json.agent-utils.workers.dev/v1/feed
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/doc-json-feed-parser-f2c37d76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WvpOeM6ggf24A34fBIw-x

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 doc-json-feed-parser-f2c37d76
```

Example prompt: Fetch the Hacker News front page RSS feed at https://hnrss.org/frontpage and give me the latest 30 items as structured JSON with titles, links, and published dates.

## When to prefer this

Choose this endpoint when you need to ingest RSS, Atom, or JSON feed data as structured JSON for further processing by an AI agent, without managing your own feed parsing library. It is ideal for agent workflows that need to monitor blogs, news sites, or podcasts for new content and require clean, normalized per-item data. Prefer this over a generic web scraper when the target URL is a proper syndication feed.

## Known failure modes

- Invalid or non-feed URL returns an error response
- Feed URL is unreachable or times out
- URL points to a non-feed resource (HTML page, PDF) rather than RSS/Atom/JSON
- limit parameter out of range (must be 1–200)
- Feed requires authentication — fetching fails without credentials
- Malformed feed XML causes parse failure

## How this service works

Web pages, PDFs and feeds turned into clean structured JSON for AI agents: metadata, schema.org data, tables, headings, readable text, per-page PDF text, feed items. Pay per call over x402, no API key.

## Output

A JSON object containing the feed's title, URL, format (rss/atom/json), language, description, last-updated timestamp, fetch timestamp, response time in ms, total item count, and an array of items each with id, link, title, author, summary, published date, updated date, categories array, and enclosure object.

## 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"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri",
       "description": "Absolute http(s) URL of the feed"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 200,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string"
      },
      "link": {
       "type": [
        "string",
        "null"
       ]
      },
      "items": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": [
           "string",
           "null"
          ]
         },
         "link": {
          "type": [
           "string",
           "null"
          ]
         },
         "title": {
          "type": [
           "string",
           "null"
          ]
         },
         "author": {
          "type": [
           "string",
           "null"
          ]
         },
         "summary": {
          "type": [
           "string",
           "null"
          ]
         },
         "updated": {
          "type": [
           "string",
           "null"
          ]
         },
         "enclosure": {
          "type": [
           "object",
           "null"
          ]
         },
         "published": {
          "type": [
           "string",
           "null"
          ]
         },
         "categories": {
          "type": "array",
          "items": {
           "type": "string"
          }
         }
        }
       }
      },
      "title": {
       "type": [
        "string",
        "null"
       ]
      },
      "format": {
       "enum": [
        "rss",
        "atom",
        "json"
       ],
       "type": "string"
      },
      "status": {
       "type": "integer"
      },
      "updated": {
       "type": [
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://hnrss.org/frontpage",
  "link": "https://news.ycombinator.com/",
  "items": [
   {
    "id": "https://news.ycombinator.com/item?id=1",
    "link": "https://example.com/post",
    "title": "Show HN: ...",
    "author": "someone",
    "summary": "Article URL: ... Points: 120 # Comments: 40",
    "updated": null,
    "enclosure": null,
    "published": "Sun, 06 Sep 2026 20:00:00 +0000",
    "categories": []
   }
  ],
  "title": "Hacker News: Front Page",
  "format": "rss",
  "status": 200,
  "updated": "Sun, 06 Sep 2026 21:29:00 +0000",
  "language": "en-us",
  "fetchedAt": "2026-09-06T21:30:00.000Z",
  "itemCount": 30,
  "responseMs": 180,
  "description": "Hacker News RSS"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/doc-json-feed-parser-f2c37d76/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from doc-json.agent-utils.workers.dev](https://www.zero.xyz/host/doc-json.agent-utils.workers.dev/llms.txt)