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. Cost: 10 to 100 credits

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":"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

What the AI market is actually doing: token volume per model, the apps sending it, what people use models for, what a coding session costs, and benchmark scores from several sources. Plus a prompt to any model OpenRouter carries, on your own key. (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 a prompt through any model OpenRouter carries, on your own OpenRouter key and your own balance: a second opinion from a model that is not the one reading this, or a cheap model for bulk work. Every OpenAI chat field passes through (temperature, tools, response_format). No streaming; the response comes back whole.

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
`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":"openai/gpt-5.6","messages":[{"role":"user","content":"In one sentence: what breaks first when a Postgres table has no index?"}]}}'

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, author or state. No account needed. Cost: 5 credits per call

Parameter	Type	Required
`tag`	string	no
`tags`	string	no
`username`	string	no
`state`	string	no
`top`	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, threaded as DEV returns it. Cost: 5 credits per call

Parameter	Type	Required
`a_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":"/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. Cost: 1 credit per call

Parameter	Type	Required
`q`	string	no
`category`	string	no
`tag`	string	no
`limit`	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. Cost: 5 credits per call

Parameter	Type	Required
`url`	string	yes
`extract_links`	boolean	no
`max_urls`	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).

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).

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.

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.

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.

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.

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
`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.

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
(other 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).

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
(other 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.

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
(other 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).

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
(other 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).

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
(other 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.

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
(other 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.

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
(other 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.

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

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.

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
`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). Cost: 5 credits per call

Parameter	Type	Required
`login`	string	yes
`first`	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":"/repos","input":{"login":"torvalds"}}'

GitHub: search

Search repositories, users, or issues (type = repository|user|issue). Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`type`	string	no
`first`	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":"/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 (state=open|closed|all, labels). Includes PRs. Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`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":"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). Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`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":"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). Cost: 5 credits per call

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`sha`	string	no
`path`	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":"/commits","input":{"repo":"facebook/react"}}'

GitHub: releases

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

