Felo APIs
Felo APIs Overview
Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.
To pay for web search, web reading, X data, Chat or PPT with platform balance, use Felo in Data API. This page documents the existing /v2 APIs, which use Felo Pro credits.
Felo APIs are first-party, workflow-level APIs for search, documents, presentations, web extraction, social search, and agent workflows. They use the same Felo API key as the rest of the platform, but are billed separately from model calls.
Eligibility can change. The Console Billing page is the source of truth for your current balance and usage.
APIs in this section
| API | Endpoint | Use it for |
|---|---|---|
| Felo Search API | POST /v2/chat | Conversational web search with query analysis, sources, and citations |
| PPT Task API | POST /v2/ppts | Generate slide decks and poll task status |
| Mindmap API | POST /v2/mindmap | Turn a prompt or LiveDoc context into a mindmap |
| LiveDoc API | POST /v2/livedocs | Create knowledge bases, manage resources, and retrieve context |
| Web Fetch API | POST /v2/web/extract | Extract a webpage as HTML, text, or Markdown |
| X Search API | POST /v2/x/tweet/search | Search X users, tweets, timelines, and replies |
| YouTube Subtitling API | GET /v2/youtube/subtitling | Fetch YouTube subtitles and timestamps |
| Landing Page Task API | POST /v2/landing_page | Generate a landing page asynchronously |
| SuperAgent API | POST /v2/conversations | Run an agent conversation over SSE |
Authentication and first call
Create one Felo API key in Console → API Keys and send it as a Bearer token.
export FELO_API_KEY="YOUR_API_KEY"
curl -sS https://openapi.felo.ai/v2/chat \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"What are the latest AI agent trends?"}'A successful response includes an answer, query analysis, and cited web resources.
Billing model
| Surface | Path | How calls are paid |
|---|---|---|
| Felo APIs | /v2/* | Felo Pro credits |
| Felo in Data API | /api/v1/data/* | Platform balance, not Pro credits |
| Model API | /api/v1/* | Prepaid Felo API Platform service credits only; Felo Pro does not apply |
| Data API | /v1/beta/* | Uses the API catalog billing basis shown for each endpoint |
Felo Pro credits and API service credits are separate balances. A Felo Pro subscription does not automatically grant API service credits, and API service credits do not add Felo Pro subscription credits.
Related
Need help?
- Contact Support for API, billing, and account questions.
- Chat with Felo developers on Discord.
- Check out our changelog.
- Need volume pricing or procurement help? Contact Sales.
- Building with an LLM? Read llms.txt.