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

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# 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