MCP docs › REST API
REST API
The MCP server is a thin proxy — it starts the same jobs, on the same quota. Use REST when you want HTTP instead of MCP.
Authenticate every request with X-API-Key: sk-… (or a scoped cfm- token, restricted to its tools). Full account-level docs: https://convertfleet.online/api-docs.
Start a Google Maps scrape
curl -X POST https://convertfleet.online/api/scrape \
-H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"query":"dentists in Miami, FL","max_results":25}'
# → {"job_id":"...","status":"running"}Start any other tool
curl -X POST https://convertfleet.online/api/tool-run \
-H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"tool":"websearch","params":{"query":"best crm 2026","max_results":10}}'
# → {"job_id":"...","status":"running"}Poll and collect
# maps jobs
curl https://convertfleet.online/api/jobs/JOB_ID -H "X-API-Key: YOUR_API_KEY"
curl https://convertfleet.online/api/jobs/JOB_ID/results -H "X-API-Key: YOUR_API_KEY"
# every other tool
curl https://convertfleet.online/api/tool-run/JOB_ID/status -H "X-API-Key: YOUR_API_KEY"
curl https://convertfleet.online/api/tool-run/JOB_ID/results -H "X-API-Key: YOUR_API_KEY"
# your recent jobs, and your plan + usage
curl https://convertfleet.online/api/jobs -H "X-API-Key: YOUR_API_KEY"
curl https://convertfleet.online/api/auth/me -H "X-API-Key: YOUR_API_KEY"Tool ids
The tool field on /api/tool-run takes these ids. The MCP name is the friendlier alias for the same job.
REST tool | MCP tool | Does |
|---|---|---|
fb | facebook_page_scrape | Pull public Facebook Page details (about, contact, category) from a page URL or ID.… |
fbads | facebook_ads_scrape | Search Meta's Ad Library (Facebook + Instagram) for LIVE ads by brand, advertiser or keyword. Returns each ad's advertiser page, r… |
yt | youtube_extract | Extract metadata and stats for a YouTube video OR channel. Pass a video URL for one video, or a channel URL to list recent videos.… |
yt_comp | youtube_competitor | Compare 1-5 YouTube channels side by side (subscriber counts, upload cadence, recent performance).… |
yt_tx | youtube_transcript | Get the transcript / closed captions for one or many YouTube videos. Returns, per video, the full plain-text transcript, timestamp… |
twitter | twitter_scrape | Scrape X/Twitter by search query, username, or tweet URLs. Returns tweets with engagement.… |
instagram | instagram_scrape | Scrape an Instagram account's followers or following list. Returns username, full name, user id, verified/private flags and avatar… |
products | product_scrape | Scrape an e-commerce store's product catalogue (WooCommerce, Shopify, or generic) including variations, paid add-ons (each add-on … |
email | email_verify | Verify deliverability of one or many email addresses (syntax, MX, SMTP).… |
disposable | disposable_email_check | Flag disposable / temporary / throwaway email addresses or domains.… |
webemail | website_email_find | Crawl a website/domain and find public contact emails, phones, and social links.… |
dl_yt | youtube_download | Get downloadable media URLs and available formats/metadata for a YouTube video.… |
dl_ig | instagram_download | Get downloadable media URLs and metadata for an Instagram post or reel.… |
dl_tt | tiktok_download | Get downloadable (watermark-free) media URLs and metadata for a TikTok video.… |
dl_fb | facebook_download | Get downloadable media URLs and metadata for a Facebook video.… |
dl_sn | snapchat_download | Get downloadable media URLs and metadata for a Snapchat spotlight/story video.… |
websearch | google_search | Search the web and return the ranked result links (title, URL, domain, snippet, position) plus related searches and any answer box… |
websearch | google_search_scrape | Search the web AND read every result page in one call. Returns the ranked links plus, for each one, the scraped page: final URL, H… |
websearch | scrape_web_pages | Fetch specific URLs you already know and extract their content — title, meta description, canonical, language, H1/H2 headings, rea… |
gads | google_ads_transparency | Check whether a business or brand is running GOOGLE ads right now. Reads Google's public Ads Transparency Center and returns each … |
adleads | ad_library_lead_finder | Find local businesses in a niche + city and report which ones are running ads. For every business it checks BOTH Google's Ads Tran… |
— (/api/scrape) | google_maps_search | Google Maps business listings. |
Parameter names match each tool's page, except where the tool documents a rename (for example MCP limit → REST max_results). Each tool page shows both calls side by side.