> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dumplingai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating from Direct Endpoints

> Map common /api/v1 Direct Endpoint calls to the Unified API under /api/v2.

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

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.