---
name: orthogonal-supadata
description: "Call Supadata through Orthogonal's pay-per-use Run API: Transcripts and metadata for YouTube, TikTok, Instagram, X and Facebook videos, transcript translation, AI structured extraction from video, YouTube channel/playlist/search data and batches, and web pages to Markdown (scrape, map, crawl)."
---

# Supadata — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

Transcripts and metadata for YouTube, TikTok, Instagram, X and Facebook videos, transcript translation, AI structured extraction from video, YouTube channel/playlist/search data and batches, and web pages to Markdown (scrape, map, crawl).

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### YouTube video metadata

Get metadata for a YouTube video.

`GET /youtube/video`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/bde72536-05a0-4b74-b53b-6d005fbacb69

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/video-get

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | YouTube video URL or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/video","method":"GET","query":{"id":"<string>"}}'
```

### YouTube playlist metadata

Get metadata for a YouTube playlist.

`GET /youtube/playlist`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/8142d7ce-0a67-4c39-9bff-fe4faa7c160a

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/playlist

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | YouTube playlist URL or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/playlist","method":"GET","query":{"id":"<string>"}}'
```

### YouTube playlist videos

Get video IDs from a YouTube playlist.

`GET /youtube/playlist/videos`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/ee710623-9fd4-46a7-8f6c-aab52d80cbe9

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/playlist-videos

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | YouTube playlist URL or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |
| `limit` | number | No | Maximum number of video IDs to return |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/playlist/videos","method":"GET","query":{"id":"<string>","limit":"<number>"}}'
```

### YouTube channel metadata

Get metadata for a YouTube channel.

`GET /youtube/channel`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/270e1611-a8cb-4630-952b-af1309e90725

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/channel

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | YouTube channel URL, handle or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/channel","method":"GET","query":{"id":"<string>"}}'
```

### YouTube channel videos

Get video IDs from a YouTube channel.

`GET /youtube/channel/videos`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/40c6e791-9e86-43aa-b89e-67739b85fe3c

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/channel-videos

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | YouTube channel URL, handle or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |
| `limit` | number | No | Maximum number of video IDs to return. If type = all, regular (landscape) videos are filled first, then Shorts, then live streams. |
| `type` | string | No | Type of videos to return. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/channel/videos","method":"GET","query":{"id":"<string>","limit":"<number>","type":"<string>"}}'
```

### YouTube search

Search YouTube for videos, channels, and playlists with advanced filters.

`GET /youtube/search`

**Estimated cost:** from $0.0109 per call (required params only), up to $2.725; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/supadata/386ade14-9876-4773-af6f-d2aa9ffd5803

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/search

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string |
| `uploadDate` | string | No | Filter by upload date (eg. last month). Note: works only for videos and movies. |
| `type` | string | No | Filter by content type |
| `duration` | string | No | Filter by video duration: short (<4min), medium (4-20min), long (>20min). Note: works only for videos and movies. |
| `sortBy` | string | No | Sort order of search results. |
| `features` | string | No | Array of special features to filter by (repeat the parameter for several: `features=hd&features=subtitles`). Note: works only for videos and movies. |
| `limit` | number | No | Maximum number of results to return. When provided, the API will automatically paginate to fetch up to this many results. When omitted, returns a single page with `nextPageToken` for manual pagination. |
| `nextPageToken` | string | No | Token for fetching the next page of results. When provided, other filter parameters are ignored. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/search","method":"GET","query":{"query":"<string>","uploadDate":"<string>","type":"<string>","duration":"<string>","sortBy":"<string>","features":"<string>","limit":"<number>","nextPageToken":"<string>"}}'
```

### Web page to Markdown

Extract content from any web page to Markdown format.

`GET /web/scrape`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/f90b7a17-fc65-463c-9d28-59d53d1bf447

**Docs:** https://docs.supadata.ai/api-reference/endpoint/web/scrape

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | URL of the webpage |
| `noLinks` | boolean | No | When true, Markdown links are stripped from the content. |
| `lang` | string | No | Preferred language for the scraped content (ISO 639-1 code). Sets Accept-Language header to influence website language selection. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/web/scrape","method":"GET","query":{"url":"<string>","noLinks":"<boolean>","lang":"<string>"}}'
```

### Website URL map

Extract all links found on a whole website.

`GET /web/map`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/3b3a43a5-5b4a-4c3f-99b0-db4e468e7aa9

**Docs:** https://docs.supadata.ai/api-reference/endpoint/web/map

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | URL of the webpage |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/web/map","method":"GET","query":{"url":"<string>"}}'
```

