Discovery API
The Discovery API provides intelligent utilities to find and normalize content sources. Whether you have a raw website URL, a YouTube profile, or a Substack link, our discovery engine can extract the underlying feed.
Resolve a feed URL
This endpoint takes a standard URL and attempts to find a valid RSS/Atom feed. It has built-in support for:
- Substack: Extracts the feed from profile pages.
- Reddit: Converts subreddit and user links to RSS.
- Google Scholar: Transforms citation profiles into publication feeds.
- X/Twitter: Resolves profiles to canonical formats.
Required attributes
- Name
url- Type
- string
- Description
The raw URL to be resolved (e.g.,
https://example.substack.com).
Request
curl -X POST https://api.repur.ai/v1/discovery/resolve \
-H "X-API-Key: {your_api_key}" \
-H "Content-Type: application/json" \
-d '{"url": "https://reddit.com/r/technology"}'
{
"success": true,
"data": "https://www.reddit.com/r/technology/.rss",
"isCustomResolved": true
}
Search global feeds
Search for new content sources using the Feedly global index. This is perfect for finding new blogs, news sites, and newsletters to follow.
Required attributes
- Name
query- Type
- string
- Description
The search term or topic (e.g., "artificial intelligence").
Optional attributes
- Name
count- Type
- integer
- Description
The number of results to return (defaults to 5).
Request
curl "https://api.repur.ai/v1/discovery/search?query=AI&count=10" \
-H "X-API-Key: {your_api_key}"
Load more feeds
A specialized pagination utility for retrieving additional feed results after an initial global search.
Required attributes
- Name
query- Type
- string
- Description
The original search query.
- Name
count- Type
- integer
- Description
The number of additional results to fetch.
Request
curl "https://api.repur.ai/v1/discovery/search/more?query=AI&count=10" \
-H "X-API-Key: {your_api_key}"
Preview a Feedly source
Convert a Feedly search result into a full, normalized RSS feed object. This allows you to preview the latest items and detailed metadata of a source discovered via the Feedly search before subscribing to it.
Required attributes
- Name
feed- Type
- object
- Description
The full feed object returned from the
searchendpoint.
Request
curl -X POST https://api.repur.ai/v1/discovery/feedly/preview \
-H "X-API-Key: {your_api_key}" \
-H "Content-Type: application/json" \
-d '{
"feed": {
"feedId": "feed/http://feeds.feedburner.com/AI-Blog",
"title": "The AI Blog"
}
}'
{
"success": true,
"data": {
"feed_metadata": { "title": "The AI Blog", "url": "..." },
"feed_item": [ ... ]
}
}
Fetch page source
Retrieve the raw HTML source code of any public webpage. This is a foundational utility for scraping and custom feed discovery.
Required attributes
- Name
url- Type
- string
- Description
The full URL of the webpage to fetch.
Request
curl "https://api.repur.ai/v1/discovery/page-source?url=https://example.com" \
-H "X-API-Key: {your_api_key}"
<!DOCTYPE html>
<html>
<head>...</head>
<body>...</body>
</html>