Parameter	Type	Required
`repo`	string	yes
`owner`	string	no
`latest`	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":"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). 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=). 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). 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). 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). 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, 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, or one by pipeline_id (status, ref). 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).

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). 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}}}'

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 — database, auth, storage, realtime.

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":"/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 (optional sql + iso_timestamp_start/end filters).

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":"/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 zones and DNS: list zones, manage DNS records, purge cache (account-owned API token + account id). (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"}}'

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.

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

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.

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":"/lists","input":{}}'

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’.

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, 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; cursor: auto, composer-2.5, grok-4.6, grok-4.5; effort — claude: low|medium|high|xhigh|max; codex: none|low|medium|high|xhigh|max|ultra (max needs a gpt-5.6 model, ultra needs sol or terra). 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

Open another agent chat in an existing workspace — a second agent on the same files. agent: claude | codex | cursor | acp; models — claude: fable-5, 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; cursor: auto, composer-2.5, grok-4.6, grok-4.5; effort — claude: low|medium|high|xhigh|max; codex: none|low|medium|high|xhigh|max|ultra (max needs a gpt-5.6 model, ultra needs sol or terra). Defaults to high.

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
`workspaceId`	string	yes
`sessionId`	string	no
`name`	string	no
`message`	string	no
`messageId`	string	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_session","input":{"workspaceId":"wsp_123","agent":"codex","model":"gpt-5.5","message":"review the diff"}}'

Conductor: rename session

Rename a 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
`session_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_session","input":{"session_id":"ses_123","name":"review pass"}}'

Conductor: archive session

Archive a session. Any messages still queued for it are cancelled, and the count comes back in the response.

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":"/archive_session","input":{"session_id":"ses_123"}}'

Conductor: send prompt

Send a prompt to the agent in a session. Answers state ‘sent’, or ‘queued’ when the agent is mid-turn. Pass your own messageId to make a retry idempotent.

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
`message`	string	yes
`messageId`	string	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":"/send_message","input":{"session_id":"ses_123","message":"run the tests and fix what fails"}}'

Conductor: cancel turn

Stop the agent’s current turn and drop anything queued behind it. The work already written to the workspace stays.

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":"/cancel_session","input":{"session_id":"ses_123"}}'

crt.name

Subdomains for any domain, indexed from Certificate Transparency logs. (dev)

Subdomains for a domain

Every subdomain on file for an apex domain, from Certificate Transparency, each with the date it was first seen. apex must be the registrable domain (example.com, not sub.example.com). Returns total alongside the page; limit defaults to 500, max 5000. This is a history of names that were ever certificated, so some no longer resolve, and anything never issued a certificate of its own is absent. Cost: 10 credits per call

Parameter	Type	Required
`apex`	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":"crtname","endpoint":"/subdomains","input":{"apex":"vercel.com"}}'

Clerk

your clerk instance: users, organizations, sessions, invitations (bring your own secret key). (dev)

Clerk: users

List users (filter by query, email_address, user_id, order_by).

Bring your own key — connect Clerk 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":"clerk","endpoint":"/users","input":{"limit":10}}'

Clerk: user

Get one user by id.

Bring your own key — connect Clerk 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":"clerk","endpoint":"/user","input":{"user_id":"user_123"}}'

Clerk: organizations

List organizations (filter by query, order_by).

Bring your own key — connect Clerk 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":"clerk","endpoint":"/organizations","input":{"limit":10}}'

Clerk: organization

Get one organization by id or slug.

Bring your own key — connect Clerk 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":"clerk","endpoint":"/organization","input":{"organization_id":"org_123"}}'

Clerk: organization memberships

List the memberships of an organization.

Bring your own key — connect Clerk 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":"clerk","endpoint":"/organization/memberships","input":{"organization_id":"org_123","limit":10}}'

Clerk: sessions

List sessions (filter by user_id, client_id, status).

Bring your own key — connect Clerk 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	no
`client_id`	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":"clerk","endpoint":"/sessions","input":{"limit":10}}'

Clerk: session

Get one session by id.

Bring your own key — connect Clerk 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":"clerk","endpoint":"/session","input":{"session_id":"sess_123"}}'

Clerk: create user

Create a user (email_address[], password, first_name, username, …).

Bring your own key — connect Clerk 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":"clerk","endpoint":"/users/create","input":{"email_address":["jane@example.com"],"password":"s3cret-passphrase"}}'

Clerk: update user

Update a user by id (first_name, username, public_metadata, …).

Bring your own key — connect Clerk 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":"clerk","endpoint":"/users/update","input":{"user_id":"user_123","first_name":"Jane"}}'

Clerk: ban user

Ban a user by id (also revokes their sessions).

Bring your own key — connect Clerk 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":"clerk","endpoint":"/users/ban","input":{"user_id":"user_123"}}'

Clerk: delete user

Delete a user by id (permanent).

Bring your own key — connect Clerk 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":"clerk","endpoint":"/users/delete","input":{"user_id":"user_123"}}'

Clerk: revoke session

Revoke a session by id (signs the user out of it).

Bring your own key — connect Clerk 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":"clerk","endpoint":"/sessions/revoke","input":{"session_id":"sess_123"}}'

Clerk: raw request

Escape hatch: call any Clerk Backend API endpoint on your key (JSON). path required, method default GET.

Bring your own key — connect Clerk 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":"clerk","endpoint":"/request","input":{"method":"GET","path":"/users","query":{"limit":1}}}'

Buffer

schedule and manage social posts across your connected channels — list channels, create/edit/schedule posts, read analytics (bring your own buffer api key) (social)

Buffer: account

The Buffer account your key authenticates as, and its organizations (with organizationId).

Bring your own key — connect Buffer 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":"buffer","endpoint":"/account","input":{}}'

Buffer: channels

List connected channels (social profiles) for an organization; gives the channel_id posts need.

Bring your own key — connect Buffer 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	no
(other provider fields)	any	no

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

Buffer: posts

List posts for an organization (Relay-paginated); filter by channel_ids or status.

Bring your own key — connect Buffer 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	no
`channel_ids`	string[]	no
`status`	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":"buffer","endpoint":"/posts","input":{"status":"sent"}}'

Buffer: post metrics

Aggregate post analytics over a time window (ISO start/end), optionally per channel.

Bring your own key — connect Buffer 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`	string	yes
`end`	string	yes
`organization_id`	string	no
`channel_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":"buffer","endpoint":"/post-metrics","input":{"start":"2026-06-01T00:00:00.000Z","end":"2026-07-01T00:00:00.000Z"}}'

Buffer: create post

Schedule a post to a channel (needs a channel_id; list channels first). mode: addToQueue/shareNext/shareNow/customScheduled.

Bring your own key — connect Buffer 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	no
`text`	string	no
`scheduling_type`	string	no
`mode`	string	no
`due_at`	string	no
`tag_ids`	string[]	no
`assets`	object[]	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":"buffer","endpoint":"/posts/create","input":{"channel_id":"<channel-id>","text":"Hello from fetchbean"}}'

Buffer: update post

Edit an existing post by its id (get it from buffer.posts).

Bring your own key — connect Buffer 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
`text`	string	no
`scheduling_type`	string	no
`mode`	string	no
`due_at`	string	no
`tag_ids`	string[]	no
`assets`	object[]	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":"buffer","endpoint":"/posts/update","input":{"id":"<post-id>","text":"Updated copy"}}'

Buffer: delete post

Delete a post by its id.

Bring your own key — connect Buffer 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":"buffer","endpoint":"/posts/delete","input":{"id":"<post-id>"}}'

Buffer: raw GraphQL

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

Bring your own key — connect Buffer 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":"buffer","endpoint":"/request","input":{"query":"query { account { id email } }"}}'

Bluesky

read and post to your bluesky account: home timeline, profile, notifications, post search; create/delete posts, like, repost, follow (bring your own app password) (social)

Bluesky: profile

A profile with follower/following/post counts: the connected account by default, or any actor (handle or did).

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

Cost: 5 credits per call

Parameter	Type	Required
`actor`	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":"bluesky","endpoint":"/actor/get-profile","input":{}}'

Bluesky: timeline

The connected account’s home timeline (the following feed), paginated with a cursor.

Bring your own key — connect Bluesky 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
`algorithm`	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":"bluesky","endpoint":"/feed/timeline","input":{"limit":25}}'

Bluesky: author feed

Posts authored by an actor (the connected account by default). filter e.g. posts_no_replies, posts_with_media.

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

Cost: 5 credits per call

Parameter	Type	Required
`actor`	string	no
`limit`	integer	no
`cursor`	string	no
`filter`	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":"bluesky","endpoint":"/feed/author","input":{}}'

Bluesky: notifications

The connected account’s notifications (likes, reposts, replies, follows, mentions, quotes).

Bring your own key — connect Bluesky 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
`reasons`	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":"bluesky","endpoint":"/notifications","input":{"limit":25}}'

Bluesky: search posts

Full-text search across public posts. sort: top | latest. Scope with author (handle or did).

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

Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`limit`	integer	no
`cursor`	string	no
`sort`	string	no
`author`	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":"bluesky","endpoint":"/feed/search-posts","input":{"q":"atproto","sort":"latest"}}'

Bluesky: post

Post to the connected account. Reply by passing reply_to {uri,cid}. Bare URLs aren’t auto-linked, pass facets to make them clickable.

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

Cost: 5 credits per call

Parameter	Type	Required
`text`	string	no
`langs`	string[]	no
`reply_to`	object	no
`reply_root`	object	no
`facets`	object[]	no
`embed`	object	no
`created_at`	string	no
`record`	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":"bluesky","endpoint":"/post/create","input":{"text":"Hello from fetchbean 🫘"}}'

Bluesky: delete post

Delete one of your own posts by its at:// uri (from author_feed) or its rkey.

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

Cost: 5 credits per call

Parameter	Type	Required
`uri`	string	no
`rkey`	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":"bluesky","endpoint":"/post/delete","input":{"uri":"at://did:plc:.../app.bsky.feed.post/3k..."}}'

Bluesky: like

Like a post by its uri + cid (both come from a timeline/search result).

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

Cost: 5 credits per call

Parameter	Type	Required
`uri`	string	yes
`cid`	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":"bluesky","endpoint":"/like","input":{"uri":"at://did:plc:.../app.bsky.feed.post/3k...","cid":"bafy..."}}'

Bluesky: repost

Repost a post by its uri + cid.

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

Cost: 5 credits per call

Parameter	Type	Required
`uri`	string	yes
`cid`	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":"bluesky","endpoint":"/repost","input":{"uri":"at://did:plc:.../app.bsky.feed.post/3k...","cid":"bafy..."}}'

Bluesky: follow

Follow an actor by handle or did.

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

Cost: 5 credits per call

Parameter	Type	Required
`actor`	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":"bluesky","endpoint":"/follow","input":{"actor":"bsky.app"}}'

Bluesky: raw XRPC

Escape hatch: call any XRPC method on the connected account’s PDS. Prefer the curated bluesky tools when one fits.

Bring your own key — connect Bluesky 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`	string	no
`params`	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":"bluesky","endpoint":"/request","input":{"method":"app.bsky.actor.getPreferences"}}'

Render

Your Render infrastructure: services, deploys, logs, metrics, workspaces, and deploy controls (bring your own API key). (dev)

Render: current user

Get the Render user associated with the connected API key.

Bring your own key — connect Render 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":"render","endpoint":"/user","input":{}}'

Render: workspaces

List workspaces the connected API key can access.

Bring your own key — connect Render 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
`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":"render","endpoint":"/workspaces","input":{"limit":20}}'

Render: workspace

Retrieve one workspace by id.

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

Cost: 5 credits per call

Parameter	Type	Required
`owner_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":"render","endpoint":"/workspace","input":{"owner_id":"tea-..."}}'

Render: services

List services, databases, workers, cron jobs, and static sites. Filter by ownerId, name, type, region, etc.

Bring your own key — connect Render 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
`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":"render","endpoint":"/services","input":{"limit":20}}'

Render: service

Retrieve one Render service by id.

Bring your own key — connect Render 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_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":"render","endpoint":"/service","input":{"service_id":"srv-..."}}'

Render: deploys

List deploys for a service, with optional status and date filters.

Bring your own key — connect Render 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_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":"render","endpoint":"/deploys","input":{"service_id":"srv-...","limit":10}}'

Render: deploy

Retrieve one deploy for a service.

Bring your own key — connect Render 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_id`	string	yes
`deploy_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":"render","endpoint":"/deploy","input":{"service_id":"srv-...","deploy_id":"dep-..."}}'

Render: events

List recent events for a service.

Bring your own key — connect Render 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_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":"render","endpoint":"/events","input":{"service_id":"srv-...","limit":20}}'

Render: custom domains

List custom domains for a web service or static site.

Bring your own key — connect Render 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_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":"render","endpoint":"/custom-domains","input":{"service_id":"srv-..."}}'

Render: logs

Query service, Postgres, and key value logs using Render’s log filters.

Bring your own key — connect Render 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
`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":"render","endpoint":"/logs","input":{"limit":100}}'

Render: metrics

Fetch one Render metric series such as cpu, memory, http-requests, or bandwidth.

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

Cost: 5 credits per call

Parameter	Type	Required
`metric`	string	string	string	string	string	string	string	string	string	string	string	string	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":"render","endpoint":"/metrics","input":{"metric":"memory","resourceId":"srv-..."}}'

Render: trigger deploy

Trigger a deploy for a service. Supports clearCache, commitId, imageUrl, and deployMode.

Bring your own key — connect Render 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_id`	string	yes
`clearCache`	string	string	no
`commitId`	string	no
`imageUrl`	string	no
`deployMode`	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":"render","endpoint":"/deploys/trigger","input":{"service_id":"srv-...","clearCache":"do_not_clear"}}'

Render: cancel deploy

Cancel an in-progress deploy for a service.

Bring your own key — connect Render 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_id`	string	yes
`deploy_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":"render","endpoint":"/deploys/cancel","input":{"service_id":"srv-...","deploy_id":"dep-..."}}'

Render: rollback

Trigger a rollback to a previous deploy. Auto-deploy can still redeploy newer changes later.

Bring your own key — connect Render 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_id`	string	yes
`deploy_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":"render","endpoint":"/deploys/rollback","input":{"service_id":"srv-...","deploy_id":"dep-..."}}'

Render: restart service

Restart a Render service.

Bring your own key — connect Render 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_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":"render","endpoint":"/service/restart","input":{"service_id":"srv-..."}}'

Render: purge cache

Purge a web service cache if caching is enabled.

Bring your own key — connect Render 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_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":"render","endpoint":"/service/purge-cache","input":{"service_id":"srv-..."}}'

Render: suspend service

Take a service offline without deleting it — it stops serving and stops billing compute. Reversible with resume_service.

Bring your own key — connect Render 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_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":"render","endpoint":"/service/suspend","input":{"service_id":"srv-..."}}'

Render: resume service

Bring a suspended service back online.

Bring your own key — connect Render 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_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":"render","endpoint":"/service/resume","input":{"service_id":"srv-..."}}'

Render: scale service

Set a fixed instance count. Render ignores this while autoscaling is on, and scaling costs money per instance.

Bring your own key — connect Render 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_id`	string	yes
`numInstances`	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":"render","endpoint":"/service/scale","input":{"service_id":"srv-...","numInstances":2}}'

Render: delete service

Permanently delete a service with its deploy history, env vars and secret files. No undo. To stop it without losing it, suspend_service instead.

Bring your own key — connect Render 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_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":"render","endpoint":"/service/delete","input":{"service_id":"srv-..."}}'

Render: remove a custom domain

Detach a custom domain from a service — traffic to it stops resolving. Pass the domain id or the name itself.

Bring your own key — connect Render 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_id`	string	yes
`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":"render","endpoint":"/service/custom-domains/delete","input":{"service_id":"srv-...","domain":"app.example.com"}}'

Render: environment variables

A service’s own env vars, values included in plaintext — treat the response as secret. Vars from a linked environment group are not listed here.

Bring your own key — connect Render 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_id`	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":"render","endpoint":"/service/env-vars","input":{"service_id":"srv-..."}}'

Render: set an environment variable

Add or overwrite one env var on a service. Overwrites silently, and the service picks it up on its next deploy. Pass generateValue ‘yes’ to have Render generate the value instead.

Bring your own key — connect Render 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_id`	string	yes
`key`	string	yes
`value`	string	no
`generateValue`	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":"render","endpoint":"/service/env-vars/set","input":{"service_id":"srv-...","key":"LOG_LEVEL","value":"debug"}}'

Render: delete an environment variable

Remove one env var from a service. The running instance keeps it until the next deploy.

Bring your own key — connect Render 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_id`	string	yes
`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":"render","endpoint":"/service/env-vars/delete","input":{"service_id":"srv-...","key":"LOG_LEVEL"}}'

Render: secret files

A service’s secret files with their contents — treat the response as secret.

Bring your own key — connect Render 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_id`	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":"render","endpoint":"/service/secret-files","input":{"service_id":"srv-..."}}'

Render: write a secret file

Add or overwrite one secret file on a service. Overwrites silently; the service sees it on its next deploy.

Bring your own key — connect Render 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_id`	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":"render","endpoint":"/service/secret-files/set","input":{"service_id":"srv-...","name":"credentials.json","content":"{}"}}'

Render: delete a secret file

Remove one secret file from a service.

Bring your own key — connect Render 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_id`	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":"render","endpoint":"/service/secret-files/delete","input":{"service_id":"srv-...","name":"credentials.json"}}'

Render: raw request

Escape hatch: call any Render REST API path on your API key, including secret-bearing and destructive endpoints.

Bring your own key — connect Render 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":"render","endpoint":"/request","input":{"method":"GET","path":"/services","query":{"limit":1}}}'

Cal.com

Your cal.com scheduling: event types, availability, and bookings (create, list, cancel). (productivity)

Account

The connected cal.com account (id, email, username, timezone).

Bring your own key — connect Cal.com 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":"cal","endpoint":"/me","input":{}}'

Event types

Your cal.com event types (id, title, slug, length). The eventTypeId here is what you book against.

Bring your own key — connect Cal.com 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":"cal","endpoint":"/event-types","input":{}}'

Bookings

List your bookings (filter by status or attendeeEmail; paginate with take/skip).

Bring your own key — connect Cal.com 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`	string	no
`take`	integer	no
`skip`	integer	no
`attendeeEmail`	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":"cal","endpoint":"/bookings","input":{"take":10}}'

Available slots

Open time slots for an event type between start and end (dates). Book one with create_booking.

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

Cost: 5 credits per call

Parameter	Type	Required
`eventTypeId`	integer	no
`username`	string	no
`eventTypeSlug`	string	no
`start`	string	yes
`end`	string	yes
`timeZone`	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":"cal","endpoint":"/slots","input":{"eventTypeId":657686,"start":"2026-07-10","end":"2026-07-12"}}'

Create booking

Book a meeting: pass start (ISO 8601 UTC), eventTypeId (or username + eventTypeSlug), and attendee {name, email, timeZone}.

Bring your own key — connect Cal.com 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`	string	yes
`eventTypeId`	integer	no
`username`	string	no
`eventTypeSlug`	string	no
`attendee`	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":"cal","endpoint":"/bookings/create","input":{"start":"2026-07-10T14:00:00.000Z","eventTypeId":657686,"attendee":{"name":"Jane Doe","email":"jane@example.com","timeZone":"America/New_York"}}}'

Cancel booking

Cancel a booking by its uid (from bookings), with an optional cancellationReason.

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

Cost: 5 credits per call

Parameter	Type	Required
`bookingUid`	string	no
`uid`	string	no
`cancellationReason`	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":"cal","endpoint":"/bookings/{uid}/cancel","input":{"bookingUid":"guuuKjY2o51bTgox1NACNQ","cancellationReason":"no longer needed"}}'

Canny

Your Canny feedback boards and ideas: read posts, votes, insights and linked deals, file and triage requests, and publish changelog entries. (customer-support)

Boards

Your Canny boards (id, name, post count). The boardID here is what you filter and post against.

Bring your own key — connect Canny 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":"canny","endpoint":"/boards","input":{}}'

Posts

Feedback posts: search, filter by board/status/tag, sort by score, trending, newest or statusChanged. Statuses: open, under review, planned, in progress, complete, closed.

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

Cost: 5 credits per call

Parameter	Type	Required
`boardID`	string	no
`search`	string	no
`status`	string	no
`sort`	string	no
`limit`	integer	no
`skip`	integer	no
`tagIDs`	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":"canny","endpoint":"/posts","input":{"status":"open","sort":"score","limit":20}}'

Post

One post in full by its id: details, status, score, author, tags.

Bring your own key — connect Canny 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":"canny","endpoint":"/posts/retrieve","input":{"id":"<post-id>"}}'

Comments

Comments, filtered by post, board, author or company. Paginate with the returned cursor.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	no
`boardID`	string	no
`authorID`	string	no
`companyID`	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":"canny","endpoint":"/comments","input":{"postID":"<post-id>"}}'

Votes

Who voted on a post — the account behind demand, useful for follow-ups when it ships. Filter by post, board, company or user.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	no
`boardID`	string	no
`companyID`	string	no
`userID`	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":"canny","endpoint":"/votes","input":{"postID":"<post-id>"}}'

Users

Users in your Canny workspace. Use this to find the id to post or change status as. Paginate with the returned cursor.

Bring your own key — connect Canny 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":"canny","endpoint":"/users","input":{}}'

User

One user by their Canny id (from canny.users).

Bring your own key — connect Canny 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
`email`	string	no
`userID`	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":"canny","endpoint":"/users/retrieve","input":{"id":"<user-id>"}}'

Status changes

Roadmap activity: every status move, newest first, with who changed it and to what.

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

Cost: 5 credits per call

Parameter	Type	Required
`boardID`	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":"canny","endpoint":"/status_changes","input":{"limit":20}}'

Ideas

Ideas: the deduped layer above posts, each with its group, owner, status and parent. Search, or narrow with a filtering object ({filters:[{resource:‘ideaDefaultField’,condition,value:{fieldID,value}}],filtersOperator}). Needs Canny Ideas.

Bring your own key — connect Canny 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
`parentID`	string	no
`filtering`	object	no
`sort`	object	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":"canny","endpoint":"/ideas","input":{"limit":20}}'

Idea

One idea in full, by its id or the urlName from its Canny link.

Bring your own key — connect Canny 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
`urlName`	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":"canny","endpoint":"/ideas/retrieve","input":{"id":"<idea-id>"}}'

Insights

The evidence behind an idea: each piece of captured feedback with its author, company and priority. Pass ideaID to read one idea’s case.

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

Cost: 5 credits per call

Parameter	Type	Required
`ideaID`	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":"canny","endpoint":"/insights","input":{"ideaID":"<idea-id>"}}'

Opportunities

Salesforce/HubSpot deals linked to Canny ideas and posts, with value, stage and won/closed — the revenue riding on a request.

Bring your own key — connect Canny 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
`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":"canny","endpoint":"/opportunities","input":{"limit":20}}'

Groups

Groups organize ideas into a nested hierarchy (product areas, ownership). Their ids filter canny.ideas.

Bring your own key — connect Canny 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":"canny","endpoint":"/groups","input":{}}'

Companies

Companies in your workspace with member count and monthly spend — the accounts behind votes and insights. Search by name or filter to a segment.

Bring your own key — connect Canny 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
`segment`	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":"canny","endpoint":"/companies","input":{}}'

Changelog entries

Your Canny changelog entries (new, improved, fixed), published or draft.

Bring your own key — connect Canny 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
`sort`	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":"canny","endpoint":"/entries","input":{}}'

Create post

File a feature request or bug on a board. authorID is the user it’s filed as (from canny.users), or the admin user id set on the connection.

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

Cost: 5 credits per call

Parameter	Type	Required
`boardID`	string	yes
`title`	string	yes
`details`	string	yes
`authorID`	string	no
`categoryID`	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":"canny","endpoint":"/posts/create","input":{"boardID":"<board-id>","title":"Dark mode","details":"The dashboard is painful at night."}}'

Edit a post

Rewrite a post’s title or details. Only the fields you pass change.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`title`	string	no
`details`	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":"canny","endpoint":"/posts/update","input":{"postID":"<post-id>","title":"Dark mode for the dashboard"}}'

Tag a post

Add a tag to a post (tagID from canny.tags). Filter by these with tagIDs on canny.posts.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`tagID`	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":"canny","endpoint":"/posts/add_tag","input":{"postID":"<post-id>","tagID":"<tag-id>"}}'

Untag a post

Take a tag off a post. The tag itself and the post both survive.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`tagID`	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":"canny","endpoint":"/posts/remove_tag","input":{"postID":"<post-id>","tagID":"<tag-id>"}}'

Move a post to another board

Reassign a post to a different board (e.g. filed as a bug, actually a feature request).

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`boardID`	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":"canny","endpoint":"/posts/change_board","input":{"postID":"<post-id>","boardID":"<board-id>"}}'

Recategorize a post

Move a post into a different category on its board (categoryID from canny.categories).

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`categoryID`	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":"canny","endpoint":"/posts/change_category","input":{"postID":"<post-id>","categoryID":"<category-id>"}}'

Create or update a user

Upsert a Canny user by email or your own userID, then use the id it returns as the author of a post or comment.

Bring your own key — connect Canny 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	no
`name`	string	no
`userID`	string	no
`avatarURL`	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":"canny","endpoint":"/users/create_or_update","input":{"email":"jane@example.com","name":"Jane Doe"}}'

Change post status

Move a post through the roadmap (open, under review, planned, in progress, complete, closed). Voters are only emailed when shouldNotifyVoters is true.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`status`	string	yes
`changerID`	string	no
`shouldNotifyVoters`	boolean	no
`commentValue`	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":"canny","endpoint":"/posts/change_status","input":{"postID":"<post-id>","status":"planned"}}'

Comment on a post

Reply on a post. Set internal true to keep it visible to your team only.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`value`	string	yes
`authorID`	string	no
`internal`	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":"canny","endpoint":"/comments/create","input":{"postID":"<post-id>","value":"Shipping this next week."}}'

Write a changelog entry

Announce what shipped (type: new, improved, fixed). Saves as a draft unless published is true; notify emails subscribers. Link the posts it closes with postIDs.

Bring your own key — connect Canny 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
`details`	string	yes
`type`	string	no
`published`	boolean	no
`notify`	boolean	no
`postIDs`	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":"canny","endpoint":"/entries/create","input":{"title":"Dark mode","details":"The dashboard now follows your system theme.","type":"new"}}'

Merge two posts

Fold a duplicate post into the one you’re keeping — its votes and comments move across. Permanent: the merged post can’t be split back out. mergerID is who it’s merged as, or the connection’s admin user id.

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

Cost: 5 credits per call

Parameter	Type	Required
`mergePostID`	string	yes
`intoPostID`	string	yes
`mergerID`	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":"canny","endpoint":"/posts/merge","input":{"mergePostID":"<duplicate-post-id>","intoPostID":"<post-id-to-keep>"}}'

Merge two ideas

Deduplicate the ideas layer: fold one idea into another. Permanent, same as merging posts.

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

Cost: 5 credits per call

Parameter	Type	Required
`mergeIdeaID`	string	yes
`intoIdeaID`	string	yes
`mergerID`	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":"canny","endpoint":"/ideas/merge","input":{"mergeIdeaID":"<duplicate-idea-id>","intoIdeaID":"<idea-id-to-keep>"}}'

Delete a post

Permanently delete a post and its comments and votes. There is no undo and no trash. To retire a post without losing the feedback, change its status to closed instead.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	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":"canny","endpoint":"/posts/delete","input":{"postID":"<post-id>"}}'

Delete an idea

Permanently delete an idea. No undo. Merging into another idea keeps the evidence; this doesn’t.

Bring your own key — connect Canny 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":"canny","endpoint":"/ideas/delete","input":{"id":"<idea-id>"}}'

Delete a comment

Permanently delete one comment (id from canny.comments). No undo.

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

Cost: 5 credits per call

Parameter	Type	Required
`commentID`	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":"canny","endpoint":"/comments/delete","input":{"commentID":"<comment-id>"}}'

Remove a vote

Take one user’s vote off a post, dropping its score. Succeeds even if the vote was already gone. Cast it again with votes/create via canny.request.

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

Cost: 5 credits per call

Parameter	Type	Required
`postID`	string	yes
`voterID`	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":"canny","endpoint":"/votes/delete","input":{"postID":"<post-id>","voterID":"<user-id>"}}'

Delete a category

Delete a board category. Canny refuses while it still has sub-categories. Posts in it survive, uncategorized.

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

Cost: 5 credits per call

Parameter	Type	Required
`categoryID`	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":"canny","endpoint":"/categories/delete","input":{"categoryID":"<category-id>"}}'

Delete a company

Permanently delete a company record, taking its spend off the votes attributed to it. Its users survive. No undo.

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

Cost: 5 credits per call

Parameter	Type	Required
`companyID`	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":"canny","endpoint":"/companies/delete","input":{"companyID":"<company-id>"}}'

Delete a user

The widest delete here: Canny also deletes every comment and vote the user made, strips them as author from posts that have other activity, and deletes outright any post that has none. No undo.

Bring your own key — connect Canny 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":"canny","endpoint":"/users/delete","input":{"id":"<user-id>"}}'

Raw Canny call

Escape hatch: POST any Canny endpoint on your own key (path relative, e.g. companies/list). Prefer the curated canny tools when one fits.

Bring your own key — connect Canny 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
`params`	object	no
`version`	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":"canny","endpoint":"/request","input":{"path":"categories/list","params":{"boardID":"<board-id>"}}}'

ElevenLabs

Turn text into speech in any voice, generate sound effects, and transcribe audio with Scribe. (ai)

Speak text

Turn text into speech in any of ElevenLabs’ voices (voice_id from elevenlabs.voices; defaults to Rachel). Returns the audio as base64 plus an audio_url that serves the same bytes from fetchbean, so you can hand off a link instead of megabytes.

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

Cost: 5 credits per call

Parameter	Type	Required
`text`	string	yes
`voice_id`	string	no
`model_id`	string	no
`language_code`	string	no
`output_format`	string	no
`voice_settings`	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":"elevenlabs","endpoint":"/text-to-speech","input":{"text":"Your deploy finished cleanly."}}'

Generate a sound effect

Describe a sound and get it as audio — footsteps on gravel, a UI chime. Leave duration_seconds off to let the model pick. Returns the audio as base64 plus an audio_url that serves the same bytes from fetchbean, so you can hand off a link instead of megabytes.

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

Cost: 5 credits per call

Parameter	Type	Required
`text`	string	yes
`duration_seconds`	number	no
`prompt_influence`	number	no
`output_format`	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":"elevenlabs","endpoint":"/sound-generation","input":{"text":"a heavy door closing in an empty hall","duration_seconds":3}}'

Transcribe audio

Transcribe speech from a URL with Scribe, with word timings. ElevenLabs fetches the URL itself, so the file must be reachable without auth. Set diarize true to label who spoke.

Bring your own key — connect ElevenLabs 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_id`	string	no
`language_code`	string	no
`diarize`	boolean	no
`num_speakers`	integer	no
`tag_audio_events`	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":"elevenlabs","endpoint":"/speech-to-text","input":{"audio_url":"https://example.com/call.mp3","diarize":true}}'

Voices

The voices on your account, including any you cloned. The voice_id here is what speak takes.

Bring your own key — connect ElevenLabs 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
`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":"elevenlabs","endpoint":"/voices","input":{}}'

Models

Available models with the languages each supports and whether it can do text to speech.

Bring your own key — connect ElevenLabs 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":"elevenlabs","endpoint":"/models","input":{}}'

Quota

Your plan and character quota: how much you have used this period and when it resets. Check before a long batch.

Bring your own key — connect ElevenLabs 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":"elevenlabs","endpoint":"/user/subscription","input":{}}'

Raw ElevenLabs call

Escape hatch for the rest of the API — dubbing, voice cloning, history — on your own key. JSON only: an endpoint that answers with audio needs a curated tool.

Bring your own key — connect ElevenLabs 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":"elevenlabs","endpoint":"/request","input":{"method":"GET","path":"/history"}}'

Sarvam AI

Speech, translation and chat across 20+ Indian languages: speak text, transcribe calls, translate and transliterate. (ai)

Speak Indian-language text

Text to speech across Indian languages (bn-IN, en-IN, gu-IN, hi-IN, kn-IN, ml-IN, mr-IN, od-IN, pa-IN, ta-IN, te-IN (translate also takes as, brx, doi, kok, ks, mai, mni, ne, sa, sat, sd, ur)), code-mixed text included. bulbul:v3 caps at 2500 characters. Sarvam answers with base64 in ‘audios’; that is passed through untouched, with an audio_urls copy served from fetchbean.

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

Cost: 5 credits per call

Parameter	Type	Required
`text`	string	yes
`language_code`	string	yes
`speaker`	string	no
`model`	string	no
`pace`	number	no
`speech_sample_rate`	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":"sarvam","endpoint":"/text-to-speech","input":{"text":"आपका ऑर्डर भेज दिया गया है।","language_code":"hi-IN","speaker":"anushka"}}'

Transcribe Indian-language audio

Transcribe speech with Saaras, tuned for Indian languages and code-mixed speech. Give a URL under 25MB; fetchbean fetches it and uploads the bytes, since Sarvam takes only a file.

Bring your own key — connect Sarvam AI 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_code`	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":"sarvam","endpoint":"/speech-to-text","input":{"audio_url":"https://example.com/support-call.mp3","language_code":"hi-IN"}}'

Translate

Translate between Indian languages and English (bn-IN, en-IN, gu-IN, hi-IN, kn-IN, ml-IN, mr-IN, od-IN, pa-IN, ta-IN, te-IN (translate also takes as, brx, doi, kok, ks, mai, mni, ne, sa, sat, sd, ur)). source_language_code defaults to auto. mode picks the register: formal, modern-colloquial, classic-colloquial or code-mixed.

Bring your own key — connect Sarvam AI 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
`target_language_code`	string	yes
`source_language_code`	string	no
`mode`	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":"sarvam","endpoint":"/translate","input":{"input":"Your order has shipped.","target_language_code":"hi-IN"}}'

Transliterate

Convert text between scripts without translating it — Hindi in Latin letters into Devanagari, or the reverse. Meaning and words stay; only the script changes.

Bring your own key — connect Sarvam AI 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
`target_language_code`	string	yes
`source_language_code`	string	no
`numerals_format`	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":"sarvam","endpoint":"/transliterate","input":{"input":"aapka order bhej diya gaya hai","target_language_code":"hi-IN"}}'

Detect language and script

Identify which Indian language a piece of text is in, and which script it is written in.

Bring your own key — connect Sarvam AI 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
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"sarvam","endpoint":"/text-lid","input":{"input":"நன்றி, உங்கள் ஆர்டர் அனுப்பப்பட்டது"}}'

Chat completion

Sarvam’s own models (sarvam-m by default) over an OpenAI-shaped chat API, built for Indian languages. messages is the usual role/content list.

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

Cost: 5 credits per call

Parameter	Type	Required
`messages`	object[]	yes
`model`	string	no
`temperature`	number	no
`max_tokens`	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":"sarvam","endpoint":"/chat/completions","input":{"messages":[{"role":"user","content":"Summarise this in Hindi: the deploy succeeded."}]}}'

Raw Sarvam call

Escape hatch: POST any Sarvam JSON endpoint on your own key — the batch speech jobs, dubbing, pronunciation dictionaries. Multipart uploads need a curated tool.

Bring your own key — connect Sarvam AI 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
`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":"sarvam","endpoint":"/request","input":{"path":"/text-lid","body":{"input":"namaste"}}}'

Chatwoot

Your Chatwoot support inbox: read conversations and contacts, reply, resolve, assign and label, and pull response-time reports. Cloud or self-hosted. (customer-support)

Conversations

Your support inbox: conversations filtered by status (open, resolved, pending, snoozed), inbox, team, labels or assignee_type (me, unassigned, all). Paginate with page.

Bring your own key — connect Chatwoot 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`	string	no
`assignee_type`	string	no
`inbox_id`	string	integer	no
`team_id`	string	integer	no
`labels`	string[]	no
`q`	string	no
`page`	integer	no
`account_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":"chatwoot","endpoint":"/conversations","input":{"status":"open"}}'

Conversation

One conversation with its contact, assignee, labels and status.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`account_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":"chatwoot","endpoint":"/conversations/{id}","input":{"conversation_id":1}}'

Filter conversations

Advanced search: an array of {attribute_key, filter_operator, values, query_operator} clauses, for anything the plain conversations filters can’t express.

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

Cost: 5 credits per call

Parameter	Type	Required
`payload`	object[]	yes
`page`	integer	no
`account_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":"chatwoot","endpoint":"/conversations/filter","input":{"payload":[{"attribute_key":"status","filter_operator":"equal_to","values":["open"]}]}}'

Inbox counts

How many conversations are mine, unassigned and all — the queue depth, without pulling the list.

Bring your own key — connect Chatwoot 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`	string	no
`inbox_id`	string	integer	no
`team_id`	string	integer	no
`labels`	string[]	no
`account_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":"chatwoot","endpoint":"/conversations/meta","input":{}}'

Messages

The message thread of a conversation. Page back with before, forward with after (a message id).

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`after`	integer	no
`before`	integer	no
`account_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":"chatwoot","endpoint":"/conversations/{id}/messages","input":{"conversation_id":1}}'

Contacts

People who have talked to you. Sort by name, email, phone_number or last_activity_at.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/contacts","input":{}}'

Search contacts

Find a contact by name, email, phone number or your own identifier.

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

Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`sort`	string	no
`page`	integer	no
`account_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":"chatwoot","endpoint":"/contacts/search","input":{"q":"jane@example.com"}}'

Contact

One contact with their attributes and the inboxes they’ve reached you on.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/contacts/{id}","input":{"id":1}}'

A contact’s conversations

Everything one person has ever written in — their full support history.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/contacts/{id}/conversations","input":{"id":1}}'

Inboxes

Your channels (website, email, WhatsApp…) and their ids, for filtering and replies.

Bring your own key — connect Chatwoot 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	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":"chatwoot","endpoint":"/inboxes","input":{}}'

Agents

Teammates on the account — their ids are what assign takes.

Bring your own key — connect Chatwoot 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	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":"chatwoot","endpoint":"/agents","input":{}}'

Teams

Teams you can route a conversation to.

Bring your own key — connect Chatwoot 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	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":"chatwoot","endpoint":"/teams","input":{}}'

Labels

Labels defined on the account — pass their titles when labelling a conversation.

Bring your own key — connect Chatwoot 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	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":"chatwoot","endpoint":"/labels","input":{}}'

Canned responses

Your saved replies — reuse the team’s approved wording instead of improvising.

Bring your own key — connect Chatwoot 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	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":"chatwoot","endpoint":"/canned_responses","input":{}}'

Custom attribute definitions

The custom fields on contacts (attribute_model: contact_attribute) or conversations (conversation_attribute).

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

Cost: 5 credits per call

Parameter	Type	Required
`attribute_model`	string	no
`account_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":"chatwoot","endpoint":"/custom_attribute_definitions","input":{"attribute_model":"conversation_attribute"}}'

Audit logs

Who changed what on the account (enterprise installs).

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/audit_logs","input":{}}'

Report

A metric over time (conversations_count, incoming_messages_count, avg_first_response_time, resolutions_count…). since/until are unix timestamps as strings. Scope with type (account, agent, inbox, label, team) + id.

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

Cost: 5 credits per call

Parameter	Type	Required
`metric`	string	yes
`since`	string	yes
`until`	string	yes
`type`	string	no
`id`	string	integer	no
`group_by`	string	no
`business_hours`	boolean	no
`account_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":"chatwoot","endpoint":"/reports","input":{"metric":"conversations_count","since":"1700000000","until":"1700604800"}}'

Report summary

Volume, first-response time, resolution time and resolution count for a window, in one call.

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

Cost: 5 credits per call

Parameter	Type	Required
`since`	string	yes
`until`	string	yes
`type`	string	no
`id`	string	integer	no
`business_hours`	boolean	no
`account_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":"chatwoot","endpoint":"/reports/summary","input":{"since":"1700000000","until":"1700604800"}}'

Reply to a conversation

Send a message to the customer. Set private true to leave an internal note only your team sees.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`content`	string	yes
`private`	boolean	no
`message_type`	string	no
`content_type`	string	no
`account_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":"chatwoot","endpoint":"/conversations/{id}/messages/create","input":{"conversation_id":1,"content":"Fixed and shipping today."}}'

Change conversation status

Move a conversation through the queue (open, resolved, pending, snoozed). Snoozing takes snoozed_until, a unix timestamp.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`status`	string	yes
`snoozed_until`	integer	no
`account_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":"chatwoot","endpoint":"/conversations/{id}/toggle_status","input":{"conversation_id":1,"status":"resolved"}}'

Set conversation priority

urgent, high, medium, low, or none to clear it.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`priority`	string	yes
`account_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":"chatwoot","endpoint":"/conversations/{id}/toggle_priority","input":{"conversation_id":1,"priority":"urgent"}}'

Assign a conversation

Hand a conversation to an agent (assignee_id, from chatwoot.agents) or a team (team_id).

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`assignee_id`	string	integer	no
`team_id`	string	integer	no
`account_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":"chatwoot","endpoint":"/conversations/{id}/assignments","input":{"conversation_id":1,"assignee_id":2}}'

Label a conversation

Set the labels on a conversation. This replaces the existing set, so send the full list.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`labels`	string[]	yes
`account_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":"chatwoot","endpoint":"/conversations/{id}/labels","input":{"conversation_id":1,"labels":["billing","urgent"]}}'

Start a conversation

Open a new conversation in an inbox on a contact’s behalf. source_id is the contact_inbox source id (see chatwoot.contact).

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

Cost: 5 credits per call

Parameter	Type	Required
`source_id`	string	yes
`inbox_id`	string	integer	yes
`contact_id`	string	integer	no
`status`	string	no
`assignee_id`	string	integer	no
`team_id`	string	integer	no
`message`	object	no
`account_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":"chatwoot","endpoint":"/conversations/create","input":{"source_id":"<source-id>","inbox_id":1,"message":{"content":"Following up on your email."}}}'

Create a contact

Add someone to the account before starting a conversation with them.

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

Cost: 5 credits per call

Parameter	Type	Required
`inbox_id`	string	integer	no
`name`	string	no
`email`	string	no
`phone_number`	string	no
`identifier`	string	no
`custom_attributes`	object	no
`account_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":"chatwoot","endpoint":"/contacts/create","input":{"name":"Jane Doe","email":"jane@example.com"}}'

Update a contact

Correct or enrich a contact. Only the fields you pass change.

Bring your own key — connect Chatwoot 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
`name`	string	no
`email`	string	no
`phone_number`	string	no
`identifier`	string	no
`custom_attributes`	object	no
`account_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":"chatwoot","endpoint":"/contacts/{id}/update","input":{"id":1,"custom_attributes":{"plan":"pro"}}}'

Label a contact

Set the labels on a contact. Replaces the existing set, so send the full list.

Bring your own key — connect Chatwoot 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
`labels`	string[]	yes
`account_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":"chatwoot","endpoint":"/contacts/{id}/labels","input":{"id":1,"labels":["vip"]}}'

Delete a contact

Permanently delete a person and their conversation history. No undo.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/contacts/{id}/delete","input":{"id":42}}'

Delete a message

Remove one message from a conversation — the usual fix for a reply sent by mistake. The thread survives.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`message_id`	string	integer	yes
`account_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":"chatwoot","endpoint":"/conversations/{id}/messages/{message_id}/delete","input":{"conversation_id":1,"message_id":99}}'

Delete a label

Delete a label account-wide, stripping it from every conversation and contact carrying it. To unlabel one conversation instead, re-post its label list without that label.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/labels/{id}/delete","input":{"id":3}}'

Delete a canned response

Retire a saved reply. Replies already sent are untouched.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/canned_responses/{id}/delete","input":{"id":7}}'

Delete a team

Delete a team. Its members keep their accounts; conversations assigned to it become unassigned.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/teams/{id}/delete","input":{"id":2}}'

Remove an agent

Remove an agent from the account, revoking their access. Needs an administrator token.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/agents/{id}/delete","input":{"id":5}}'

Delete a custom attribute

Delete a custom attribute definition and the values stored under it across contacts and conversations.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/custom_attribute_definitions/{id}/delete","input":{"id":11}}'

Raw Chatwoot call

Escape hatch: any account-scoped Chatwoot endpoint on your own token (path relative to the account, e.g. conversations/1/custom_attributes). Prefer the curated chatwoot tools when one fits.

Bring your own key — connect Chatwoot 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
`account_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":"chatwoot","endpoint":"/request","input":{"method":"GET","path":"portals"}}'

Intercom

Your Intercom workspace: search conversations and contacts, reply, close, snooze and assign, tag and note, file tickets, and search the help center. (customer-support)

Conversations

Your Intercom inbox, newest first. Paginate with per_page + the starting_after cursor.

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

Cost: 5 credits per call

Parameter	Type	Required
`per_page`	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":"intercom","endpoint":"/conversations","input":{"per_page":25}}'

Conversation

One conversation with its full part-by-part thread. Bodies come back as plaintext unless you ask otherwise.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`display_as`	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":"intercom","endpoint":"/conversations/{id}","input":{"conversation_id":"1234"}}'

Search conversations

Find conversations by state, assignee, tag, channel or time. query is Intercom’s search shape: {field, operator, value} or {operator: ‘AND’, value: […]}. Paginate with per_page + the starting_after cursor.

Bring your own key — connect Intercom 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`	object	yes
`per_page`	integer	no
`starting_after`	string	no
`sort`	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":"intercom","endpoint":"/conversations/search","input":{"query":{"field":"open","operator":"=","value":"true"}}}'

Contacts

Users and leads in the workspace. Paginate with per_page + starting_after.

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

Cost: 5 credits per call

Parameter	Type	Required
`per_page`	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":"intercom","endpoint":"/contacts","input":{}}'

Contact

One contact with their attributes, tags, companies and segments.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/contacts/{id}","input":{"id":"<contact-id>"}}'

Search contacts

Find people by email, external_id, custom attribute, tag or last-seen time. query is Intercom’s search shape: {field, operator, value} or {operator: ‘AND’, value: […]}. Paginate with per_page + the starting_after cursor.

Bring your own key — connect Intercom 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`	object	yes
`per_page`	integer	no
`starting_after`	string	no
`sort`	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":"intercom","endpoint":"/contacts/search","input":{"query":{"field":"email","operator":"=","value":"jane@example.com"}}}'

Contact notes

Internal notes your team has left on a person.

Bring your own key — connect Intercom 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
`per_page`	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":"intercom","endpoint":"/contacts/{id}/notes","input":{"id":"<contact-id>"}}'

Contact segments

Which segments a person falls into.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/contacts/{id}/segments","input":{"id":"<contact-id>"}}'

Companies

Accounts in the workspace, filtered by name, your own company_id, tag or segment.

Bring your own key — connect Intercom 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
`company_id`	string	no
`tag_id`	string	no
`segment_id`	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":"intercom","endpoint":"/companies","input":{"name":"Acme"}}'

Company

One company with its plan, size, custom attributes and user count.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/companies/{id}","input":{"id":"<company-id>"}}'

Company contacts

Everyone attached to a company — who to talk to at an account.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/companies/{id}/contacts","input":{"id":"<company-id>"}}'

Teammates

Admins on the workspace — their ids are what assign and reply act as.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/admins","input":{}}'

Teams

Teams a conversation can be routed to.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/teams","input":{}}'

Segments

Saved audience segments and their counts.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/segments","input":{}}'

Data attributes

The fields available on contacts, companies or conversations (model: contact, company, conversation) — the vocabulary search queries use.

Bring your own key — connect Intercom 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
`include_archived`	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":"intercom","endpoint":"/data_attributes","input":{"model":"contact"}}'

Help center articles

Your published and draft help center articles.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/articles","input":{}}'

Article

One help center article with its body and state.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/articles/{id}","input":{"id":"<article-id>"}}'

Search articles

Full-text search over the help center — find the article to send a customer before writing a reply.

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

Cost: 5 credits per call

Parameter	Type	Required
`phrase`	string	yes
`state`	string	no
`help_center_id`	string	integer	no
`highlight`	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":"intercom","endpoint":"/articles/search","input":{"phrase":"refund policy"}}'

Search tickets

Find tickets by state, type, assignee or attribute. query is Intercom’s search shape: {field, operator, value} or {operator: ‘AND’, value: […]}. Paginate with per_page + the starting_after cursor.

Bring your own key — connect Intercom 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`	object	yes
`per_page`	integer	no
`starting_after`	string	no
`sort`	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":"intercom","endpoint":"/tickets/search","input":{"query":{"field":"open","operator":"=","value":"true"}}}'

Ticket

One ticket with its parts, state and attributes.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/tickets/{id}","input":{"id":"<ticket-id>"}}'

Ticket types

The ticket types configured in the workspace and their attributes — needed to file one.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/ticket_types","input":{}}'

Contact events

What a person actually did in your product, newest first. Identify them by user_id, intercom_user_id or email.

Bring your own key — connect Intercom 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	no
`intercom_user_id`	string	no
`email`	string	no
`summary`	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":"intercom","endpoint":"/events","input":{"email":"jane@example.com"}}'

Whoami

The admin and workspace this connection acts as.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/me","input":{}}'

Reply to a conversation

Send a customer-visible reply as your teammate. Use intercom.note for something only the team sees.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`body`	string	yes
`admin_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":"intercom","endpoint":"/conversations/{id}/reply","input":{"conversation_id":"1234","body":"Fixed and shipping today."}}'

Add an internal note

Leave a note on a conversation. The customer never sees it. Accepts some HTML.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`body`	string	yes
`admin_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":"intercom","endpoint":"/conversations/{id}/reply/note","input":{"conversation_id":"1234","body":"Refunded via Stripe, waiting on confirmation."}}'

Close a conversation

Mark a conversation closed, optionally leaving a parting message.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`body`	string	no
`admin_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":"intercom","endpoint":"/conversations/{id}/parts/close","input":{"conversation_id":"1234"}}'

Reopen a conversation

Put a closed or snoozed conversation back in the open queue.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`admin_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":"intercom","endpoint":"/conversations/{id}/parts/open","input":{"conversation_id":"1234"}}'

Snooze a conversation

Hide a conversation until snoozed_until (a unix timestamp), then reopen it automatically.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`snoozed_until`	integer	yes
`admin_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":"intercom","endpoint":"/conversations/{id}/parts/snooze","input":{"conversation_id":"1234","snoozed_until":1800000000}}'

Assign a conversation

Route a conversation to a teammate (assignee_id from intercom.admins) or a team (set type to team). assignee_id 0 unassigns.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`assignee_id`	string	integer	yes
`type`	string	no
`body`	string	no
`admin_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":"intercom","endpoint":"/conversations/{id}/parts/assign","input":{"conversation_id":"1234","assignee_id":"4324241"}}'

Tag a conversation

Attach an existing tag (tag_id from intercom.tags) to a conversation.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`tag_id`	string	integer	yes
`admin_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":"intercom","endpoint":"/conversations/{id}/tags","input":{"conversation_id":"1234","tag_id":"7522907"}}'

Tag a contact

Attach an existing tag to a person.

Bring your own key — connect Intercom 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
`tag_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":"intercom","endpoint":"/contacts/{id}/tags","input":{"id":"<contact-id>","tag_id":"7522907"}}'

Note on a contact

Record context about a person that follows them across conversations.

Bring your own key — connect Intercom 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
`body`	string	yes
`admin_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":"intercom","endpoint":"/contacts/{id}/notes/create","input":{"id":"<contact-id>","body":"Migrating from a competitor, watch churn risk."}}'

Create a contact

Add a user or lead (role: user or lead). Identify them by email or your own external_id.

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

Cost: 5 credits per call

Parameter	Type	Required
`role`	string	no
`email`	string	no
`external_id`	string	no
`phone`	string	no
`name`	string	no
`owner_id`	integer	no
`custom_attributes`	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":"intercom","endpoint":"/contacts/create","input":{"role":"user","email":"jane@example.com","name":"Jane Doe"}}'

Update a contact

Correct or enrich a person. Only the fields you pass change.

Bring your own key — connect Intercom 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
`email`	string	no
`name`	string	no
`phone`	string	no
`external_id`	string	no
`owner_id`	integer	no
`unsubscribed_from_emails`	boolean	no
`custom_attributes`	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":"intercom","endpoint":"/contacts/{id}/update","input":{"id":"<contact-id>","custom_attributes":{"plan":"pro"}}}'

File a ticket

Open a ticket for a customer. ticket_type_id comes from intercom.ticket_types; contacts is [{id}] or [{email}].

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

Cost: 5 credits per call

Parameter	Type	Required
`ticket_type_id`	string	yes
`contacts`	object[]	yes
`company_id`	string	no
`ticket_attributes`	object	no
`skip_notifications`	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":"intercom","endpoint":"/tickets","input":{"ticket_type_id":"<ticket-type-id>","contacts":[{"email":"jane@example.com"}],"ticket_attributes":{"_default_title_":"Cannot log in"}}}'

Untag a conversation

Take a tag off a conversation. The tag itself survives.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`tag_id`	string	integer	yes
`admin_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":"intercom","endpoint":"/conversations/{id}/tags/{tag_id}","input":{"conversation_id":"1234","tag_id":"7522907"}}'

Untag a contact

Take a tag off a person. The tag itself survives.

Bring your own key — connect Intercom 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
`tag_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":"intercom","endpoint":"/contacts/{id}/tags/{tag_id}","input":{"id":"<contact-id>","tag_id":"7522907"}}'

Archive a contact

Take a person out of the active list without destroying them — the reversible alternative to delete_contact. Undo with unarchive_contact.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/contacts/{id}/archive","input":{"id":"<contact-id>"}}'

Unarchive a contact

Put an archived person back in the active list.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/contacts/{id}/unarchive","input":{"id":"<contact-id>"}}'

Merge two contacts

Fold a lead (from) into a user (into). Permanent: the source contact stops resolving by id, disappears from list and search, and only the target survives — update any stored ids.

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

Cost: 5 credits per call

Parameter	Type	Required
`from`	string	yes
`into`	string	yes
`skip_duplicate_validation`	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":"intercom","endpoint":"/contacts/merge","input":{"from":"<lead-contact-id>","into":"<user-contact-id>"}}'

Merge two conversations

Fold a duplicate thread into the one you’re keeping: the source is closed and linked to the target, which survives. conversation_id is the one merged away.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_id`	string	integer	yes
`merge_into_conversation_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":"intercom","endpoint":"/conversations/{id}/merge","input":{"conversation_id":"<duplicate-conversation-id>","merge_into_conversation_id":"<conversation-id-to-keep>"}}'

Detach a contact from a company

Unlink a person from a company. Both records survive; only the association goes.

Bring your own key — connect Intercom 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
`company_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":"intercom","endpoint":"/contacts/{id}/companies/{company_id}","input":{"id":"<contact-id>","company_id":"<company-id>"}}'

Delete a contact

Permanently delete a person. No undo — archive_contact is the reversible version.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/contacts/{id}/delete","input":{"id":"<contact-id>"}}'

Delete a conversation

Permanently delete a conversation and its parts. No undo. To take a thread out of the inbox without losing it, close it instead.

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

Cost: 5 credits per call

Parameter	Type	Required
`conversation_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":"intercom","endpoint":"/conversations/{id}/delete","input":{"conversation_id":"1234"}}'

Delete a company

Permanently delete a company record. Its contacts survive, detached. No undo.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/companies/{id}/delete","input":{"id":"<company-id>"}}'

Delete a ticket

Permanently delete a ticket. No undo.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/tickets/{id}/delete","input":{"id":"<ticket-id>"}}'

Delete a tag

Delete a tag workspace-wide, stripping it from every conversation, contact and ticket carrying it.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/tags/{id}/delete","input":{"id":"<tag-id>"}}'

Delete a help center article

Permanently delete an article. No undo — unpublishing it via the API’s article update is the soft option.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/articles/{id}/delete","input":{"id":"<article-id>"}}'

Raw Intercom call

Escape hatch: any Intercom endpoint on your own token, pinned to API version 2.16 (path absolute, e.g. /news/news_items). Prefer the curated intercom tools when one fits.

Bring your own key — connect Intercom 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":"intercom","endpoint":"/request","input":{"method":"GET","path":"/help_center/help_centers"}}'

Plain

Your Plain support inbox: read threads and customers, reply, resolve, assign, label, and write internal notes. Plus the B2B side — tenants, companies, and the tiers and SLAs that say what response a customer is owed (bring your own key). (customer-support)

Plain: workspace

The Plain workspace your key is scoped to, and the permissions it holds.

Bring your own key — connect Plain 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":"plain","endpoint":"/me","input":{}}'

Plain: customers

List the customers in your workspace.

Bring your own key — connect Plain 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
`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":"plain","endpoint":"/customers","input":{"first":25}}'

Plain: customer

Get one customer by Plain id, email address, or your own external id.

Bring your own key — connect Plain 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
`email`	string	no
`external_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":"plain","endpoint":"/customer","input":{"email":"ada@example.com"}}'

Plain: search customers

Partial-match search across customer name, email, short name, and external id.

Bring your own key — connect Plain 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
(other provider fields)	any	no

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

Plain: upsert customer

Create a customer, or update the one matching the email, external id, or Plain id you pass. Tells you which of CREATED, UPDATED, or NOOP happened.

Bring your own key — connect Plain 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	no
`external_id`	string	no
`id`	string	no
`full_name`	string	no
`short_name`	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":"plain","endpoint":"/customers/upsert","input":{"email":"ada@example.com","full_name":"Ada Lovelace"}}'

Plain: threads

List the support threads in your Plain inbox, filtered by status, assignment, priority, customer, or label.

Bring your own key — connect Plain 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
`status`	string	string	string	no
`is_assigned`	boolean	no
`assigned_to_user`	string	no
`priority`	integer	no
`customer_id`	string	no
`label_type_ids`	string[]	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":"plain","endpoint":"/threads","input":{"status":"TODO","is_assigned":false}}'

Plain: thread

One thread in full: status, priority, assignee, labels, tier, and message timestamps.

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

Cost: 5 credits per call

Parameter	Type	Required
`thread_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":"plain","endpoint":"/thread","input":{"thread_id":"<thread-id>"}}'

Plain: search threads

Free-text search across your support threads (at least 2 characters).

Bring your own key — connect Plain 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
`status`	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":"plain","endpoint":"/threads/search","input":{"query":"refund"}}'

Plain: thread timeline

Read the conversation on a thread: emails, chats, notes, and status changes, oldest first. Each entry carries Plain’s own plain-text rendering, so it drops straight into a prompt.

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

Cost: 5 credits per call

Parameter	Type	Required
`thread_id`	string	yes
`first`	integer	no
`after`	string	no
`messages_only`	boolean	no
`entry_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":"plain","endpoint":"/threads/timeline","input":{"thread_id":"<thread-id>","messages_only":true}}'

Plain: reply to a thread

Send a reply to the customer on whichever channel they used (email, chat, Slack). This reaches the customer, unlike a note.

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

Cost: 5 credits per call

Parameter	Type	Required
`thread_id`	string	yes
`text`	string	yes
`markdown`	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":"plain","endpoint":"/threads/reply","input":{"thread_id":"<thread-id>","text":"Refund is on its way, you'll see it in 3 to 5 days."}}'

Plain: set thread status

Move a thread to TODO, DONE, or SNOOZED. A snoozed thread wakes up after duration_seconds (default an hour) or when the customer replies; a done thread reopens on new activity.

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

Cost: 5 credits per call

Parameter	Type	Required
`thread_id`	string	yes
`status`	string	string	string	yes
`duration_seconds`	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":"plain","endpoint":"/threads/status","input":{"thread_id":"<thread-id>","status":"DONE"}}'

Plain: assign a thread

Assign a thread to a teammate or machine user. Pass neither id to clear the assignment.

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

Cost: 5 credits per call

Parameter	Type	Required
`thread_id`	string	yes
`user_id`	string	no
`machine_user_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":"plain","endpoint":"/threads/assign","input":{"thread_id":"<thread-id>","user_id":"<user-id>"}}'

Plain: change thread priority

Set a thread’s priority: 0 urgent, 1 high, 2 normal, 3 low.

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

Cost: 5 credits per call

Parameter	Type	Required
`thread_id`	string	yes
`priority`	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":"plain","endpoint":"/threads/priority","input":{"thread_id":"<thread-id>","priority":0}}'

Plain: label types

The labels your workspace defines — the label_type_ids you need to label a thread.

Bring your own key — connect Plain 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
`include_archived`	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":"plain","endpoint":"/label-types","input":{}}'

Plain: label a thread

Add one or more labels to a thread (ids from plain.label_types). Labels already on it are skipped.

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

Cost: 5 credits per call

Parameter	Type	Required
`thread_id`	string	yes
`label_type_ids`	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":"plain","endpoint":"/threads/labels/add","input":{"thread_id":"<thread-id>","label_type_ids":["<label-type-id>"]}}'

Plain: unlabel a thread

Remove labels from a thread. Takes the label id off the thread (see plain.thread), not the label type id, and they must all be from the same thread.

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

Cost: 5 credits per call

Parameter	Type	Required
`label_ids`	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":"plain","endpoint":"/threads/labels/remove","input":{"label_ids":["<label-id>"]}}'

Plain: write a note

Add an internal note your team can see and the customer cannot. With a thread_id it pins to that thread; without one it follows the customer across all of theirs.

Bring your own key — connect Plain 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
`thread_id`	string	no
`text`	string	yes
`markdown`	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":"plain","endpoint":"/notes/create","input":{"customer_id":"<customer-id>","thread_id":"<thread-id>","text":"Confirmed with billing, refund approved."}}'

Plain: edit a note

Rewrite a note’s body. Plain marks it as edited.

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

Cost: 5 credits per call

Parameter	Type	Required
`note_id`	string	yes
`text`	string	yes
`markdown`	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":"plain","endpoint":"/notes/update","input":{"note_id":"<note-id>","text":"Correction: refund was already issued on the 3rd."}}'

Plain: delete a note

Remove an internal note. Plain soft-deletes it, so it stays on the record as removed.

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

Cost: 5 credits per call

Parameter	Type	Required
`note_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":"plain","endpoint":"/notes/delete","input":{"note_id":"<note-id>"}}'

Plain: tenants

List your tenants — the accounts, teams, or workspaces your customers belong to. Each carries its support tier, so this is how you tell which account a thread is really about.

Bring your own key — connect Plain 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
`tenant_ids`	string[]	no
`tier_id`	string	no
`tier_external_id`	string	no
`is_deleted`	boolean	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":"plain","endpoint":"/tenants","input":{"first":25}}'

Plain: search tenants

Find a tenant by name (partial match) or by the external id you gave it (exact). At least 2 characters.

Bring your own key — connect Plain 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
(other provider fields)	any	no

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

Plain: upsert tenant

Create a tenant, or update the one matching the external id from your own backend. Tells you which of CREATED, UPDATED, or NOOP happened.

Bring your own key — connect Plain 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
`name`	string	yes
`url`	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":"plain","endpoint":"/tenants/upsert","input":{"external_id":"team_8412","name":"Acme Corp","url":"https://admin.example.com/teams/8412"}}'

Plain: set a customer’s tenants

Replace the full set of tenants a customer belongs to. Use this when syncing account membership from your own database.

Bring your own key — connect Plain 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
`email`	string	no
`customer_external_id`	string	no
`tenant_external_ids`	string[]	no
`tenant_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":"plain","endpoint":"/customers/tenants","input":{"email":"ada@acme.com","tenant_external_ids":["team_8412"]}}'

Plain: companies

List the companies in your workspace, with their tier, contract value, and account owner. Plain creates these automatically from customer email domains.

Bring your own key — connect Plain 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
`company_ids`	string[]	no
`is_deleted`	boolean	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":"plain","endpoint":"/companies","input":{"first":25}}'

Plain: search companies

Find a company by name or domain (partial match, at least 2 characters).

Bring your own key — connect Plain 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
(other provider fields)	any	no

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

Plain: upsert company

Create or update a company by domain. contract_value is in cents. Tells you which of CREATED or UPDATED happened.

Bring your own key — connect Plain 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
`name`	string	yes
`company_id`	string	no
`contract_value`	integer	no
`account_owner_user_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":"plain","endpoint":"/companies/upsert","input":{"domain":"acme.com","name":"Acme Corp","contract_value":1200000}}'

Plain: tiers and SLAs

Your support tiers with the SLAs attached to each: first-response and next-response targets in minutes, which priorities they apply to, and whether they run 24/7 or only in business hours. This is how you know what response a customer is actually owed.

Bring your own key — connect Plain 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":"plain","endpoint":"/tiers","input":{}}'

Plain: set a tier

Move one company or tenant into a support tier, which is what applies that tier’s SLAs to their threads. Omit the tier to take them out of the one they are in.

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

Cost: 5 credits per call

Parameter	Type	Required
`tier_id`	string	no
`tier_external_id`	string	no
`company_id`	string	no
`company_domain`	string	no
`tenant_id`	string	no
`tenant_external_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":"plain","endpoint":"/tiers/set","input":{"tenant_external_id":"team_8412","tier_external_id":"enterprise"}}'

Plain: snippets

Your team’s saved reply snippets, with their text and markdown. Read these before drafting a reply so an answer matches the wording your team already agreed on.

Bring your own key — connect Plain 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":"plain","endpoint":"/snippets","input":{"first":50}}'

Plain: open a thread

Start a support thread on a customer — a contact-form submission, or proactive support off the back of an error. The thread opens empty; use plain.send_email or plain.reply_to_thread to put the first message on it.

Bring your own key — connect Plain 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
`email`	string	no
`customer_external_id`	string	no
`title`	string	no
`description`	string	no
`priority`	integer	no
`label_type_ids`	string[]	no
`tenant_id`	string	no
`tenant_external_id`	string	no
`assigned_to_user_id`	string	no
`external_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":"plain","endpoint":"/threads/create","input":{"email":"ada@acme.com","title":"Checkout failing on card 4242","priority":1}}'

Plain: send an email

Email a customer from your support address. Without a thread_id Plain opens a new thread for it, which is how you reach out first rather than answering. To answer an existing thread use plain.reply_to_thread.

Bring your own key — connect Plain 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
`subject`	string	yes
`text`	string	yes
`markdown`	string	no
`thread_id`	string	no
`cc`	string[]	no
`bcc`	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":"plain","endpoint":"/emails/send","input":{"customer_id":"<customer-id>","subject":"About your failed payment","text":"Hi Ada, we noticed..."}}'

Plain: raw GraphQL

Escape hatch: run any Plain GraphQL query or mutation on your own key, for anything the curated tools do not cover (tasks, discussions, help center, webhook targets, events). The schema is at core-api.uk.plain.com/graphql/v1/schema.graphql. Prefer a curated plain tool when one fits.

Bring your own key — connect Plain 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":"plain","endpoint":"/graphql","input":{"query":"query { myWorkspace { id name } }"}}'

NASA

NASA and JPL open data on one key: the astronomy picture of the day, asteroids and comets passing close to Earth, impact risk and recorded fireballs, live wildfires and storms seen from orbit, solar flares and geomagnetic storms, full-disc Earth photos, and the public image and video archive. (data)

NASA: astronomy picture of the day

The Astronomy Picture of the Day with its explanation: today by default, a specific date, a date range, or a number of random days. Videos come back as links, and thumbs asks for a still. Cost: 5 credits per call

Parameter	Type	Required
`date`	string	no
`start_date`	string	no
`end_date`	string	no
`count`	integer	no
`thumbs`	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":"nasa","endpoint":"/apod","input":{"date":"2026-07-04"}}'

NASA: near-earth asteroids

Asteroids making a close approach to Earth in a date window (7 days max), each with its miss distance, relative velocity, estimated diameter, and whether NASA flags it as potentially hazardous. Cost: 5 credits per call

Parameter	Type	Required
`start_date`	string	no
`end_date`	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":"nasa","endpoint":"/asteroids","input":{"start_date":"2026-08-22","end_date":"2026-08-25"}}'

NASA: one asteroid

The full record for a single asteroid by its JPL SPK-ID, including orbital data and every logged close approach. Cost: 5 credits per call

Parameter	Type	Required
`asteroid_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":"nasa","endpoint":"/asteroids/lookup","input":{"asteroid_id":"3542519"}}'

NASA: space weather

Space weather events from NASA’s DONKI database: FLR solar flares, GST geomagnetic storms, CME coronal mass ejections, SEP solar energetic particles, HSS high-speed streams, and more. Defaults to the plain-language NOTIFICATIONS feed. Cost: 5 credits per call

Parameter	Type	Required
`type`	string	string	string	string	string	string	string	string	string	string	string	no
`start_date`	string	no
`end_date`	string	no
`notification_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":"nasa","endpoint":"/space-weather","input":{"type":"FLR","start_date":"2026-08-01","end_date":"2026-08-22"}}'

NASA: full-disc Earth images

Whole-Earth photographs from the EPIC camera aboard DSCOVR, a million miles out. Returns the most recent set, or a given date, with a ready image_url on each frame plus the sub-satellite lat/lon it was centred on. Cost: 5 credits per call

Parameter	Type	Required
`kind`	string	string	no
`date`	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":"nasa","endpoint":"/earth-images","input":{"kind":"natural"}}'

NASA: natural events on Earth

Natural events NASA is currently tracking from orbit — wildfires, severe storms, volcanoes, floods, icebergs — each with coordinates, a magnitude where one applies, and its source links. Categories: wildfires, severeStorms, volcanoes, floods, earthquakes, drought, dustHaze, landslides, manmade, seaLakeIce, snow, tempExtremes, waterColor. Cost: 5 credits per call

Parameter	Type	Required
`category`	string	no
`status`	string	string	string	no
`limit`	integer	no
`days`	integer	no
`bbox`	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":"nasa","endpoint":"/natural-events","input":{"category":"wildfires","status":"open","limit":20}}'

NASA: search images and video

Search NASA’s public media library across images, video and audio. Each hit comes back flattened, with its title, description, centre, date and a preview_url. media_type narrows to image, video, or audio. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`media_type`	string	no
`year_start`	string	no
`year_end`	string	no
`center`	string	no
`keywords`	string	no
`page`	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":"nasa","endpoint":"/media/search","input":{"q":"apollo 11","media_type":"image"}}'

NASA: fireballs

Bright meteors that hit the atmosphere, logged by US government sensors: date, radiated energy, estimated impact energy in kilotons, altitude, velocity, and where over the Earth it happened. req_loc drops the ones with no location. Needs no key. Cost: 5 credits per call

Parameter	Type	Required
`date_min`	string	no
`date_max`	string	no
`energy_min`	number	no
`impact_e_min`	number	no
`req_loc`	boolean	no
`sort`	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":"nasa","endpoint":"/fireballs","input":{"date_min":"2026-01-01","sort":"-impact-e","limit":10}}'

NASA: close approaches

Asteroids and comets passing near Earth, from JPL. Unlike nasa.asteroids this takes any date range, reaches decades ahead or back, covers comets, and filters on distance (dist_max accepts au or a form like ‘10LD’ for lunar distances). Needs no key. Cost: 5 credits per call

Parameter	Type	Required
`date_min`	string	no
`date_max`	string	no
`dist_max`	string	no
`dist_min`	string	no
`h_max`	number	no
`des`	string	no
`spk`	string	no
`body`	string	no
`pha`	boolean	no
`comet`	boolean	no
`neo`	boolean	no
`class`	string	no
`sort`	string	no
`limit`	integer	no
`diameter`	boolean	no
`fullname`	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":"nasa","endpoint":"/close-approaches","input":{"date_min":"2026-08-22","date_max":"2026-12-31","dist_max":"0.01","sort":"dist"}}'

NASA: impact risk (Sentry)

JPL’s Sentry list: objects with a non-zero chance of hitting Earth, with impact probability, Palermo and Torino scale ratings, and estimated diameter. Pass des for one object and you get its table of possible impact dates instead. Needs no key. Cost: 5 credits per call

Parameter	Type	Required
`des`	string	no
`spk`	string	no
`ps_min`	number	no
`ip_min`	number	no
`h_max`	number	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":"nasa","endpoint":"/impact-risk","input":{"ps_min":-4}}'

NASA: small-body record

The full JPL record for one asteroid or comet by name, designation or SPK-ID: orbit class and elements, and optionally physical parameters (phys_par), every logged close approach (ca_data), and discovery circumstances. A name matching several objects comes back naming the candidates. Needs no key. Cost: 5 credits per call

Parameter	Type	Required
`sstr`	string	no
`des`	string	no
`spk`	string	no
`phys_par`	boolean	no
`ca_data`	boolean	no
`discovery`	boolean	no
`full_prec`	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":"nasa","endpoint":"/small-body","input":{"sstr":"433","phys_par":true}}'

NASA: raw request

Escape hatch: any api.nasa.gov path with the key applied, for what the curated tools do not reach — browsing the whole asteroid catalogue, or a DONKI feed by hand. Note two api.nasa.gov services are not usable here: /planetary/earth/* has been answering 503, and /techtransfer/* returns an HTML page rather than JSON. Prefer a curated nasa tool when one fits. Cost: 5 credits per call

Parameter	Type	Required
`path`	string	yes
`query`	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":"nasa","endpoint":"/request","input":{"path":"/neo/rest/v1/neo/browse","query":{"page":0,"size":20}}}'

Frankfurter

Exchange rates for 201 currencies, blended from 84 central banks and reaching back to 1948. Convert an amount, read a single day, or pull a time series. No account needed. (data)

Exchange rates

Exchange rates for 201 currencies: today’s by default, a specific day with date, or a series with from/to. Rates are blended from 84 central banks and reach back to 1948, and every day is covered including weekends. A range must name its quotes; use group week or month to downsample a long span. Cost: 5 credits per call

Parameter	Type	Required
`date`	string	no
`from`	string	no
`to`	string	no
`base`	string	no
`quotes`	string	no
`group`	string	string	no
`providers`	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":"frankfurter","endpoint":"/rates","input":{"base":"USD","quotes":"EUR,GBP,INR"}}'

Convert currency

Convert an amount from one currency to another, at today’s rate or a past date’s. Returns the converted result alongside the rate used and the date it applies to. Cost: 5 credits per call

Parameter	Type	Required
`amount`	number	yes
`from`	string	yes
`to`	string	yes
`date`	string	no
`providers`	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":"frankfurter","endpoint":"/convert","input":{"amount":250,"from":"USD","to":"EUR"}}'

Supported currencies

Every currency code available, with the providers covering each. include_legacy folds in currencies no longer in circulation, such as the pre-euro national ones. Cost: 5 credits per call

Parameter	Type	Required
`include_legacy`	boolean	no
`providers`	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":"frankfurter","endpoint":"/currencies","input":{}}'

Rate sources

The 84 central banks and official sources behind the rates, each with the currencies it covers, its rate type, publishing cadence, and how far its history goes. 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":"frankfurter","endpoint":"/providers","input":{}}'

SEC EDGAR

US public company filings and financials, straight from the SEC: resolve a ticker to a company, list its 10-Ks and 8-Ks with links to the documents, pull a reported figure across every period, or search the full text of filings. No account needed. (data)

SEC: company profile

Look up a US-listed company by ticker, CIK, or name: its CIK, every ticker and exchange it trades on, industry (SIC) code, EIN, fiscal year end, website, and business address. A name matching several companies comes back naming them. Cost: 5 credits per call

Parameter	Type	Required
`ticker`	string	no
`cik`	string	no
`company`	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":"sec","endpoint":"/company","input":{"ticker":"AAPL"}}'

SEC: company filings

A company’s filings, newest first, each with a direct link to the filed document. Narrow with form (10-K, 10-Q, 8-K, 4, S-1) and since. Covers roughly the last 1000 filings; the response says when older ones exist beyond that. Cost: 5 credits per call

Parameter	Type	Required
`ticker`	string	no
`cik`	string	no
`company`	string	no
`form`	string	string[]	no
`since`	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":"sec","endpoint":"/filings","input":{"ticker":"AAPL","form":"10-K","limit":5}}'

SEC: search filing text

Search the full text of filed documents, not just their titles. Quote a phrase to match it exactly. Each hit names the company and form and links straight to the document. Narrow by form type and date range. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`forms`	string	string[]	no
`start_date`	string	no
`end_date`	string	no
`from`	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":"sec","endpoint":"/search","input":{"q":"\"climate risk\"","forms":"10-K","start_date":"2025-01-01"}}'

SEC: financial metric over time

One reported financial figure for one company, every period it appears, straight from XBRL — so revenue or net income comes with the filing and form it came from. Common tags: Revenues, NetIncomeLoss, Assets, Liabilities, StockholdersEquity, CashAndCashEquivalentsAtCarryingValue. Cost: 5 credits per call

Parameter	Type	Required
`tag`	string	yes
`ticker`	string	no
`cik`	string	no
`company`	string	no
`taxonomy`	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":"sec","endpoint":"/concept","input":{"ticker":"AAPL","tag":"NetIncomeLoss"}}'

SEC: one metric across all companies

The same figure for every company that reported it in a period, which is how you rank or compare. Period is CY2024 or CY2024Q1 for a duration measure like Revenues, and CY2024Q1I for an instant one like Assets. Cost: 5 credits per call

Parameter	Type	Required
`tag`	string	yes
`period`	string	yes
`taxonomy`	string	no
`unit`	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":"sec","endpoint":"/frames","input":{"tag":"Assets","period":"CY2024Q1I"}}'

Crossref

Scholarly literature metadata: search ~160M papers by title, author or topic, or resolve a DOI to its authors, journal, date and citation count. No account needed. (data)

Crossref: search papers

Search ~160M scholarly works by title, author, or topic, each with its DOI, authors, journal, year and citation count. Sort by is-referenced-by-count for the most cited. Matching is bibliographic rather than semantic, so a title works better than a plain-English question. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`limit`	integer	no
`offset`	integer	no
`from_year`	integer	no
`until_year`	integer	no
`type`	string	no
`sort`	string	no
`order`	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":"crossref","endpoint":"/search","input":{"query":"deep learning","sort":"is-referenced-by-count","limit":5}}'

Crossref: paper by DOI

Resolve a DOI to its full record: title, authors, journal, publication date, publisher, licence and how many works cite it. Accepts a bare DOI or a doi.org link. Cost: 5 credits per call

Parameter	Type	Required
`doi`	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":"crossref","endpoint":"/work","input":{"doi":"10.1038/nature14539"}}'

USGS

Earthquakes from the USGS catalog: recent activity, historic events, or everything within a radius of a point, with magnitude, depth and felt reports. No account needed. (data)

USGS: earthquakes

Earthquakes from the USGS catalog with magnitude, depth, coordinates, felt reports and tsunami flag, timestamps already in ISO rather than epoch milliseconds. Defaults to the last 30 days; narrow by magnitude, by date, or to a radius around a point. Says how many matched in total, not just what came back. Cost: 5 credits per call

Parameter	Type	Required
`start_time`	string	no
`end_time`	string	no
`min_magnitude`	number	no
`max_magnitude`	number	no
`latitude`	number	no
`longitude`	number	no
`radius_km`	number	no
`min_depth_km`	number	no
`max_depth_km`	number	no
`alert_level`	string	no
`orderby`	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":"usgs","endpoint":"/earthquakes","input":{"min_magnitude":5,"limit":10}}'

NHTSA

US vehicle data from the safety regulator: decode any VIN, look up makes and models, and check a car’s recalls, government crash-test ratings and owner-filed complaints. No account needed. (data)

NHTSA: decode a VIN

Everything a VIN encodes, from the manufacturer’s own filing: make, model, year, trim, body class, engine size and cylinders, horsepower, transmission, airbag positions, assembly plant and GVWR class. Says whether the check digit validated, so a plausible-looking bad VIN is distinguishable from a clean decode. Inapplicable fields are dropped rather than returned as ‘Not Applicable’. Cost: 5 credits per call

Parameter	Type	Required
`vin`	string	yes
`model_year`	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":"nhtsa","endpoint":"/decode_vin","input":{"vin":"1HGCM82633A004352"}}'

NHTSA: vehicle makes

Every make registered with NHTSA — 12,000-odd, counting one-off custom builders — or just those building one type of vehicle (car, truck, motorcycle, bus, trailer). NHTSA offers no search on this table, so contains filters the answer here. Cost: 5 credits per call

Parameter	Type	Required
`vehicle_type`	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":"nhtsa","endpoint":"/makes","input":{"contains":"honda"}}'

NHTSA: models for a make

The models a manufacturer sold, for one model year or across every year on file. The reference list the other vehicle tools expect a model name from. Cost: 5 credits per call

Parameter	Type	Required
`make`	string	yes
`year`	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":"nhtsa","endpoint":"/models","input":{"make":"Honda","year":2024}}'

NHTSA: safety recalls

Open safety recalls on a vehicle, with the campaign number, the component at fault, what goes wrong and what the remedy is. Carries NHTSA’s two urgency flags — park it, park it outside — and whether the fix is over-the-air. Dates are converted from NHTSA’s day-first format to ISO. Cost: 5 credits per call

Parameter	Type	Required
`make`	string	yes
`model`	string	yes
`year`	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":"nhtsa","endpoint":"/recalls","input":{"make":"Honda","model":"Accord","year":2024}}'

NHTSA: crash-test ratings

NCAP star ratings from the government’s own crash tests: overall, frontal, side barrier, side pole and rollover, plus rollover probability and whether stability control, forward-collision warning and lane-departure warning are standard. Includes links to the crash-test photos and video. Omit model to see which models NHTSA rated that year; NHTSA rates body styles, so ‘civic’ returns the sedan, hatchback and Si separately. Cost: 5 credits per call

Parameter	Type	Required
`make`	string	yes
`year`	integer	yes
`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":"nhtsa","endpoint":"/safety_ratings","input":{"make":"Honda","year":2024,"model":"civic"}}'

NHTSA: owner complaints

Defect complaints owners filed with NHTSA about a vehicle, with the affected component, the owner’s account, and whether the incident involved a crash, a fire, injuries or deaths. Says how many exist in total, not just how many came back. Cost: 5 credits per call

Parameter	Type	Required
`make`	string	yes
`model`	string	yes
`year`	integer	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":"nhtsa","endpoint":"/complaints","input":{"make":"Honda","model":"Accord","year":2022,"limit":10}}'

fueleconomy.gov

Official EPA mileage, annual fuel cost and CO2 figures for every vehicle sold in the US since 1984, per engine and transmission. No account needed. (data)

EPA: rated years, makes and models

What fueleconomy.gov actually rates, one level at a time: every model year with no arguments, the makes sold in a year with year, and that make’s models with both. The spellings the mileage lookup expects. Cost: 5 credits per call

Parameter	Type	Required
`year`	integer	no
`make`	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":"fueleconomy","endpoint":"/models","input":{"year":2024,"make":"Honda"}}'

EPA: mileage and running cost

Official EPA figures for every engine and transmission combination of one vehicle: city, highway and combined MPG, estimated annual fuel cost, CO2 grams per mile, the EPA fuel-economy and greenhouse-gas scores, emissions standard and electric range. Covers everything sold in the US since 1984. Cost: 5 credits per call

Parameter	Type	Required
`year`	integer	yes
`make`	string	yes
`model`	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":"fueleconomy","endpoint":"/lookup","input":{"year":2024,"make":"Honda","model":"Accord"}}'

AAA Fuel Prices

US retail fuel prices from AAA’s daily survey: national, state and metro averages by grade, with yesterday, last week, last month and last year alongside. No account needed. (data)

AAA: gas prices now

Average US pump prices per gallon by grade — regular, mid-grade, premium, diesel and E85 nationally — for today, yesterday, a week ago, a month ago and a year ago, so a change is visible without a second call. Pass a two-letter state code for that state plus each of its metro areas. Cost: 5 credits per call

Parameter	Type	Required
`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":"aaa","endpoint":"/gas_prices","input":{"state":"CA"}}'

AAA: gas prices by state

Today’s average price for every US state and DC in one call, per grade — the table to rank, compare or find the cheapest and most expensive states from. 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":"aaa","endpoint":"/state_prices","input":{}}'

Freddie Mac

The weekly US mortgage rate survey: 30-year and 15-year fixed averages, this week or back to 1971. No account needed. (data)

US mortgage rates

The weekly average US mortgage rate from Freddie Mac’s Primary Mortgage Market Survey — the 30-year and 15-year fixed figures quoted in the news. Returns this week’s rate on its own, or the whole weekly series between two dates: the 30-year runs back to April 1971, so a rate today can be put against any point in fifty years. Cost: 5 credits per call

Parameter	Type	Required
`start_date`	string	no
`end_date`	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":"freddiemac","endpoint":"/mortgage_rates","input":{"start_date":"2026-01-01"}}'

Realtor.com Research

The monthly US housing market: median list price, inventory, days on market and price cuts for the country, any state, metro, county or ZIP code. No account needed. (data)

US housing market by area

The monthly state of the US housing market from Realtor.com’s open research data, for the whole country, a state, a metro, a county or a ZIP code: median listing price, price per square foot, active and new listing counts, median days on market, how many listings cut or raised their price, and pending sales — each with its month-over-month and year-over-year change. Sort by any column to rank the hottest or cheapest markets. Covers roughly 28,000 ZIP codes. Cost: 5 credits per call

Parameter	Type	Required
`level`	string	string	string	string	string	no
`area`	string	no
`sort_by`	string	no
`order`	string	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":"realtor","endpoint":"/market_metrics","input":{"level":"metro","area":"austin"}}'

India Post

Indian PIN codes both ways: a code to its post offices, district and state, or a locality name to its codes. No account needed. (data)

India: look up a PIN code

Every post office served by an Indian PIN code, with district, state, postal circle and division, and whether each one delivers or is non-delivery. One PIN usually covers several post offices, so this is what turns a six-digit code into a place you can name and validate an address against. Cost: 5 credits per call

Parameter	Type	Required
`pincode`	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":"indiapost","endpoint":"/pincode","input":{"pincode":"560001"}}'

India: find a PIN code by name

The PIN codes for a named post office, locality or neighbourhood in India, with its district, state and postal hierarchy. The other direction from a PIN lookup: for when an address has a place name and needs the code. 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":"indiapost","endpoint":"/post_offices","input":{"name":"Koramangala"}}'

IFSC

Indian bank branches by IFSC code: bank, branch, address, MICR and SWIFT, and whether the branch supports NEFT, RTGS, IMPS and UPI. No account needed. (data)

India: look up a bank branch by IFSC

The bank, branch, address, city, district and state behind an Indian IFSC code, plus its MICR and SWIFT codes — and, the part that decides whether a payment goes through, which rails the branch is live on: NEFT, RTGS, IMPS and UPI. Validates the code’s format before asking, so a typo comes back named rather than as a bare not-found. Cost: 5 credits per call

Parameter	Type	Required
`ifsc`	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":"ifsc","endpoint":"/branch","input":{"ifsc":"HDFC0000001"}}'

Open Food Facts

Packaged goods by barcode or name: ingredients, allergens, nutrition per 100g, and the Nutri-Score, NOVA processing and Eco-Score ratings. Covers food plus the sibling cosmetics, pet food and general-product databases. Community-maintained, no account needed. (data)

Open Food Facts: product by barcode

Look up a packaged product by its barcode: name, brand, ingredients, allergens, and nutrition per 100g, plus the three headline scores, Nutri-Score A to E for nutrition, NOVA 1 to 4 for how processed it is, and Eco-Score for environmental impact. Four databases sit behind this: ‘database’ defaults to food and also takes beauty (cosmetics), petfood and product (everything else). A barcode in the wrong one comes back naming the right one. Cost: 5 credits per call

Parameter	Type	Required
`barcode`	string	yes
`database`	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":"openfoodfacts","endpoint":"/product","input":{"barcode":"737628064502"}}'

Open Food Facts: search products

Search packaged foods by name, brand, or category, each hit carrying the same nutrition and score fields as a barcode lookup. Food only: the beauty, petfood and product databases have no search index, so reach those by barcode. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`limit`	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":"openfoodfacts","endpoint":"/search","input":{"query":"oat milk","limit":10}}'

Open Prices

Grocery prices collected by the Open Food Facts community from photographed shelf tags and receipts: amount, currency, date and the shop it was seen in, searchable by barcode or by radius around a point. No account needed. (data)

Open Prices: what a product costs

Prices people have photographed off the shelf: the amount, the currency, the date and the named shop. Filter by barcode, by category tag, by a lat/lon and radius to see what a thing costs near a place, or by date to watch it move. Coverage is partial and leans European, about 135,000 of Open Food Facts’ 4.5 million products carry any price at all, so a barcode with no prices is the common case rather than an error. Cost: 5 credits per call

Parameter	Type	Required
`barcode`	string	no
`category_tag`	string	no
`currency`	string	no
`lat`	number	no
`lon`	number	no
`radius_km`	number	no
`date__gte`	string	no
`date__lte`	string	no
`price__gte`	number	no
`price__lte`	number	no
`price_is_discounted`	boolean	no
`order_by`	string	no
`page`	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":"openprices","endpoint":"/prices","input":{"lat":48.85,"lon":2.35,"radius_km":5,"limit":10}}'

Open Prices: shops with prices on file

The shops behind the prices, each with its address, coordinates and how many prices and products it has on file. Names come from OpenStreetMap in the local language, so ‘country’ matches Deutschland rather than Germany. Cost: 5 credits per call

Parameter	Type	Required
`name`	string	no
`city`	string	no
`country`	string	no
`min_prices`	integer	no
`order_by`	string	no
`page`	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":"openprices","endpoint":"/locations","input":{"city":"Paris","limit":10}}'

Nomads.com

Where to live and work remotely: cost of living, rent, coworking, internet speed, live weather and air quality, and safety, healthcare, walkability and nightlife scores for about 1,370 cities, plus the meetups happening in them. No account needed. (data)

Nomads.com: find a city to live and work remotely

Rank about 1,370 cities on what it costs to live there for a nomad, expat, local or family, rent and coworking, internet speed, the weather and air quality right now, and scores out of 5 for safety, cleanliness, fun, nightlife, walkability, healthcare, English, and how LGBT- and female-friendly it is, plus whether it has a remote work visa. Filter by region, country, budget, minimum internet, minimum safety and a temperature range. Ordered best first, so no filters gives the live top ranking. Cost: 5 credits per call

Parameter	Type	Required
`region`	string	no
`country`	string	no
`max_cost_usd`	number	no
`min_internet_mbps`	number	no
`min_safety`	number	no
`min_temperature_c`	number	no
`max_temperature_c`	number	no
`limit`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"nomads","endpoint":"/search","input":{"region":"Asia","max_cost_usd":2000,"min_internet_mbps":20,"limit":10}}'

Nomads.com: one city in detail

The same curated set of costs, scores and live weather for a single city, by the slug a search returns, for example lisbon-portugal. Cost: 5 credits 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":"nomads","endpoint":"/city","input":{"slug":"lisbon-portugal"}}'

Nomads.com: upcoming nomad meetups

Where and when nomads are meeting in person over the next days: venue, local time and how many people are going. Filter by city slug or country. Attendance is a headcount only, never who is going or who organises. Cost: 5 credits per call

Parameter	Type	Required
`city`	string	no
`country`	string	no
`days_ahead`	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":"nomads","endpoint":"/meetups","input":{"country":"Portugal","days_ahead":30,"limit":10}}'

Nomads.com: the ranked city list with coordinates

All 1,374 cities in rank order, each with latitude and longitude, nomad and life scores, cost of living, internet speed, temperature, air quality, population and photos. This is the list behind the map, so it carries coordinates and rank that a search hit does not, and fewer of the detailed scores. Narrow it with region or country, since the whole list is 1.5MB. Cost: 5 credits per call

Parameter	Type	Required
`region`	string	no
`country`	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":"nomads","endpoint":"/cities","input":{"region":"Europe","limit":50}}'

Nomads.com: your own trip history

Your past and upcoming stays on Nomads.com: city, country and dates. Reads your own account only, using the username and personal key you connected.

Bring your own key — connect Nomads.com 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":"nomads","endpoint":"/trips","input":{}}'

Nomads.com: add a trip to your history

Record a stay on your own Nomads.com profile: a start and end date plus the city, given either as a city_slug from a search or as latitude and longitude, which are snapped to the nearest Nomads.com city within 80km. Writes to your account.

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

Cost: 5 credits per call

Parameter	Type	Required
`date_start`	string	yes
`date_end`	string	yes
`city_slug`	string	no
`latitude`	number	no
`longitude`	number	no
`city`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"nomads","endpoint":"/trips/add","input":{"city_slug":"lisbon-portugal","date_start":"2026-10-01","date_end":"2026-10-21"}}'

Hacker News

Search Hacker News stories and comments by topic, points or date, and read a thread’s full comment tree. No account needed. (social)

Hacker News: search

Search Hacker News stories and comments, with points, comment count and a link to the discussion. Narrow by type (story, comment, show_hn, ask_hn, front_page), by min_points, or since a date. sort date gives newest first instead of most relevant. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`type`	string	no
`sort`	string	string	no
`min_points`	integer	no
`min_comments`	integer	no
`since`	string	no
`limit`	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":"hn","endpoint":"/search","input":{"query":"rust","type":"story","min_points":100,"limit":10}}'

Hacker News: item with comments

One story or comment by id, with its full nested comment tree — the way to read what a thread actually said. 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":"hn","endpoint":"/item","input":{"id":"1"}}'

arXiv

arXiv preprints in physics, maths, CS, biology and economics: search by title, author, abstract or category, fetch a paper by id, or read a paper’s full text. No account needed. (data)

arXiv: search preprints

Search arXiv preprints across physics, maths, CS, biology and economics. A plain phrase searches everything; prefix it to narrow — ti: title, au: author, abs: abstract, cat: category (cs.LG, hep-th). Each result carries its abstract, authors, categories and a direct PDF link. sort date gives newest first. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`sort`	string	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":"arxiv","endpoint":"/search","input":{"query":"cat:cs.LG diffusion models","sort":"date","limit":10}}'

arXiv: paper by id

Fetch a preprint by its arXiv id (1706.03762, or 1706.03762v5 for a specific version), with abstract, authors, categories, DOI, journal reference and PDF link. Accepts several ids separated by commas, or a full arxiv.org URL. 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":"arxiv","endpoint":"/paper","input":{"id":"1706.03762"}}'

arXiv: full paper text

Read a preprint’s actual text rather than its abstract — introduction, method, results and all — by id or arxiv.org URL. A typical paper comes back around 38,000 characters against 1,100 for the abstract. A paper arXiv has not rendered falls back to the abstract and says so in source. max_chars caps the response. Cost: 5 credits per call

Parameter	Type	Required
`id`	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":"arxiv","endpoint":"/fulltext","input":{"id":"1706.03762"}}'

Open-Meteo

Weather by place name or coordinates: forecast, recorded weather back to 1940, air quality, river discharge, waves, elevation, and place-to-coordinates lookup. No account needed. (weather)

Weather forecast

Weather for a place by name or coordinates: current conditions and a daily forecast up to 16 days, with conditions written out rather than left as a WMO code. Times are local to the place. Override the variables with current, daily or hourly if you want something specific. Cost: 5 credits per call

Parameter	Type	Required
`place`	string	no
`latitude`	number	no
`longitude`	number	no
`days`	integer	no
`current`	string	no
`daily`	string	no
`hourly`	string	no
`timezone`	string	no
`temperature_unit`	string	no
`wind_speed_unit`	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":"openmeteo","endpoint":"/forecast","input":{"place":"Bengaluru","days":3}}'

Historical weather

Recorded weather for a past date range, anywhere, back to 1940. Answers what the weather actually was on a day, or how a month compares to the same month in other years. Cost: 5 credits per call

Parameter	Type	Required
`place`	string	no
`latitude`	number	no
`longitude`	number	no
`start_date`	string	yes
`end_date`	string	yes
`daily`	string	no
`hourly`	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":"openmeteo","endpoint":"/historical","input":{"place":"London","start_date":"2025-07-01","end_date":"2025-07-07"}}'

Air quality

Air quality for a place: PM2.5, PM10, ozone, carbon monoxide, and both the US and European AQI, which use different scales and will not agree. Current plus a short forecast. Cost: 5 credits per call

Parameter	Type	Required
`place`	string	no
`latitude`	number	no
`longitude`	number	no
`days`	integer	no
`current`	string	no
`hourly`	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":"openmeteo","endpoint":"/air-quality","input":{"place":"Delhi"}}'

River discharge and flood risk

Daily river discharge from the GloFAS global flood model, up to 210 days ahead. Discharge rising far above its usual range is the flood signal; the number alone means little without that comparison. Cost: 5 credits per call

Parameter	Type	Required
`place`	string	no
`latitude`	number	no
`longitude`	number	no
`days`	integer	no
`start_date`	string	no
`end_date`	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":"openmeteo","endpoint":"/flood","input":{"place":"Patna","days":14}}'

Marine and wave forecast

Wave height, dominant direction and period for a coastal or offshore point. Only covers water — an inland point returns nothing useful. Cost: 5 credits per call

Parameter	Type	Required
`place`	string	no
`latitude`	number	no
`longitude`	number	no
`days`	integer	no
`daily`	string	no
`current`	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":"openmeteo","endpoint":"/marine","input":{"latitude":54.5,"longitude":8}}'

Place to coordinates

Turn a place name into coordinates, with country, region, timezone, elevation and population — the last of which is the usual way to tell which of several same-named places was meant. The other tools here accept a place name directly, so this is for when you want the coordinates themselves. Cost: 5 credits per call

Parameter	Type	Required
`name`	string	yes
`limit`	integer	no
`language`	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":"openmeteo","endpoint":"/geocode","input":{"name":"Springfield","limit":5}}'

Elevation

Ground elevation in metres at a place or point, from a 90m digital elevation model. Cost: 5 credits per call

Parameter	Type	Required
`place`	string	no
`latitude`	number	no
`longitude`	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":"openmeteo","endpoint":"/elevation","input":{"place":"Leh"}}'

STAC

Find satellite imagery of anywhere on Earth: search Microsoft Planetary Computer, AWS Earth Search and USGS LandsatLook by place, date and cloud cover, and get direct links to the scenes. No account needed. (data)

Find satellite imagery

Satellite scenes covering a place or bounding box, with the date, cloud cover and direct links to the imagery. Give a place name and it searches a box around it, or pass an explicit bbox. max_cloud matters more than it looks: over somewhere monsoonal, most scenes are unusable, so filtering can legitimately return nothing. Collection ids differ per catalogue — see stac.collections. Cost: 5 credits per call

Parameter	Type	Required
`collections`	string	yes
`place`	string	no
`bbox`	string	number[]	no
`radius_km`	integer	no
`start_date`	string	no
`end_date`	string	no
`max_cloud`	integer	no
`catalog`	string	string	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":"stac","endpoint":"/search","input":{"collections":"sentinel-2-l2a","place":"Bengaluru","max_cloud":30,"limit":5}}'

What imagery a catalogue holds

The collections available in a catalogue — Microsoft Planetary Computer carries well over a hundred, USGS LandsatLook the Landsat archive, AWS Earth Search open Sentinel and Landsat. Ask here before searching, because a collection id from one catalogue returns nothing on another rather than erroring. Cost: 5 credits per call

Parameter	Type	Required
`catalog`	string	string	string	no
`query`	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":"stac","endpoint":"/collections","input":{"catalog":"planetary","query":"sentinel"}}'

One satellite scene

A single scene by its id, with every asset link. On Planetary Computer the links are signed for you, since unsigned ones are refused; those signatures expire about an hour after they are issued. Cost: 5 credits per call

Parameter	Type	Required
`collection`	string	yes
`id`	string	yes
`catalog`	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":"stac","endpoint":"/item","input":{"catalog":"earth-search","collection":"sentinel-2-l2a","id":"S2B_43PGQ_20260810_0_L2A"}}'

OCHA HAPI

UN humanitarian data on one set of boundaries: displacement, refugees, people in need, appeal funding, conflict events, food insecurity and market prices, down to district level. No account needed. (humanitarian)

People displaced inside a country

Internally displaced people by country and district, from IOM’s displacement tracking. Answers at the national total unless you name an admin1 or admin2, and returns the most recent reporting rounds first — the raw dataset is unordered, so an unsorted read hands back whichever decade it happens to start on. Distinct from humdata.refugees, which counts people who crossed a border. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`admin1`	string	no
`admin2`	string	no
`admin_level`	integer	no
`start_date`	string	no
`end_date`	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":"humdata","endpoint":"/idps","input":{"country":"Sudan","limit":10}}'

Refugees and people of concern

Refugee and asylum-seeker counts from UNHCR, as flows: ‘origin’ is the country people fled, ‘asylum’ is where they are now. Give either to see one side of the movement, or both for a single corridor. At least one is required, because the unfiltered dataset is every corridor on earth. Cost: 5 credits per call

Parameter	Type	Required
`origin`	string	no
`asylum`	string	no
`population_group`	string	no
`gender`	string	no
`start_date`	string	no
`end_date`	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":"humdata","endpoint":"/refugees","input":{"origin":"Syria","asylum":"Turkiye","limit":10}}'

How many people need aid

People in need, targeted and reached, broken down by sector — health, protection, food security, shelter and the rest — from the humanitarian needs overviews. Filter by sector to answer ‘how many need clean water in Yemen’ rather than the headline figure. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`admin1`	string	no
`admin2`	string	no
`admin_level`	integer	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`sector`	string	no
`status`	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":"humdata","endpoint":"/needs","input":{"country":"Yemen","sector":"Health","limit":10}}'

Humanitarian appeal funding

What a humanitarian appeal asked for, what it actually received, and the percentage covered, from OCHA’s financial tracking. Appeals run back to the 1990s and are returned newest first, so the current one leads. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`appeal_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":"humdata","endpoint":"/funding","input":{"country":"Sudan","limit":5}}'

Conflict events and fatalities

Monthly counts of conflict events and fatalities by district, from ACLED. event_type separates battles from violence against civilians and remote explosives. Answers at admin1 by default, since a conflict is reported where it happened rather than as a national figure. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`admin1`	string	no
`admin2`	string	no
`admin_level`	integer	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`event_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":"humdata","endpoint":"/conflict","input":{"country":"Myanmar","event_type":"civilian_targeting","limit":10}}'

Which organisations work where

Which aid organisations are operating in which districts and sectors — the 3W, who does what where. There is no national row: an organisation is present in places, so this answers at admin1 and below. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`admin1`	string	no
`admin2`	string	no
`admin_level`	integer	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`sector`	string	no
`org`	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":"humdata","endpoint":"/operations","input":{"country":"Chad","sector":"Protection","limit":15}}'

Food insecurity by IPC phase

How many people sit in each IPC phase, 1 (minimal) through 5 (famine), with the share of the population that is. Defaults to the current assessment; pass ipc_type ‘projected’ for the forward look. Phase 3 and above is the number usually quoted as ‘in crisis’. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`admin1`	string	no
`admin2`	string	no
`admin_level`	integer	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`ipc_phase`	string	no
`ipc_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":"humdata","endpoint":"/food-security","input":{"country":"Somalia","ipc_phase":"3","limit":10}}'

Staple food prices in local markets

What staples actually cost in monitored markets, from WFP’s price monitoring, with a flag for whether a price is unusually high. Useful as an early signal: market prices move before an IPC classification does. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`admin1`	string	no
`admin2`	string	no
`admin_level`	integer	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`commodity`	string	no
`market`	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":"humdata","endpoint":"/food-prices","input":{"country":"Nigeria","commodity":"Maize","limit":15}}'

Baseline population by district

Population by country, province and district, split by gender and age band, from the common operational datasets. This is the denominator the other tools imply: it turns ‘2 million affected’ into a share of the people who live there. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`admin1`	string	no
`admin2`	string	no
`admin_level`	integer	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`gender`	string	no
`age_range`	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":"humdata","endpoint":"/population","input":{"country":"Afghanistan","admin1":"Kabul","limit":10}}'

Country crisis risk ranking

INFORM risk scores and global rank per country, split into hazard exposure, vulnerability and lack of coping capacity. Omit country and pass top_n to rank the most at-risk countries rather than looking one up. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	no
`start_date`	string	no
`end_date`	string	no
`limit`	integer	no
`risk_class`	string	no
`top_n`	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":"humdata","endpoint":"/risk","input":{"top_n":20}}'

Countries covered, and which have an active response

Every country in the dataset with its ISO3 code, flagged for whether it has a humanitarian response plan and whether it is in the global humanitarian overview. Pass has_hrp to list the countries with an active response rather than all 250. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	no
`has_hrp`	boolean	no
`in_gho`	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":"humdata","endpoint":"/locations","input":{"has_hrp":true}}'

UN Statistics

The UN’s own numbers: merchandise trade between any two countries by commodity, population from 1950 to 2100, and the Sustainable Development Goal indicators. No account needed. (statistics)

What a country trades, and with whom

Merchandise trade from UN Comtrade: what one country exported or imported in a year, in US dollars, by partner and commodity. Leave partner out for the world total, or name one for a single corridor. flow is X for exports, M for imports. Commodity is an HS code — find it with un.commodities. One year per call, because the open endpoint allows one period per request, and it is rate limited to about a request a second. Cost: 5 credits per call

Parameter	Type	Required
`reporter`	string	yes
`partner`	string	no
`flow`	string	string	no
`year`	integer	no
`commodity`	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":"un","endpoint":"/trade","input":{"reporter":"India","partner":"Germany","commodity":"0901","year":2023}}'

HS commodity codes by name

Look up the Harmonised System code for a product, which is what un.trade filters on. Codes nest by length: 09 is coffee, tea and spices, 0901 is coffee, 090111 is green coffee beans, so a shorter code is the broader category. Broadest matches are returned first. Cost: 5 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":"un","endpoint":"/commodities","input":{"query":"coffee"}}'

The Sustainable Development Goals and targets

All 17 goals with the 169 targets under them, or one goal with its own. This is the map: it tells you which goal a question belongs to before you go looking for the series that measures it. Cost: 5 credits per call

Parameter	Type	Required
`goal`	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":"un","endpoint":"/sdg-goals","input":{"goal":"6"}}'

Find an SDG series to ask about

Search the 700-odd statistical series behind the SDG indicators by keyword or goal, and get the series code un.sdg_data needs. Search here first: an indicator like 1.1.1 is a concept, while a series like SI_POV_DAY1 is the thing with numbers attached. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	no
`goal`	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":"un","endpoint":"/sdg-series","input":{"query":"drinking water"}}'

SDG indicator values for a country

The actual numbers for one series, newest year first, with the source behind each. Omit country for every country reporting it. Most series are broken down by sex, age or urban and rural, so one year can carry several rows and the dimensions on each row are what separate them. Cost: 5 credits per call

Parameter	Type	Required
`series`	string	yes
`country`	string	no
`start_year`	integer	no
`end_year`	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":"un","endpoint":"/sdg-data","input":{"series":"SI_POV_DAY1","country":"India"}}'

Population, past and projected

World Population Prospects: a country’s population by year, from 1950 to 2100, and eighty-odd other demographic indicators — fertility, life expectancy, median age, migration — via un.population_indicators. Answers the median projection for both sexes, which is the number normally meant; the alternatives are scenarios, and variant names one (high-fertility, zero-migration, constant-mortality). Anything past the present year is a projection, not a measurement. Cost: 5 credits per call

Parameter	Type	Required
`country`	string	yes
`indicator`	string	no
`start_year`	integer	no
`end_year`	integer	no
`variant`	string	no
`sex`	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":"un","endpoint":"/population","input":{"country":"India","start_year":2020,"end_year":2030}}'

What the population database measures

The demographic indicators available to un.population, with the code each needs. Search for what you are after — ‘fertility’, ‘life expectancy’, ‘migration’ — since the names are precise and the right one is rarely the first guess. Cost: 5 credits per call

Parameter	Type	Required
`query`	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":"un","endpoint":"/population-indicators","input":{"query":"life expectancy"}}'

DigitalOcean

Your DigitalOcean infrastructure: droplets, App Platform, managed databases, Kubernetes, DNS, storage, networking and billing, with power and deploy controls (bring your own token). (dev)

DigitalOcean account

Who the token belongs to: email, team, verification status, and the droplet and volume limits on the account. The quickest check that a connection is live and which team it reaches.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/account","input":{}}'

Account balance

Current month-to-date usage, account balance and the last invoice amount. Month-to-date is what has accrued since the last bill, not a forecast of the next one.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/balance","input":{}}'

Billing history

Past invoices with their amounts and periods. Pair with digitalocean.balance for what is accruing now.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/invoices","input":{"per_page":12}}'

List droplets

Every droplet on the account with its status, size, region, IP addresses and tags. Filter by tag_name to scope to one fleet. Pages are 20 by default and cap at 200.

Bring your own key — connect DigitalOcean 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
`tag_name`	string	no
`name`	string	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":"digitalocean","endpoint":"/droplets","input":{"tag_name":"production","per_page":50}}'

One droplet

Full detail for a single droplet: status, networking, the image and size it runs, attached volumes and its current features.

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

Cost: 5 credits per call

Parameter	Type	Required
`droplet_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":"digitalocean","endpoint":"/droplet","input":{"droplet_id":3164444}}'

Power, reboot, resize or snapshot a droplet

Runs one action against a droplet: power_on, power_off, reboot, shutdown, power_cycle, snapshot, resize, rebuild, restore, rename, enable_backups, disable_backups, enable_ipv6, change_kernel or password_reset. This returns an action that is still in progress, not a finished one — the reboot has been accepted, not completed — so check digitalocean.action with the returned id to see whether it actually succeeded. shutdown asks the OS politely and can be refused; power_off is the plug, and can corrupt what was mid-write. resize needs the droplet powered off first.

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

Cost: 5 credits per call

Parameter	Type	Required
`droplet_id`	string	integer	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":"digitalocean","endpoint":"/droplet-action","input":{"droplet_id":3164444,"type":"reboot"}}'

Create a droplet

Spins up a new droplet, which starts billing immediately. Needs a region and size slug and an image — see digitalocean.regions, digitalocean.sizes and digitalocean.images. Pass ssh_keys with your key ids, because a droplet created without them mails a root password instead. Returns before the droplet is ready; it comes back with status ‘new’ and becomes ‘active’ a minute or so later.

Bring your own key — connect DigitalOcean 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
`region`	string	yes
`size`	string	yes
`image`	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":"digitalocean","endpoint":"/create-droplet","input":{"name":"web-1","region":"blr1","size":"s-1vcpu-1gb","image":"ubuntu-24-04-x64"}}'

Destroy a droplet

Permanently destroys one droplet and the local disk with it. There is no undo and no recycle bin: anything not on an attached volume or in a snapshot is gone. Answers 204 with an empty body on success. Backups and snapshots survive and keep billing separately.

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

Cost: 5 credits per call

Parameter	Type	Required
`droplet_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":"digitalocean","endpoint":"/delete-droplet","input":{"droplet_id":3164444}}'

Destroy every droplet with a tag

Destroys ALL droplets carrying the given tag, however many that is, in one call. This is the fleet-wide delete and it is deliberately separate from deleting one droplet. DigitalOcean answers 204 with no body, so nothing comes back saying how many were destroyed or which — list them with digitalocean.droplets on the same tag first, because afterwards there is no record to check against.

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

Cost: 5 credits per call

Parameter	Type	Required
`tag_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":"digitalocean","endpoint":"/delete-droplets-by-tag","input":{"tag_name":"staging-ephemeral"}}'

Did that action finish?

The status of one asynchronous action: in-progress, completed or errored, with when it started and finished. Droplet actions, resizes and snapshots all return immediately and finish later, so this is how you learn a reboot or resize actually worked rather than assuming it from the accepted request.

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

Cost: 5 credits per call

Parameter	Type	Required
`action_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":"digitalocean","endpoint":"/action","input":{"action_id":36804636}}'

List App Platform apps

Every app on the account with its live URL, region, current deployment and the spec it runs.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/apps","input":{}}'

One app

Full detail for an app: its spec, components, active deployment, domains and region.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/app","input":{"app_id":"4f6c71e2-1e90-4762-9fee-6cc4a0a9f2d5"}}'

An app’s deployments

Deployment history for an app, newest first, with the phase each reached and what caused it. The phase is where a failed deploy explains itself: BUILD, DEPLOY, ACTIVE, ERROR or SUPERSEDED.

Bring your own key — connect DigitalOcean 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
`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":"digitalocean","endpoint":"/app-deployments","input":{"app_id":"4f6c71e2-1e90-4762-9fee-6cc4a0a9f2d5","per_page":5}}'

Deploy an app

Triggers a new deployment of an app’s current spec. force_build skips the build cache and rebuilds from scratch, which is what you want when a deploy succeeded but shipped stale code. Returns the deployment in its first phase, not a finished rollout.

Bring your own key — connect DigitalOcean 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
`force_build`	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":"digitalocean","endpoint":"/create-app-deployment","input":{"app_id":"4f6c71e2-1e90-4762-9fee-6cc4a0a9f2d5","force_build":true}}'

Restart an app

Restarts a running app without rebuilding it. Name components to restart only some of them; leave it out for all. Use this over a redeploy when the code is fine and the process is not.

Bring your own key — connect DigitalOcean 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
`components`	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":"digitalocean","endpoint":"/restart-app","input":{"app_id":"4f6c71e2-1e90-4762-9fee-6cc4a0a9f2d5"}}'

App logs

Logs for an app: RUN for the running process (the default), BUILD for what happened while building, DEPLOY for the rollout. Returns time-limited URLs to the log content rather than the text itself, so fetch them promptly. BUILD is where a failed deployment usually says why.

Bring your own key — connect DigitalOcean 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
`type`	string	string	string	no
`tail_lines`	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":"digitalocean","endpoint":"/app-logs","input":{"app_id":"4f6c71e2-1e90-4762-9fee-6cc4a0a9f2d5","type":"BUILD"}}'

Delete an app

Permanently deletes an App Platform app and takes its live URL down with it. Databases the app provisioned as part of its spec go too; separately created managed databases do not.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/delete-app","input":{"app_id":"4f6c71e2-1e90-4762-9fee-6cc4a0a9f2d5"}}'

Managed database clusters

Every managed database cluster: engine, version, size, region, node count and status. DigitalOcean’s engines are PostgreSQL, MySQL, MongoDB, Kafka, Valkey and OpenSearch — Valkey is what it offers instead of Redis.

Bring your own key — connect DigitalOcean 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
`tag_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":"digitalocean","endpoint":"/databases","input":{}}'

One database cluster

Full detail for a cluster, including its connection details. The connection object carries the password in plaintext, which is the point of the endpoint and worth knowing before you log the response.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/database","input":{"database_id":"9cc10173-e9ea-4176-9dbc-a4cee4c4ff30"}}'

Kubernetes clusters

DOKS clusters with their version, region, node pools and status.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/kubernetes-clusters","input":{}}'

One Kubernetes cluster

Full detail for a DOKS cluster: node pools, versions, maintenance window and endpoint.

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

Cost: 5 credits per call

Parameter	Type	Required
`cluster_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":"digitalocean","endpoint":"/kubernetes-cluster","input":{"cluster_id":"bd5f5959-5e1e-4205-a714-a914373942af"}}'

DNS zones on the account

The zones whose DNS DigitalOcean hosts for you. This is hosted DNS only: it says nothing about who a domain is registered with, and nothing about whether a name is available to buy.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/domains","input":{}}'

DNS records for a domain

The DNS records in a zone, filterable by type (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA) or by record_name. Names come back relative to the zone, so the apex is ’@’ rather than the domain itself.

Bring your own key — connect DigitalOcean 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
`domain`	string	yes
`type`	string	no
`record_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":"digitalocean","endpoint":"/domain-records","input":{"domain":"example.com","type":"A"}}'

Add a DNS record

Adds one record to a zone. name is relative to the domain — ’@’ for the apex, ‘www’ for a subdomain, never the full hostname. CNAME and MX data must be fully qualified and end with a dot. ttl is in seconds and defaults to 1800.

Bring your own key — connect DigitalOcean 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
`type`	string	yes
`name`	string	no
`data`	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":"digitalocean","endpoint":"/create-domain-record","input":{"domain":"example.com","type":"A","name":"www","data":"203.0.113.10","ttl":3600}}'

Change a DNS record

Updates fields on an existing record — usually data or ttl. Only what you pass changes; the rest is left alone.

Bring your own key — connect DigitalOcean 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
`record_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":"digitalocean","endpoint":"/update-domain-record","input":{"domain":"example.com","record_id":3352896,"data":"203.0.113.11"}}'

Delete a DNS record

Removes one record from a zone, permanently. Deleting the wrong A or MX record takes a site or its mail off the internet as soon as caches expire, so read it with digitalocean.domain_records first.

Bring your own key — connect DigitalOcean 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
`record_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":"digitalocean","endpoint":"/delete-domain-record","input":{"domain":"example.com","record_id":3352896}}'

Block storage volumes

Volumes with their size, region and which droplet each is attached to. A volume outlives the droplet it was attached to, and keeps billing.

Bring your own key — connect DigitalOcean 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
`name`	string	no
`region`	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":"digitalocean","endpoint":"/volumes","input":{}}'

Snapshots

Droplet and volume snapshots with their sizes and regions. resource_type narrows to ‘droplet’ or ‘volume’. Snapshots bill by the gigabyte until deleted.

Bring your own key — connect DigitalOcean 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
`resource_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":"digitalocean","endpoint":"/snapshots","input":{"resource_type":"droplet"}}'

Images

Available images: distributions, one-click applications, and your own snapshots and backups. Pass type ‘distribution’ or ‘application’, or private true for only your own. The slug (e.g. ubuntu-24-04-x64) is what create_droplet wants.

Bring your own key — connect DigitalOcean 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
`type`	string	no
`private`	boolean	no
`tag_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":"digitalocean","endpoint":"/images","input":{"type":"distribution"}}'

Cloud firewalls

Firewalls with their inbound and outbound rules and what they are applied to. Rules list allowed traffic; anything unlisted is denied.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/firewalls","input":{}}'

Load balancers

Load balancers with their forwarding rules, health checks, status and the droplets behind them.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/load-balancers","input":{}}'

Reserved IPs

Reserved (formerly floating) IPs and which droplet each points at. An unassigned reserved IP still bills.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/reserved-ips","input":{}}'

Projects

Projects, which group resources for organisation and billing purposes. Every account has a default project.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/projects","input":{}}'

SSH keys

SSH keys on the account with their fingerprints and ids. Those ids are what create_droplet needs to make a droplet you can log into.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/ssh-keys","input":{}}'

Regions

Datacentre regions with their slugs, the sizes each offers and whether each is currently available. Not every size exists in every region.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/regions","input":{}}'

Droplet sizes

Droplet plans with their slug, memory, vCPUs, disk, transfer allowance and hourly and monthly price, plus the regions each is available in.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/sizes","input":{"per_page":50}}'

DigitalOcean: raw request

Escape hatch: any DigitalOcean v2 path on your token, including the parts not modelled here — uptime checks, container registries, VPCs, CDN endpoints, Spaces keys, monitoring and the GradientAI platform — and including destructive ones.

Bring your own key — connect DigitalOcean 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":"digitalocean","endpoint":"/request","input":{"method":"GET","path":"/uptime/checks"}}'

Monkeytype

The typing test: leaderboards, global speed distributions and any public profile with no account at all, plus your own results, bests, streak and rank with an ApeKey. (data)

Monkeytype’s global totals

Site-wide counters: tests started, tests completed and total seconds spent typing across everyone who has ever used it. Started and completed differ a lot, because an abandoned test still counts as started. 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":"monkeytype","endpoint":"/typing-stats","input":{}}'

How fast everyone actually types

The distribution of results in 10 wpm buckets, so you can see where a speed sits against the field. Defaults to english time 60, the standard test. The counts are results, not people — a fast typist appears once per test they finished. Cost: 5 credits per call

Parameter	Type	Required
`language`	string	no
`mode`	string	no
`mode2`	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":"monkeytype","endpoint":"/speed-histogram","input":{"language":"english","mode":"time","mode2":"60"}}'

All-time leaderboard

The top typists for one test. A board only exists per language, mode and length — english time 60 is the default and the one most people mean — so there is no overall ranking to ask for. limit has a floor of 10. Cost: 5 credits per call

Parameter	Type	Required
`language`	string	no
`mode`	string	no
`mode2`	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":"monkeytype","endpoint":"/leaderboard","input":{"language":"english","mode":"time","mode2":"60","limit":10}}'

Today’s leaderboard

The best results of the current day for one test, which resets daily and is a far more reachable board than all-time. days_before 1 gets yesterday’s final standings. Cost: 5 credits per call

Parameter	Type	Required
`language`	string	no
`mode`	string	no
`mode2`	string	no
`page`	integer	no
`limit`	integer	no
`days_before`	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":"monkeytype","endpoint":"/daily-leaderboard","input":{"mode":"time","mode2":"15"}}'

Weekly XP leaderboard

Who earned the most XP this week. This one rewards volume rather than speed, so it ranks the people who typed the most, not the fastest. Cost: 5 credits per call

Parameter	Type	Required
`page`	integer	no
`limit`	integer	no
`weeks_before`	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":"monkeytype","endpoint":"/weekly-xp","input":{}}'

Anyone’s public profile

A public profile by username: personal bests across every test type, total tests, time typing, streak and when they joined. No credential needed — this works for any user, not just you. Cost: 5 credits per call

Parameter	Type	Required
`username`	string	yes
`uid`	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":"monkeytype","endpoint":"/profile","input":{"username":"Miodec"}}'

Your typing totals

Your own completed and started tests and total time typing. Needs an ApeKey from your Monkeytype account settings.

Bring your own key — connect Monkeytype 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":"monkeytype","endpoint":"/my-stats","input":{}}'

Your streak

Your current and longest daily streak, and when it was last extended.

Bring your own key — connect Monkeytype 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":"monkeytype","endpoint":"/streak","input":{}}'

Your personal bests

Your best results for a mode. Pass mode ‘time’ or ‘words’; leave mode2 out for every length in that mode, or set it (15, 60, 25, 50) for one.

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

Cost: 5 credits per call

Parameter	Type	Required
`mode`	string	no
`mode2`	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":"monkeytype","endpoint":"/personal-bests","input":{"mode":"time"}}'

Your recent test results

Your own tests, newest first, with wpm, raw wpm, accuracy, consistency and the test settings for each. on_or_after takes a millisecond epoch timestamp to window it. This is the one to use for tracking progress over time rather than a single best.

Bring your own key — connect Monkeytype 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
`on_or_after`	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":"monkeytype","endpoint":"/my-results","input":{"limit":25}}'

Your last test

The single most recent test you finished, in full.

Bring your own key — connect Monkeytype 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":"monkeytype","endpoint":"/last-result","input":{}}'

Where you rank

Your position on one leaderboard, with the total number of entries so the rank means something. Ranks are per test, so your english time 60 standing says nothing about words 50.

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

Cost: 5 credits per call

Parameter	Type	Required
`language`	string	no
`mode`	string	no
`mode2`	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":"monkeytype","endpoint":"/my-rank","input":{"mode":"time","mode2":"60"}}'

Microsoft Clarity

Your Clarity project’s dashboard metrics: traffic, engagement, scroll depth and the frustration signals — rage clicks, dead clicks, quickbacks — for the last three days (bring your own token). (analytics)

Clarity dashboard metrics

Your Clarity project’s numbers for the last 1 to 3 days: traffic, engagement time, scroll depth, popular pages, and the frustration signals Clarity is actually useful for — rage clicks, dead clicks, excessive scroll, quickbacks and script errors. Break them down by up to three of Browser, Device, Country/Region, OS, Source, Medium, Campaign, Channel or URL. Two hard limits worth planning around: only ten requests per project per day, and no history beyond three days — this API cannot answer what happened last week. It returns aggregates only; session recordings and heatmaps are not available through it.

Bring your own key — connect Microsoft Clarity 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
`dimensions`	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":"clarity","endpoint":"/insights","input":{"days":3,"dimensions":"Device,Country/Region"}}'

OpenAI

Generate and edit images with gpt-image-2.5, on your own key or ours. (ai)

Generate an image

Generate an image from a text prompt with gpt-image-2.5, which renders text inside images far better than diffusion models do. Flare (default) is the fast everyday model; sunburst is slower and more precise. Quality runs low to max, size is any WIDTHxHEIGHT up to 4K, and background: transparent gives a cutout. Returns base64 rather than a URL, because OpenAI offers no URL option: higher quality and larger sizes mean a multi-megabyte response, so leave quality at low unless detail matters. To change an image you already have, use /images/edits. Runs on your own OpenAI key if you connect one, otherwise on fetchbean’s. Cost: 5 to 8539 credits

Parameter	Type	Required
`prompt`	string	yes
`model`	string	no
`quality`	string	no
`size`	string	no
`background`	string	no
`output_format`	string	no
`output_compression`	integer	no
`n`	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":"openai","endpoint":"/images/generations","input":{"prompt":"a storefront sign reading OPEN LATE, warm evening light"}}'

Edit an image, or compose one from references

Change an image you already have, or make a new one from up to 16 reference images, with gpt-image-2.5: ‘swap the sign to CLOSED’, ‘put this product on a marble counter’, ‘the same character in a rainy street’. Inputs are URLs, data: URIs or base64. A mask limits the edit to its transparent pixels. Sunburst is OpenAI’s pick when edit precision matters; flare (default) is faster. Returns base64 like /images/generations, and the input images add to the price on fetchbean’s key. Runs on your own OpenAI key if you connect one, otherwise on fetchbean’s. Cost: 5 to 8539 credits

Parameter	Type	Required
`prompt`	string	yes
`images`	string	string[]	yes
`mask`	string	no
`model`	string	no
`quality`	string	no
`size`	string	no
`background`	string	no
`output_format`	string	no
`output_compression`	integer	no
`n`	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":"openai","endpoint":"/images/edits","input":{"prompt":"change the sign to read CLOSED, keep everything else identical","images":"https://example.com/storefront.jpg"}}'

Gemini

Generate and edit images with Google’s Gemini image models — the same call does both, so you can hand it a photo and say what to change (bring your own key). (ai)

Generate or edit an image with Gemini

Make an image from a prompt, or edit one you already have by passing it alongside the prompt — the same call does both, so ‘put this product on a marble counter’ is one request with the product photo attached. Input images are base64 or a data: URI, not URLs. Defaults to gemini-3.1-flash-image; gemini-3-pro-image handles complex scenes and legible text better, gemini-3.1-flash-lite-image is cheapest and 1K only. aspect_ratio (16:9, 1:1, 9:16) and image_size (1K, 2K, 4K) shape the output. Returns base64, because Google offers no URL option, so a 4K image is a multi-megabyte response. Runs on your own Google AI key.

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

Cost: 5 credits per call

Parameter	Type	Required
`prompt`	string	yes
`image`	string	string[]	no
`model`	string	no
`aspect_ratio`	string	no
`image_size`	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":"gemini","endpoint":"/image","input":{"prompt":"a storefront sign reading OPEN LATE, warm evening light","aspect_ratio":"16:9"}}'

Calendly

Your Calendly: what is booked, who booked it and what they said, your meeting types and open slots, plus single-use links and cancellations (bring your own token). (productivity)

Who this token belongs to

Your Calendly user: name, email, timezone, scheduling URL, and the canonical URIs for you and your organization. Most other endpoints identify people by those URIs rather than by email, though the tools here resolve yours for you.

Bring your own key — connect Calendly 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":"calendly","endpoint":"/me","input":{}}'

Your bookable meeting types

The meeting types people can book — the 30-minute intro, the demo — with their duration, scheduling URL and whether each is active. Defaults to yours; pass a user URI for someone else in the organization. This is where the event_type a scheduling link or availability lookup needs comes from.

Bring your own key — connect Calendly 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
`active`	boolean	no
`limit`	integer	no
`page_token`	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":"calendly","endpoint":"/event-types","input":{"active":true}}'

Meetings on the calendar

Scheduled meetings with their times, status and who is on them, soonest first. Defaults to yours — pass organization to see the whole team’s instead. start_after and start_before take a plain date or a full timestamp; a bare date covers the whole day. status ‘canceled’ finds what fell through.

Bring your own key — connect Calendly 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
`organization`	string	no
`status`	string	string	no
`start_after`	string	no
`start_before`	string	no
`limit`	integer	no
`page_token`	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":"calendly","endpoint":"/events","input":{"start_after":"2026-08-23","status":"active"}}'

One meeting

Full detail for a single meeting: location, guests, host memberships, and the cancellation if it was called off. Takes the uuid or the full event URI.

Bring your own key — connect Calendly 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`	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":"calendly","endpoint":"/event","input":{"event":"AAAAAAAAAAAAAAAA"}}'

Who booked a meeting

The invitees on a meeting with their name, email, timezone, and the answers they gave to your booking questions — which is where the context about why they booked usually lives. Includes reschedule and cancellation state.

Bring your own key — connect Calendly 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`	string	yes
`status`	string	no
`email`	string	no
`limit`	integer	no
`page_token`	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":"calendly","endpoint":"/invitees","input":{"event":"AAAAAAAAAAAAAAAA"}}'

Open slots for a meeting type

The bookable slots for one event type in a window — what someone visiting your link would see. The window must start in the future and cover no more than 7 days, which is Calendly’s limit rather than ours.

Bring your own key — connect Calendly 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`	string	yes
`start_time`	string	yes
`end_time`	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":"calendly","endpoint":"/available-times","input":{"event_type":"AAAAAAAAAAAAAAAA","start_time":"2026-08-25","end_time":"2026-08-29"}}'

When someone is already busy

Existing commitments in a window, both Calendly bookings and external calendar events. The inverse of available_times and the better question when you want to know whether a person is free rather than what a specific meeting type offers. Window is capped at 7 days.

Bring your own key — connect Calendly 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
`start_time`	string	yes
`end_time`	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":"calendly","endpoint":"/busy-times","input":{"start_time":"2026-08-25","end_time":"2026-08-29"}}'

Working hours

The availability schedules behind the booking pages — the recurring weekly hours and any date-specific overrides. This is the rule, not the calendar; busy_times is what actually happened.

Bring your own key — connect Calendly 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
(other provider fields)	any	no

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

Make a single-use booking link

Creates a one-time scheduling link for an event type — it stops working once someone books through it, which is what you want when sending a link to one person rather than handing out your permanent URL. Calendly only supports a max of one booking per link.

Bring your own key — connect Calendly 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`	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":"calendly","endpoint":"/scheduling-link","input":{"event_type":"AAAAAAAAAAAAAAAA"}}'

Cancel a meeting

Cancels a scheduled meeting and notifies the invitees, with the reason included in what they receive. This cannot be undone — the booking is gone and the slot reopens — so read it with calendly.event first if there is any doubt which one it is.

Bring your own key — connect Calendly 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`	string	yes
`reason`	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":"calendly","endpoint":"/cancel-event","input":{"event":"AAAAAAAAAAAAAAAA","reason":"Rescheduling to next week"}}'

Crisp

Your Crisp inbox: conversations and transcripts, replying as an operator, resolving threads, and the contacts behind them (bring your own token). (customer-support)

Your Crisp inbox

Conversations in the inbox, newest activity first, each with the visitor, the last message and its state. Filter to unresolved to see what still needs answering, or search with query. Pages are numbered from 1 and hold about 25.

Bring your own key — connect Crisp 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
`query`	string	no
`state`	string	string	no
`unread`	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":"crisp","endpoint":"/conversations","input":{"state":"unresolved"}}'

One conversation

A single conversation’s metadata: the visitor, assigned operator, state, segments and the last message. Use crisp.messages for the transcript itself.

Bring your own key — connect Crisp 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":"crisp","endpoint":"/conversation","input":{"session_id":"session_abc123"}}'

A conversation’s messages

The transcript, with who sent each message and when. Crisp returns the most recent batch; pass before with the earliest timestamp you have to walk further back rather than a page number.

Bring your own key — connect Crisp 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
`before`	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":"crisp","endpoint":"/messages","input":{"session_id":"session_abc123"}}'

Reply in a conversation

Sends a text message into a conversation as an operator — the visitor sees it and is notified, so this is a real reply, not a draft. from ‘user’ instead writes as the visitor themselves, which puts words in their mouth in their own transcript; leave it alone unless that is genuinely what you want.

Bring your own key — connect Crisp 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
`content`	string	yes
`from`	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":"crisp","endpoint":"/send-message","input":{"session_id":"session_abc123","content":"Thanks for reporting this — looking into it now."}}'

Resolve or reopen a conversation

Moves a conversation between pending, unresolved and resolved. Resolving takes it out of the working inbox without deleting anything, and reopening is just setting it back.

Bring your own key — connect Crisp 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
`state`	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":"crisp","endpoint":"/set-state","input":{"session_id":"session_abc123","state":"resolved"}}'

Contacts

People who have talked to you, with their email, company, segments and when they were last seen. Search by name or email with query.

Bring your own key — connect Crisp 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
`query`	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":"crisp","endpoint":"/people","input":{"query":"acme.com"}}'

One contact

A single contact by people id or by email address — Crisp accepts either in the same position, so an email works without looking the id up first.

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

Cost: 5 credits per call

Parameter	Type	Required
`people_id`	string	no
`email`	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":"crisp","endpoint":"/person","input":{"email":"someone@acme.com"}}'

How many contacts you have

Total contact count for the website. The cheap way to size the list before paging through it.

Bring your own key — connect Crisp 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":"crisp","endpoint":"/people-stats","input":{}}'

Miro

Your Miro boards: read what is on a whiteboard, add and edit sticky notes, text and shapes, and manage who can see it (bring your own token). (productivity)

Your Miro boards

Boards you can reach, most recently modified first, with their name, owner, team and view link. Search names with query. Pages by offset and caps at 50 — the item listing pages by cursor instead, which is the one inconsistency in this API worth remembering.

Bring your own key — connect Miro 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
`team_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":"miro","endpoint":"/boards","input":{"query":"roadmap"}}'

One board

Full detail for a board: owner, team, sharing policy, permissions and links. Use miro.items for what is actually on it.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_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":"miro","endpoint":"/board","input":{"board_id":"uXjVKzYQZ5s="}}'

What is on a board

The items on a board with their content, position and size. Filter by type — sticky_note, text, shape, card, image, document, frame, embed — to read just the notes off a workshop board. Pages by cursor, not offset: pass the cursor from the previous response to continue.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_id`	string	yes
`type`	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":"miro","endpoint":"/items","input":{"board_id":"uXjVKzYQZ5s=","type":"sticky_note"}}'

One item

A single item on a board, with its content, geometry, style and parent frame.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_id`	string	yes
`item_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":"miro","endpoint":"/item","input":{"board_id":"uXjVKzYQZ5s=","item_id":"3458764517517819042"}}'

Add something to a board

Puts an item on a board: sticky_note (the default), text, shape, card or frame. x and y are board coordinates measured from the centre, not a corner, and y grows downward — omit them and it lands in the middle, which means a batch of items with no positions will stack on top of each other. parent_id drops it inside a frame.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_id`	string	yes
`content`	string	no
`type`	string	no
`x`	number	no
`y`	number	no
`width`	number	no
`height`	number	no
`fill_color`	string	no
`parent_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":"miro","endpoint":"/create-item","input":{"board_id":"uXjVKzYQZ5s=","content":"Ship the thing","type":"sticky_note","x":0,"y":0}}'

Change an item

Edits an item’s text, moves it, or recolours it. Only what you pass changes. Moving takes both x and y, since a position is a pair.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_id`	string	yes
`item_id`	string	yes
`content`	string	no
`x`	number	no
`y`	number	no
`fill_color`	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":"miro","endpoint":"/update-item","input":{"board_id":"uXjVKzYQZ5s=","item_id":"3458764517517819042","content":"Shipped"}}'

Remove an item from a board

Deletes one item permanently. Deleting a frame does not delete what is inside it; those items are left loose on the board.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_id`	string	yes
`item_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":"miro","endpoint":"/delete-item","input":{"board_id":"uXjVKzYQZ5s=","item_id":"3458764517517819042"}}'

Create a board

Makes a new empty board. It lands in your default team unless you name one, and comes back with the id every other tool here needs.

Bring your own key — connect Miro 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
`description`	string	no
`team_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":"miro","endpoint":"/create-board","input":{"name":"Q4 planning"}}'

Delete a board

Moves a board to trash along with everything on it. Recoverable from Miro’s trash for a limited window, unlike deleting a single item, but everyone who had it shared with them loses access immediately.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_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":"miro","endpoint":"/delete-board","input":{"board_id":"uXjVKzYQZ5s="}}'

Who can see a board

The people a board is shared with and the role each has.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_id`	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":"miro","endpoint":"/members","input":{"board_id":"uXjVKzYQZ5s="}}'

Invites people to a board by email and sends them a notification. Defaults to commenter, the least powerful role; editor lets them change the board and coowner lets them reshare and delete it.

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

Cost: 5 credits per call

Parameter	Type	Required
`board_id`	string	yes
`emails`	string	string[]	yes
`role`	string	no
`message`	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":"miro","endpoint":"/share-board","input":{"board_id":"uXjVKzYQZ5s=","emails":["someone@acme.com"],"role":"editor"}}'

OpenSky

Live aircraft positions and flight history from the OpenSky receiver network: what is flying over a place right now, an airport’s departures and arrivals, and the path a flight actually took. Works with no account; connect one for ten times the daily budget. (data)

Aircraft in the air right now

Live positions from the OpenSky receiver network: callsign, country, latitude and longitude, altitude, speed and heading for everything currently flying over a bounding box. Give lamin/lomin/lamax/lomax, or an icao24 address to follow one aircraft. This is the cheap half of OpenSky — a box under 25 square degrees costs 1 credit against a daily budget, the whole world costs 4 — and the answer says what it charged and what is left. Coverage is volunteer receivers, so it is dense over Europe and thin over oceans and much of Africa. Cost: 5 credits per call

Parameter	Type	Required
`lamin`	number	no
`lomin`	number	no
`lamax`	number	no
`lomax`	number	no
`icao24`	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":"opensky","endpoint":"/states","input":{"lamin":18,"lomin":72,"lamax":20,"lomax":74}}'

Flights that left an airport

Departures from an airport in a time window, with the aircraft, callsign and estimated arrival airport for each. airport is a 4-letter ICAO code (EDDF, KJFK, VIDP), not IATA. begin and end are unix seconds, defaulting to the last hour and capped at 24. Worth knowing before you loop over airports: the historical endpoints cost about 30 credits a call against a separate budget from live positions, where a whole day is 400 credits unconnected and 4,000 connected, so this is roughly thirteen calls a day on the free tier. An empty result means nothing was seen in that window, which is normal at a quiet airport rather than an error. Cost: 5 credits per call

Parameter	Type	Required
`airport`	string	yes
`begin`	integer	no
`end`	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":"opensky","endpoint":"/departures","input":{"airport":"EDDF"}}'

Flights that landed at an airport

Arrivals at an airport in a time window, with the aircraft and its estimated departure airport. Same shape and price as departures: 4-letter ICAO code, unix-second window defaulting to the last hour and capped at 24, about 30 credits a call. Cost: 5 credits per call

Parameter	Type	Required
`airport`	string	yes
`begin`	integer	no
`end`	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":"opensky","endpoint":"/arrivals","input":{"airport":"KJFK"}}'

What one aircraft has been doing

Every flight a single aircraft made in a window, by its icao24 address — the 6 hex digits that identify the airframe itself, not the flight number, so it follows the physical plane across the day rather than one scheduled service. Window defaults to the last hour and is capped at 24; about 30 credits a call. Cost: 5 credits per call

Parameter	Type	Required
`icao24`	string	yes
`begin`	integer	no
`end`	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":"opensky","endpoint":"/aircraft-flights","input":{"icao24":"3c675a"}}'

A flight’s path

The trajectory an aircraft actually flew, as waypoints of time, position, altitude and heading. Leave time out for the flight it is on right now. Labelled here — upstream each waypoint is a bare array with nothing saying which number is which. Cost: 5 credits per call

Parameter	Type	Required
`icao24`	string	yes
`time`	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":"opensky","endpoint":"/track","input":{"icao24":"3c675a"}}'

Travelpayouts

What flights cost: the cheapest recent fares on a route, the cheapest days and months to fly, and where you can go cheaply from a city. Observed fares rather than live availability. Airport and airline lookups need no account. (data)

What a flight costs

The cheapest recent fares on a route, with the dates, airline and number of stops. Origin and destination are 3-letter IATA codes — use travelpayouts.places to find one. Leave destination out to see the cheapest fares from a city to anywhere. Read these as observed prices rather than live availability: they are the fares other travellers actually found, cached, so a figure here tells you what a route usually costs, not what you can book this second. Cost: 5 credits per call

Parameter	Type	Required
`origin`	string	yes
`destination`	string	no
`month`	string	no
`one_way`	boolean	no
`currency`	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":"travelpayouts","endpoint":"/prices","input":{"origin":"DEL","destination":"DXB","currency":"usd"}}'

Cheapest days to fly a route

A price for each departure day in a month on one route, which is the tool for ‘when is it cheapest to go’. month takes YYYY-MM. Same caveat as prices: a cheap-looking day is a fare somebody found recently, not a seat held for you. Cost: 5 credits per call

Parameter	Type	Required
`origin`	string	yes
`destination`	string	yes
`month`	string	no
`currency`	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":"travelpayouts","endpoint":"/calendar","input":{"origin":"DEL","destination":"DXB","month":"2026-11"}}'

Cheapest dates across the year

The lowest fare found for each date on a route, for picking the month rather than the day. Pass by ‘return’ to organise it around the return date instead of the departure. Cost: 5 credits per call

Parameter	Type	Required
`origin`	string	yes
`destination`	string	yes
`month`	string	no
`by`	string	no
`currency`	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":"travelpayouts","endpoint":"/cheapest-month","input":{"origin":"BOM","destination":"LHR"}}'

Where can I fly cheaply from here

Popular destinations from one city ranked by how cheap the fares have been — the ‘anywhere’ search, for when the question is where to go rather than what a known route costs. Cost: 5 credits per call

Parameter	Type	Required
`origin`	string	yes
`currency`	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":"travelpayouts","endpoint":"/destinations","input":{"origin":"DEL"}}'

Find an airport or city code

The IATA code for a city or airport, which every price tool here needs, from Travelpayouts’ own place search — ranked by their relevance weight, with coordinates, country and the main airport name. Cities and airports both come back and the difference matters: London the city is LON and covers all its airports, while LHR is only Heathrow. Pass types to narrow to one kind (city, airport, country). No account needed. Cost: 5 credits per call

Parameter	Type	Required
`query`	string	yes
`types`	string	string[]	no
`locale`	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":"travelpayouts","endpoint":"/places","input":{"query":"Patna"}}'

Look up an airline

Airline names and their 2-letter codes, with a flag for whether each is a low-cost carrier — useful for reading the airline code that comes back on a fare. No account needed. Cost: 5 credits per call

Parameter	Type	Required
`query`	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":"travelpayouts","endpoint":"/airlines","input":{"query":"indigo"}}'

Replicate

Run any model on Replicate with your own token: generate images, video, audio and text, search the model catalog, and manage predictions and fine-tunes. (ai)

Search models

Find a model on Replicate by name or description — the way in when you don’t know the exact owner/name. Cost: 5 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":"replicate","endpoint":"/search","input":{"query":"text to image"}}'

Browse models

Public models on Replicate, newest or most-run first. Cost: 5 credits per call

Parameter	Type	Required
`sort_by`	string	no
`sort_direction`	string	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":"replicate","endpoint":"/models","input":{}}'

Model

One model, including its latest version and that version’s openapi_schema — the authoritative list of input fields to pass to replicate.run. Cost: 5 credits per call

Parameter	Type	Required
`model`	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":"replicate","endpoint":"/models/{model}","input":{"model":"black-forest-labs/flux-schnell"}}'

Model versions

Every published version of a model; the id is what replicate.run takes as version. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes
`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":"replicate","endpoint":"/models/{model}/versions","input":{"model":"stability-ai/sdxl"}}'

Model version

One version with its openapi_schema — read this to learn exactly which inputs a model accepts. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes
`version_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":"replicate","endpoint":"/models/{model}/versions/{id}","input":{"model":"stability-ai/sdxl","version_id":"<version-id>"}}'

Model readme

The model’s documentation, in markdown — what it does and how to prompt it. Cost: 5 credits per call

Parameter	Type	Required
`model`	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":"replicate","endpoint":"/models/{model}/readme","input":{"model":"black-forest-labs/flux-schnell"}}'

Model examples

Example predictions for a model — real inputs that are known to work. Cost: 5 credits per call

Parameter	Type	Required
`model`	string	yes
`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":"replicate","endpoint":"/models/{model}/examples","input":{"model":"black-forest-labs/flux-schnell"}}'

Your predictions

Predictions on your account, newest first — what you’ve run and what it cost in time.

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

Cost: 5 credits per call

Parameter	Type	Required
`created_after`	string	no
`created_before`	string	no
`source`	string	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":"replicate","endpoint":"/predictions","input":{}}'

Prediction

One prediction: status, output, logs and metrics. This is what you poll when replicate.run came back still processing.

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

Cost: 5 credits per call

Parameter	Type	Required
`prediction_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":"replicate","endpoint":"/predictions/{id}","input":{"prediction_id":"<prediction-id>"}}'

Trainings

Fine-tunes on your account and their status.

Bring your own key — connect Replicate 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":"replicate","endpoint":"/trainings","input":{}}'

Training

One fine-tune: status, logs, and the model version it produced.

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

Cost: 5 credits per call

Parameter	Type	Required
`training_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":"replicate","endpoint":"/trainings/{id}","input":{"training_id":"<training-id>"}}'

Deployments

Your deployments — models running on dedicated hardware you control.

Bring your own key — connect Replicate 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":"replicate","endpoint":"/deployments","input":{}}'

Deployment

One deployment: its current release, hardware, and scaling settings.

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

Cost: 5 credits per call

Parameter	Type	Required
`deployment`	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":"replicate","endpoint":"/deployments/{deployment}","input":{"deployment":"<owner>/<deployment>"}}'

Collections

Curated model collections (text-to-image, upscalers, speech…) — a good way to find the right model. 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":"replicate","endpoint":"/collections","input":{}}'

Collection

The models in one curated collection. Cost: 5 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":"replicate","endpoint":"/collections/{slug}","input":{"slug":"text-to-image"}}'

Account

The account this token belongs to.

Bring your own key — connect Replicate 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":"replicate","endpoint":"/account","input":{}}'

Hardware

The GPU/CPU tiers models can run on, with their SKUs. 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":"replicate","endpoint":"/hardware","input":{}}'

Files

Files you’ve uploaded to Replicate for use as model inputs.

Bring your own key — connect Replicate 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":"replicate","endpoint":"/files","input":{}}'

File

One uploaded file, with the URL to pass as a model input.

Bring your own key — connect Replicate 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":"replicate","endpoint":"/files/{id}","input":{"file_id":"<file-id>"}}'

Download a file

Fetch an uploaded file’s contents. owner, expiry and signature come from the signed urls.get link on replicate.file.

Bring your own key — connect Replicate 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
`owner`	string	no
`expiry`	string	integer	no
`signature`	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":"replicate","endpoint":"/files/{id}/download","input":{"file_id":"<file-id>"}}'

Run a model

Run a model and wait for the output in one call (up to 60s). Pass model (owner/name) for an official model, or version for any other. input is model-specific — see replicate.model for its schema. If the model takes longer than the wait, you get the prediction back still processing: poll replicate.prediction with its id. Outputs are URLs that expire in about an hour. cancel_after (e.g. 5m) caps GPU time. Billed to your own Replicate account. Cost: 5 to 1300 credits

Parameter	Type	Required
`model`	string	no
`version`	string	no
`wait`	integer	no
`cancel_after`	string	no
`input`	object	no
`webhook`	string	no
`webhook_events_filter`	string[]	no
`stream`	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":"replicate","endpoint":"/run","input":{"model":"black-forest-labs/flux-schnell","input":{"prompt":"a red bicycle on a beach at sunset"}}}'

Start a prediction (async)

Kick off a model without waiting — returns a pending prediction immediately. Use this for slow models (video, long generations): poll replicate.prediction, or pass a webhook. Cheaper than replicate.run because nothing is held open.

Bring your own key — connect Replicate 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
`version`	string	no
`input`	object	no
`webhook`	string	no
`webhook_events_filter`	string[]	no
`stream`	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":"replicate","endpoint":"/predictions/create","input":{"model":"black-forest-labs/flux-schnell","input":{"prompt":"a red bicycle"}}}'

Run a deployment

Run one of your deployments (a model on dedicated hardware) and wait for the output, same as replicate.run.

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

Cost: 5 credits per call

Parameter	Type	Required
`deployment`	string	yes
`wait`	integer	no
`cancel_after`	string	no
`input`	object	no
`webhook`	string	no
`webhook_events_filter`	string[]	no
`stream`	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":"replicate","endpoint":"/deployments/{deployment}/predictions","input":{"deployment":"<owner>/<deployment>","input":{"prompt":"hello"}}}'

Cancel a prediction

Stop a running prediction. Useful when a model is taking longer than it’s worth — you stop paying for the GPU.

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

Cost: 5 credits per call

Parameter	Type	Required
`prediction_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":"replicate","endpoint":"/predictions/{id}/cancel","input":{"prediction_id":"<prediction-id>"}}'

Start a fine-tune

Train a model version against your own data and push the result to destination. Long-running and billed by the second on your account — poll replicate.training for status.

Bring your own key — connect Replicate 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
`version_id`	string	yes
`destination`	string	yes
`input`	object	no
`webhook`	string	no
`webhook_events_filter`	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":"replicate","endpoint":"/models/{model}/versions/{id}/trainings","input":{"model":"ostris/flux-dev-lora-trainer","version_id":"<version-id>","destination":"<your-account>/<model-name>","input":{"input_images":"https://example.com/images.zip"}}}'

Cancel a fine-tune

Stop a running training and stop paying for it.

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

Cost: 5 credits per call

Parameter	Type	Required
`training_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":"replicate","endpoint":"/trainings/{id}/cancel","input":{"training_id":"<training-id>"}}'

Delete a model version

Permanently delete one version of your own private model, with every prediction made on it and their output files. Replicate refuses if anyone else has run it or a training depends on it. Needs your own Replicate token connected.

Bring your own key — connect Replicate 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
`version_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":"replicate","endpoint":"/models/{owner}/{name}/versions/{id}/delete","input":{"model":"your-name/your-model","version_id":"<version-id>"}}'

Delete a model

Delete your own private model. Replicate only allows it once the model has no versions left, so delete those first. Needs your own Replicate token connected.

Bring your own key — connect Replicate 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
(other provider fields)	any	no

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

Delete a deployment

Tear down a deployment. Replicate only allows it after the deployment has been offline and unused for 15 minutes. Needs your own Replicate token connected.

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

Cost: 5 credits per call

Parameter	Type	Required
`deployment`	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":"replicate","endpoint":"/deployments/{owner}/{name}/delete","input":{"deployment":"your-name/your-deployment"}}'

Delete a file

Permanently delete an uploaded file — its URL 404s afterwards. Needs your own Replicate token connected.

Bring your own key — connect Replicate 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":"replicate","endpoint":"/files/{id}/delete","input":{"file_id":"<file-id>"}}'

Raw Replicate call

Escape hatch: any Replicate endpoint on your own token (path absolute, e.g. /webhooks/default/secret). Prefer the curated replicate tools when one fits.

Bring your own key — connect Replicate 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":"replicate","endpoint":"/request","input":{"method":"GET","path":"/collections"}}'

Google Workspace (gws)

use your exported gws login across Gmail, Drive, Calendar, Docs, Sheets, Chat, Admin, and the full Google Workspace REST surface without running the CLI. (productivity)

Google Workspace permissions

Live-check the connected Google account, its exact OAuth scopes, and which gws services those scopes can call.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Workspace (gws) 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":"gws","endpoint":"/permissions","input":{}}'

Google Workspace API methods

Search the live Google Discovery catalog for methods supported by a gws service and see scope availability.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Workspace (gws) 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`	string	yes
`query`	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":"gws","endpoint":"/methods","input":{"service":"gmail","query":"messages list"}}'

Google Workspace method schema

Get Google’s live Discovery schema, parameters, request body, response, scopes, and media support for one method.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Workspace (gws) 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

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

Execute Google Workspace API method

Call any gws-backed Google REST method directly from its Discovery id, with refresh, scope checks, pagination, and media transfer.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Workspace (gws) 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
`params`	object	no
`body`	any	no
`page_all`	boolean	no
`page_limit`	integer	no
`confirm`	boolean	no
`media_base64`	string	no
`media_content_type`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gws","endpoint":"/execute","input":{"method":"gmail.users.messages.list","params":{"userId":"me","maxResults":10}}}'

List mailboxes

Known mailboxes for the connected Google account, whether each is enabled, and whether it can send. Cost: 5 credits per call

Parameter	Type	Required
`enabled_only`	boolean	no

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

Re-sync mailboxes

Re-read the account’s send-as identities and a recent Delivered-To sample. Selections are preserved; addresses that disappear are marked, not deleted.

Bring your own key — connect Google Workspace (gws) 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":"gws","endpoint":"/mailboxes/sync","input":{}}'

Enable or disable a mailbox

Turn one mailbox on or off by address, or the whole set with all: true. Cost: 5 credits per call

Parameter	Type	Required
`enabled`	boolean	yes
`address`	string	no
`all`	boolean	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gws","endpoint":"/mailboxes/set","input":{"address":"hi@apprevs.com","enabled":true}}'

Resend

send and receive email, manage templates, contacts, broadcasts, domains, and delivery data (communications)

Resend: send email

Send or schedule an email. Resend validates the sender, recipients, content, templates, attachments, and account quota.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/send","input":{"from":"Acme <hello@example.com>","to":["user@example.com"],"subject":"Hello","text":"Hello"}}'

Resend: sent emails

List sent emails and their latest delivery event.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails","input":{}}'

Resend: email

Retrieve a sent email, its content, tags, schedule, and latest delivery event.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/get","input":{"id":"email-id"}}'

Resend: update scheduled email

Update a scheduled email using Resend’s current request fields.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/update","input":{"id":"email-id","scheduled_at":"in 10 minutes"}}'

Resend: cancel email

Cancel a scheduled email.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/cancel","input":{"id":"email-id"}}'

Resend: send email batch

Send a batch of emails using Resend’s batch API.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/batch","input":{"emails":[]}}'

Resend: email metrics

Retrieve account-level email metrics.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/metrics","input":{}}'

Resend: received emails

List emails received by the connected Resend account.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/received","input":{}}'

Resend: received email

Retrieve one received email and its content.

Bring your own key — connect Resend 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":"resend","endpoint":"/emails/received/get","input":{"id":"email-id"}}'

Resend: templates

List email templates.

Bring your own key — connect Resend 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":"resend","endpoint":"/templates","input":{}}'

Resend: template

Retrieve one email template.

Bring your own key — connect Resend 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":"resend","endpoint":"/templates/get","input":{"id":"template-id"}}'

Resend: create template

Create an email template using Resend’s request fields.

Bring your own key — connect Resend 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":"resend","endpoint":"/templates/create","input":{}}'

Resend: update template

Update an email template.

Bring your own key — connect Resend 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":"resend","endpoint":"/templates/update","input":{"id":"template-id"}}'

Resend: publish template

Publish an email template.

Bring your own key — connect Resend 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":"resend","endpoint":"/templates/publish","input":{"id":"template-id"}}'

Resend: contacts

List contacts.

Bring your own key — connect Resend 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":"resend","endpoint":"/contacts","input":{}}'

Resend: contact

Retrieve one contact.

Bring your own key — connect Resend 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":"resend","endpoint":"/contacts/get","input":{"id":"contact-id-or-email"}}'

Resend: create contact

Create a contact using Resend’s request fields.

Bring your own key — connect Resend 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":"resend","endpoint":"/contacts/create","input":{}}'

Resend: update contact

Update a contact.

Bring your own key — connect Resend 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":"resend","endpoint":"/contacts/update","input":{"id":"contact-id-or-email"}}'

Resend: delete contact

Delete a contact.

Bring your own key — connect Resend 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":"resend","endpoint":"/contacts/delete","input":{"id":"contact-id-or-email"}}'

Resend: broadcasts

List broadcasts.

Bring your own key — connect Resend 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":"resend","endpoint":"/broadcasts","input":{}}'

Resend: broadcast

Retrieve one broadcast.

Bring your own key — connect Resend 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":"resend","endpoint":"/broadcasts/get","input":{"id":"broadcast-id"}}'

Resend: create broadcast

Create a broadcast without sending it.

Bring your own key — connect Resend 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":"resend","endpoint":"/broadcasts/create","input":{}}'

Resend: update broadcast

Update a broadcast.

Bring your own key — connect Resend 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":"resend","endpoint":"/broadcasts/update","input":{"id":"broadcast-id"}}'

Resend: send broadcast

Start sending a broadcast through Resend. Requires confirm=true because this sends to an audience.

Bring your own key — connect Resend 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
`confirm`	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":"resend","endpoint":"/broadcasts/send","input":{"id":"broadcast-id","confirm":true}}'

Resend: domains

List sending domains and their verification state.

Bring your own key — connect Resend 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":"resend","endpoint":"/domains","input":{}}'

Resend: domain

Retrieve one sending domain and DNS records.

Bring your own key — connect Resend 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":"resend","endpoint":"/domains/get","input":{"id":"domain-id"}}'

Resend: create domain

Add a sending domain.

Bring your own key — connect Resend 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":"resend","endpoint":"/domains/create","input":{}}'

Resend: update domain

Update a sending domain.

Bring your own key — connect Resend 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":"resend","endpoint":"/domains/update","input":{"id":"domain-id"}}'

Resend: verify domain

Ask Resend to verify a domain’s DNS records.

Bring your own key — connect Resend 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":"resend","endpoint":"/domains/verify","input":{"id":"domain-id"}}'

Resend: suppressions

List suppressed recipients.

Bring your own key — connect Resend 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":"resend","endpoint":"/suppressions","input":{}}'

Resend: add suppression

Add an email address to the suppression list.

Bring your own key — connect Resend 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":"resend","endpoint":"/suppressions/add","input":{}}'

Resend: remove suppression

Remove an email or id from the suppression list.

Bring your own key — connect Resend 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":"resend","endpoint":"/suppressions/remove","input":{"id":"email@example.com"}}'

Resend: segments

List contact segments.

Bring your own key — connect Resend 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":"resend","endpoint":"/segments","input":{}}'

Resend: create segment

Create a contact segment.

Bring your own key — connect Resend 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":"resend","endpoint":"/segments/create","input":{}}'

Resend: topics

List email subscription topics.

Bring your own key — connect Resend 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":"resend","endpoint":"/topics","input":{}}'

Resend: create topic

Create an email subscription topic.

Bring your own key — connect Resend 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":"resend","endpoint":"/topics/create","input":{}}'

Resend: webhooks

List webhook endpoints.

Bring your own key — connect Resend 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":"resend","endpoint":"/webhooks","input":{}}'

Resend: create webhook

Create a webhook endpoint and return its signing secret.

Bring your own key — connect Resend 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":"resend","endpoint":"/webhooks/create","input":{}}'

Resend: API logs

List Resend API request logs.

Bring your own key — connect Resend 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":"resend","endpoint":"/logs","input":{}}'

Resend: raw API request

Call any Resend REST API path with the connected account. Resend owns request validation, quotas, and error messages.

Bring your own key — connect Resend 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	no
`path`	string	yes
`query`	object	no
`body`	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":"resend","endpoint":"/request","input":{"method":"GET","path":"/emails"}}'

Loops

lifecycle email, campaigns, contacts, transactional messages, events, and automation workflows (communications)

Loops: account

Test the connected API key and return its Loops team.

Bring your own key — connect Loops 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":"loops","endpoint":"/api-key","input":{}}'

Loops: audience segment

Retrieve one audience segment.

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

Cost: 5 credits per call

Parameter	Type	Required
`audienceSegmentId`	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":"loops","endpoint":"/audience-segments/get","input":{"audienceSegmentId":"audienceSegmentId-id"}}'

Loops: audience segments

List audience segments for campaign targeting.

Bring your own key — connect Loops 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":"loops","endpoint":"/audience-segments","input":{}}'

Loops: create audience segment

Create an audience segment using Loops’ current request fields.

Bring your own key — connect Loops 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":"loops","endpoint":"/audience-segments/create","input":{}}'

Loops: campaigns

List lifecycle email campaigns.

Bring your own key — connect Loops 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":"loops","endpoint":"/campaigns","input":{}}'

Loops: create campaign

Create a draft marketing campaign and its email message.

Bring your own key — connect Loops 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":"loops","endpoint":"/campaigns/create","input":{}}'

Loops: campaign

Retrieve one campaign.

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

Cost: 5 credits per call

Parameter	Type	Required
`campaignId`	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":"loops","endpoint":"/campaigns/get","input":{"campaignId":"campaignId-id"}}'

Loops: update campaign

Update a draft campaign’s name, audience, group, or schedule.

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

Cost: 5 credits per call

Parameter	Type	Required
`campaignId`	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":"loops","endpoint":"/campaigns/update","input":{"campaignId":"campaignId-id"}}'

Loops: campaign groups

List campaign groups.

Bring your own key — connect Loops 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":"loops","endpoint":"/campaign-groups","input":{}}'

Loops: create campaign group

Create a campaign group.

Bring your own key — connect Loops 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":"loops","endpoint":"/campaign-groups/create","input":{}}'

Loops: campaign group

Retrieve one campaign group.

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

Cost: 5 credits per call

Parameter	Type	Required
`campaignGroupId`	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":"loops","endpoint":"/campaign-groups/get","input":{"campaignGroupId":"campaignGroupId-id"}}'

Loops: update campaign group

Update a campaign group’s name or description.

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

Cost: 5 credits per call

Parameter	Type	Required
`campaignGroupId`	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":"loops","endpoint":"/campaign-groups/update","input":{"campaignGroupId":"campaignGroupId-id"}}'

Loops: dedicated sending IPs

List dedicated sending IP addresses.

Bring your own key — connect Loops 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":"loops","endpoint":"/dedicated-sending-ips","input":{}}'

Loops: create contact

Add a contact to the audience.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/create","input":{}}'

Loops: update contact

Update or create a contact.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/update","input":{}}'

Loops: find contact

Find a contact by email address or user ID.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/find","input":{}}'

Loops: delete contact

Delete a contact by email address or user ID.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/delete","input":{}}'

Loops: contact suppression

Check whether a contact is suppressed.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/suppression","input":{}}'

Loops: remove contact suppression

Remove suppression for a contact.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/suppression/remove","input":{}}'

Loops: create contact property

Create a custom contact property.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/properties/create","input":{}}'

Loops: contact properties

List custom contact properties.

Bring your own key — connect Loops 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":"loops","endpoint":"/contacts/properties","input":{}}'

Loops: component

Retrieve one reusable email component.

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

Cost: 5 credits per call

Parameter	Type	Required
`componentId`	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":"loops","endpoint":"/components/get","input":{"componentId":"componentId-id"}}'

Loops: update component

Update a reusable email component and its LMX body.

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

Cost: 5 credits per call

Parameter	Type	Required
`componentId`	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":"loops","endpoint":"/components/update","input":{"componentId":"componentId-id"}}'

Loops: components

List reusable email components.

Bring your own key — connect Loops 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":"loops","endpoint":"/components","input":{}}'

Loops: create component

Create a reusable email component from LMX content.

Bring your own key — connect Loops 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":"loops","endpoint":"/components/create","input":{}}'

Loops: email message

Retrieve an email message and its compiled content.

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

Cost: 5 credits per call

Parameter	Type	Required
`emailMessageId`	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":"loops","endpoint":"/email-messages/get","input":{"emailMessageId":"emailMessageId-id"}}'

Loops: update email message

Update an email message’s subject, sender, preview text, or LMX content.

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

Cost: 5 credits per call

Parameter	Type	Required
`emailMessageId`	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":"loops","endpoint":"/email-messages/update","input":{"emailMessageId":"emailMessageId-id"}}'

Loops: preview email message

Send a test preview of an email message.

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

Cost: 5 credits per call

Parameter	Type	Required
`emailMessageId`	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":"loops","endpoint":"/email-messages/preview","input":{"emailMessageId":"emailMessageId-id"}}'

Loops: check email message

Run Loops Guardian content checks before publishing or sending.

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

Cost: 5 credits per call

Parameter	Type	Required
`emailMessageId`	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":"loops","endpoint":"/email-messages/guardian","input":{"emailMessageId":"emailMessageId-id"}}'

Loops: send event

Send an event to trigger a lifecycle workflow.

Bring your own key — connect Loops 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":"loops","endpoint":"/events/send","input":{}}'

Loops: event patterns

List event patterns used by workflow triggers.

Bring your own key — connect Loops 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":"loops","endpoint":"/event-patterns","input":{}}'

Loops: event pattern by name

Retrieve a workflow event pattern by its case-sensitive name.

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

Cost: 5 credits per call

Parameter	Type	Required
`eventName`	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":"loops","endpoint":"/event-patterns/by-name","input":{"eventName":"eventName-id"}}'

Loops: event pattern

Retrieve a workflow event pattern by ID.

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

Cost: 5 credits per call

Parameter	Type	Required
`eventPatternId`	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":"loops","endpoint":"/event-patterns/get","input":{"eventPatternId":"eventPatternId-id"}}'

Loops: mailing lists

List mailing lists.

Bring your own key — connect Loops 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":"loops","endpoint":"/mailing-lists","input":{}}'

Loops: theme

Retrieve one email theme.

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

Cost: 5 credits per call

Parameter	Type	Required
`themeId`	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":"loops","endpoint":"/themes/get","input":{"themeId":"themeId-id"}}'

Loops: update theme

Update an email theme’s name or styles.

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

Cost: 5 credits per call

Parameter	Type	Required
`themeId`	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":"loops","endpoint":"/themes/update","input":{"themeId":"themeId-id"}}'

Loops: themes

List email themes.

Bring your own key — connect Loops 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":"loops","endpoint":"/themes","input":{}}'

Loops: create theme

Create an email theme.

Bring your own key — connect Loops 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":"loops","endpoint":"/themes/create","input":{}}'

Loops: send transactional email

Send a published transactional email with data variables.

Bring your own key — connect Loops 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":"loops","endpoint":"/transactional","input":{}}'

Loops: published transactional emails

List published transactional emails through the stable v1 sending surface.

Bring your own key — connect Loops 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":"loops","endpoint":"/transactional/published","input":{}}'

Loops: transactional email templates

List transactional emails, drafts, and publication state.

Bring your own key — connect Loops 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":"loops","endpoint":"/transactional-emails","input":{}}'

Loops: create transactional email

Create a transactional email and its draft message.

Bring your own key — connect Loops 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":"loops","endpoint":"/transactional-emails/create","input":{}}'

Loops: transactional email

Retrieve one transactional email.

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

Cost: 5 credits per call

Parameter	Type	Required
`transactionalId`	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":"loops","endpoint":"/transactional-emails/get","input":{"transactionalId":"transactionalId-id"}}'

Loops: update transactional email

Update a transactional email.

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

Cost: 5 credits per call

Parameter	Type	Required
`transactionalId`	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":"loops","endpoint":"/transactional-emails/update","input":{"transactionalId":"transactionalId-id"}}'

Loops: ensure transactional draft

Ensure a transactional email has a draft message.

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

Cost: 5 credits per call

Parameter	Type	Required
`transactionalId`	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":"loops","endpoint":"/transactional-emails/draft","input":{"transactionalId":"transactionalId-id"}}'

Loops: publish transactional email

Publish the current transactional email draft.

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

Cost: 5 credits per call

Parameter	Type	Required
`transactionalId`	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":"loops","endpoint":"/transactional-emails/publish","input":{"transactionalId":"transactionalId-id"}}'

Loops: transactional groups

List transactional email groups.

Bring your own key — connect Loops 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":"loops","endpoint":"/transactional-groups","input":{}}'

Loops: create transactional group

Create a transactional email group.

Bring your own key — connect Loops 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":"loops","endpoint":"/transactional-groups/create","input":{}}'

Loops: transactional group

Retrieve one transactional email group.

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

Cost: 5 credits per call

Parameter	Type	Required
`transactionalGroupId`	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":"loops","endpoint":"/transactional-groups/get","input":{"transactionalGroupId":"transactionalGroupId-id"}}'

Loops: update transactional group

Update a transactional email group’s name or description.

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

Cost: 5 credits per call

Parameter	Type	Required
`transactionalGroupId`	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":"loops","endpoint":"/transactional-groups/update","input":{"transactionalGroupId":"transactionalGroupId-id"}}'

Loops: create upload

Request a pre-signed image upload URL.

Bring your own key — connect Loops 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":"loops","endpoint":"/uploads/create","input":{}}'

Loops: complete upload

Finalize an image upload after bytes reach the pre-signed URL.

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

Cost: 5 credits per call

Parameter	Type	Required
`emailAssetId`	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":"loops","endpoint":"/uploads/complete","input":{"emailAssetId":"emailAssetId-id"}}'

Loops: workflows

List lifecycle automation workflows.

Bring your own key — connect Loops 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":"loops","endpoint":"/workflows","input":{}}'

Loops: create workflow

Create a draft workflow with blank trigger and exit nodes.

Bring your own key — connect Loops 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":"loops","endpoint":"/workflows/create","input":{}}'

Loops: workflow

Retrieve a workflow graph.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	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":"loops","endpoint":"/workflows/get","input":{"workflowId":"workflowId-id"}}'

Loops: update workflow

Update a workflow’s display properties.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	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":"loops","endpoint":"/workflows/update","input":{"workflowId":"workflowId-id"}}'

Loops: change workflow mailing list

Change a workflow’s mailing list.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	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":"loops","endpoint":"/workflows/mailing-list","input":{"workflowId":"workflowId-id"}}'

Loops: create workflow node

Create a default workflow node.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	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":"loops","endpoint":"/workflows/nodes/create","input":{"workflowId":"workflowId-id"}}'

Loops: add workflow branch

Add a branch under a workflow branch or experiment node.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	string	yes
`nodeId`	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":"loops","endpoint":"/workflows/nodes/add-branch","input":{"workflowId":"workflowId-id","nodeId":"nodeId-id"}}'

Loops: workflow node

Retrieve detailed workflow node data.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	string	yes
`nodeId`	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":"loops","endpoint":"/workflows/nodes/get","input":{"workflowId":"workflowId-id","nodeId":"nodeId-id"}}'

Loops: update workflow node

Update workflow-node-owned fields.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	string	yes
`nodeId`	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":"loops","endpoint":"/workflows/nodes/update","input":{"workflowId":"workflowId-id","nodeId":"nodeId-id"}}'

Loops: delete workflow node

Delete one workflow node.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	string	yes
`nodeId`	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":"loops","endpoint":"/workflows/nodes/delete","input":{"workflowId":"workflowId-id","nodeId":"nodeId-id"}}'

Loops: delete workflow subtree

Delete a workflow node and its downstream subtree.

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

Cost: 5 credits per call

Parameter	Type	Required
`workflowId`	string	yes
`nodeId`	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":"loops","endpoint":"/workflows/nodes/delete-recursively","input":{"workflowId":"workflowId-id","nodeId":"nodeId-id"}}'

Loops: raw API request

Call any Loops REST API path with the connected account. Loops owns request validation, rate limits, and error messages.

Bring your own key — connect Loops 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	no
`path`	string	yes
`query`	object	no
`body`	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":"loops","endpoint":"/request","input":{"method":"GET","path":"/v1/workflows"}}'

Google Calendar

your google calendar: list, read, create, update, and delete calendar events, and list your calendars (connect with one click). (productivity)

Google Calendar: list events

List events on a calendar (default ‘primary’). Optional timeMin/timeMax (RFC3339), q, maxResults.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`calendarId`	string	no
`timeMin`	string	no
`timeMax`	string	no
`q`	string	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":"google_calendar","endpoint":"/events","input":{"calendarId":"primary","timeMin":"2026-07-01T00:00:00Z","maxResults":10}}'

Google Calendar: get event

Get one event by id from a calendar (default ‘primary’).

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`eventId`	string	yes
`calendarId`	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":"google_calendar","endpoint":"/event","input":{"eventId":"abc123","calendarId":"primary"}}'

Google Calendar: list calendars

List the calendars on the user’s calendar list.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Calendar 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":"google_calendar","endpoint":"/calendars","input":{}}'

Google Calendar: create event

Create an event on a calendar (default ‘primary’). event needs start + end.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Calendar 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`	object	yes
`calendarId`	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":"google_calendar","endpoint":"/create-event","input":{"calendarId":"primary","event":{"summary":"Sync","start":{"dateTime":"2026-07-02T15:00:00Z"},"end":{"dateTime":"2026-07-02T15:30:00Z"}}}}'

Google Calendar: update event

Patch (partial update) an event by id on a calendar (default ‘primary’).

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`eventId`	string	yes
`event`	object	yes
`calendarId`	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":"google_calendar","endpoint":"/update-event","input":{"calendarId":"primary","eventId":"abc123","event":{"summary":"Updated title"}}}'

Google Calendar: delete event

Delete an event by id from a calendar (default ‘primary’).

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`eventId`	string	yes
`calendarId`	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":"google_calendar","endpoint":"/delete-event","input":{"calendarId":"primary","eventId":"abc123"}}'

Google Docs & Sheets

your google docs, sheets, slides, and forms: read and write documents, spreadsheet data, presentations, and forms, and read form responses (connect with one click). (productivity)

Google Docs: get document

Read a document’s full content (body, styles, revision id) by document id.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`documentId`	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":"google_workspace","endpoint":"/doc","input":{"documentId":"1AbC..."}}'

Google Docs: create document

Create a new empty document with a title. add content afterwards with doc batch update.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Docs & Sheets 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	no
(other provider fields)	any	no

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

Google Docs: batch update

Apply edits to a document. requests is an array of docs edit ops (insertText, replaceAllText, etc.).

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`documentId`	string	yes
`requests`	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":"google_workspace","endpoint":"/doc-batch-update","input":{"documentId":"1AbC...","requests":[{"insertText":{"location":{"index":1},"text":"hello world"}}]}}'

Google Sheets: read values

Read a value range from a spreadsheet (A1 notation, e.g. ‘Sheet1!A1:C10’).

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`spreadsheetId`	string	yes
`range`	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":"google_workspace","endpoint":"/sheet-values","input":{"spreadsheetId":"1AbC...","range":"Sheet1!A1:C10"}}'

Google Sheets: spreadsheet info

Get a spreadsheet’s metadata (sheet names, properties). Optional fields mask.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`spreadsheetId`	string	yes
`fields`	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":"google_workspace","endpoint":"/sheet-info","input":{"spreadsheetId":"1AbC...","fields":"sheets.properties"}}'

Google Sheets: update values

Overwrite a value range (USER_ENTERED). values is a 2D array of rows.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`spreadsheetId`	string	yes
`range`	string	yes
`values`	any[][]	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":"google_workspace","endpoint":"/update-sheet-values","input":{"spreadsheetId":"1AbC...","range":"Sheet1!A1","values":[["Name","Score"],["Ada",42]]}}'

Google Sheets: append rows

Append rows after the last row of a range (USER_ENTERED). values is a 2D array of rows.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`spreadsheetId`	string	yes
`range`	string	yes
`values`	any[][]	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":"google_workspace","endpoint":"/append-row","input":{"spreadsheetId":"1AbC...","range":"Sheet1!A1","values":[["Grace",99]]}}'

Google Sheets: create spreadsheet

Create a new spreadsheet. Pass a title, or a full spreadsheet resource.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Docs & Sheets 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	no
`spreadsheet`	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":"google_workspace","endpoint":"/create-spreadsheet","input":{"title":"Q3 metrics"}}'

Google Slides: get presentation

Read a presentation’s full content (slides, layouts, masters) by presentation id.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`presentationId`	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":"google_workspace","endpoint":"/presentation","input":{"presentationId":"1AbC..."}}'

Google Slides: create presentation

Create a new presentation with a title. add slides afterwards with slides batch update.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Docs & Sheets 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	no
(other provider fields)	any	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"google_workspace","endpoint":"/create-presentation","input":{"title":"q3 review deck"}}'

Google Slides: batch update

Apply edits to a presentation. requests is an array of slides edit ops (createSlide, insertText, etc.).

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`presentationId`	string	yes
`requests`	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":"google_workspace","endpoint":"/slides-batch-update","input":{"presentationId":"1AbC...","requests":[{"createSlide":{"insertionIndex":1}}]}}'

Google Forms: get form

Read a form’s structure (info, items, settings) by form id.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`formId`	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":"google_workspace","endpoint":"/form","input":{"formId":"1AbC..."}}'

Google Forms: list responses

List the responses submitted to a form by form id.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`formId`	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":"google_workspace","endpoint":"/form-responses","input":{"formId":"1AbC..."}}'

Google Forms: create form

Create a new form with a title. add questions afterwards via a forms batch update.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Docs & Sheets 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
`documentTitle`	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":"google_workspace","endpoint":"/create-form","input":{"title":"customer feedback"}}'

Google Drive: list files

The docs, sheets, slides and forms this connection created — how you find a file’s id again after making it. Files created in the browser are invisible here: the connection holds a per-file grant, not access to your whole Drive.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`q`	string	no
`pageSize`	integer	no
`pageToken`	string	no
`orderBy`	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":"google_workspace","endpoint":"/drive/files","input":{"q":"mimeType='application/vnd.google-apps.document'","pageSize":20}}'

Google Drive: file metadata

One file’s name, type, folder, share link and trashed state.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`fileId`	string	yes
`fields`	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":"google_workspace","endpoint":"/drive/file","input":{"fileId":"<file-id>"}}'

Google Drive: rename or move a file

Rename a file, or move it by giving the folder id to add and the one to remove. Moving needs both — Drive treats folders as parents, not a path.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`fileId`	string	yes
`name`	string	no
`addParents`	string	no
`removeParents`	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":"google_workspace","endpoint":"/drive/file/update","input":{"fileId":"<file-id>","name":"Q3 report"}}'

Google Drive: trash a file

Move a file to Drive’s trash, where the owner can restore it for 30 days. Pass restore true to bring it back. The reversible alternative to delete_drive_file.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`fileId`	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":"google_workspace","endpoint":"/drive/file/trash","input":{"fileId":"<file-id>"}}'

Google Drive: delete a file

Permanently delete a file, skipping the trash entirely. No undo for anyone, including the owner. Prefer trash_drive_file.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`fileId`	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":"google_workspace","endpoint":"/drive/file/delete","input":{"fileId":"<file-id>"}}'

Grant access to a file. With an emailAddress it shares with that person (role reader, writer or commenter); with no address it defaults to type ‘anyone’, which makes the link public to everyone who has it.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`fileId`	string	yes
`emailAddress`	string	no
`role`	string	no
`type`	string	no
`sendNotificationEmail`	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":"google_workspace","endpoint":"/drive/file/share","input":{"fileId":"<file-id>","emailAddress":"jane@example.com","role":"writer"}}'

Gmail

send email as your connected gmail account: plain text or html, with cc and bcc (connect with one click). (communications)

Gmail: send email

Send an email as the connected account. to is required; subject, body (plain text), html, cc, bcc optional.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`to`	string	yes
`subject`	string	no
`body`	string	no
`html`	string	no
`cc`	string	no
`bcc`	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":"gmail","endpoint":"/send-email","input":{"to":"friend@example.com","subject":"hello","body":"sent from fetchbean"}}'

Google Analytics

your ga4 data: run reports over your properties and list the properties you can access (connect with one click). (analytics)

Google Analytics: run report (GA4)

Run a GA4 report for a property. Pass numeric property_id, dimensions + metrics (name arrays), and a date range.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`property_id`	string	yes
`dimensions`	string[]	no
`metrics`	string[]	no
`date_ranges`	object[]	no
`start_date`	string	no
`end_date`	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":"google_analytics","endpoint":"/report","input":{"property_id":"123456789","dimensions":["country"],"metrics":["activeUsers"],"start_date":"2026-06-01","end_date":"2026-06-30"}}'

Google Analytics: list properties

List the GA4 accounts and properties you can access, to find a numeric property_id.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Analytics 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":"google_analytics","endpoint":"/properties","input":{}}'

Google Search Console

your search console data: query search analytics for a verified site, list your sites, and inspect a url’s index status (connect with one click). (analytics)

Search Console: search analytics

Query Search Console traffic for a verified site over a date range. dimensions can be query, page, country, device, or date.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`site_url`	string	yes
`start_date`	string	yes
`end_date`	string	yes
`dimensions`	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":"google_search_console","endpoint":"/search-analytics","input":{"site_url":"https://example.com/","start_date":"2026-06-01","end_date":"2026-06-30","dimensions":["query"]}}'

Search Console: list sites

List the sites you have verified in Search Console.

Beta — gated to orgs with beta access.

Bring your own key — connect Google Search Console 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":"google_search_console","endpoint":"/sites","input":{}}'

Search Console: inspect url

Inspect a URL’s index status in Search Console. Needs the inspection_url and its owning verified site_url.

Beta — gated to orgs with beta access.

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

Cost: 5 credits per call

Parameter	Type	Required
`inspection_url`	string	yes
`site_url`	string	yes
`language_code`	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":"google_search_console","endpoint":"/inspect-url","input":{"inspection_url":"https://example.com/page","site_url":"https://example.com/"}}'

Bing Webmaster

Your site’s Bing search performance: queries, pages, crawl health, backlinks, and indexing. (analytics)

Bing verified sites

List the sites verified in your Bing Webmaster Tools account.

Bring your own key — connect Bing Webmaster 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":"bing_webmaster","endpoint":"/GetUserSites","input":{}}'

Add a site to Bing

Add a site to your Bing Webmaster Tools account. Adding is not verifying — pair it with bing_webmaster.verify_site, and until that passes the stats and submission tools have nothing to read.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Verify a site with Bing

Ask Bing to check a site’s ownership proof now. Returns true once it passes; false means the meta tag, XML file or DNS record it expects is not in place yet. Read the codes to publish from bing_webmaster.sites.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Remove a site from Bing

Remove a site from your Bing Webmaster Tools account. This drops its history and verification; re-adding it means verifying ownership again.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Tell Bing about a linking page

Register an external page that links to your site. There is no remove counterpart in the API — once added, it can only be cleared in the Bing UI.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`masterUrl`	string	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/AddConnectedPage","input":{"siteUrl":"https://fetchbean.com","masterUrl":"https://news.ycombinator.com/item?id=1"}}'

Block a page’s preview snippet

Stop Bing showing a preview snippet for a page. The reason is an undocumented integer enum, so take a value from an existing block rather than guessing.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes
`reason`	integer	yes

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

Allow a page’s preview snippet again

Lift a page preview block so Bing may show a snippet for the page.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes

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

Set geo-targeting

Target a site or directory at a country or region. Read the current settings with bing_webmaster.country_region_settings and send one back in the same shape.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`settings`	object	yes

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

Clear geo-targeting

Remove a country or region targeting rule. Pass the entry exactly as bing_webmaster.country_region_settings returned it.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`settings`	object	yes

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

Grant someone access to a site

Delegate Bing Webmaster access for a site to another email address. isAdministrator grants full control — this hands a third party control of your search presence, so read the flags carefully.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`delegatedUrl`	string	yes
`userEmail`	string	yes
`authenticationCode`	string	yes
`isAdministrator`	boolean	no
`isReadOnly`	boolean	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/AddSiteRoles","input":{"siteUrl":"https://fetchbean.com","delegatedUrl":"https://fetchbean.com","userEmail":"teammate@example.com","authenticationCode":"5C71F5...","isReadOnly":true}}'

Revoke someone’s site access

Remove a delegated role. Pass the whole role object from bing_webmaster.site_roles — Bing matches on its fields, not on the email alone.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`siteRole`	object	yes

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

Tell Bing the site moved

Declare a site migration so Bing transfers signals from the old URLs to the new ones. This reshapes how Bing treats your whole domain and there is no undo through the API; MoveType and MoveScope are integer enums Bing does not publish. GetSiteMoves, which would have let you read back what was submitted, no longer exists on the service.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`settings`	object	yes

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

Fetch a page as Bingbot

Ask Bingbot to fetch a URL now and record what it received. Read the result back with bing_webmaster.fetched_url_details — this is how you see a page the way the crawler does.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes

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

Block a URL from Bing

Hide a page or directory from Bing’s results. The block is temporary — Bing expires it after about 90 days — and it hides the page rather than fixing why it is indexed.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes
`entityType`	integer	no
`requestType`	integer	no

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

Unblock a URL in Bing

Lift a block so Bing may show the page again. entityType and requestType must match the original block; read them from bing_webmaster.blocked_urls.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes
`entityType`	integer	no
`requestType`	integer	no

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

Ignore a query parameter

Tell Bing a query-string parameter does not change the page, so ?utm_source and friends stop splitting one page into many. A site may hold only a limited number of these.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`queryParameter`	string	yes

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

Stop ignoring a query parameter

Delete a URL normalization rule, so Bing treats the parameter as significant again.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`queryParameter`	string	yes

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

Enable or disable a query parameter rule

Turn an existing normalization rule on or off without deleting it.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`queryParameter`	string	yes
`isEnabled`	boolean	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/EnableDisableQueryParameter","input":{"siteUrl":"https://fetchbean.com","queryParameter":"utm_source","isEnabled":false}}'

Set Bing’s crawl rate

Change how hard Bingbot may crawl the site, hour by hour. Read the current settings with bing_webmaster.crawl_settings first and send them back modified — what you send replaces the whole schedule.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`crawlSettings`	object	yes

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

Bing index details for a directory

Index status of every page under a directory — crawl date, HTTP status, document size and anchor count. Paged; prefix with ‘domain:’ for a whole domain.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes
`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":"bing_webmaster","endpoint":"/GetChildrenUrlInfo","input":{"siteUrl":"https://fetchbean.com","url":"fetchbean.com"}}'

Bing traffic for a directory

Clicks and impressions for every page under a directory.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	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":"bing_webmaster","endpoint":"/GetChildrenUrlTrafficInfo","input":{"siteUrl":"https://fetchbean.com","url":"fetchbean.com"}}'

Bing stats for one query on one page

Daily clicks, impressions and position for a specific query landing on a specific page — the narrowest view Bing offers.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`query`	string	yes
`page`	string	yes

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

Bing fetch-as-Bingbot result

What Bingbot received when it last fetched a URL on your request.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes

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

Bing fetched URLs

URLs you have asked Bingbot to fetch, with status.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing sitemap details

Per-sitemap detail: last crawled, status, URL count and file size — the follow-up to bing_webmaster.feeds.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`feedUrl`	string	yes

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

Bing connected pages

Pages you have told Bing link to your site.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing content submission quota

Daily and monthly quota for bing_webmaster.submit_content — a separate budget from the URL submission quota.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing geo-targeting

Country and region targeting configured for the site or its directories.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing URL normalization parameters

Query-string parameters Bing has been told to ignore when normalizing your URLs.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing page preview blocks

Pages blocked from showing a preview snippet in Bing results.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing traffic stats

Daily impressions, clicks, and average position for a site on Bing.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing top queries

Top search queries driving impressions and clicks to a site on Bing.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing top pages

Traffic statistics for a site’s top-performing pages on Bing.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing queries for a page

Which search queries drive traffic to one specific page.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`page`	string	yes

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

Bing keyword stats

Historical search impression volume for a keyword on Bing.

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

Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`language`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/GetKeywordStats","input":{"q":"ai agent tools","country":"us","language":"en-US"}}'

Keywords related to a seed term, with impression counts over a date range.

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

Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`language`	string	no
`startDate`	string	no
`endDate`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/GetRelatedKeywords","input":{"q":"ai agent tools","country":"us","language":"en-US"}}'

Bing keyword impressions

Impression count for one exact keyword over a date range. The single-term counterpart to bing_webmaster.related_keywords, which expands a seed instead.

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

Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`country`	string	no
`language`	string	no
`startDate`	string	no
`endDate`	string	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/GetKeyword","input":{"q":"ai agent tools","country":"us","language":"en-US"}}'

Bing pages for a query

Which of your pages Bing served for one query, with clicks, impressions and average position.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`query`	string	yes

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

Bing traffic for one page

Clicks and impressions for a single page or directory. Prefix with ‘domain:’ for a whole domain.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes

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

Bing blocked URLs

Pages and directories you have asked Bing to drop from its index, with their expiry.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing crawl settings

How fast Bing may crawl the site: the 24 hourly crawl-rate slots, and whether AJAX crawling is on.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing site access

Who else can read or manage this site in Bing Webmaster Tools, their role, and whether it has lapsed.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`includeAllSubdomains`	boolean	no

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

Submit a page’s content to Bing

Hand Bing the rendered content of a URL directly instead of waiting for a crawl. Counts against the separate content quota — read it with bing_webmaster.url_submission_quota.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes
`httpMessage`	string	yes
`structuredData`	string	no
`dynamicServing`	integer	no

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/SubmitContent","input":{"siteUrl":"https://fetchbean.com","url":"https://fetchbean.com/changelog","httpMessage":"SFRUUC8xLjEgMjAwIE9LDQoNCjxodG1sPjwvaHRtbD4="}}'

Bing crawl issues

Crawl errors Bing found on a site: 404s, blocked URLs, malware, DNS failures.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing crawl stats

How often Bing crawled a site, and what it found each day.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing URL index info

Index status and details Bing holds for a single page.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes

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

Bing inbound link counts

Pages on a site that have inbound links, with counts.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`page`	number	no

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

Bing backlinks for a URL

Inbound links pointing at one specific page.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes
`page`	number	no

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

Bing sitemaps

Sitemaps submitted for a site, with their status.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Bing URL submission quota

Remaining daily and monthly URL submission allowance. Check before submitting.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes

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

Submit URL to Bing

Submit a single URL to Bing for crawling and indexing. Counts against your daily quota.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`url`	string	yes

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

Submit URLs to Bing (batch)

Submit several URLs to Bing for indexing in one call. Counts against your daily quota.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`urlList`	string[]	yes

curl https://api.fetchbean.com/v1/run \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"bing_webmaster","endpoint":"/SubmitUrlBatch","input":{"siteUrl":"https://fetchbean.com","urlList":["https://fetchbean.com/a","https://fetchbean.com/b"]}}'

Submit sitemap to Bing

Register a sitemap (or RSS/Atom feed) with Bing so it discovers your URLs — the write half of feeds. Verify afterwards with bing_webmaster.feeds.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`feedUrl`	string	yes

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

Remove sitemap from Bing

Unregister a previously submitted sitemap or feed from Bing.

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

Cost: 5 credits per call

Parameter	Type	Required
`siteUrl`	string	yes
`feedUrl`	string	yes

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

Strale

Run any of ~300 compliance, company-data, and validation capabilities by slug — sanctions and PEP screening, business registries, IBAN and VAT checks, on-chain counterparty verdicts — each returning an audit trail (bring your own key, prepaid EUR wallet). (data)

Strale: search capabilities

Keyword search across Strale’s capabilities and bundled solutions. Each match carries its slug, price in EUR cents, and category — feed the slug to execute_capability. Cost: 5 credits per call

Parameter	Type	Required
`q`	string	yes
`limit`	integer	no
`geo`	string	no
`type`	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":"strale","endpoint":"/capability-search","input":{"q":"vat"}}'

Strale: match a task to a capability

Describe the job in a sentence and get one recommended capability or solution with the reason it matched and its test-pass record, plus alternatives and how many others matched. Use when a keyword search does not name the thing you want. Cost: 5 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":"strale","endpoint":"/capability-match","input":{"query":"check whether a Swedish company is sanctioned"}}'

Strale: capability detail

One capability’s input schema, output example, price, data source, and freshness. Read this to learn what inputs execute_capability expects for a slug. Cost: 5 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":"strale","endpoint":"/capability-detail","input":{"slug":"vat-validate"}}'

Strale: run a capability

Run any Strale capability or bundled solution by slug (or pass task and let Strale pick one), charged to your prepaid EUR wallet. max_price_cents is your spend cap for the call; dry_run reports what would run and what it would cost without spending. A capability over 10s answers with status pending and a transaction_id — poll it with transaction_detail.

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

Cost: 5 credits per call

Parameter	Type	Required
`capability_slug`	string	no
`task`	string	no
`inputs`	object	no
`max_price_cents`	integer	yes
`timeout_seconds`	integer	no
`dry_run`	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":"strale","endpoint":"/execute","input":{"capability_slug":"vat-validate","inputs":{"vat_number":"SE556703748501"},"max_price_cents":10}}'

Strale: solutions

List the bundled solutions — multi-step workflows (Nordic KYC, B2B payment validation, GDPR audit) that run several capabilities as one priced call. Optionally filter by category. Cost: 5 credits per call

Parameter	Type	Required
`category`	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":"strale","endpoint":"/solutions","input":{"category":"finance-banking"}}'

Strale: solution detail

One solution’s steps, the capabilities it runs, its data sources, price, and compliance coverage. Cost: 5 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":"strale","endpoint":"/solution-detail","input":{"slug":"kyc-sweden"}}'

Strale: on-chain counterparty check

A proceed/review/block verdict on a wallet, contract, token, protocol, or bridge before you transact with it, with the reason codes and evidence behind it. Paid, from your wallet.

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

Cost: 5 credits per call

Parameter	Type	Required
`target`	string	yes
`target_type`	string	no
`chain`	string	no
`action`	string	no
`amount_usd`	number	no
`mode`	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":"strale","endpoint":"/web3-assurance","input":{"target":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","target_type":"wallet","action":"send_payment"}}'

Strale: wallet balance

Your remaining prepaid balance, in EUR cents.

Bring your own key — connect Strale 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":"strale","endpoint":"/wallet-balance","input":{}}'

Strale: transactions

Your capability execution history — slug, status, price, and latency per call.

Bring your own key — connect Strale 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":"strale","endpoint":"/transactions","input":{}}'

Strale: transaction detail

One past execution in full: inputs, output, provenance, and the audit trail. Also the poll target for an execute_capability that came back pending.

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

Cost: 5 credits per call

Parameter	Type	Required
`transaction_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":"strale","endpoint":"/transaction-detail","input":{"transaction_id":"213a0614-13d3-4e61-b535-0830ba653adf"}}'

Strale: raw request

Escape hatch: call any Strale endpoint on your key — including GET /v1/capabilities, the full ~660KB catalog no curated tool returns. Pointed at /v1/auth/api-key it rotates your key and breaks this connection. Prefer the curated strale tools when one fits.

Bring your own key — connect Strale 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":"strale","endpoint":"/request","input":{"method":"GET","path":"/v1/capabilities"}}'

​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

​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

​Unpublish an article

​My articles

​My DEV account

​My post analytics

​My followers

​Tags I follow

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

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

Unpublish an article

My articles

My DEV account

My post analytics

My followers

Tags I follow