# Tiktok Contact Extractor (`solid-scraper/tiktok-contact-extractor`) Actor

📲 Unlock leads with Tiktok Contact Extractor! Extract emails, phone numbers & profiles from TikTok fast and accurately. Perfect for marketers, agencies & sales teams to build targeted lists and boost outreach 🚀✨ Try it now!

- **URL**: https://apify.com/solid-scraper/tiktok-contact-extractor.md
- **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community)
- **Categories:** Lead generation, Social media, Automation
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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

### Tiktok Contact Extractor 📬

**Tiktok Contact Extractor** is a professional TikTok contact scraper designed to help you build lead lists by extracting **emails** and related profile contact signals from publicly available sources. Whether you’re a marketer, recruiter, or data analyst, this **TikTok email extractor** streamlines “tiktok contact extractor” workflows—especially when you need a **TikTok phone number extractor–style contact list builder** (using email-first contact data) without spending hours on manual research. It’s optimized for B2B and B2C lead generation so you can scale contact discovery faster than traditional manual methods.

---

### Why choose Tiktok Contact Extractor?

| Feature | Benefit |
|---|---|
| ✅ **All-in-one contact extraction** | Extract emails and profile/contact-related fields in a single run for your keywords |
| ✅ **Source region targeting** | Use **Source Region** (`All`, `Profile`, `Videos`) to focus results by content type |
| ✅ **Engine modes (reliability vs cost control)** | Choose between `legacy` and `cost-effective` scraping engines depending on your run goals |
| ✅ **Email limits for predictable output** | Control volume with **Max Emails** (up to 10,000) for cost and quality management |
| ✅ **Structured dataset output** | Save results into a dataset with consistent fields for easy filtering/export |
| ✅ **Designed for lead generation workflows** | Supports B2C vs B2B email extraction via **Email Type** to fit your outreach strategy |

---

### Key features

- 🔍 **TikTok email extractor for lead generation**: Collects email contacts tied to TikTok profile-related pages and results.
- 🌐 **TikTok profile info extraction support**: Stores profile-level context such as `title`, `url`, and `description` alongside the email.
- 🧩 **Keyword-driven discovery**: Use **Search Terms** (a list) to find relevant TikTok profile results in your preferred categories.
- 🗺️ **Source region selector**: Choose `All`, `Profile`, or `Videos` to guide which TikTok URL types the run targets.
- 🛡️ **Reliability-focused engine choice**: Switch between `legacy` and `cost-effective` modes depending on your priorities (reliability vs speed/cost).
- 💾 **Real dataset tables**: Output is saved to the **TikTok Email Data** dataset and viewable as a table (e.g., email, domain, source).
- ⏱️ **Email volume control**: Use **Max Emails** to cap collection so runs stay aligned with your budget and downstream processing.
- 🧠 **Email-type filtering (B2C vs B2B)**: Set **Email Type** to tailor extraction toward consumer or business-style contacts (as selected).

---

### Input

Provide input via an `input.json` file. Example structure:

