Discover feed API

Pull the public Discover feed

curl "https://reviral.ai/api/v1/discover?page=1&limit=24" \
  -H "Authorization: Bearer $REVIRAL_API_KEY"

Who lands here and from where

Reseller developers arrive from the API overview, search results, generated documentation, or the machine-readable endpoint index when they need content to link or embed.

What they must see first

The authenticated curl example above works as written after REVIRAL_API_KEY is set.

How it ranks and gets cited

The keyword-focused Discover feed API title, OpenAPI response schema, FAQ structured data, sitemap-derived docs URL, and llms.txt endpoint row make the contract indexable and citable.

What it upsells

Turn a selected topic into media with generate-media, then review plans and credits on the pricing page.

List the public Discover feed

Returns the same trending topics and public video metadata as the public Discover page for the same source snapshot; refresh times can differ. Sources are YouTube, Hacker News, Wikipedia, Google Trends, and TikTok. Third-party titles and URLs are preserved. Internal descriptions and model metadata are excluded. Filter titles with q or select one visible source with tag. Requests are limited to 60 per minute per API key; invalid queries count toward this limit. This endpoint requires a configured, available rate-limit store. If it is unavailable, requests return 503 rate_limit_unavailable with Retry-After: 60 to keep throttling enforced.

Authentication: Bearer API key required

curl "https://reviral.ai/api/v1/discover" \
  -H "Authorization: Bearer $REVIRAL_API_KEY"