​

Unified API

• capabilities: ask DumplingAI to do a job like search_news, extract_document, or scrape_page
• provider endpoints: call a specific managed upstream endpoint like serper.search, perplexity.search, or firecrawl.scrape

​

Base URL

https://app.dumplingai.com

​

Capability lane

​

Endpoints

• POST /api/v2/search
• POST /api/v2/details
• POST /api/v2/run

​

Example

curl -X POST https://app.dumplingai.com/api/v2/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "capability",
    "id": "search_news",
    "input": {
      "query": "latest AI regulation",
      "dateRange": "pastWeek"
    }
  }'

​

Provider endpoint lane

​

Endpoints

• POST /api/v2/search
• POST /api/v2/details
• POST /api/v2/run

​

Example

curl -X POST https://app.dumplingai.com/api/v2/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "endpoint",
    "id": "serper.search",
    "input": {
      "query": "best seo keywords for plumbers in nyc"
    },
    "options": {
      "include_native": true
    }
  }'

​

Response envelope

{
  "success": true,
  "requestId": "req_123",
  "object": "capability_result",
  "data": {},
  "meta": {}
}

{
  "success": false,
  "requestId": "req_123",
  "error": "Provider not allowed for this API key",
  "code": "PROVIDER_NOT_ALLOWED"
}

​

Current capabilities

• google_search
• search_news
• search_places
• get_google_reviews
• crawl_site
• screenshot
• extract_web
• extract_document
• extract_image
• extract_audio
• extract_video
• scrape_page
• get_youtube_transcript

• crawl resolves to crawl_site
• extract resolves to extract_web

• screenshot supports firecrawl, scrapingfish, and phantomjscloud
• extract_web, extract_document, extract_image, extract_audio, and extract_video are DumplingAI-managed capabilities and surface provider: "dumplingai"
• crawl_site defaults to firecrawl and falls back to spidercloud when needed

​

Current provider endpoints

• serper.search
• serper.news
• serper.places
• serper.maps
• serper.autocomplete
• serper.images
• serper.videos
• serper.shopping
• serper.scholar
• serper.patents
• perplexity.search
• firecrawl.scrape
• firecrawl.search
• firecrawl.map
• firecrawl.crawl
• firecrawl.screenshot
• scrapingfish.screenshot
• spidercloud.scrape
• spidercloud.crawl
• spidercloud.links
• dataforseo.google_reviews
• phantomjscloud.screenshot
• phantomjscloud.scrape
• scrapecreators.youtube_transcript
• transcriptapi.youtube_transcript
• transcriptapi.youtube_search
• transcriptapi.youtube_channel_videos
• perplexity.search
• dataforseo.dataforseo_labs_google_keyword_ideas

​

Screenshot example

curl -X POST https://app.dumplingai.com/api/v2/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "capability",
    "id": "screenshot",
    "provider": "firecrawl",
    "input": {
      "url": "https://example.com",
      "fullPage": true,
      "wait": 1000,
      "viewport": {
        "width": 1280,
        "height": 800
      }
    }
  }'

​

Related docs

• MCP Server
• API Reference Overview