Skip to main content
POST /v1/run is the complete surface of fetchbean. It lets you reach any supported provider endpoint directly and returns the provider’s native response without any normalization or transformation. Every curated tool (Search, Read, Weather) is built on top of this same endpoint, so anything you can do with a curated tool you can also do — and more — with /v1/run.

​
Request format

Every /v1/run call takes three fields in the request body:
FieldTypeDescription
providerstringThe provider id — for example exa, tavily, jina, or openweather.
endpointstringThe provider’s own endpoint path — for example /search or /v1/extract.
inputobjectThe request body passed through directly to the provider.

​
Examples

curl https://api.fetchbean.com/v1/run \
  -H "Authorization: Bearer $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"exa","endpoint":"/search","input":{"query":"best vector databases","numResults":10}}'

​
Available providers

fetchbean supports the following providers through /v1/run. Each provider has its own set of endpoints and per-call credit costs documented in the catalog.
Provider IDCategoryDescription
exaWeb searchNeural web search built for retrieval across the open web.
parallelWeb searchRun multiple search queries or URL extractions in a single call.
jinaPage readingTurns any URL into clean, LLM-ready markdown.
tikhubSocial dataSocial data including public Instagram profiles.
openweatherWeatherOn-demand weather data by city name or coordinates.
tavilyWeb searchAgent-focused web search with optional synthesized answers.
perplexityWeb searchWeb search with synthesized, cited answers.
remoteokJobsRemote job listings across the web.
apprevsApp intelligenceiOS App Store search, metadata, reviews, ratings, and AI insights.
fetchbeanData utilitiesFirst-party utilities — quotes, jokes, facts, UUIDs, LLM pricing.
firefliesMeetings (BYOK)Meeting transcripts, summaries, and action items. Requires connection.
posthogAnalytics (BYOK)Product analytics, feature flags, HogQL queries, and more. Requires connection.
linearIssue tracking (BYOK)Issues, projects, teams, and comments. Requires connection.
BYOK providers — Fireflies, PostHog, and Linear require you to connect your own API key before calling them. See the BYOK Connections guide for setup instructions.
Not sure which provider or endpoint to use? Call GET /discover?q=your+task to get a ranked list of provider methods that match your task description.