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

# Bright Data

> Connect Bright Data to scrape social media profiles and posts in your workflows.

## How to set up Bright Data

### Authentication

Bright Data uses API token authentication:

1. Sign up at [brightdata.com](https://brightdata.com)
2. Copy your API token from your account settings at [brightdata.com/cp/setting/users](https://brightdata.com/cp/setting/users)
3. Paste the API token in Cargo when connecting

Bright Data is also compatible with Cargo credits: if you don't connect your own account, actions run on Cargo's managed Bright Data access and are billed in Cargo credits.

<Note>
  **Code slugs** — integration slug: `brightData`. Actions: `scrapeInstagramProfile`, `scrapeTikTokProfile`, `scrapeFacebookPagePosts`, `scrapeFacebookProfile`, `scrapeTwitterProfile`, `scrapeYouTubeChannel`. Call them as `integrations.brightData.<action>(...)`.
</Note>

Cargo spreads requests at up to 100 calls per minute. Scrapes run asynchronously: Cargo polls the Bright Data snapshot until it completes.

## Bright Data actions

Every action takes a single required field and costs 0.1 Cargo credits per request when running on Cargo credits.

### Scrape Instagram profile

Scrape Instagram profile data by URL including follower count, posts, bio, and engagement metrics.

**Required fields:**

* **URL**: The URL of the Instagram profile to scrape

**Use case:** Qualify creators or brands by audience size and engagement before outreach.

### Scrape TikTok profile

Scrape TikTok profile data by URL including follower count, likes, videos, and engagement metrics.

**Required fields:**

* **URL**: The URL of the TikTok profile to scrape

**Use case:** Vet TikTok creators for influencer campaigns.

### Scrape Facebook page posts

Scrape Facebook page posts by URL including content, engagement metrics, and attachments.

**Required fields:**

* **URL**: The URL of the Facebook page to scrape posts from

**Use case:** Monitor a company's Facebook activity as a buying or engagement signal.

### Scrape Facebook profile

Scrape Facebook page or profile data by URL including name, followers, contact info, and business details.

**Required fields:**

* **URL**: The URL of the Facebook page or profile to scrape

**Use case:** Enrich local businesses with contact details (emails, websites, address) from their Facebook page.

### Scrape X (Twitter) profile

Scrape X (Twitter) profile data by URL including follower count, posts, bio, and engagement metrics.

**Required fields:**

* **URL**: The URL of the X (Twitter) profile to scrape

**Use case:** Score prospects by social reach and recent posting activity.

### Scrape YouTube channel

Scrape YouTube channel data by URL including subscriber count, videos, views, and top videos.

**Required fields:**

* **URL**: The URL of the YouTube channel to scrape

**Use case:** Identify high-reach channels for sponsorship or partnership outreach.

## Best practices

* Pass full profile/page URLs — each action targets one specific platform's dataset
* Scrapes can take a while to complete; runs stay in an executing state while Bright Data prepares the snapshot
* Results are cacheable in Cargo — avoid re-scraping the same URL in tight loops
* Use your own API token if you already have a Bright Data account; otherwise run on Cargo credits