```json
{
  "searchTerms": ["fitness", "gym", "workout"],
  "country": "United States",
  "sourceRegion": "All",
  "emailType": "B2C",
  "maxEmails": 50
}
````

#### Input Fields

| Key | Required | Description |
|---|---:|---|
| `country` | ✅ | Select the target country for regional targeting (used to guide which results are considered). |
| `emailType` | ✅ | Choose one contact focus: `B2C` for consumer-style emails or `B2B` for business-style emails. |
| `engine` | ❌ | Choose the scraping engine mode: `cost-effective` (Cost Effective (New)) or `legacy` (Legacy). |
| `maxEmails` | ✅ | Enter the maximum number of emails to collect (min 1, max 10,000). |
| `searchTerms` | ✅ | A list of keywords/queries used to find relevant TikTok profiles for extraction. |
| `sourceRegion` | ✅ | Select the regional index to target as `All`, `Profile`, or `Videos`. |

***

### Output

The actor saves the scraped results into the **TikTok Email Data** dataset in JSON format, with a consistent set of fields per record.

```json
[
  {
    "keyword": "fitness",
    "title": "Example TikTok profile title",
    "url": "https://www.tiktok.com/@example",
    "description": "Example profile description snippet",
    "email": "contact@example.com",
    "email_domain": "example.com",
    "email_type": "B2C",
    "scrape_from": "Profile",
    "country": "United States"
  }
]
```

#### Output Fields

| Field | Type | Description |
|---|---|---|
| `keyword` | string | The keyword from your **Search Terms** that led to this record. |
| `title` | string | The scraped result title associated with the contact/profile. |
| `url` | string | The TikTok-related URL for the profile/page that was used. |
| `description` | string | The scraped text snippet/description related to the result. |
| `email` | string | The extracted email address (when found). |
| `email_domain` | string | The domain part of the email address (e.g., `example.com`). |
| `email_type` | string | The email classification based on your **Email Type** selection (`B2C` or `B2B`). |
| `scrape_from` | string | Indicates where the record was scraped from (based on the selected `sourceRegion`). |
| `country` | string | The selected country used for targeting (`country`). |
| `error_message` | string | If an error occurs for a record/run, an error message may appear (field coverage depends on execution outcomes). |

You can export the dataset from Apify Console to formats such as **JSON/CSV** for downstream analysis and CRM imports.

***

### How to use Tiktok Contact Extractor (via Apify Console)

1. **Open Apify Console**: Start in [console.apify.com](https://console.apify.com) and sign in.
2. **Find the actor**: Search for **Tiktok Contact Extractor** in the Actors marketplace and open its page.
3. **Go to the INPUT panel**: Paste your settings using the built-in form (or upload an `input.json`).
4. **Set your extraction focus**:
   In the form, enter your **Search Terms** (array), choose **Source Region** (`All`, `Profile`, `Videos`), and set **Email Type** (`B2C` or `B2B`).
5. **Control volume**: Set **Max Emails** to the number of emails you want to collect (up to 10,000).
6. **(Optional) Choose an engine**: If you have `cost-effective` or `legacy` needs, set `engine` accordingly. If you leave it as default, it will run with the actor’s default engine selection.
7. **Run the actor**: Click **Run** and monitor logs for progress, retries, and any resilience behavior during scraping.
8. **Open the dataset and export**: After completion, open the **TikTok Email Data** dataset and export the results (JSON/CSV) for your TikTok lead generation tool workflow.

No coding required—get accurate TikTok contact data in minutes with **Tiktok Contact Extractor**.

***

### Advanced features & SEO optimization

- ⚙️ **Keyword-led discovery for TikTok contact list builder use cases**: Engineered to excel at “tiktok profile email scraper” style workflows—especially when you need consistent records across multiple keywords.
- 🔄 **Engine choice for different run priorities**: Use `legacy` or `cost-effective` depending on whether you want maximum reliability behavior or a more cost-effective approach.
- 📌 **Input flexibility for targeted TikTok influencer contact finder workflows**: Combine **Search Terms** with **Source Region** to tailor your extraction scope.
- 🧾 **Structured fields for fast downstream analysis**: Output includes `email_domain`, `email_type`, and `scrape_from`, which makes it easier to clean and segment your TikTok email extractor results.

***

### Best use cases

- 📈 **Growth marketers building outreach lists**: Use Tiktok Contact Extractor to quickly assemble a TikTok contact list builder dataset for email outreach campaigns.
- 🎯 **B2B teams doing influencer outreach**: Extract TikTok user contact signals (email-first) with `emailType: B2B` to prioritize business-style contacts.
- 🛠️ **Recruiters researching candidate or creator profiles**: Run with focused **Search Terms** and `sourceRegion: Profile` to gather contact details for follow-up.
- 🧪 **Data analysts validating contact-enrichment pipelines**: Ingest structured output fields like `email_domain` and `country` for segmentation and reporting.
- 🏷️ **Community managers identifying collaboration leads**: Use **Source Region** and keyword filters to support a TikTok influencer contact finder workflow.
- 💼 **Sales development teams scaling prospecting**: Build TikTok email contact lists at volume while enforcing **Max Emails** limits.
- 🔁 **Researchers comparing niches across regions**: Target different **country** values to study contact distribution by region (while keeping the same keyword sets).

***

### Technical specifications

- **Supported Input Formats**
  - ✅ `input.json` structured object with `searchTerms`, `country`, `sourceRegion`, `emailType`, `maxEmails` (and optional `engine`)
  - ✅ `searchTerms` is an array of strings

- **Proxy Support**
  - ✅ Built-in proxy support for reliable scraping
  - ✅ Engine selection provides different reliability/cost behaviors (`engine`: `legacy` or `cost-effective`)

- **Retry Mechanism**
  - ✅ Includes retries and fallbacks for resilience during scraping

- **Dataset Structure**
  - ✅ Dataset title: **TikTok Email Data**
  - ✅ Default view: **Scraped Emails** (table fields include `keyword`, `title`, `url`, `description`, `email`, `email_domain`, `email_type`, `scrape_from`, `country`)

- **Rate Limits & Performance**
  - ✅ Designed for controlled extraction with concurrency controls and email volume limits via **Max Emails**

- **Limitations**
  - ❌ Records may be limited when emails are not publicly available
  - ❌ Results depend on publicly available source content and your selected filters (`emailType`, `sourceRegion`, `country`, keywords)

***

### FAQ

#### Does Tiktok Contact Extractor work for TikTok email extractor use cases only?

✅ Yes—this actor is built around extracting email contacts plus related profile context. If you’re specifically after “TikTok phone number extractor” results, you’ll want to treat this as an **email-first TikTok contact extractor**.

#### What should I set for Email Type: B2C or B2B?

✅ Use `B2C` when you want consumer-style email contacts and `B2B` when you want business-style email contacts. Your choice is reflected in the output field `email_type`.

#### Can I control how many emails are collected?

✅ Yes. Use `maxEmails` to set an upper limit for the run. The actor is designed to stop once the limit is reached.

#### What does Source Region change?

✅ `sourceRegion` controls where the actor focuses its extraction scope: `All`, `Profile`, or `Videos`. This selection is also captured in the dataset via the `scrape_from` field.

#### Is there an option to adjust scraping reliability vs cost?

✅ Yes. Set the optional `engine` input to either `legacy` or `cost-effective` depending on your preference.

#### Where do the results go after the run?

✅ The actor saves results into the **TikTok Email Data** dataset. The default dataset view is a table showing fields like `email`, `email_domain`, and `country`.

#### Can I use the output in my CRM or spreadsheet workflow?

✅ Yes. The dataset can be exported for downstream workflows, and the output fields are designed to be easy to filter and join (e.g., by `email_domain`, `keyword`, `country`).

#### Do I need to write code to use it?

✅ No. You can run it directly from Apify Console using the provided input fields. If you’re building via API, the actor still accepts the same `input.json` structure.

***

### Support & feature requests

Want improvements to your **Tiktok Contact Extractor** workflow? Tell us what you need—feedback directly shapes the roadmap.

- 💡 **Feature Requests**: For example, improvements like additional export options, enhanced filtering controls, or better dataset segmentation for TikTok email extractor pipelines.
- 📧 **Contact**: Reach out at <dataforleads@gmail.com>.

***

### *Tiktok Contact Extractor* — Final thoughts

*If you’re looking for a fast, structured **TikTok contact extractor** to power scalable lead generation, this is built to help you extract what you need from publicly available sources efficiently and consistently.*

# Actor input Schema

## `country` (type: `string`):

Specify the country to target for Google search results.

## `emailType` (type: `string`):

Choose one — B2C or B2B.

## `engine` (type: `string`):

Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE\_SERP proxy with traditional selectors - more reliable but slower and more expensive.

## `maxEmails` (type: `integer`):

Enter the maximum number of emails to collect.

## `searchTerms` (type: `array`):

List of queries to find Tiktok profiles.

## `sourceRegion` (type: `string`):

Select the regional index to target.

## Actor input object example

```json
{
  "country": "United States",
  "emailType": "B2C",
  "engine": "legacy",
  "maxEmails": 20,
  "searchTerms": [
    "fitness",
    "gym",
    "workout"
  ],
  "sourceRegion": "All"
}
```

# 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 = {
    "searchTerms": [
        "fitness",
        "gym",
        "workout"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("solid-scraper/tiktok-contact-extractor").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 = { "searchTerms": [
        "fitness",
        "gym",
        "workout",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("solid-scraper/tiktok-contact-extractor").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 '{
  "searchTerms": [
    "fitness",
    "gym",
    "workout"
  ]
}' |
apify call solid-scraper/tiktok-contact-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=solid-scraper/tiktok-contact-extractor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Tiktok Contact Extractor",
        "description": "📲 Unlock leads with Tiktok Contact Extractor! Extract emails, phone numbers & profiles from TikTok fast and accurately. Perfect for marketers, agencies & sales teams to build targeted lists and boost outreach 🚀✨ Try it now!",
        "version": "1.0",
        "x-build-id": "QWyJwngiO2xxHW82S"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solid-scraper~tiktok-contact-extractor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solid-scraper-tiktok-contact-extractor",
                "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/solid-scraper~tiktok-contact-extractor/runs": {
            "post": {
                "operationId": "runs-sync-solid-scraper-tiktok-contact-extractor",
                "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/solid-scraper~tiktok-contact-extractor/run-sync": {
            "post": {
                "operationId": "run-sync-solid-scraper-tiktok-contact-extractor",
                "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": [
                    "searchTerms",
                    "country",
                    "sourceRegion",
                    "emailType",
                    "maxEmails"
                ],
                "properties": {
                    "country": {
                        "title": "Country",
                        "enum": [
                            "United States",
                            "United Kingdom",
                            "Canada",
                            "Australia",
                            "Germany",
                            "France",
                            "India",
                            "Japan",
                            "Brazil",
                            "Italy",
                            "Spain",
                            "Netherlands",
                            "Sweden",
                            "Norway",
                            "Denmark",
                            "Finland",
                            "Poland",
                            "Czech Republic",
                            "Hungary",
                            "Romania",
                            "Bulgaria",
                            "Croatia",
                            "Slovenia",
                            "Slovakia",
                            "Estonia",
                            "Latvia",
                            "Lithuania",
                            "Portugal",
                            "Greece",
                            "Cyprus",
                            "Malta",
                            "Luxembourg",
                            "Ireland",
                            "Belgium",
                            "Austria",
                            "Switzerland",
                            "Liechtenstein",
                            "Iceland",
                            "South Korea",
                            "China",
                            "Mexico",
                            "Argentina",
                            "Chile",
                            "Colombia",
                            "Peru",
                            "Venezuela",
                            "Ecuador",
                            "Uruguay",
                            "Paraguay",
                            "Bolivia",
                            "Guyana",
                            "Suriname",
                            "French Guiana",
                            "Falkland Islands (Malvinas)",
                            "South Georgia and the South Sandwich Islands",
                            "Bonaire, Sint Eustatius and Saba",
                            "Curaçao",
                            "Aruba",
                            "Sint Maarten (Dutch part)",
                            "Turks and Caicos Islands",
                            "British Virgin Islands",
                            "Anguilla",
                            "Montserrat",
                            "Antigua and Barbuda",
                            "Barbados",
                            "Dominica",
                            "Grenada",
                            "Saint Kitts and Nevis",
                            "Saint Lucia",
                            "Saint Vincent and the Grenadines",
                            "Trinidad and Tobago",
                            "Jamaica",
                            "Bahamas",
                            "Belize",
                            "Costa Rica",
                            "Guatemala",
                            "Honduras",
                            "Nicaragua",
                            "Panama",
                            "El Salvador",
                            "Cuba",
                            "Dominican Republic",
                            "Haiti",
                            "Puerto Rico",
                            "U.S. Virgin Islands",
                            "American Samoa",
                            "Guam",
                            "Northern Mariana Islands",
                            "Saudi Arabia",
                            "United Arab Emirates",
                            "Bahrain",
                            "Iraq",
                            "Iran, Islamic Republic of",
                            "Israel",
                            "Jordan",
                            "Kuwait",
                            "Lebanon",
                            "Oman",
                            "Qatar",
                            "Syrian Arab Republic",
                            "Yemen",
                            "Afghanistan",
                            "Bangladesh",
                            "Bhutan",
                            "Maldives",
                            "Nepal",
                            "Pakistan",
                            "Sri Lanka",
                            "Myanmar",
                            "Cambodia",
                            "Lao People's Democratic Republic",
                            "Thailand",
                            "Viet Nam",
                            "Malaysia",
                            "Singapore",
                            "Brunei Darussalam",
                            "Philippines",
                            "Indonesia",
                            "Timor-Leste",
                            "Papua New Guinea",
                            "Fiji",
                            "New Zealand",
                            "Solomon Islands",
                            "Vanuatu",
                            "New Caledonia",
                            "French Polynesia",
                            "Wallis and Futuna",
                            "Samoa",
                            "Tonga",
                            "Tuvalu",
                            "Kiribati",
                            "Nauru",
                            "Federated States of Micronesia",
                            "Marshall Islands",
                            "Palau",
                            "Cook Islands",
                            "Niue",
                            "Tokelau"
                        ],
                        "type": "string",
                        "description": "Specify the country to target for Google search results.",
                        "default": "United States"
                    },
                    "emailType": {
                        "title": "Email Type",
                        "enum": [
                            "B2C",
                            "B2B"
                        ],
                        "type": "string",
                        "description": "Choose one — B2C or B2B.",
                        "default": "B2C"
                    },
                    "engine": {
                        "title": "Engine",
                        "enum": [
                            "cost-effective",
                            "legacy"
                        ],
                        "type": "string",
                        "description": "Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE_SERP proxy with traditional selectors - more reliable but slower and more expensive.",
                        "default": "legacy"
                    },
                    "maxEmails": {
                        "title": "Max Emails",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Enter the maximum number of emails to collect.",
                        "default": 20
                    },
                    "searchTerms": {
                        "title": "Search Terms",
                        "type": "array",
                        "description": "List of queries to find Tiktok profiles.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "sourceRegion": {
                        "title": "Source Region",
                        "enum": [
                            "All",
                            "Profile",
                            "Videos"
                        ],
                        "type": "string",
                        "description": "Select the regional index to target.",
                        "default": "All"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
