# Dailymotion Text & Metadata Scraper (`ilborso/dailymotion-text-metadata-scraper`) Actor

A powerful Apify Actor that automatically extracts transcriptions, subtitles, auto-generated captions, and detailed metadata from Dailymotion videos. Process single videos by URL or search and scrape entire collections matching your criteria.

- **URL**: https://apify.com/ilborso/dailymotion-text-metadata-scraper.md
- **Developed by:** [Fabio Borsotti](https://apify.com/ilborso) (community)
- **Categories:** AI, Social media, MCP servers
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Dailymotion Transcript Scraper - Extract Video Transcriptions & Metadata

A powerful Apify Actor that automatically extracts transcriptions, subtitles, auto-generated captions, and detailed metadata from Dailymotion videos. Process single videos by URL or search and scrape entire collections matching your criteria.

### What This Actor Does

#### Core Capabilities

- **Extract Video Transcriptions** - Download manual subtitles and auto-generated captions from Dailymotion videos in multiple languages
- **Bulk Video Search & Processing** - Search Dailymotion by keywords and automatically process all matching results
- **Multi-Language Subtitle Collection** - Extract subtitles in all available languages with customizable priority ordering
- **Video Metadata Extraction** - Collect comprehensive video information including title, duration, view count, upload date, uploader details, and more
- **Clean Text Output** - Convert SRT and VTT subtitle formats to readable plain text with timestamps and formatting removed
- **Flexible Filtering** - Filter search results by publication date (24 hours, 7 days, 30 days, or 1 year)
- **Transcript Filtering** - Optionally filter search results to include only videos with available transcriptions
- **Scalable Processing** - Process from 1 to 100+ videos in a single run with configurable limits

#### Use Cases

- **Content Research** - Extract transcriptions from educational, technical, or news videos for analysis
- **SEO Content Analysis** - Collect video metadata and transcriptions for competitor analysis
- **Audio Content Processing** - Export full video transcriptions for NLP, translation, or archival
- **Quality Assurance** - Verify subtitle availability and quality across video collections
- **Data Collection** - Build datasets of video transcriptions in multiple languages

---

### Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| **`urls`** | array | No | - | List of direct Dailymotion video URLs. Format: `https://www.dailymotion.com/video/xXXXXXX`. Direct URLs are always processed regardless of other filters. |
| **`query`** | string | No | - | Search query to find Dailymotion videos. If provided, the actor searches for matching videos and processes them according to other parameters. |
| **`limit`** | integer | No | 10 | Maximum number of videos to retrieve from search results (1-100). Does not apply to direct URLs. |
| **`langs`** | array | Yes | ["en", "it", "fr"] | Preferred language codes in priority order (e.g., `["en", "it", "fr"]`). The primary transcription is selected from the first available language. All available languages are collected regardless. |
| **`output`** | string | Yes | "output.json" | Name of the JSON file to save results in the key-value store (e.g., `results.json`, `transcripts.json`). |
| **`metadata`** | string | No | "false" | Include full metadata from video analysis (true/false). When enabled, adds comprehensive metadata object to each video result. |
| **`onlyWithTranscription`** | string | No | "true" | In search mode, filter to only videos with transcriptions available (true/false). Ignored for direct URLs. |
| **`dateRange`** | string | No | (empty) | In search mode, filter search results by publication date. Options: `last_daily` (24 hours), `last_week` (7 days), `last_month` (30 days), `last_year` (365 days). |

#### Input Examples

**Extract from single video URL:**
```json
{
  "urls": ["https://www.dailymotion.com/video/xaeie8a"],
  "langs": ["en", "it", "fr"],
  "output": "transcript.json"
}
````

**Search and process videos:**

```json
{
  "query": "machine learning tutorial",
  "limit": 5,
  "langs": ["en"],
  "output": "ml_videos.json",
  "onlyWithTranscription": "true"
}
```

**Combined: direct URLs + search:**

```json
{
  "urls": ["https://www.dailymotion.com/video/xaeie8a"],
  "query": "python programming",
  "limit": 10,
  "langs": ["en", "it"],
  "output": "combined.json",
  "dateRange": "last_month"
}
```

***

### Output Format

The actor outputs a JSON array of video objects. Each object contains extracted transcriptions and metadata.

#### Output Without Metadata (`metadata: false`)

```json
[
  {
    "url": "https://www.dailymotion.com/video/xaeie8a",
    "title": "States: Donald Trump affirms he 'loves inflation' as prices reach highest levels in three years",
    "videoId": "xaeie8a",
    "duration": 114,
    "views": 7896,
    "uploadDate": "20260723",
    "uploader": "News Channel",
    "availableSubtitleLanguages": ["en", "it", "fr"],
    "primaryLanguage": "en",
    "primaryTranscription": "Today in news, Donald Trump made controversial statements about inflation... [full transcription text]",
    "allTranscriptions": {
      "en": "Today in news, Donald Trump made controversial statements about inflation...",
      "it": "Oggi nelle notizie, Donald Trump ha fatto dichiarazioni controverse sull'inflazione...",
      "fr": "Aujourd'hui dans l'actualité, Donald Trump a fait des déclarations controversées sur l'inflation..."
    }
  }
]
```

#### Output With Metadata (`metadata: true`)

```json
[
  {
    "url": "https://www.dailymotion.com/video/xaeie8a",
    "title": "States: Donald Trump affirms he 'loves inflation' as prices reach highest levels in three years",
    "videoId": "xaeie8a",
    "duration": 114,
    "views": 7896,
    "uploadDate": "20260723",
    "uploader": "News Channel",
    "availableSubtitleLanguages": ["en", "it", "fr"],
    "primaryLanguage": "en",
    "primaryTranscription": "Today in news, Donald Trump made controversial statements about inflation... [full transcription text]",
    "allTranscriptions": {
      "en": "Today in news, Donald Trump made controversial statements about inflation...",
      "it": "Oggi nelle notizie, Donald Trump ha fatto dichiarazioni controverse sull'inflazione...",
      "fr": "Aujourd'hui nelle actualité, Donald Trump a fait des déclarations controversées sur l'inflation..."
    },
    "metadata": {
      "id": "xaeie8a",
      "ext": "mp4",
      "format": "247 - webm container vp9 vp09.00.51.08 [1920x1080]",
      "webpage_url": "https://www.dailymotion.com/video/xaeie8a",
      "display_id": "xaeie8a",
      "title": "States: Donald Trump affirms he 'loves inflation' as prices reach highest levels in three years",
      "description": "Full video description here...",
      "duration": 114,
      "timestamp": 1721750595,
      "upload_date": "20260723",
      "uploader": "News Channel",
      "uploader_id": "news_channel_id",
      "like_count": 245,
      "comment_count": 87,
      "view_count": 7896,
      "tags": ["news", "trump", "inflation"],
      "categories": ["News & Politics"],
      "thumbnail": "https://...",
      "subtitles": {
        "en": [{"ext": "vtt", "url": "https://..."}],
        "it": [{"ext": "vtt", "url": "https://..."}],
        "fr": [{"ext": "vtt", "url": "https://..."}]
      },
      "automatic_captions": {},
      "formats": [...],
      "extractor": "dailymotion",
      "extractor_key": "Dailymotion"
    }
  }
]
```

#### Output Fields Explanation

| Field | Type | Description |
|-------|------|-------------|
| `url` | string | Direct URL of the Dailymotion video |
| `title` | string | Video title |
| `videoId` | string | Unique Dailymotion video ID |
| `duration` | integer | Video duration in seconds |
| `views` | integer | Total view count |
| `uploadDate` | string | Video publication date (format: YYYYMMDD) |
| `uploader` | string | Name of the channel/uploader |
| `availableSubtitleLanguages` | array | List of language codes for which subtitles/captions are available |
| `primaryLanguage` | string | Language code of the selected primary transcription (based on language preferences) |
| `primaryTranscription` | string | Full transcription text in the primary language |
| `allTranscriptions` | object | Dictionary with transcriptions for all available languages (key: language code, value: full text) |
| `metadata` | object | *(optional, only if `metadata: true`)* Complete video metadata object with 50+ fields including formats, thumbnails, categories, and more |

***

### How It Works

1. **Input Validation** - Accepts direct video URLs and/or search queries
2. **Video Discovery** - Searches Dailymotion and filters by date range and transcription availability
3. **Metadata Extraction** - Downloads comprehensive video information for each video
4. **Subtitle Download** - Retrieves all available manual subtitles and auto-generated captions
5. **Text Processing** - Converts subtitle formats (SRT/VTT) to clean readable text
6. **Language Selection** - Selects primary transcription based on language preferences
7. **Results Export** - Saves complete results as JSON array to specified output file

***

### Typical Results

#### Search Performance

| Query Type | Videos Found | Processing Time | Typical Use |
|------------|-------------|-----------------|-------------|
| Specific keyword (e.g., "tutorial") | 5-50 | 1-2 minutes | Quick research |
| Broad category (e.g., "news") | 20-100 | 5-10 minutes | Content collection |
| Direct URLs only | Variable | 10-30 sec per video | Focused analysis |

#### Transcription Availability

- **Manual Subtitles**: ~40-60% of videos
- **Auto-Generated Captions**: ~20-40% of videos (platform-dependent)
- **Multiple Languages**: 30-50% of videos with subtitles

***

### Supported Languages

The actor supports all ISO 639-1 language codes including (but not limited to):

- **Major Languages**: English (en), Italian (it), French (fr), Spanish (es), German (de), Portuguese (pt), Russian (ru), Chinese (zh), Japanese (ja), Arabic (ar), Hindi (hi)
- **And 180+ additional languages**

Specify language codes in the `langs` parameter in your preferred priority order.

See below table:

#### Supported languages (iso ISO 639-1)

| Codice | Lingua            | Codice | Lingua           | Codice | Lingua         | Codice | Lingua      | Codice | Lingua          | Codice | Lingua     |
| ------ | ----------------- | ------ | ---------------- | ------ | -------------- | ------ | ----------- | ------ | --------------- | ------ | ---------- |
| aa     | Afar              | ab     | Abkhaz           | ae     | Avestan        | af     | Afrikaans   | ak     | Akan            | am     | Amharic    |
| ar     | Arabic            | as     | Assamese         | av     | Avaric         | ay     | Aymara      | az     | Azerbaijani     | ba     | Bashkir    |
| be     | Belarusian        | bg     | Bulgarian        | bi     | Bislama        | bm     | Bambara     | bn     | Bengali         | bo     | Tibetan    |
| br     | Breton            | bs     | Bosnian          | ca     | Catalan        | ce     | Chechen     | ch     | Chamorro        | co     | Corsican   |
| cr     | Cree              | cs     | Czech            | cu     | Church Slavic  | cv     | Chuvash     | cy     | Welsh           | da     | Danish     |
| de     | German            | dv     | Divehi           | dz     | Dzongkha       | ee     | Ewe         | el     | Greek           | en     | English    |
| eo     | Esperanto         | es     | Spanish          | et     | Estonian       | eu     | Basque      | fa     | Persian         | ff     | Fulah      |
| fi     | Finnish           | fj     | Fijian           | fo     | Faroese        | fr     | French      | fy     | Western Frisian | ga     | Irish      |
| gd     | Scottish Gaelic   | gl     | Galician         | gn     | Guarani        | gu     | Gujarati    | gv     | Manx            | ha     | Hausa      |
| he     | Hebrew            | hi     | Hindi            | ho     | Hiri Motu      | hr     | Croatian    | ht     | Haitian         | hu     | Hungarian  |
| hy     | Armenian          | hz     | Herero           | ia     | Interlingua    | id     | Indonesian  | ie     | Interlingue     | ig     | Igbo       |
| ii     | Sichuan Yi        | ik     | Inupiaq          | io     | Ido            | is     | Icelandic   | it     | Italian         | iu     | Inuktitut  |
| ja     | Japanese          | jv     | Javanese         | ka     | Georgian       | kg     | Kongo       | ki     | Kikuyu          | kj     | Kuanyama   |
| kk     | Kazakh            | kl     | Kalaallisut      | km     | Central Khmer  | kn     | Kannada     | ko     | Korean          | kr     | Kanuri     |
| ks     | Kashmiri          | ku     | Kurdish          | kv     | Komi           | kw     | Cornish     | ky     | Kirghiz         | la     | Latin      |
| lb     | Luxembourgish     | lg     | Ganda            | li     | Limburgan      | ln     | Lingala     | lo     | Lao             | lt     | Lithuanian |
| lu     | Luba-Katanga      | lv     | Latvian          | mg     | Malagasy       | mh     | Marshallese | mi     | Maori           | mk     | Macedonian |
| ml     | Malayalam         | mn     | Mongolian        | mr     | Marathi        | ms     | Malay       | mt     | Maltese         | my     | Burmese    |
| na     | Nauru             | nb     | Norwegian Bokmål | nd     | North Ndebele  | ne     | Nepali      | ng     | Ndonga          | nl     | Dutch      |
| nn     | Norwegian Nynorsk | no     | Norwegian        | nr     | South Ndebele  | nv     | Navajo      | ny     | Chichewa        | oc     | Occitan    |
| oj     | Ojibwa            | om     | Oromo            | or     | Oriya          | os     | Ossetian    | pa     | Panjabi         | pi     | Pali       |
| pl     | Polish            | ps     | Pashto           | pt     | Portuguese     | qu     | Quechua     | rm     | Romansh         | rn     | Rundi      |
| ro     | Romanian          | ru     | Russian          | rw     | Kinyarwanda    | sa     | Sanskrit    | sc     | Sardinian       | sd     | Sindhi     |
| se     | Northern Sami     | sg     | Sango            | sh     | Serbo-Croatian | si     | Sinhala     | sk     | Slovak          | sl     | Slovenian  |
| sm     | Samoan            | sn     | Shona            | so     | Somali         | sq     | Albanian    | sr     | Serbian         | ss     | Swati      |
| st     | Southern Sotho    | su     | Sundanese        | sv     | Swedish        | sw     | Swahili     | ta     | Tamil           | te     | Telugu     |
| tg     | Tajik             | th     | Thai             | ti     | Tigrinya       | tk     | Turkmen     | tl     | Tagalog         | tn     | Tswana     |
| to     | Tonga             | tr     | Turkish          | ts     | Tsonga         | tt     | Tatar       | tw     | Twi             | ty     | Tahitian   |
| ug     | Uighur            | uk     | Ukrainian        | ur     | Urdu           | uz     | Uzbek       | ve     | Venda           | vi     | Vietnamese |
| vo     | Volapük           | wa     | Walloon          | wo     | Wolof          | xh     | Xhosa       | yi     | Yiddish         | yo     | Yoruba     |
| za     | Zhuang            | zh     | Chinese          | zu     | Zulu           |        |             |        |                 |        |            |

***

### Common Applications

#### Content Research & Analysis

Extract transcriptions from competitors' videos or industry content for analysis and SEO optimization.

#### Educational Content Processing

Collect educational video transcriptions for creating study materials, documentation, or knowledge bases.

#### Multilingual Content Collection

Gather transcriptions in multiple languages for translation projects or multilingual dataset creation.

#### Quality Assurance Testing

Verify subtitle coverage, language availability, and transcription quality across video collections.

#### Archival & Preservation

Create searchable text archives of video content for long-term storage or accessibility.

***

### Limitations & Notes

- Search results depend on Dailymotion's search algorithm and availability
- Subtitle availability varies by video (manual subtitles must be created by uploader, auto-captions by platform)
- Processing time increases with number of videos and subtitle file sizes
- Very large transcriptions may take additional time to download and process
- Some videos may have regional restrictions affecting availability

***

### Getting Started

1. Provide video URLs and/or a search query
2. Select preferred languages for transcription priority
3. Configure optional filters (date range, transcription requirement)
4. Enable metadata if you need comprehensive video information
5. Run the actor and retrieve results from the output JSON file

***

### Support

For issues, questions, or feature requests, please contact the actor maintainers or consult the documentation.

**Last Updated**: 2026-07-24

# Actor input Schema

## `urls` (type: `array`):

List of direct Dailymotion video URLs. Supported formats: dailymotion.com/video/xXXXXXX. Specified videos are always processed.

## `query` (type: `string`):

Dailymotion search query to find videos. Optional if urls are specified. If both are provided, both will be processed.

## `limit` (type: `integer`):

Maximum number of videos to retrieve from search query. Does not apply to direct URLs. Range: 1-100

## `langs` (type: `array`):

List of language codes in priority order. Primary transcription will be selected from the first available language in this list.

## `output` (type: `string`):

Name of the JSON file to save results in the key-value store. Default: output.json

## `metadata` (type: `string`):

Include full metadata from yt-dlp in output (true/false). Default: false

## `onlyWithTranscription` (type: `string`):

In search mode, filter to only videos with transcriptions (true/false). Default: true. Ignored for direct URLs.

## `dateRange` (type: `string`):

In search mode, filter results by publication date. Options: last\_daily, last\_week, last\_month, last\_year. Leave empty for no filter.

## Actor input object example

```json
{
  "urls": [
    "https://www.dailymotion.com/video/xar6klq"
  ],
  "limit": 10,
  "langs": [
    "en",
    "it",
    "fr"
  ],
  "output": "output.json",
  "metadata": "false",
  "onlyWithTranscription": "true",
  "dateRange": ""
}
```

# Actor output Schema

## `datasetUrl` (type: `string`):

URL to access all scraped video items in the dataset

## `kvStoreUrl` (type: `string`):

URL to the key-value store containing the aggregated output JSON

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.dailymotion.com/video/xar6klq"
    ],
    "langs": [
        "en",
        "it",
        "fr"
    ],
    "output": "output.json"
};

// Run the Actor and wait for it to finish
const run = await client.actor("ilborso/dailymotion-text-metadata-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.dailymotion.com/video/xar6klq"],
    "langs": [
        "en",
        "it",
        "fr",
    ],
    "output": "output.json",
}

# Run the Actor and wait for it to finish
run = client.actor("ilborso/dailymotion-text-metadata-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.dailymotion.com/video/xar6klq"
  ],
  "langs": [
    "en",
    "it",
    "fr"
  ],
  "output": "output.json"
}' |
apify call ilborso/dailymotion-text-metadata-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ilborso/dailymotion-text-metadata-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Dailymotion Text & Metadata Scraper",
        "description": "A powerful Apify Actor that automatically extracts transcriptions, subtitles, auto-generated captions, and detailed metadata from Dailymotion videos. Process single videos by URL or search and scrape entire collections matching your criteria.",
        "version": "0.0",
        "x-build-id": "B93IcrtAWtQAAWJ08"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ilborso~dailymotion-text-metadata-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ilborso-dailymotion-text-metadata-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/ilborso~dailymotion-text-metadata-scraper/runs": {
            "post": {
                "operationId": "runs-sync-ilborso-dailymotion-text-metadata-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/ilborso~dailymotion-text-metadata-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-ilborso-dailymotion-text-metadata-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "langs",
                    "output"
                ],
                "properties": {
                    "urls": {
                        "title": "Direct URLs",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "List of direct Dailymotion video URLs. Supported formats: dailymotion.com/video/xXXXXXX. Specified videos are always processed.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "query": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Dailymotion search query to find videos. Optional if urls are specified. If both are provided, both will be processed."
                    },
                    "limit": {
                        "title": "Search Limit",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Maximum number of videos to retrieve from search query. Does not apply to direct URLs. Range: 1-100",
                        "default": 10
                    },
                    "langs": {
                        "title": "Preferred Languages",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "List of language codes in priority order. Primary transcription will be selected from the first available language in this list.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "aa",
                                "ab",
                                "ae",
                                "af",
                                "ak",
                                "am",
                                "ar",
                                "as",
                                "av",
                                "ay",
                                "az",
                                "ba",
                                "be",
                                "bg",
                                "bi",
                                "bm",
                                "bn",
                                "bo",
                                "br",
                                "bs",
                                "ca",
                                "ce",
                                "ch",
                                "co",
                                "cr",
                                "cs",
                                "cu",
                                "cv",
                                "cy",
                                "da",
                                "de",
                                "dv",
                                "dz",
                                "ee",
                                "el",
                                "en",
                                "eo",
                                "es",
                                "et",
                                "eu",
                                "fa",
                                "ff",
                                "fi",
                                "fj",
                                "fo",
                                "fr",
                                "fy",
                                "ga",
                                "gd",
                                "gl",
                                "gn",
                                "gu",
                                "gv",
                                "ha",
                                "he",
                                "hi",
                                "ho",
                                "hr",
                                "ht",
                                "hu",
                                "hy",
                                "hz",
                                "ia",
                                "id",
                                "ie",
                                "ig",
                                "ii",
                                "ik",
                                "io",
                                "is",
                                "it",
                                "iu",
                                "ja",
                                "jv",
                                "ka",
                                "kg",
                                "ki",
                                "kj",
                                "kk",
                                "kl",
                                "km",
                                "kn",
                                "ko",
                                "kr",
                                "ks",
                                "ku",
                                "kv",
                                "kw",
                                "ky",
                                "la",
                                "lb",
                                "lg",
                                "li",
                                "ln",
                                "lo",
                                "lt",
                                "lu",
                                "lv",
                                "mg",
                                "mh",
                                "mi",
                                "mk",
                                "ml",
                                "mn",
                                "mr",
                                "ms",
                                "mt",
                                "my",
                                "na",
                                "nb",
                                "nd",
                                "ne",
                                "ng",
                                "nl",
                                "nn",
                                "no",
                                "nr",
                                "nv",
                                "ny",
                                "oc",
                                "oj",
                                "om",
                                "or",
                                "os",
                                "pa",
                                "pi",
                                "pl",
                                "ps",
                                "pt",
                                "qu",
                                "rm",
                                "rn",
                                "ro",
                                "ru",
                                "rw",
                                "sa",
                                "sc",
                                "sd",
                                "se",
                                "sg",
                                "sh",
                                "si",
                                "sk",
                                "sl",
                                "sm",
                                "sn",
                                "so",
                                "sq",
                                "sr",
                                "ss",
                                "st",
                                "su",
                                "sv",
                                "sw",
                                "ta",
                                "te",
                                "tg",
                                "th",
                                "ti",
                                "tk",
                                "tl",
                                "tn",
                                "to",
                                "tr",
                                "ts",
                                "tt",
                                "tw",
                                "ty",
                                "ug",
                                "uk",
                                "ur",
                                "uz",
                                "ve",
                                "vi",
                                "vo",
                                "wa",
                                "wo",
                                "xh",
                                "yi",
                                "yo",
                                "za",
                                "zh",
                                "zu"
                            ]
                        },
                        "default": [
                            "en",
                            "it",
                            "fr"
                        ]
                    },
                    "output": {
                        "title": "Output File Name",
                        "type": "string",
                        "description": "Name of the JSON file to save results in the key-value store. Default: output.json",
                        "default": "output.json"
                    },
                    "metadata": {
                        "title": "Include Metadata",
                        "enum": [
                            "true",
                            "false"
                        ],
                        "type": "string",
                        "description": "Include full metadata from yt-dlp in output (true/false). Default: false",
                        "default": "false"
                    },
                    "onlyWithTranscription": {
                        "title": "Only With Transcription (Search mode)",
                        "enum": [
                            "true",
                            "false"
                        ],
                        "type": "string",
                        "description": "In search mode, filter to only videos with transcriptions (true/false). Default: true. Ignored for direct URLs.",
                        "default": "true"
                    },
                    "dateRange": {
                        "title": "Date Range (Search mode)",
                        "enum": [
                            "",
                            "last_daily",
                            "last_week",
                            "last_month",
                            "last_year"
                        ],
                        "type": "string",
                        "description": "In search mode, filter results by publication date. Options: last_daily, last_week, last_month, last_year. Leave empty for no filter.",
                        "default": ""
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
