Skip to main content

​
How to set up Bright Data

​
Authentication

Bright Data uses API token authentication:
  1. Sign up at brightdata.com
  2. Copy your API token from your account settings at 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.
Code slugs — integration slug: brightData. Actions: scrapeInstagramProfile, scrapeTikTokProfile, scrapeFacebookPagePosts, scrapeFacebookProfile, scrapeTwitterProfile, scrapeYouTubeChannel. Call them as integrations.brightData.<action>(...).
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