Skip to main content

RSS/Atom/JSON Feed Discovery API

free
GET/v1/domain/feeds

Discovers 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. 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 Specialist

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.

Content Strategist

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.

Developer

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

NameLocationTypeRequiredDescription
domainquerystringRequiredDomain or full URL — accepts `techcrunch.com` or `https://blog.example.com/path`.Example: https://techcrunch.com
validateBodiesquerybooleanOptionalWhen true, fetches each discovered feed (cap 3) and parses RSS/Atom/JSON body to verify it actually works. Reports itemCount, lastEntryDate, staleness (>90 days), and parse errors. Also HEAD-verifies the WebSub hub URL.Example: true

Response Fields

Result fields below are inside the JSON data object. Any row named meta describes the sibling response metadata object. See response and error handling for status codes and error responses. Optional observations may be absent or null; inspect warnings and partial-failure fields before treating a missing result as a negative finding.

FieldTypeDescription
domainstringThe queried domain (bare hostname).
urlstringFull URL that was fetched, echoing the protocol used in the request.
feedsarrayDiscovered feeds — each with type (rss/atom/json), URL, and title
countnumberTotal number of feeds discovered
hasRssbooleanWhether RSS 2.0 feeds were found
hasAtombooleanWhether Atom feeds were found
hasJsonbooleanWhether JSON Feed (jsonfeed.org) endpoints were found
websubHubstringWebSub hub URL if detected (null if none)
feedValidationarrayPer-feed validation (when validateBodies=true): format, status, isValid, itemCount, channelTitle, lastEntryDate, daysSinceLastEntry, stale (>90 days), parseErrors, sample items. Catches the very common "RSS link points at a dead feed" case.
websubVerificationobjectWebSub hub HEAD verification (when validateBodies=true): verified, status, contentType. Most rel="hub" declarations point at dead endpoints — verifying lets you fix or remove.
scorenumberFeed implementation score (0-100)
gradestringLetter grade (A-F) based on score
recommendationsarrayActionable feed implementation suggestions

Code Examples

Replace YOUR_API_KEY with your API key. This endpoint requires the free plan or higher; see plans and usage limits.

cURL
curl --request GET 'https://api.edgedns.dev/v1/domain/feeds?domain=https%3A%2F%2Fsiteproxy.ruqli.workers.dev%3A443%2Fhttps%2Ftechcrunch.com' \
  --header "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch(
  "https://api.edgedns.dev/v1/domain/feeds?domain=https%3A%2F%2Fsiteproxy.ruqli.workers.dev%3A443%2Fhttps%2Ftechcrunch.com",
  {
    "method": "GET",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
);

if (!response.ok) {
  throw new Error(`EdgeDNS returned HTTP ${response.status}`);
}
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    'GET',
    "https://api.edgedns.dev/v1/domain/feeds?domain=https%3A%2F%2Fsiteproxy.ruqli.workers.dev%3A443%2Fhttps%2Ftechcrunch.com",
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    timeout=60,
)
response.raise_for_status()
data = response.json()
print(data)

Read the full RSS/Atom/JSON Feed Discovery guide

Learn the concepts, choose a practical workflow, and interpret the observations from RSS/Atom/JSON Feed Discovery before acting on them. Run supported checks via MCP or through REST.

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.

    RSS/Atom/JSON Feed Discovery API Reference | EdgeDNS