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 Endpoint	Unified API target	Notes
`POST /api/v1/scrape`	`capability:scrape_page`	Best default for new page scraping jobs.
`POST /api/v1/crawl`	`capability:crawl_site`	Use for crawl jobs with a simple site-level contract.
`POST /api/v1/search-news`	`capability:search_news`	Use for recent-news discovery.
`POST /api/v1/get-youtube-transcript`	`capability:get_youtube_transcript`	Use for normalized transcript output and provider fallback.
`POST /api/v1/get-tiktok-profile`	`endpoint:scrapecreators.tiktok_profile`	Provider-native TikTok data stays in the provider endpoint lane.
`POST /api/v1/extract-audio`	`capability:extract_audio`	Use for audio summarization or structured audio extraction.
`POST /api/v1/extract-video`	`capability:extract_video`	Use 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.

​Migrating from Direct Endpoints

​Quick map

​Scrape

​Search news

​YouTube transcript

​TikTok provider endpoint

​Media extraction

​Still use Direct Endpoints for these

Migrating from Direct Endpoints

Quick map

Scrape

Search news

YouTube transcript

TikTok provider endpoint

Media extraction

Still use Direct Endpoints for these