Catalog - fetchbean

Call any method below through POST /v1/run with a provider, endpoint, and input. Browse the same catalog interactively at fetchbean.com/catalog.

Exa

Neural web search built for retrieval across the open web. (web-search)

Search

Search the open web for ranked links (title, url, snippet, score). The default web search; use read to fetch a result’s full text. Cost: 100 credits per call

Parameter	Type	Required
`query`	string	yes
`numResults`	integer	no
`type`	string	no
(other provider fields)	any	no

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

Jina

Reader and web search: clean markdown from any URL, plus ranked web results. (scrape)

Read

Fetch a URL and return clean markdown, no nav or clutter. Cost: 10 to 300 credits

Parameter	Type	Required
`url`	string	yes
`format`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"jina","endpoint":"/read","input":{"url":"https://example.com/post"}}'

Search

Search the web for ranked links (title, url, snippet). Use read to fetch a result’s full page. num is results per page (up to 20), page pages through them, gl/hl set country and language, site limits to one or more domains, type is web, images or news. Cost: 10 to 100 credits

Parameter	Type	Required
`q`	string	yes
`page`	integer	no
`num`	integer	no
`gl`	string	no
`hl`	string	no
`location`	string	no
`site`	string	string[]	no
`type`	string	no
`filetype`	string	no
`intitle`	string	no
`loc`	string	no
`ext`	string	no
`nfpr`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"jina","endpoint":"/search","input":{"q":"best vector databases"}}'

Firecrawl

Scrape and search the web as clean, LLM-ready markdown, with JS rendering. (scrape)

Scrape

Scrape a URL to clean, LLM-ready markdown with JS rendering. Handles dynamic, script-heavy pages a plain reader misses. Cost: 50 to 2500 credits

Parameter	Type	Required
`url`	string	yes
`formats`	string[]	no
`onlyMainContent`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"firecrawl","endpoint":"/scrape","input":{"url":"https://firecrawl.dev"}}'

Search

Search the web and get ranked results (title, url, description). Fetch a result’s full text with the read or firecrawl_scrape tool. Cost: 50 to 1200 credits

Parameter	Type	Required
`query`	string	yes
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"firecrawl","endpoint":"/search","input":{"query":"best vector databases","limit":5}}'

OpenWeather

On-demand weather data by city or coordinates. (weather)

Current weather

Current conditions for a place by name or lat/lon. Cost: 20 credits per call

Parameter	Type	Required
`q`	string	no
`lat`	number	no
`lon`	number	no
`units`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openweather","endpoint":"/data/2.5/weather","input":{"q":"Tokyo"}}'

Context.dev

Brand intelligence — logos, colors, fonts, and company data for any domain, email, name, or ticker. (brand-data)

Brand data

Structured brand profile (logos, colors, description, socials, industry, address) for a company by domain, email, name, or ticker. Cost: 300 credits per call

Parameter	Type	Required
`domain`	string	no
`email`	string	no
`name`	string	no
`ticker`	string	no
`force_language`	string	no
`maxSpeed`	boolean	no
`maxAgeMs`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"contextdev","endpoint":"/brand/retrieve","input":{"domain":"stripe.com"}}'

NAICS code

Classify a company into 2022 NAICS industry codes (code, name, confidence) by domain or company name. Cost: 300 credits per call

Parameter	Type	Required
`input`	string	yes
`minResults`	integer	no
`maxResults`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"contextdev","endpoint":"/web/naics","input":{"input":"stripe.com"}}'

SIC code

Classify a company into SIC industry codes (code, name, major group, confidence) by domain or company name. type: original_sic (default) or latest_sec. Cost: 300 credits per call

Parameter	Type	Required
`input`	string	yes
`type`	string	no
`minResults`	integer	no
`maxResults`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"contextdev","endpoint":"/web/sic","input":{"input":"stripe.com"}}'

Logo.dev

Brand search: resolve a company or brand name to its domain. (brand-data)

Brand search

Resolve a company or brand name to its domain — fuzzy search over logo.dev’s brand index. Cost: 10 credits per call

Parameter	Type	Required
`q`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"logodev","endpoint":"/search","input":{"q":"stripe"}}'

Ahrefs

Ahrefs Domain Rating (DR): how strong a site’s backlink profile is, on a 0-100 scale. (brand-data)

Domain Rating

Ahrefs Domain Rating (DR) for any site, 0-100 on a logarithmic scale. Display it with the ‘Domain Rating by Ahrefs’ attribution the response carries. Cost: 5 to 20 credits

Parameter	Type	Required
`domain`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"ahrefs","endpoint":"/domain-rating","input":{"domain":"stripe.com"}}'

Top sites by DR

The 100 strongest sites on the web by Ahrefs DR, with their rank. Cost: 5 to 20 credits

Parameter	Type	Required
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"ahrefs","endpoint":"/top-domains","input":{"limit":10}}'

TinyFish

Web search and page fetching built for agents: news and paper search, domain filters, and up to 10 URLs read as markdown in one call. (web-search)

Search the web

Web, news, or research-paper search with domain include/exclude lists, a freshness window or date range, and country/language targeting. Pass intent (why you are searching) for better-ranked results. Cost: 2 to 5 credits

Parameter	Type	Required
`query`	string	yes
`intent`	string	no
`location`	string	no
`language`	string	no
`include_domains`	string	no
`exclude_domains`	string	no
`recency_minutes`	integer	no
`after_date`	string	no
`before_date`	string	no
`domain_type`	string	string	string	no
`pub_year_min`	integer	no
`pub_year_max`	integer	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tinyfish","endpoint":"/search","input":{"query":"postgres connection pooling","domain_type":"web","recency_minutes":10080}}'

Fetch pages as text

Read up to 10 URLs in one call as markdown, html, or a structured tree. CSS selectors scope what is extracted, and ttl accepts a cached copy instead of a live fetch. Cost: 2 to 5 credits

Parameter	Type	Required
`urls`	string[]	yes
`intent`	string	no
`format`	string	string	string	no
`links`	boolean	no
`image_links`	boolean	no
`ttl`	integer	no
`per_url_timeout_ms`	integer	no
`include_selectors`	string[]	no
`exclude_selectors`	string[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tinyfish","endpoint":"/fetch","input":{"urls":["https://example.com"],"format":"markdown"}}'

Artificial Analysis

Independent benchmarks for AI models: intelligence, coding, and agentic scores plus token pricing and measured latency for LLMs, and arena rankings for image, video, speech, and music models. (ai)

Benchmark language models

Independent scores, pricing, and measured speed for every tracked LLM: the Intelligence, Coding, and Agentic indices, input/output/cache price per 1M tokens, and median output tokens per second, time to first token, and end-to-end response time. 200 models per page. Cost: 2 to 5 credits

Parameter	Type	Required
`page`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"artificialanalysis","endpoint":"/language/models/free","input":{"page":1}}'

Rank image, video, speech, and music models

Head-to-head arena rankings for one media modality: text-to-image, image-editing, text-to-video, image-to-video, either video-with-audio arena, text-to-speech, speech-to-speech, speech-to-text, or instrumental and with-vocals music. Cost: 2 to 5 credits

Parameter	Type	Required
`modality`	string	string	string	string	string	string	string	string	string	string	string	yes
`page`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"artificialanalysis","endpoint":"/media/models/free","input":{"modality":"text-to-image"}}'

Brave Search

Search an independent web index rather than a rented one: web pages, news, images, and videos. (web-search)

Search the web

Web results from Brave’s own index, not a rented one: title, url, and snippet, with freshness windows down to the last 24 hours, country and language targeting, and search operators. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`search_lang`	string	no
`freshness`	string	no
`safesearch`	string	no
`count`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"brave","endpoint":"/web/search","input":{"q":"postgres connection pooling","count":10,"freshness":"pw"}}'

Search the news

News articles with publisher, age, and thumbnail, filtered to the last day, week, month, year, or an exact date range. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`search_lang`	string	no
`freshness`	string	no
`safesearch`	string	no
`count`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"brave","endpoint":"/news/search","input":{"q":"openai funding","freshness":"pd"}}'

Search for images

Images from across the web with source page, dimensions, and thumbnail. Up to 200 per call. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`search_lang`	string	no
`safesearch`	string	no
`count`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"brave","endpoint":"/images/search","input":{"q":"red panda","count":20}}'

Search for videos

Videos with duration, publisher, creator, and thumbnail, filterable by how recently they were posted. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`search_lang`	string	no
`freshness`	string	no
`safesearch`	string	no
`count`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"brave","endpoint":"/videos/search","input":{"q":"rust async explained","freshness":"pm"}}'

OpenRouter

Live model and provider discovery across every OpenRouter modality, free-model routing, chat, Responses and embeddings on your own key, plus usage rankings, app trends, session costs and benchmark datasets. (ai)

Which models people actually use

Token volume per model per day across all of OpenRouter, the numbers behind its public rankings, with an ‘other’ row summing everything outside the top 50 so a share of total traffic is one request. Slice it by modality, by request context length, or by what the traffic was for: category and language_type read a sampled weekly dataset and cannot be mixed with the exact modality and context_bucket filters. Cost: 2 to 5 credits

Parameter	Type	Required
`start_date`	string	no
`end_date`	string	no
`period`	string	string	string	no
`modality`	string	string	string	string	string	no
`context_bucket`	string	string	string	string	string	no
`category`	string	string	string	string	string	string	string	string	string	string	string	string	no
`language_type`	string	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/datasets/rankings-daily","input":{"period":"week"}}'

Top AI apps by token usage

Which apps put the most tokens through OpenRouter, with request counts. sort ‘trending’ ranks by growth against the three preceding periods instead of raw volume, so it surfaces what is climbing rather than what is already large. Cost: 2 to 5 credits

Parameter	Type	Required
`start_date`	string	no
`end_date`	string	no
`sort`	string	string	no
`category`	string	string	string	string	no
`subcategory`	string	string	string	string	string	string	string	string	string	string	string	string	string	string	string	no
`limit`	integer	no
`offset`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/datasets/app-rankings","input":{"sort":"trending","limit":20}}'

What people use AI for

The last 7 days of OpenRouter traffic split by task: code generation, web search, summarization and the rest, each with its share of requests and of tokens, the top models within it, and a roll-up into Code, Data, Agent and General. Shares of sampled traffic, so no absolute volumes. Cost: 2 to 5 credits

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/classifications/task","input":{}}'

What a coding session costs

Median USD spend per session for the published agent harnesses, broken out by model and by how many turns the session ran. Filter by model alone to compare harnesses at a fixed model. Refreshed weekly. Cost: 2 to 5 credits

Parameter	Type	Required
`app_slug`	string	no
`model`	string	no
`turn_range`	string	string	string	string	no
`limit`	integer	no
`offset`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/datasets/session-cost","input":{"app_slug":"claude-code"}}'

Benchmark scores from several sources

Model scores gathered from Artificial Analysis, Design Arena, and OpenRouter’s own tau-bench, GPQA and web-search evals, in one shape. Filter by source to get one board, or by task_type to find models suited to a workload. Filtering by source also returns the citation to use for it in meta; a mixed response names the source on each row instead. Cost: 2 to 5 credits

Parameter	Type	Required
`source`	string	string	string	no
`task_type`	string	string	string	string	no
`benchmark_type`	string	string	string	string	string	string	no
`arena`	string	string	string	no
`category`	string	no
`search_engine`	string	no
`search_surface`	string	string	no
`include_run_config`	boolean	no
`max_results`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/benchmarks","input":{"task_type":"coding"}}'

Ask another model

Run an OpenAI-shaped chat request through any compatible OpenRouter model on your own key. It defaults to the free router, or pass a paid or exact :free model id. Tools, structured output, reasoning and provider routing pass through. Set provider.data_collection to deny or provider.zdr to true when the request needs stricter routing. No streaming.

Bring your own key — connect OpenRouter first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	no
`messages`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/chat/completions","input":{"model":"openrouter/free","messages":[{"role":"user","content":"Explain Postgres MVCC in one sentence."}]}}'

Create a model response

Use OpenRouter’s OpenAI-compatible Responses API with text or multimodal input, tools and reasoning on your own key. Defaults to the free router; pass any compatible model id to choose one. Streaming and background mode are not available here.

Bring your own key — connect OpenRouter first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	no
`input`	string	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/responses","input":{"input":"What is 1312 times 3333? Return only the number."}}'

Create embeddings

Create text, token or multimodal embeddings with any compatible OpenRouter embedding model on your own key. Discover current models and exact free variants with openrouter.embedding_models.

Bring your own key — connect OpenRouter first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes
`input`	any	yes
`dimensions`	integer	no
`encoding_format`	string	string	no
`input_type`	string	no
`provider`	object	no
`user`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/embeddings","input":{"model":"liquid/lfm-2.5-embedding-350m:free","input":["A database row","A related record"]}}'

Browse OpenRouter models

Search OpenRouter’s live catalog across text, image, audio, video, embeddings, reranking, speech and transcription. Filter by modalities, capabilities, context, price, privacy, region, author, host and benchmark scores. free_only matches exact :free variants plus openrouter/free rather than guessing from incomplete price fields. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	no
`category`	string	string	string	string	string	string	string	string	string	string	string	string	no
`supported_parameters`	string	no
`output_modalities`	string	no
`input_modalities`	string	no
`context`	integer	no
`sort`	string	string	string	string	string	string	string	string	string	string	string	string	no
`min_price`	number	no
`max_price`	number	no
`arch`	string	no
`model_authors`	string	no
`providers`	string	no
`distillable`	boolean	no
`zdr`	boolean	no
`region`	string	string	no
`min_output_price`	number	no
`max_output_price`	number	no
`min_age_days`	integer	no
`max_age_days`	integer	no
`min_intelligence_index`	number	no
`max_intelligence_index`	number	no
`min_coding_index`	number	no
`max_coding_index`	number	no
`min_agentic_index`	number	no
`max_agentic_index`	number	no
`min_tool_success_rate`	number	no
`max_tool_success_rate`	number	no
`free_only`	boolean	no
`offset`	integer	no
`limit`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/models","input":{"output_modalities":"all","free_only":true,"sort":"context-high-to-low"}}'

OpenRouter model details

Read one current model’s architecture, modalities, context length, pricing, supported parameters and lifecycle metadata by its author/model id. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/model/{author}/{slug}","input":{"model":"openrouter/free"}}'

OpenRouter model providers

List every live provider route for one model with its context window, prices, supported parameters, quantization, uptime and latency. Use it before pinning provider order or privacy constraints. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/models/{author}/{slug}/endpoints","input":{"model":"cohere/north-mini-code:free"}}'

Browse embedding models

List every current OpenRouter embedding model with input modalities, context and prices. free_only returns exact :free variants suitable for openrouter.embeddings. Cost: 5 credits per call

Parameter	Type	Required
`free_only`	boolean	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/embeddings/models","input":{"free_only":true}}'

OpenRouter balance

Credits bought and credits spent on your own OpenRouter account.

Bring your own key — connect OpenRouter first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/credits","input":{}}'

OpenRouter key limits

What the connected key is allowed to spend and what it has spent, daily, weekly and monthly, including usage billed to your own upstream provider keys.

Bring your own key — connect OpenRouter first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"openrouter","endpoint":"/key","input":{}}'

Groq

Fast model inference, reasoning and tool use, plus embeddings, Whisper transcription and Orpheus speech on your own Groq key, with model discovery available without a connection. (ai)

Chat completion

Prompt a Groq-hosted model with the OpenAI chat shape, including tools, reasoning and structured output. Defaults to openai/gpt-oss-20b. Every chat field passes through except streaming; the response comes back whole on your own key.

Bring your own key — connect Groq first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	no
`messages`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/chat/completions","input":{"messages":[{"role":"user","content":"Explain Postgres MVCC in one sentence."}]}}'

Create a model response

Groq’s beta OpenAI Responses API for text or image input, reasoning, function calls, browser search, code execution and remote MCP tools. Stateful previous_response_id is not supported. The call uses your own key and returns whole, not streamed.

Bring your own key — connect Groq first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	no
`input`	string	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/responses","input":{"input":"What is 1312 times 3333? Return only the number."}}'

Create text embeddings

Create one or more text embedding vectors with Groq. Defaults to nomic-embed-text-v1_5, accepts up to 2,048 input strings, and can return float arrays or base64-encoded vectors on your own key.

Bring your own key — connect Groq first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`input`	string	string[]	yes
`model`	string	no
`encoding_format`	string	string	no
`user`	string	null	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/embeddings","input":{"input":["A database row","A semantically related record"]}}'

Transcribe audio

Transcribe a public audio or video URL with Whisper on Groq. Defaults to whisper-large-v3-turbo; use verbose_json with word or segment timestamp_granularities for timings. Groq fetches the URL directly.

Bring your own key — connect Groq first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`audio_url`	string	yes
`model`	string	no
`language`	string	no
`prompt`	string	no
`response_format`	string	string	string	no
`temperature`	number	no
`timestamp_granularities`	string	string[]	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/audio/transcriptions","input":{"audio_url":"https://example.com/call.mp3","language":"en"}}'

Translate audio into English

Transcribe non-English audio or video from a public URL and translate it into English with Whisper on Groq. Defaults to whisper-large-v3-turbo. Groq fetches the URL directly.

Bring your own key — connect Groq first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`audio_url`	string	yes
`model`	string	no
`prompt`	string	no
`response_format`	string	string	string	no
`temperature`	number	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/audio/translations","input":{"audio_url":"https://example.com/interview-es.wav"}}'

Speak text

Generate up to 200 characters of expressive English or Saudi Arabic speech with Orpheus. Defaults to the English model with troy voice; the Arabic model defaults to abdullah. Returns WAV as base64 plus an audio_url serving the same bytes from fetchbean.

Bring your own key — connect Groq first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`input`	string	yes
`model`	string	no
`voice`	string	no
`response_format`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/audio/speech","input":{"input":"[cheerful] Your deployment finished cleanly.","voice":"hannah"}}'

Available models

List Groq models with owner, context window and maximum completion size. A connected key shows that project’s permissions; otherwise fetchbean uses a managed key. Use this instead of hard-coding a preview model that may disappear. Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/models","input":{}}'

Model details

Read one Groq model’s availability, owner, context window and maximum completion size by model ID. Uses the connected key when present, otherwise a managed fetchbean key. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"groq","endpoint":"/models/{model}","input":{"model":"openai/gpt-oss-20b"}}'

Vercel AI Gateway

What the AI market runs in production, measured on real gateway traffic: daily usage share by model, lab, app and inference provider, the full model catalog with pricing and retention flags, and hourly latency, throughput and uptime for every provider serving a model. (ai)

Which AI models people actually run

Daily share of real Vercel AI Gateway traffic, by model, by lab, by app, or by inference provider, counted in requests, token volume, spend, and images or videos generated. models and labs give one row per entity per day back to 2025-10-01 and can be narrowed to a modality; apps and providers give a ranked top list with no day dimension. Shares only, never absolute volumes. Published by Vercel under CC BY 4.0. Cost: 5 credits per call

Parameter	Type	Required
`dataset`	string	string	string	string	no
`modality`	string	string	string	string	no
`from`	string	no
`to`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"vercel","endpoint":"/api/ai/leaderboard-export","input":{"dataset":"providers"}}'