### Video transcript

Get transcript from a supported video platform (YouTube, TikTok, Twitter, Instagram, Facebook) or file URL. If the video is too large to return transcript immediately, request returns a job ID. Use the `/transcript/:jobId` endpoint to get job results.

`GET /transcript`

**Estimated cost:** Dynamic — use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/supadata/1d37fdf6-babd-4196-8fab-619cf6ccc0a4

**Docs:** https://docs.supadata.ai/api-reference/endpoint/transcript/transcript

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Video URL from any supported platform (YouTube, TikTok, Twitter, Instagram, Facebook) or a direct media file URL. |
| `lang` | string | No | Preferred language code of the transcript (ISO 639-1). If not provided, the first available language will be returned. If the requested language is unavailable, the API defaults to the first available language. See [Languages](https://docs.supadata.ai/youtube/supported-language-codes). |
| `text` | boolean | No | When true, returns plain text transcript. |
| `chunkSize` | number | No | Maximum characters per transcript chunk (only when text=false) |
| `mode` | string | No | Transcript mode: `native` (only fetch existing transcript), `generate` (always generate transcript using AI), or `auto` (try native, fallback to generate if unavailable). If url is a file URL, mode is always `generate`. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/transcript","method":"GET","query":{"url":"<string>","lang":"<string>","text":"<boolean>","chunkSize":"<number>","mode":"<string>"}}'
```

### Transcript job results

Get results for a transcript job by job ID.

`GET /transcript/{jobId}`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/supadata/a20b17ea-68ec-46a9-a9e1-e17383197409

**Docs:** https://docs.supadata.ai/api-reference/endpoint/transcript/transcript-get

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `jobId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {jobId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/transcript/{jobId}","method":"GET"}'
```

### Social media metadata

Fetch metadata from any supported internet media including YouTube, TikTok, Instagram, Twitter/X and Facebook posts. Returns unified metadata with a predictable structure across all platforms.

`GET /metadata`

**Estimated cost:** $0.0109

**Page:** https://www.orthogonal.com/api/supadata/3964100a-fc85-464b-a81a-e37d3731a498

**Docs:** https://docs.supadata.ai/api-reference/endpoint/metadata/metadata

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | URL to any supported internet media. Supports YouTube videos, TikTok videos, Instagram reels/posts, Twitter/X posts, Facebook videos, and more. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/metadata","method":"GET","query":{"url":"<string>"}}'
```

### Video data extraction

Use AI to analyze video content and extract structured data. Provide either a prompt describing what to extract, a JSON Schema for the output format, or both. Supports YouTube, TikTok, Instagram, Twitter/X, and Facebook videos, or a direct media file URL. Returns a job ID for asynchronous processing. Use the `/extract/:jobId` endpoint to poll for results.

`POST /extract`

**Estimated cost:** $9.81

**Page:** https://www.orthogonal.com/api/supadata/4940e88e-d0ce-469b-a899-ee49386dac95

**Docs:** https://docs.supadata.ai/api-reference/endpoint/extract/extract

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | URL to any supported video media. Supports YouTube, TikTok, Instagram, Twitter/X, and Facebook videos, or a direct media file URL. |
| `prompt` | string | No | Natural language description of what data to extract from the video. Required if schema is not provided. Do not include JSON structure definitions here — use the "schema" field instead. |
| `schema` | object | No | JSON Schema defining the structure of data to extract. Required if prompt is not provided. Checked before the job is created: a schema the AI model cannot use (most often large `maxItems`/`maxLength` bounds) is rejected with `400 invalid-request` explaining what to change. See the schema rules at https://docs.supadata.ai/get-extract#schema-rules. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/extract","body":{"url":"<string>","prompt":"<string>","schema":"<object>"}}'
```

### Extraction job results

Get results for an extract job by job ID.

`GET /extract/{jobId}`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/supadata/c2f8954e-1d39-491c-8c67-5f807847f151

**Docs:** https://docs.supadata.ai/api-reference/endpoint/extract/extract-get

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `jobId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {jobId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/extract/{jobId}","method":"GET"}'
```

### YouTube transcript translation

Translate YouTube video transcript into different languages.

`GET /youtube/transcript/translate`

**Estimated cost:** Dynamic — use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/supadata/a1dd016d-80d4-474d-88e2-1b7b591ac8b1

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/translation

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | No | YouTube video URL. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |
| `videoId` | string | No | YouTube video ID. Alternative to URL. |
| `text` | boolean | No | When true, returns plain text transcript. |
| `chunkSize` | number | No | Maximum characters per transcript chunk (only when text=false) |
| `lang` | string | Yes | Language code for translation (ISO 639-1). See [Languages](https://docs.supadata.ai/youtube/supported-language-codes). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/transcript/translate","method":"GET","query":{"url":"<string>","videoId":"<string>","text":"<boolean>","chunkSize":"<number>","lang":"<string>"}}'
```

### YouTube metadata batch

Create a batch job to fetch metadata of multiple YouTube videos. Batches created from a playlist or channel include regular videos only (Shorts and live streams are skipped).

`POST /youtube/video/batch`

**Estimated cost:** from $0.0109 per call (required params only), up to $54.5; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/supadata/23b949e9-3a00-4196-ba94-069768b8fc5c

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/video-batch

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `videoIds` | string | No | Array of YouTube video IDs or URLs |
| `playlistId` | string | No | YouTube playlist URL or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |
| `channelId` | string | No | YouTube channel URL, handle or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |
| `limit` | number | No | Maximum number of videos to process (when using playlistId or channelId) |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/video/batch","body":{"videoIds":"<string>","playlistId":"<string>","channelId":"<string>","limit":"<number>"}}'
```

### YouTube transcript batch

Create a batch job to get transcripts of multiple YouTube videos. Batches created from a playlist or channel include regular videos only (Shorts and live streams are skipped).

`POST /youtube/transcript/batch`

**Estimated cost:** from $0.0109 per call (required params only), up to $54.5; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/supadata/af801e80-670e-4aaf-9c28-3f9d9c5f40c7

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/transcript-batch

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `videoIds` | string | No | Array of YouTube video IDs or URLs |
| `playlistId` | string | No | YouTube playlist URL or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |
| `channelId` | string | No | YouTube channel URL, handle or ID. See [supported URL formats](https://docs.supadata.ai/youtube/supported-url-formats). |
| `limit` | number | No | Maximum number of videos to process (when using playlistId or channelId) |
| `lang` | string | No | Preferred language code of the transcript (ISO 639-1). If not provided, the first available language will be returned. If the requested language is unavailable, the API defaults to the first available language. See [Languages](https://docs.supadata.ai/youtube/supported-language-codes). |
| `text` | boolean | No | When true, returns plain text transcript. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/transcript/batch","body":{"videoIds":"<string>","playlistId":"<string>","channelId":"<string>","limit":"<number>","lang":"<string>","text":"<boolean>"}}'
```

### YouTube batch results

Get the status and results of a YouTube batch job.

`GET /youtube/batch/{jobId}`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/supadata/344deada-d390-416f-8665-ac60f6007e8a

**Docs:** https://docs.supadata.ai/api-reference/endpoint/youtube/batch-get

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `jobId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `limit` | integer | No | Return at most this many results (with `offset`, pages through a completed batch). Omit both to receive all results in one streamed response. |
| `offset` | integer | No | Skip this many results (in submission order) before returning a page. |

```bash
# Replace {jobId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/youtube/batch/{jobId}","method":"GET","query":{"limit":"<integer>","offset":"<integer>"}}'
```

### Website crawl

Create a crawl job to extract content from all pages on a website.

`POST /web/crawl`

**Estimated cost:** from $0.0109 per call (required params only), up to $54.5; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/supadata/3a3c9322-937c-4c9b-ac9d-27802e057166

**Docs:** https://docs.supadata.ai/api-reference/endpoint/web/crawl

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | URL of the website to crawl |
| `limit` | number | No | Maximum number of pages to crawl |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/web/crawl","body":{"url":"<string>","limit":"<number>"}}'
```

### Website crawl results

Get the status and results of a crawl by job ID.

`GET /web/crawl/{jobId}`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/supadata/58355419-e4ed-4423-9770-07f43abd0f4c

**Docs:** https://docs.supadata.ai/api-reference/endpoint/web/crawl-get

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `jobId` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `skip` | number | No |  |

```bash
# Replace {jobId} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"supadata","path":"/web/crawl/{jobId}","method":"GET","query":{"skip":"<number>"}}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/supadata
