Skip to main content

​
Migrating from Direct Endpoints

Direct Endpoints under /api/v1 remain supported. For new focused data integrations, prefer the Unified API under /api/v2 so you get one request envelope, Workbench discovery, API key policies, usage logs, and provider-aware routing.

​
Quick map

Direct EndpointUnified API targetNotes
POST /api/v1/scrapecapability:scrape_pageBest default for new page scraping jobs.
POST /api/v1/crawlcapability:crawl_siteUse for crawl jobs with a simple site-level contract.
POST /api/v1/search-newscapability:search_newsUse for recent-news discovery.
POST /api/v1/get-youtube-transcriptcapability:get_youtube_transcriptUse for normalized transcript output and provider fallback.
POST /api/v1/get-tiktok-profileendpoint:scrapecreators.tiktok_profileProvider-native TikTok data stays in the provider endpoint lane.
POST /api/v1/extract-audiocapability:extract_audioUse for audio summarization or structured audio extraction.
POST /api/v1/extract-videocapability:extract_videoUse for video summarization or structured video extraction.

​
Scrape

Direct Endpoint: 
curl -X POST https://app.dumplingai.com/api/v1/scrape \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "url": "https://example.com/article",
    "format": "markdown"
  }'
Unified API: 
curl -X POST https://app.dumplingai.com/api/v2/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "capability",
    "id": "scrape_page",
    "input": {
      "url": "https://example.com/article",
      "format": "markdown"
    }
  }'

​
Search news

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

​
YouTube transcript

Direct Endpoint: 
curl -X POST https://app.dumplingai.com/api/v1/get-youtube-transcript \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }'
Unified API: 
curl -X POST https://app.dumplingai.com/api/v2/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "capability",
    "id": "get_youtube_transcript",
    "input": {
      "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    }
  }'

​
TikTok provider endpoint

TikTok profile data is provider-native, so use the provider endpoint lane: 
curl -X POST https://app.dumplingai.com/api/v2/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "endpoint",
    "id": "scrapecreators.tiktok_profile",
    "input": {
      "handle": "duolingo"
    },
    "options": {
      "include_native": true
    }
  }'

​
Media extraction

Use extract_audio or extract_video for focused media extraction: 
curl -X POST https://app.dumplingai.com/api/v2/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "capability",
    "id": "extract_audio",
    "input": {
      "inputMethod": "url",
      "audio": "https://example.com/interview.mp3",
      "prompt": "Summarize the key action items"
    }
  }'

​
Still use Direct Endpoints for these

Keep using /api/v1 when you need current Make.com compatibility, PDF utility endpoints, AI image generation, agent completion, JS/Python execution, or LinkedIn endpoints.