Every model on AI Gateway, with pricing

The whole catalog across every creator: per-token pricing for input, output and cache reads and writes, tiered by context length where that applies, plus context window, max output tokens, capability tags, knowledge cutoff, supported parameters, and the zero-data-retention and no-training flags. Covers image, video, embedding, speech, transcription, realtime and reranking models, not only chat. Filter by type or creator; the whole list is large. Cost: 5 credits per call

Parameter	Type	Required
`type`	string	string	string	string	string	string	string	string	no
`owned_by`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"vercel","endpoint":"/v1/models","input":{"type":"image"}}'

One model’s specs and price

Pricing, context window, max output, capability tags, supported parameters, knowledge cutoff and retention flags for a single model, without pulling the whole catalog. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"vercel","endpoint":"/v1/models/{creator}/{model}","input":{"model":"anthropic/claude-opus-5"}}'

Which provider is fastest for a model right now

Every inference provider serving one model, each with P50 and P95 time-to-first-token and tokens per second measured on the last hour of real gateway traffic, uptime over 15 minutes, an hour and a day, and its own pricing, context length, quantization and supported parameters. The same model can run an order of magnitude apart between providers at near-identical list prices, so this is the tool that picks one. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"vercel","endpoint":"/v1/models/{creator}/{model}/endpoints","input":{"model":"openai/gpt-oss-120b"}}'

Every provider route, with prices

One row per provider-and-model pair across the whole gateway: pricing, context length, max output tokens, capability tags and the retention flags. Answers what every provider charges for a model in a single call. Live latency and throughput are not on these rows; the per-model tool carries those. Cost: 5 credits per call

Parameter	Type	Required
`provider`	string	no
`model`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"vercel","endpoint":"/v1/models/endpoints","input":{"provider":"groq"}}'

SubmitForBacklinks

List your product in a directory for a backlink: scan a site into a draft, submit it, and manage the badge. (marketing)

Scan a product site

Turn a product URL into a structured listing draft: name, tagline, descriptions, category, tags, pricing and platform type. No account needed. Cost: 10 credits per call

Parameter	Type	Required
`websiteUrl`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/scan","input":{"websiteUrl":"https://fetchbean.com"}}'

Free launch weeks

The free-tier launch calendar with remaining capacity per week (20 slots each). Featured listings skip this queue. Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/launch-weeks","input":{}}'

My submissions

List your own submissions with their status.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions","input":{"limit":20}}'

Get a submission

One of your submissions in full.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/get","input":{"id":"…"}}'

Create a draft or submit

Create a listing draft, or submit one for review in one call. Submitting requires all four attestations true (terms, reciprocal badge, authority to represent the product, content reviewed). FREE takes a launch-week slot and needs a badge for dofollow; FEATURED is $11.99 one-time with no badge or queue.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`websiteUrl`	string	yes
`action`	string	string	yes
`listingType`	string	string	no
`launchWeekStart`	string	no
`founderName`	string	no
`contactEmail`	string	no
`companyName`	string	no
`overrides`	object	no
`attestations`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/create","input":{"websiteUrl":"https://fetchbean.com","action":"draft"}}'

Edit a submission

Replace the editable content on a draft or a listing that came back needing changes.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
`overrides`	object	no
`founderName`	string	no
`contactEmail`	string	no
`companyName`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/update","input":{"id":"…","overrides":{"tagline":"One key for every tool your agent needs"}}}'

Submit a draft for review

Send an existing draft to review. Same four attestations as submitting outright; review is partly automated and escalates to a human when needed.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
`launchWeekStart`	string	no
`attestations`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/submit","input":{"id":"…"}}'

Featured checkout link

Open (or resume) the Stripe checkout for a Featured listing, $11.99 one-time, refunded automatically if the listing is rejected. Returns a link to pay; it charges nothing by itself.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/featured-checkout","input":{"id":"…"}}'

Badge status

Badge and follow-link state for a free listing, without issuing one.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/badge","input":{"id":"…"}}'

Issue a badge

Mint the badge markup to install on your own site. Idempotent, and does not check installation.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/badge/issue","input":{"id":"…"}}'

Verify badge installation

Fetch a page on your domain and check the badge markup and follow-link. Rate limited upstream to 10/hour per key.

Bring your own key — connect SubmitForBacklinks first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
`targetUrl`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"submitforbacklinks","endpoint":"/submissions/badge/verify","input":{"id":"…","targetUrl":"https://fetchbean.com"}}'

ScrollLaunch

Indie product launches: which directories are worth submitting to, what launched this week, and how it ranked. (marketing)

Startup directories by DR

Indexable startup directories ranked by Ahrefs Domain Rating, each with its pricing and whether the link is dofollow. The shortlist for where to submit a product. Cost: 10 credits per call

Parameter	Type	Required
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"scrolllaunch","endpoint":"/directories","input":{"limit":25}}'

Search launched products

Search ScrollLaunch’s directory of launched indie products by keyword, category or tag. Cost: 10 credits per call

Parameter	Type	Required
`query`	string	yes
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"scrolllaunch","endpoint":"/search","input":{"query":"agent tools","limit":10}}'

Weekly launch leaderboard

The ranked product leaderboard for an ISO week, ordered by upvotes. See what launched and how it did. Cost: 10 credits per call

Parameter	Type	Required
`week`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"scrolllaunch","endpoint":"/leaderboard","input":{"limit":20}}'

Get a launched product

Full metadata for one launched product: tagline, description, categories, website and upvotes. Cost: 10 credits per call

Parameter	Type	Required
`slug`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"scrolllaunch","endpoint":"/product","input":{"slug":"trendgap-io"}}'

DEV Community

Publish to your DEV blog and read the numbers back: posts, drafts, analytics, followers and search. (social)

Publish an article

Write a post to your DEV account. Leave published false to create a draft and review it on dev.to before it goes live. Set canonical_url when the piece also lives on your own site.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`title`	string	yes
`body_markdown`	string	no
`published`	boolean	no
`tags`	string	string[]	no
`series`	string	no
`main_image`	string	no
`canonical_url`	string	no
`description`	string	no
`organization_id`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/articles/publish","input":{"title":"How we cut agent tool definitions to one","body_markdown":"...","published":false,"tags":["ai","api"]}}'

Update an article

Edit one of your posts, or flip a draft to published by passing published true.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	integer	yes
`title`	string	no
`body_markdown`	string	no
`published`	boolean	no
`tags`	string	string[]	no
`series`	string	no
`main_image`	string	no
`canonical_url`	string	no
`description`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/articles/update","input":{"id":1234,"published":true}}'

Unpublish an article

Take one of your posts back to draft. The post is not deleted.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/articles/unpublish","input":{"id":1234}}'

My articles

Your own posts, including drafts. Use state to narrow to published or unpublished.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`state`	string	string	string	no
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/articles/mine","input":{"state":"unpublished"}}'

My DEV account

The account the connected key belongs to.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/users/me","input":{}}'

My post analytics

Views, reactions and comments for your posts. report picks totals, historical, referrers and the rest.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`report`	string	string	string	string	string	string	string	string	no
`start`	string	no
`end`	string	no
`article_id`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/analytics","input":{"report":"totals"}}'

My followers

Users following your DEV account, newest first.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`sort`	string	no
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/followers","input":{"per_page":30}}'

Tags I follow

The tags your account follows, with your weight for each.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/follows/tags","input":{}}'

My reading list

Articles you saved to your DEV reading list.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/readinglist","input":{}}'

Follow users

Follow DEV users or organizations from your account.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`users`	object[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/follows","input":{"users":[{"id":1}]}}'

React to a post

Toggle a reaction on an article or comment. Sending the same reaction twice removes it.

Bring your own key — connect DEV Community first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`category`	string	no
`reactable_id`	integer	yes
`reactable_type`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/reactions/toggle","input":{"category":"like","reactable_id":1234,"reactable_type":"Article"}}'

Browse articles

Published DEV articles, filterable by tag (or exclude tags with tags_exclude), author, state or series collection_id. No account needed. Cost: 5 credits per call

Parameter	Type	Required
`tag`	string	no
`tags`	string	no
`tags_exclude`	string	no
`username`	string	no
`state`	string	no
`top`	integer	no
`collection_id`	integer	no
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/articles","input":{"tag":"ai","per_page":10}}'

Get an article

One published article in full, including its markdown body. Cost: 5 credits per call

Parameter	Type	Required
`id`	string	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/articles/get","input":{"id":1234}}'

Search articles

Free-text search across published DEV articles. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/articles/search","input":{"q":"model context protocol"}}'

Article comments

The comment thread on an article (a_id) or podcast episode (p_id), threaded as DEV returns it. page walks the top-level comments. Cost: 5 credits per call

Parameter	Type	Required
`a_id`	string	integer	no
`p_id`	string	integer	no
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/comments","input":{"a_id":1234}}'

Popular tags

DEV’s tags by popularity, for picking the four a post is allowed. Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"devto","endpoint":"/tags","input":{"per_page":20}}'

Tavily

Agent-focused web search with optional synthesized answers. (web-search)

Search

Search the web with an optional synthesized answer (set include_answer). Good for quick factual lookups. Cost: 115 credits per call

Parameter	Type	Required
`query`	string	yes
`search_depth`	string	no
`topic`	string	no
`max_results`	integer	no
`include_answer`	boolean	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tavily","endpoint":"/search","input":{"query":"agent frameworks"}}'

Perplexity

Web search with synthesized answers. (web-search)

Search

Search the web and get a written, synthesized answer (not just links). Use when you want an answer, not sources. Cost: 70 credits per call

Parameter	Type	Required
`query`	string	string[]	yes
`max_results`	integer	no
`max_tokens_per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"perplexity","endpoint":"/search","input":{"query":"latest llm benchmarks"}}'

Parallel

multi-query web search, url extraction, and deep research runs. (web-search)

Search

Run several web search queries in one call (pass search_queries). Use to batch multiple distinct queries. Cost: 100 credits per call

Parameter	Type	Required
`search_queries`	string[]	yes
`objective`	string	no
`mode`	string	no
`advanced_settings`	any	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"parallel","endpoint":"/v1/search","input":{"search_queries":["vector databases"]}}'

Extract

Turn public URLs (including JS-heavy pages and PDFs) into markdown. Cost: 20 credits per call

Parameter	Type	Required
`urls`	string[]	yes
`objective`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"parallel","endpoint":"/v1/extract","input":{"urls":["https://example.com"]}}'

Deep research (start)

Kick off a deep web research run and get a run_id back. Poll it with task_result. processor: lite (fast/cheap), base (default), or core (deepest). Cost: 200 to 900 credits

Parameter	Type	Required
`input`	string	yes
`processor`	string	string	string	string	string	string	no
`output_schema`	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"parallel","endpoint":"/v1/tasks/runs","input":{"input":"who are the top competitors to Parallel AI and how are they funded?","processor":"base"}}'

Deep research (result)

Fetch a deep-research run’s result by run_id. Long-polls ~30s; if still running it returns { status: “running” } so you can call again. Cost: 3 credits per call

Parameter	Type	Required
`run_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"parallel","endpoint":"/v1/tasks/runs/{run_id}/result","input":{"run_id":"trun_..."}}'

RemoteOK

Remote job listings across the web. (jobs)

Jobs

Fetch the latest remote job listings. Cost: 10 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"remoteok","endpoint":"/api","input":{}}'

fetchbean

First-party data and utilities, hosted by fetchbean. (data)

Create artifact

Host and share a web page: publish a rendered markdown or interactive HTML page (report, dashboard, landing page, chart, slides, mini-app) to a shareable fetchbean URL a human opens in a browser. fetchbean handles the styling (Tailwind + a base stylesheet) and hosting; you send the content. Returns the link. For a completed local PDF, DOCX, PPTX, or XLSX, use the multipart file-artifact flow in the guide. Cost: 10 credits per call

Parameter	Type	Required
`title`	string	yes
`type`	string	string	string	string	string	yes
`content`	string	yes
`visibility`	string	string	no
`ttl`	string	string	string	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts","input":{"title":"Q3 revenue","type":"html","content":"<div class=\"max-w-md mx-auto p-10 text-center\"><h1 class=\"text-2xl font-bold text-emerald-700\">Q3 revenue</h1><p class=\"mt-3 text-5xl font-mono font-bold\">$1.2M</p><p class=\"mt-2 text-slate-500\">up 20% from Q2</p></div>"}}'

Update artifact

Revise an existing artifact in place (same URL). The prior version is kept for rollback. Cost: 3 credits per call

Parameter	Type	Required
`id`	string	yes
`content`	string	yes
`title`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/update","input":{"id":"art_1234","content":"<h1>Q3 revenue: $1.4M (updated)</h1>"}}'

Patch artifact

Surgically edit an artifact with find/replace edits instead of resending the whole body — same URL, a version is snapshotted first. Best for small changes to a large artifact. Cost: 3 credits per call

Parameter	Type	Required
`id`	string	yes
`edits`	object[]	yes
`replace_all`	boolean	no
`title`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/patch","input":{"id":"art_1234","edits":[{"old_string":"$1.2M","new_string":"$1.4M"}]}}'

List artifacts

List your published web and file artifacts with durable ids, links, lifecycle state, engagement, and file metadata. Returns 100 at a time by default (500 max) alongside total, so page with limit + offset when total exceeds what came back. Cost: 1 credit per call

Parameter	Type	Required
`limit`	number	no
`offset`	number	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/list","input":{}}'

Find MCP servers

Search the third-party MCP server directory: what exists, who publishes it, whether it is remote, and how maintained it is. These are servers a user installs in their own client, not tools fetchbean runs. limit is up to 100 (default 50); total says how many match, so page with offset. Cost: 1 credit per call

Parameter	Type	Required
`q`	string	no
`category`	string	no
`tag`	string	no
`limit`	number	no
`offset`	number	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/mcp-servers","input":{"q":"notion"}}'

Get artifact

Fetch a web artifact’s content or a file artifact’s metadata and authenticated exact-byte download URL. Cost: 1 credit per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/get","input":{"id":"art_1234"}}'

Delete artifact

Permanently delete an artifact and its version history. Cost: 1 credit per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/delete","input":{"id":"art_1234"}}'

Set artifact visibility

Change an artifact between unlisted (anyone with the link) and private (your org only). Cost: 1 credit per call

Parameter	Type	Required
`id`	string	yes
`visibility`	string	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/visibility","input":{"id":"art_1234","visibility":"private"}}'

Grant viewer access to specific email addresses. Restricted viewers sign in with the invited address. Cost: 1 credit per call

Parameter	Type	Required
`id`	string	yes
`emails`	string[]	yes
`notify`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/share","input":{"id":"art_1234","emails":["viewer@example.com"]}}'

List artifact access

List the people who can open a restricted artifact. Cost: 1 credit per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/shares","input":{"id":"art_1234"}}'

Remove artifact access

Remove one email address from an artifact’s viewer list. Cost: 1 credit per call

Parameter	Type	Required
`id`	string	yes
`email`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/unshare","input":{"id":"art_1234","email":"viewer@example.com"}}'

Restore artifact version

Restore a prior version of an artifact (defaults to the most recent), keeping the same URL. Non-destructive: the current body is snapshotted first, so history is preserved and the restore is reversible. Cost: 3 credits per call

