RSS/Atom/JSON Feed Discovery
free/v1/domain/feedsDiscovers RSS 2.0, Atom, and JSON Feed endpoints on a website using a two-phase approach: first parsing HTML <link rel="alternate"> autodiscovery tags (per the RSS Board specification), then probing 11 common feed paths used by popular CMS platforms (WordPress, Hugo, Jekyll, Ghost). Also detects WebSub (W3C Recommendation) hub endpoints for real-time subscription support. Returns feed URLs, format types, titles, and actionable recommendations for improving feed implementation.
What It Does
Phase 1: Parses the HTML <head> section for <link rel="alternate"> tags with RSS (application/rss+xml), Atom (application/atom+xml), and JSON Feed (application/feed+json) MIME types. Phase 2: Probes common feed paths (/feed, /rss, /rss.xml, /feed.xml, /atom.xml, /index.xml, /blog/feed, /feed.json) via HEAD requests and validates responses by content type. Also extracts WebSub hub links for real-time push notification support.
Why It's Useful
RSS/Atom feeds remain the backbone of content syndication, powering news aggregators, podcast directories, SEO monitoring tools, and automated content pipelines. Over 60% of the top 10K websites still maintain RSS feeds. Automated feed discovery is essential for building aggregation platforms, monitoring competitor content strategies, auditing SEO syndication readiness, and integrating real-time content updates via WebSub.
Use Cases
SEO Content Syndication Audit
Audit whether a website properly exposes RSS/Atom feeds via autodiscovery link tags, checks for JSON Feed support, and implements WebSub for real-time indexing. Identify missing feed formats that could improve content distribution to Google News, Apple News, and other aggregators.
Improve content discoverability and syndication reach by identifying and fixing feed implementation gaps.
Competitive Content Monitoring
Discover competitor RSS/Atom feeds programmatically to set up automated monitoring of publishing cadence, content themes, and product announcements. Use feed metadata to understand update frequency and content volume.
Build automated competitive intelligence pipelines that track competitor content output in real time.
Feed Aggregator Integration
Programmatically discover feed URLs for thousands of websites when building news aggregators, podcast directories, or content curation platforms. Detect feed format (RSS vs Atom vs JSON Feed) and WebSub hub availability to optimize subscription strategy.
Automate feed URL discovery at scale, eliminating manual configuration for content aggregation platforms.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | The domain to discover feeds for (e.g., techcrunch.com, blog.example.com)Example: techcrunch.com |
Response Fields
| Field | Type | Description |
|---|---|---|
domain | string | The queried domain |
feeds | array | Discovered feeds — each with type (rss/atom/json), URL, and title |
count | number | Total number of feeds discovered |
hasRss | boolean | Whether RSS 2.0 feeds were found |
hasAtom | boolean | Whether Atom feeds were found |
hasJson | boolean | Whether JSON Feed (jsonfeed.org) endpoints were found |
websubHub | string | WebSub hub URL if detected (null if none) |
score | number | Feed implementation score (0-100) |
grade | string | Letter grade (A-F) based on score |
recommendations | array | Actionable feed implementation suggestions |
Code Examples
curl "https://api.edgedns.dev/v1/domain/feeds" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=techcrunch.com"const response = await fetch(
'https://api.edgedns.dev/v1/domain/feeds?domain=techcrunch.com',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/domain/feeds',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'techcrunch.com'
}
)
data = response.json()
print(data)Read the full RSS/Atom/JSON Feed Discovery guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.
Try This Endpoint
Test the RSS/Atom/JSON Feed Discovery endpoint live in the playground.