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