Parameter	Type	Required
`id`	string	yes
`version_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/rollback","input":{"id":"art_1234"}}'

List artifact versions

The version timeline of an artifact (newest first): version id, title, and when it was saved. Cost: 1 credit per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/artifacts/versions","input":{"id":"art_1234"}}'

Random quote

A random quote with its author. Cost: 1 credit per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/quotes/random","input":{}}'

Random joke

A random safe joke, optionally filtered by category, type, or search text. Cost: 1 credit per call

Parameter	Type	Required
`category`	string	no
`type`	string	string	no
`contains`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/jokes/random","input":{"category":"Programming"}}'

Random fact

A random fact with its source. Cost: 1 credit per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/facts/random","input":{}}'

Quotes

Paginated list of quotes. Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`skip`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/quotes","input":{"limit":10}}'

UUID

Generate one or more UUIDs. Cost: 1 credit per call

Parameter	Type	Required
`count`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/uuid","input":{}}'

Email deliverability

Validate an email: syntax, DNS deliverability (MX), and disposable/free-provider/typo signals. Cost: 5 credits per call

Parameter	Type	Required
`email`	string	yes
`dns`	boolean	no
`typo`	boolean	no
`disposable`	boolean	no
`freeProvider`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/email/deliverability","input":{"email":"user@example.com"}}'

Domain lookup

Is a domain available? Plus registrar, created/expiry dates, and nameservers (via RDAP). Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/domain","input":{"domain":"example.com"}}'

Sitemap

Find a site’s sitemaps (robots.txt + common paths) and extract its URLs. A capped read returns truncated: true and next_offset to pass as offset for the rest. Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
`extract_links`	boolean	no
`max_urls`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/sitemap","input":{"url":"example.com"}}'

YouTube transcript

Fetch a YouTube video’s transcript: timed segments plus the joined plain text, with the title and channel. No key and nothing to connect. Pass lang for a specific caption track; if that track is missing, the error names the ones the video does have. Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
`lang`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/youtube/transcript","input":{"url":"https://youtu.be/dQw4w9WgXcQ"}}'

DNS lookup

Resolve a domain’s DNS records (A/AAAA/MX/TXT/NS/CNAME/SOA/CAA/SRV). Pass types to limit. Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
`types`	string[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/dns","input":{"domain":"example.com"}}'

Place to coordinates

Turn a place name into coordinates, with country, region, timezone and population. Answers from an index bundled with fetchbean rather than an upstream service, so an exact name match ranks first: asking for Leh gives Leh in Ladakh, not the much larger Le Havre. Historic and local names work too, so Bombay finds Mumbai. Each result says whether it matched the name, an alias, or a prefix. Covers settlements over 15,000 people. Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/geocode","input":{"name":"Springfield","limit":5}}'

Coordinates to place

What is at a set of coordinates: the nearest known settlements with their distance in km, closest first. Answers from the bundled index, so it works without an upstream call. Cost: 5 credits per call

Parameter	Type	Required
`latitude`	number	yes
`longitude`	number	yes
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/geocode/reverse","input":{"latitude":34.16,"longitude":77.58}}'

Read a URL

Fetch any URL and get back what it actually is, parsed: an article’s text without the navigation, a PDF’s text with its page count, a JSON body, an RSS or Atom feed as items, or a description of a binary file. If the page did not really load — a bot wall, a captcha, a client-rendered shell — it says so instead of handing back the markup as though it were the content, and a scanned PDF says it has no text layer rather than coming back empty. Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
`max_chars`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/read","input":{"url":"https://en.wikipedia.org/wiki/Apollo_11"}}'

URL metadata

All metadata for a page: title, full meta tags, OpenGraph + Twitter cards, JSON-LD, icons, canonical. Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/url/meta","input":{"url":"https://vercel.com"}}'

HTTP inspect

A URL’s status, response headers, redirect chain, content-type, and security headers (no body). Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
`method`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/http/inspect","input":{"url":"https://github.com"}}'

Verify image (AI detection)

Is an image AI-generated? Returns a clear is_ai_generated boolean + confidence, with every signal under meta: C2PA Content Credentials, EXIF/XMP tags, and a light forensic pass. Runs locally, no key. A positive is strong evidence; a negative is not proof a photo is real. Cost: 10 credits per call

Parameter	Type	Required
`url`	string	no
`image_base64`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/verify/image","input":{"url":"https://example.com/photo.jpg"}}'

LLM pricing

Full LiteLLM row per model: token prices, tiered/batch rates, context windows, capability flags. Filter by model/provider/mode. Cost: 1 credit per call

Parameter	Type	Required
`model`	string	no
`provider`	string	no
`mode`	string	no
`contains`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/llm/pricing","input":{"contains":"gpt-4o"}}'

Find a model

Search every model across every host: filter by maker, by capability, by price ceiling or by intelligence floor. Answers ‘cheapest model above quality X’ and ‘what supports computer use under $2 per 1M’, which no single provider’s own API can. Cost: 1 credit per call

Parameter	Type	Required
`q`	string	no
`creator`	string	no
`capability`	string	no
`max_price_in`	number	no
`min_intelligence`	number	no
`sort`	string	string	string	no
`limit`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/models/search","input":{"min_intelligence":50,"sort":"price","limit":5}}'

One model, every host

Everywhere a model is served, cheapest first, with each host’s own price, context window and capabilities. Hosts disagree: the same model may support tool calling on one and not another. Cost: 1 credit per call

Parameter	Type	Required
`slug`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/models/lookup","input":{"slug":"claudeopus45"}}'

Inference hosts, ranked

Every host that serves models, how many each carries, and its median input price per 1M tokens. Cost: 1 credit per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fetchbean","endpoint":"/models/hosts","input":{}}'

AppRevs

iOS App Store search, metadata, reviews, ratings, and AI review insights. (app-reviews)

iOS app search

Search iOS App Store apps by keyword and storefront country. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"apprevs","endpoint":"/apps/search","input":{"q":"notion","country":"us","limit":5}}'

iOS app lookup

Fetch full App Store metadata for an iOS app by track ID. Cost: 10 credits per call

Parameter	Type	Required
`track_id`	integer	yes
`country`	string	no
`force`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"apprevs","endpoint":"/apps/lookup/{track_id}","input":{"track_id":1232780281,"country":"us"}}'

iOS app reviews

Fetch App Store reviews with rating distribution for an iOS app. Cost: 10 credits per call

Parameter	Type	Required
`track_id`	integer	yes
`country`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"apprevs","endpoint":"/apps/{track_id}/reviews","input":{"track_id":1232780281,"country":"us","limit":100}}'

iOS rating history

Fetch stored App Store rating snapshots for an iOS app. Cost: 10 credits per call

Parameter	Type	Required
`track_id`	integer	yes
`country`	string	no
`days`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"apprevs","endpoint":"/apps/{track_id}/rating-history","input":{"track_id":1232780281,"country":"us","days":30}}'

iOS cached insights

Read cached AI review insights for an iOS app, if one exists. Cost: 10 credits per call

Parameter	Type	Required
`track_id`	integer	yes
`country`	string	no
`model`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"apprevs","endpoint":"/apps/{track_id}/insights","input":{"track_id":1232780281,"country":"us"}}'

iOS review research

Generate fresh AI insights from App Store reviews you pass in (supply reviews; pull them with the reviews tool first). Cost: 50 credits per call

Parameter	Type	Required
`app_name`	string	yes
`track_id`	integer	yes
`country`	string	no
`reviews`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"apprevs","endpoint":"/apps/research","input":{"app_name":"Example App","track_id":123456789,"country":"us","reviews":[{"rating":2,"title":"Buggy","content":"Crashes on launch"}]}}'

Fireflies

Your meeting transcripts, summaries, and action items (bring your own Fireflies key). (productivity)

Fireflies: search transcripts

Find meetings by keyword, date, or participant; returns matching transcript ids and metadata (not full text). Use first, then the transcript tool.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	no
`from_date`	string	no
`to_date`	string	no
`participants`	string[]	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcripts","input":{"query":"pricing","limit":5}}'

Fireflies: get transcript

Fetch a meeting transcript with its summary, keywords, and action items.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	yes
`include_sentences`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcript","input":{"transcript_id":"01H..."}}'

Fireflies: action items

Get just the action items and outline from a meeting.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcript/action-items","input":{"transcript_id":"01H..."}}'

Fireflies: current user

Confirm whose Fireflies account the connected key acts as.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/user","input":{}}'

Fireflies: recent meetings

Your meetings from the last N days (default 7), newest first.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`days`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcripts/recent","input":{"days":7,"limit":10}}'

Fireflies: AI app outputs

Outputs from Fireflies AI Apps run on your meetings (custom summaries, extractions). Fireflies returns at most 10 per call; page with offset.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	no
`app_id`	string	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/apps","input":{"limit":10}}'

Fireflies: active meetings

Meetings currently in progress, with status and details.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`input`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/active-meetings","input":{}}'

Fireflies: analytics

Team and per-user conversation/meeting metrics over a time range.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`start_time`	string	no
`end_time`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/analytics","input":{"start_time":"2026-05-01T00:00:00.000Z"}}'

Fireflies: channels

List your channels/folders with membership.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/channels","input":{}}'

Fireflies: channel

Details and membership for one channel.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/channel","input":{"channel_id":"..."}}'

Fireflies: contacts

Your contacts, sorted by recent meeting activity.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/contacts","input":{}}'

Fireflies: soundbites

Shareable audio/transcript clips from your meetings.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	no
`mine`	boolean	no
`my_team`	boolean	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/bites","input":{"limit":10}}'

Fireflies: user groups

Team structure and group membership.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`mine`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/user-groups","input":{}}'

Fireflies: rule executions

Automation rule execution logs grouped by meeting (Enterprise).

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`cursor`	string	no
`logs_per_meeting`	integer	no
`filters`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/rule-executions","input":{"limit":10}}'

Fireflies: update meeting title

Rename a meeting (admin).

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	yes
`title`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcript/title","input":{"transcript_id":"...","title":"Q3 planning sync"}}'

Share a meeting transcript with email addresses.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	yes
`emails`	string[]	yes
`expiry_days`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcript/share","input":{"transcript_id":"...","emails":["a@b.com"]}}'

Fireflies: revoke meeting access

Remove a previously granted meeting share.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	yes
`email`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcript/revoke-access","input":{"transcript_id":"...","email":"a@b.com"}}'

Fireflies: move meeting

Move one or more meetings to a channel/folder.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel_id`	string	yes
`transcript_id`	string	no
`transcript_ids`	string[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcript/move","input":{"transcript_id":"...","channel_id":"..."}}'

Fireflies: create soundbite

Clip a soundbite from a meeting transcript.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	yes
`start_time`	number	yes
`end_time`	number	yes
`name`	string	no
`media_type`	string	no
`summary`	string	no
`privacies`	string[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/bites/create","input":{"transcript_id":"...","start_time":12.5,"end_time":30}}'

Fireflies: delete a transcript

Permanently delete a meeting: its transcript, summary, recording and soundbites. No undo, and anyone the meeting was shared with loses it too.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`transcript_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/transcripts/delete","input":{"transcript_id":"<transcript-id>"}}'

Fireflies: raw GraphQL

Escape hatch: run any Fireflies GraphQL query or mutation on your own key. Prefer the curated fireflies tools when one fits.

Bring your own key — connect Fireflies first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`variables`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"fireflies","endpoint":"/graphql","input":{"query":"query { user { email num_transcripts } }"}}'

PostHog

Query your PostHog events and analytics (HogQL), feature flags, insights, and errors (bring your own key). (analytics)

PostHog: query (HogQL)

Run a HogQL/SQL query over your PostHog events, persons, and analytics. The main PostHog read tool.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/query","input":{"query":"SELECT event, count() FROM events GROUP BY event ORDER BY count() DESC LIMIT 10"}}'

PostHog: raw request

Escape hatch: call any PostHog REST endpoint (read or write) on your own key. \{project_id\} in the path is filled from your connection. Prefer the curated posthog tools when one fits. Not idempotent for writes.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/request","input":{"method":"GET","path":"/api/projects/{project_id}/feature_flags/"}}'

PostHog: account + projects

Your PostHog account, organization, and accessible projects (ids for the other tools).

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/projects","input":{}}'

PostHog: feature flags

List your feature flags (prefer this curated tool over the raw request escape hatch). Page with limit + offset (the response’s next URL carries the next offset); PostHog’s own filters such as search and active pass through.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/feature-flags","input":{"limit":50}}'

PostHog: get feature flag

Get one feature flag by id.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`flag_id`	string	integer	yes
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/feature-flag","input":{"flag_id":123}}'

PostHog: create feature flag

Create a feature flag (pass any PostHog flag fields, e.g. filters/rollout).

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`key`	string	yes
`name`	string	no
`active`	boolean	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/feature-flags/create","input":{"key":"new-checkout","name":"New checkout","active":true}}'

PostHog: update feature flag

Update a feature flag (e.g. toggle active, change rollout). Pass any PostHog flag fields.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`flag_id`	string	integer	yes
`active`	boolean	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/feature-flags/update","input":{"flag_id":123,"active":false}}'

PostHog: delete feature flag

Delete a flag. Any SDK still evaluating its key falls back to the default, so turn it off with update_feature_flag and let the code settle before deleting.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`flag_id`	string	integer	yes
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/feature-flags/delete","input":{"flag_id":123}}'

PostHog: delete persons

The GDPR erasure path: delete up to 1000 people by PostHog uuid or by your own distinct id. Their events and session recordings stay unless you pass delete_events or delete_recordings. PostHog has no single-person delete.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`ids`	string[]	no
`distinct_ids`	string[]	no
`delete_events`	boolean	no
`delete_recordings`	boolean	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/persons/delete","input":{"distinct_ids":["user_42"],"delete_events":true}}'

PostHog: insights

List your saved insights. Page with limit + offset; PostHog’s own filters such as search and saved pass through.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/insights","input":{"limit":50}}'

PostHog: dashboards

List your dashboards. Page with limit + offset; other PostHog query params pass through.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/dashboards","input":{"limit":50}}'

PostHog: error issues

List grouped error-tracking issues. Page with limit + offset.

Bring your own key — connect PostHog first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`project_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"posthog","endpoint":"/error-issues","input":{"limit":25}}'

Linear

Read and write your Linear issues, projects, and comments: search, create, update (bring your own key). (productivity)

Linear: me

The Linear account your key authenticates as.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/viewer","input":{}}'

Linear: issues

List issues, filtered by team, state, assignee, or priority. When page.hasNextPage is true, pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`first`	integer	no
`after`	string	no
`team_key`	string	no
`assigned_to_me`	boolean	no
`state_type`	string	no
`priority`	integer	no
`filter`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/issues","input":{"assigned_to_me":true,"state_type":"started"}}'

Linear: issue

Get one issue by UUID or human identifier (e.g. ENG-123).

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	no
`identifier`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/issue","input":{"id":"ENG-123"}}'

Linear: search

Free-text search across your Linear issues. Pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/search","input":{"query":"login bug"}}'

Linear: teams

List your teams (id, key, name). Pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/teams","input":{}}'

Linear: projects

List projects with status and progress. Pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/projects","input":{}}'

Linear: comments

Read the comment thread on an issue, by UUID or identifier (e.g. ENG-123). Pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	no
`identifier`	string	no
`issueId`	string	no
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/comments","input":{"id":"ENG-123"}}'

Linear: workflow states

A team’s workflow states (id, name, type) — the stateId to move an issue. Filter by team_key (e.g. ENG). Pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`team_key`	string	no
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/workflow-states","input":{"team_key":"ENG"}}'

Linear: users

Workspace members (id, name, email) — the assigneeId for creating or reassigning issues. Pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/users","input":{}}'

Linear: labels

Issue labels across the workspace (id, name, team) — the labelIds for create/update. Pass page.endCursor as after for the next page.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/labels","input":{}}'

Linear: create issue

Create an issue (needs a teamId; list teams first).

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`teamId`	string	no
`title`	string	no
`description`	string	no
`assigneeId`	string	no
`stateId`	string	no
`priority`	integer	no
`projectId`	string	no
`input`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/issues/create","input":{"teamId":"<team-uuid>","title":"Fix the login redirect","priority":2}}'

Linear: update issue

Update an issue by its UUID (get it from the issue tool); stateId/assigneeId are UUIDs too.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
`title`	string	no
`description`	string	no
`stateId`	string	no
`assigneeId`	string	no
`priority`	integer	no
`input`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/issues/update","input":{"id":"<issue-uuid>","stateId":"<state-uuid>"}}'

Linear: comment

Add a comment to an issue (issueId is the UUID).

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`issueId`	string	yes
`body`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/comments/create","input":{"issueId":"<issue-uuid>","body":"On it."}}'

Linear: archive an issue

Take an issue out of the active board without destroying it — the normal way to close out stale work. Reversible with unarchive_issue. id is the UUID, not ENG-123.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
`trash`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/issues/archive","input":{"id":"<issue-uuid>"}}'

Linear: unarchive an issue

Put an archived issue back on the board.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/issues/unarchive","input":{"id":"<issue-uuid>"}}'

Linear: delete an issue

Move an issue to trash, where Linear keeps it recoverable. Pass permanently true to destroy it outright, with its comments and history. archive_issue is the everyday option.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
`permanently`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/issues/delete","input":{"id":"<issue-uuid>"}}'

Linear: edit a comment

Rewrite a comment’s body (id from linear.comments). Linear stamps it as edited.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
`body`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/comments/update","input":{"id":"<comment-uuid>","body":"Corrected: the regression landed in 1.4.2."}}'

Linear: delete a comment

Remove a comment from its issue.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/comments/delete","input":{"id":"<comment-uuid>"}}'

Linear: delete a project

Delete a project. Its issues survive, unassigned from any project. Linear’s API has no project archive, so this is the only way to retire one.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/projects/delete","input":{"id":"<project-uuid>"}}'

Linear: raw GraphQL

Escape hatch: run any Linear GraphQL query or mutation on your own key. Prefer the curated linear tools when one fits.

Bring your own key — connect Linear first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`variables`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"linear","endpoint":"/graphql","input":{"query":"query { viewer { id name } }"}}'

RevenueCat

Read your RevenueCat customers, subscriptions, products, entitlements, and offerings (bring your own v2 key). (payments)

RevenueCat: projects

List the projects your key can see. Paginate with limit + starting_after (the cursor in next_page).

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/projects","input":{}}'

RevenueCat: customer

Get ONE customer by their app_user_id (the customer_id param), incl. active entitlements.

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
`expand`	string	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/customer","input":{"customer_id":"user_123"}}'

RevenueCat: customers

List/page customers; the optional search is exact-email only (no name or partial match).

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
`search`	string	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/customers","input":{"search":"jane@example.com"}}'

RevenueCat: customer subscriptions

A customer’s subscriptions (status, store, access, renewal).

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
`limit`	integer	no
`starting_after`	string	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/customer-subscriptions","input":{"customer_id":"user_123"}}'

RevenueCat: products

List products (store id, type, price).

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/products","input":{}}'

RevenueCat: entitlements

List entitlements and their products.

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/entitlements","input":{}}'

RevenueCat: offerings

List offerings and their packages.

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/offerings","input":{}}'

RevenueCat: grant entitlement

Grant a promotional entitlement to a customer (write).

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
`entitlement_id`	string	yes
`duration`	string	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/grant-entitlement","input":{"customer_id":"user_123","entitlement_id":"<entitlement-id>","duration":"monthly"}}'

RevenueCat: revoke entitlement

Take back a promotional entitlement — the counterpart to grant_entitlement. The customer loses access at their next check; it does not touch a real store subscription.

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
`entitlement_id`	string	yes
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/revoke-entitlement","input":{"customer_id":"user_123","entitlement_id":"<entitlement-id>"}}'

RevenueCat: delete a customer

Delete a customer and their purchase history from the project — the GDPR erasure path. Their store subscription keeps renewing at Apple or Google; this only forgets it.

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/customers/delete","input":{"customer_id":"user_123"}}'

RevenueCat: raw request

Escape hatch: call any v2 endpoint on your key (path fills {project_id}). Prefer the curated revenuecat tools when one fits.

Bring your own key — connect RevenueCat first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
`project_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"revenuecat","endpoint":"/request","input":{"method":"GET","path":"/v2/projects/{project_id}/products"}}'

Expo

Read your Expo/EAS builds, updates, submissions, and apps; cancel a build (bring your own access token). (dev)

Expo: whoami

The Expo account/robot your token authenticates as, and its accounts.

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/whoami","input":{}}'

Expo: apps

List the apps (projects) under an account; gives the app_id the build/update tools need.

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account`	string	no
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/apps","input":{}}'

Expo: app

Get one app by full name (@owner/slug) or app_id.

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`full_name`	string	no
`app_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/app","input":{"full_name":"@owner/slug"}}'

Expo: builds

Recent EAS builds for an app (status/platform/artifact url); filter by platform (ios/android) or status.

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`app_id`	string	no
`platform`	string	no
`status`	string	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/builds","input":{"status":"errored"}}'

Expo: build

One build by id, with full detail (commit, error docs, queue/duration metrics).

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`build_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/build","input":{"build_id":"<build-id>"}}'

Expo: updates

Recent EAS Updates on a branch (grouped per publish).

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`branch`	string	yes
`app_id`	string	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/updates","input":{"branch":"main"}}'

Expo: submissions

Recent App Store / Play Store submissions for an app; filter by platform (ios/android) or status.

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`app_id`	string	no
`platform`	string	no
`status`	string	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/submissions","input":{}}'

Expo: cancel build

Cancel an in-progress EAS build (write).

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`build_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/cancel-build","input":{"build_id":"<build-id>"}}'

Expo: raw GraphQL

Escape hatch: run any Expo GraphQL query or mutation on your own token (covers the long tail + create-build/publish-update).

Bring your own key — connect Expo first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`variables`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"expo","endpoint":"/graphql","input":{"query":"query { meActor { id } }"}}'

GitHub

Contribution graphs, profiles, repos, code/files, issues, PRs, commits, and search — public data works out of the box; connect a token for higher limits, private repos, and writes. (dev)

GitHub: contributions

Any user’s contribution calendar (the green graph): total + daily counts. Omit from/to for the last year. Cost: 5 credits per call

Parameter	Type	Required
`login`	string	yes
`from`	string	no
`to`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/contributions","input":{"login":"torvalds"}}'

GitHub: user

A user’s public profile (bio, company, location, follower/repo counts). Cost: 5 credits per call

Parameter	Type	Required
`login`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/user","input":{"login":"torvalds"}}'

GitHub: repos

A user’s public repositories, newest-pushed first (stars, language, description). Pass pageInfo.endCursor as after for the next page. Cost: 5 credits per call

Parameter	Type	Required
`login`	string	yes
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/repos","input":{"login":"torvalds"}}'

GitHub: search

Search repositories, users, or issues (type = repository|user|issue). Pass pageInfo.endCursor as after for the next page. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`type`	string	no
`first`	integer	no
`after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/search","input":{"query":"language:rust stars:>1000","type":"repository"}}'

GitHub: whoami

The account your connected GitHub token authenticates as.

Bring your own key — connect GitHub first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/whoami","input":{}}'

