The Feed Parser API from santosautomation-com — 1 operation(s) for feed parser.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/santosautomation-com:santosautomation-com-feed-parser-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Santos Website Intelligence Feed Parser API
version: 2.18.0
description: 'AI Website Intelligence for determining whether public websites can be discovered, understood, trusted, and used by agents. Twelve paid capabilities use USDC on Base mainnet (eip155:8453) via x402 v2 with no account or traditional API key. QUICK INTELLIGENCE (GET /api/audit, $0.015, synchronous): lightweight single-page fetch-and-parse audit. AGENT READINESS (GET /api/agent-readiness, $0.075, synchronous): bounded passive discovery and applicability-aware assessment of agent-facing interfaces. DEEP WEBSITE INTELLIGENCE (POST /v1/audits, $0.225, asynchronous): real Chromium via Playwright, Lighthouse, rendered axe-core, browser evidence, screenshots, and passive security checks. The other eight paid capabilities — SAFE FETCH (GET /v1/fetch, $0.002), CONTENT EXTRACTION (POST /v1/extract, $0.005), FEED PARSER (GET /v1/feed, $0.003), LINK MAP (GET /v1/links, $0.003), SUMMARIZER (POST /v1/summarize, $0.033), SCREENSHOT & PDF RENDER (GET /v1/screenshot, $0.01), STRUCTURED EXTRACTION (POST /v1/extract/structured, $0.08), and BATCH QUICK INTELLIGENCE (POST /api/audit/batch, $0.50 flat for up to 50 URLs) — are documented per-path below. Quick and Agent Readiness payments settle only on a successful response; Deep payment purchases a bounded compute reservation and settles when the job is accepted.'
contact:
name: Santos Automation
email: info@santosautomation.com
url: https://www.santosautomation.com
servers:
- url: https://api.santosautomation.com
tags:
- name: Feed Parser
paths:
/v1/feed:
get:
operationId: parseFeed
tags:
- Feed Parser
summary: Parse one public feed URL into normalized JSON ($0.003 USDC via x402…
description: 'Requires x402 v2 payment (base64 PAYMENT-REQUIRED challenge header; retry with PAYMENT-SIGNATURE); settles only on a successful parse. Fetches one public feed URL through the same hardened SSRF-guarded fetcher as /v1/fetch (private/link-local/cloud-metadata addresses blocked including via redirects, 15s timeout, 2MB cap, ports 80/443 only), detects RSS 2.0, Atom, or JSON Feed, and returns normalized JSON: feed metadata (title, link, description, feed_url) plus up to 50 items with id, title, url, published, summary, and author. A target that is not a recognized feed returns 422 and never settles. A POST variant with a JSON {url} body is paywalled identically.'
parameters:
- name: url
in: query
required: true
schema:
type: string
format: uri
description: Publicly reachable HTTP or HTTPS website URL. Bare domains are accepted (https:// is assumed). Localhost, private-network, and cloud-metadata addresses are rejected.
example: https://example.com
responses:
'200':
description: Feed parsed.
content:
application/json:
schema:
type: object
required:
- schema_version
- url
- final_url
- format
- feed
- item_count
- items
properties:
schema_version:
type: string
const: 1.0.0
url:
type: string
final_url:
type: string
format: uri
format:
type: string
enum:
- rss2
- atom
- json
feed:
type: object
properties:
title:
type:
- string
- 'null'
link:
type:
- string
- 'null'
description:
type:
- string
- 'null'
feed_url:
type:
- string
- 'null'
item_count:
type: integer
maximum: 50
items:
type: array
maxItems: 50
items:
type: object
properties:
id:
type:
- string
- 'null'
title:
type:
- string
- 'null'
url:
type:
- string
- 'null'
published:
type:
- string
- 'null'
summary:
type:
- string
- 'null'
author:
type:
- string
- 'null'
'400':
description: Invalid or blocked target URL (not charged).
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
'402':
description: Payment required/invalid. Terms in the PAYMENT-REQUIRED header; body is an agent-readable hint.
'422':
description: Target is not a recognized RSS 2.0, Atom, or JSON Feed (not charged — never settles).
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
'502':
description: Target site unreachable (not charged).
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID
'504':
description: Target site timed out (not charged).
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable explanation.
code:
type: string
description: Stable machine-readable error code.
enum:
- INVALID_URL
- UNSUPPORTED_SCHEME
- PRIVATE_ADDRESS_BLOCKED
- RATE_LIMITED
- FREE_TIER_RETIRED
- AUDIT_TIMEOUT
- TARGET_UNREACHABLE
- AUDIT_FAILED
- INVALID_EXTRACTION_SCHEMA
- STRUCTURED_OUTPUT_INVALID