GitHub: raw GraphQL

Escape hatch: run any GitHub GraphQL query or mutation on your own token (BYOK only).

Bring your own key — connect GitHub first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`variables`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/graphql","input":{"query":"query { viewer { login } }"}}'

GitHub: repo

Get one repository (stars, language, topics, default branch, license). Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/repo","input":{"repo":"facebook/react"}}'

GitHub: contents

Read a file (decoded text) or list a directory. Omit path for the repo root; ref = branch/sha. Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`path`	string	no
`ref`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/contents","input":{"repo":"facebook/react","path":"README.md"}}'

GitHub: issues

List issues for a repo. Includes PRs. Filters: state=open|closed|all, labels, assignee, creator, mentioned, milestone, since; sort, direction, per_page, page. Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`state`	string	no
`labels`	string	no
`assignee`	string	no
`creator`	string	no
`since`	string	no
`sort`	string	no
`direction`	string	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/issues","input":{"repo":"facebook/react","state":"open"}}'

GitHub: issue

Get one issue by number (title, body, labels, state). Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`number`	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/issue","input":{"repo":"facebook/react","number":1}}'

GitHub: pull requests

List pull requests for a repo (state=open|closed|all, head=user:branch, base=branch; sort, direction, per_page, page). Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`state`	string	no
`head`	string	no
`base`	string	no
`sort`	string	no
`direction`	string	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/pulls","input":{"repo":"facebook/react","state":"open"}}'

GitHub: pull request

Get one PR by number (status, head/base, mergeable, diff stats). Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`number`	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/pull","input":{"repo":"facebook/react","number":1}}'

GitHub: commits

Recent commits for a repo (filter by sha/branch, path, author, committer, since/until ISO 8601; per_page, page). Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`sha`	string	no
`path`	string	no
`author`	string	no
`committer`	string	no
`since`	string	no
`until`	string	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/commits","input":{"repo":"facebook/react"}}'

GitHub: releases

List releases for a repo (per_page, page), or the latest with latest=true. Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`latest`	boolean	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/releases","input":{"repo":"facebook/react","latest":true}}'

GitHub: code search

Search code across GitHub (scope with qualifiers like repo:/language:/path:). Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/code-search","input":{"query":"useEffect repo:facebook/react"}}'

GitHub: create issue

Open an issue (BYOK). Required: repo + title; optional body, labels, assignees.

Bring your own key — connect GitHub first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`title`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/create-issue","input":{"repo":"me/myrepo","title":"Bug: ...","body":"..."}}'

GitHub: comment

Comment on an issue or PR (BYOK). Required: repo + number + body.

Bring your own key — connect GitHub first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`number`	integer	yes
`body`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/comment","input":{"repo":"me/myrepo","number":12,"body":"thanks!"}}'

GitHub: create pull request

Open a PR (BYOK). Required: repo + title + head (branch) + base (branch).

Bring your own key — connect GitHub first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`title`	string	yes
`head`	string	yes
`base`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/create-pr","input":{"repo":"me/myrepo","title":"Add feature","head":"feature-branch","base":"main"}}'

GitHub: raw REST

Escape hatch: call any GitHub REST endpoint on your own token (notifications, traffic, etc.). BYOK only.

Bring your own key — connect GitHub first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"github","endpoint":"/rest","input":{"method":"GET","path":"/notifications"}}'

Better Stack

Uptime monitors, incidents, on-call, and status pages — read status, acknowledge/resolve incidents (bring your own Uptime API token). (dev)

Better Stack: monitors

List your uptime monitors with status, last check, and SSL/domain expiry.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/monitors","input":{"per_page":50}}'

Better Stack: monitor

Get one monitor by id.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/monitor","input":{"id":"123456"}}'

Better Stack: monitor groups

List monitor groups.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/monitor-groups","input":{}}'

Better Stack: heartbeats

List heartbeat (cron/job) monitors with their status.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/heartbeats","input":{}}'

Better Stack: incidents

List incidents. Filter with resolved=false / acknowledged=false, from/to (YYYY-MM-DD), or monitor_id.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/incidents","input":{"resolved":false}}'

Better Stack: incident

Get one incident by id (cause, status, acknowledged/resolved by).

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/incident","input":{"id":"987654"}}'

Better Stack: incident timeline

The full timeline of events for one incident.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/incident-timeline","input":{"id":"987654"}}'

Better Stack: on-call

On-call calendars and who is currently on call (in relationships.on_call_users).

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/on-calls","input":{}}'

Better Stack: escalation policies

List escalation policies and their steps.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/escalation-policies","input":{}}'

Better Stack: status pages

List your status pages.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/status-pages","input":{}}'

Better Stack: status page

Get one status page by id.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/status-page","input":{"id":"12345"}}'

Better Stack: status page resources

The resources (monitors etc.) shown on a status page.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`status_page_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/status-page-resources","input":{"status_page_id":"12345"}}'

Better Stack: status page reports

Reports / maintenance posted on a status page.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`status_page_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/status-page-reports","input":{"status_page_id":"12345"}}'

Better Stack: metadata

List metadata key/values (filter by owner_type/owner_id).

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/metadata","input":{}}'

Better Stack: team members

List members of the token’s team (name, email, role).

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/team-members","input":{}}'

Better Stack: acknowledge incident

Acknowledge an incident by id.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/incidents/acknowledge","input":{"id":"987654"}}'

Better Stack: resolve incident

Resolve an incident by id.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/incidents/resolve","input":{"id":"987654"}}'

Better Stack: create monitor

Create a monitor. Required: url + monitor_type (e.g. status, keyword, ping); plus options.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
`monitor_type`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/monitors/create","input":{"url":"https://example.com","monitor_type":"status"}}'

Better Stack: update monitor

Update a monitor by id (pause via {“paused”: true}).

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/monitors/update","input":{"id":"123456","paused":true}}'

Better Stack: post status report

Post a report / maintenance to a status page (title, message, affected_resources).

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`status_page_id`	string	yes
`title`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/status-reports/create","input":{"status_page_id":"12345","title":"Investigating elevated errors"}}'

Better Stack: delete monitor

Permanently delete a monitor with its check history and incidents. To stop alerts without losing the history, update_monitor with paused true.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/monitors/delete","input":{"id":"123456"}}'

Better Stack: delete monitor group

Delete a monitor group. The monitors in it survive, ungrouped.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/monitor-groups/delete","input":{"id":"123456"}}'

Better Stack: delete status page

Permanently delete a status page with its reports and subscribers. Its public URL stops resolving.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/status-pages/delete","input":{"id":"123456"}}'

Better Stack: delete status report

Remove an incident report or maintenance window from a status page.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`status_page_id`	string	yes
`id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/status-pages/status-reports/delete","input":{"status_page_id":"123456","id":"12345"}}'

Better Stack: raw request

Escape hatch: call any Uptime API endpoint on your token (reaches the long tail incl. deletes). host=“betterstack” for team-members/roles.

Bring your own key — connect Better Stack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`host`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"betterstack","endpoint":"/request","input":{"method":"GET","path":"/api/v2/monitors","query":{"per_page":1}}}'

Tailscale

Inspect and administer devices, users, routes, DNS, policy, keys, webhooks, and settings with a scoped OAuth client. (dev)

Tailscale: devices

List devices in the connected tailnet, including addresses, ownership, status, and client version.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/devices","input":{"fields":"all"}}'

Tailscale: device

Get one tailnet device by its stable device id.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device","input":{"device_id":"device-id"}}'

Tailscale: device routes

Read the subnet and exit-node routes advertised and enabled for a device.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device-routes","input":{"device_id":"device-id"}}'

Tailscale: users

List users in the connected tailnet and their role and status.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/users","input":{}}'

Tailscale: user

Get one tailnet user by id.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user","input":{"user_id":"user-id"}}'

Tailscale: DNS nameservers

Read the tailnet’s global DNS nameservers.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-nameservers","input":{}}'

Tailscale: DNS preferences

Read tailnet DNS preferences such as MagicDNS.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-preferences","input":{}}'

Tailscale: DNS search paths

Read the tailnet’s DNS search domains.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-search-paths","input":{}}'

Tailscale: split DNS

Read split-DNS nameserver assignments by domain.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-split","input":{}}'

Tailscale: DNS configuration

Read the complete tailnet DNS configuration in one call.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-configuration","input":{}}'

Tailscale: access policy

Read the tailnet policy file, including grants, ACLs, groups, tags, and posture rules.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/policy","input":{}}'

Tailscale: set device routes

Replace the enabled subnet and exit-node routes for a device. Routes must already be advertised.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`routes`	string[]	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device-routes/set","input":{"device_id":"device-id","routes":["10.0.0.0/16"]}}'

Tailscale: authorize device

Authorize or deauthorize a device when device approval is enabled.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`authorized`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device/authorize","input":{"device_id":"device-id","authorized":true}}'

Tailscale: rename device

Change a device’s MagicDNS name; existing URLs using the old name stop working.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`name`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device/rename","input":{"device_id":"device-id","name":"dev-server"}}'

Tailscale: set device tags

Replace a device’s tags with tags permitted to the OAuth client.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`tags`	string[]	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device/tags","input":{"device_id":"device-id","tags":["tag:server"]}}'

Tailscale: set device key expiry

Enable or disable key expiry for a device.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`keyExpiryDisabled`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device/key-expiry","input":{"device_id":"device-id","keyExpiryDisabled":true}}'

Tailscale: expire device key

Immediately expire a device key, forcing the device to re-authenticate.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device/expire","input":{"device_id":"device-id"}}'

Tailscale: set device IP

Replace a device’s Tailscale IPv4 address. This breaks its existing connections.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`ipv4`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device/ip","input":{"device_id":"device-id","ipv4":"100.80.0.1"}}'

Tailscale: delete device

Permanently remove a device from the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device/delete","input":{"device_id":"device-id"}}'

Tailscale: set DNS nameservers

Replace the global DNS nameserver list. Removing all nameservers also disables MagicDNS.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dns`	string[]	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-nameservers/set","input":{"dns":["1.1.1.1","8.8.8.8"]}}'

Tailscale: set DNS preferences

Enable or disable MagicDNS for the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`magicDNS`	boolean	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-preferences/set","input":{"magicDNS":true}}'

Tailscale: set DNS search paths

Replace the tailnet’s DNS search domains.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`searchPaths`	string[]	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-search-paths/set","input":{"searchPaths":["example.internal"]}}'

Tailscale: replace split DNS

Replace all split-DNS domain-to-nameserver mappings; an empty object clears them.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-split/set","input":{"example.internal":["10.0.0.53"]}}'

Tailscale: update split DNS

Partially update split-DNS mappings; null clears one domain.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-split/update","input":{"example.internal":["10.0.0.53"]}}'

Tailscale: set DNS configuration

Replace nameservers, split DNS, search paths, and DNS preferences together.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/dns-configuration/set","input":{"nameservers":["1.1.1.1"],"preferences":{"magicDNS":true}}}'

Tailscale: preview policy rule matches

Preview which source, destination, and users a proposed policy rule matches without changing the policy.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/policy/preview","input":{"type":"ssh","previewFor":"user@example.com","rule":{}}}'

Tailscale: validate policy

Validate and test a proposed policy without applying it.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/policy/validate","input":{"acls":[],"tests":[]}}'

Tailscale: set access policy

Replace the complete tailnet access policy. Validate it first with validate_policy.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`policy`	object	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/policy/set","input":{"policy":{"grants":[]}}}'

Tailscale: update user role

Change a tailnet user’s administrative role.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user_id`	string	yes
`role`	string	string	string	string	string	string	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user/role","input":{"user_id":"user-id","role":"member"}}'

Tailscale: approve user

Approve a user waiting for tailnet approval.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user/approve","input":{"user_id":"user-id"}}'

Tailscale: suspend user

Suspend a user and their access to the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user/suspend","input":{"user_id":"user-id"}}'

Tailscale: restore user

Restore a suspended or deleted user when Tailscale permits it.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user/restore","input":{"user_id":"user-id"}}'

Tailscale: delete user

Delete a user from the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user/delete","input":{"user_id":"user-id"}}'

Tailscale: keys

List auth keys and trust credentials visible to the connected OAuth client.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/keys","input":{}}'

Tailscale: create auth key

Create a pre-authorized or reusable device auth key within the OAuth client’s permitted tags.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`capabilities`	object	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/keys/create","input":{"capabilities":{"devices":{"create":{"reusable":false,"ephemeral":true,"preauthorized":true,"tags":["tag:server"]}}}}}'

Tailscale: delete key

Revoke an auth key or trust credential visible to the connected client.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`key_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/keys/delete","input":{"key_id":"key-id"}}'

Tailscale: webhooks

List tailnet webhook endpoints and subscriptions.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/webhooks","input":{}}'

Tailscale: create webhook

Create a webhook and choose the Tailscale events it receives.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`endpointUrl`	string	yes
`subscriptions`	string[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/webhooks/create","input":{"endpointUrl":"https://example.com/tailscale","subscriptions":["nodeCreated"]}}'

Tailscale: update webhook

Replace a webhook’s event subscriptions.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/webhooks/update","input":{"endpoint_id":"endpoint-id","subscriptions":["nodeCreated"]}}'

Tailscale: delete webhook

Delete a tailnet webhook endpoint.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`endpoint_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/webhooks/delete","input":{"endpoint_id":"endpoint-id"}}'

Tailscale: test webhook

Send a test event to a webhook endpoint.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`endpoint_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/webhooks/test","input":{"endpoint_id":"endpoint-id"}}'

Tailscale: rotate webhook secret

Rotate the signing secret for a webhook endpoint.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`endpoint_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/webhooks/rotate","input":{"endpoint_id":"endpoint-id"}}'

Tailscale: settings

Read tailnet feature, logging, and account settings.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/settings","input":{}}'

Tailscale: update settings

Partially update tailnet feature, logging, or account settings permitted by the client’s scopes.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/settings/update","input":{"devicesApprovalOn":true}}'

Tailscale: batch update posture attributes

Merge custom posture attributes across multiple devices; null deletes an attribute.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`nodes`	object	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/posture-attributes/batch","input":{"nodes":{"node-id":{"custom:risk":"low"}}}}'

Tailscale: set device posture attribute

Set one custom posture attribute on a device.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`attribute_key`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/posture-attributes/set","input":{"device_id":"device-id","attribute_key":"custom:risk","value":"low"}}'

Tailscale: delete device posture attribute

Delete one custom posture attribute from a device.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
`attribute_key`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/posture-attributes/delete","input":{"device_id":"device-id","attribute_key":"custom:risk"}}'

Tailscale: create device invite

Share a device with another user or tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`device_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device-invites/create","input":{"device_id":"device-id","multiUse":false}}'

Tailscale: create user invite

Invite a user to join the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user-invites/create","input":{"email":"user@example.com","role":"member"}}'

Tailscale: delete user invite

Revoke an outstanding user invite.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`invite_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user-invites/delete","input":{"invite_id":"invite-id"}}'

Tailscale: resend user invite

Resend an outstanding user invitation email.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`invite_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/user-invites/resend","input":{"invite_id":"invite-id"}}'

Tailscale: delete device invite

Revoke an outstanding device invite.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`invite_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device-invites/delete","input":{"invite_id":"invite-id"}}'

Tailscale: resend device invite

Resend an outstanding device invitation email.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`invite_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device-invites/resend","input":{"invite_id":"invite-id"}}'

Tailscale: accept device invite

Accept a device invite into the OAuth client’s own tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/device-invites/accept","input":{"invite":"invite-token"}}'

Tailscale: set log streaming

Configure configuration-audit or network-flow log streaming.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`log_type`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/log-streaming/set","input":{"log_type":"configuration","destinationType":"s3"}}'

Tailscale: disable log streaming

Disable one tailnet log stream.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`log_type`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/log-streaming/disable","input":{"log_type":"configuration"}}'

Tailscale: create or get AWS external ID

Create or retrieve the external ID used by Tailscale log streaming to AWS.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/aws-external-id","input":{}}'

Tailscale: validate AWS log trust

Validate an AWS IAM role trust policy for log streaming.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`external_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/aws-external-id/validate","input":{"external_id":"external-id","roleArn":"arn:aws:iam::123456789012:role/tailscale"}}'

Tailscale: update key

Update a key or trust credential visible to the connected OAuth client.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`key_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/keys/set","input":{"key_id":"key-id","description":"ci runners"}}'

Tailscale: create posture integration

Create a device-posture integration for the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/posture-integrations/create","input":{"provider":"crowdstrike"}}'

Tailscale: update posture integration

Partially update a device-posture integration.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`integration_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/posture-integrations/update","input":{"integration_id":"integration-id"}}'

Tailscale: delete posture integration

Delete a device-posture integration.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`integration_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/posture-integrations/delete","input":{"integration_id":"integration-id"}}'

Tailscale: update contact

Update a tailnet account, security, or support contact.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`contact_type`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/contacts/update","input":{"contact_type":"security","email":"security@example.com"}}'

Tailscale: resend contact verification

Resend the verification email for a tailnet contact.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`contact_type`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/contacts/resend-verification","input":{"contact_type":"security"}}'

Tailscale: update Service

Create or replace a Tailscale Service definition.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`service_name`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/services/update","input":{"service_name":"svc:web","ports":["tcp:443"]}}'

Tailscale: delete Service

Delete a Tailscale Service definition.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`service_name`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/services/delete","input":{"service_name":"svc:web"}}'

Tailscale: approve Service device

Approve or revoke a device as a host for a Tailscale Service.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`service_name`	string	yes
`device_id`	string	yes
`approved`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/services/device-approval","input":{"service_name":"svc:web","device_id":"device-id","approved":true}}'

Tailscale: create OAuth app

Create an OAuth application in the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/oauth-apps/create","input":{"name":"internal app","redirectUris":["https://example.com/callback"]}}'

Tailscale: update OAuth app

Replace an OAuth application’s configuration.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`app_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/oauth-apps/update","input":{"app_id":"app-id","name":"internal app"}}'

Tailscale: delete OAuth app

Delete an OAuth application from the tailnet.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`app_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/oauth-apps/delete","input":{"app_id":"app-id"}}'

Tailscale: create organization tailnet

Create an API-only tailnet under an organization; returns its initial OAuth credentials.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/organization-tailnets/create","input":{"organization":"example.com","displayName":"staging"}}'

Tailscale: delete tailnet

Permanently delete the OAuth client’s tailnet, including all users, devices, and configuration.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/tailnet/delete","input":{}}'

Tailscale: raw API request

Call any stable Tailscale API v2 endpoint allowed by the connected client’s scopes, including the long-tail reads and writes.

Bring your own key — connect Tailscale first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	string	string	string	string	no
`query`	object	no
`body`	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tailscale","endpoint":"/request","input":{"method":"GET","path":"/api/v2/tailnet/-/settings"}}'

GitLab

Projects, files, issues, merge requests, commits, releases, pipelines, and search — public data works out of the box; connect a token (incl. self-managed hosts) for private data, higher limits, and writes. (dev)

GitLab: project

Get one project (description, stars, default branch, visibility). Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/project","input":{"project":"gitlab-org/gitlab"}}'

GitLab: projects

List/search projects (search=, membership=true for your own, visibility, order_by, sort, per_page, page). Cost: 5 credits per call

Parameter	Type	Required
`search`	string	no
`membership`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/projects","input":{"search":"kubernetes"}}'

GitLab: user

A user by username or numeric id. Cost: 5 credits per call

Parameter	Type	Required
`username`	string	no
`id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/user","input":{"username":"torvalds"}}'

GitLab: contents

Read a file from a project repo (decoded text). ref = branch/tag/sha. Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`file_path`	string	yes
`ref`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/contents","input":{"project":"gitlab-org/gitlab","file_path":"README.md"}}'

GitLab: tree

List a directory in a project repo (path=, ref=, recursive=). 20 entries per page by default; per_page, page. Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/tree","input":{"project":"gitlab-org/gitlab"}}'

GitLab: issues

List issues for a project (state=opened|closed|all, labels, search, author_username, assignee_username, created_after; order_by, sort, per_page, page). Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`state`	string	no
`labels`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/issues","input":{"project":"gitlab-org/gitlab","state":"opened"}}'

GitLab: issue

Get one issue by its per-project iid. Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`iid`	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/issue","input":{"project":"gitlab-org/gitlab","iid":1}}'

GitLab: merge requests

List merge requests for a project (state=opened|merged|closed|all, source_branch, target_branch, author_username, search; order_by, sort, per_page, page). Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`state`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/merge-requests","input":{"project":"gitlab-org/gitlab","state":"opened"}}'

GitLab: merge request

Get one merge request by its per-project iid. Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`iid`	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/merge-request","input":{"project":"gitlab-org/gitlab","iid":1}}'

GitLab: commits

List commits for a project (ref_name, since/until, path, author; per_page, page). Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`ref_name`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/commits","input":{"project":"gitlab-org/gitlab"}}'

GitLab: releases

Releases for a project (order_by, sort, per_page, page), or one by tag. Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`tag`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/releases","input":{"project":"gitlab-org/gitlab"}}'

GitLab: pipelines

CI/CD pipelines for a project (status, ref, per_page, page), or one by pipeline_id. Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`pipeline_id`	string	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/pipelines","input":{"project":"gitlab-org/gitlab"}}'

GitLab: search

Global search (BYOK — GitLab requires a token). scope = projects|issues|merge_requests|users|blobs (code search needs Advanced Search); per_page, page.

Bring your own key — connect GitLab first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`search`	string	yes
`scope`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/search","input":{"search":"kubernetes","scope":"projects"}}'

GitLab: user events

A user’s activity feed (the closest thing to a contribution feed; no calendar API exists). action, target_type, after/before, sort, per_page, page. Cost: 5 credits per call

Parameter	Type	Required
`id`	string	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/user-events","input":{"id":1}}'

GitLab: create issue

Open an issue (BYOK). Required: project + title; optional description, labels.

Bring your own key — connect GitLab first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`title`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/create-issue","input":{"project":"me/myproj","title":"Bug: ..."}}'

GitLab: comment

Comment on an issue (BYOK). Required: project + iid + body.

Bring your own key — connect GitLab first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`iid`	integer	yes
`body`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/create-note","input":{"project":"me/myproj","iid":12,"body":"thanks!"}}'

GitLab: create merge request

Open a merge request (BYOK). Required: project + source_branch + target_branch + title.

Bring your own key — connect GitLab first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project`	string	integer	yes
`source_branch`	string	yes
`target_branch`	string	yes
`title`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/create-merge-request","input":{"project":"me/myproj","source_branch":"feature","target_branch":"main","title":"Add feature"}}'

GitLab: raw REST

Escape hatch: call any /api/v4 endpoint on your own token + host (BYOK only).

Bring your own key — connect GitLab first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/rest","input":{"method":"GET","path":"/projects/278964/issues"}}'

GitLab: raw GraphQL

Escape hatch: run any GitLab GraphQL query or mutation on your own token + host (BYOK only).

Bring your own key — connect GitLab first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`variables`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","endpoint":"/graphql","input":{"query":"query { currentUser { username } }"}}'

Notion

Search, read pages as markdown, query databases, and create pages, blocks, and comments — bring your own connected Notion workspace. (productivity)

Notion: search

Full-text search across pages and databases. filter=‘page’|‘database’ narrows the object type.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	no
`filter`	string	no
`page_size`	integer	no
`start_cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/search","input":{"query":"roadmap","filter":"page"}}'

Notion: page

Get one page’s properties + metadata by id (use read_page for the body content).

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/page","input":{"page_id":"59833787-2cf9-4fdf-8782-e53db20768a5"}}'

Notion: read page

Read a whole page’s content as markdown — recursively crawls the block tree and flattens it (capped for very large pages).

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/read-page","input":{"page_id":"59833787-2cf9-4fdf-8782-e53db20768a5"}}'

Notion: database

Get a database’s schema (title, properties) by id.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`database_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/database","input":{"database_id":"8d4f3c2a-1b6e-4a9f-9c2d-7e1f0a3b5c6d"}}'

Notion: query database

Query a database’s rows with filter/sorts. Returns one page of results (paginate via start_cursor).

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`database_id`	string	yes
`filter`	object	no
`sorts`	object[]	no
`page_size`	integer	no
`start_cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/query-database","input":{"database_id":"8d4f3c2a-1b6e-4a9f-9c2d-7e1f0a3b5c6d","page_size":50}}'

Notion: users

List the workspace’s users (people + bots).

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_size`	integer	no
`start_cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/users","input":{}}'

Notion: create page

Create a page under a parent page or database. Required: parent + properties; children = block content.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`parent`	object	yes
`properties`	object	yes
`children`	object[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/create-page","input":{"parent":{"page_id":"59833787-2cf9-4fdf-8782-e53db20768a5"},"properties":{"title":{"title":[{"text":{"content":"New page"}}]}}}}'

Notion: append blocks

Append blocks to a page or block’s children. Required: block_id + a children array.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`block_id`	string	yes
`children`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/append-blocks","input":{"block_id":"59833787-2cf9-4fdf-8782-e53db20768a5","children":[{"paragraph":{"rich_text":[{"text":{"content":"Hello"}}]}}]}}'

Notion: comment

Add a comment to a page (via parent) or an existing discussion (via discussion_id). Pass body or rich_text.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`parent`	object	no
`discussion_id`	string	no
`body`	string	no
`rich_text`	object[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/comment","input":{"parent":{"page_id":"59833787-2cf9-4fdf-8782-e53db20768a5"},"body":"Looks good!"}}'

Notion: update a page

Edit a page’s properties, icon or cover — the counterpart to create_page. Only the properties you pass change; the rest and the page’s content blocks are untouched. Property values use Notion’s typed shape.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_id`	string	yes
`properties`	object	no
`icon`	object	no
`cover`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/update-page","input":{"page_id":"59833787-2cf9-4fdf-8782-e53db20768a5","properties":{"Status":{"select":{"name":"Done"}}}}}'

Notion: trash a page

Move a page to the workspace Trash, where a human can still restore it for 30 days. Pass restore true to bring it back. Notion’s API has no permanent delete for pages.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_id`	string	yes
`restore`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/trash-page","input":{"page_id":"59833787-2cf9-4fdf-8782-e53db20768a5"}}'

Notion: list child blocks

One level of a page or block’s children, raw. read_page is better for reading content; this is how you get the block ids that update_block and delete_block need.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`block_id`	string	yes
`start_cursor`	string	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/blocks","input":{"block_id":"59833787-2cf9-4fdf-8782-e53db20768a5"}}'

Notion: update a block

Rewrite one block in place (id from notion.blocks). The body is keyed by the block’s own type — a paragraph takes {paragraph:{rich_text:[…]}} — and you can’t change a block’s type this way.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`block_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/update-block","input":{"block_id":"59833787-2cf9-4fdf-8782-e53db20768a5","paragraph":{"rich_text":[{"text":{"content":"Rewritten."}}]}}}'

Notion: delete a block

Move a block and everything nested under it to Trash — the way to remove a paragraph, a heading or a whole section from a page. Restorable by a human for 30 days.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`block_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/delete-block","input":{"block_id":"59833787-2cf9-4fdf-8782-e53db20768a5"}}'

Notion: create a database

Create a database under a page. properties is the schema — a map of column name to column type, one of which must be a title.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`parent`	object	yes
`title`	object[]	no
`properties`	object	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/create-database","input":{"parent":{"type":"page_id","page_id":"59833787-2cf9-4fdf-8782-e53db20768a5"},"title":[{"text":{"content":"Bugs"}}],"properties":{"Name":{"title":{}},"Status":{"select":{"options":[{"name":"Open"}]}}}}}'

Notion: update a database

Change a database’s title, description or schema. Passing a property as null removes that column and its data from every row.

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`database_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/update-database","input":{"database_id":"59833787-2cf9-4fdf-8782-e53db20768a5","title":[{"text":{"content":"Bugs (triaged)"}}]}}'

Notion: raw request

Escape hatch: call any Notion API endpoint on your token (host pinned to api.notion.com).

Bring your own key — connect Notion first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"notion","endpoint":"/request","input":{"method":"POST","path":"/v1/search","body":{"query":"roadmap"}}}'

Dodo Payments

Your Dodo Payments account: payments, subscriptions, customers, products, refunds, payouts, licenses, and checkout links (bring your own API key). (payments)

Dodo: payments

List payments (filter by status, customer_id, etc.).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/payments","input":{"page_size":20}}'

Dodo: payment

Get one payment by id.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`payment_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/payment","input":{"payment_id":"pay_123"}}'

Dodo: subscriptions

List subscriptions (status, customer).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/subscriptions","input":{"page_size":20}}'

Dodo: subscription

Get one subscription by id.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/subscription","input":{"subscription_id":"sub_123"}}'

Dodo: customers

List customers (filter by email, etc.).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/customers","input":{"page_size":20}}'

Dodo: customer

Get one customer by id.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/customer","input":{"customer_id":"cus_123"}}'

Dodo: products

List products.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/products","input":{}}'

Dodo: refunds

List refunds.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/refunds","input":{}}'

Dodo: disputes

List disputes/chargebacks.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/disputes","input":{}}'

Dodo: payouts

List payouts.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/payouts","input":{}}'

Dodo: licenses

List license keys (validate/activate via the request passthrough).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/licenses","input":{}}'

Dodo: discounts

List discount codes.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/discounts","input":{}}'

Dodo: create refund

Refund a payment. Required: payment_id; optional amount (partial) + reason.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`payment_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/refunds/create","input":{"payment_id":"pay_123"}}'

Dodo: cancel subscription

Cancel a subscription by id.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/subscriptions/cancel","input":{"subscription_id":"sub_123"}}'

Dodo: create checkout

Create a hosted checkout session / payment link (per Dodo’s checkout-sessions schema).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/checkout/create","input":{"product_cart":[{"product_id":"prod_123","quantity":1}]}}'

Dodo: customer portal link

Generate a self-serve billing-portal session link for a customer.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/customers/portal","input":{"customer_id":"cus_123"}}'

Dodo: validate license

Check whether a license key is valid. Optional license_key_instance_id.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`license_key`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/licenses/validate","input":{"license_key":"KEY-XXXX-XXXX"}}'

Dodo: activate license

Activate a license key on a device/instance. Required: license_key + name.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`license_key`	string	yes
`name`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/licenses/activate","input":{"license_key":"KEY-XXXX-XXXX","name":"my-laptop"}}'

Dodo: create customer

Create a customer. Required: email; name + phone_number optional.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`email`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/customers/create","input":{"email":"jane@example.com","name":"Jane"}}'

Dodo: create product

Create a product (name + price/tax_category per Dodo’s schema).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/products/create","input":{"name":"Pro plan","tax_category":"saas"}}'

Dodo: payment line items

Line items for a payment.

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`payment_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/payments/line-items","input":{"payment_id":"pay_123"}}'

Dodo: balance ledger

Balance ledger entries (filter by date range, event type, currency).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page_number`	integer	no
`page_size`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/balance-ledger","input":{"page_size":20}}'

Dodo: raw request

Escape hatch: call any Dodo endpoint on your key (license validate/activate, portal sessions, etc.).

Bring your own key — connect Dodo Payments first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dodo","endpoint":"/request","input":{"method":"GET","path":"/payments","query":{"page_size":1}}}'

Polar

Your Polar organization: orders, subscriptions, customers, products, checkouts, benefits, license keys, usage metering, refunds, metrics and webhooks (bring your own organization token). (payments)

Polar: orders

List orders (filter by status, product_id, customer_id, external_customer_id, created_after/before, metadata).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/orders","input":{"limit":20}}'

Polar: order

Get one order by id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`order_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/order","input":{"order_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: update order

Update an order’s billing name/address (what the invoice will show).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`order_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/orders/update","input":{"order_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","billing_name":"Acme Inc."}}'

Polar: order invoice

Invoice data (download URL) for an order. Generate it first with generate_invoice if it 404s.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`order_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/orders/invoice","input":{"order_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: generate invoice

Trigger invoice generation for an order (async, 202); then read it with order_invoice.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`order_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/orders/invoice/generate","input":{"order_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: order receipt

Presigned URL for an order’s receipt PDF (202 with no body while it is still being generated).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`order_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/orders/receipt","input":{"order_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: export orders

All orders as CSV text (filter by status, product_id, created_after/before; optional columns, timezone).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/orders/export","input":{"created_after":"2026-01-01T00:00:00Z"}}'

Polar: payments

List payment attempts (filter by order_id, checkout_id, customer_id, status, method, customer_email).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/payments","input":{"status":"failed","limit":20}}'

Polar: payment

Get one payment attempt (method, status, decline reason).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`payment_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/payment","input":{"payment_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: refunds

List refunds (filter by order_id, customer_id, succeeded).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/refunds","input":{}}'

Polar: create refund

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`order_id`	string	yes
`reason`	string	yes
`amount`	integer	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/refunds/create","input":{"order_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","reason":"customer_request","amount":1900}}'

Polar: disputes

List disputes/chargebacks.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/disputes","input":{}}'

Polar: dispute

Get one dispute with its status and support case.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dispute_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/dispute","input":{"dispute_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: accept dispute

Concede a chargeback: closes the dispute with the processor as lost. Not reversible.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dispute_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/disputes/accept","input":{"dispute_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: metrics

Revenue, MRR, orders, checkouts, churn and more per period. Requires start_date, end_date (YYYY-MM-DD) and interval; optional metrics (slugs), product_id, customer_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`start_date`	string	yes
`end_date`	string	yes
`interval`	string	string	string	string	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/metrics","input":{"start_date":"2026-08-01","end_date":"2026-08-31","interval":"day"}}'

Polar: metrics limits

The longest date range each metrics interval allows (check before a big hourly query).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/metrics/limits","input":{}}'

Polar: export metrics

The metrics series as CSV text. Same inputs as metrics.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`start_date`	string	yes
`end_date`	string	yes
`interval`	string	string	string	string	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/metrics/export","input":{"start_date":"2026-01-01","end_date":"2026-08-31","interval":"month"}}'

Polar: organizations

The organization this token belongs to (id, slug, settings). Its id is what license-key ops need.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/organizations","input":{}}'

Polar: organization

Get one organization by id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/organization","input":{"organization_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: update organization

Update organization settings (name, website, socials, subscription/customer-portal settings, feature flags).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/organizations/update","input":{"organization_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","website":"https://example.com"}}'

Polar: raw request

Escape hatch: call any Polar endpoint on your token (members, metrics dashboards, file uploads, order finalize). Paths start with /v1/.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/request","input":{"method":"GET","path":"/v1/orders/","query":{"limit":1}}}'

Polar: customers

List customers (filter by email, free-text query, active, metadata).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers","input":{"query":"jane","limit":20}}'

Polar: customer

Get one customer by Polar id or by your own external_customer_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	no
`external_customer_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customer","input":{"external_customer_id":"user_123"}}'

Polar: customer state

One call for a customer’s active subscriptions, granted benefits and meter balances (by id or external_customer_id).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	no
`external_customer_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers/state","input":{"external_customer_id":"user_123"}}'

Polar: customer payment methods

Saved payment methods for a customer (card brand, last4, expiry). By id or external_customer_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	no
`external_customer_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers/payment-methods","input":{"customer_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create customer

Create a customer. Required: email; optional name, external_id (your user id), metadata, billing_address.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`email`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers/create","input":{"email":"jane@example.com","name":"Jane","external_id":"user_123"}}'

Polar: update customer

Update a customer’s email, name, external_id, billing_address, tax_id or metadata. By id or external_customer_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	no
`external_customer_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers/update","input":{"external_customer_id":"user_123","name":"Jane Doe"}}'

Polar: delete customer

Delete a customer: cancels their subscriptions, revokes benefits and clears external_id, not reversible. Optional anonymize=true. Meant for deleting the user in your own service.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	no
`external_customer_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers/delete","input":{"external_customer_id":"user_123"}}'

Polar: export customers

All customers as CSV text.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers/export","input":{}}'

Polar: customer portal link

Create a one-hour customer session; returns customer_portal_url for self-serve billing. By customer_id or external_customer_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	no
`external_customer_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customers/portal","input":{"external_customer_id":"user_123","return_url":"https://example.com/account"}}'

Polar: subscriptions

List subscriptions (filter by active, product_id, customer_id, external_customer_id).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/subscriptions","input":{"active":true,"limit":20}}'

Polar: subscription

Get one subscription by id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/subscription","input":{"subscription_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: export subscriptions

All subscriptions as CSV text (filter by status, product_id, cancel_at_period_end, started_after/before).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/subscriptions/export","input":{}}'

Polar: create subscription

Subscribe a customer to a FREE recurring product without checkout (no order, no email). Required: product_id + customer_id or external_customer_id. Paid products need create_checkout.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`product_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/subscriptions/create","input":{"product_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","external_customer_id":"user_123"}}'

Polar: update subscription

Change plan (product_id + proration_behavior), apply a discount_id, set seats, end a trial (trial_end), pause/resume, or clear a pending update. One change per call.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/subscriptions/update","input":{"subscription_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","product_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","proration_behavior":"prorate"}}'

Polar: cancel subscription

Cancel at the end of the current period (customer keeps access until then). cancel_at_period_end=false reverses it.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/subscriptions/cancel","input":{"subscription_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","customer_cancellation_reason":"too_expensive"}}'

Polar: revoke subscription

Cancel immediately and revoke the customer’s benefits now.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/subscriptions/revoke","input":{"subscription_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: seats

Seats on a seat-based subscription or order (who holds one, claimed or pending). Pass subscription_id or order_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/seats","input":{"subscription_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: assign seat

Assign a seat on a subscription_id (or order_id) to an email, customer_id or external_customer_id; emails an invitation unless immediate_claim=true.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/seats/assign","input":{"subscription_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","email":"teammate@example.com"}}'

Polar: revoke seat

Revoke a seat by seat_id; the holder loses the benefits.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`seat_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/seats/revoke","input":{"seat_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: products

List products with their prices and benefits (filter by is_archived, is_recurring, query).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/products","input":{"is_archived":false}}'

Polar: product

Get one product by id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`product_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/product","input":{"product_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create product

Create a product. Required: name + prices; add recurring_interval (day|week|month|year) for a subscription. Products cannot be deleted, only archived.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
`prices`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/products/create","input":{"name":"Pro","recurring_interval":"month","prices":[{"amount_type":"fixed","price_amount":1900,"price_currency":"usd"}]}}'

Polar: update product

Update a product’s name, description, prices, recurring_interval, or archive it (is_archived=true).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`product_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/products/update","input":{"product_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","is_archived":true}}'

Polar: set product benefits

Replace the full list of benefit ids a product grants (order matters for display).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`product_id`	string	yes
`benefits`	string[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/products/benefits","input":{"product_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","benefits":["3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"]}}'

Polar: checkouts

List checkout sessions (filter by status open|expired|confirmed|succeeded|failed, product_id, customer_id, query).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkouts","input":{"status":"succeeded","limit":20}}'

Polar: checkout

Get one checkout session (status, url, amounts, customer).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`checkout_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkout","input":{"checkout_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create checkout

Create a checkout session (returns url). Required: products (ids); optional success_url, customer_email, external_customer_id, discount_id, metadata.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`products`	string[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkouts/create","input":{"products":["3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"],"success_url":"https://example.com/thanks"}}'

Polar: update checkout

Update an open checkout session (product_id, amount for PWYW, customer fields, discount, metadata).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`checkout_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkouts/update","input":{"checkout_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","customer_email":"jane@example.com"}}'

Polar: checkout links

List shareable checkout links.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkout-links","input":{}}'

Polar: checkout link

Get one checkout link (url, products, label).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`checkout_link_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkout-link","input":{"checkout_link_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create checkout link

Create a long-lived shareable checkout link. Required: products (ids) or product_id; optional label, success_url, discount_id, allow_discount_codes.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkout-links/create","input":{"products":["3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"],"label":"Pro annual"}}'

Polar: update checkout link

Update a checkout link’s products, label, success_url, discount or metadata.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`checkout_link_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkout-links/update","input":{"checkout_link_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","label":"Pro annual (autumn)"}}'

Polar: delete checkout link

Delete a checkout link; anyone holding the URL gets a dead link.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`checkout_link_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/checkout-links/delete","input":{"checkout_link_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: discounts

List discount codes.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/discounts","input":{}}'

Polar: discount

Get one discount (type, amount, duration, redemptions).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`discount_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/discount","input":{"discount_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create discount

Create a discount. Required: name, type (fixed|percentage), duration (once|forever|repeating); fixed needs amount + currency, percentage needs basis_points; optional code, max_redemptions, products.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
`duration`	string	yes
`type`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/discounts/create","input":{"name":"Launch 20%","type":"percentage","basis_points":2000,"duration":"once","code":"LAUNCH20"}}'

Polar: update discount

Update a discount’s name, code, amount, max_redemptions, ends_at or products.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`discount_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/discounts/update","input":{"discount_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","max_redemptions":100}}'

Polar: delete discount

Delete a discount; existing subscriptions keep what they were granted.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`discount_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/discounts/delete","input":{"discount_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: custom fields

List custom checkout fields (text, number, date, checkbox, select).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/custom-fields","input":{}}'

Polar: custom field

Get one custom field.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`custom_field_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/custom-field","input":{"custom_field_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create custom field

Create a checkout form field. Required: type (text|number|date|checkbox|select), slug, name; properties per type (e.g. select options). Attach it to products via update_product attached_custom_fields.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	yes
`slug`	string	yes
`name`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/custom-fields/create","input":{"type":"text","slug":"company","name":"Company","properties":{"form_label":"Company name"}}}'

Polar: update custom field

Update a custom field’s name, slug or properties. type must be sent and cannot change.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`custom_field_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/custom-fields/update","input":{"custom_field_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","type":"text","name":"Company (optional)"}}'

Polar: delete custom field

Delete a custom field and detach it from every product.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`custom_field_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/custom-fields/delete","input":{"custom_field_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: benefits

List benefits (license_keys, downloadables, discord, github_repository, meter_credit, feature_flag, custom).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/benefits","input":{}}'

Polar: benefit

Get one benefit with its properties.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`benefit_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/benefit","input":{"benefit_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create benefit

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	yes
`description`	string	yes
`properties`	object	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/benefits/create","input":{"type":"license_keys","description":"Desktop app license","properties":{"limit_activations":{"limit":3}}}}'

Polar: update benefit

Update a benefit’s description or properties. type must be sent and cannot change.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`benefit_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/benefits/update","input":{"benefit_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","type":"license_keys","description":"Desktop app license (3 devices)"}}'

Polar: delete benefit

Delete a benefit; every customer holding it loses it. Not reversible.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`benefit_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/benefits/delete","input":{"benefit_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: benefit grants

Who holds which benefit, across all benefits (filter by customer_id, external_customer_id, is_granted).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/benefit-grants","input":{"is_granted":true,"limit":20}}'

Polar: grants of one benefit

Grants of one benefit (filter by customer_id, is_granted).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`benefit_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/benefits/grants","input":{"benefit_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: license keys

List issued license keys (filter by benefit_id, status granted|revoked|disabled).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/license-keys","input":{"limit":20}}'

Polar: license key

Get one license key with its activations, usage and limits.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`license_key_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/license-key","input":{"license_key_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: update license key

Set a key’s status (granted|revoked|disabled), usage, limit_activations, limit_usage or expires_at.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`license_key_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/license-keys/update","input":{"license_key_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","status":"disabled"}}'

Polar: validate license

Check whether a license key is valid. Required: key + organization_id; optional activation_id, conditions, increment_usage.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`key`	string	yes
`organization_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/license-keys/validate","input":{"key":"XXXX-XXXX-XXXX-XXXX","organization_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: activate license

Activate a license key on a device. Required: key + organization_id + label; returns the activation id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`key`	string	yes
`organization_id`	string	yes
`label`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/license-keys/activate","input":{"key":"XXXX-XXXX-XXXX-XXXX","organization_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","label":"my-laptop"}}'

Polar: deactivate license

Free an activation slot. Required: key + organization_id + activation_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`key`	string	yes
`organization_id`	string	yes
`activation_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/license-keys/deactivate","input":{"key":"XXXX-XXXX-XXXX-XXXX","organization_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","activation_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: meters

List usage meters (what metered billing aggregates).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/meters","input":{}}'

Polar: meter

Get one meter (filter, aggregation, unit).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`meter_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/meter","input":{"meter_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create meter

Create a usage meter. Required: name, filter ({conjunction, clauses:[{property, operator, value}]}), aggregation ({func: count|sum|max|min|avg|unique, property?}).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
`filter`	object	yes
`aggregation`	object	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/meters/create","input":{"name":"API calls","filter":{"conjunction":"and","clauses":[{"property":"name","operator":"eq","value":"api_call"}]},"aggregation":{"func":"count"}}}'

Polar: update meter

Rename a meter or change its filter/aggregation/unit/metadata.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`meter_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/meters/update","input":{"meter_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","name":"API requests"}}'

Polar: meter quantities

A meter’s aggregated usage per period; optional customer_id or external_customer_id narrows it to one customer.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`meter_id`	string	yes
`start_timestamp`	string	yes
`end_timestamp`	string	yes
`interval`	string	string	string	string	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/meters/quantities","input":{"meter_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","start_timestamp":"2026-09-01T00:00:00Z","end_timestamp":"2026-09-18T00:00:00Z","interval":"day"}}'

Polar: customer meters

Per-customer meter balances (consumed, credited, balance). Filter by customer_id, external_customer_id, meter_id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customer-meters","input":{"external_customer_id":"user_123"}}'

Polar: customer meter

One customer-meter balance by id.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_meter_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/customer-meter","input":{"customer_meter_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: events

List ingested usage events (filter by name, customer_id, external_customer_id, meter_id, start/end_timestamp, metadata).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/events","input":{"limit":20}}'

Polar: event

Get one ingested event.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`event_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/event","input":{"event_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: event names

Distinct event names seen, with counts and first/last timestamps (what a meter filter can match).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/events/names","input":{}}'

Polar: event types

Event types with their labels (filter by query, source, root_events).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/event-types","input":{}}'

Polar: update event type

Set the display label of an event type (what customers see on usage breakdowns).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`event_type_id`	string	yes
`label`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/event-types/update","input":{"event_type_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","label":"API call"}}'

Polar: ingest usage events

Record usage for metered billing. Each event: name + customer_id or external_customer_id; optional metadata (what meters aggregate), timestamp, external_id (dedupe).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`events`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/events/ingest","input":{"events":[{"name":"api_call","external_customer_id":"user_123","metadata":{"tokens":1200}}]}}'

Polar: files

List uploaded files (downloadable benefits, product media). Uploads are a multi-step S3 flow; use request for them.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/files","input":{}}'

Polar: delete file

Delete an uploaded file; downloadable benefits pointing at it lose it.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`file_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/files/delete","input":{"file_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: webhooks

List webhook endpoints (url, format, events, enabled, secret).

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhooks","input":{}}'

Polar: webhook

Get one webhook endpoint, secret included.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`webhook_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhook","input":{"webhook_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: create webhook

Register a webhook endpoint. Required: url, format (raw|discord|slack), events (e.g. order.paid, subscription.active, customer.state_changed); optional name, secret.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
`format`	string	yes
`events`	string[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhooks/create","input":{"url":"https://example.com/hooks/polar","format":"raw","events":["order.paid","subscription.active"]}}'

Polar: update webhook

Change a webhook’s url, name, events or enabled flag.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`webhook_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhooks/update","input":{"webhook_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a","enabled":false}}'

Polar: delete webhook

Delete a webhook endpoint.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`webhook_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhooks/delete","input":{"webhook_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: reset webhook secret

Rotate a webhook’s signing secret; the old one stops validating immediately.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`webhook_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhooks/reset-secret","input":{"webhook_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Polar: webhook deliveries

Delivery attempts with HTTP code and payload (filter by endpoint_id, succeeded, event_type, http_code_class). Last 7 days unless start_timestamp is given; Polar times out on windows past ~2 weeks.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhooks/deliveries","input":{"succeeded":false,"limit":20}}'

Polar: redeliver webhook event

Re-send one webhook event (the webhook_event_id from a delivery) to its endpoint.

Bring your own key — connect Polar first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`event_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"polar","endpoint":"/webhooks/redeliver","input":{"event_id":"3ab5f2d6-1234-4c1a-9b8e-0f1e2d3c4b5a"}}'

Spaceship

Your Spaceship domains and DNS: list domains, edit DNS records, set nameservers and auto-renew (bring your own API key + secret). (dev)

Spaceship: my domains

List the domains in your account (expiry, auto-renew, nameservers).

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`take`	integer	no
`skip`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/domains","input":{"take":50}}'

Spaceship: domain info

Details for one of your domains (expiry, auto-renew, nameservers, status).

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/domain","input":{"domain":"example.com"}}'

Spaceship: DNS records

List the DNS records for one of your domains.

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
`take`	integer	no
`skip`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/dns/records","input":{"domain":"example.com"}}'

Spaceship: domain availability

Check whether a domain is available to register.

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/domains/available","input":{"domain":"example.com"}}'

Spaceship: save DNS records

Add or update DNS records (upsert). Pass items per Spaceship’s record schema.

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
`items`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/dns/records/save","input":{"domain":"example.com","items":[{"type":"TXT","name":"@","value":"verify=abc","ttl":3600}]}}'

Spaceship: delete DNS records

Delete DNS records. Pass the records to remove in items.

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
`items`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/dns/records/delete","input":{"domain":"example.com","items":[{"type":"TXT","name":"@","value":"verify=abc"}]}}'

Spaceship: set nameservers

Update a domain’s nameservers (provider preset or custom hosts).

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/domains/nameservers","input":{"domain":"example.com","provider":"custom","hosts":["ns1.example.net","ns2.example.net"]}}'

Spaceship: set auto-renew

Turn auto-renew on or off for a domain.

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`domain`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/domains/autorenew","input":{"domain":"example.com","isAutoRenew":true}}'

Spaceship: raw request

Escape hatch: call any Spaceship endpoint on your key (register, renew, transfer, contacts, async-operations).

Bring your own key — connect Spaceship first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"spaceship","endpoint":"/request","input":{"method":"GET","path":"/domains","query":{"take":1,"skip":0}}}'

Supabase

Your Supabase org: run SQL on its projects, list projects, read logs (connect with one click; pick the org). (dev)

Supabase: my projects

List your Supabase projects (id, ref, name, region, status).

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/projects","input":{}}'

Supabase: edge functions

Edge functions deployed to a project, with slug, status and version.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/functions","input":{"project_ref":"abcdefgh"}}'

Supabase: database branches

Preview branches on a project, with their status and parent.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/branches","input":{"project_ref":"abcdefgh"}}'

Supabase: project health

Per-service health for a project. services picks which of auth, db, db_postgres_user, pooler, realtime, rest, storage, pg_bouncer to check (default auth, realtime, rest, storage, db).

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
`services`	string	string[]	no
`timeout_ms`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/health","input":{"project_ref":"abcdefgh"}}'

Supabase: auth settings

A project’s auth configuration: providers enabled, token expiry, signup and email rules.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/config/auth","input":{"project_ref":"abcdefgh"}}'

Supabase: project

Details for one project by its ref.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/project","input":{"project_ref":"abcdefghijklmnop"}}'

Supabase: organizations

List your Supabase organizations.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/organizations","input":{}}'

Supabase: project logs

Recent project logs from a single stream. sql queries the log tables (edge_logs, postgres_logs, auth_logs and more); iso_timestamp_start/end bound the window.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
`sql`	string	no
`iso_timestamp_start`	string	no
`iso_timestamp_end`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/logs","input":{"project_ref":"abcdefghijklmnop"}}'

Supabase: run SQL

Run SQL on a project. Defaults to read-only; pass read_only:false to allow writes/DDL.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
`query`	string	yes
`read_only`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/database/query","input":{"project_ref":"abcdefghijklmnop","query":"select count(*) from auth.users"}}'

Supabase: project API keys

A project’s API keys, values revealed — the anon and service_role keys an app needs to talk to it. Treat the response as secret; the service_role key bypasses row level security.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
`reveal`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/project/api-keys","input":{"project_ref":"<project-ref>"}}'

Supabase: edge function secrets

The secrets available to a project’s edge functions, with their values. Treat the response as secret.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/project/secrets","input":{"project_ref":"<project-ref>"}}'

Supabase: set edge function secrets

Create or overwrite secrets for a project’s edge functions. Names can’t start with SUPABASE_, and an existing name is overwritten silently.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
`secrets`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/project/secrets/set","input":{"project_ref":"<project-ref>","secrets":[{"name":"OPENAI_API_KEY","value":"sk-..."}]}}'

Supabase: delete edge function secrets

Remove secrets by name. Functions relying on them start failing at their next invocation.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
`names`	string[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/project/secrets/delete","input":{"project_ref":"<project-ref>","names":["OPENAI_API_KEY"]}}'

Supabase: pause a project

Pause a project: the database stops accepting connections and stops billing compute. Restorable from the dashboard, unlike delete_project.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/project/pause","input":{"project_ref":"<project-ref>"}}'

Supabase: delete a project

Permanently delete a project and its database. Every table, row, storage object and edge function goes with it, and no restore exists. pause_project is the reversible way to stop paying for one.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_ref`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/project/delete","input":{"project_ref":"<project-ref>"}}'

Supabase: raw request

Escape hatch: call any Supabase Management API endpoint on your connection.

Bring your own key — connect Supabase first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"supabase","endpoint":"/request","input":{"method":"GET","path":"/v1/projects"}}'

Cloudflare

Your Cloudflare account: run Workers AI models, manage zones and DNS, inspect edge infrastructure, and purge cache. (dev)

Cloudflare: zones

List your zones (domains). Filter by name.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`name`	string	no
`page`	integer	no
`per_page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/zones","input":{}}'

Cloudflare: zone

Details for one zone by id.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`zone_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/zone","input":{"zone_id":"023e105f4ecef8ad9ca31a8372d0c353"}}'

Cloudflare: DNS records

List a zone’s DNS records (filter by type/name).

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`zone_id`	string	yes
`type`	string	no
`name`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/dns_records","input":{"zone_id":"023e105f..."}}'

Cloudflare: zone settings

Every setting on a zone and its current value — SSL mode, minify, HTTP/3, security level and the rest.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`zone_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/zone_settings","input":{"zone_id":"023e105f..."}}'

Cloudflare: workers.dev subdomain

The account’s workers.dev subdomain, which prefixes every Worker’s default URL.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/workers/subdomain","input":{}}'

Cloudflare: Worker cron triggers

The cron schedules attached to a Worker, with when each last ran.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`script_name`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/workers/schedules","input":{"script_name":"my-worker"}}'

Cloudflare: Pages project

One Pages project in full: build config, domains, environment variables and its latest deployment.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_name`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/pages/project","input":{"project_name":"my-site"}}'

Cloudflare: Pages deployments

Deployment history for a Pages project, with status, trigger and commit.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_name`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/pages/deployments","input":{"project_name":"my-site"}}'

Cloudflare: D1 database

One D1 database: size, table count, version and region.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`database_id`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/d1/database","input":{"database_id":"2e7ee3c2-..."}}'

Cloudflare: run SQL on D1

Run SQL against a D1 database and get the rows back. A write verb because the same endpoint runs INSERT, UPDATE and DDL — a SELECT is safe, anything else changes your data.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`database_id`	string	yes
`sql`	string	yes
`params`	any[]	no
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/d1/query","input":{"database_id":"2e7ee3c2-...","sql":"select count(*) from users"}}'

Cloudflare: create R2 bucket

Create an R2 object-storage bucket.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
`location`	string	no
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/r2/buckets/create","input":{"name":"my-bucket"}}'

Cloudflare: delete R2 bucket

Delete an R2 bucket. The bucket must already be empty, and the deletion cannot be undone.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`bucket_name`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/r2/buckets/delete","input":{"bucket_name":"my-bucket"}}'

Cloudflare: create KV namespace

Create a Workers KV namespace.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`title`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/kv/namespaces/create","input":{"title":"MY_CACHE"}}'

Cloudflare: delete KV namespace

Delete a Workers KV namespace and every key in it. Cannot be undone.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`namespace_id`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/kv/namespaces/delete","input":{"namespace_id":"6f0136e8..."}}'

Cloudflare: create queue

Create a Queue.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`queue_name`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/queues/create","input":{"queue_name":"jobs"}}'

Cloudflare: delete queue

Delete a Queue along with any messages still on it. Cannot be undone.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`queue_id`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/queues/delete","input":{"queue_id":"238be3a0..."}}'

Cloudflare: create D1 database

Create a D1 SQLite database.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/d1/create","input":{"name":"my-db"}}'

Cloudflare: delete Worker

Delete a Worker script. Its routes stop serving immediately and the deployment cannot be undone.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`script_name`	string	yes
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/workers/delete","input":{"script_name":"my-worker"}}'

Cloudflare: D1 databases

D1 SQLite databases in the account, with size and version.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/d1/databases","input":{}}'

Cloudflare: Vectorize indexes

Vector search indexes in the account, with dimensions and metric.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/vectorize/indexes","input":{}}'

Cloudflare: queues

Queues in the account, with their producers and consumers.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/queues","input":{}}'

Cloudflare: Hyperdrive configs

Hyperdrive database connection configs in the account.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/hyperdrive/configs","input":{}}'

Cloudflare: email routing addresses

Verified destination addresses that email routing can forward to.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/email/routing","input":{}}'

Cloudflare: rulesets

WAF and transform rulesets at the account level, with their phase and kind.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/rulesets","input":{}}'

Cloudflare Radar: networks (ASNs)

Autonomous systems with their name, country and estimated user base — who actually runs a network.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/asns","input":{"limit":20}}'

Cloudflare Radar: DNS resolver trends

Share of DNS queries served from cache across Cloudflare’s 1.1.1.1 resolver.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dateRange`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/dns","input":{"dateRange":"7d"}}'

Cloudflare Radar: internet quality

Measured bandwidth, latency and DNS response time percentiles — how fast the internet actually is.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dateRange`	string	no
`metric`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/quality","input":{"dateRange":"7d","metric":"bandwidth"}}'

Cloudflare Radar: certificate authorities

Certificate authorities seen in Certificate Transparency logs, by issuance volume.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/certificate_authorities","input":{"limit":20}}'

Share of inbound email classified as spam across Cloudflare’s email security network.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dateRange`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/email_security","input":{"dateRange":"7d"}}'

Which AI crawlers are actually fetching the web, by share of AI bot traffic across Cloudflare’s network — GPTBot, ClaudeBot, Googlebot, Meta-ExternalAgent and the rest.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dateRange`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/ai_bots","input":{"dateRange":"7d"}}'

Cloudflare Radar: most visited sites

The most visited sites on the internet, ranked by Cloudflare resolver traffic, with categories. A popularity chart, not a lookup: it cannot tell you anything about one specific site.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/ranking","input":{"limit":20}}'

Cloudflare Radar: HTTP traffic mix

Share of internet traffic by HTTP protocol version across Cloudflare’s network.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dateRange`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/http","input":{"dateRange":"7d"}}'

Cloudflare Radar: layer 7 attacks

Application-layer attack traffic broken down by HTTP method, across Cloudflare’s network.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dateRange`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/attacks","input":{"dateRange":"7d"}}'

Cloudflare Radar: BGP routing table

Global routing table stats: distinct origins, prefixes and RPKI validity, IPv4 and IPv6.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`dateRange`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/bgp","input":{}}'

Cloudflare Radar: downloadable datasets

The Radar datasets available to download, such as the top-million ranking domains.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/radar/datasets","input":{"limit":20}}'

Cloudflare: Workers scripts

Every Worker deployed in the account, with when each was created and last modified.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/workers","input":{}}'

Cloudflare: Pages projects

Pages projects in the account, with their subdomain, build config and latest deployment.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/pages/projects","input":{}}'

Cloudflare: R2 buckets

R2 object-storage buckets in the account, with creation date and location.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/r2/buckets","input":{}}'

Cloudflare: KV namespaces

Workers KV namespaces in the account.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/kv/namespaces","input":{}}'

Cloudflare: tunnels

cloudflared tunnels in the account, with status and connections.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`account_id`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/tunnels","input":{}}'

Cloudflare: accounts

List the accounts your token can access.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/accounts","input":{}}'

Cloudflare: create DNS record

Add a DNS record. Required: zone_id, type, name, content; optional ttl, proxied.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`zone_id`	string	yes
`type`	string	yes
`name`	string	yes
`content`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/dns_records/create","input":{"zone_id":"023e105f...","type":"A","name":"app.example.com","content":"203.0.113.10","proxied":true}}'

Cloudflare: update DNS record

Update a DNS record by zone_id + record_id (fields to change in the body).

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`zone_id`	string	yes
`record_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/dns_records/update","input":{"zone_id":"023e105f...","record_id":"372e67954...","content":"203.0.113.20"}}'

Cloudflare: delete DNS record

Delete a DNS record by zone_id + record_id.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`zone_id`	string	yes
`record_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/dns_records/delete","input":{"zone_id":"023e105f...","record_id":"372e67954..."}}'

Cloudflare: purge cache

Purge a zone’s cache. Defaults to purge_everything; pass files:[] for selective purge.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`zone_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/purge_cache","input":{"zone_id":"023e105f...","purge_everything":true}}'

Cloudflare: raw request

Escape hatch: call any Cloudflare v4 endpoint on your token (Workers, Pages, KV, rulesets, analytics).

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/request","input":{"method":"GET","path":"/zones"}}'

Cloudflare AI: chat completion

Prompt any Workers AI text-generation model through the OpenAI chat shape. Defaults to free-plan GLM-4.7-Flash with reasoning, tools and a 131k context window. Every chat field passes through except streaming.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	no
`messages`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/ai/chat/completions","input":{"messages":[{"role":"user","content":"Explain Durable Objects in one sentence."}]}}'

Cloudflare AI: model response

Use Cloudflare’s OpenAI-compatible Responses API with a model that supports it. Defaults to GPT-OSS 120B and returns the complete response without streaming.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	no
`input`	string	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/ai/responses","input":{"input":"What is 1312 times 3333? Return only the number."}}'

Cloudflare AI: text embeddings

Create one or more embedding vectors through Cloudflare’s OpenAI-compatible endpoint. Defaults to BGE Base English v1.5; pass another Workers AI embedding model when needed.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`input`	string	string[]	yes
`model`	string	no
`encoding_format`	string	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/ai/embeddings","input":{"input":["A database row","A semantically related record"]}}'

Cloudflare AI: run any model

Run any Workers AI model with its native input schema, including text, images, speech, transcription, translation, classification and reranking. JSON is returned directly; binary output is returned as base64 with its content type.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes
`input`	object	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/ai/run/{model}","input":{"model":"@cf/meta/m2m100-1.2b","input":{"text":"hello","source_lang":"en","target_lang":"es"}}}'

Cloudflare AI: model catalog

Search the live Workers AI model catalog by task, author or name. The result reflects the connected account; use it before choosing a model because access and deprecations change.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`search`	string	no
`task`	string	no
`author`	string	no
`hide_experimental`	boolean	no
`include_deprecated`	boolean	no
`format`	string	no
`source`	integer	no
`page`	integer	no
`per_page`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/ai/models","input":{"task":"Text Generation","hide_experimental":true}}'

Cloudflare AI: model input schema

Get Cloudflare’s current input and output JSON schemas for one Workers AI model. Use this before ai_run so model-specific fields are not guessed.

Bring your own key — connect Cloudflare first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"cloudflare","endpoint":"/ai/models/schema","input":{"model":"@cf/zai-org/glm-4.7-flash"}}'

Stripe

Your Stripe account: customers, payments, subscriptions, invoices, balance, payouts, refunds + checkout/payment links (bring your own restricted key). (payments)

Stripe: customers

List customers (filter by email, etc.).

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/customers","input":{"limit":10}}'

Stripe: customer

Get one customer by id.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`customer_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/customer","input":{"customer_id":"cus_123"}}'

Stripe: payment intents

List payment intents.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/payment_intents","input":{"limit":10}}'

Stripe: payment intent

Get one payment intent by id.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`payment_intent_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/payment_intent","input":{"payment_intent_id":"pi_123"}}'

Stripe: charges

List charges.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/charges","input":{"limit":10}}'

Stripe: subscriptions

List subscriptions (filter by customer, status, price).

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/subscriptions","input":{"limit":10}}'

Stripe: subscription

Get one subscription by id.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/subscription","input":{"subscription_id":"sub_123"}}'

Stripe: invoices

List invoices.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/invoices","input":{"limit":10}}'

Stripe: products

List products.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/products","input":{"limit":10}}'

Stripe: prices

List prices.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/prices","input":{"limit":10}}'

Stripe: refunds

List refunds.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/refunds","input":{"limit":10}}'

Stripe: balance

Your current Stripe balance (available + pending).

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/balance","input":{}}'

Stripe: balance transactions

List balance transactions (the money ledger).

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/balance_transactions","input":{"limit":10}}'

Stripe: payouts

List payouts to your bank.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/payouts","input":{"limit":10}}'

Stripe: events

List recent account events.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/events","input":{"limit":10}}'

Stripe: disputes

List disputes / chargebacks.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`starting_after`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/disputes","input":{"limit":10}}'

Stripe: create refund

Refund a charge or payment_intent (moves money back). Required: charge OR payment_intent.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/refunds/create","input":{"payment_intent":"pi_123"}}'

Stripe: create customer

Create a customer (email, name, metadata).

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/customers/create","input":{"email":"jane@example.com"}}'

Stripe: cancel subscription

Cancel a subscription by id (stops recurring billing).

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`subscription_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/subscriptions/cancel","input":{"subscription_id":"sub_123"}}'

Stripe: create payment link

Create a shareable payment link. line_items reference existing prices.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`line_items`	object[]	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/payment_links/create","input":{"line_items":[{"price":"price_123","quantity":1}]}}'

Stripe: create checkout session

Create a hosted Checkout session (per Stripe’s checkout schema).

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/checkout/create","input":{"mode":"payment","line_items":[{"price":"price_123","quantity":1}],"success_url":"https://example.com/ok"}}'

Stripe: raw request

Escape hatch: call any Stripe endpoint on your key (form-encoded). params support nested objects/arrays.

Bring your own key — connect Stripe first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`params`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"stripe","endpoint":"/request","input":{"method":"GET","path":"/v1/charges","params":{"limit":1}}}'

Slack

Your Slack workspace: post and read messages, list channels and users (connect with one click; invite the bot to channels it should act in). (communications)

Slack: list channels

List channels (public/private the bot can see).

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`types`	string	no
`limit`	integer	no
`cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/conversations.list","input":{"types":"public_channel","limit":50}}'

Slack: read a thread

Every reply in one thread, given the parent message’s ts. Channel history returns only parent messages, so this is the one that reads the actual conversation.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
`ts`	string	yes
`limit`	integer	no
`cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/conversations.replies","input":{"channel":"C0123ABC","ts":"1728000000.123456"}}'

Slack: search messages

Search the workspace with Slack’s own query syntax — in:#channel, from:@user, before/after a date. Needs a user token; a bot token cannot search.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`count`	integer	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/search.messages","input":{"query":"deploy failed in:#engineering","count":20}}'

Slack: channel members

User ids in a channel.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
`limit`	integer	no
`cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/conversations.members","input":{"channel":"C0123ABC"}}'

Slack: channels a user is in

Channels the given user (or the token’s own identity) belongs to.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user`	string	no
`types`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/users.conversations","input":{"types":"public_channel"}}'

Slack: list files

Files shared in the workspace, filterable by channel or uploader.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	no
`user`	string	no
`count`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/files.list","input":{"count":20}}'

Slack: add a reaction

React to a message with an emoji.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
`timestamp`	string	yes
`name`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/reactions.add","input":{"channel":"C0123ABC","timestamp":"1728000000.123456","name":"white_check_mark"}}'

Slack: join a channel

Join a public channel. The bot must be a member before it can read history or post, so this is usually the fix for not_in_channel.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/conversations.join","input":{"channel":"C0123ABC"}}'

Slack: channel history

Recent messages in a channel (the bot must be a member).

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
`limit`	integer	no
`cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/conversations.history","input":{"channel":"C0123ABC","limit":20}}'

Slack: channel info

Metadata for one channel.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/conversations.info","input":{"channel":"C0123ABC"}}'

Slack: list users

List workspace users.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/users.list","input":{"limit":100}}'

Slack: user info

Profile for one user by id.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`user`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/users.info","input":{"user":"U0123ABC"}}'

Slack: post message

Post a message to a channel (the bot must be a member). text or blocks.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
`text`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/chat.postMessage","input":{"channel":"C0123ABC","text":"deploy finished ✅"}}'

Slack: update message

Edit a message by channel + ts.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
`ts`	string	yes
`text`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/chat.update","input":{"channel":"C0123ABC","ts":"1700000000.000100","text":"updated"}}'

Slack: delete message

Delete a message by channel + ts.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`channel`	string	yes
`ts`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/chat.delete","input":{"channel":"C0123ABC","ts":"1700000000.000100"}}'

Slack: raw request

Escape hatch: call any Slack Web API method on your token. http_method defaults to POST.

Bring your own key — connect Slack first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`method`	string	yes
`http_method`	string	no
`params`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"slack","endpoint":"/request","input":{"method":"conversations.list","http_method":"GET","params":{"limit":1}}}'

Discord

Your Discord servers: search and send messages, manage channels, threads, reactions, and pins across every installed server. (communications)

Discord: list servers

List the connected user’s servers and show which are installed/default.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/list-servers","input":{}}'

Discord: get server

Get one connected server; omitted guild_id uses the default.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/get-server","input":{}}'

Discord: join server

Add the connected user to a server where the fetchbean bot is installed.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/join-server","input":{}}'

Discord: leave server

Leave a server as the connected user. Server owners must transfer ownership first.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	yes
`confirm`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/leave-server","input":{"guild_id":"123","confirm":true}}'

Discord: list channels

List channels in a connected server.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/list-channels","input":{}}'

Discord: get channel

Get channel or thread metadata.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/get-channel","input":{"channel_id":"123"}}'

Discord: create channel

Create a channel in a connected server.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`name`	string	yes
`type`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/create-channel","input":{"name":"launch-room","type":0}}'

Discord: update channel

Rename or configure a channel.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`name`	string	no
`topic`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/update-channel","input":{"channel_id":"123","topic":"launch coordination"}}'

Discord: delete channel

Permanently delete a channel.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`confirm`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/delete-channel","input":{"channel_id":"123","confirm":true}}'

Discord: list messages

Read up to 100 messages from a channel or thread.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`before`	string	no
`after`	string	no
`around`	string	no
`limit`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/list-messages","input":{"channel_id":"123","limit":25}}'

Discord: search messages

Search server messages by content, author, channel, mentions, links, files, or relevance.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`content`	string	no
`channel_id`	string[]	no
`author_id`	string[]	no
`mentions`	string[]	no
`has`	string[]	no
`pinned`	boolean	no
`sort_by`	string	string	no
`sort_order`	string	string	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/search-messages","input":{"content":"launch plan","sort_by":"relevance"}}'

Discord: get message

Read one message by channel and message id.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`message_id`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/get-message","input":{"channel_id":"123","message_id":"456"}}'

Discord: send message

Send or reply in a channel/thread. Mentions are suppressed unless explicitly allowed.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`content`	string	no
`embeds`	object[]	no
`components`	object[]	no
`poll`	object	no
`reply_to_message_id`	string	no
`allowed_mentions`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/send-message","input":{"channel_id":"123","content":"deploy finished"}}'

Discord: edit message

Edit a message sent by the fetchbean bot.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`message_id`	string	yes
`content`	string	no
`embeds`	object[]	no
`components`	object[]	no
`allowed_mentions`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/edit-message","input":{"channel_id":"123","message_id":"456","content":"updated"}}'

Discord: delete message

Delete a message where the bot has permission.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`message_id`	string	yes
`confirm`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/delete-message","input":{"channel_id":"123","message_id":"456","confirm":true}}'

Discord: add reaction

React to a message with Unicode or name:id custom emoji.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`message_id`	string	yes
`emoji`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/add-reaction","input":{"channel_id":"123","message_id":"456","emoji":"✅"}}'

Discord: remove reaction

Remove the bot’s reaction from a message.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`message_id`	string	yes
`emoji`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/remove-reaction","input":{"channel_id":"123","message_id":"456","emoji":"✅"}}'

Discord: list pins

List pinned messages in a channel.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`before`	string	no
`limit`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/list-pins","input":{"channel_id":"123"}}'

Discord: pin or unpin message

Set whether a message is pinned.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`message_id`	string	yes
`pinned`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/set-pin","input":{"channel_id":"123","message_id":"456","pinned":true}}'

Discord: list active threads

List active public and private threads visible to the bot.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/list-threads","input":{}}'

Discord: create thread or forum post

Create a thread, start one from a message, or create a forum post.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`channel_id`	string	yes
`name`	string	yes
`message_id`	string	no
`auto_archive_duration`	integer	no
`type`	integer	no
`invitable`	boolean	no
`message`	object	no
`applied_tags`	string[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/create-thread","input":{"channel_id":"123","name":"launch checklist"}}'

Discord: update thread

Rename, archive, unarchive, or lock a thread.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`thread_id`	string	yes
`name`	string	no
`archived`	boolean	no
`locked`	boolean	no
`auto_archive_duration`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/update-thread","input":{"thread_id":"123","archived":true}}'

Discord: join or leave thread

Add or remove the bot from a thread.

Bring your own key — connect Discord first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`guild_id`	string	no
`thread_id`	string	yes
`join`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"discord","endpoint":"/set-thread-membership","input":{"thread_id":"123","join":true}}'

Sentry

Your Sentry org: list and inspect issues + events, list projects and releases, resolve issues (bring your own auth token). (dev)

Sentry: organizations

List the organizations your token can access. Pass next_cursor back as cursor for the next page; Sentry’s owner, query and sortBy filters pass through.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`cursor`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/organizations","input":{}}'

Sentry: teams

Teams in the organization and the projects each owns.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/teams","input":{}}'

Sentry: members

People in the organization, with role and the teams they belong to.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/members","input":{}}'

Sentry: events across the org

Raw error events across every project, filterable with Sentry search syntax. Issues group events; this is the ungrouped stream underneath.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization_slug`	string	no
`query`	string	no
`statsPeriod`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/events","input":{"statsPeriod":"24h"}}'

Sentry: projects

List an organization’s projects.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization_slug`	string	no
`cursor`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/projects","input":{}}'

Sentry: issues

List issues. Defaults to is:unresolved; use query (e.g. ‘is:unresolved lastSeen:-24h’), sort, limit, cursor.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	no
`sort`	string	no
`limit`	integer	no
`cursor`	string	no
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/issues","input":{"query":"is:unresolved","limit":25}}'

Sentry: issue

Get one issue by id.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`issue_id`	string	yes
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/issue","input":{"issue_id":"123456"}}'

Sentry: issue events

List the events for an issue.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`issue_id`	string	yes
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/issue/events","input":{"issue_id":"123456"}}'

Sentry: latest event

The latest event (stacktrace, context) for an issue.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`issue_id`	string	yes
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/issue/latest_event","input":{"issue_id":"123456"}}'

Sentry: releases

List an organization’s releases.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`organization_slug`	string	no
`cursor`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/releases","input":{}}'

Sentry: update issue

Update an issue (status: resolved | unresolved | ignored, assignedTo, priority…).

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`issue_id`	string	yes
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/issue/update","input":{"issue_id":"123456","status":"resolved"}}'

Sentry: delete issue

Permanently delete an issue and its events. Sentry queues the work, so the call returns before the data is gone. To silence an issue without losing the history, update_issue with status ignored.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`issue_id`	string	yes
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/issue/delete","input":{"issue_id":"123456"}}'

Sentry: delete issues in bulk

Delete a list of issues in one call — cleaning up after a noisy deploy. issue_ids is required: Sentry’s id-less form of this endpoint would delete every issue matching the filters.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`issue_ids`	string[]	yes
`project`	string[]	no
`organization_slug`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/issues/delete","input":{"issue_ids":["123456","123457"]}}'

Sentry: raw request

Escape hatch: call any Sentry API path on your token (under /api/0). Returns next_cursor when paginated.

Bring your own key — connect Sentry first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sentry","endpoint":"/request","input":{"method":"GET","path":"/organizations/"}}'

Trakt

Track movies and TV: read and update your watchlist, watched history, and ratings, and search the catalog (connect your Trakt account). (data)

Trakt: current user

Confirm whose Trakt account the connected token acts as.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/user","input":{}}'

Trakt: watchlist

Your watchlist, optionally filtered by type (movies, shows, seasons, episodes).

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/watchlist","input":{"type":"movies","limit":25}}'

Trakt: watched history

What you’ve watched, newest first. Filter by type and/or a date range (start_at/end_at).

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`page`	integer	no
`limit`	integer	no
`start_at`	string	no
`end_at`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/history","input":{"type":"movies","limit":25}}'

Trakt: ratings

Your ratings (1-10), optionally filtered by type.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/ratings","input":{"type":"movies"}}'

Trakt: search

Search by text. type defaults to ‘movie,show’; returns matches with trakt/imdb/tmdb ids to use in the write tools.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`type`	string	no
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/search","input":{"query":"the matrix","type":"movie"}}'

Trakt: lists

Your personal lists. Paginated: Trakt returns a small first page by default, so pass page and limit.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/lists","input":{"limit":50}}'

Most-watched movies or shows right now. type=‘movies’ (default) or ‘shows’.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`page`	integer	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/trending","input":{"type":"movies","limit":10}}'

Trakt: recommendations

Personalized movie or show recommendations based on your history. type=‘movies’ (default) or ‘shows’; limit defaults to 10.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/recommendations","input":{"type":"movies","limit":10}}'

Trakt: add to watchlist

Add an item to your watchlist. Pass type + an id (imdb_id/tmdb_id/trakt_id/slug), or raw movies/shows/episodes arrays.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`imdb_id`	string	no
`tmdb_id`	integer	no
`trakt_id`	integer	no
`slug`	string	no
`movies`	object[]	no
`shows`	object[]	no
`seasons`	object[]	no
`episodes`	object[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/watchlist/add","input":{"type":"movie","imdb_id":"tt0133093"}}'

Trakt: remove from watchlist

Remove an item from your watchlist (same addressing as add).

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`imdb_id`	string	no
`tmdb_id`	integer	no
`trakt_id`	integer	no
`slug`	string	no
`movies`	object[]	no
`shows`	object[]	no
`seasons`	object[]	no
`episodes`	object[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/watchlist/remove","input":{"type":"movie","imdb_id":"tt0133093"}}'

Trakt: mark watched

Add an item to your watched history. Optional watched_at (ISO 8601, defaults to now). Same addressing as add-to-watchlist.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`imdb_id`	string	no
`tmdb_id`	integer	no
`trakt_id`	integer	no
`slug`	string	no
`movies`	object[]	no
`shows`	object[]	no
`seasons`	object[]	no
`episodes`	object[]	no
`watched_at`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/history/add","input":{"type":"movie","imdb_id":"tt0133093"}}'

Trakt: remove from history

Remove an item from your watched history (same addressing as mark-watched).

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`imdb_id`	string	no
`tmdb_id`	integer	no
`trakt_id`	integer	no
`slug`	string	no
`movies`	object[]	no
`shows`	object[]	no
`seasons`	object[]	no
`episodes`	object[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/history/remove","input":{"type":"movie","imdb_id":"tt0133093"}}'

Trakt: rate

Rate an item 1-10. Pass type + an id + rating, or raw arrays where each item carries its own rating.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`imdb_id`	string	no
`tmdb_id`	integer	no
`trakt_id`	integer	no
`slug`	string	no
`movies`	object[]	no
`shows`	object[]	no
`seasons`	object[]	no
`episodes`	object[]	no
`rating`	integer	no
`rated_at`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/rate","input":{"type":"movie","imdb_id":"tt0133093","rating":9}}'

Trakt: remove rating

Remove your rating from an item (same addressing as rate).

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`imdb_id`	string	no
`tmdb_id`	integer	no
`trakt_id`	integer	no
`slug`	string	no
`movies`	object[]	no
`shows`	object[]	no
`seasons`	object[]	no
`episodes`	object[]	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/rate/remove","input":{"type":"movie","imdb_id":"tt0133093"}}'

Trakt: raw request

Escape hatch: call any Trakt API endpoint on your token (host pinned to api.trakt.tv). Prefer the curated trakt tools when one fits.

Bring your own key — connect Trakt first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"trakt","endpoint":"/request","input":{"method":"GET","path":"/sync/watchlist/movies"}}'

TMDB

The Movie Database: search movies and TV, fetch rich details, images, trending, and recommendations, and resolve IMDb ids to TMDB records. (movies)

TMDB: search

Search movies, TV, and people. type=‘movie’|‘tv’|‘person’ narrows it (default searches all). Returns TMDB ids + poster_path. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`type`	string	no
`year`	integer	no
`page`	integer	no
`include_adult`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/search","input":{"query":"the matrix","type":"movie"}}'

TMDB: movie details

Full movie detail by TMDB id: overview, runtime, genres, plus credits, videos, images, external_ids (imdb_id), and watch providers. Cost: 5 credits per call

Parameter	Type	Required
`id`	integer	string	yes
`append_to_response`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/movie","input":{"id":603}}'

TMDB: TV details

Full TV-show detail by TMDB id: overview, seasons, genres, plus credits, videos, images, external_ids, and watch providers. Cost: 5 credits per call

Parameter	Type	Required
`id`	integer	string	yes
`append_to_response`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/tv","input":{"id":1396}}'

Trending titles. media_type=‘all’(default)|‘movie’|‘tv’|‘person’, time_window=‘day’|‘week’(default). Cost: 5 credits per call

Parameter	Type	Required
`media_type`	string	no
`time_window`	string	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/trending","input":{"media_type":"movie","time_window":"week"}}'

TMDB: find by external id

Map an external id to TMDB records. Defaults to IMDb (external_source=‘imdb_id’), pass an imdb_id like tt0133093. Bridges trakt to TMDB. Cost: 5 credits per call

Parameter	Type	Required
`external_id`	string	no
`imdb_id`	string	no
`external_source`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/find","input":{"imdb_id":"tt0133093"}}'

TMDB: discover

Browse movies or TV by filters (with_genres, primary_release_year, sort_by, vote_average.gte, …). type=‘movie’(default)|‘tv’. Cost: 5 credits per call

Parameter	Type	Required
`type`	string	no
`with_genres`	string	no
`sort_by`	string	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/discover","input":{"type":"movie","with_genres":"878","sort_by":"popularity.desc"}}'

TMDB: recommendations

Recommended (or similar=true) titles for a movie/TV id. type=‘movie’(default)|‘tv’. Cost: 5 credits per call

Parameter	Type	Required
`id`	integer	string	yes
`type`	string	no
`similar`	boolean	no
`page`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/recommendations","input":{"id":603,"type":"movie"}}'

TMDB: raw request

Escape hatch: call any TMDB v3 endpoint (host pinned to api.themoviedb.org). Prefer the curated tmdb tools. Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`method`	string	no
`query`	object	no
`body`	object	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"tmdb","endpoint":"/request","input":{"path":"/3/movie/603/keywords"}}'

PVR INOX

India’s largest cinema chain: what’s playing and coming soon, showtimes near you, seat availability and ticket prices across 116 cities. (movies)

PVR: cities

The 116 Indian cities PVR INOX operates in, with coordinates and cinema counts. Filter by name/state (query) or region (NORTH/SOUTH/EAST/WEST). Cost: 10 credits per call

Parameter	Type	Required
`query`	string	no
`region`	string	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"pvr","endpoint":"/cities","input":{"query":"bang"}}'

PVR: cinemas

Cinemas in a city with distance and show counts. film keeps only cinemas showing that title. Distance is measured from lat/lng — pass your own, because a city’s stored coordinates are not always its centre (Bengaluru’s sit ~20 km out). full=true adds every film playing at each cinema, which is most of the response. Cost: 10 credits per call

Parameter	Type	Required
`city`	string	yes
`lat`	string	no
`lng`	string	no
`query`	string	no
`film`	string	no
`max_distance_km`	number	no
`full`	boolean	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"pvr","endpoint":"/cinemas","input":{"city":"Mumbai","film":"odyssey"}}'

PVR: movies

Films in a city — status=‘now_showing’ (default), ‘coming_soon’ for the release calendar (dates, cast, director, synopsis, trailer), or ‘all’. Filter by query, language, genre, or experience (imax, 4dx, luxe). The city’s premium formats come back in exp; full=true adds its cinemas and the long-form format list, ~1.4MB that pvr.cinemas serves better. Cost: 10 credits per call

Parameter	Type	Required
`city`	string	yes
`status`	string	no
`query`	string	no
`language`	string	no
`genre`	string	no
`experience`	string	no
`full`	boolean	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"pvr","endpoint":"/movies","input":{"city":"Mumbai","status":"coming_soon","language":"Tamil"}}'

PVR: showtimes

Showtimes across a city or near a point, one block per cinema. date is YYYY-MM-DD (today if omitted; other dates cost one upstream call per cinema, so narrow them with film). Filter by film, language, experience (imax/4dx/luxe), time window (after/before, ‘18:00’ or ‘6:00 PM’), available_only (drops Sold Out and already-started Lapsed shows), accessible_only. A whole city is covered by default; pass lat/lng or cinema_id to stay local. Each show carries an encrypted token for pvr.seats and pvrcinemas.com/seatlayout/<token>. full=true re-attaches each cinema’s whole film list, which is ~85% of the bytes and already answered by the showtimes themselves. Cost: 15 credits per call

Parameter	Type	Required
`city`	string	yes
`date`	string	no
`cinema_id`	string	no
`lat`	string	no
`lng`	string	no
`film`	string	no
`language`	string	no
`experience`	string	no
`after`	string	no
`before`	string	no
`available_only`	boolean	no
`accessible_only`	boolean	no
`max_distance_km`	number	no
`all_cinemas`	boolean	no
`full`	boolean	no
`limit`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"pvr","endpoint":"/showtimes","input":{"city":"Mumbai","date":"2026-08-21","film":"odyssey","experience":"imax"}}'

PVR: cinema schedule

One cinema’s schedule plus days, the dates open for booking — the way to tell whether a booking window has opened. Omit date for today’s shows and the whole window in one call; a date not yet on sale answers status 500 with output null. Cost: 10 credits per call

Parameter	Type	Required
`city`	string	yes
`cinema_id`	string	yes
`date`	string	no
`film`	string	no
`language`	string	no
`experience`	string	no
`after`	string	no
`before`	string	no
`available_only`	boolean	no
`accessible_only`	boolean	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"pvr","endpoint":"/cinema","input":{"city":"Mumbai","cinema_id":"540"}}'

PVR: seats and prices

Seat map and ticket prices for one show, from the encrypted token pvr.showtimes returns. priceList gives each class’s price, convenience fee and GST; in the rows, s=1 is free and s=2 is taken. Cost: 10 credits per call

Parameter	Type	Required
`token`	string	yes
`city`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"pvr","endpoint":"/seats","input":{"token":"NmhqEITuzBQGXMP30uW88g=="}}'

Conductor

Conductor cloud workspaces: run Claude Code, Codex or Cursor on a repo, send prompts, read transcripts, and manage the workspaces they run in. (dev)

Conductor: whoami

The Conductor account the connected key belongs to: user id, email, organization, and how it authenticated.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/me","input":{}}'

Conductor: projects

Repositories you can create workspaces in. Start here — creating a workspace needs a projectId. Paginated with limit/offset.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/projects","input":{"limit":20}}'

Conductor: project

One project by id, with its name and git remote.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/project","input":{"project_id":"prj_123"}}'

Conductor: project workspaces

Workspaces belonging to one project. Paginated with limit/offset.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`project_id`	string	yes
`limit`	integer	no
`offset`	integer	no
`channel`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/project/workspaces","input":{"project_id":"prj_123"}}'

Conductor: workspace

One workspace: name, project, creator, last activity, and a deepLink that opens it in the Conductor app.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`workspace_id`	string	yes
`channel`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/workspace","input":{"workspace_id":"wsp_123"}}'

Conductor: workspace status

Lifecycle state of a workspace: initializing, ready, sleeping, archived, deleted or updating, plus the current step and any error. Poll this after creating one.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`workspace_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/workspace/status","input":{"workspace_id":"wsp_123"}}'

Conductor: workspace sessions

The agent chat sessions inside a workspace. Paginated with limit/offset.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`workspace_id`	string	yes
`limit`	integer	no
`offset`	integer	no
`channel`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/workspace/sessions","input":{"workspace_id":"wsp_123"}}'

Conductor: session

One session: its agent, requested and resolved model, effort, fast mode, and whether it is archived.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`session_id`	string	yes
`channel`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/session","input":{"session_id":"ses_123"}}'

Conductor: session status

Whether the agent is idle, working or errored, with the last error. This is how you tell a turn has finished.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`session_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/session/status","input":{"session_id":"ses_123"}}'

Conductor: session transcript

Messages in a session. Pass after with the last message id you saw to poll for only what is new, rather than re-reading the transcript.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`session_id`	string	yes
`after`	string	no
`limit`	integer	no
`offset`	integer	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/messages","input":{"session_id":"ses_123","limit":50}}'

Conductor: message

A single message by id, with its type, content and position in the session.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`message_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/message","input":{"message_id":"msg_123"}}'

Conductor: search transcripts

Run one read-only SELECT over your organization’s agent transcripts. Only the view session_transcripts_view is readable — columns include session_id, workspace_id, transcript, session_title, agent_type and model. Use it to find which past session touched something.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/sql","input":{"query":"SELECT session_id, session_title FROM session_transcripts_view WHERE transcript ILIKE '%migration%' LIMIT 10"}}'

Conductor: create workspace

Start a cloud workspace on a repo and open its first session, optionally queueing a first prompt. Pass either projectId or repositoryUrl. agent: claude | codex | cursor | acp; models — claude: fable-5-1, fable-5, opus-5-5-1m, opus-5-1m, opus-4-8-1m, opus-4-8, opus-4-7-1m, opus-4-7, opus-4-6-1m, sonnet-5-1m, sonnet-4-6-1m, sonnet-4-6, haiku-4-5; codex: gpt-5.5, gpt-5.4, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.3-codex-spark, gpt-5.3-codex, gpt-5.2-codex, gpt-6-astra, gpt-6-sol, gpt-6-luna, gpt-daybreak-blue-latest; cursor: auto, composer-2.5, grok-4.7, grok-4.6, grok-4.5; effort — claude: low|medium|high|xhigh|max; codex: none|low|medium|high|xhigh|max|ultra (max and ultra only on models that support them); cursor: low|medium|high|xhigh. Defaults to high. Returns workspaceId, sessionId and a deepLink. Not idempotent: a retried call creates a second workspace.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`projectId`	string	no
`repositoryUrl`	string	no
`branch`	string	no
`name`	string	no
`sessionName`	string	no
`message`	string	no
`env`	object	no
`agent`	string	no
`model`	string	no
`effort`	string	no
`fastMode`	boolean	no
`channel`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/create_workspace","input":{"projectId":"prj_123","name":"fix-login","agent":"claude","model":"opus-5-1m","message":"fix the login redirect"}}'

Conductor: rename workspace

Rename a workspace.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`workspace_id`	string	yes
`name`	string	yes
`channel`	string	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/rename_workspace","input":{"workspace_id":"wsp_123","name":"login-fix"}}'

Conductor: archive workspace

Archive a workspace once its work is done. Reversible with conductor.unarchive_workspace.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`workspace_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/archive_workspace","input":{"workspace_id":"wsp_123"}}'

Conductor: unarchive workspace

Bring an archived workspace back to ready.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`workspace_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/unarchive_workspace","input":{"workspace_id":"wsp_123"}}'

Conductor: sleep workspace

Put a workspace to sleep to stop its machine, keeping the files. It wakes on next use.

Bring your own key — connect Conductor first (POST /v1/connections); the call runs on your own key. See the API reference → Connections.

Cost: 5 credits per call

Parameter	Type	Required
`workspace_id`	string	yes
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"conductor","endpoint":"/sleep_workspace","input":{"workspace_id":"wsp_123"}}'

Conductor: create session

Bring your own key — connect Conductor first (<

​Exa

​Search

​Jina

​Read

​Search

​Firecrawl

​Scrape

​Search

​OpenWeather

​Current weather

​Context.dev

​Brand data

​NAICS code

​SIC code

​Logo.dev

​Brand search

​Ahrefs

​Domain Rating

​Top sites by DR

​TinyFish

​Search the web

​Fetch pages as text

​Artificial Analysis

​Benchmark language models

​Rank image, video, speech, and music models

​Brave Search

​Search the web

​Search the news

​Search for images

​Search for videos

​OpenRouter

​Which models people actually use

​Top AI apps by token usage

​What people use AI for

​What a coding session costs

​Benchmark scores from several sources

​Ask another model

​Create a model response

​Create embeddings

​Browse OpenRouter models

​OpenRouter model details

​OpenRouter model providers

​Browse embedding models

​OpenRouter balance

​OpenRouter key limits

​Groq

​Chat completion

​Create a model response

​Create text embeddings

​Transcribe audio

​Translate audio into English

​Speak text

​Available models

​Model details

​Vercel AI Gateway

​Which AI models people actually run

​Every model on AI Gateway, with pricing

​One model’s specs and price

​Which provider is fastest for a model right now

​Every provider route, with prices

​SubmitForBacklinks

​Scan a product site

​Free launch weeks

​My submissions

​Get a submission

​Create a draft or submit

​Edit a submission

​Submit a draft for review

​Featured checkout link

​Badge status

​Issue a badge

​Verify badge installation

​ScrollLaunch

​Startup directories by DR

​Search launched products

​Weekly launch leaderboard

​Get a launched product

​DEV Community

​Publish an article

​Update an article

Exa

Search

Jina

Read

Search

Firecrawl

Scrape

Search

OpenWeather

Current weather

Context.dev

Brand data

NAICS code

SIC code

Logo.dev

Brand search

Ahrefs

Domain Rating

Top sites by DR

TinyFish

Search the web

Fetch pages as text

Artificial Analysis

Benchmark language models

Rank image, video, speech, and music models

Brave Search

Search the web

Search the news

Search for images

Search for videos

OpenRouter

Which models people actually use

Top AI apps by token usage

What people use AI for

What a coding session costs

Benchmark scores from several sources

Ask another model

Create a model response

Create embeddings

Browse OpenRouter models

OpenRouter model details

OpenRouter model providers

Browse embedding models

OpenRouter balance

OpenRouter key limits

Groq

Chat completion

Create a model response

Create text embeddings

Transcribe audio

Translate audio into English

Speak text

Available models

Model details

Vercel AI Gateway

Which AI models people actually run

Every model on AI Gateway, with pricing

One model’s specs and price

Which provider is fastest for a model right now

Every provider route, with prices

SubmitForBacklinks

Scan a product site

Free launch weeks

My submissions

Get a submission

Create a draft or submit

Edit a submission

Submit a draft for review

Featured checkout link

Badge status

Issue a badge

Verify badge installation

ScrollLaunch

Startup directories by DR

Search launched products

Weekly launch leaderboard

Get a launched product

DEV Community

Publish an article

Update an article