# Python SDK
Source: https://docs.brightdata.com/api-reference/SDK

Install the Bright Data Python SDK (thousands of scrapers) to scrape URLs, search the web, run platform scrapers and connect Playwright to the Browser API.

This guide shows how to install the Bright Data Python SDK and call every feature it exposes: URL scraping, search engines, platform-specific scrapers (LinkedIn, Amazon, Instagram, TikTok, YouTube, Reddit, Pinterest, ChatGPT, Perplexity, Digikey), Scraper Studio, datasets, and the Browser API.

<img alt="Bright Data Python SDK banner" />

## Installation and setup

Install the package via pip:

```bash theme={null}
pip install brightdata-sdk
```

### Configuration

You must provide your API key. You can find it in your [Bright Data Control Panel](https://brightdata.com/cp/api_keys).

**Option 1: Environment variable (recommended)**

```bash theme={null}
export BRIGHTDATA_API_KEY="YOUR_API_KEY"
```

<Note>
  The Python SDK looks for your API key in this order: the `token` argument, `BRIGHTDATA_API_TOKEN`, `BRIGHTDATA_API_KEY`, then the key stored by `brightdata login`. `BRIGHTDATA_API_KEY` is the variable the [Bright Data CLI](/products/cli/installation) reads, so one export covers both. If both variables are set, `BRIGHTDATA_API_TOKEN` wins. Versions before 2.5.0 read only `BRIGHTDATA_API_TOKEN`; upgrade with `pip install -U brightdata-sdk` or export that variable instead.
</Note>

**Option 2: Direct initialization**

```python theme={null}
# Async client
from brightdata import BrightDataClient

async with BrightDataClient(token="YOUR_API_KEY") as client:
    ...

# Sync client
from brightdata import SyncBrightDataClient

with SyncBrightDataClient(token="YOUR_API_KEY") as client:
    ...
```

## Basic usage

Use `SyncBrightDataClient` for simple scripts. Use `BrightDataClient` with asyncio for high-concurrency workloads.

<CodeGroup>
  ```python Synchronous theme={null}
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      # Scrape a URL
      data = client.scrape_url("https://example.com")
      print(f"Result: {data.data}")

      # Search Google
      search = client.search.google(query="Bright Data")
      print(f"Found: {len(search.data)}")
  ```

  ```python Asynchronous theme={null}
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient() as client:
          result = await client.scrape_url("https://example.com")
          print(result.data)

          search = await client.search.google(query="Bright Data")
          print(f"Found: {len(search.data)}")

  if __name__ == "__main__":
      asyncio.run(main())
  ```
</CodeGroup>

## Launch scrapes and web searches

<CodeGroup>
  ```python Search Engines theme={null}
  from brightdata import BrightDataClient

  client = BrightDataClient()

  # Google search
  results = client.search.google(
      query="best shoes of 2025",
      location="United States",
      language="en",
      num_results=20
  )

  # Bing search
  results = client.search.bing(
      query="python tutorial",
      location="United States"
  )

  # Yandex search
  results = client.search.yandex(
      query="latest news",
      location="Germany"
  )

  if results.success:
      print(f"Cost: ${results.cost:.4f}")
      print(f"Time: {results.elapsed_ms():.2f}ms")
  ```

  ```python Web Scraping theme={null}
  from brightdata import BrightDataClient

  client = BrightDataClient()

  # Scrape single URL
  result = client.scrape_url("https://example.com")

  # Scrape multiple URLs concurrently
  urls = [
      "https://example1.com",
      "https://example2.com",
      "https://example3.com"
  ]
  results = client.scrape_url(urls)

  for r in results:
      if r.success:
          print(f"Success: {r.data[:200]}...")
          r.save_to_file(f"result_{hash(r.data)}.json")
  ```
</CodeGroup>

<Check>
  When working with multiple queries or URLs, requests are handled concurrently for optimal performance.
</Check>

## Use platform-specific scrapers for structured data

Extract structured data from Amazon, LinkedIn, Facebook, Instagram, TikTok, YouTube, Reddit, Pinterest, ChatGPT, Perplexity, and Digikey.

<CodeGroup>
  ```python Amazon theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          products = await client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
          reviews = await client.scrape.amazon.reviews(
              url="https://amazon.com/dp/B0CRMZHDG8",
              pastDays=30,
              keyWord="quality"
          )
          sellers = await client.scrape.amazon.sellers(
              url="https://amazon.com/sp?seller=AXXXXXXXXXXX"
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      products = client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
      reviews = client.scrape.amazon.reviews(
          url="https://amazon.com/dp/B0CRMZHDG8",
          pastDays=30,
          keyWord="quality"
      )
      sellers = client.scrape.amazon.sellers(
          url="https://amazon.com/sp?seller=AXXXXXXXXXXX"
      )
  ```

  ```python LinkedIn theme={null}
  # Async: collect by URL, then discover by parameters
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          profiles = await client.scrape.linkedin.profiles(
              url="https://www.linkedin.com/in/johndoe"
          )
          companies = await client.scrape.linkedin.companies(
              url="https://www.linkedin.com/company/bright-data"
          )
          jobs = await client.scrape.linkedin.jobs(
              url="https://www.linkedin.com/jobs/view/123456"
          )
          posts = await client.scrape.linkedin.posts(
              url="https://www.linkedin.com/feed/update/urn:li:activity:123"
          )

          # Discover by parameters
          job_results = await client.search.linkedin.jobs(
              keyword="python developer",
              location="New York",
              remote=True
          )
          profile_results = await client.search.linkedin.profiles(
              first_name="John",
              last_name="Doe"
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      profiles = client.scrape.linkedin.profiles(url="https://www.linkedin.com/in/johndoe")
      companies = client.scrape.linkedin.companies(
          url="https://www.linkedin.com/company/bright-data"
      )
      jobs = client.scrape.linkedin.jobs(url="https://www.linkedin.com/jobs/view/123456")
      posts = client.scrape.linkedin.posts(
          url="https://www.linkedin.com/feed/update/urn:li:activity:123"
      )
  ```

  ```python Facebook & Instagram theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          await client.scrape.facebook.posts_by_profile(
              url="https://www.facebook.com/nasa", num_of_posts=10
          )
          await client.scrape.facebook.posts_by_group(
              url="https://www.facebook.com/groups/example"
          )
          await client.scrape.facebook.posts_by_url(
              url="https://www.facebook.com/post/123456"
          )
          await client.scrape.facebook.comments(
              url="https://www.facebook.com/post/123456", num_of_comments=100
          )
          await client.scrape.facebook.reels(url="https://www.facebook.com/nasa")

          await client.scrape.instagram.profiles(url="https://www.instagram.com/nasa/")
          await client.scrape.instagram.posts(url="https://www.instagram.com/p/Cuf4s0MNqNr")
          await client.scrape.instagram.reels(
              url="https://www.instagram.com/reel/C5Rdyj_q7YN/"
          )
          await client.scrape.instagram.comments(
              url="https://www.instagram.com/p/CesFC7JLyFl/"
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      client.scrape.facebook.posts_by_profile(
          url="https://www.facebook.com/nasa", num_of_posts=10
      )
      client.scrape.instagram.profiles(url="https://www.instagram.com/nasa/")
  ```

  ```python TikTok theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          profiles = await client.scrape.tiktok.profiles(
              url="https://www.tiktok.com/@username"
          )
          posts = await client.scrape.tiktok.posts(
              url="https://www.tiktok.com/@user/video/7433494424040017194"
          )
          comments = await client.scrape.tiktok.comments(
              url="https://www.tiktok.com/@user/video/7216019547806092550"
          )
          fast_posts = await client.scrape.tiktok.posts_by_profile_fast(
              url="https://www.tiktok.com/@bbc"
          )
          search = await client.scrape.tiktok.posts_by_search_url_fast(
              url="https://www.tiktok.com/search?q=cats", num_of_posts=10
          )


  asyncio.run(main())
  ```

  ```python YouTube theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          videos = await client.scrape.youtube.videos(
              url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
              transcription_language="English"
          )
          channels = await client.scrape.youtube.channels(
              url="https://www.youtube.com/@MrBeast/about"
          )
          comments = await client.scrape.youtube.comments(
              url="https://www.youtube.com/watch?v=dQw4w9WgXcQ", num_of_comments=100
          )


  asyncio.run(main())
  ```

  ```python Reddit theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          posts = await client.scrape.reddit.posts(
              url="https://www.reddit.com/r/python/comments/abc123/"
          )
          by_keyword = await client.scrape.reddit.posts_by_keyword(
              keyword="machine learning", sort_by="Top", date="Past week"
          )
          by_subreddit = await client.scrape.reddit.posts_by_subreddit(
              url="https://www.reddit.com/r/datascience/"
          )
          comments = await client.scrape.reddit.comments(
              url="https://www.reddit.com/r/python/comments/abc123/", days_back=30
          )


  asyncio.run(main())
  ```

  ```python Pinterest theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          posts = await client.scrape.pinterest.posts(
              url="https://www.pinterest.com/pin/3166662230556591/"
          )
          profiles = await client.scrape.pinterest.profiles(
              url="https://www.pinterest.com/boredpanda/"
          )

          # Discover by parameters
          by_keyword = await client.search.pinterest.posts_by_keyword(
              keyword="spaghetti recipes"
          )
          by_profile = await client.search.pinterest.posts_by_profile(
              url="https://www.pinterest.com/grandmapowpow/", num_of_posts=20
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      posts = client.scrape.pinterest.posts(
          url="https://www.pinterest.com/pin/3166662230556591/"
      )
      profiles = client.scrape.pinterest.profiles(
          url="https://www.pinterest.com/boredpanda/"
      )
  ```

  ```python ChatGPT theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          result = await client.scrape.chatgpt.prompt(
              "Explain async programming", web_search=True
          )
          batch = await client.scrape.chatgpt.prompts(
              prompts=["Explain Python", "Explain JavaScript"]
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      result = client.scrape.chatgpt.prompt(
          "Explain async programming", web_search=True
      )
      batch = client.scrape.chatgpt.prompts(
          prompts=["Explain Python", "Explain JavaScript"]
      )
  ```

  ```python Digikey & Perplexity theme={null}
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          parts = await client.scrape.digikey.products(
              url="https://www.digikey.com/en/products/detail/abc"
          )
          answer = await client.scrape.perplexity.search(
              prompt="What is new in battery technology?"
          )


  asyncio.run(main())
  ```
</CodeGroup>

## Run your custom Scraper Studio scrapers

```python theme={null}
# Async
from brightdata import BrightDataClient

async with BrightDataClient() as client:
    data = await client.scraper_studio.run(
        collector="c_abc123",
        input={"url": "https://example.com/product/1"}
    )
    job = await client.scraper_studio.trigger(
        "c_abc123", {"url": "https://example.com/product/1"}
    )
    data = await job.wait_and_fetch(timeout=120)
    status = await client.scraper_studio.status("j_abc123")

# Sync
from brightdata import SyncBrightDataClient

with SyncBrightDataClient() as client:
    data = client.scraper_studio.run(
        collector="c_abc123",
        input={"url": "https://example.com/product/1"}
    )
    status = client.scraper_studio.status("j_abc123")
```

## Datasets API

Access pre-collected data snapshots.

```python theme={null}
from brightdata import SyncBrightDataClient

with SyncBrightDataClient() as client:
    # 1. Request snapshot with filters
    print("Requesting snapshot...")
    snapshot_id = client.datasets.imdb_movies(
        filter={"name": "year", "operator": "=", "value": 2024},
        records_limit=10
    )

    # 2. Download (SDK polls automatically)
    print(f"Snapshot {snapshot_id} ready. Downloading...")
    data = client.datasets.imdb_movies.download(snapshot_id)
    print(f"Downloaded {len(data)} records.")
```

<Tip>
  In your IDE, hover over the `BrightDataClient` class or **any of its methods** to view available parameters, type hints, and usage examples. The SDK provides full IntelliSense support.
</Tip>

## Use dataclass payloads for type safety

The SDK includes dataclass payloads with runtime validation and helper properties.

```python theme={null}
from brightdata import BrightDataClient
from brightdata.payloads import (
    AmazonProductPayload,
    LinkedInJobSearchPayload,
    ChatGPTPromptPayload
)

client = BrightDataClient()

# Amazon product with validation
amazon_payload = AmazonProductPayload(
    url="https://amazon.com/dp/B123456789",
    reviews_count=50  # Runtime validated.
)
print(f"ASIN: {amazon_payload.asin}")  # Helper property
print(f"Domain: {amazon_payload.domain}")

# LinkedIn job search
linkedin_payload = LinkedInJobSearchPayload(
    keyword="python developer",
    location="San Francisco",
    remote=True
)
print(f"Remote search: {linkedin_payload.is_remote_search}")

# Use with client
result = client.scrape.amazon.products(**amazon_payload.to_dict())
```

## Connect to scraping browser

Connect Playwright to Bright Data's cloud browser via the Browser API.

```python theme={null}
from brightdata import BrightDataClient
from playwright.async_api import async_playwright

client = BrightDataClient(
    browser_username="brd-customer-xxxx-zone-scraping_browser1",
    browser_password="YOUR_ZONE_PASSWORD",
)

async with async_playwright() as pw:
    browser = await pw.chromium.connect_over_cdp(client.browser.get_connect_url())
    page = await browser.new_page()
    await page.goto("https://example.com", timeout=120000)
    print(await page.content())
    await browser.close()
```

## Use the CLI tool

The SDK includes a command-line interface for terminal usage.

```bash theme={null}
# Search operations
brightdata search google "python tutorial" --location "United States"
brightdata search linkedin jobs --keyword "python developer" --remote

# Scrape operations
brightdata scrape amazon products "https://amazon.com/dp/B123"
brightdata scrape linkedin profiles "https://linkedin.com/in/johndoe"

# Generic web scraping
brightdata scrape generic "https://example.com" --output-format pretty

# Save results to file
brightdata search google "AI news" --output-file results.json
```

## Async usage for better performance

For concurrent operations, pass a list of URLs to `scrape_url` and run inside an async context manager.

```python theme={null}
import asyncio
from brightdata import BrightDataClient

async def main():
    async with BrightDataClient() as client:
        results = await client.scrape_url([
            "https://example1.com",
            "https://example2.com",
            "https://example3.com",
        ], mode="async", poll_timeout=180)

        for result in results:
            print(result.data)

asyncio.run(main())
```

## Resources

<CardGroup>
  <Card title="GitHub repository" icon="github" href="https://github.com/brightdata/sdk-python">
    View source code, examples, and contribute
  </Card>

  <Card title="Examples directory" icon="code" href="https://github.com/brightdata/sdk-python/tree/main/examples">
    10+ working examples for all features
  </Card>

  <Card title="PyPI page" icon="box" href="https://pypi.org/project/brightdata-sdk/">
    Package listing and release history
  </Card>
</CardGroup>

## What's new

| Feature | Description |
| - | - |
| **Scraper Studio** | `client.scraper_studio.run/trigger/status()`. Trigger and fetch your custom Scraper Studio scrapers. Available on both sync and async clients. |
| **Browser API** | `client.browser.get_connect_url()`. Connect Playwright/Puppeteer to Bright Data's cloud browser. Replaces `client.connect_browser()`. |
| **New scrapers** | TikTok, YouTube, Reddit, Pinterest, Digikey, Perplexity added to `client.scrape.*` |
| **Platform search** | `client.search.linkedin` / `amazon` / `instagram` / `tiktok` / `youtube` / `pinterest` / `chatgpt`. Discover content by parameters, not just URLs. |
| **126+ Datasets** | Full catalog via `client.datasets.*` with `.sample()` and `.download()` |
| **Full sync parity** | `SyncBrightDataClient` now covers all features: scrapers, search, discover, scraper studio, browser |


# JavaScript SDK
Source: https://docs.brightdata.com/api-reference/SDK-JS

Install and use the Bright Data JavaScript SDK (thousands of scrapers) to scrape URLs, search Google/Bing/Yandex and connect to the Browser API from Node.js.

This guide shows how to install the Bright Data JavaScript SDK, scrape URLs, run searches, call platform-specific scrapers (LinkedIn, Amazon, Instagram, and more), and connect to the Browser API and Scraper Studio from Node.js.

## Install the package

Open the terminal and run:

```bash theme={null}
npm install @brightdata/sdk
```

In your code file, import the package and launch your first requests:

```javascript theme={null}
import { bdclient } from '@brightdata/sdk';

const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

const html = await client.scrapeUrl('https://example.com');
const google = await client.search.google('pizza restaurants');

console.log(google);
await client.close();
```

## Launch scrapes and web searches

<CodeGroup>
  ```javascript search(...) theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  const google = await client.search.google('best laptops 2026');
  const bing = await client.search.bing('python tutorial');
  const yandex = await client.search.yandex('AI news');

  console.log({ google, bing, yandex });
  await client.close();
  ```

  ```javascript scrape(...) theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  const html = await client.scrapeUrl('https://example.com');
  const md = await client.scrapeUrl('https://example.com', {
      dataFormat: 'markdown',
      country: 'us',
  });

  console.log({ html, md });
  await client.close();
  ```
</CodeGroup>

## Platform scrapers and datasets

Collect data from popular platforms by URL, or discover content by parameters.

<CodeGroup>
  ```javascript LinkedIn theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  // Collect by URL
  const profiles = await client.scrape.linkedin.collectProfiles([
      'https://www.linkedin.com/in/satyanadella/',
  ]);
  const companies = await client.scrape.linkedin.collectCompanies([
      'https://www.linkedin.com/company/bright-data',
  ]);
  const jobs = await client.scrape.linkedin.collectJobs([
      'https://www.linkedin.com/jobs/view/123456',
  ]);
  const posts = await client.scrape.linkedin.collectPosts([
      'https://www.linkedin.com/feed/update/urn:li:activity:123',
  ]);

  // Discover by parameters
  const byKeyword = await client.scrape.linkedin.discoverJobs(
      [{ keyword: 'python developer', location: 'New York', remote: true }],
      {}
  );
  const byName = await client.scrape.linkedin.discoverProfiles(
      [{ firstName: 'John', lastName: 'Doe' }],
      {}
  );
  const compPosts = await client.scrape.linkedin.discoverCompanyPosts(
      [{ url: 'https://www.linkedin.com/company/bright-data' }],
      {}
  );
  const userPosts = await client.scrape.linkedin.discoverUserPosts(
      [{ url: 'https://www.linkedin.com/in/satyanadella' }],
      {}
  );
  ```

  ```javascript Amazon theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  // Collect by URL
  const products = await client.scrape.amazon.collectProducts(
      ['https://www.amazon.com/dp/B0D77BX8Y4'],
      {}
  );
  const reviews = await client.scrape.amazon.collectReviews(
      ['https://www.amazon.com/dp/B0D77BX8Y4'],
      {}
  );
  const sellers = await client.scrape.amazon.collectSellers(
      ['https://www.amazon.com/sp?seller=AXXX'],
      {}
  );

  // Discover by parameters
  const byKeyword = await client.scrape.amazon.discoverProductsByKeyword(
      [{ keyword: 'wireless headphones' }],
      {}
  );
  const byCategory = await client.scrape.amazon.discoverProductsByCategoryURL(
      ['https://amazon.com/s?category=electronics'],
      {}
  );
  const byBSUrl = await client.scrape.amazon.discoverProductsByBestSellerURL(
      ['https://amazon.com/gp/bestsellers/electronics'],
      {}
  );

  // One-call orchestrated (trigger, poll, and return)
  const result = await client.scrape.amazon.products([
      'https://www.amazon.com/dp/B0D77BX8Y4',
  ]);
  ```

  ```javascript Instagram theme={null}
  const profiles = await client.scrape.instagram.collectProfiles([
      'https://www.instagram.com/natgeo/',
  ]);
  const posts = await client.scrape.instagram.collectPosts([
      'https://www.instagram.com/p/ABC123/',
  ]);
  const reels = await client.scrape.instagram.collectReels([
      'https://www.instagram.com/reel/XYZ789/',
  ]);
  const comments = await client.scrape.instagram.collectComments([
      'https://www.instagram.com/p/ABC123/',
  ]);
  ```

  ```javascript Facebook theme={null}
  const profilePosts = await client.scrape.facebook.collectPostsByProfile([
      'https://www.facebook.com/nasa',
  ]);
  const groupPosts = await client.scrape.facebook.collectPostsByGroup([
      'https://www.facebook.com/groups/example',
  ]);
  const postByUrl = await client.scrape.facebook.collectPostsByUrl([
      'https://www.facebook.com/post/123456',
  ]);
  const comments = await client.scrape.facebook.collectComments([
      'https://www.facebook.com/post/123456',
  ]);
  const reels = await client.scrape.facebook.collectReels([
      'https://www.facebook.com/nasa',
  ]);
  ```

  ```javascript TikTok theme={null}
  const profiles = await client.scrape.tiktok.collectProfiles([
      'https://www.tiktok.com/@tiktok',
  ]);
  const posts = await client.scrape.tiktok.collectPosts([
      'https://www.tiktok.com/@user/video/7433494424040017194',
  ]);
  const comments = await client.scrape.tiktok.collectComments([
      'https://www.tiktok.com/@user/video/7216019547806092550',
  ]);
  ```

  ```javascript YouTube theme={null}
  const videos = await client.scrape.youtube.collectVideos([
      'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
  ]);
  ```

  ```javascript Reddit theme={null}
  const posts = await client.scrape.reddit.collectPosts([
      'https://www.reddit.com/r/technology/top/',
  ]);
  ```

  ```javascript ChatGPT / Perplexity / Digikey / Pinterest theme={null}
  const chatgpt = await client.scrape.chatGPT.search([
      'What are the latest trends in AI?',
  ]);
  const perplexity = await client.scrape.perplexity.search([
      'Latest breakthroughs in battery tech?',
  ]);
  const parts = await client.scrape.digikey.collectProducts([
      'https://www.digikey.com/en/products/detail/abc',
  ]);
  const pins = await client.scrape.pinterest.collectPosts([
      'https://www.pinterest.com/pin/123456',
  ]);
  ```
</CodeGroup>

## Scraper Studio

Run your custom Scraper Studio collectors from the SDK.

```javascript theme={null}
// Run and get results in one call
const results = await client.scraperStudio.run('c_your_collector_id', {
    input: { url: 'https://example.com/product/1' },
});
// results is [{ input, data, error, responseId, elapsedMs }]

// Manual: trigger, wait, and fetch
const job = await client.scraperStudio.trigger('c_your_collector_id', {
    url: 'https://example.com/product/1',
});
const data = await job.waitAndFetch();

// Check status
const status = await client.scraperStudio.status('j_abc123');
// status.status is 'queued' | 'running' | 'done' | 'failed'
```

## Browser API

Connect Playwright to Bright Data's cloud browser.

```javascript theme={null}
import { bdclient } from '@brightdata/sdk';
import { chromium } from 'playwright';

const client = new bdclient({
    apiKey: 'YOUR_API_KEY',
    browserUsername: 'brd-customer-xxxx-zone-scraping_browser1',
    browserPassword: 'YOUR_ZONE_PASSWORD',
});

const browser = await chromium.connectOverCDP(client.browser.getConnectUrl());
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();
await client.close();
```

## Datasets API

Query and download from any of the 126+ Bright Data datasets.

```javascript theme={null}
const ds = client.datasets;

// Query, then download
const snapshotId = await ds.instagramProfiles.query(
    { url: 'https://www.instagram.com/natgeo/' },
    { records_limit: 10 }
);
const rows = await ds.instagramProfiles.download(snapshotId);

// Same pattern across the full catalog
await ds.amazonProducts.query({ url: 'https://amazon.com/dp/B123' });
await ds.linkedinProfiles.query({ url: 'https://linkedin.com/in/johndoe' });
await ds.imdbMovies.query({}, { records_limit: 50 });
await ds.redditPosts.query({ subreddit: 'technology' });
await ds.glassdoorReviews.query({ company: 'Bright Data' });

// Get field metadata
const meta = await ds.instagramProfiles.getMetadata();
```

## Client and method parameters

<AccordionGroup>
  <Accordion title="Client" description="Add client parameters" icon="circle-info">
    | Parameter | Type | Description | Default |
    | - | - | - | - |
    | `apiKey` | `string` | Your API key (or `BRIGHTDATA_API_KEY` env var) | . |
    | `autoCreateZones` | `boolean` | Auto-create zones if they do not exist | `true` |
    | `webUnlockerZone` | `string` | Custom Web Unlocker zone name | . |
    | `serpZone` | `string` | Custom SERP zone name | . |
    | `browserUsername` | `string` | Browser API username (or `BRIGHTDATA_BROWSERAPI_USERNAME` env var) | . |
    | `browserPassword` | `string` | Browser API password (or `BRIGHTDATA_BROWSERAPI_PASSWORD` env var) | . |
    | `logLevel` | `string` | Log level | `'INFO'` |
    | `structuredLogging` | `boolean` | Use structured JSON logging | `true` |
    | `verbose` | `boolean` | Enable verbose logging | `false` |

    ```javascript theme={null}
    const client = new bdclient({
        apiKey: 'YOUR_API_KEY',
        autoCreateZones: true,
        webUnlockerZone: 'unlocker_zone1',
        serpZone: 'serp_zone1',
        browserUsername: 'brd-customer-xxxx-zone-scraping_browser1',
        browserPassword: 'YOUR_ZONE_PASSWORD',
        logLevel: 'INFO',
        structuredLogging: true,
        verbose: false,
    });
    ```
  </Accordion>

  <Accordion title="Search" description="Add advanced search parameters" icon="magnifying-glass-chart">
    Search the web using the SERP API.

    | Name | Type | Description | Default |
    | - | - | - | - |
    | `query` | `string \| string[]` | Search query string or array of queries | . |
    | `options.searchEngine` | `'google' \| 'bing' \| 'yandex'` | Search engine | `'google'` |
    | `options.zone` | `string` | Zone identifier (auto-configured if null) | . |
    | `options.format` | `'json' \| 'raw'` | Response format | `'raw'` |
    | `options.method` | `string` | HTTP method | `'GET'` |
    | `options.country` | `string` | Two-letter country code | `''` |
    | `options.dataFormat` | `'markdown' \| 'screenshot' \| 'html'` | Returned content format | `'html'` |
    | `options.concurrency` | `number` | Max parallel workers | `10` |
    | `options.timeout` | `number (ms)` | Request timeout | `30000` |
  </Accordion>

  <Accordion title="Scrape" description="Add advanced scrape parameters" icon="spider">
    Scrape a single URL or list of URLs using the Web Unlocker API.

    | Name | Type | Description | Default |
    | - | - | - | - |
    | `url` | `string \| string[]` | Single URL string or array of URLs | . |
    | `options.zone` | `string` | Zone identifier (auto-configured if null) | . |
    | `options.format` | `'json' \| 'raw'` | Response format | `'raw'` |
    | `options.method` | `string` | HTTP method | `'GET'` |
    | `options.country` | `string` | Two-letter country code | `''` |
    | `options.dataFormat` | `'markdown' \| 'screenshot' \| 'html'` | Returned content format | `'html'` |
    | `options.concurrency` | `number` | Max parallel workers | `10` |
    | `options.timeout` | `number (ms)` | Request timeout | `30000` |
  </Accordion>

  <Accordion title="saveResults" description="Save content to local file." icon="floppy-disk">
    | Name | Type | Description | Default |
    | - | - | - | - |
    | `content` | `any` | Content to save | . |
    | `options.filename` | `string` | Output filename (auto-generated if null) | . |
    | `options.format` | `'json' \| 'csv' \| 'txt'` | File format | . |
  </Accordion>
</AccordionGroup>

## Error handling

<AccordionGroup>
  <Accordion title="Logging" description="Enable advanced logging" icon="ballot">
    Enable `VERBOSE` in the Client for advanced logging (see Client parameters). Use the `listZones()` function to check available zones.
  </Accordion>

  <Accordion title="Authentication" description="Bright Data Auth" icon="rectangle-barcode">
    Create a [Bright Data](https://brightdata.com/) account and copy your API key. Go to [account settings](https://brightdata.com/cp/setting/users) and make sure your API key has **admin permissions**.
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup>
  <Card title="GitHub" icon="github" href="https://github.com/brightdata/bright-data-sdk-js?tab=readme-ov-file">
    Visit the Bright Data SDK GitHub repository
  </Card>
</CardGroup>


# Choose a delivery type on request level
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level

Pick a Bright Data Scraper Studio API collection mode: batch, async real-time or sync real-time, and match delivery preferences to each endpoint.

Instead of creating duplicate scrapers for each delivery type, you can choose a delivery type per job using API.

<Frame>
  <img alt="hero-image.png" />
</Frame>

Scraper Studio supports three API collection modes:

* **Batch collection**: runs one or more inputs in the background and returns a collection\_id.
* **Asynchronous real-time collection**: runs one input in the background and returns a response\_id.
* **Synchronous real-time collection**: runs one input and returns the collected data directly in the same API response, if the request completes within the timeout.

The scraper’s **Delivery preferences** in the control panel affect which API modes can be used. A scraper configured for Batch delivery can still be triggered with the real-time API endpoints. However, a scraper configured for Real-time delivery cannot be triggered with the batch endpoint.

<Frame>
  <img alt="Delivery preferences tab in the Scraper Studio control panel, showing the &#x22;Choose when to get the data&#x22; options: &#x22;On a job completion (batch)&#x22; selected, &#x22;Realtime (single request)&#x22; and &#x22;Split delivery to small batches&#x22;" />
</Frame>

## **Delivery preference compatibility**

Before triggering a scraper by API, check its Delivery preferences in the control panel.

| Delivery preference in control panel | Batch endpoint | Real-time endpoints |
| :- | :- | :- |
| Batch / On job completion | Supported | Supported |
| Real-time | Not supported | Supported |

If you call the batch endpoint for a scraper configured as real-time, the API returns an error:

```json theme={null}
"error": "Cannot trigger a batch job with a real-time scraper. Use /trigger_immediate endpoint instead"
```

## **Choose a collection mode**

| Mode | Endpoint | Input shape | Response | Use when |
| :- | :- | :- | :- | :- |
| Batch | `POST /dca/trigger` | JSON array of input objects | collection\_id | You need to process one or more inputs in a background job. |
| Async real-time | `POST /dca/trigger_immediate` | Single JSON input object | response\_id | You need to run one input in the background and retrieve results later. |
| Sync real-time | `POST /dca/crawl` | Single JSON input object | Collected data, or 202 if timeout is reached | You need the result in the same API request. |

## **Batch collection**

Use batch collection when you want to run one or more inputs in the background.

Batch collection is best for:

* Multiple URLs, keywords or input rows
* Large jobs
* Scheduled or recurring data collection
* Jobs where results can be retrieved later

Batch collection is available only when the scraper is not configured as Real-time in Delivery preferences.

See [Trigger batch collection](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method) for request parameters and examples.

## **Asynchronous real-time collection**

Use asynchronous real-time collection when you want to run a single input in the background and retrieve the result later.

Async real-time is best for:

* One input per request
* Low-latency workflows where the client should not keep the HTTP request open
* Applications that prefer to trigger now and retrieve results later

A scraper configured for Batch delivery in the control panel can still be triggered with the async real-time endpoint.

See [Trigger async real-time collection](/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job) for request parameters and examples.

## **Synchronous real-time collection**

Use synchronous real-time collection when you want the API request to wait for the scraper result and return the collected data directly.

Sync real-time is best for:

* One input per request
* Applications that need an immediate response
* Scrapers that usually complete within the configured timeout

A scraper configured for Batch delivery in the control panel can still be triggered with the sync real-time endpoint.

Synchronous real-time requests use the timeout query parameter. The timeout must be between 25s and 50s.

If the scraper finishes within the timeout, the API returns 200 OK with the collected data. If the scraper is still running when the timeout is reached, the API may return 202 Accepted with a response\_id. Use this response\_id with the real-time data endpoint to retrieve the result asynchronously.

See [Trigger sync real-time collection](/api-reference/scraper-studio-api/initiate-a-realtime-job/sync-realtime-job) for request parameters and examples.

## **Delivery behavior**

Collection mode controls how the scraper runs. Delivery preferences control default delivery behavior configured in the control panel.

Depending on your scraper configuration, results can be retrieved by API or delivered to a configured destination, such as:

* API download
* Webhook
* Amazon S3
* Google Cloud Storage
* Azure Blob Storage
* SFTP / FTP
* Snowflake
* Email

To override the configured destination for a single batch request, pass the `deliver` query parameter on `POST /dca/trigger`, and use the `notify` parameter to send a notification when the job or delivery completes. See [request-level delivery and notifications](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method#override-delivery-settings-for-one-request).

**Important behavior:**

* A scraper configured for Batch delivery can be triggered by either batch or real-time API endpoints.
* A scraper configured for Real-time delivery can be triggered only by real-time API endpoints.
* Batch endpoint calls return a collection\_id.
* Async real-time endpoint calls return a response\_id.
* Sync real-time endpoint calls return collected data directly, unless the timeout is reached.

<Note>
  Batch responses begin with `j_****` and real-time responses begin with `d****`
</Note>


# Understanding the AI Scraper Studio APIs
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/overview

Use Bright Data Scraper Studio AI Flow APIs to create scrapers with AI, monitor job progress and update existing scrapers with the Self-Healing tool.

The AI Scraper Studio API is a set of endpoints that let you create Scraper Studio scrapers with AI and update existing scrapers using Self-Healing tool, without using the UI. This page explains which endpoint to call and in what order.

Both flows are asynchronous: you start an AI job, then check its progress until it completes.

## Workflow 1: Create a new scraper with AI

Use these endpoints when you want AI to generate a scraper (schema + code) from scratch for a target site.

1. Create the scraper entity<br />→ <Badge>Create scraper template</Badge>
2. Start the AI generation job (schema + code)<br />→ <Badge>Trigger AI Flow to create code</Badge>
3. Poll until the AI job finishes and returns the result<br />→ <Badge>AI job progress</Badge>

## Workflow 2: Update an existing scraper with Self-Healing

Use these endpoints when you already have a scraper and want to fix or modify it using a prompt.

1. Start a Self-Healing refactor job<br />→ <Badge>Trigger Self-Healing</Badge>
2. Poll until the refactor job finishes or pauses for user input<br />→ <Badge>Self-Healing job progress</Badge>
3. If progress returns `status: "pending_answer"`, approve or reject the proposed diff<br />→ <Badge>Resume Self-Healing job</Badge>
4. After the scraper is ready, initiate collection<br />→ <Badge>Initiate collection</Badge>

Once created or updated, run it using the standard Scraper Studio API initiation endpoints (manual trigger, schedule, queue, etc.).

## Workflow 3: Heal a scraper automatically with Auto Self-Healing

Use this endpoint when you want Scraper Studio to start a healing job on its own whenever a scraper's success rate drops below a threshold you set.

1. Enable Auto Self-Healing and set the trigger rules<br />→ <Badge>Enable Auto Self-Healing</Badge>

For what each trigger rule does, see [Scraper Studio Auto Self-Healing](/products/scraper-studio/auto-self-healing).

<Columns>
  <Tip>
    **Not sure which to use?**

    * No scraper yet → [Workflow 1](#workflow-1-create-a-new-scraper-with-ai)
    * Scraper needs changes → [Workflow 2](#workflow-2-update-an-existing-scraper-with-self-healing)
    * Scraper should fix itself when it fails → [Workflow 3](#workflow-3-heal-a-scraper-automatically-with-auto-self-healing)
  </Tip>

  <Tip>
    **New to the API?**

    See: <a href="/products/scraper-studio/quickstart">Getting started with the API</a>
  </Tip>
</Columns>


# Ethical web scraping best practices
Source: https://docs.brightdata.com/concepts/ethical-web-scraping

5 core principles of ethical web data collection, the legal risks of non-compliant scraping and a practical checklist for sustainable data pipelines.

How do you build a data pipeline that won't get shut down by a lawsuit, a regulatory change, or a blocked IP range? As scraping lawsuits multiply and AI-specific regulation accelerates, how you collect data matters as much as what you collect.

This guide covers the risks of non-compliant scraping, five core principles for ethical data collection, and a practical checklist you can apply today.

<iframe title="Ethical web scraping best practices" />

## Why ethical scraping matters now

The demand for web data keeps growing, especially for AI training, competitive intelligence, and real-time analytics. But so does the scrutiny.

Three trends are converging:

* **Regulatory pressure is increasing.** Governments worldwide are drafting AI-specific regulations that include data collection requirements. The EU AI Act, the US AI Action Plan, and China's Global AI Initiative all address how data is sourced.
* **Legal disputes are multiplying.** Website owners and platforms are filing lawsuits against data collectors more frequently. Cases involving social media platforms, publishers, and AI companies make headlines weekly.
* **The need for data is not slowing down.** Data is now the key differentiator in the AI triangle of compute, talent, and data. The internet is the largest dataset mankind has ever built, but accessing it responsibly is a challenge on its own.

If you build ethical data collection practices now, you'll avoid costly disruptions later. If you don't, you risk lawsuits, blocked access, reputational damage, and poisoned data pipelines.

## Risks of unethical data collection

The consequences of non-compliant scraping fall into two categories.

### Legal, reputational, and financial risks

* **Lawsuits from website owners.** Legal actions from platforms and publishers are increasing. These cases are expensive, take years to resolve, and damage your reputation even before a ruling.
* **High-profile media coverage.** You don't need a court case to suffer reputational damage. Negative press about your data practices can erode customer trust quickly, especially in the AI space where data sourcing is under a spotlight.
* **Vendor risk.** If your data vendor gets sued or shuts down, you lose your data source. Worse, your AI model or product may have already ingested data that was unethically sourced, and unwinding that is far more expensive than preventing it.

### Technical and operational risks

* **IP bans and blocked access.** Aggressive or poorly configured scraping triggers blocks that degrade your data quality and availability.
* **Silent data degradation.** Blocked scrapers don't always fail loudly. They may return valid-looking HTML with wrong data, meaning your downstream systems ingest bad data without alerting anyone.
* **Product damage.** If your product depends on scraped data, any disruption to your data pipeline directly impacts your users.

<Warning>
  These risks are not theoretical. Data vendors have been sued and forced to shut down for selling non-public data, leaving their customers exposed to both data loss and legal liability.
</Warning>

## Five principles of ethical web scraping

### 1. Collect publicly available data only

This is the most important principle. Public web data means content accessible without logging in. If data requires a login, sits behind a paywall, or needs restricted access credentials, it is not public data.

The distinction matters legally and practically:

| Data type | Example | Ethical to scrape? |
| - | - | - |
| **Public web data** | Product listings, public profiles, published articles | Yes (with other principles applied) |
| **Login-required data** | Private messages, account dashboards, gated content | No |
| **Paywall-protected data** | Subscription-only articles, premium databases | No |

<Tip>
  Build your scraping infrastructure to distinguish between public and non-public data by design. Being able to demonstrate this distinction (through code, policies, or audits) is one of the strongest defenses you can have.
</Tip>

### 2. Collect only what you need

Scope your data collection to specific business purposes before you start scraping. This isn't just good practice. It directly reduces your legal exposure.

Ask three questions before any scraping project:

* **What** specific data fields do you need?
* **Why** do you need this data? (What business problem does it solve?)
* **How** will this data be used and stored?

Broad, unfocused data collection increases risk without increasing value. The more targeted your scraping, the easier it is to justify and defend.

### 3. Protect the web

When you scrape with automated processes and bots, your traffic should not harm or degrade the target site's performance. Both bots and humans should still be able to use the website normally.

Practical measures include:

* **Monitor domain response times.** Measure the target site's response time in real time to detect if your traffic is affecting performance.
* **Implement rate limiting.** Throttle your requests to avoid overwhelming the server.
* **Respect `robots.txt`.** While not legally binding in all jurisdictions, respecting `robots.txt` signals good faith.
* **Back off on errors.** If you start receiving 429 (Too Many Requests) or 503 (Service Unavailable) responses, reduce your request rate immediately.

<Note>
  Ethical scraping requires a proactive approach. Don't just avoid causing harm. Actively monitor for it and adjust your behavior accordingly.
</Note>

### 4. Keep detailed logs

Many proxy and scraping providers advertise "no logs" as a feature. For ethical scraping, the opposite is true.

Keeping logs allows you to:

* **Monitor** your scraping activity for anomalies or policy violations
* **Investigate** any issues or complaints from website owners
* **Defend** against false accusations with evidence of compliant behavior
* **Improve** your practices based on historical patterns

If you don't want to keep logs, ask yourself why. Logs are a protection, not a liability. They enable transparency and accountability, two things regulators and courts value highly.

### 5. Enforce governance and reporting

Having a policy isn't enough. You need active enforcement.

This means:

* **Zero tolerance for non-compliant activity.** Define clear boundaries and enforce them consistently.
* **Internal and external reporting channels.** Allow stakeholders (including website owners) to report suspicious activity.
* **Third-party audits.** Independent verification ensures your policies are actually being followed.
* **Incident investigation.** When dealing with large-scale data collection, issues will arise. What matters is whether you detect them, investigate them, and fix them.

## The regulatory landscape

Regulation around web scraping and AI data collection is evolving rapidly and differs by jurisdiction.

| Approach | Key framework | Focus |
| - | - | - |
| **Risk-based (EU)** | EU AI Act, Voluntary Code of Practice | Ethics and safety first, with layers of compliance requirements for AI systems |
| **Innovation-first (US)** | US AI Action Plan | Emphasizes removing barriers to AI development. Views access to public data as crucial to AI leadership |
| **Hybrid** | China's Global AI Initiative | Combines innovation goals with data governance requirements |

Three takeaways regardless of your jurisdiction:

1. **Data collection practices are getting more scrutiny.** Regulators are distinguishing between data collection and data usage. Both carry separate risks and requirements.
2. **Local regulation matters.** Requirements differ based on where your organization operates, where your data sources are located, and where your users are.
3. **Existing laws still apply.** Privacy regulations, copyright law, and computer fraud statutes are being applied to scraping cases today. Don't wait for AI-specific legislation to address compliance.

<Tip>
  Consult with your legal team regularly. Regulation is changing fast, and what was acceptable six months ago may no longer be. Ongoing risk management is essential, not optional.
</Tip>

## What to check before scraping

Use this checklist to evaluate your own scraping practices or to vet a data vendor.

<AccordionGroup>
  <Accordion title="1. Know your data sources">
    Only collect publicly available data. If you use a data vendor or proxy provider, do your due diligence: know who you're doing business with, where and how they source their data, and whether they follow ethical practices. Not all vendors are created equal.
  </Accordion>

  <Accordion title="2. Protect the web">
    Monitor target site health, implement rate limits, and use response time tracking to ensure your scraping doesn't degrade site performance. Ethical scraping means the website works normally for all visitors during and after your data collection.
  </Accordion>

  <Accordion title="3. Maintain logs and documentation">
    Keep detailed records of your scraping activity. Logs serve compliance, incident investigation, and continuous improvement. They're your best defense if your practices are ever questioned.
  </Accordion>

  <Accordion title="4. Build reporting and governance channels">
    Create mechanisms for internal teams and external stakeholders to report concerns. Investigate any abnormal activity promptly. At scale, issues will arise. Your response to them defines your ethical posture.
  </Accordion>

  <Accordion title="5. Stay current on regulation">
    Follow regulatory developments in every jurisdiction where you operate or source data. Consult with your legal team regularly. Join industry groups and alliances focused on responsible data collection to stay informed.
  </Accordion>
</AccordionGroup>

## Common misconceptions

**"If data is on the internet, it's free to scrape."**
Being publicly accessible doesn't mean there are no rules. Privacy laws, terms of service, and copyright protections may still apply. Public access reduces legal risk significantly compared to scraping behind logins, but it doesn't eliminate all obligations.

**"CAPTCHA solving means you're accessing protected data."**
Solving a CAPTCHA doesn't mean you're piercing a privacy wall or accessing restricted content. CAPTCHAs are anti-bot measures, not access controls. Courts have recognized this distinction: content behind a CAPTCHA can still be publicly available.

**"No-log policies protect you."**
Without logs, you can't prove what you did or didn't do. If a website owner claims you scraped non-public data or caused a service disruption, logs are your evidence. "No logs" is a liability, not a feature.

**"Data collection and data usage carry the same risk."**
These are distinct activities with different legal and ethical considerations. How you collect data (scraping practices, sources, methods) and how you use it (training models, commercial analytics, resale) are evaluated separately by regulators and courts.

## FAQs

<AccordionGroup>
  <Accordion title="What is 'public web data'?">
    Public web data is content accessible to anyone through a web browser without logging in, providing credentials, or bypassing access restrictions. Product listings, public social media profiles, published news articles, and government databases are common examples.
  </Accordion>

  <Accordion title="Is web scraping legal?">
    Web scraping of publicly available data is generally legal in most jurisdictions, but the specifics depend on local laws, the type of data, and how it's used. Privacy regulations (like GDPR), copyright law, and terms of service can all create constraints. Consult with legal counsel for your specific situation.
  </Accordion>

  <Accordion title="How do I evaluate a data vendor's ethical practices?">
    Ask whether they collect only public data, how they distinguish public from non-public content, whether they maintain logs, how they handle website owner complaints, and whether they undergo third-party audits. A vendor that can't answer these questions clearly is a risk.
  </Accordion>

  <Accordion title="Does respecting robots.txt make scraping ethical?">
    Respecting `robots.txt` is one signal of good faith, but it's not the full picture. Ethical scraping also requires collecting only public data, protecting site performance, maintaining logs, and having governance processes in place. `robots.txt` compliance alone is not sufficient.
  </Accordion>

  <Accordion title="What should I do if my data vendor gets sued or shuts down?">
    This is why vendor due diligence matters upfront. If it happens, assess what data you've already ingested, whether it was ethically sourced, and whether you need to remove or replace it. Build redundancy into your data pipeline so a single vendor failure doesn't cripple your operations.
  </Accordion>
</AccordionGroup>

## Further reading

* [Alliance for Responsible Data Collection (ARDC)](https://responsibledatacollection.org)
* [Bright Data Trust Center](https://brightdata.com/trustcenter)
* [Web Scraping Without Getting Blocked: 12 Techniques](https://brightdata.com/blog/web-data/web-scraping-without-getting-blocked)
* [How Bright Data handles anti-bot blocking](/concepts/how-bright-data-handles-blocking)


# How Bright Data handles anti-bot blocking
Source: https://docs.brightdata.com/concepts/how-bright-data-handles-blocking

Learn how modern anti-bot systems detect scrapers across 4 layers, why DIY bypasses are costly, and how Bright Data's products defeat each detection layer.

Your scraper worked yesterday. Today it returns a 403, a CAPTCHA page, or worse: valid-looking HTML with completely wrong data. What changed?

Websites layer multiple detection systems that evolve constantly. This guide explains the detection layers that block scrapers, why maintaining anti-blocking yourself is costly, and how Bright Data's products defeat each layer.

## Why scrapers get blocked

Modern anti-bot systems don't rely on a single signal. They combine multiple detection layers, and failing any one of them triggers a block.

DIY scraping refers to building and maintaining your own scraping infrastructure: writing parsers, managing proxies, handling CAPTCHAs, and patching browser fingerprints yourself. Here is why each detection layer makes that difficult:

| Detection layer | What it checks | Why DIY scraping struggles |
| - | - | - |
| **IP reputation** | Historical behavior of your IP address | Datacenter IPs are flagged instantly; rotating residential IPs requires a large, clean pool |
| **TLS/JA3 fingerprinting** | The TLS handshake signature of your HTTP client | Libraries like Python `requests` send identical JA3 hashes on every request, matching known bot signatures |
| **Browser fingerprinting** | Canvas, WebGL, fonts, screen resolution, audio context | Even headless browsers with stealth plugins leave detectable traces |
| **Behavioral analysis** | Request timing, navigation patterns, mouse movement | Fixed intervals and linear crawl paths signal automation |
| **CAPTCHAs** | Human verification challenges | reCAPTCHA v3, hCaptcha, Cloudflare Turnstile each require different solving approaches |

Here is what a typical blocked response looks like when scraping a Cloudflare-protected site with a basic setup:

```bash cURL theme={null}
curl -s "https://www.g2.com/products/bright-data/reviews" \
  -H "User-Agent: Mozilla/5.0" \
  -x http://datacenter-proxy:8080
```

```html Response theme={null}
<html>
  <head><title>Attention Required! | Cloudflare</title></head>
  <body>
    <h1>Sorry, you have been blocked</h1>
    <p>You are unable to access g2.com</p>
    <!-- Cloudflare Ray ID: 7a1b2c3d4e5f -->
  </body>
</html>
```

## Why maintaining anti-blocking yourself is costly

Each detection layer requires a different countermeasure, and each countermeasure requires ongoing maintenance.

IP rotation means sourcing, validating, and retiring proxies. TLS fingerprinting means patching your HTTP client to randomize handshake signatures, something most libraries don't support natively. Browser fingerprinting means keeping headless browser patches current as detection systems update weekly. CAPTCHA solving means integrating third-party solvers and handling failures.

In practice, teams that build this in-house find that anti-blocking maintenance consumes a significant share of their engineering effort, often more time than building the actual data pipeline. When a target site updates its defenses, your scraper fails silently, returning empty fields or stale data while appearing to work normally. By the time you notice, your downstream systems have been ingesting bad data for hours or days.

Every Bright Data scraping product shares the same anti-blocking engine. The difference between products is what you get back and how much control you keep.

## How Bright Data handles each detection layer

**IP reputation.** Requests are routed through residential IPs from real ISPs across 195+ countries. Anti-bot systems treat these as regular household traffic. IPs are automatically rotated per request and flagged addresses are retired from the pool.

**TLS fingerprinting.** When your HTTP client opens a connection, it sends a TLS Client Hello that anti-bot systems hash into a JA3 fingerprint. Python `requests`, for example, always produces the same hash, which is a known bot signature. Bright Data generates a unique TLS fingerprint per request, matching the diversity of real browser populations.

**Browser fingerprinting.** Sites collect Canvas renders, WebGL data, installed fonts, screen dimensions, and audio context to build a device profile. Bright Data emulates complete, consistent browser environments that pass checks from Cloudflare Turnstile, Akamai Bot Manager, and other major detection systems.

**Behavioral analysis.** Anti-bot systems track request timing, navigation sequences, and interaction patterns. Bright Data varies request timing, simulates realistic navigation patterns, and manages session state to match human browsing behavior.

**CAPTCHA solving.** CAPTCHAs are solved automatically, including reCAPTCHA, hCaptcha, Cloudflare Turnstile, and others. You never see the challenge. The response arrives as if no CAPTCHA existed.

## Which product fits your situation

Each product inherits the anti-blocking capabilities described above. The difference is what you get back and how much control you need.

**I want full control over my HTTP client and just need IPs that won't get flagged.**

Use [Bright Data Proxies](/left-over/proxy-networks-introduction). Four types are available: residential (highest trust, best for protected sites), datacenter (fastest, best for unprotected sites), ISP (residential trust at datacenter speed), and mobile (highest trust, best for heavily protected targets). Proxies solve IP reputation but leave the other four detection layers to you.

**I need raw HTML from protected sites without building anti-blocking myself.**

Use [Web Unlocker](/products/web-unlocker/introduction). Send a URL, get back clean HTML. All five detection layers are handled in a single API call: IP rotation, TLS fingerprinting, browser fingerprinting, behavioral emulation, and CAPTCHA solving.

**I need to navigate to click through pagination, or interact with JavaScript-heavy pages.**

Use [Bright Data Browser API](/products/scraping-browser/introduction). Full cloud-hosted browsers controlled through Puppeteer or Playwright with all anti-blocking built in. Unlike Web Unlocker, Browser API runs a real GUI browser (not headless), which produces authentic rendering artifacts that detection systems are far less likely to flag.

**I need search engine results from Google, Bing, or other engines without getting blocked.**

Use [SERP API](/products/serp-api/introduction). Search engines are among the most aggressively protected targets. SERP API handles all the anti-blocking and returns structured JSON with organic results, ads, featured snippets, and knowledge panels already parsed.

**I want structured data from popular websites without writing or maintaining parsers.**

Use [Web Scraper API](/products/scrapers/overview). Thousands of pre-built scrapers for sites like Amazon, LinkedIn, Instagram, YouTube, TikTok, and Google Maps. You get clean JSON with an average of 220+ data fields per scraper. When target sites change, Bright Data updates the scrapers.

## Common misconceptions

**"Residential proxies alone solve blocking."** They handle IP reputation, but modern systems also check TLS fingerprints, browser fingerprints, and behavioral patterns. Proxies are one layer out of five.

**"Stealth plugins make headless browsers undetectable."** Cloudflare Turnstile and Akamai Bot Manager detect patched headless browsers even with Playwright Stealth applied. Browser API solves this by running a real GUI browser rather than a patched headless one.

**"Slowing down requests prevents blocks."** Rate limiting helps avoid basic IP bans, but sites like LinkedIn, Instagram, and Amazon use session-level fingerprinting that detects automation regardless of speed.

**"Proxies and Web Unlocker do the same thing."** Proxies route your requests through different IPs only. Web Unlocker also manages TLS fingerprints, solves CAPTCHAs, emulates browser behavior, handles JavaScript rendering, and retries with fresh fingerprints on failure.

## FAQs

<AccordionGroup>
  <Accordion title="Does Bright Data work on Cloudflare-protected sites?">
    Yes. Web Unlocker, Browser API, SERP API, and Web Scraper API all handle Cloudflare challenges (including Turnstile), Akamai Bot Manager, PerimeterX, DataDome, and other major anti-bot systems automatically.
  </Accordion>

  <Accordion title="Where can I find my public IP when using Web Unlocker API, SERP API or Browser API?">
    You cannot. The public IPs used by Web Unlocker API, SERP API and Browser API are not visible to customers. All three draw on a dynamic pool that includes real residential IPs, and those IPs are deliberately hidden and continuously rotated for compliance and privacy, and to keep unblocking effective.

    You can still inspect the metadata around the IP, such as country, ASN and city, by sending a request to `http://brdtest.com/myip.json`. The response does not include the IP field itself.
  </Accordion>

  <Accordion title="What success rate should I expect?">
    In an [independent benchmark](https://brightdata.com/blog/web-data/best-web-scraping-apis) testing 11 providers, Bright Data achieved a 98.44% average success rate, the highest among all tested.
  </Accordion>
</AccordionGroup>

## Further reading

* [Web Scraping Without Getting Blocked: 12 Techniques](https://brightdata.com/blog/web-data/web-scraping-without-getting-blocked)
* [Top 7 Anti-Scraping Techniques and How to Bypass Them](https://brightdata.com/blog/web-data/anti-scraping-techniques)
* [How to target API endpoints](/products/web-unlocker/target-api-endpoints)
* [Web Unlocker vs Scraping Browser](https://brightdata.com/blog/web-data/web-unlocker-vs-scraping-browser)


# Modern scraping operations
Source: https://docs.brightdata.com/concepts/modern-scraping-operations

Why web scraping shifted from a scripting problem to an infrastructure discipline, and what production-grade scraping systems look like in 2026.

What changed about web scraping? The scripts still work, until they don't. Then you're debugging at 2 AM because a site changed a single CSS class and your entire pipeline went silent.

Five years ago, scraping was a scripting problem. You wrote a parser, pointed it at a URL, and collected data. Today, scraping is an infrastructure problem. Cloudflare alone protects [over 24 million active websites](https://www.cloudflare.com/network/), and in July 2025 it began [blocking AI crawlers by default](https://blog.cloudflare.com/declaring-your-aindependence-block-ai-bots-scrapers-and-crawlers-with-a-single-click/) across its entire network. The number of web security services tracked by [Wappalyzer](https://www.wappalyzer.com/technologies/security/) nearly doubled from 36 to 60 between 2022 and 2024. The web got harder to scrape, and it happened fast.

This article examines why the landscape shifted, what production scraping systems look like now, and how teams are adapting their architecture to operate reliably at scale.

## The economics shifted

The headline number most teams track is cost per gigabyte of proxy traffic. That number has fallen significantly over the past five years. But it's the wrong metric.

What actually matters is **cost per successful payload**: the total spend (proxy, compute, API fees) divided by the number of usable records you extract. That number has been climbing, because the techniques required to extract data have gotten more expensive even as individual input costs dropped.

Here's why:

* Sites that once responded to simple HTTP requests with datacenter proxies now require residential proxies (roughly 10x the cost) or full browser rendering (another 5-10x multiplier in compute)
* According to [AImultiple's web scraping challenges research](https://aimultiple.com/web-scraping-challenges), blocking is now the primary challenge developers face, with static IP blocking replaced by continuous behavioral trust scoring
* The share of requests that need heavyweight extraction methods (residential IPs, headless browsers, or both) has grown substantially, driven by widespread adoption of anti-bot services

This creates what you might call **scraping shock**: data remains technically reachable but becomes economically painful to extract at previous cost levels.

<Tip>
  The competitive advantage in scraping has shifted from "who can scrape the most" to "who can scrape most efficiently." Cost-per-successful-payload is now the metric that matters.
</Tip>

## Three forces driving the shift

### 1. Anti-bot systems got smarter, faster

In September 2024, Cloudflare introduced [one-click AI bot blocking](https://blog.cloudflare.com/declaring-your-aindependence-block-ai-bots-scrapers-and-crawlers-with-a-single-click/). Over 1 million customers activated it. By July 2025, Cloudflare began blocking AI crawlers by default across its entire network.

Detection moved beyond IP reputation and cookie validation. Modern anti-bot systems now analyze:

* **TLS fingerprints.** Python's Requests library has a different TLS signature than Chrome, making the library itself identifiable.
* **Browser fingerprints.** Screen resolution, WebGL renderer, canvas fingerprint, installed fonts, audio context, and GPU timing.
* **Behavioral signals.** Mouse movement patterns, scroll velocity, click timing, and keystroke cadence.
* **Header consistency.** Real browsers send different headers per request type; bots send identical headers every time.

The popular `puppeteer-stealth` library was deprecated in February 2025 because it could no longer bypass current Cloudflare versions. As developers frequently report in scraping communities: stock Selenium and Puppeteer leak automation signals everywhere, and techniques that work today stop working next month.

### 2. Platforms locked down deliberately

This isn't just technical escalation. It's strategic. Platforms are treating their data as a competitive asset, especially against AI companies.

* **Reddit** filed a lawsuit in October 2025 against multiple data collection companies and Perplexity AI for circumventing security measures.
* **X/Twitter** implemented IP reputation scoring in October 2024, bound guest tokens to browser fingerprints in January 2025, and permanently banned datacenter IPs.
* **Cloudflare's "AI Labyrinth"** creates honeypot traps that force AI agents to waste compute resources on fake content.

These aren't isolated incidents. They represent a coordinated shift where platforms view unrestricted data access as a threat to their business model.

### 3. AI crawlers changed the game for everyone

AI crawler traffic from GPTBot rose 147% between July 2024 and July 2025. Meta-ExternalAgent traffic rose 843%. These crawlers collectively generate around [50 billion requests daily](https://blog.cloudflare.com/declaring-your-aindependence-block-ai-bots-scrapers-and-crawlers-with-a-single-click/), roughly 1% of all web traffic according to Cloudflare.

This flood of AI traffic triggered a defensive response that affects all scrapers, not just AI crawlers. Sites that never bothered with anti-bot protection now have it. The collateral damage hits every team running a data pipeline.

<Warning>
  AI crawlers spend a significant portion of their fetches on 404 pages and redirect chains. This inefficiency is part of what drives sites to implement blanket blocking rather than selective filtering.
</Warning>

## What production scraping looks like now

The gap between "scraping works on my laptop" and "scraping works in production" has never been wider. Low-code tools and LLMs help get from 0 to 1 (getting a scraper working against a single page). But getting from 1 to 100 (running reliably at scale) requires systems thinking.

The operational reality of scraping at scale is sobering: successfully operating at even fewer than 1 million page views per day requires managing viewport size matching, user-agent rotation, multiple VLANs per container, and datacenter IP avoidance.

Here's what a production scraping system actually looks like:

<img alt="Modern scraping operations architecture" />

The architecture has five layers, each solving a distinct operational concern:

### How the orchestration layer works

This is the control plane. It manages what gets scraped, when, and how. At minimum, it includes:

* **Job scheduler.** Prioritizes and queues scrape jobs based on data freshness requirements.
* **Request router.** Decides the extraction method per target (HTTP client, headless browser, or managed API) based on the site's difficulty profile.
* **Retry logic with backoff.** Handles transient failures without hammering targets.

Most teams start without this layer. They run scrapers as cron jobs and handle routing manually. That works at hundreds of pages per day. It breaks at hundreds of thousands.

### How the extraction layer works

This is where the actual scraping happens. The key insight is that not every request needs the same tool:

* **HTTP clients** handle 0.5-2 seconds per request at minimal resource cost. They work for static content and sites without heavy JavaScript rendering.
* **Headless browsers** handle JavaScript-rendered content but consume 200-500 MB of RAM per instance and take 3-15 seconds per request. That's a 5-10x infrastructure multiplier.
* **Managed scraping APIs** offload anti-bot handling, proxy rotation, and browser management to a third party. The per-request cost is higher, but you eliminate infrastructure maintenance.

The production pattern is a tiered approach: try the cheapest method first, escalate only when it fails, and cache the result so subsequent requests to the same domain use the right method automatically.

<Note>
  Each Chrome instance needs 200-500 MB of RAM, and background scripts continue running even when a page seems idle. Sessions are tied to a specific process, making cross-machine load balancing complex and sharing Chrome user data directories across instances risky.
</Note>

### How the validation layer works

This is the layer most teams skip, and the one that causes the most damage at scale.

Scaling without validation means scaling error. A blocked scraper doesn't always return an HTTP error. It may return valid-looking HTML with wrong data: a CAPTCHA page, a soft block, or a region-specific version of the content. Your downstream systems ingest it silently.

Production validation includes:

* **Schema validation** before data enters storage: expected fields, types, and value ranges.
* **Content fingerprinting** to detect when a response matches a known block page pattern rather than real content.
* **Field completeness checks** that flag records where critical fields are missing or suspiciously uniform.

Teams that add schema validation to their scraping pipelines consistently report significant reductions in downstream data quality issues and ML model errors.

### How the observability layer works

Treat scraping like a production service. If you run a web application without monitoring, you'd be negligent. Scraping pipelines deserve the same discipline.

Key metrics to track:

* **Success rate per domain.** The percentage of requests that return valid, usable data (not just HTTP 200).
* **Cost per successful payload.** The total cost (proxy + compute + API) divided by usable records extracted.
* **Selector health.** Automated checks that detect when CSS selectors or XPath expressions stop matching expected elements.
* **Latency distribution.** p50 and p99 response times per domain, which signal when a site starts throttling.

Teams that implement observability-driven scraper redesigns consistently see dramatic improvements: fewer job failures, faster detection of site changes, and lower operational overhead from reduced manual debugging.

### Storage and delivery layer

Clean, validated data flows into storage and downstream systems. This layer is straightforward but matters for pipeline integrity:

* **Deduplication** before write. Scraping the same product page twice shouldn't create two records.
* **Timestamping.** Every record carries a collection timestamp so downstream consumers know data freshness.
* **Schema evolution.** When sites change their data structure, your storage schema needs to accommodate both old and new formats during the transition.

## The build vs. buy decision

At some point, every scraping team asks: should we maintain this infrastructure ourselves, or use a managed service?

The breakeven math depends on scale and site difficulty:

<img alt="Build vs buy decision framework" />

| Factor | Build (self-hosted) | Buy (managed service) |
| - | - | - |
| **Upfront cost** | Low (open-source tools) | Per-request pricing |
| **Maintenance burden** | High (proxy rotation, browser updates, anti-bot adaption) | Low (vendor handles it) |
| **Control** | Full | Limited to API parameters |
| **Scaling ceiling** | Limited by your infra team | Scales with spend |
| **Anti-bot adaptation speed** | Weeks to months | Hours to days |
| **Breakeven point** | Below \~500K requests/month | Above \~500K requests/month |

Self-hosted browser infrastructure costs \$200-800/month plus ongoing engineering time. At scale, the engineering time dominates: quarterly selector fixes, proxy pool management, and anti-bot adaptation are recurring costs that don't shrink with automation.

The practical pattern is a hybrid approach:

* **Self-host** for sites where simple HTTP requests work and data formats are stable.
* **Use managed APIs** for sites with heavy anti-bot protection, frequent layout changes, or JavaScript-heavy rendering.

Bright Data's product suite maps to this layered model. [Web Unlocker](/products/web-unlocker/introduction) handles the anti-bot layer for HTTP requests. [Scraping Browser](/products/scraping-browser/introduction) provides managed headless browsers without the RAM and scaling headaches. [Web Scraper API](/products/scrapers/overview) handles the full extraction pipeline for supported sites, returning structured data directly.

The decision isn't binary. Most production teams use a mix of self-hosted and managed components, optimized per domain based on difficulty, cost, and data freshness requirements.

## Common architectural mistakes

These patterns show up repeatedly in scraping teams that struggle at scale:

* **No validation layer.** The single most common failure. Teams scale their extraction without validating output, then discover weeks later that half their data is CAPTCHA pages stored as legitimate records.
* **Defaulting to browsers.** Headless browsers are 5-10x more expensive than HTTP clients. Teams that route every request through Puppeteer or Playwright are burning money on sites that would respond fine to a well-configured HTTP request with proper headers.
* **Hardcoded selectors without monitoring.** Static XPath and CSS selectors become invalid silently when sites change their DOM. Without automated selector health checks, data quality degrades without triggering any alert.
* **Treating scraping as a script, not a service.** Cron jobs without health checks, no alerting on success rate drops, no cost tracking per domain. This works at small scale. It creates invisible failures at production scale.
* **Ignoring the economics.** Scraping costs can spike 5-10x overnight when a site upgrades its defenses. Teams without cost-per-payload tracking don't notice until the monthly bill arrives.

## Where this is heading

Three trends will shape scraping operations over the next two years:

1. **Legal frameworks are crystallizing.** Reddit's lawsuit, the EU AI Act's data sourcing requirements, and platform-specific terms of service are creating a compliance layer that scraping systems need to account for. Teams that treat compliance as an afterthought will face operational disruption.

2. **AI is on both sides.** Sites use ML models to detect bots. Scrapers use LLMs to parse unstructured content. The cost of LLM-based parsing is still orders of magnitude higher than traditional approaches at scale, but it's falling. The teams that figure out when to use AI parsing and when to use traditional selectors will have a cost advantage.

3. **Managed infrastructure is becoming the default.** As anti-bot systems get more sophisticated, the maintenance burden of self-hosting increases. The trend line points toward more teams buying infrastructure and focusing engineering effort on data quality and business logic.

The scraping teams that thrive won't be the ones writing the cleverest bypass scripts. They'll be the ones running the most disciplined operations, with clear cost tracking, automated quality validation, and architecture that adapts to an adversarial web without manual intervention.

## Further reading

* [How Bright Data handles anti-bot blocking](/concepts/how-bright-data-handles-blocking): deep dive into detection layers and how managed services defeat them
* [How to reduce web scraping costs](/concepts/reducing-scraping-costs): practical techniques for optimizing at the request level
* [Ethical web scraping best practices](/concepts/ethical-web-scraping): compliance principles and regulatory context
* [Sync vs async requests](/concepts/sync-vs-async): when to use async vs sync for performance and cost

<AccordionGroup>
  <Accordion title="What is scraping shock?">
    Scraping shock describes the point where web data remains technically reachable but becomes economically unfeasible to extract at previous cost levels. It's driven by the combination of more sophisticated anti-bot systems, mandatory browser rendering, and required residential proxies, even as per-GB proxy prices have fallen.
  </Accordion>

  <Accordion title="How many requests per month justify building your own scraping infrastructure?">
    The general breakeven point is around 500K-1M requests per month, but this varies significantly by target site difficulty. If most of your targets work with simple HTTP requests and datacenter proxies, self-hosting stays cost-effective at higher volumes. If your targets require residential proxies and browser rendering, managed services become more economical at lower volumes.
  </Accordion>

  <Accordion title="Why did scraping costs rise even though proxy prices dropped?">
    Per-GB proxy prices have fallen significantly over the past five years. But the share of requests requiring residential proxies (roughly 10x more expensive than datacenter) and browser rendering (another 5-10x multiplier) has grown substantially. The shift in what's required more than offset the per-unit price decrease.
  </Accordion>

  <Accordion title="What percentage of scraping failures are silent?">
    This varies by implementation, but teams without validation layers commonly discover that 10-30% of their "successful" requests returned block pages, CAPTCHAs, or region-specific content instead of the expected data. These failures return HTTP 200, so they pass basic success/failure checks undetected.
  </Accordion>

  <Accordion title="Is self-hosted scraping infrastructure still viable in 2026?">
    Yes, for the right targets. Sites with minimal anti-bot protection, stable DOM structures, and static content are still cost-effective to scrape with self-hosted tools. The challenge is that the number of such sites is shrinking. A hybrid approach (self-hosted for easy targets, managed services for difficult ones) is the most common production pattern.
  </Accordion>
</AccordionGroup>


# How to reduce web scraping costs
Source: https://docs.brightdata.com/concepts/reducing-scraping-costs

Cut web scraping costs at four layers: IP type selection, request optimization, bandwidth reduction and service plan structure. Includes a cost checklist.

Your scraping pipeline works, but the monthly bill keeps climbing. Bandwidth charges, residential proxy usage, and server costs add up fast at scale.

Most of that spend is avoidable. This guide walks through practical techniques to cut costs at every layer: IP selection, request optimization, bandwidth reduction, and service plan structure.

<iframe title="How to save money on data collection" />

## Start with the cheapest IP type that works

The single biggest cost lever in web scraping is IP type. Datacenter IPs are significantly cheaper per gigabyte than residential or mobile IPs, yet many teams default to residential when datacenter would work fine.

Think of it like shipping: you don't overnight everything just because it's easier. You start with ground shipping and only upgrade when the delivery window demands it.

| IP type | Relative cost | Best for |
| - | - | - |
| **Datacenter** | Lowest | Sites without advanced anti-bot systems |
| **ISP** | Medium | Sites that need residential-grade trust at datacenter speed |
| **Residential** | Higher | Sites with Cloudflare, Akamai, or PerimeterX protection |
| **Mobile** | Highest | Heavily protected targets that block all other IP types |

**Rule of thumb:** start with datacenter IPs. Only move up the cost ladder when you've confirmed they won't work for your target.

### How to test if a site works with datacenter IPs

Before writing any code, test manually in a browser:

1. Configure your browser (Firefox works well) to route traffic through a datacenter proxy with a single sticky session
2. Navigate to the target URL
3. If the page loads normally, datacenter IPs can work for this site

If it loads in a browser through a datacenter proxy, you can make it work in code too. The key is making your requests look exactly like the browser's.

### Making datacenter IPs work with headers and cookies

A bare HTTP request with no headers or cookies won't work on most sites, even with a clean datacenter IP. But adding the right headers and cookies often gets you to near-perfect success rates.

Here's a real example scraping an Amazon product page with datacenter IPs:

```javascript Node.js theme={null}
const axios = require("axios");

const TARGET_URL = "https://www.amazon.com/dp/B0EXAMPLE";

// Without headers/cookies: ~10% success rate
const bareRequest = await axios.get(TARGET_URL, {
  proxy: { host: "datacenter-proxy", port: 8080 },
});

// With headers and cookies: ~100% success rate
const optimizedRequest = await axios.get(TARGET_URL, {
  proxy: { host: "datacenter-proxy", port: 8080 },
  headers: {
    "User-Agent":
      "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    Accept:
      "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
    "Accept-Language": "en-US,en;q=0.5",
    "Accept-Encoding": "gzip, deflate, br",
    Connection: "keep-alive",
    "Upgrade-Insecure-Requests": "1",
    Cookie: "session-id=123-4567890; i18n-prefs=USD; sp-cdn=L5Z9:US",
  },
});
```

The difference is dramatic: 10% success rate jumps to nearly 100% just by mimicking what a real browser sends.

**Where to find the right headers and cookies:**

1. Open the target site in a browser routed through your datacenter proxy
2. Open DevTools (F12) and go to the **Network** tab
3. Reload the page and click the main document request
4. Copy the **Request Headers** section
5. Use those exact headers in your scraping code

<Tip>
  Headers and cookies don't change often. You can automate the refresh by loading the target domain once in a headless browser, extracting cookies and headers, then reusing them for hundreds of HTTP client requests.
</Tip>

## Use a browser only when an HTTP client isn't enough

There are two ways to fetch a web page through a proxy:

* **HTTP client** (axios, Python `requests`, cURL): sends a single request and downloads just the HTML. Fast, lightweight, and cheap. Everything in the previous section uses this approach.
* **Browser automation** (Puppeteer, Playwright, Selenium): launches a full browser that renders JavaScript, loads images, stylesheets, and every other resource on the page. Much heavier on bandwidth.

Both go through your proxy. The difference is cost: an HTTP client downloads \~500 KB of HTML, while a browser loads 20+ MB of resources for the same page. Use this decision tree to pick the right approach:

```text theme={null}
Can an HTTP client (with headers/cookies) get the data?
├── Yes → Use an HTTP client (cheapest, fastest)
└── No → Does the site need JavaScript rendering?
    ├── Yes → Use browser automation
    └── No → Check if you're missing headers, cookies, or TLS fingerprint
```

When you do need a browser, use a real Chrome binary instead of Chromium. Anti-bot systems fingerprint browser builds, and Chromium screams "automation."

```javascript Node.js (Puppeteer) theme={null}
const puppeteer = require("puppeteer-extra");
const StealthPlugin = require("puppeteer-extra-plugin-stealth");

puppeteer.use(StealthPlugin());

const browser = await puppeteer.launch({
  executablePath: "/usr/bin/google-chrome", // Real Chrome, not Chromium
  headless: "new",
  args: ["--no-sandbox"],
});

const page = await browser.newPage();

// Set realistic headers
await page.setExtraHTTPHeaders({
  "Accept-Language": "en-US,en;q=0.9",
});

await page.goto("https://www.amazon.com/dp/B0EXAMPLE", {
  waitUntil: "domcontentloaded",
});
```

This swap alone can eliminate CAPTCHAs on many sites that would otherwise block your scraper.

<Note>
  If you don't want to manage browsers at all, [Bright Data Browser API](/products/scraping-browser/introduction) runs real GUI browsers in the cloud with all anti-blocking built in. You connect via Puppeteer or Playwright and we handle the infrastructure.
</Note>

## Reduce bandwidth when using browsers

A single Amazon product page loads over 20 MB of resources. If you only need text data like titles, prices, and descriptions, most of that bandwidth is wasted money.

### Block unnecessary resource types

Intercept network requests and abort anything you don't need:

```javascript Node.js (Puppeteer) theme={null}
await page.setRequestInterception(true);

page.on("request", (request) => {
  const resourceType = request.resourceType();

  // Block images, stylesheets, fonts, and media
  if (["image", "stylesheet", "font", "media"].includes(resourceType)) {
    request.abort();
  } else {
    request.continue();
  }
});

await page.goto("https://www.amazon.com/dp/B0EXAMPLE");
```

Blocking images alone cuts page load bandwidth by 50% or more. Adding stylesheets and fonts to the block list reduces it further.

### Block requests by domain

Many pages load third-party scripts (analytics, social widgets, ad networks) that contribute nothing to the data you need:

```javascript Node.js (Puppeteer) theme={null}
const BLOCKED_DOMAINS = [
  "google-analytics.com",
  "facebook.net",
  "doubleclick.net",
  "adservice.google.com",
];

page.on("request", (request) => {
  const url = request.url();
  if (BLOCKED_DOMAINS.some((domain) => url.includes(domain))) {
    request.abort();
  } else {
    request.continue();
  }
});
```

<Warning>
  Test blocking carefully. Some JavaScript files are required for the page to render your target data. Start by blocking images and obvious third-party domains, then expand the block list incrementally. If the site breaks, step back.
</Warning>

### Stop loading once you have the data

You don't need to wait for the full page to finish loading. Wait for the specific elements you need, then stop:

```javascript Node.js (Puppeteer) theme={null}
await page.goto("https://www.amazon.com/dp/B0EXAMPLE", {
  waitUntil: "domcontentloaded", // Don't wait for all resources
});

// Wait only for the elements you need
await page.waitForSelector("#productTitle");
await page.waitForSelector(".a-price .a-offscreen");

// Extract data immediately
const title = await page.$eval("#productTitle", (el) => el.textContent.trim());
const price = await page.$eval(".a-price .a-offscreen", (el) =>
  el.textContent.trim()
);

// Close the page before remaining resources finish loading
await page.close();
```

This can reduce bandwidth from 20+ MB down to under 2 MB per page while still capturing everything you need.

## Navigate directly to the data

Every extra page navigation costs bandwidth and time. Build the shortest path to the data you need.

**Longer path (3 navigations):**

1. Search for "Xbox" on Amazon
2. Click on the first product result
3. Click "See all reviews"

**Shorter path (1 navigation):**
Navigate directly to `https://www.amazon.com/product-reviews/B0EXAMPLE` by substituting the product ID into the reviews URL.

Most sites have predictable URL patterns for product pages, review pages, and search results. Reverse-engineer the URL structure and skip the clicks entirely.

## Mix HTTP client and browser methods

Some sites require a browser session to generate authentication tokens, but the actual data pages work fine with an HTTP client. You can combine both approaches to get the best of each:

1. **Load one page in a headless browser** to collect session cookies and authentication tokens
2. **Extract the cookies** from the browser session
3. **Use those cookies with your HTTP client** for all subsequent pages

```javascript Node.js theme={null}
// Step 1: Get auth cookies from one browser session
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto("https://target-site.com/search?q=product");

// Step 2: Extract cookies
const cookies = await page.cookies();
const cookieString = cookies.map((c) => `${c.name}=${c.value}`).join("; ");
await browser.close();

// Step 3: Use cookies for fast HTTP requests (no browser needed)
const productUrls = [
  "https://target-site.com/product/123",
  "https://target-site.com/product/456",
  "https://target-site.com/product/789",
];

for (const url of productUrls) {
  const response = await axios.get(url, {
    headers: {
      Cookie: cookieString,
      "User-Agent": "Mozilla/5.0 ...",
    },
    proxy: { host: "datacenter-proxy", port: 8080 },
  });
  // Parse response.data
}
```

This pattern uses heavy browser bandwidth for a single page load, then switches to lightweight HTTP client requests for hundreds of data pages. At scale, the cost difference is significant.

## Choose the right data collection approach

Before optimizing individual requests, consider whether you should be building scrapers at all.

| Approach | What you manage | Best for |
| - | - | - |
| **In-house** | Everything: proxies, unlocking, parsing, storage, servers, engineering team | Companies where data collection IS the core business |
| **Hybrid** | Parsing and storage; a service handles unlocking and IP rotation | Teams that want control over data processing but not infrastructure |
| **Data as a service** | Analysis only; you buy structured data from a provider | Teams whose core business is analyzing data, not collecting it |

**In-house** requires multiple engineering teams and ongoing infrastructure. Unless data collection is your core product, this approach is rarely cost-effective.

**Hybrid** removes the biggest time sink: fighting anti-bot systems. With [Bright Data Web Unlocker](/products/web-unlocker/introduction), you send a URL and we return clean HTML. All five detection layers (IP rotation, TLS fingerprinting, browser fingerprinting, behavioral emulation, and CAPTCHA solving) are handled in a single API call. Your developers focus on parsing and data quality instead of reverse-engineering blocking mechanisms.

**Data as a service** eliminates the scraping pipeline entirely. [Bright Data Web Scraper API](/products/scrapers/overview) provides thousands of pre-built scrapers that return structured JSON, no selectors, no proxy configuration, no maintenance. If your core business is machine learning, analytics, or market intelligence, this is often the biggest cost saver of all.

<Tip>
  Not sure which approach fits? See our detailed comparison in [Scraper API vs DIY scraping](/concepts/web-scraper-api-vs-diy).
</Tip>

## Optimize your service plan

Technical optimizations reduce per-request costs. Service plan optimization reduces the price you pay for each gigabyte or request.

**Choose the right pricing model.** Some providers charge per gigabyte of bandwidth, others per request. A single browser-loaded product page can weigh 20+ MB of bandwidth but counts as one request. Compare both models against your actual usage pattern.

**Commit to a monthly plan.** Pay-as-you-go rates are the highest tier. Even a small monthly commitment can cut per-unit costs by 50% or more. If a large commitment feels risky, start smaller. The savings still outweigh pay-as-you-go.

**Consolidate with one provider.** Splitting volume across multiple providers means you get worse pricing from both. Bringing all your volume to one provider unlocks higher-tier discounts.

<Accordion title="Real-world example: consolidating providers">
  A company split traffic 50/50 between two proxy providers, paying a combined \$31,000 per month. By moving 90% of traffic to a single provider (keeping 10% as backup), the total bill dropped to \$24,000 per month. That's \$84,000 in annual savings from consolidation alone, with no code changes.
</Accordion>

## Cost optimization checklist

Use this checklist to audit your current scraping setup:

* [ ] Are you using datacenter IPs where possible, or defaulting to residential?
* [ ] Have you tested your target sites with datacenter IPs in a real browser?
* [ ] Are you sending proper headers and cookies with your HTTP client?
* [ ] If using a browser, are you blocking images and unnecessary resource types?
* [ ] Are you blocking third-party domains that don't contribute to your data?
* [ ] Are you stopping page loads once target elements are present?
* [ ] Are you navigating directly to data URLs instead of clicking through multiple pages?
* [ ] Can you use a browser for authentication and an HTTP client for data pages?
* [ ] Is your pricing model (bandwidth vs. per-request) optimal for your usage pattern?
* [ ] Are you on a monthly plan instead of pay-as-you-go?
* [ ] Have you consolidated proxy volume with a single provider for better tier pricing?

## Verify your optimizations

After applying these techniques, measure the impact:

1. **Compare bandwidth per request.** Log the response size before and after blocking resources. If you went from 20 MB to 5 MB per page, you've cut costs by 75%.
2. **Track success rates.** Send 10-20 test requests with your optimized headers and cookies. If success rate is below 90%, you're likely missing a required header or cookie.
3. **Monitor cost per record.** Divide your monthly proxy bill by the number of successful records collected. This is the metric that matters. Repeat after each optimization to confirm savings.

## Troubleshooting

**Datacenter IPs return CAPTCHAs or 403 errors even with headers and cookies.**
The site likely uses Cloudflare, Akamai, or a similar system that blocks all datacenter IP ranges. Switch to ISP or residential IPs, or use [Bright Data Web Unlocker](/products/web-unlocker/introduction). We handle detection automatically so you don't have to debug it.

**Blocking resources breaks the page and target data is missing.**
You blocked a JavaScript file that the page needs to render the data. Roll back to the last working block list and re-add resources one type at a time. Always block images first (safest), then expand incrementally.

**Cookies expire and success rate drops after a few hours.**
Set up a cron job or scheduled task that loads the target domain in a headless browser, extracts fresh cookies, and stores them for your HTTP requests.

## FAQs

<AccordionGroup>
  <Accordion title="Which sites work with datacenter IPs?">
    Many sites work with datacenter IPs when you send proper headers and cookies. To test, route your browser through a datacenter proxy and try loading the target page. If it loads, you can make it work in code. Sites with Cloudflare, Akamai, or PerimeterX set to block all datacenter IPs will require residential or ISP proxies.
  </Accordion>

  <Accordion title="How much bandwidth does blocking images save?">
    Blocking images typically reduces page load bandwidth by 50% or more. A product page that transfers 20 MB with all resources may drop to 7-8 MB with images blocked. Adding stylesheet and font blocking reduces it further.
  </Accordion>

  <Accordion title="How often do I need to refresh headers and cookies?">
    Headers rarely change. Cookies may expire depending on the site, but most session cookies last hours or days. You can automate the refresh by loading the target domain in a browser periodically and extracting fresh cookies for your HTTP requests.
  </Accordion>

  <Accordion title="Should I use Puppeteer, Playwright, or Selenium?">
    All three have equivalent data collection capabilities. Choose based on your team's language preference: Puppeteer for Node.js, Playwright for Node.js/Python/Java/.NET, Selenium for Python/Java. The cost optimization techniques in this guide apply to all of them.
  </Accordion>

  <Accordion title="What if I don't want to manage any of this?">
    If maintaining scrapers isn't your core business, consider [Bright Data Web Scraper API](/products/scrapers/overview). We maintain thousands of pre-built scrapers that return structured JSON. You get data without managing proxies, browsers, or anti-blocking. Pay-as-you-go pricing is \$1.50 per 1,000 delivered records.
  </Accordion>
</AccordionGroup>

## Further reading

* [How Bright Data handles anti-bot blocking](/concepts/how-bright-data-handles-blocking)
* [Scraper API vs DIY scraping](/concepts/web-scraper-api-vs-diy)
* [How to target API endpoints](/products/web-unlocker/target-api-endpoints)
* [Understanding sync vs. async requests](/concepts/sync-vs-async)


# Sync vs async requests
Source: https://docs.brightdata.com/concepts/sync-vs-async

How synchronous and asynchronous requests differ across the Bright Data Scraper API, Web Unlocker API and SERP API, when to use each, and what a job costs, returns and retains.

This page explains the one choice every Bright Data API asks you to make: wait for the result in the same HTTP response, or submit a job and collect the result later. It covers how the Scraper API, the Web Unlocker API and the SERP API each implement the two modes, when to pick which, and the tradeoffs.

## What sync and async requests are

A **synchronous** request holds the connection open until the result arrives, typically seconds. A single request gives you a single response, and there is nothing else to track.

An **asynchronous** request returns an ID at once and the work continues in the background. You retrieve the result later by polling or by having Bright Data push it to a webhook or storage. Nothing waits on an open connection, so you can submit thousands of jobs in a minute and process them when they are ready.

## How each API implements the two modes

| API | Synchronous | Asynchronous | Result retention |
| :- | :- | :- | :- |
| **Scraper API** | `POST /datasets/v3/scrape`, built for a handful of URLs; runs past 1 minute answer HTTP 202 with a `snapshot_id` | `POST /datasets/v3/trigger` returns a `snapshot_id`; poll it, or deliver to a webhook or storage. See [How to scrape in bulk with async requests](/products/scrapers/scrapers-library/async-requests) | 30 days |
| **Web Unlocker API** | The default request | An async zone returns an `x-response-id` header at once; retrieve by polling or by a `webhook_url`. See [Send your first async request](/products/web-unlocker/send-your-first-request#send-your-first-async-request) | 48 hours |
| **SERP API** | The default request | Same async zone mechanism as Web Unlocker API. See [Asynchronous requests](/products/serp-api/asynchronous-requests) | 48 hours |

## When to use each mode

**Use synchronous requests when:**

* You serve a live user who is waiting, such as a "check this product now" button or search results on screen.
* You need results in seconds for a small number of inputs. On the Scraper API that means a handful of URLs.
* You are prototyping and want the simplest possible integration.

**Use asynchronous requests when:**

* You run scheduled jobs: nightly competitor monitoring, weekly rank tracking.
* You scrape at volume, hundreds of requests per hour or more, or more URLs than fit one sync call.
* You run discovery on the Scraper API: searching by keyword, finding posts by company.
* You want results delivered to a webhook, S3, Snowflake or other storage.
* You are building a pipeline where freshness within minutes is fine and you want fewer retries.

<Warning>
  Do not use async for a feature where a person is actively waiting. Async latency is minutes at best and, on the Web Unlocker API and SERP API, up to 8 hours at peak times.
</Warning>

An e-commerce team scrapes 50,000 competitor prices overnight with async for the morning report, and uses sync for the button shoppers click to check one product.

## How the Scraper API flows

Synchronous:

```text theme={null}
Your app --> POST /scrape --> [Wait up to 1 min] --> Scraped data in response
```

The whole operation is one HTTP request. If the scrape runs past 1 minute, the API answers HTTP 202 with a `snapshot_id` and finishes the job asynchronously; the data is still collected, you retrieve it as you would an async job. Code that calls `/scrape` must branch on the status code. The branch and the polling loop are in [How to handle a 202 response](/api-reference/scrapers/synchronous-requests#how-to-handle-a-202-response).

Asynchronous:

```text theme={null}
Your app --> POST /trigger --> snapshot_id (immediate)
                                    |
                     +--------------+--------------+
                     |              |              |
                  Poll API      Webhook      S3/Storage
                     |              |              |
                  GET /snapshot  POST to URL   File in bucket
```

Three ways to get the results: poll `GET /datasets/v3/progress/{snapshot_id}` and download with `GET /datasets/v3/snapshot/{snapshot_id}`; pass `endpoint` on the trigger so Bright Data POSTs the records to your URL; or set a storage destination so the file lands in your bucket. Delivery destinations are listed in [How to deliver results](/products/scrapers/scrapers-library/data-delivery).

## How the Web Unlocker API and SERP API flow

<img alt="An async request returns an x-response-id at once; the result is retrieved later by polling or delivered by webhook" />

The request returns an `x-response-id` header immediately. You are billed for the submission, not for retrieving the result, and the result is stored for 48 hours. Polling before the job completes returns a `202`. Configure a `webhook_url` per request or in the zone settings and Bright Data POSTs a notification when the result is ready, from the IPs `100.27.150.189` and `18.214.10.85`; allowlist them or your firewall may drop the call. A zone is either sync or async, so keep one zone of each if you need both.

<Warning>
  On the SERP API each poll is metered. Use webhooks, or poll no more than once a minute.
</Warning>

## What the tradeoffs are

| | Sync | Async |
| :- | :- | :- |
| **Latency** | Seconds | Minutes to hours |
| **Connection handling** | Holds a connection per request | No open connections |
| **Implementation** | One request, one response | Webhook or polling logic |
| **Volume** | Limited by open connections | Thousands of jobs a minute |
| **Cost** | Per successful record or request | The same; retrieval is free |

## Common misconceptions

### Async is always faster than sync

For a few inputs, sync is faster: there is no queue step before the scrape begins. Use sync for small real-time lookups.

### Sync requests fail if they take too long

They do not fail. On the Scraper API a sync request that passes 1 minute answers HTTP 202 with a `snapshot_id` and the job continues; on the Web Unlocker API and SERP API a sync request holds the connection until the result arrives.

## Common questions

### Can I mix sync and async in the same application?

Yes. Most applications use sync for user-facing lookups and async for batch jobs. On the Web Unlocker API and SERP API that means one sync zone and one async zone.

### Is there a cost difference between sync and async?

No. Pricing is per successful record on the Scraper API and per request on the Web Unlocker API and SERP API, whichever mode you use. Retrieving an async result is free.

### What happens if my webhook is down when the results are ready?

The Scraper API retries webhook delivery when your endpoint returns a non-200 status or times out. For guaranteed delivery, use a storage destination instead.

### What if I lose a response ID or snapshot ID?

A Web Unlocker API or SERP API response ID cannot be recovered, so store it with the request metadata when you submit. Scraper API snapshot IDs are listed by [Get snapshots](/api-reference/scrapers/management-apis/get-snapshots) for 30 days.

## Next steps

<CardGroup>
  <Card title="Scrape in bulk with async requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Trigger, monitor and download a Scraper API batch job.
  </Card>

  <Card title="Deliver results" icon="truck" href="/products/scrapers/scrapers-library/data-delivery">
    Webhook, S3, Google Cloud, Azure, SFTP and Snowflake.
  </Card>

  <Card title="SERP API async requests" icon="magnifying-glass" href="/products/serp-api/asynchronous-requests">
    Async zones, polling and webhook IPs for search results.
  </Card>

  <Card title="Web Unlocker API async request" icon="unlock" href="/products/web-unlocker/send-your-first-request#send-your-first-async-request">
    The async form of the unlocker request.
  </Card>
</CardGroup>


# Scraper API vs DIY scraping
Source: https://docs.brightdata.com/concepts/web-scraper-api-vs-diy

Compare Bright Data Scraper API (thousands of pre-built scrapers) with DIY scraping (proxies + custom code) to decide which approach fits your use case.

Every scraping project starts the same way: write a parser, add proxy rotation, deploy. It works until the target site changes its DOM, adds a CAPTCHA, or starts fingerprinting headless browsers. Then you're maintaining scrapers instead of using the data.

This guide compares the DIY approach (proxies + custom code) with Bright Data Scraper API (thousands of pre-built, maintained scrapers), so you can decide which fits your use case.

## What is DIY scraping?

DIY scraping means you build and maintain the entire pipeline yourself:

* A scraper (BeautifulSoup, Playwright, Puppeteer, Scrapy)
* A proxy layer for IP rotation
* Retry and error-handling logic
* A scheduler to run jobs on a recurring basis

This gives you full control. You choose your selectors and handle edge cases your way.

The tradeoff is maintenance. Every target site becomes a separate codebase that breaks independently when the site changes its DOM, adds anti-bot measures, or starts fingerprinting headless browsers.

## What is Bright Data Scraper API?

Bright Data Scraper API is a collection of [thousands of pre-built scrapers](https://brightdata.com/cp/scrapers/browse) maintained by Bright Data's engineering team, covering top sites including LinkedIn, Amazon, Instagram, YouTube, TikTok, Google Maps, and many more. You send a URL, you get structured JSON back, no parsing, no selectors, no proxy configuration.

Each scraper returns a typed record. On September 6, 2026 a LinkedIn profile record carried 34 top-level fields and an Amazon product record 94, covering details like seller lists, map coordinates and structured metadata that most DIY scrapers miss.

If your target site isn't covered, you can build a custom scraper in minutes using [Bright Data Scraper Studio](/products/scraper-studio/introduction): just pass a URL and a plain-language description of the data you need. When a site changes its frontend and breaks your scraper, the [Self-healing tool](/products/scraper-studio/self-healing-tool) rewrites the affected code based on a prompt, so you don't need to dig into the script manually.

## The same scrape, two ways

Here's what scraping an Amazon product page looks like with each approach.

**DIY with Playwright**: you write and maintain every selector:

```python Python theme={null}
from playwright.sync_api import sync_playwright

def scrape_amazon_product(url: str, proxy: str) -> dict:
    with sync_playwright() as p:
        browser = p.chromium.launch(proxy={"server": proxy})
        page = browser.new_page()
        page.goto(url, wait_until="domcontentloaded")

        title = page.query_selector("#productTitle").inner_text().strip()
        price = page.query_selector(".a-price .a-offscreen").inner_text()
        rating = page.query_selector("#acrPopover span").inner_text()

        browser.close()
        return {"title": title, "price": price, "rating": rating}
```

<Warning>
  Those CSS selectors (`#productTitle`, `.a-price .a-offscreen`) break whenever Amazon updates their frontend. When that happens, your scraper silently returns wrong data or crashes.
</Warning>

**Scraper API**: one API call, structured output:

```bash cURL theme={null}
curl "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0EXAMPLE"}]'
```

```json Response theme={null}
{
  "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
  "currency": "USD",
  "rating": 4.4,
  "reviews_count": 14779,
  "availability": "In Stock",
  "seller_name": "Amazon.com",
  "brand": "Apple",
  "description": "About this item WORLD’S BEST IN-EAR ACTIVE NOISE CANCELLATION — Removes up to 2x more unwanted noise than AirPods Pro 2* so you can stay fully immersed in th...",
  "initial_price": 249,
  "parent_asin": "B0FQFB8FMG"
}
```

<Tip>
  Find the `dataset_id` for your target site in the [scraper library](/products/scrapers/overview). Each site has its own ID.
</Tip>

## How DIY and Scraper API compare

| | DIY (proxies + custom code) | Scraper API |
| - | - | - |
| **Scraping logic** | You write and maintain selectors | Pre-built for each site |
| **Anti-bot handling** | You manage CAPTCHAs, fingerprinting, stealth | Automatic |
| **When sites change** | You debug and redeploy | Bright Data updates the scraper |
| **Output format** | Raw HTML you parse into structured data | Structured JSON/CSV with named fields |
| **Data fields** | Only what you code selectors for | 11 to 94 top-level fields per record depending on the scraper (captured September 6, 2026) |
| **Time to first result** | Hours to days | Minutes |
| **Ongoing maintenance** | You, indefinitely | Bright Data's scraper team |
| **Success rate** | Typically 60–85% depending on anti-bot investment | [98.44% average](https://brightdata.com/blog/web-data/best-web-scraping-apis) |
| **Supported sites** | Any site you can write a parser for | [thousands of pre-built](https://brightdata.com/cp/scrapers/browse); custom via Scraper Studio |

## Which sites are supported

The [scraper library](/products/scrapers/overview) includes ready-made scrapers across categories:

| Category | Example sites |
| - | - |
| **E-commerce** | Amazon, Walmart, eBay, Shopify |
| **Social media** | LinkedIn, Instagram, TikTok, X, Facebook |
| **Search engines** | Google, Bing, Yahoo, DuckDuckGo |
| **Real estate** | Zillow, Realtor, Redfin |
| **Travel** | Booking.com, Tripadvisor, Airbnb |
| **Jobs & B2B** | Indeed, Glassdoor, Crunchbase |

If your target isn't in the library, [Bright Data Scraper Studio](/products/scraper-studio/ai-agent) can generate a custom scraper from a URL and a natural language description of the data you need.

## Sync vs async collection

The Scraper API has two endpoints: `/scrape` returns results in the same response and is built for a handful of URLs, and `/trigger` runs a batch job and returns a `snapshot_id` to poll or deliver. A `/scrape` request that runs past 1 minute answers HTTP 202 with a `snapshot_id` and continues as a job. See [Understanding sync vs. async requests](/concepts/sync-vs-async) for the comparison and [Scraper API limits](/products/scrapers/limits) for the numbers.

## When to use what

| If you need... | Use | You write code? | You maintain scrapers? |
| - | - | - | - |
| Structured data from popular sites | **Scraper API** | API calls only | No |
| Raw HTML from any site (custom parsing) | **[Web Unlocker API](/products/web-unlocker/target-api-endpoints)** | Yes | Yes |
| JS-heavy pages (clicks, scrolls, forms) | **[Bright Data Browser API](/products/scraping-browser/introduction)** | Yes (Playwright/Puppeteer) | Yes |
| Full control over your existing stack | **[Proxies](/products/residential/introduction)** | Yes (everything) | Yes |

## Limitations and tradeoffs

**Predefined data fields.** Each pre-built scraper returns a typed record, 11 to 94 top-level fields depending on the scraper when captured on September 6, 2026, which covers most use cases. If you need a field that isn't included, you can use [Bright Data Scraper Studio](/products/scraper-studio/ai-agent) to customize the scraper's output or fall back to [Web Unlocker API](/products/web-unlocker/target-api-endpoints) for raw HTML.

**Latency.** Sync scrapes typically return in seconds, but complex sites may take longer than 1 minute and answer HTTP 202 with a `snapshot_id`. If you need sub-second responses, you may want to cache results or use pre-scraped [Datasets](https://brightdata.com/products/datasets).

## FAQs

### How much does Scraper API cost?

As of September 2026, pay-as-you-go pricing is \$1.50 per 1,000 delivered records, and failed deliveries are not charged. New accounts get 5,000 free credits per month (no credit card required), plus a matched deposit of up to \$500. See the [pricing page](https://brightdata.com/pricing/web-scraper) and [free tier](/general/account/billing-and-pricing/free-tier) for full details.

### Can I use Scraper API with Python, Node.js, or other languages?

Yes. Scraper API is a standard REST API, so any language that can make HTTP requests works. Bright Data also provides an official [Python SDK](/api-reference/SDK) and a [CLI tool](/products/cli/overview) for terminal-based workflows. See the [Quickstart guide](/products/scrapers/overview#your-first-request) for examples.

### What output formats does Scraper API support?

NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)). Results can be delivered via webhook (up to 1 GB), API download (up to 5 GB), or pushed to external storage (S3, Google Cloud, Snowflake).

### Should I use Scraper API or Web Unlocker API?

Use **Scraper API** when you want structured data from a supported site with zero scraper maintenance. Use **[Web Unlocker API](/products/web-unlocker/target-api-endpoints)** when you need raw HTML from any site and want to write your own custom parsing logic. Web Unlocker API handles anti-bot bypass but returns HTML, not structured fields.

### Does Scraper API work for AI and LLM training pipelines?

Yes. The structured JSON output is directly ingestable by AI pipelines without HTML cleaning or parsing. Bright Data also offers integration with MCP servers, LlamaIndex, Google ADK, Dify, and many more.

### Is web scraping with Bright Data compliant and ethical?

Bright Data operates under strict compliance standards. All scrapers collect only publicly available data. See the [Trust Center](https://brightdata.com/trustcenter) for their ethical web data collection policies, KYC process, and compliance framework.


# Bright Data documentation
Source: https://docs.brightdata.com/introduction

Guides, quickstarts and API references for Bright Data Scraper API, Scraper Studio, Web Unlocker API, SERP API, proxies, datasets and Bright Data MCP.

<div>
  <h1>Start building with live web data</h1>

  <p>
    Scrape any site, buy ready-made datasets. Thousands of pre-built scrapers, one API key.
  </p>

  <Prompt description="Read https://docs.brightdata.com/llms.txt and get me set up with Bright Data" icon="sparkles">
    Read [https://docs.brightdata.com/llms.txt](https://docs.brightdata.com/llms.txt) and get me set up with Bright Data
  </Prompt>

  <p>
    **5,000 free credits per month**, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).
  </p>

  <Columns>
    <Tile href="/quickstart" title="Quickstart" description="Scrape your first page and get structured JSON in three steps.">
      <img alt="Quickstart" />
    </Tile>

    <Tile href="/quickstart-coding-agent" title="You're an agent? Start here" description="llms.txt, skills and MCP tools for AI readers.">
      <img alt="Agent resources" />
    </Tile>

    <Tile href="/products" title="All products" description="Data extraction, web search, AI training data and proxy networks.">
      <img alt="Product catalog" />
    </Tile>

    <Tile href="/api-reference/authentication" title="API reference" description="Authentication, endpoints, SDKs and the CLI.">
      <img alt="API reference" />
    </Tile>
  </Columns>

  ## Browse by product

  <div>
    <div>
      <div>
        <h3>Data extraction</h3>
        <p>Extract structured data, unblock pages and collect search results.</p>
      </div>

      <div>
        <a href="/products/scrapers/overview"><Icon icon="spider" /><span><span>Scraper API</span><span>Structured data from thousands of sites</span></span></a>
        <a href="/products/scraper-studio/overview"><Icon icon="code" /><span><span>Scraper Studio</span><span>Build and host custom scrapers</span></span></a>
        <a href="/left-over/marketplace-overview"><Icon icon="store" /><span><span>Dataset Marketplace</span><span>Ready-made datasets, 250+ domains</span></span></a>
        <a href="/products/web-unlocker/introduction"><Icon icon="unlock" /><span><span>Web Unlocker API</span><span>Unblock any protected page</span></span></a>
        <a href="/products/scraping-browser/introduction"><Icon icon="window-maximize" /><span><span>Browser API</span><span>Remote browsers for automation</span></span></a>
        <a href="/products/serp-api/introduction"><Icon icon="magnifying-glass" /><span><span>SERP API</span><span>Search results as structured JSON</span></span></a>
        <a href="https://brightdata.com/pricing/managed-services"><Icon icon="user-gear" /><span><span>Managed services</span><span>Done-for-you data collection</span></span></a>
      </div>
    </div>

    <div>
      <div>
        <h3>Web search</h3>
        <p>Search records and the live web by API.</p>
      </div>

      <div>
        <a href="/products/business-search/introduction"><Icon icon="magnifying-glass-chart" /><span><span>Business Search</span><span>Find people and companies by criteria</span></span></a>
      </div>
    </div>

    <div>
      <div>
        <h3>AI training data</h3>
        <p>Media and archived pages for model training.</p>
      </div>

      <div>
        <a href="/datasets/media-data-api"><Icon icon="photo-film" /><span><span>Media Data API</span><span>Video, audio and captions at scale</span></span></a>
        <a href="/products/archive/overview"><Icon icon="box-archive" /><span><span>Web Archive</span><span>Cached web page snapshots</span></span></a>
      </div>
    </div>

    <div>
      <div>
        <h3>Proxy networks</h3>
        <p>Five network types for routing traffic at scale.</p>
      </div>

      <div>
        <a href="/products/residential/introduction"><Icon icon="globe" /><span><span>Residential proxies</span><span>400M+ real-user IPs</span></span></a>
        <a href="/products/data-center/introduction"><Icon icon="server" /><span><span>Datacenter proxies</span><span>Fast, low-cost IPs</span></span></a>
        <a href="/products/isp/introduction"><Icon icon="network-wired" /><span><span>ISP proxies</span><span>Static residential-grade IPs</span></span></a>
        <a href="/products/proxy-manager/introduction"><Icon icon="sliders" /><span><span>Proxy Manager</span><span>Open-source proxy routing</span></span></a>
        <a href="/left-over/browser-extension/introduction"><Icon icon="puzzle-piece" /><span><span>Browser Extension</span><span>Proxies in Chrome</span></span></a>
      </div>
    </div>

    <div>
      <div>
        <h3>AI tools</h3>
        <p>Tools that connect agents to the live web.</p>
      </div>

      <div>
        <a href="/products/mcp-server/overview"><Icon icon="microchip-ai" /><span><span>Bright Data MCP</span><span>Live web access for agents</span></span></a>
        <a href="/api-reference/SDK"><Icon icon="cubes" /><span><span>SDKs</span><span>Python and JavaScript clients</span></span></a>
        <a href="/products/cli/overview"><Icon icon="terminal" /><span><span>Bright Data CLI</span><span>The platform from your terminal</span></span></a>
      </div>
    </div>
  </div>

  ## Set up your AI tools

  Connect Bright Data to the tool you already use. Each command is the same one documented in its [MCP integration guide](/products/mcp-server/integrations/overview).

  <CodeGroup>
    ```bash Claude Code theme={null}
    claude mcp add --transport sse brightdata "https://mcp.brightdata.com/sse?token=YOUR_API_KEY"
    ```

    ```json Cursor theme={null}
    {
      "mcpServers": {
        "brightdata-mcp": {
          "command": "npx",
          "args": ["-y", "@brightdata/mcp"],
          "env": {
            "API_TOKEN": "<your API token>"
          }
        }
      }
    }
    ```

    ```bash Codex CLI theme={null}
    codex mcp add brightdata --env API_TOKEN=YOUR_API_KEY -- npx -y @brightdata/mcp
    ```

    ```bash Bright Data CLI theme={null}
    npx -p @brightdata/cli brightdata --version
    ```
  </CodeGroup>

  ## Send your first request

  Each example scrapes a LinkedIn profile with the Scraper API and works as-is after you replace `YOUR_API_KEY` with a key from your [account settings](https://brightdata.com/cp/setting/users). See [authentication](/api-reference/authentication) for how API keys work across all products.

  <CodeGroup>
    ```bash cURL theme={null}
    curl -X POST \
      "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
    ```

    ```python Python theme={null}
    import requests

    response = requests.post(
        "https://api.brightdata.com/datasets/v3/scrape",
        params={"dataset_id": "gd_l1viktl72bvl7bjuj0", "format": "json"},
        headers={
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
        },
        json=[{"url": "https://www.linkedin.com/in/satyanadella"}],
    )

    print(response.json())
    ```

    ```javascript Node.js theme={null}
    const response = await fetch(
      "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
      {
        method: "POST",
        headers: {
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
        },
        body: JSON.stringify([
          { url: "https://www.linkedin.com/in/satyanadella" }
        ]),
      }
    );

    const data = await response.json();
    console.log(data);
    ```
  </CodeGroup>

  The same request pattern works for every scraper: swap the dataset ID and input URL. See the [Instagram](/products/scrapers/instagram/quickstart) and [SERP API](/products/serp-api/quickstart) quickstarts for the next targets.

  <div>
    <a href="https://brightdata.com/network-status">Service status</a>
    <a href="https://help.brightdata.com/hc/en-us/requests/new">Contact support</a>
    <a href="/release-notes">Release notes</a>
    <a href="https://docs.brightdata.com/llms.txt">llms.txt for agents</a>
  </div>
</div>


# How to select the best product
Source: https://docs.brightdata.com/product-selector

Describe your goal and get the right Bright Data product: Web Scraper API, Scraper Studio, Web Unlocker API, SERP API, Browser API or proxies.

This guide helps you pick the right Bright Data product for your goal. For most data collection tasks, start with the [Web Scraper API](/products/scrapers/overview)'s thousands of pre-built scrapers and use [Scraper Studio](/products/scraper-studio/overview) when no pre-built scraper covers your target site.

## Which quickstart should I start with?

Find your goal in the table, then go straight to that product's first request. Each page below ends with a runnable request and the response it returns.

| Your goal | Product | Send your first request |
| :- | :- | :- |
| Structured data from a popular site like LinkedIn, Amazon or TikTok | Web Scraper API | [LinkedIn quickstart](/products/scrapers/linkedin/quickstart), one of thousands of scrapers |
| Structured data from a site with no pre-built scraper | Scraper Studio | [Scraper Studio quickstart](/products/scraper-studio/quickstart) |
| Results from Google, Bing or Yandex | SERP API | [Send your first SERP API request](/products/serp-api/send-your-first-request) |
| Raw HTML from a protected page | Web Unlocker API | [Send your first Web Unlocker request](/products/web-unlocker/send-your-first-request) |
| Clicks, forms and screenshots with Playwright or Puppeteer | Browser API | [Run your first browser session](/products/scraping-browser/five-minute-how-to) |
| Traffic routed through a specific IP type | Residential, ISP or Datacenter proxies | [Send your first Residential proxy request](/products/residential/send-your-first-request) |

The SERP API, Web Unlocker API, Browser API and proxy networks each need a zone before the first request. Each page above links its zone setup step.

The rest of this page explains when each product is the right choice.

## Use cases

* Structured data from a popular site: getting profiles, posts, products or reviews from sites like LinkedIn, Amazon, Instagram or TikTok. The correct product is the [Web Scraper API](/products/scrapers/overview).
* Structured data from any other site: collecting structured data from a site that has no pre-built scraper. The correct product is [Scraper Studio](/products/scraper-studio/overview).
* Search engine data: getting results from search engines like Google, Bing, Yandex. Results from the search engine can be ads, hotels, trends, flights or search results. The correct product is the [SERP API](/products/serp-api/introduction).

## Which product to choose

The following is a list of products with a description of when it makes sense to use them.

### When to use the Web Scraper API

The [Web Scraper API](/products/scrapers/overview) is the default choice for structured data collection. It is most suitable when:

* the target is a popular site covered by one of the pre-built scrapers, including LinkedIn, Amazon, Instagram, TikTok, Facebook, X (Twitter), YouTube, Reddit, Google and ChatGPT
* structured JSON output is needed rather than raw HTML
* Bright Data should handle proxies, unblocking and scraper maintenance

Browse the [Scrapers Library](/products/scrapers/overview) to check whether a pre-built scraper exists for your target site.

### When to use Scraper Studio

[Scraper Studio](/products/scraper-studio/overview) is the choice when the target site has no pre-built scraper. It is most suitable when:

* you want to build a custom scraper from a natural-language prompt with the [AI Agent](/products/scraper-studio/ai-agent), or write one in the JavaScript IDE
* the scraper should keep working when the target site changes, using the [Self-Healing tool](/products/scraper-studio/self-healing-tool)
* you want Bright Data to host and run the scraper, with no infrastructure to maintain

### When to use the SERP API

The [SERP API](/products/serp-api/introduction) is most suitable when you need structured results from search engines like Google, Bing, Yandex or DuckDuckGo, including ads, hotels, trends, flights and organic listings.

### When to use the Web Unlocker API

The [Web Unlocker API](/products/web-unlocker/introduction) is most suitable when:

* you need to simply GET HTML pages, without doing any interactions on the page. Just download HTML content for given URLs.
* the page has CAPTCHA and CAPTCHA needs to be solved in order to enter the website
* custom cookies or fingerprints are needed in order to unblock the page

If you have these needs, the Web Unlocker API is usually the best fit.

### When to use the Browser API

The [Browser API](/products/scraping-browser/introduction) is most suitable when:

* you are using tools like Puppeteer, Playwright or Selenium. In that case, you can easily adjust existing code to use the Browser API.
* you need to take actions on the page, like clicking buttons, filling forms
* you want to take a screenshot of the website

If you have these needs, the Browser API is usually the best fit.

### When to use Residential proxies

[Residential proxies](/products/residential/introduction) route traffic through 400M+ real residential IPs across 195+ countries. They are most suitable for accessing sophisticated, highly protected sites that block datacenter and automated traffic, and for geo-targeted access as a real local user.

### When to use ISP proxies

[ISP proxies](/products/isp/introduction) combine residential trust with datacenter speed, using static residential-grade IPs. They are most suitable for ad verification, QA and bypassing datacenter blocks.

### When to use Datacenter proxies

[Datacenter proxies](/products/data-center/introduction) offer 1.6M+ IPs from 98+ countries and are the fastest and most cost-effective option. They are most suitable for high-volume collection from sites with light bot protection.

## Which domains need a dataset

* shopee.my, shopee.ph: these domains are available as a dataset. It is not possible to scrape these sites using proxies or the Web Unlocker API. The dataset is updated regularly on an ongoing basis. Browse the [Dataset Marketplace](/left-over/marketplace-overview).


# Bright Data CLI command reference
Source: https://docs.brightdata.com/products/cli/commands

Reference for every Bright Data CLI command across 4 areas (scrape, search, pipelines and config), with flags, global options and copy-paste examples.

## Global options

These flags work with any command:

| Flag | Description |
| - | - |
| `-k, --api-key <key>` | Override API key for this request |
| `--timing` | Show request timing info |
| `-v, --version` | Show CLI version |

***

## `brightdata login`

Authenticate with Bright Data. Opens the browser for OAuth by default.

| Flag | Description |
| - | - |
| `-k, --api-key <key>` | Use API key directly (skips browser) |
| `-c, --customer-id <id>` | Bright Data account ID (optional) |
| `-d, --device` | Use device flow for SSH/headless environments |
| `-g, --github` | Authenticate using the GitHub CLI token (`gh auth token`) |

```bash theme={null}
brightdata login                        # Browser OAuth (recommended)
brightdata login --device               # Headless/SSH environments
brightdata login --api-key <key>        # Direct API key
brightdata login --github               # Reuse the GitHub CLI token
```

<Tip>
  On first login, the CLI automatically creates `cli_unlocker` and `cli_browser` proxy zones and sets sensible defaults.
</Tip>

***

## `brightdata logout`

Clear stored credentials.

```bash theme={null}
brightdata logout
```

***

## `brightdata scrape <url>`

Scrape any URL using Bright Data's Web Unlocker. Handles CAPTCHAs, JavaScript rendering, and anti-bot protections automatically.

| Flag | Description |
| - | - |
| `-f, --format <fmt>` | `markdown` (default), `html`, `screenshot`, `json` |
| `--country <code>` | ISO country code for geo-targeting (e.g. `us`, `de`, `jp`) |
| `--zone <name>` | Web Unlocker zone name |
| `--mobile` | Use a mobile user agent |
| `--async` | Submit async, return a snapshot ID |
| `-o, --output <path>` | Write output to file |
| `--json` | Force JSON output |
| `--pretty` | Pretty-print JSON output |

<CodeGroup>
  ```bash Markdown (default) theme={null}
  brightdata scrape https://news.ycombinator.com
  ```

  ```bash HTML theme={null}
  brightdata scrape https://example.com -f html
  ```

  ```bash JSON with geo-targeting theme={null}
  brightdata scrape https://amazon.com -f json --country us -o product.json
  ```

  ```bash Screenshot theme={null}
  brightdata scrape https://example.com -f screenshot -o page.png
  ```

  ```bash Async mode theme={null}
  brightdata scrape https://example.com --async
  ```

  ```bash Pipe to markdown reader theme={null}
  brightdata scrape https://docs.github.com | glow -
  ```
</CodeGroup>

***

## `brightdata search <query>`

Search Google, Bing, or Yandex via Bright Data's SERP API. Google returns structured JSON with organic results, ads, People Also Ask, and related searches. Bing and Yandex return markdown by default.

| Flag | Description |
| - | - |
| `--engine <name>` | `google` (default), `bing`, `yandex` |
| `--country <code>` | Localized results (e.g. `us`, `de`) |
| `--language <code>` | Language code (e.g. `en`, `fr`) |
| `--page <n>` | Page number, 0-indexed (default: `0`) |
| `--type <type>` | `web` (default), `news`, `images`, `shopping` |
| `--device <type>` | `desktop`, `mobile` |
| `--zone <name>` | SERP zone name |
| `-o, --output <path>` | Write output to file |
| `--json` | Force JSON output |
| `--pretty` | Pretty-print JSON output |

<CodeGroup>
  ```bash Basic search theme={null}
  brightdata search "typescript best practices"
  ```

  ```bash Localized search theme={null}
  brightdata search "restaurants berlin" --country de --language de
  ```

  ```bash News search theme={null}
  brightdata search "AI regulation" --type news
  ```

  ```bash Pagination theme={null}
  brightdata search "web scraping" --page 1
  ```

  ```bash Extract URLs with jq theme={null}
  brightdata search "open source scraping" --json | jq -r '.organic[].link'
  ```

  ```bash Bing search theme={null}
  brightdata search "bright data pricing" --engine bing
  ```
</CodeGroup>

***

## `brightdata pipelines <type> [params...] [options]`

Extract structured data from 40+ platforms. Triggers an async collection job, polls until results are ready, and returns the data.

| Flag | Description |
| - | - |
| `--format <fmt>` | `json` (default), `csv`, `ndjson`, `jsonl` |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `-o, --output <path>` | Write output to file |
| `--json` | Force JSON output |
| `--pretty` | Pretty-print JSON output |

```bash theme={null}
# List all available pipeline types
brightdata pipelines list
```

<CodeGroup>
  ```bash LinkedIn profile theme={null}
  brightdata pipelines linkedin_person_profile "https://linkedin.com/in/username"
  ```

  ```bash Amazon product theme={null}
  brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB"
  ```

  ```bash Amazon search theme={null}
  brightdata pipelines amazon_product_search "laptop" "https://amazon.com"
  ```

  ```bash Instagram profile theme={null}
  brightdata pipelines instagram_profiles "https://instagram.com/username"
  ```

  ```bash YouTube comments theme={null}
  brightdata pipelines youtube_comments "https://youtube.com/watch?v=..." 50
  ```

  ```bash CSV export theme={null}
  brightdata pipelines amazon_product "https://amazon.com/dp/..." --format csv -o product.csv
  ```
</CodeGroup>

### Supported platforms

<AccordionGroup>
  <Accordion title="E-Commerce" icon="cart-shopping">
    | Type | Platform | Parameters |
    | - | - | - |
    | `amazon_product` | Amazon product page | `<url>` |
    | `amazon_product_reviews` | Amazon reviews | `<url>` |
    | `amazon_product_search` | Amazon search results | `<keyword> <domain_url>` |
    | `walmart_product` | Walmart product page | `<url>` |
    | `walmart_seller` | Walmart seller profile | `<url>` |
    | `ebay_product` | eBay listing | `<url>` |
    | `bestbuy_products` | Best Buy | `<url>` |
    | `etsy_products` | Etsy | `<url>` |
    | `homedepot_products` | Home Depot | `<url>` |
    | `zara_products` | Zara | `<url>` |
    | `google_shopping` | Google Shopping | `<url>` |
  </Accordion>

  <Accordion title="Professional Networks" icon="briefcase">
    | Type | Platform | Parameters |
    | - | - | - |
    | `linkedin_person_profile` | LinkedIn person | `<url>` |
    | `linkedin_company_profile` | LinkedIn company | `<url>` |
    | `linkedin_job_listings` | LinkedIn jobs | `<url>` |
    | `linkedin_posts` | LinkedIn posts | `<url>` |
    | `linkedin_people_search` | LinkedIn people search | `<url> <first_name> <last_name>` |
    | `crunchbase_company` | Crunchbase | `<url>` |
    | `zoominfo_company_profile` | ZoomInfo | `<url>` |
  </Accordion>

  <Accordion title="Social Media" icon="hashtag">
    | Type | Platform | Parameters |
    | - | - | - |
    | `instagram_profiles` | Instagram profiles | `<url>` |
    | `instagram_posts` | Instagram posts | `<url>` |
    | `instagram_reels` | Instagram reels | `<url>` |
    | `instagram_comments` | Instagram comments | `<url>` |
    | `facebook_posts` | Facebook posts | `<url>` |
    | `facebook_marketplace_listings` | Facebook Marketplace | `<url>` |
    | `facebook_company_reviews` | Facebook reviews | `<url> [num_reviews]` |
    | `facebook_events` | Facebook events | `<url>` |
    | `tiktok_profiles` | TikTok profiles | `<url>` |
    | `tiktok_posts` | TikTok posts | `<url>` |
    | `tiktok_shop` | TikTok shop | `<url>` |
    | `tiktok_comments` | TikTok comments | `<url>` |
    | `x_posts` | X (Twitter) posts | `<url>` |
    | `youtube_profiles` | YouTube channels | `<url>` |
    | `youtube_videos` | YouTube videos | `<url>` |
    | `youtube_comments` | YouTube comments | `<url> [num_comments]` |
    | `reddit_posts` | Reddit posts | `<url>` |
  </Accordion>

  <Accordion title="Maps, Reviews & Other" icon="map-location-dot">
    | Type | Platform | Parameters |
    | - | - | - |
    | `google_maps_reviews` | Google Maps reviews | `<url> [days_limit]` |
    | `google_play_store` | Google Play | `<url>` |
    | `apple_app_store` | Apple App Store | `<url>` |
    | `github_repository_file` | GitHub repository files | `<url>` |
    | `yahoo_finance_business` | Yahoo Finance | `<url>` |
    | `zillow_properties_listing` | Zillow | `<url>` |
    | `booking_hotel_listings` | Booking.com | `<url>` |
  </Accordion>
</AccordionGroup>

<Tip>
  Run `brightdata pipelines list` in your terminal to see all available types at any time.
</Tip>

***

## `brightdata scraper`

Build, run, and maintain custom [Bright Data Scraper Studio](/products/scraper-studio/build-with-the-cli) scrapers from the terminal. Each scraper is identified by a Collector ID (a `c_*` string) that stays stable across runs and self-healing.

### `brightdata scraper create <url> <description>`

Build a scraper from a natural-language description using Bright Data's AI Agent. Returns a Collector ID.

AI generation typically takes 5 to 15 minutes and can run up to 25 minutes on complex targets.

| Flag | Description |
| - | - |
| `--name <name>` | Scraper template name (default: `cli-scraper-<timestamp>`) |
| `--deliver-webhook <url>` | Webhook URL for the deliver stub (default: `https://example.com/webhook`) |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `--max-retries <n>` | Max retries on the AI-Flow concurrent-job 429 cap (default: `4`) |
| `--no-retry` | Fail immediately on 429 instead of waiting through the cap. Same as `--max-retries 0` |
| `--legacy-output` | Emit the bare AI-progress payload used before v0.3 instead of the envelope below |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output (raw / indented) |
| `--timing` | Show request timing |

```bash theme={null}
# Minimal: a URL plus a description of the data you want
brightdata scraper create https://news.ycombinator.com \
  "Extract top stories: title, url, points, author, comment count"

# Named scraper, with the JSON envelope saved for inspection
brightdata scraper create https://www.ycombinator.com/companies?batch=W26 \
  "For each company card, extract name, vertical, tagline, link" \
  --name yc-w26 --pretty -o create.json
```

#### JSON output from `scraper create`

With `--json`, `--pretty`, `-o` or any non-TTY stream, `scraper create` returns an envelope instead of the human summary:

| Field | Description |
| - | - |
| `collector_id` | Collector ID of the new scraper |
| `name` | Scraper template name |
| `status` | Job status when the response was written |
| `completed_steps` | AI generation steps finished so far |
| `view_url` | Scraper Studio URL for the new collector |
| `created_at` | Creation timestamp, when the API returns one |
| `error` | Failure reason, present only on failure |

`--legacy-output` replaces the envelope with the bare AI-progress payload used before v0.3. Use it only while migrating a script to the envelope.

#### Concurrent job cap on `scraper create`

Bright Data's AI Flow caps how many generation jobs run at once. When your account is at the cap, the API returns HTTP 429 and the CLI waits and retries, four times by default. Each wait grows exponentially with jitter, up to about four minutes between attempts. Raise or lower the count with `--max-retries`, or fail on the first 429 with `--no-retry`.

### `brightdata scraper run <collector_id> [url]`

Run a scraper on one or more URLs and return the data. The CLI tries real-time mode first and falls back to batch mode automatically when a run exceeds the real-time page-load limit.

| Flag | Description |
| - | - |
| `--urls <list>` | Comma-separated list of URLs, sent to `/dca/trigger` as a single batch |
| `--input-file <path>` | File of URLs: one per line, or a JSON array of strings, or a JSON array of `{"url": "..."}` objects. Blank lines and `#` comments are skipped |
| `--sync` | Use the synchronous `/dca/crawl` endpoint, which has a server-side 25 to 50 second cap. Single URL only |
| `--sync-timeout <seconds>` | Sync-mode server timeout, 25 to 50 (default: `50`) |
| `--timeout <seconds>` | Polling timeout in async mode (default: `600`; batch mode: `3600`) |
| `--name <name>` | Human-readable job name |
| `--version <version>` | Scraper version, for example `dev` |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output (raw / indented) |
| `--timing` | Show request timing |

Pass the URL as an argument for a single page, or use `--urls` or `--input-file` to run a batch. Omit the URL argument when you use either batch flag.

```bash theme={null}
# One URL
brightdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --pretty

# Several URLs as one batch job
brightdata scraper run c_mpohus372o5tmid1jk \
  --urls https://news.ycombinator.com,https://news.ycombinator.com/newest

# URLs from a file, one per line
brightdata scraper run c_mpohus372o5tmid1jk --input-file urls.txt

# Sync mode for a small, fast page
brightdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --sync
```

<Note>
  `--sync` cannot be combined with `--urls` or `--input-file`. The `/dca/crawl` endpoint accepts one URL at a time, so drop `--sync` to run a batch.
</Note>

### `brightdata scraper heal <collector_id> <prompt>`

Fix an existing scraper in place via AI self-healing. The Collector ID does not change. By default, `heal` stops at an approval gate and returns `status: "awaiting_approval"` with a `preview_result`.

| Flag | Description |
| - | - |
| `--url <url>` | Verify target woven into the next-step hint. Not sent to the heal call |
| `--auto-approve` | Approve automatically at the gate and poll through to `done` |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `--max-retries <n>` | Max retries on the AI-Flow concurrent-job 429 cap (default: `4`) |
| `--no-retry` | Fail immediately on 429 instead of waiting through the cap |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output (raw / indented) |

```bash theme={null}
brightdata scraper heal c_mpohus372o5tmid1jk \
  "The price field returns null since the redesign. Re-capture price and currency." \
  --url https://example.com/product/1
```

### `brightdata scraper approve <collector_id>`

Commit a heal that is awaiting approval, or reject it with `--reject`.

| Flag | Description |
| - | - |
| `--reject` | Reject the proposed fix instead of approving it |
| `--url <url>` | Verify target woven into the next-step hint on success |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output |

```bash theme={null}
brightdata scraper approve c_mpohus372o5tmid1jk --url https://example.com/product/1
brightdata scraper approve c_mpohus372o5tmid1jk --reject
```

<Warning>
  **Approving is not the same as saving.** A successful `approve` can return exit code 0 and a success message while the healed template is still a development draft, so the next live run serves the pre-heal version. Confirm the fix reached production before you rely on it: re-run the collector and check that the healed field is present in the output, or open the scraper in the Scraper Studio IDE and check it shows **Active** or **Ready** rather than **Draft**. See [Initiate collection and delivery](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-save-a-scraper-to-production).
</Warning>

### Heal statuses

`heal` and `approve` report the job through these statuses. Poll until you reach `done` or `error`.

| Status | Meaning | What to do |
| - | - | - |
| `awaiting_approval` | The fix is generated and previewed, waiting on you | Inspect `preview_result`, then run `approve` |
| `pending_answer` | The job is parked on a human decision and the collector keeps serving the old template | Same as `awaiting_approval`: approve or reject. The job does not advance on its own |
| `done` | The heal completed | Verify a live run returns the healed field |
| `error` | The heal failed | Read the failure reason and retry with a more specific prompt |

<Note>
  A heal that reaches `done` confirms a value came back, not that it is the right value. Check the healed field against the live page before trusting it downstream.
</Note>

<Tip>
  The self-healing flow is run, inspect, `heal`, `approve`, re-run. See the [Scraper Studio CLI quickstart](/products/scraper-studio/build-with-the-cli) for a full walkthrough. `scraper heal` and `scraper approve` were added in CLI v0.3.1.
</Tip>

***

## `brightdata status <job-id>`

Check the status of an async snapshot job (from `--async` scrapes or pipeline collections).

| Flag | Description |
| - | - |
| `--wait` | Poll until the job completes |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output |

```bash theme={null}
brightdata status s_abc123xyz
brightdata status s_abc123xyz --wait --pretty
brightdata status s_abc123xyz --wait --timeout 300
```

***

## `brightdata browser`

Control a real browser session powered by Bright Data's [Scraping Browser](/products/scraping-browser/introduction). A lightweight local daemon holds the browser connection open between commands, giving you persistent state without reconnecting on every call.

```bash theme={null}
brightdata browser <subcommand> [options]
```

### Global flags

These flags work with every `browser` subcommand:

| Flag | Description |
| - | - |
| `--session <name>` | Session name for running multiple isolated sessions in parallel (default: `default`) |
| `--country <code>` | Geo-target by ISO country code. On `open`, changing country reconnects the browser |
| `--zone <name>` | Scraping Browser zone (default: `cli_browser`) |
| `--timeout <ms>` | IPC command timeout in milliseconds (default: `30000`) |
| `--idle-timeout <ms>` | Daemon auto-shutdown after idle (default: `600000` / 10 min) |
| `--json` / `--pretty` | JSON output |
| `-o, --output <path>` | Write output to file |

### Subcommands

<AccordionGroup>
  <Accordion title="browser open" icon="globe">
    Navigate to a URL. Starts the daemon and browser session automatically if not already running.

    ```bash theme={null}
    brightdata browser open <url>
    brightdata browser open https://amazon.com --country us --session shop
    ```

    | Flag | Description |
    | - | - |
    | `--country <code>` | Geo-targeting. Reconnects the browser if the country changes on an existing session |
    | `--zone <name>` | Browser zone name |
    | `--idle-timeout <ms>` | Daemon idle timeout for this session |
  </Accordion>

  <Accordion title="browser snapshot" icon="camera">
    Capture the page as a text accessibility tree. This is the primary way AI agents read page content - far more token-efficient than raw HTML.

    Each interactive element gets a `ref` (e.g. `e1`, `e2`) that you pass to `click`, `type`, `fill`, and other interaction commands.

    ```bash theme={null}
    brightdata browser snapshot
    brightdata browser snapshot --compact          # Interactive elements + ancestors only
    brightdata browser snapshot --interactive      # Interactive elements as a flat list
    brightdata browser snapshot --depth 3          # Limit tree depth
    brightdata browser snapshot --selector "main"  # Scope to a CSS subtree
    ```

    **Example output:**

    ```text theme={null}
    Page: Example Domain
    URL: https://example.com

    - heading "Example Domain" [level=1]
    - paragraph "This domain is for use in illustrative examples."
    - link "More information..." [ref=e1]
    ```

    | Flag | Description |
    | - | - |
    | `--compact` | Only interactive elements and their ancestors (70-90% fewer tokens) |
    | `--interactive` | Only interactive elements, as a flat list |
    | `--depth <n>` | Limit tree depth |
    | `--selector <sel>` | Scope snapshot to elements matching a CSS selector |
    | `--wrap` | Wrap output in content boundaries (useful for AI agent prompt injection safety) |
  </Accordion>

  <Accordion title="browser screenshot" icon="image">
    Capture a PNG screenshot of the current viewport.

    ```bash theme={null}
    brightdata browser screenshot
    brightdata browser screenshot ./result.png
    brightdata browser screenshot --full-page -o page.png
    brightdata browser screenshot --base64
    ```

    | Flag | Description |
    | - | - |
    | `[path]` | Where to save the PNG (default: temp directory) |
    | `--full-page` | Capture the full scrollable page, not just the viewport |
    | `--base64` | Output base64-encoded PNG data instead of saving to a file |
  </Accordion>

  <Accordion title="browser click / type / fill" icon="hand-pointer">
    Interact with elements using their snapshot `ref` values.

    ```bash theme={null}
    # Click an element
    brightdata browser click e3

    # Type text into a field (clears first by default)
    brightdata browser type e5 "search query"
    brightdata browser type e5 " more text" --append    # Append to existing value
    brightdata browser type e5 "search query" --submit  # Press Enter after typing

    # Fill a form field directly (no keyboard simulation)
    brightdata browser fill e2 "user@example.com"

    # Select a dropdown option by visible label
    brightdata browser select e4 "United States"

    # Check / uncheck a checkbox or radio button
    brightdata browser check e7
    brightdata browser uncheck e7

    # Hover over an element
    brightdata browser hover e2
    ```

    | Flag (for `type`) | Description |
    | - | - |
    | `--append` | Append to existing value using key-by-key simulation |
    | `--submit` | Press Enter after typing |
  </Accordion>

  <Accordion title="browser scroll" icon="arrows-up-down">
    Scroll the viewport or scroll an element into view.

    ```bash theme={null}
    brightdata browser scroll                          # Scroll down 300px (default)
    brightdata browser scroll --direction up
    brightdata browser scroll --direction down --distance 600
    brightdata browser scroll --ref e10                # Scroll element into view
    ```

    | Flag | Description |
    | - | - |
    | `--direction <dir>` | `up`, `down`, `left`, `right` (default: `down`) |
    | `--distance <px>` | Pixels to scroll (default: `300`) |
    | `--ref <ref>` | Scroll this element into view instead of the viewport |
  </Accordion>

  <Accordion title="browser get text / get html" icon="code">
    Get text or HTML content from the page or a specific element.

    ```bash theme={null}
    # Text content
    brightdata browser get text            # Full page text
    brightdata browser get text "h1"       # Text of the first h1
    brightdata browser get text "#price"   # Text inside #price

    # HTML content
    brightdata browser get html              # Full page outer HTML
    brightdata browser get html ".product"   # innerHTML of .product
    ```
  </Accordion>

  <Accordion title="browser network / cookies / status" icon="network-wired">
    Inspect session state.

    ```bash theme={null}
    # HTTP requests captured since last navigation
    brightdata browser network

    # Cookies for the active session
    brightdata browser cookies

    # Current session state
    brightdata browser status
    brightdata browser status --session shop --pretty

    # List all active sessions
    brightdata browser sessions
    ```
  </Accordion>

  <Accordion title="browser back / forward / reload" icon="rotate">
    Navigation controls.

    ```bash theme={null}
    brightdata browser back
    brightdata browser forward
    brightdata browser reload
    ```
  </Accordion>

  <Accordion title="browser close" icon="xmark">
    Close a session and stop its daemon.

    ```bash theme={null}
    brightdata browser close                    # Close the default session
    brightdata browser close --session shop     # Close a named session
    brightdata browser close --all              # Close all active sessions
    ```
  </Accordion>
</AccordionGroup>

<Note>
  Element `ref` values (e.g. `e1`, `e3`) are re-assigned on every `snapshot` call. After navigating or clicking, take a fresh snapshot before using refs again.
</Note>

***

## `brightdata zones`

List and inspect Bright Data proxy zones.

```bash theme={null}
brightdata zones                        # List all active zones
brightdata zones info <name>            # Full details for a zone
brightdata zones --json -o zones.json   # Export as JSON
brightdata zones info my_zone --pretty  # Pretty-print zone info
```

***

## `brightdata budget`

View account balance and per-zone cost/bandwidth. Read-only.

| Subcommand | Description |
| - | - |
| *(none)* | Quick account balance |
| `balance` | Balance + pending charges |
| `zones` | Cost & bandwidth table for all zones |
| `zone <name>` | Detailed cost & bandwidth for one zone |

| Flag | Description |
| - | - |
| `--from <datetime>` | Start of date range (e.g. `2024-01-01T00:00:00`) |
| `--to <datetime>` | End of date range |
| `--json` / `--pretty` | JSON output |

```bash theme={null}
brightdata budget
brightdata budget balance
brightdata budget zones
brightdata budget zone my_zone
brightdata budget zones --from 2024-01-01T00:00:00 --to 2024-02-01T00:00:00
```

***

## `brightdata config`

View and manage CLI configuration.

| Subcommand | Description |
| - | - |
| *(none)* | Show all config |
| `get <key>` | Get a single value |
| `set <key> <value>` | Set a value |

| Config Key | Description |
| - | - |
| `default_zone_unlocker` | Default zone for `scrape` and `search` |
| `default_zone_serp` | Override zone for `search` only |
| `default_format` | Default output format: `markdown` or `json` |
| `api_url` | Override API base URL |

```bash theme={null}
brightdata config
brightdata config set default_zone_unlocker my_zone
brightdata config set default_format json
brightdata config get default_zone_unlocker
```

***

## `brightdata init`

Interactive setup wizard. Walks through authentication, zone selection, and default configuration.

| Flag | Description |
| - | - |
| `--skip-auth` | Skip the authentication step |
| `-k, --api-key <key>` | Provide API key directly |

```bash theme={null}
brightdata init
```

***

## `brightdata skill`

Install Bright Data AI agent skills into coding agents (Claude Code, Cursor, Copilot, etc.).

| Subcommand | Description |
| - | - |
| `add` | Interactive picker - choose skills + target agents |
| `add <name>` | Install a specific skill directly |
| `list` | List all available skills |

Available skills: `search`, `scrape`, `data-feeds`, `bright-data-mcp`, `bright-data-best-practices`

```bash theme={null}
brightdata skill add              # Interactive picker
brightdata skill add scrape       # Direct install
brightdata skill list             # See what's available
```

***

## `brightdata add mcp`

Add the Bright Data MCP server to Claude Code, Cursor, or Codex. Uses the API key stored by `brightdata login`.

```bash theme={null}
brightdata add mcp                               # Interactive agent + scope prompts
brightdata add mcp --agent claude-code --global
brightdata add mcp --agent claude-code,cursor --project
brightdata add mcp --agent codex --global
```

| Flag | Description |
| - | - |
| `--agent <agents>` | Comma-separated targets: `claude-code`, `cursor`, `codex` |
| `--global` | Install to the agent's global config file |
| `--project` | Install to the current project's config file |

### Config file locations

| Agent | Global path | Project path |
| - | - | - |
| Claude Code | `~/.claude.json` | `.claude/settings.json` |
| Cursor | `~/.cursor/mcp.json` | `.cursor/mcp.json` |
| Codex | `$CODEX_HOME/mcp.json` or `~/.codex/mcp.json` | Not supported |

The command writes the MCP server entry under `mcpServers["bright-data"]`. Existing config is preserved - only the `bright-data` key is added or replaced.

<Warning>
  `brightdata add mcp` uses the API key stored by `brightdata login`. It does not read `BRIGHTDATA_API_KEY` or the `--api-key` flag, so run `brightdata login` first.
</Warning>


# Usage examples
Source: https://docs.brightdata.com/products/cli/examples

Real-world workflows and recipes for the Bright Data CLI, from 1-line scrapes returning clean markdown to scheduled pipelines feeding LLMs.

## How to scrape with the CLI

### Get clean content from any website

```bash theme={null}
# Clean markdown - great for reading or feeding to LLMs
brightdata scrape https://news.ycombinator.com

# Save to file
brightdata scrape https://docs.python.org/3/tutorial/ -o python-tutorial.md

# Get raw HTML for parsing
brightdata scrape https://example.com -f html -o page.html
```

### How to scrape with geo-targeting

```bash theme={null}
# See Amazon prices as a US customer
brightdata scrape https://amazon.com/dp/B09V3KXJPB --country us

# Scrape a German news site from Germany
brightdata scrape https://spiegel.de --country de

# Mobile user agent for mobile-optimized pages
brightdata scrape https://example.com --mobile
```

### How to take screenshots

```bash theme={null}
# Full-page screenshot
brightdata scrape https://example.com -f screenshot -o homepage.png

# Screenshot from a specific country
brightdata scrape https://amazon.co.uk -f screenshot --country gb -o uk-amazon.png
```

***

## How to run search workflows

### Basic web search

```bash theme={null}
# Google search with formatted table output
brightdata search "best web scraping tools 2025"

# Get raw JSON for processing
brightdata search "typescript best practices" --json

# Pretty-print for inspection
brightdata search "AI startups" --pretty
```

### Localized and specialized search

```bash theme={null}
# Local restaurant search from Germany, in German
brightdata search "restaurants berlin" --country de --language de

# News-only results
brightdata search "AI regulation 2025" --type news

# Shopping results
brightdata search "wireless headphones" --type shopping

# Image search
brightdata search "mountain landscape wallpaper" --type images
```

### Pagination

```bash theme={null}
# First page (default)
brightdata search "web scraping tutorials"

# Second page
brightdata search "web scraping tutorials" --page 1

# Third page
brightdata search "web scraping tutorials" --page 2
```

***

## How to run browser workflows

### Navigate and read pages

```bash theme={null}
# Open a page and read its content
brightdata browser open https://example.com
brightdata browser snapshot

# Compact snapshot for AI agents (70-90% fewer tokens)
brightdata browser snapshot --compact

# Scope to a specific section
brightdata browser snapshot --selector "main"
```

### Interact with pages

```bash theme={null}
# Open a page
brightdata browser open https://example.com

# Read the page structure
brightdata browser snapshot --compact

# Click, type, and submit using refs from the snapshot
brightdata browser click e3
brightdata browser type e5 "search query" --submit

# Get updated snapshot after interaction
brightdata browser snapshot --compact

# Take a screenshot for visual verification
brightdata browser screenshot ./result.png

# Clean up
brightdata browser close
```

### How to compare multiple sessions

```bash theme={null}
# Open the same page from different countries
brightdata browser open https://amazon.com --session us --country us
brightdata browser open https://amazon.com --session de --country de

# Capture both snapshots
brightdata browser snapshot --session us --json > us.json
brightdata browser snapshot --session de --json > de.json

# Close all sessions
brightdata browser close --all
```

### Extract content from dynamic pages

```bash theme={null}
# Navigate to a page that requires JavaScript
brightdata browser open https://example.com/dashboard

# Get text content from specific elements
brightdata browser get text "#total-revenue"
brightdata browser get text ".summary-table"

# Get HTML for parsing
brightdata browser get html ".product-grid"

# Check network requests
brightdata browser network
```

***

## Structured data extraction

### How to extract e-commerce data

```bash theme={null}
# Amazon product details
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB"

# Amazon product reviews
brightdata pipelines amazon_product_reviews "https://amazon.com/dp/B09V3KXJPB"

# Amazon search - requires keyword + domain
brightdata pipelines amazon_product_search "wireless headphones" "https://amazon.com"

# Walmart product
brightdata pipelines walmart_product "https://walmart.com/ip/123456"

# Export as CSV
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format csv -o product.csv
```

### Social media profiles

```bash theme={null}
# LinkedIn person
brightdata pipelines linkedin_person_profile "https://linkedin.com/in/username"

# LinkedIn company
brightdata pipelines linkedin_company_profile "https://linkedin.com/company/bright-data"

# Instagram profile
brightdata pipelines instagram_profiles "https://instagram.com/username"

# TikTok profile
brightdata pipelines tiktok_profiles "https://tiktok.com/@username"
```

### Reviews and comments

```bash theme={null}
# Google Maps reviews - last 7 days
brightdata pipelines google_maps_reviews "https://maps.google.com/maps/place/..." 7

# YouTube comments - top 50
brightdata pipelines youtube_comments "https://youtube.com/watch?v=dQw4w9WgXcQ" 50

# Facebook company reviews - 25 reviews
brightdata pipelines facebook_company_reviews "https://facebook.com/company" 25

# Instagram comments
brightdata pipelines instagram_comments "https://instagram.com/p/ABC123"
```

***

## Piping and automation

The CLI is designed to be pipe-friendly. When stdout is not a TTY, colors and spinners are automatically disabled.

### Chain search → scrape

```bash theme={null}
# Search Google, extract the first URL, then scrape it
brightdata search "best python frameworks 2025" --json \
  | jq -r '.organic[0].link' \
  | xargs brightdata scrape
```

### Scrape and read in terminal

```bash theme={null}
# Pipe markdown output to a terminal reader
brightdata scrape https://docs.github.com | glow -

# Or use less
brightdata scrape https://docs.github.com | less
```

### Export to CSV for analysis

```bash theme={null}
# Amazon product data to CSV
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format csv > product.csv

# LinkedIn jobs to CSV
brightdata pipelines linkedin_job_listings "https://linkedin.com/jobs/view/123" --format csv -o jobs.csv
```

### Extract specific fields with jq

```bash theme={null}
# Get just the titles and prices from Amazon search
brightdata pipelines amazon_product_search "laptop" "https://amazon.com" \
  | jq '[.[] | {title, price: .final_price}]'

# Get just organic result URLs from search
brightdata search "web scraping" --json | jq -r '.organic[].link'
```

### Async jobs for heavy workloads

```bash theme={null}
# Submit an async scrape
JOB_ID=$(brightdata scrape https://heavy-page.com --async --json | jq -r '.snapshot_id')

# Do other work...

# Check back later
brightdata status $JOB_ID --wait --pretty
```

***

## How to manage your account

### Monitor costs

```bash theme={null}
# Quick balance check
brightdata budget

# Detailed balance with pending charges
brightdata budget balance

# Cost breakdown by zone
brightdata budget zones

# Specific zone in a date range
brightdata budget zone cli_unlocker --from 2024-01-01T00:00:00 --to 2024-02-01T00:00:00
```

### Manage configuration

```bash theme={null}
# View current config
brightdata config

# Set default output to JSON
brightdata config set default_format json

# Use a custom zone for scraping
brightdata config set default_zone_unlocker my_custom_zone

# Override SERP zone
brightdata config set default_zone_serp my_serp_zone
```

***

## AI agent integration

### Add the MCP server to your coding agent

```bash theme={null}
# Interactive - choose agent and scope
brightdata add mcp

# Add to Claude Code globally
brightdata add mcp --agent claude-code --global

# Add to multiple agents at once
brightdata add mcp --agent claude-code,cursor --project

# Add to Codex
brightdata add mcp --agent codex --global
```

### Install skills into coding agents

```bash theme={null}
# Interactive picker - choose skills and target agents
brightdata skill add

# Install the scraping skill into your agent
brightdata skill add scrape

# Install search capabilities
brightdata skill add search

# See all available skills
brightdata skill list
```

<Tip>
  Skills are pre-packaged bundles of prompts and configuration that teach AI coding agents how to use Bright Data effectively. See [For your coding agent](/quickstart-coding-agent) and [github.com/brightdata/skills](https://github.com/brightdata/skills) for more details.
</Tip>

***

## Supported environment variables

Override any stored configuration with environment variables:

| Variable | Purpose |
| - | - |
| `BRIGHTDATA_API_KEY` | API key (skips login entirely) |
| `BRIGHTDATA_UNLOCKER_ZONE` | Default Web Unlocker zone |
| `BRIGHTDATA_SERP_ZONE` | Default SERP zone |
| `BRIGHTDATA_POLLING_TIMEOUT` | Polling timeout in seconds |
| `BRIGHTDATA_BROWSER_ZONE` | Default Scraping Browser zone (default: `cli_browser`) |
| `BRIGHTDATA_DAEMON_DIR` | Directory for the browser daemon socket and state. Defaults to the CLI config directory for your OS |

```bash theme={null}
# Use in CI/CD without login
BRIGHTDATA_API_KEY=your_key brightdata scrape https://example.com

# Override timeout for large pipeline jobs
BRIGHTDATA_POLLING_TIMEOUT=1200 brightdata pipelines amazon_product "https://amazon.com/dp/..."
```


# Bright Data CLI FAQs
Source: https://docs.brightdata.com/products/cli/faqs

FAQs and troubleshooting for the Bright Data CLI: brightdata and bdata aliases, authentication, installation issues and common errors.

## Frequently asked general questions

<AccordionGroup>
  <Accordion title="What is the difference between `brightdata` and `bdata`?">
    They are identical - `bdata` is a shorthand alias installed alongside `brightdata`. Use whichever you prefer.
  </Accordion>

  <Accordion title="Do I need a Bright Data account to use the CLI?">
    Yes. The CLI connects to Bright Data's infrastructure to handle web requests. You can [sign up for free](https://brightdata.com/?hs_signup=1\&utm_source=docs) and get started with the free tier.
  </Accordion>

  <Accordion title="What platforms can I extract data from?">
    The CLI supports 40+ platforms through the `pipelines` command, including Amazon, LinkedIn, Instagram, TikTok, YouTube, Facebook, Reddit, Google Maps, Walmart, eBay, and many more. Run `brightdata pipelines list` to see the full list.
  </Accordion>

  <Accordion title="What output formats are supported?">
    * **Scrape:** `markdown` (default), `html`, `json`, `screenshot`
    * **Search:** Formatted table (default), `json`, `pretty`
    * **Pipelines:** `json` (default), `csv`, `ndjson`, `jsonl`

    All commands support `-o <path>` to write output to a file.
  </Accordion>

  <Accordion title="Can I use the CLI in scripts and CI/CD pipelines?">
    Yes. The CLI is fully pipe-friendly. When stdout is not a TTY, colors and spinners are automatically disabled. Use `--json` for machine-readable output and `BRIGHTDATA_API_KEY` environment variable for non-interactive authentication.
  </Accordion>
</AccordionGroup>

## Authentication

<AccordionGroup>
  <Accordion title="Where are my credentials stored?">
    Credentials are stored locally on your machine:

    | OS | Path |
    | - | - |
    | macOS | `~/Library/Application Support/brightdata-cli/credentials.json` |
    | Linux | `~/.config/brightdata-cli/credentials.json` |
    | Windows | `%APPDATA%\brightdata-cli\credentials.json` |

    The file is set to mode `0o600` (owner read/write only).
  </Accordion>

  <Accordion title="How do I log in on a remote server without a browser?">
    Use the device flow:

    ```bash theme={null}
    brightdata login --device
    ```

    This prints a URL and a verification code. Open the URL on any device with a browser, enter the code, and authentication completes on the server.
  </Accordion>

  <Accordion title="How do I switch between Bright Data accounts?">
    Run `brightdata logout` followed by `brightdata login` with the new account. Or pass a different API key directly:

    ```bash theme={null}
    brightdata login --api-key <new_key>
    ```
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;No Web Unlocker zone specified&#x22;">
    This means no default zone is configured. Fix it by either:

    ```bash theme={null}
    # Re-run login (auto-creates zones)
    brightdata login

    # Or set a zone manually
    brightdata config set default_zone_unlocker <zone_name>
    ```
  </Accordion>

  <Accordion title="&#x22;Invalid or expired API key&#x22;">
    Your stored API key is no longer valid. Re-authenticate:

    ```bash theme={null}
    brightdata login
    ```
  </Accordion>

  <Accordion title="&#x22;Access denied&#x22;">
    Your API key does not have permission for the requested zone or operation. Check zone permissions in the [Bright Data control panel](https://brightdata.com/cp).
  </Accordion>

  <Accordion title="&#x22;Rate limit exceeded&#x22;">
    You've hit the rate limit for your zone. Options:

    * Wait a moment and retry
    * Use `--async` for large jobs to avoid blocking
    * Contact your account manager to increase limits
  </Accordion>

  <Accordion title="Pipeline job timed out">
    The default polling timeout is 600 seconds (10 minutes). For large datasets, increase it:

    ```bash theme={null}
    # Per-command
    brightdata pipelines amazon_product "<url>" --timeout 1200

    # Via environment variable
    export BRIGHTDATA_POLLING_TIMEOUT=1200
    ```
  </Accordion>

  <Accordion title="Colors or spinners look broken in my terminal">
    The CLI auto-detects TTY support. If detection fails, pipe through `cat` to force plain output:

    ```bash theme={null}
    brightdata scrape https://example.com | cat
    ```

    Or use `--json` for clean, parseable output.
  </Accordion>
</AccordionGroup>

## Frequently asked configuration questions

<AccordionGroup>
  <Accordion title="How do I change the default output format?">
    ```bash theme={null}
    brightdata config set default_format json
    ```

    Valid values: `markdown`, `json`.
  </Accordion>

  <Accordion title="What is the configuration priority order?">
    Settings are resolved in this order (highest priority first):

    1. **CLI flags** - e.g., `--zone my_zone`
    2. **Environment variables** - e.g., `BRIGHTDATA_UNLOCKER_ZONE`
    3. **config.json** - e.g., `default_zone_unlocker`
    4. **Defaults** - built-in fallbacks
  </Accordion>

  <Accordion title="How do I reset all configuration?">
    Delete the configuration directory:

    ```bash theme={null}
    # Linux
    rm -rf ~/.config/brightdata-cli/

    # macOS
    rm -rf ~/Library/Application\ Support/brightdata-cli/
    ```

    Then run `brightdata login` to start fresh.
  </Accordion>
</AccordionGroup>


# Install the Bright Data CLI
Source: https://docs.brightdata.com/products/cli/installation

Install the Bright Data CLI via npm or curl and authenticate your account with an API key in 1 minute. Includes setup verification commands.

## Install the CLI

The fastest way to run the Bright Data CLI is `npx`, which executes the latest version with no global install:

```bash theme={null}
npx -p @brightdata/cli brightdata --version
```

Prefix any command in these docs with `npx -p @brightdata/cli` to run it the same way, with no global dependency to maintain. The Bright Data CLI requires Node.js 20 or later.

For a persistent `brightdata` command and faster startup, install the CLI globally instead:

<CodeGroup>
  ```bash npm (recommended) theme={null}
  npm install -g @brightdata/cli
  ```

  ```bash yarn theme={null}
  yarn global add @brightdata/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @brightdata/cli
  ```
</CodeGroup>

On macOS and Linux, an install script does the same global install and then starts the login flow:

```bash theme={null}
curl -fsSL cli.brightdata.com/install.sh | sh
```

The script checks for Node.js 20 or later, runs `npm install -g @brightdata/cli`, then calls `brightdata login`. It needs npm on your PATH, so it is a shortcut rather than a Node-free install.

Verify a global install:

```bash theme={null}
brightdata --version
```

<Tip>
  The shorthand alias `bdata` is also available, both with `npx -p @brightdata/cli bdata` and after a global install - use whichever you prefer.
</Tip>

## Windows

Running the CLI through `npx` authenticates your session but does not put a `brightdata` or `bdata` binary on your PATH. Install globally if you want a persistent command:

```bash theme={null}
npm install -g @brightdata/cli
```

Calling the CLI from a Python subprocess on Windows fails with `[WinError 2] The system cannot find the file specified`, or `[WinError 193]`, because npm installs a `.cmd` shim that Python cannot execute directly. Three ways round it:

```python theme={null}
import subprocess

# 1. Call the .cmd shim by name
subprocess.run(["bdata.cmd", "scraper", "run", "c_YOUR_COLLECTOR_ID"])

# 2. Route through the shell
subprocess.run("bdata scraper run c_YOUR_COLLECTOR_ID", shell=True)

# 3. Go through cmd /c
subprocess.run(["cmd", "/c", "bdata", "scraper", "run", "c_YOUR_COLLECTOR_ID"])
```

Two more Windows notes:

* PowerShell blocks the npm shim under the default execution policy. Run `Get-ExecutionPolicy` and, if it returns `Restricted`, allow local scripts with `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`.
* The default console code page is cp1252, which raises `UnicodeEncodeError` when scraped pages contain UTF-8. Set `PYTHONUTF8=1`, or run `chcp 65001` before the command.

## Update the CLI

Upgrade to the latest version with the same package manager you installed with:

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @brightdata/cli@latest
  ```

  ```bash yarn theme={null}
  yarn global add @brightdata/cli@latest
  ```

  ```bash pnpm theme={null}
  pnpm add -g @brightdata/cli@latest
  ```
</CodeGroup>

Check your installed version against the latest published version:

```bash theme={null}
brightdata --version           # your installed version
npm view @brightdata/cli version   # latest version on npm
```

<Tip>
  New commands ship in CLI releases. For example, `scraper heal` and `scraper approve` were added in v0.3.1. Run the update command above to pick them up. See the [release notes](https://github.com/brightdata/cli/releases) for what changed in each version.
</Tip>

## Authenticate

Run the login command to connect your Bright Data account:

```bash theme={null}
brightdata login
```

This opens your browser for secure OAuth authentication. Once complete, the CLI:

1. Validates and stores your API key locally
2. Auto-creates required proxy zones (`cli_unlocker`, `cli_browser`)
3. Sets sensible defaults so you can start immediately

<Check>
  You only need to log in **once**. All subsequent commands authenticate automatically.
</Check>

### Alternative authentication methods

<AccordionGroup>
  <Accordion title="Headless / SSH environments" icon="server">
    When no browser is available, use the device flow:

    ```bash theme={null}
    brightdata login --device
    ```

    This prints a URL and a code. Open the URL on any device, enter the code, and the CLI completes authentication.
  </Accordion>

  <Accordion title="Direct API key" icon="key">
    For CI/CD pipelines or non-interactive environments, pass your API key directly:

    ```bash theme={null}
    brightdata login --api-key YOUR_API_KEY
    ```

    You can find your API key in the [Bright Data control panel](https://brightdata.com/cp/setting).
  </Accordion>

  <Accordion title="Environment variable" icon="leaf">
    Set the `BRIGHTDATA_API_KEY` environment variable to skip login entirely:

    ```bash theme={null}
    export BRIGHTDATA_API_KEY=YOUR_API_KEY
    ```

    This is useful for Docker containers, GitHub Actions, and other automated environments.

    <Note>
      The [Bright Data Python SDK](/api-reference/SDK) 2.5.0 and later also reads `BRIGHTDATA_API_KEY`, so one export covers the CLI and the SDK. Older SDK versions read only `BRIGHTDATA_API_TOKEN`.
    </Note>
  </Accordion>
</AccordionGroup>

## Interactive setup wizard

For a guided first-time experience, use the init command:

```bash theme={null}
brightdata init
```

This walks you through authentication, zone selection, and default configuration step by step.

| Flag | Description |
| - | - |
| `--skip-auth` | Skip the authentication step (if already logged in) |
| `-k, --api-key <key>` | Provide API key directly |

## Verify your setup

After logging in, confirm everything is working:

```bash theme={null}
# Check your configuration
brightdata config

# Verify API connectivity
brightdata budget

# Try a quick scrape
brightdata scrape https://example.com
```

## Where configuration is stored

The CLI stores credentials and configuration locally:

| OS | Path |
| - | - |
| macOS | `~/Library/Application Support/brightdata-cli/` |
| Linux | `~/.config/brightdata-cli/` |
| Windows | `%APPDATA%\brightdata-cli\` |

Two files are created:

| File | Purpose | Permissions |
| - | - | - |
| `credentials.json` | API key | `0o600` (owner-only) |
| `config.json` | Zones, output format, preferences | Standard |

<Tip>
  **Priority order for configuration:** CLI flags → Environment variables → `config.json` → Defaults. You can always override any setting on a per-command basis.
</Tip>

## Next steps

<CardGroup>
  <Card title="Commands" icon="code" href="/products/cli/commands">
    Explore the full command reference.
  </Card>

  <Card title="Usage Examples" icon="book-open" href="/products/cli/examples">
    Jump into real-world workflows and recipes.
  </Card>
</CardGroup>


# Bright Data CLI
Source: https://docs.brightdata.com/products/cli/overview

Scrape websites, search the web, extract structured data from 40+ platforms, and manage your Bright Data account from the terminal.

<Card title="Get started in 60 seconds" icon="rocket" href="/products/cli/installation">
  Install the CLI, log in once, and start scraping - CAPTCHAs, anti-bot protections, and JavaScript rendering are handled automatically.
</Card>

## What can you do with the CLI?

<CardGroup>
  <Card title="Scrape any website" icon="globe">
    Get clean markdown, HTML, JSON, or screenshots from any URL - anti-bot bypass and JS rendering included.
  </Card>

  <Card title="Search the web" icon="magnifying-glass">
    Query Google, Bing, or Yandex and get structured results with organic listings, ads, and People Also Ask.
  </Card>

  <Card title="Extract structured data" icon="table">
    Pull product details, profiles, reviews, and more from 40+ platforms like Amazon, LinkedIn, Instagram, and TikTok.
  </Card>

  <Card title="Control a browser" icon="window-maximize">
    Navigate, click, type, screenshot, and read pages using a real remote browser session with persistent state.
  </Card>

  <Card title="Power up AI agents" icon="robot">
    Install skills or add the Bright Data MCP server into Claude Code, Cursor, Codex, and other AI coding agents.
  </Card>

  <Card title="Manage zones & budget" icon="gauge">
    List proxy zones, inspect configurations, and monitor account balance and per-zone costs.
  </Card>

  <Card title="Automate with pipes" icon="pipe-section">
    JSON output, file export, and pipe-friendly design make it easy to chain commands and build workflows.
  </Card>
</CardGroup>

## What the CLI looks like

```bash theme={null}
# Scrape a page as clean markdown
brightdata scrape https://news.ycombinator.com

# Search Google and get structured results
brightdata search "best web scraping tools 2025"


# Extract an Amazon product as JSON
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format json

# Control a remote browser session
brightdata browser open https://example.com
brightdata browser snapshot --compact

# Add Bright Data MCP server to your coding agent
brightdata add mcp
```

<Tip>
  The CLI alias `bdata` is available as a shorthand - e.g., `bdata scrape https://example.com`.
</Tip>

## How it works

The Bright Data CLI wraps the full Bright Data web data platform into simple terminal commands. Under the hood, it:

1. **Authenticates once** via OAuth, device flow, or API key - credentials are stored locally and never need to be entered again
2. **Auto-provisions zones** (`cli_unlocker`, `cli_browser`) on first login so you can start immediately
3. **Routes requests** through Bright Data's infrastructure, handling CAPTCHAs, bot detection, IP rotation, and JavaScript rendering
4. **Returns clean output** - formatted tables in the terminal, or structured JSON/CSV/markdown for automation

## Explore CLI resources

<CardGroup>
  <Card title="Installation" icon="download" href="/products/cli/installation">
    Install the CLI and authenticate with Bright Data.
  </Card>

  <Card title="Commands" icon="code" href="/products/cli/commands">
    Full reference for every command, flag, and option.
  </Card>

  <Card title="Usage Examples" icon="book-open" href="/products/cli/examples">
    Real-world workflows and recipes for common tasks.
  </Card>

  <Card title="FAQs" icon="question" href="/products/cli/faqs">
    Answers to common questions and troubleshooting tips.
  </Card>
</CardGroup>

<Check>
  **Zero configuration required.** After a one-time `brightdata login`, every command works out of the box - no tokens to manage, no zones to create, no proxies to configure.
</Check>


# Customization and filtering
Source: https://docs.brightdata.com/products/marketplace/customization-and-filtering

Customize fields and apply filters to Bright Data Marketplace datasets (250+ domains) using the UI or API to get the data subset you need.

Narrow down Bright Data Marketplace datasets (250+ domains) to the exact records and fields you need using the UI or API by creating filtered subsets and selecting the fields to include.

**What you can do:**

* **Customize fields:** choose which columns (fields) to include in your dataset view or export.
* **Filter a dataset:** create a saved subset using filter rules.

**Permissions:** You need access to the dataset and permission to create subsets.

## How to customize fields

Choose which fields (columns) appear in your Bright Data Marketplace dataset view and exports.

1. Navigate to the dataset you want to work with.
2. On the Data sample tab, click Edit table.
3. Select the fields you want to include in the view.
4. Click Apply, and save the view if prompted.

**Expected result:** The dataset preview and any export from this view include only the selected fields.

## How to filter a dataset

Create a saved subset of a Bright Data Marketplace dataset by applying filter rules in the UI or through the API.

### Filter a dataset using the UI

1. Navigate to the dataset you want to filter.
2. Click the Filter icon (top right).
3. Enter a name so you can find this subset later.
4. Under Include filters, add one or more filters (for example: country, job title, date).
5. Click Create subset.

**Expected result:** A new subset appears with only the records that match your filters.

### Filter operators reference

#### Select

Match one or more exact values from a predefined list (for example: countries or regions).

#### Boolean (true/false)

Filter fields that can only be true or false (for example: a field like `verified`).

#### Date

Filter records within a specific date range (start date and end date).

#### Number (operators)

* **Is:** match an exact numeric value.
* **Not:** exclude a numeric value.
* **Exists:** include only records where the field is not empty.
* **List (exact match):** match any value in a provided list.
* **Lower than / Lower or equal to:** match values below (or up to) a threshold.
* **Greater than / Greater or equal to:** match values above (or at) a threshold.

#### String

Filter text fields using the match types available in the UI (for example: exact match or contains).

#### Array

Use Array includes to match records where a multi-value (array) field contains a specific value (for example: categories, attributes or labels).

#### Upload a CSV list

If you need to match many values, use the CSV upload option in the value input. Upload a CSV with one value per row. After upload, the filter matches records where the array contains any value from the uploaded list.

#### CSV upload limitations

* **CSV format:** upload a `.csv` file with one value per row (single column).
* **Maximum 10,000 values per list:** to match more, split the values across multiple CSV lists, up to 100,000 values total, and apply them as filters in separate subsets.
* **No empty or whitespace-only lines:** lines that contain only spaces are rejected.
* **Single column only:** the CSV must contain only one column. If you include a header, it must be a single column.
* **One value per row:** put exactly one filter value on each row. Do not comma-separate multiple values on the same row.

### Includes vs List (exact match)

#### Includes

Use Includes to match records where the field contains the value you enter (partial match).

Example: if the field is `name` and you filter with Includes = `john`, you match values like `John Smith` and `Johnson`.

#### List (exact match)

Use List (exact match) to match records where the field value is exactly one of the values in your list (no partial matches).

Example: List (exact match) = `John Smith`, `Jane Doe` matches only those exact values.

### Group filters (rule-based filters)

1. Click + Add filter.
2. Select Add group.
3. Define your group rules (for example: category is "Electronics" and brand is "Dell" or "Apple").

**Expected result:** The subset includes only records that match your group logic.

### Limitations

* Filter groups can be nested up to 3 levels deep, with no limit on the number of sibling groups. See the [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax).
* A maximum of four inputs per filter group is allowed.
* To filter by more values, use a CSV list upload option (if available) or contact your account manager.
* For more complex queries, contact your account manager.

## Troubleshooting

* **I can't see the Filter icon.** Make sure you're viewing the dataset table and that your account has permission to create subsets.
* **My subset returns no results.** Remove filters one by one to identify the restrictive condition, then reapply the correct values and operators.

## Next steps

* [Export or download a dataset subset](/products/marketplace/data-delivery-and-export)
* [Filter a dataset by API](/products/marketplace/filter-dataset-by-api)
* [Bright Data Marketplace datasets overview](/left-over/marketplace-overview)


# Dataset view
Source: https://docs.brightdata.com/products/marketplace/dataset-view

Browse dataset details in the Bright Data Marketplace (250+ domains), including data fields, freshness, sample downloads and purchase options.

## How to preview a data sample

Some values in the data sample preview may be partially masked with asterisks `*`). This means the value is hidden in the preview and does not indicate that the field is missing. Full field availability depends on the dataset, selected filters, and purchase options.

* Data-fields
* Records
* Freshness
* Min order
* Download data sample: JSON, CSV, number records (display 30 records but you get 1,000 records)
* CSV/JSON
* Create a subset
* Talk to a data expert
* Purchase options

### How to customize a dataset

* Customize - Create a custom subset by hiding/showing and renaming fields and filter the dataset according to your requirements.
* Customize Fields
* Filter

## Where to view the data dictionary

* Search attribute
* Table
  * Column name
  * Description
  * Data type

## When to use this dataset

* Case study
* Related subset
* What category it’s related to

## What this dataset covers

* Description about the dataset
* What domain we collect from
* Use case categories
* Customize dataset CTA
* Delivery options
* FAQ

## Initiate by API

* Ability to submit a request through the API or the UI  to collect fresh data based on your own URLs (inputs)
* +Add input
* Upload CSV
* Creating API key to initiate a collection
* Setting the expected records
* Data Collection Choices
  * Discover new records
  * Specific URL collection
* Purchase options


# Marketplace fill rates
Source: https://docs.brightdata.com/products/marketplace/fill-rates-and-statistics

Review per-field fill rates, record counts and data freshness on the Statistics tab of any Bright Data Marketplace dataset (250+ domains) before purchase.

Every Bright Data Marketplace dataset page exposes field-level fill rates in the **Fill rate** column of the **Dictionary** tab, alongside the total record count and a freshness indicator; the **Statistics** tab holds dataset-level charts. Review these before purchase to confirm the dataset meets your requirements.

## What are fill rates?

A fill rate is the percentage of records in a dataset where a specific field is populated. A fill rate of 100 percent means every record contains a value for that field. A lower fill rate means some records are missing values for that field.

Fill rates vary depending on:

* The dataset type (social media, B2B, eCommerce)
* The source quality and what is publicly available
* The specific field being measured (email, phone number, location)

## Where to find fill rates

Fill rates and statistics are shown on each dataset's page in the Marketplace.

<Steps>
  <Step title="Open the Marketplace">
    In the Bright Data Control Panel, go to **Dataset Marketplace**.
  </Step>

  <Step title="Select a dataset">
    Open the dataset whose coverage you want to review.
  </Step>

  <Step title="Open the Dictionary tab">
    Navigate to the **Dictionary** tab and review the **Fill rate** column in the dictionary table to view field-level fill rates. The **Statistics** tab shows dataset-level charts.
  </Step>
</Steps>

## What statistics are available?

For each dataset you can review:

* **Fill rate per field**: percentage of records with a value
* **Record count**: total number of available records
* **Freshness**: how recently the data was collected

## Why do some fields have low fill rates?

Some fields have lower fill rates because of limitations or gaps in the publicly available source data. For example, phone numbers and email addresses are not always publicly listed, so contact fields commonly show lower fill rates than name or location fields.

<Tip>
  Always review fill rates before purchasing to confirm the data meets your specific requirements.
</Tip>


# Pricing
Source: https://docs.brightdata.com/products/marketplace/pricing

Understand how Bright Data Marketplace datasets are priced, including per-record costs and compute fees for pre-collected and fresh records.

* Pre-collected records
* Fresh records
* Pricing is determined based on compute cost and record cost to reach and collect the data.

For delivery methods and output formats, see [Data delivery and export](/products/marketplace/data-delivery-and-export).


# Purchase options
Source: https://docs.brightdata.com/products/marketplace/purchase-options

Compare 2 Bright Data Marketplace purchase options: one-time or subscription, pre-collected or fresh data, with supported delivery destinations.

* Purchase options → Flexibility
  * One-time purchase
  * Subscription

* Select data type
  * Pre-collected data - Access data that was collected recently and is ready for use.
  * Fresh data - Access data that's up-to-date and fresh, available immediately after it's collected.

* Data distribution  - shows how many records are available for the dataset

* Specific time range - Access data from a specific time range.(back from today)

* Available only for pre-collected.

* Select Period

* Collect fresh data for the rest of the records
  * Records outside of the specified time range will be scraped when the request is processed and will incur an additional fee. The refresh time depends on the size of the dataset. You'll get an email when your snapshot is ready.
  * As the data changes, these records may no longer match your filters and may be excluded from your dataset. If these records later do not meet your filters, they will be removed, but you will still be charged for the initial scrape.

* Set record limit - Enter the number of records you would like. Records are selected randomly. Notice that the price will change according to the record count.

* Order
  * Dataset name - “LinkedIn people profile dataset”
  * Total amount of records
  * “Records” - cost of total records
  * Number of records
  * Cost per record - \$0.0006
  * Subtotal - (before VAT or salestax)
  * Total

* Price adjustment (max snapshot cost)

* Small dataset fee (min snapshot cost)


# Bright Data MCP FAQs
Source: https://docs.brightdata.com/products/mcp-server/faqs

FAQs about the Bright Data MCP server (60+ tools): setup, hosted versus self-hosted modes, available tools, token usage and billing for AI agents.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<AccordionGroup>
  <Accordion title="What is Bright Data MCP Server?">
    Bright Data MCP (Model Context Protocol) is a server that enables LLMs, AI agents, and applications to access, discover, and extract web data in real-time. \
    It allows MCP clients like Claude Desktop, Cursor, and Windsurf to search the web, navigate websites, take actions, and retrieve data without getting blocked, making it perfect for web scraping tasks.\\

    * New MCP users get a **free tier** with 5,000 requests per month

    The MCP server provides advanced capabilities, including:

    * Bypassing geo-restrictions to access content regardless of location
    * Navigating websites with bot detection protection using unlocker technology
    * Structured data extraction from platforms like Amazon, LinkedIn, Instagram, and many other data feeds
    * Remote browser automation for complex web interactions
    * Access to a global IP network to avoid blocking or rate limiting

    **Get started with Bright Data MCP:**

    1. [**Explore the MCP GitHub repository**](https://github.com/brightdata/brightdata-mcp) to review the source code, contribute, or deploy your own instance.
    2. [**Read the MCP documentation**](/products/mcp-server/overview) to understand the API, request structure, and supported features.
    3. [Get your API key](https://brightdata.com/cp/setting/users)
    4. [**Try the Bright Data AI Playground**](https://brightdata.com/ai/playground-chat) to test and experiment with live requests in a no-code environment.
  </Accordion>

  <Accordion title="Are there limitations for the Bright Data free tier?">
    Yes, the free tier includes up to 5,000 requests per month for web search and web page scraping via Web Unlocker.
  </Accordion>

  <Accordion title="Where do I get my API keys?">
    You can get your API token from the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account. Make sure you have an account on [brightdata.com](https://brightdata.com) - new users get free credit for testing, and pay-as-you-go options are available after that.
  </Accordion>

  <Accordion title="Do I need a username to use the MCP server?">
    No. The Bright Data MCP server only requires an API token, for both the remote (hosted) and local (self-hosted) setup. Usernames (format: `brd-customer-{customer_id}-zone-{zone_name}`) are only used for native proxy access and are not needed for MCP, SDK or API integrations.

    If a third-party tool or integration asks for a username, you can leave it empty or check whether it is actually configuring proxy access.
  </Accordion>

  <Accordion title="How do I use Bright Data MCP Server?">
    Bright Data MCP (Model Context Protocol) is a server that allows AI agents, LLMs, and dev tools to access and extract real-time web data using Bright Data’s infrastructure. It is available as both a [remote (hosted)](/products/mcp-server/remote/quickstart) and [local (self-hosted)](/products/mcp-server/local/quickstart) server.

    To get started: [**BrightData MCP Overview**](/products/mcp-server/overview)

    **Helpful links:**

    * [MCP GitHub Repository](https://github.com/brightdata/brightdata-mcp)
    * [MCP Documentation](/products/mcp-server/overview)
    * [Try MCP in the AI Playground](https://brightdata.com/ai/playground-chat)
  </Accordion>

  <Accordion title="What can I do with Bright Data MCP Server?">
    Bright Data MCP allows you to integrate real-time web access into your AI agents or dev tools. It supports:

    **Search & Scraping:**

    * `search_engine`: Search Google, Bing, Yandex
    * `scrape_as_markdown`, `scrape_as_html`: Get content in clean formats
    * `session_stats`: Monitor tool usage

    **Structured Data Extraction:**

    * Amazon: `web_data_amazon_product`, `web_data_amazon_product_reviews`
    * LinkedIn: `web_data_linkedin_person_profile`, `web_data_linkedin_company_profile`
    * Instagram: `web_data_instagram_profiles`, `web_data_instagram_posts`, `web_data_instagram_reels`
    * Facebook: `web_data_facebook_posts`, `web_data_facebook_marketplace_listings`
    * Others: `web_data_x_posts`, `web_data_youtube_videos`, `web_data_zillow_properties_listing`

    **Browser Automation:**

    * `scraping_browser_navigate`, `scraping_browser_click_ref`, `scraping_browser_type_ref`
    * `scraping_browser_get_html`, `scraping_browser_screenshot`, `scraping_browser_wait_for_ref`

    **🔗 Full list of tools:** [MCP Tools on GitHub](https://github.com/brightdata/brightdata-mcp/blob/main/assets/Tools.md)
  </Accordion>

  <Accordion title="Which AI agents and tools can integrate with Bright Data MCP Server?">
    Bright Data MCP is designed to work with a wide range of AI tools and agents, including:

    * **Claude Desktop** (Anthropic)
    * **Cursor IDE**
    * **Windsurf**
    * **LangChain**
    * **AutoGPT / AgentGPT**
    * **Smithery**
    * **Custom LLMs or AI agents** that support MCP

    These tools can use MCP to:

    * Perform real-time web searches
    * Scrape structured data
    * Automate browser interactions
    * Access geo-restricted or protected content

    Try it live: [Bright Data AI Playground](https://brightdata.com/ai/playground-chat)
  </Accordion>

  <Accordion title="How do I enable browser control tools?">
    All you need is your Bright Data API key, the MCP server automatically creates and configures the required browser zone for you.

    To access browser tools, enable them using one of these methods:

    * **Pro mode:** Set `&pro=1` (remote) or `PRO_MODE=true` (self-hosted) to enable all tools, including browser automation
    * **Tool groups:** Set `&groups=browser` (remote) or `GROUPS=browser` (self-hosted) to enable just the browser automation tools

    For example, with the remote MCP:

    ```http theme={null}
    https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=browser
    ```

    See the [Remote Advanced Configuration](/products/mcp-server/remote/advanced) or [Local Advanced Configuration](/products/mcp-server/local/advanced) for more details.
  </Accordion>

  <Accordion title="What tools are available in the Bright Data MCP Server?">
    For the full list of tools, please refer to our GitHub repo: [MCP Tools](https://github.com/brightdata/brightdata-mcp/blob/main/assets/Tools.md).

    Bright Data MCP offers a comprehensive set of tools, including:

    **Search and basic scraping:**

    * `search_engine`: Scrape search results from Google, Bing, or Yandex
    * `scrape_as_markdown`: Scrape a webpage and get results in Markdown format
    * `scrape_as_html`: Scrape a webpage and get results in HTML format
    * `session_stats`: View tool usage during the current session

    **Structured data extraction:**

    * Amazon: `web_data_amazon_product`, `web_data_amazon_product_reviews`
    * LinkedIn: `web_data_linkedin_person_profile`, `web_data_linkedin_company_profile`
    * ZoomInfo: `web_data_zoominfo_company_profile`
    * Instagram: `web_data_instagram_profiles`, `web_data_instagram_posts`, `web_data_instagram_reels`, `web_data_instagram_comments`
    * Facebook: `web_data_facebook_posts`, `web_data_facebook_marketplace_listings`, `web_data_facebook_company_reviews`
    * Various others: `web_data_x_posts`, `web_data_zillow_properties_listing`, `web_data_booking_hotel_listings`, `web_data_youtube_videos`

    **Browser automation:**

    * `scraping_browser_navigate`: Navigate to a URL
    * `scraping_browser_go_back`/`scraping_browser_go_forward`: Navigate browser history
    * `scraping_browser_click_ref`: Click on an element
    * `scraping_browser_type_ref`: Type text into an element
    * `scraping_browser_wait_for_ref`: Wait for an element to appear
    * `scraping_browser_screenshot`: Take a screenshot
    * `scraping_browser_get_html`/`scraping_browser_get_text`: Get page content
  </Accordion>

  <Accordion title="How do I handle timeout issues when using Bright Data MCP Server?">
    Some web data tools can take longer to execute, especially when dealing with complex websites. To ensure your agent can consume the data:

    1. Set a high enough timeout in your agent settings (180 seconds is recommended)
    2. For particularly slow sites, you may need to increase this value further
    3. Use the specialized `web_data_*` tools when available, as they're often faster than general scraping
    4. For browser automation sequences, keep operations close together in time
  </Accordion>

  <Accordion title="What security considerations should I keep in mind?">
    Always treat scraped web content as untrusted data. Never use raw scraped content directly in LLM prompts to avoid potential prompt injection risks. Instead:

    * Filter and validate all web data before passing it to the LLM
    * Use structured data extraction rather than raw text when possible
    * Be cautious with executing JavaScript from scraped content
  </Accordion>

  <Accordion title="Why am I getting a 'spawn npx ENOENT' error?">
    This error occurs when your system cannot find the `npx` command. To fix it:

    1. Find your Node.js path:
       * On macOS: Run `which node` in Terminal
       * On Windows: Run `where node` in Command Prompt
    2. Update your MCP configuration to use the full path instead of `npx`:

    ```json theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "/usr/local/bin/node", // Replace with your actual Node.js path
          "args": ["node_modules/@brightdata/mcp/index.js"],
          "env": {
            "API_TOKEN": "YOUR_API_KEY"
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="How do I monitor my usage and costs?">
    You can use the `session_stats` tool to check your usage during the current session. For comprehensive usage tracking and billing information, log in to your Bright Data account dashboard. The `session_stats` tool will show you information about:

    * Number of requests made during the current session
    * Tools used and their frequency
  </Accordion>

  <Accordion title="Is there a playground where I can try Bright Data MCP Server?">
    Yes, you can try Bright Data MCP without any setup using the [Bright Data AI Playground](https://brightdata.com/ai/playground-chat). It provides an easy way to explore the capabilities of Bright Data MCP without any local setup. Just sign in and start experimenting with web data collection!
  </Accordion>

  <Accordion title="How do I connect my AI agent with Bright Data's MCP?">
    You can connect your AI agent with Bright Data by following these steps:

    1. Install [Node.js](https://nodejs.org/en/download) (only required for the self-hosted option)
    2. Create a [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing)
    3. Copy your API key from the [user settings page](https://brightdata.com/cp/setting/users) (new users receive an **API key** in the welcome email)
    4. Configure your agent with your API key. For more detailed examples, visit us on [GitHub](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-usage-examples) or check our [MCP documentation](/products/mcp-server/overview#configuration).
  </Accordion>

  <Accordion title="When using MCP, should I create zones or configure them?">
    No, zones are created automatically for you. All you need is Node.js (for self-hosted) and your Bright Data API key. If you want to change your zone name to something specific, you can always do so through the [control panel](https://brightdata.com/cp/zones).
  </Accordion>

  <Accordion title="Is there a free access tier for the Bright Data MCP?">
    Yes! Bright Data provides a free tier of **5,000 requests/month** to new MCP users. The free tier includes web search and web page scraping via Web Unlocker. See [What is the MCP free tier?](#) below for more details.
  </Accordion>

  <Accordion title="What is the MCP free tier?">
    The MCP free tier allows you to connect your AI agent via MCP (Model Context Protocol) to Bright Data services for free.
    You get up to 5,000 requests per month for web search and scraping any public webpage via Web Unlocker at no cost. This is ideal for testing, development, or light usage.

    The MCP free tier is not a separate grant. It is the same account-level [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month, drawn from a single shared pool, because the MCP server runs on the Web Unlocker API.

    For more information, see the [Remote MCP Quickstart](/products/mcp-server/remote/quickstart).
  </Accordion>

  <Accordion title="What happens when the free tier limit is reached?">
    When you exceed the 5,000 monthly request limit on the free tier, requests will start failing. To continue using the MCP server, you need to create a new Web Unlocker zone and configure the MCP to use it:

    1. Go to [brightdata.com/cp](https://brightdata.com/cp) and click **Add** (top-right)
    2. Select **Unlocker zone** and create it with any name (e.g., `my_unlocker`)
    3. Update your MCP configuration to use the new zone:
       * **Remote MCP:** Add `&unlocker=ZONE_NAME` to your MCP URL
       * **Self-hosted MCP:** Set the `WEB_UNLOCKER_ZONE=ZONE_NAME` environment variable
    4. Restart your MCP client (e.g., Claude Desktop, Cursor) after the configuration change
  </Accordion>

  <Accordion title="Can I run multiple MCP instances in parallel?">
    Yes, you can run multiple MCP instances for parallelized workloads. However, if you are using the self-hosted (local) MCP with `npx`, each instance downloads and caches the package separately, which can consume significant disk space.

    For parallel use cases, we recommend using the **Remote MCP** instead. It requires no local installation, runs entirely in the cloud, and eliminates disk space concerns. Simply point each instance to the remote endpoint:

    ```http theme={null}
    https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN
    ```

    See the [Remote MCP Quickstart](/products/mcp-server/remote/quickstart) for setup instructions.
  </Accordion>
</AccordionGroup>


# Local MCP server advanced configuration
Source: https://docs.brightdata.com/products/mcp-server/local/advanced

Customize the local Bright Data MCP server (60+ tools): enable Browser API, configure proxies, set rate limits and pass environment variables.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## MCP Server Modes

Bright Data's MCP server offers two modes to suit different needs:

* **Rapid (Free)** - Quickly scrape search results and unlock any public webpage as clean Markdown.
* **Pro** - Access advanced scraping, structured data from top platforms (Amazon, LinkedIn, X, Instagram, etc.), and full browser automation. Built for dynamic and large-scale use cases.
* **Groups** - Unlock targeted capabilities with pre-built bundles. Whether you're monitoring competitors, analyzing social trends, or automating browsers, select the exact tool groups your project requires.
* **Tools** -  Fine-tune your toolkit. Cherry-pick individual tools to supplement your Groups or build a completely custom setup for specialized use cases.

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

***

## How to configure the local MCP server

When using the MCP server locally, you can set environment variables for finer control:

* `RATE_LIMIT` - Set the rate limit for requests (*default:* `100/1h`).
* `WEB_UNLOCKER_ZONE` - Override the default web unlocker zone (*default:* `mcp_unlocker`).
* `BROWSER_ZONE` - Override the default browser zone (*default:* `mcp_browser`).
* `PRO_MODE` - Set to true/false to enable/disable Pro tools (*default:* `false`).
* `GROUPS` - Comma-separated list of tool group IDs to enable (e.g., `browser,ecommerce,social`). Available groups: `ecommerce`, `social`, `browser`, `finance`, `business`, `research`, `app_stores`, `travel`, `advanced_scraping`, `geo`, `code`.
* `TOOLS` - Comma-separated list of individual tool names to add on top of selected groups (e.g., `web_data_linkedin_person_profile,scrape_as_html`). Use this to fine-tune your toolkit with specific capabilities.

> **Note:** `PRO_MODE=true` enables all tools. If you use `GROUPS` or `TOOLS`, they take priority and override Pro mode.

<Tip>
  Use `PRO_MODE=true` to enable **Pro mode**.
</Tip>

### Example configuration

```json theme={null}
{
  "mcpServers":{
    "Bright Data":{
      "command":"npx",
      "args":["@brightdata/mcp"],
      "env":{
        "API_TOKEN":"YOUR_API_KEY",
        "WEB_UNLOCKER_ZONE": "my_zone_name",
        "BROWSER_ZONE": "my_browser_zone",
        "PRO_MODE": "true",
        "GROUPS": "browser,advanced_scraping",
        "TOOLS": "web_data_linkedin_person_profile,web_data_amazon_product"
      }
    }
  }
}
```


# How to set up local (self-hosted) MCP
Source: https://docs.brightdata.com/products/mcp-server/local/quickstart

Set up a self-hosted Bright Data MCP server: step-by-step installation, configuration and connection to AI agents like Claude or Cursor in under 10 minutes.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Steps>
  <Step title="Prerequisites">
    Before you begin, make sure you have the following:

    <CardGroup>
      <Card title="Bright Data Account" icon="user" href="https://brightdata.com/?hs_signup=1&utm_source=docs">
        *Sign up for free and receive **5,000 requests** per month at no cost.*
      </Card>

      <Card title="Your Bright Data API Key" icon="key" href="https://brightdata.com/cp/setting">
        *New users receive their API key in the welcome email.*
      </Card>
    </CardGroup>

    <Card title="Node.js" icon="node-js" href="https://nodejs.org/en/download">
      *Ensure Node.js is installed and up to date.*
    </Card>

    <Tip>
      No username is required. The self-hosted MCP server authenticates with your `API_TOKEN` only. Usernames (format: `brd-customer-{customer_id}-zone-{zone_name}`) are for native proxy access, not MCP. If a third-party tool asks for a username, leave it empty.
    </Tip>
  </Step>

  <Step title="Choose Your Client">
    Select and configure your preferred MCP client:

    * <a href="/products/mcp-server/integrations/claude#self-hosted-mcp"><span> Claude</span></a>
    * <a href="/integrations/n8n#self-hosted-mcp-integration"><span> n8n</span></a>
  </Step>

  <Step title="Quick Examples">
    Try these example prompts with your MCP server:

    <AccordionGroup>
      <Accordion title="Extract real-time data from Google">
        “Extract all flight times departing from JFK Airport to Heathrow in the next 24 hours.”
      </Accordion>

      <Accordion title="Extract company data from LinkedIn">
        “Extract the Bright Data overview section from LinkedIn.”
      </Accordion>

      <Accordion title="Extract dynamic data from eBay">
        “Go to ebay.com, click the ‘Shop by category’ button in the navigation bar, and extract all categories.”
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

<Card title="Advanced Configuration" icon="sliders" href="/products/mcp-server/local/advanced">
  See the Advanced Configuration page for more details.
</Card>


# MCP server overview
Source: https://docs.brightdata.com/products/mcp-server/overview

Use the Bright Data MCP server to give AI agents real-time access to public web data with 5,000 free requests per month and zero infrastructure setup.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The **Bright Data MCP server** gives AI agents and assistants real-time access to public web data through the Model Context Protocol (MCP). Connect it to Claude, Cursor or any MCP-compatible client, and your agent can search, scrape and read live web pages without you building or maintaining data pipelines.

The MCP server runs on the Web Unlocker API, so every request handles proxy rotation, anti-bot challenges and CAPTCHA solving automatically. Every new account includes 5,000 free requests per month. You can run the server two ways: a fully managed remote server, or a self-hosted local instance.

<Card title="Get started for free" icon="rocket" href="https://brightdata.com/?hs_signup=1&utm_source=docs">
  Start using the Bright Data MCP server with **5,000 requests** per month, completely free.
</Card>

## Choose your MCP server

<CardGroup>
  <Card title="Remote (hosted) MCP" icon="cloud" href="/products/mcp-server/remote/quickstart">
    Launch a fully managed MCP server in the cloud, no setup required.
  </Card>

  <Card title="Local (self-hosted) MCP" icon="house" href="/products/mcp-server/local/quickstart">
    Set up your own MCP server instance on-premise or in your private cloud.
  </Card>
</CardGroup>

<Tip>
  **Optimize your token usage:** Select only the tools you need using [tool groups](/products/mcp-server/tools) (e.g., `groups=ecommerce,social`) or individual tools (e.g., `tools=web_data_amazon_product`). This reduces context size and maximizes your usage.
</Tip>

## Explore MCP server resources

<CardGroup>
  <Card title="Tools" icon="wrench" href="/products/mcp-server/tools">
    Discover the built-in tools available for your MCP server.
  </Card>

  <Card title="FAQs" icon="book-open" href="/products/mcp-server/faqs">
    Get quick answers to frequently asked MCP server questions.
  </Card>

  <Card title="Usage examples" icon="code" href="/products/mcp-server/usage-examples">
    Learn from practical examples to accelerate your implementation.
  </Card>

  <Card title="Integrations" icon="puzzle-piece" href="/products/mcp-server/integrations/overview">
    Connect the MCP server with leading AI platforms like Claude, Cursor and more.
  </Card>

  <Card title="Source code" icon="github" href="https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-usage-examples">
    Explore the MCP server source code on GitHub.
  </Card>
</CardGroup>

<Note>
  The MCP free tier is the same account-level [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month, drawn from a single shared pool, because the MCP server runs on the Web Unlocker API. For team accounts, that free tier is shared across all users within the account. If you require additional credits, please contact your account manager.
</Note>


# Remote MCP server advanced configuration
Source: https://docs.brightdata.com/products/mcp-server/remote/advanced

Customize the remote Bright Data MCP server (60+ tools): configure auth tokens, switch proxies, tune timeouts and enable advanced tools per session.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## MCP Server Modes

Bright Data's MCP server offers two modes to suit different needs:

* **Rapid (Free)** - Quickly scrape search results and unlock any public webpage as clean Markdown.
* **Pro** - Access advanced scraping, structured data from top platforms (Amazon, LinkedIn, X, Instagram, etc.), and full browser automation. Built for dynamic and large-scale use cases.
* **Groups** - Unlock targeted capabilities with pre-built bundles. Whether you're monitoring competitors, analyzing social trends, or automating browsers, select the exact tool groups your project requires.
* **Tools** -  Fine-tune your toolkit. Cherry-pick individual tools to supplement your Groups or build a completely custom setup for specialized use cases.

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

***

## How to configure the remote MCP server

When using a remote MCP server, you can configure advanced options by passing query parameters to your endpoint:

<ParamField type="string">
  Use a custom zone name for web scraping.

  > **For example:** `&unlocker=my_zone_name`
</ParamField>

<ParamField type="string">
  Use a custom zone name for browser automation.

  > **For example:** `&browser=my_browser_zone`
</ParamField>

<ParamField type="number">
  Enable advanced (Pro) processing.

  > **For example:** `&pro=1`

  <Tip>
    Use `&pro=1` to enable **Pro mode**.
  </Tip>
</ParamField>

<ParamField type="string">
  Select pre-built tool bundles tailored to your domain. Comma-separated list of group IDs.

  > **For example:** `&groups=browser,ecommerce,social`

  <Tip>
    Available groups: `ecommerce`, `social`, `browser`, `finance`, `business`, `research`, `app_stores`, `travel`, `advanced_scraping`, `geo`, `code`
  </Tip>
</ParamField>

<ParamField type="string">
  Handpick individual tools to complement your groups selection. Comma-separated list of tool names.

  > **For example:** `&tools=scrape_as_markdown,web_data_linkedin_person_profile`

  <Warning>
    Using `groups` or `tools` overrides `pro=1`. Tool selection takes priority over Pro mode.
  </Warning>
</ParamField>

### Example configurations

<CodeGroup>
  ```sh SSE - Pro Mode (All Tools) theme={null}
  https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&pro=1
  ```

  ```sh SSE - Tool Groups theme={null}
  https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=browser,ecommerce,social
  ```

  ```sh SSE - Custom Tools theme={null}
  https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=browser&tools=web_data_linkedin_person_profile,scrape_as_html
  ```

  ```sh HTTP - Pro Mode (All Tools) theme={null}
  https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&pro=1
  ```

  ```sh HTTP - Tool Groups theme={null}
  https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&groups=browser,ecommerce,social
  ```

  ```sh HTTP - Custom Tools theme={null}
  https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN&groups=browser&tools=web_data_linkedin_person_profile,scrape_as_html
  ```
</CodeGroup>

***


# How to get started with remote MCP server
Source: https://docs.brightdata.com/products/mcp-server/remote/quickstart

Connect AI agents to the fully managed Bright Data Remote MCP server (60+ tools) with no setup: authentication, tool selection and a working sample request.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Steps>
  <Step title="Prerequisites">
    Before getting started, make sure you have the following:

    <CardGroup>
      <Card title="Bright Data Account" icon="user" href="https://brightdata.com/?hs_signup=1&utm_source=docs">
        *Sign up for free and receive **5,000 requests** per month at no cost.*
      </Card>

      <Card title="Your Bright Data API Key" icon="key" href="https://brightdata.com/cp/setting">
        *New users receive their API key via the welcome email.*
      </Card>
    </CardGroup>
  </Step>

  <Step title="Select Your Endpoint">
    Use one of the following endpoints to connect to the Remote MCP Server:

    <CodeGroup>
      ```sh SSE (Server-Sent Events) endpoint: theme={null}
      https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN
      ```

      ```sh Streamable HTTP endpoint: theme={null}
      https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
      ```
    </CodeGroup>

    <Tip>
      Replace `YOUR_API_TOKEN` with your actual Bright Data API token.
    </Tip>

    <Tip>
      No username is required. The Remote MCP server authenticates with your API token only. Usernames (format: `brd-customer-{customer_id}-zone-{zone_name}`) are for native proxy access, not MCP. If a third-party tool asks for a username, leave it empty.
    </Tip>
  </Step>

  <Step title="Choose Your Client">
    Select and configure your preferred client:

    * <a href="/products/mcp-server/integrations/claude#hosted-mcp"><span> Claude</span></a>
    * <a href="/products/mcp-server/integrations/cursor"><span> Cursor</span></a>
    * <a href="/integrations/n8n#sse-based-mcp-integration"><span> n8n</span></a>
  </Step>

  <Step title="Quick Examples">
    Try these sample prompts with your MCP Server:

    <AccordionGroup>
      <Accordion title="Extract real-time data from Google">
        “Extract all flight times departing from JFK Airport to Heathrow in the next 24 hours.”
      </Accordion>

      <Accordion title="Extract company data from LinkedIn">
        “Extract the Bright Data overview section from LinkedIn.”
      </Accordion>

      <Accordion title="Extract dynamic data from eBay">
        “Go to ebay.com, click the ‘Shop by category’ button in the navigation bar, and extract all categories.”
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

<Card title="Advanced Configuration" icon="sliders" href="/products/mcp-server/remote/advanced#remote-configuration">
  See the Advanced Configuration page for more details.
</Card>


# Bright Data MCP tools
Source: https://docs.brightdata.com/products/mcp-server/tools

Reference for the Bright Data MCP server tools (60+ tools): web search, scraping, structured data and platform extractors for ecommerce and social workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Note>
  ### Modes: Rapid (Free), Pro and 11 tool groups

  Bright Data's MCP server offers two modes to suit different needs:

  * <Icon icon="gift" />   **Rapid (Free)** - Quickly scrape search results and unlock any public webpage as clean Markdown.
  * <Icon icon="gem" />   **Pro** - Access advanced scraping, structured data from top platforms (Amazon, LinkedIn, X, Instagram, etc.), and full browser automation. Built for dynamic and large-scale use cases.
  * <Icon icon="layer-group" />  **Groups** - Pre-configured tool collections for specific use cases including E-commerce, Social Media, Browser Automation, Business Intelligence, Finance, Research, App Stores, Travel, Advanced Scraping, GEO & LLM Visibility, and Code. Each group bundles relevant tools and data feeds for its domain.

  ***

  To use **Pro mode**:

  * In Remote MCP, request Pro features by setting `&pro=1`.
  * In Local MCP, enable Pro features with `PRO_MODE=true`.

  To use **Groups:**

  * In Remote MCP, request the Groups by setting `&groups=<group_name>`.
  * In Local MCP, enable Groups  with `GROUPS=<group_name>`.
</Note>

<Tip>
  **Rapid (Free)** mode is enabled by default and is **recommended** for everyday browsing and data needs.
</Tip>

## Bright Data MCP Tools Reference

| Mode | Tool Name | Description | Group |
| :-: | :- | :- | - |
| <Icon icon="gift" /> | `search_engine` | Scrape search results from Google, Bing, or Yandex. Returns SERP results in JSON for Google and Markdown for Bing/Yandex; supports pagination with the cursor parameter. | `all` |
| <Icon icon="gift" /> | `scrape_as_markdown` | Scrape a single webpage with advanced extraction and return Markdown. Uses Bright Data's unlocker to handle bot protection and CAPTCHA. | `all` |
| <Icon icon="gift" /> | `search_engine_batch` | Run up to 10 search queries in parallel. Returns JSON for Google results and Markdown for Bing/Yandex. | `advanced_scraping` |
| <Icon icon="gift" /> | `scrape_batch` | Scrape up to 10 webpages in one request and return an array of URL/content pairs in Markdown format. | `advanced_scraping` |
| <Icon icon="gem" /> | `scrape_as_html` | Scrape a single webpage with advanced extraction and return the HTML response body. Handles sites protected by bot detection or CAPTCHA. | `advanced_scraping` |
| <Icon icon="gem" /> | `extract` | Scrape a webpage as Markdown and convert it to structured JSON using AI sampling, with an optional custom extraction prompt. | `advanced_scraping` |
| <Icon icon="gem" /> | `session_stats` | Report how many times each tool has been called during the current MCP session. | `advanced_scraping` |
| <Icon icon="gem" /> | `web_data_amazon_product` | Quickly read structured Amazon product data. Requires a valid product URL containing /dp/. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_amazon_product_reviews` | Quickly read structured Amazon product review data. Requires a valid product URL containing /dp/. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_amazon_product_search` | Retrieve structured Amazon search results. Requires a search keyword and Amazon domain URL; limited to the first page of results. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_walmart_product` | Quickly read structured Walmart product data. Requires a product URL containing /ip/. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_walmart_seller` | Quickly read structured Walmart seller data. Requires a valid Walmart seller URL. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_ebay_product` | Quickly read structured eBay product data. Requires a valid eBay product URL. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_homedepot_products` | Quickly read structured Home Depot product data. Requires a valid homedepot.com product URL. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_zara_products` | Quickly read structured Zara product data. Requires a valid Zara product URL. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_etsy_products` | Quickly read structured Etsy product data. Requires a valid Etsy product URL. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_bestbuy_products` | Quickly read structured Best Buy product data. Requires a valid Best Buy product URL. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_linkedin_person_profile` | Quickly read structured LinkedIn people profile data. Requires a valid LinkedIn profile URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_linkedin_company_profile` | Quickly read structured LinkedIn company profile data. Requires a valid LinkedIn company URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_linkedin_job_listings` | Quickly read structured LinkedIn job listings data. Requires a valid LinkedIn jobs URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_linkedin_posts` | Quickly read structured LinkedIn posts data. Requires a valid LinkedIn post URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_linkedin_people_search` | Quickly read structured LinkedIn people search data. Requires a LinkedIn people search URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `list_dataset_fields` | List the filterable fields of a searchable dataset with each field's name, type and description. Call before `search_dataset` to learn which fields you can filter on. | `social`, `business` |
| <Icon icon="gem" /> | `search_dataset` | Search a Bright Data dataset by a filter and get matching records back directly, with no snapshot step. Finds many records by criteria, unlike `web_data_*` tools that fetch one record by URL. Returns up to 10 records per call with `search_after` pagination. | `social`, `business` |
| <Icon icon="gem" /> | `web_data_crunchbase_company` | Quickly read structured Crunchbase company data. Requires a valid Crunchbase company URL. Often faster and more reliable than scraping. | `business` |
| <Icon icon="gem" /> | `web_data_zoominfo_company_profile` | Quickly read structured ZoomInfo company profile data. Requires a valid ZoomInfo company URL. Often faster and more reliable than scraping. | `business` |
| <Icon icon="gem" /> | `web_data_instagram_profiles` | Quickly read structured Instagram profile data. Requires a valid Instagram profile URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_instagram_posts` | Quickly read structured Instagram post data. Requires a valid Instagram post URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_instagram_reels` | Quickly read structured Instagram reel data. Requires a valid Instagram reel URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_instagram_comments` | Quickly read structured Instagram comments data. Requires a valid Instagram URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_facebook_posts` | Quickly read structured Facebook post data. Requires a valid Facebook post URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_facebook_marketplace_listings` | Quickly read structured Facebook Marketplace listing data. Requires a valid Marketplace listing URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_facebook_company_reviews` | Quickly read structured Facebook company reviews data. Requires a valid Facebook company URL and review count. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_facebook_events` | Quickly read structured Facebook events data. Requires a valid Facebook event URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_tiktok_profiles` | Quickly read structured TikTok profile data. Requires a valid TikTok profile URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_tiktok_posts` | Quickly read structured TikTok post data. Requires a valid TikTok post URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_tiktok_shop` | Quickly read structured TikTok Shop product data. Requires a valid TikTok Shop product URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_tiktok_comments` | Quickly read structured TikTok comments data. Requires a valid TikTok video URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_google_maps_reviews` | Quickly read structured Google Maps reviews data. Requires a valid Google Maps URL and optional days\_limit (default 3). Often faster and more reliable than scraping. | `business` |
| <Icon icon="gem" /> | `web_data_google_shopping` | Quickly read structured Google Shopping product data. Requires a valid Google Shopping product URL. Often faster and more reliable than scraping. | `ecommerce` |
| <Icon icon="gem" /> | `web_data_google_play_store` | Quickly read structured Google Play Store app data. Requires a valid Play Store app URL. Often faster and more reliable than scraping. | `app_stores` |
| <Icon icon="gem" /> | `web_data_apple_app_store` | Quickly read structured Apple App Store app data. Requires a valid App Store app URL. Often faster and more reliable than scraping. | `app_stores` |
| <Icon icon="gem" /> | `web_data_github_repository_file` | Quickly read structured GitHub repository file data. Requires a valid GitHub file URL. Often faster and more reliable than scraping. | `research` |
| <Icon icon="gem" /> | `web_data_yahoo_finance_business` | Quickly read structured Yahoo Finance company profile data. Requires a valid Yahoo Finance business URL. Often faster and more reliable than scraping. | `finance` |
| <Icon icon="gem" /> | `web_data_x_posts` | Quickly read structured X (Twitter) post data. Requires a valid X post URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_x_profile_posts` | Quickly read structured X posts from a profile. Requires a valid X profile URL. Returns the most recent posts, with optional date range filtering. | `social` |
| <Icon icon="gem" /> | `web_data_zillow_properties_listing` | Quickly read structured Zillow property listing data. Requires a valid Zillow listing URL. Often faster and more reliable than scraping. | `business` |
| <Icon icon="gem" /> | `web_data_booking_hotel_listings` | Quickly read structured Booking.com hotel listing data. Requires a valid Booking.com listing URL. Often faster and more reliable than scraping. | `travel` |
| <Icon icon="gem" /> | `web_data_youtube_videos` | Quickly read structured YouTube video metadata. Requires a valid YouTube video URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_youtube_profiles` | Quickly read structured YouTube channel profile data. Requires a valid YouTube channel URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_youtube_comments` | Quickly read structured YouTube comments data. Requires a valid YouTube video URL and optional num\_of\_comments (default 10). Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `web_data_reddit_posts` | Quickly read structured Reddit post data. Requires a valid Reddit post URL. Often faster and more reliable than scraping. | `social` |
| <Icon icon="gem" /> | `scraping_browser_navigate` | Open or reuse a scraping-browser session and navigate to the provided URL, resetting tracked network requests. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_go_back` | Navigate the active scraping-browser session back to the previous page and report the new URL and title. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_go_forward` | Navigate the active scraping-browser session forward to the next page and report the new URL and title. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_snapshot` | Capture an ARIA snapshot of the current page listing interactive elements and their refs for later ref-based actions. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_click_ref` | Click an element using its ref from the latest ARIA snapshot; requires a ref and human-readable element description. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_type_ref` | Fill an element identified by ref from the ARIA snapshot, optionally pressing Enter to submit after typing. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_screenshot` | Capture a screenshot of the current page; supports optional full\_page mode for full-length images. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_network_requests` | List the network requests recorded since page load with HTTP method, URL, and response status for debugging. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_wait_for_ref` | Wait until an element identified by ARIA ref becomes visible, with an optional timeout in milliseconds. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_get_text` | Return the text content of the current page's body element. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_get_html` | Return the HTML content of the current page; avoid the full\_page option unless head or script tags are required. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_scroll` | Scroll to the bottom of the current page in the scraping-browser session. | `browser` |
| <Icon icon="gem" /> | `scraping_browser_scroll_to_ref` | Scroll the page until the element referenced in the ARIA snapshot is in view. | `browser` |
| <Icon icon="gem" /> | `web_data_chatgpt_ai_insights` | Send a prompt to ChatGPT and get back AI-generated insights. Returns structured answer text, citations, recommendations, and markdown. Useful for GEO and LLM as a judge. | `geo` |
| <Icon icon="gem" /> | `web_data_grok_ai_insights` | Send a prompt to Grok and get back AI-generated insights. Returns structured answer text in markdown format. Useful for GEO and LLM as a judge. | `geo` |
| <Icon icon="gem" /> | `web_data_perplexity_ai_insights` | Send a prompt to Perplexity and get back AI-generated insights. Returns structured answer text in markdown format. Useful for GEO and LLM as a judge. | `geo` |
| <Icon icon="gem" /> | `web_data_npm_package` | Quickly read structured npm package data. Requires a valid npm package name (e.g., `@brightdata/sdk`). Often faster and more reliable than scraping. | `code` |
| <Icon icon="gem" /> | `web_data_pypi_package` | Quickly read structured PyPI package data. Requires a valid PyPI package name (e.g., `langchain-brightdata`). Often faster and more reliable than scraping. | `code` |

## How do I search datasets by filter with the Bright Data MCP server?

Use `list_dataset_fields` and `search_dataset` to find many records that match your criteria, as opposed to the `web_data_*` tools, which fetch one record by URL. The search runs directly against the dataset with no snapshot step and returns up to 10 records per call. Under the hood, `list_dataset_fields` calls the [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata) endpoint and `search_dataset` calls the [Search dataset](/api-reference/marketplace-dataset-api/search-dataset) endpoint of the Marketplace Dataset API.

Three datasets are searchable:

| `dataset_id` | Dataset |
| :- | :- |
| `gd_l1viktl72bvl7bjuj0` | LinkedIn people profiles |
| `gd_me5ppxjr2ge6icjuh0` | LinkedIn people profiles (contact-enriched) |
| `gd_l1vikfnt1wgvvqz95w` | LinkedIn company information |

The workflow is two calls:

1. Call `list_dataset_fields` with a `dataset_id`. It returns each filterable field's name, type and description.
2. Call `search_dataset` with the same `dataset_id` and a `filter`.

A filter is a tree with a maximum nesting depth of three. Each node is either a group, `{"operator": "and" | "or", "filters": [...]}`, or a leaf, `{"name": ..., "operator": ..., "value": ...}`. See [filter syntax](/api-reference/marketplace-dataset-api/filter-syntax) for the full list of leaf operators and their behavior.

For example, this filter matches profiles in the United States whose position mentions data engineering:

```json theme={null}
{
  "operator": "and",
  "filters": [
    { "name": "country_code", "operator": "=", "value": "US" },
    { "name": "position", "operator": "includes", "value": "data engineer" }
  ]
}
```

The response contains `hits` (the matching records), `total_hits` and `took` (search time in milliseconds). To page through more than 10 results, set `sort` to `"default"` or a custom sort like `[{"timestamp": "asc"}]`, then pass the response's `search_after` cursor into the next call. Set `sort` to `"random"` to sample records instead.


# TOON format for Bright Data MCP
Source: https://docs.brightdata.com/products/mcp-server/toon

Use Token-Oriented Object Notation (TOON) with the Bright Data MCP server (60+ tools) to cut token usage on large web data payloads without losing structure.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## What is TOON?

**Token-Oriented Object Notation (TOON)** is a compact, human-readable encoding of the JSON data model designed specifically for LLM input. It minimizes token usage while maintaining full data fidelity, making it an excellent choice for reducing costs when processing large amounts of structured data.

TOON combines YAML's indentation-based structure with a CSV-style tabular layout for uniform arrays, achieving **30-60% token reduction** compared to standard JSON.

<Info>
  TOON is a **translation layer** - use JSON programmatically in your code, and encode it as TOON when passing data to LLMs.
</Info>

***

## How TOON Works

### The Problem with JSON

Standard JSON repeats field names for every record, which is token-expensive:

```json theme={null}
{
  "products": [
    { "id": 1, "name": "Laptop", "price": 999 },
    { "id": 2, "name": "Mouse", "price": 29 },
    { "id": 3, "name": "Keyboard", "price": 79 }
  ]
}
```

### The TOON Solution

TOON declares fields once and streams data as compact rows:

```yaml theme={null}
products[3]{id,name,price}:
  1,Laptop,999
  2,Mouse,29
  3,Keyboard,79
```

* `[3]` declares the array length (helps detect truncation)
* `{id,name,price}` declares field names once
* Each row contains comma-separated values

***

## Token Savings Example

<CardGroup>
  <Card title="JSON" icon="file-code">
    **235 tokens**

    Verbose with repeated keys
  </Card>

  <Card title="TOON" icon="compress">
    **106 tokens**

    \~55% reduction
  </Card>
</CardGroup>

```json JSON (235 tokens) theme={null}
{
  "context": {
    "task": "Product catalog",
    "category": "Electronics"
  },
  "items": [
    { "id": 1, "name": "Laptop", "price": 999, "stock": 50, "active": true },
    { "id": 2, "name": "Mouse", "price": 29, "stock": 200, "active": true },
    { "id": 3, "name": "Keyboard", "price": 79, "stock": 150, "active": false }
  ]
}
```

```yaml TOON (106 tokens) theme={null}
context:
  task: Product catalog
  category: Electronics
items[3]{id,name,price,stock,active}:
  1,Laptop,999,50,true
  2,Mouse,29,200,true
  3,Keyboard,79,150,false
```

***

## When to Use TOON

<Check>
  **TOON excels with flat, uniform arrays of objects** - data where items share the same structure across all records.
</Check>

### Ideal Use Cases

| Data Type | Example | Token Savings |
| - | - | - |
| Product listings | E-commerce catalogs | 40-60% |
| User records | Flat profile data | 35-55% |
| Log entries | Structured logs | 45-60% |
| Search results | SERP data (flat) | 40-55% |
| Simple tables | Spreadsheet-like data | 50-65% |

***

## When NOT to Use TOON

<Warning>
  **TOON performs poorly on deeply nested or non-uniform data structures.** This is particularly relevant for Bright Data MCP responses.
</Warning>

### Avoid TOON When:

<AccordionGroup>
  <Accordion title="Data is deeply nested" icon="sitemap">
    Complex objects with multiple nesting levels don't benefit from TOON's tabular format. JSON-compact often uses fewer tokens for such structures.

    **Example:** LinkedIn profiles with nested experience, education, and skills objects.
  </Accordion>

  <Accordion title="Data is non-uniform" icon="shuffle">
    When array items have different fields or optional properties, TOON's header-based approach breaks down.

    **Example:** Mixed product types with varying attributes.
  </Accordion>

  <Accordion title="Using Bright Data MCP structured endpoints" icon="database">
    Most Bright Data web data endpoints return **richly nested JSON** with hierarchical relationships. TOON won't provide meaningful savings here.

    **Example:** `web_data_amazon_product`, `web_data_linkedin_person_profile`, etc.
  </Accordion>
</AccordionGroup>

***

## TOON with Bright Data MCP

### Understanding the Limitation

Bright Data's MCP server returns structured data from platforms like Amazon, LinkedIn, Instagram, and more. This data is typically **nested and hierarchical**, making it unsuitable for TOON optimization.

<Tabs>
  <Tab title="Remote MCP (SSE)">
    Connect via Server-Sent Events:

    ```http theme={null}
    https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
    ```
  </Tab>

  <Tab title="Local MCP (STDIO)">
    Configure in your MCP client:

    ```json theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": ["@brightdata/mcp"],
          "env": {
            "API_TOKEN": "YOUR_API_KEY",
            "WEB_UNLOCKER_ZONE": "my_zone_name",
            "BROWSER_ZONE": "my_browser_zone",
            "PRO_MODE": "true",
            "GROUPS": "browser,advanced_scraping",
            "TOOLS": "web_data_linkedin_person_profile,web_data_amazon_product"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

### When TOON Can Help

While most Bright Data endpoints return nested data, there are scenarios where TOON can be beneficial:

<Steps>
  <Step title="Flatten the data first">
    Post-process MCP responses to extract flat arrays before encoding to TOON.
  </Step>

  <Step title="Use for batch results">
    When using `scrape_batch` or `search_engine_batch`, the URL/content pairs can be flattened.
  </Step>

  <Step title="Custom extraction">
    Use the `extract` tool with a prompt that requests flat, tabular data.
  </Step>
</Steps>

***

## Quick Start with TOON

### How to install TOON

<CodeGroup>
  ```bash npm theme={null}
  npm install @toon-format/toon
  ```

  ```bash pnpm theme={null}
  pnpm add @toon-format/toon
  ```

  ```bash yarn theme={null}
  yarn add @toon-format/toon
  ```
</CodeGroup>

### How to encode and decode data

```typescript theme={null}
import { encode, decode } from '@toon-format/toon'

// Your flat data (ideal for TOON)
const data = {
  products: [
    { id: 1, name: 'Laptop', price: 999 },
    { id: 2, name: 'Mouse', price: 29 },
    { id: 3, name: 'Keyboard', price: 79 }
  ]
}

// Encode to TOON for LLM input
const toonData = encode(data)
console.log(toonData)
// Output:
// products[3]{id,name,price}:
//   1,Laptop,999
//   2,Mouse,29
//   3,Keyboard,79

// Decode back to JSON (lossless round-trip)
const jsonData = decode(toonData)
```

### How to use the CLI

```bash theme={null}
# Convert JSON to TOON
npx @toon-format/cli input.json -o output.toon

# Convert TOON back to JSON
npx @toon-format/cli input.toon -o output.json
```

***

## Practical Example: Using TOON with MCP Client

This example demonstrates a complete workflow: connecting to Bright Data's MCP server, fetching data, flattening the nested response, and converting it to TOON format for token-efficient LLM processing.

### Full MCP Client Example

```typescript theme={null}
import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'
import { encode } from '@toon-format/toon'

// Initialize MCP client with Bright Data (ecommerce group for Amazon tools)
const transport = new SSEClientTransport(
  new URL('https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=ecommerce')
)

const client = new Client({
  name: 'toon-example-client',
  version: '1.0.0'
})

await client.connect(transport)

// Fetch Amazon product data using MCP (with timeout for slow responses)
const result = await client.callTool(
  {
    name: 'web_data_amazon_product',
    arguments: {
      url: 'https://www.amazon.com/dp/B0EXAMPLE123'
    }
  },
  undefined,
  { timeout: 120000 } // 2 minutes timeout
)

// The MCP response is an array with nested product data
const mcpResponse = JSON.parse(result.content[0].text)
console.log('Raw MCP Response:', JSON.stringify(mcpResponse, null, 2))
// [
//   {
//     "title": "Ceramic Vase Set of 3...",
//     "final_price": 29.99,
//     "initial_price": 29.99,
//     "currency": "USD",
//     "rating": 4.5,
//     "reviews_count": 1250,
//     "seller_name": "HomeDecorStore",
//     "brand": "Lyeec",
//     "is_available": true,
//     "asin": "B0G13HFJNB",
//     ...
//   }
// ]

// Flatten the nested data for TOON optimization
// Map actual MCP field names to flat structure
function flattenProduct(product: any) {
  return {
    title: product.title,
    price: product.final_price,
    original_price: product.initial_price,
    currency: product.currency,
    rating: product.rating,
    reviews: product.reviews_count,
    seller: product.seller_name,
    brand: product.brand,
    in_stock: product.is_available
  }
}

// Response is an array - flatten all products
const flatProducts = mcpResponse.map(flattenProduct)

// Encode to TOON - now it's efficient!
const toonOutput = encode({ products: flatProducts })
console.log('TOON Output:', toonOutput)
// products[1]{title,price,original_price,currency,rating,reviews,seller,brand,in_stock}:
//   Ceramic Vase Set of 3...,29.99,29.99,USD,4.5,1250,HomeDecorStore,Lyeec,true

// Use the TOON-encoded data in your LLM prompt
const prompt = `Analyze this product data and suggest pricing strategy:\n\n${toonOutput}`
```

### Batch Processing Multiple Products

For larger datasets, the token savings become even more significant:

```typescript theme={null}
import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'
import { encode } from '@toon-format/toon'

const transport = new SSEClientTransport(
  new URL('https://mcp.brightdata.com/sse?token=YOUR_API_TOKEN&groups=ecommerce')
)

const client = new Client({ name: 'batch-example', version: '1.0.0' })
await client.connect(transport)

// Fetch multiple products
const productUrls = [
  'https://www.amazon.com/dp/B0EXAMPLE1',
  'https://www.amazon.com/dp/B0EXAMPLE2',
  'https://www.amazon.com/dp/B0EXAMPLE3'
]

const results = await Promise.all(
  productUrls.map(async (url) => {
    const result = await client.callTool(
      { name: 'web_data_amazon_product', arguments: { url } },
      undefined,
      { timeout: 120000 }
    )
    // MCP returns an array, get the first item
    return JSON.parse(result.content[0].text)[0]
  })
)

// Flatten all products for TOON using actual MCP field names
const flattenedProducts = results.map(p => ({
  title: p.title,
  price: p.final_price,
  currency: p.currency,
  rating: p.rating,
  reviews: p.reviews_count,
  seller: p.seller_name,
  brand: p.brand,
  in_stock: p.is_available
}))

// Convert to TOON - massive token savings with multiple items!
const toonData = encode({ products: flattenedProducts })
console.log(toonData)
// products[3]{title,price,currency,rating,reviews,seller,brand,in_stock}:
//   Wireless Mouse,29.99,USD,4.5,1250,TechGear,Logitech,true
//   Gaming Keyboard,89.99,USD,4.7,890,KeyMaster,Razer,true
//   USB Hub,19.99,USD,4.2,2100,PortPlus,Anker,false

// Token comparison for 3 products:
// - JSON: ~180 tokens
// - TOON: ~65 tokens (64% savings!)
```

### Creating a Reusable Flattener

For production use, create a reusable utility with the correct MCP field mappings:

```typescript theme={null}
import { encode } from '@toon-format/toon'

// Generic flattener for common MCP data structures
// These map the actual field names returned by Bright Data MCP
const flatteners = {
  amazon_product: (p: any) => ({
    title: p.title,
    price: p.final_price,
    original_price: p.initial_price,
    currency: p.currency,
    rating: p.rating,
    reviews: p.reviews_count,
    seller: p.seller_name,
    brand: p.brand,
    in_stock: p.is_available
  }),

  linkedin_profile: (p: any) => ({
    name: p.full_name,
    headline: p.headline,
    location: p.city,
    country: p.country,
    connections: p.connections_count,
    followers: p.followers_count,
    company: p.current_company_name,
    position: p.position
  }),

  instagram_post: (p: any) => ({
    caption: p.description?.substring(0, 100),
    likes: p.likes,
    comments: p.comments,
    posted: p.upload_date,
    author: p.channel
  })
}

// Helper to process MCP response and convert to TOON
function mcpToToon<T>(
  data: T | T[],
  flattener: (item: T) => Record<string, any>,
  key: string = 'items'
): string {
  const items = Array.isArray(data) ? data : [data]
  const flattened = items.map(flattener)
  return encode({ [key]: flattened })
}

// Usage example
const result = await client.callTool(
  { name: 'web_data_amazon_product', arguments: { url: '...' } },
  undefined,
  { timeout: 120000 }
)
const mcpData = JSON.parse(result.content[0].text)
const toonOutput = mcpToToon(mcpData, flatteners.amazon_product, 'products')
```

***

## Summary

<CardGroup>
  <Card title="Use TOON For" icon="check">
    * Flat, uniform arrays
    * Tabular data structures
    * Large datasets with repeated schemas
    * Post-processed, flattened MCP data
  </Card>

  <Card title="Avoid TOON For" icon="xmark">
    * Deeply nested objects
    * Non-uniform data structures
    * Direct MCP endpoint responses
    * Complex hierarchical data
  </Card>
</CardGroup>

<Info>
  **Bottom Line:** TOON is a powerful tool for token optimization, but it's designed for flat, uniform data. Bright Data MCP responses are typically nested, so apply TOON only after flattening the data to a tabular structure.
</Info>

***

## Where to learn more

<CardGroup>
  <Card title="TOON Specification" icon="book" href="https://github.com/toon-format/spec">
    Official format specification
  </Card>

  <Card title="TypeScript SDK" icon="npm" href="https://www.npmjs.com/package/@toon-format/toon">
    NPM package documentation
  </Card>

  <Card title="TOON Website" icon="globe" href="https://toonformat.dev">
    Interactive playground and docs
  </Card>
</CardGroup>


# MCP usage examples
Source: https://docs.brightdata.com/products/mcp-server/usage-examples

Browse community demos and reference projects built on the Bright Data MCP server (60+ tools), covering AI agents, scraping pipelines and integrations.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

1. AI voice agent that closed 4 deals & made \$596 overnight 🤑

* <Icon icon="github" />   [GitHub Repo](https://github.com/llSourcell/my_ai_intern)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=YGzT3sVdwdY)

<iframe title="AI voice agent that closed 4 deals & made $596 overnight" />

***

2. LangGraph with mcp-adapters demo

* <Icon icon="github" />   [GitHub Repo](https://github.com/techwithtim/BrightDataMCPServerAgent)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=6DXuadyaJ4g)

<iframe title="LangGraph with mcp-adapters demo" />

***

3. Researcher Agent built with Google ADK that is connected to Bright Data's MCP to fetch real-time data

* <Icon icon="github" />   [GitHub Repo](https://github.com/MeirKaD/MCP_ADK)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=r7WG6dXWdUI)

<iframe title="Researcher Agent with Google ADK using Bright Data MCP" />

***

4. Multi-Agent job finder using Bright Data MCP and TypeScript from SCRATCH

* <Icon icon="github" />   [GitHub Repo](https://github.com/bitswired/jobwizard)

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=45OtteCGFiI)

<iframe title="Multi-Agent job finder with Bright Data MCP and TypeScript" />

***

5. Replacing 3 MCP servers with our MCP server to avoid getting blocked 🤯

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=0xmE0OJrNmg)

<iframe title="Replacing 3 MCP servers with Bright Data MCP server" />

***

6. Scrape ANY Website In Realtime With This Powerful AI MCP Server

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=bL5JIeGL3J0)

<iframe title="Scrape any website in realtime with Bright Data MCP server" />

***

7. Usage example with Gemini CLI

* <Icon icon="youtube" />   [YouTube Demo](https://www.youtube.com/watch?v=FE1LChbgFEw)

<iframe title="Usage example with Gemini CLI and Bright Data MCP" />


# Build a scraper with the AI Agent
Source: https://docs.brightdata.com/products/scraper-studio/ai-agent

Use Bright Data Scraper Studio's AI Agent to build a custom web scraper from a natural-language prompt in about 10 minutes, no coding required.

Bright Data Scraper Studio's AI Agent builds a custom web scraper from a natural-language description. Give it a target URL and describe the data you want; the agent generates an output schema, writes the scraper code, and hands you a runnable scraper you can trigger by API, manually, or on a schedule. This tutorial walks through the full flow.

**Time to complete:** about 10 minutes

<Tip>
  Prefer the terminal? Use the [Bright Data CLI](/products/scraper-studio/build-with-the-cli) to build the same scraper from any shell or coding-agent embedded terminal (Claude Code, Cursor, Codex).
</Tip>

## Prerequisites

* A Bright Data account ([sign up free](https://brightdata.com/?hs_signup=1\&utm_source=docs))
* The URL of the website you want to scrape

## Build your first scraper with the AI Agent

<Steps>
  <Step title="Open Scraper Studio">
    In the Bright Data control panel, click **Scrapers** in the left menu and open **Scraper Studio**.

    <Frame>
      <img alt="Navigate to the Scraper Studio page" />
    </Frame>
  </Step>

  <Step title="Enter the target website URL">
    Paste the URL of the page you want to scrape into the chat input. Along with the URL, add any context that helps the AI build a more accurate scraper on the first try. The more context you provide, the better the generated code.

    <Frame>
      <img alt="Add additional instructions to the AI Agent" />
    </Frame>

    Useful context to include:

    * **Specific fields** you need: "I need price, title, and stock status"
    * **Where the data lives** on the page: "prices are in the product detail panel, not the listing page"
    * **Actions required** to reach the data: "click 'Show more' to load full descriptions"
    * **CSS selectors**, if you know them: `.product-price span.amount`
    * **Page load behavior**, if the site is slow or lazy-loads content: "results load dynamically, give it extra time"

    > **Expected result:** the AI Agent acknowledges the URL and may ask one or two clarifying questions about the data you want.
  </Step>

  <Step title="Answer the AI's questions">
    Respond in plain language.

    > **Expected result:** the AI Agent generates a schema, a structured list of fields with data types that will become your scraper's output.
  </Step>

  <Step title="Review and approve the schema">
    Read through the generated schema. You have four options:

    * **Approve:** click Approve to accept the schema as-is
    * **Decline:** type feedback in the chat (for example, "Remove the image field and add a rating field") and the AI regenerates the schema
    * **Edit inline:** modify the schema directly without going back to the chat
    * **Upload your own schema:** bring your own schema file; download the example file to see the correct format

    Inline editing options:

    * **Edit a field** (pencil icon): change a field's name or data type
    * **Delete a field** (trash icon): remove fields you do not need
    * **Add a field** (plus button): add new fields to the schema

    <Frame>
      <img alt="Approve the generated schema" />
    </Frame>

    Additional controls:

    * **Start from scratch:** clears every field so you can build the schema manually from an empty state
    * **Reset the schema:** discards inline changes and returns to the original AI-generated schema

    Click **Approve** when you are ready.

    > **Expected result:** once approved, the AI Agent starts generating the scraper code.
  </Step>

  <Step title="Wait for code generation">
    The AI writes the full scraper, including extraction logic, navigation handling, data validation, and error handling. This takes a few minutes.

    > **Expected result:** a confirmation popup appears indicating your scraper is ready.

    <Frame>
      <img alt="Collector created successfully confirmation" />
    </Frame>
  </Step>

  <Step title="Run your scraper">
    Click **Try it out** to open the Initiate Manually page. Review the collection settings and click **Start** to begin data collection.

    <Frame>
      <img alt="Start button on the Initiate Manually page" />
    </Frame>

    You can also choose an alternative initiation method:

    * **[Initiate by API](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method):** trigger the scraper programmatically without opening the control panel
    * **Schedule:** run the scraper on an hourly, daily, weekly, or custom interval

    > **Expected result:** the scraper collects data. Monitor progress from the Runs dashboard and download results in JSON, NDJSON, CSV, or XLSX once the job completes.
  </Step>
</Steps>

After the scraper is ready, use the [Self-Healing tool](/products/scraper-studio/self-healing-tool) to make plain-language changes, or open the code in the Bright Data Scraper Studio IDE to edit it directly.

## **Resume a previous AI chat**

Use **My AI Chats** on the **Scraper Studio** chat page to reopen AI Agent conversations that are still waiting for your input or have finished creating a scraper.

**My AI Chats** can show chats with different statuses:

* **Pending answer**: the AI Agent is waiting for your response. Open the chat to continue the scraper creation flow.
* **Done**: the scraper is ready. Open the chat to access the created scraper. After you open it, the chat is removed from **My AI Chats**.

Once a scraper is created, you cannot continue editing it from the same AI chat. To change an existing scraper, use the [**Self-Healing**](https://docs.brightdata.com/datasets/scraper-studio/self-healing-tool) tool.

## What can the AI Agent build?

Reach for the Bright Data Scraper Studio AI Agent when the data you need isn't already in the [Datasets Marketplace](/datasets/marketplace). For sites Bright Data already covers (Amazon, Walmart, LinkedIn, eBay), the marketplace ships pre-built scrapers that are faster and cheaper than building your own. The AI Agent shines on regional ecommerce, B2B catalogs, niche verticals and any site where no marketplace scraper exists.

The AI Agent builds one of five scraper types. Pick the one that matches what you have and what you need.

| Scraper type | What you provide | What you get | Page visits per input |
| - | - | - | - |
| **PDP** | List of product URLs | Full per-product detail | 1 |
| **Discovery** | Category / listing URL | Listing-level rows (title, price, rank) | 1 |
| **Discovery + PDP** | Category / listing URL | Full per-product detail for every item | 1 + N |
| **Search** | Keyword (+ optional country) | Either Discovery or Discovery + PDP shape | 1 + M |
| **Sitemap** | Domain or `sitemap.xml` URL | Full per-page detail for every URL in the sitemap | 1 + N |

<Warning>
  **Not a crawler.** Don't pass a homepage and ask for "everything." Each scraper is scoped to one data shape.
</Warning>

### When do I use a PDP scraper?

Use a PDP scraper when you have a list of specific product URLs and need full per-product detail. Each input URL produces one row.

**Example:** 100 product URLs from a regional retailer like [dm.de](https://www.dm.de) → 100 rows with title, price, availability, images and any other field you defined in the schema.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a PDP scraper for dm.de. For each product URL I provide, extract the product title, price, availability, brand, rating and all product image URLs. Return one row per input URL.
```

### When do I use a Discovery scraper?

Use a Discovery scraper when you need an overview of items on a single listing page and can live without per-product detail. Each input URL produces N rows where N equals the number of items in the listing.

**Example:** A category page like `https://www.dm.de/baby-und-kind` → 30 rows with title, price, rating and listing position. No description, no full image gallery.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Discovery scraper for the dm.de category page https://www.dm.de/baby-und-kind. Return one row per item shown in the listing with title, price, rating and listing position. Do not open the individual product pages.
```

### When do I use a Discovery + PDP scraper?

Use a Discovery + PDP scraper when you need full per-product detail for an entire category. Each input URL produces N rows with the full PDP shape.

This is the most expensive type. One category URL with 200 products costs roughly 200 times a single PDP scrape.

**Example:** A category page on a regional retailer like [decathlon.fr](https://www.decathlon.fr) → full per-product detail for every item in that category.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Discovery + PDP scraper for a category page on decathlon.fr (for example a sport category like running shoes). Find every product in the category, open each product page, and extract full detail: title, price, availability, description, rating and image URLs. Return one row per product.
```

### When do I use a Search scraper?

Use a Search scraper when you do not have specific URLs. Provide a keyword and optionally a country; the AI Agent picks Discovery or Discovery + PDP shape based on whether you asked for listing-level fields or full PDP detail.

**Example:** keyword "brake pads" on a B2B parts site like [autodoc.de](https://www.autodoc.de) → matching product results in either listing-level or full PDP shape.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Search scraper for autodoc.de. For the keyword "brake pads" in Germany, return matching products with title, price, brand and product URL. No need to open each product page.
```

### When do I use a Sitemap scraper?

Use a Sitemap scraper when you need data from many pages on a site and the site publishes those page URLs in an XML sitemap. The sitemap lets the scraper discover URLs directly instead of clicking through category pages, pagination or search results, so it fits large ecommerce sites, marketplaces, catalogs, blogs and documentation sites.

Provide a domain or a sitemap URL. Each sitemap produces N discovered page URLs, and the scraper visits each relevant page to collect the fields you defined in the schema.

**Example:** a domain like [dm.de](https://www.dm.de) or its sitemap at `https://www.dm.de/sitemap.xml` → discover every product URL in the sitemap → visit each product page → collect full product detail.

Paste this into the AI Agent chat:

```text Prompt theme={null}
Build a Sitemap scraper for dm.de. Collect all product URLs from the sitemap, visit each product page, and extract product name, price, SKU, description, image URL and availability. Return one row per product.
```

If you already have the sitemap URL, point the AI Agent straight at it:

```text Prompt theme={null}
Build a scraper using this sitemap: https://www.dm.de/sitemap.xml. Extract all product page URLs, visit each product page, and collect the product detail fields.
```

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I edit the code after the AI Agent builds the scraper?">
    Yes. Every scraper the AI Agent generates can be opened in the Bright Data Scraper Studio IDE and edited directly. If you prefer not to write code, use the [Self-Healing tool](/products/scraper-studio/self-healing-tool) to request changes in plain language.
  </Accordion>

  <Accordion title="Does the AI Agent build scrapers for login-protected sites?">
    The AI Agent generates scrapers that run on Bright Data's proxy and unblocking infrastructure, which handles most anti-bot defenses. For sites that require a logged-in session, build the scraper in the IDE and use `set_session_cookie()` or the authentication pattern that matches the target site.
  </Accordion>

  <Accordion title="Why didn't the AI generate what I expected?">
    The AI Agent relies on the context you give it. If the output is off, decline the schema and add more specifics about field names, selectors, or the exact page section where the data lives. You can also use the [Self-Healing tool](/products/scraper-studio/self-healing-tool) to refine a generated scraper after the fact.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Build with the Bright Data CLI" icon="terminal" href="/products/scraper-studio/build-with-the-cli">
    Build the same scraper from the terminal or any coding agent
  </Card>

  <Card title="Develop a scraper with the IDE" icon="code" href="/products/scraper-studio/develop-a-scraper">
    Build a scraper by writing JavaScript directly
  </Card>

  <Card title="Self-Healing tool" icon="screwdriver-wrench" href="/products/scraper-studio/self-healing-tool">
    Update a generated scraper with plain-language prompts
  </Card>
</CardGroup>


# Scraper Studio Auto Self-Healing
Source: https://docs.brightdata.com/products/scraper-studio/auto-self-healing

Configure Auto Self-Healing in Bright Data Scraper Studio to fix a scraper automatically when its success rate drops or 1 of 6 supported errors occurs.

Use the **Auto Self-Healing** tab to let Bright Data Scraper Studio try to fix a scraper on its own when collection quality drops or a supported scraper error occurs. Auto Self-Healing jobs do not cost credits.

Auto Self-Healing is configured per scraper. Once enabled, Bright Data Scraper Studio monitors that scraper's runs and starts a healing job whenever the trigger rules you set are met.

<Note>
  Auto Self-Healing runs without you asking. To fix a scraper on demand from a plain-language prompt instead, use the [Self-Healing tool](/products/scraper-studio/self-healing-tool) in the Scraper Studio IDE.
</Note>

## How do I open Auto Self-Healing settings?

1. Open **My Scrapers** in Bright Data Scraper Studio.
2. Select the scraper you want to configure.
3. Open the **Auto Self-Healing** tab.
4. Configure the general settings, trigger rules and notifications.
5. Click **Save**.

Saved settings apply to future runs of that scraper. Runs that already completed are not reprocessed.

## Which general settings control Auto Self-Healing?

| Setting | Options | What it does |
| - | - | - |
| **Enable Auto self healing** | On, Off | Turns Auto Self-Healing on or off for this scraper. When On, Bright Data Scraper Studio can start healing jobs as soon as the trigger rules are met. |
| **Auto save code** | On, Off | Controls whether Bright Data Scraper Studio saves the code the healing process generates. When On, any successful healing job saves the newly extracted code to production and updates the collector's template version. When Off, the healing job still runs but the generated code is not saved, and the users you select under **Notifications** get an email so they can review the suggested fix before saving it. |

<Warning>
  **Auto save code** writes straight to production. A successful healing job saves the new code and bumps the collector's template version with no human review, so the next run collects with AI-written code. Turn it on only when you accept that. Leave it Off to keep a review step before any fix reaches production.
</Warning>

## Which trigger rules start a healing job?

Trigger rules decide when Auto Self-Healing starts for the scraper you are configuring. **Success Rate Threshold** and **Minimum Inputs Threshold** are required fields.

| Trigger rule | Default | What it controls |
| - | - | - |
| **Success Rate Threshold (%)** | `40` | The success rate below which Auto Self-Healing triggers. At `40`, a healing job can start once the scraper's success rate falls below 40 percent. |
| **Trigger Frequency** | Per Day | Whether Bright Data Scraper Studio checks once per day (**Per Day**) or on every job run (**Per Job**). |
| **Minimum Inputs Threshold** | `10` | The minimum number of job inputs required before Auto Self-Healing triggers. A run smaller than this never starts a healing job, so a handful of failures in a tiny run does not count as a quality drop. |
| **Cooldown Period (hours)** | `3` | The minimum hours to wait between consecutive Auto Self-Healing triggers for this scraper. |
| **Max Auto-Healing Jobs Per Day** | `8` | The maximum number of Auto Self-Healing jobs allowed for this scraper in one day. |

A healing job that fails still counts against **Max Auto-Healing Jobs Per Day** and still starts the **Cooldown Period**.

## Which error codes trigger Auto Self-Healing?

Auto Self-Healing starts only for these six scraper error codes:

* `crawl_error`
* `parse_error`
* `bad_cmd_arg`
* `dead_page`
* `bad_input`
* `bad_navigate`

A scraper that fails with any other error code does not start Auto Self-Healing, even when every trigger rule is met. For what each code means and how to resolve it by hand, see [Scraper Studio error codes](/products/scraper-studio/error-codes).

## Where do I see status and notifications?

The **Status** section of the **Auto Self-Healing** tab reports this scraper's healing-job activity. Before any healing job has run it reads `No auto healing jobs were triggered`.

The **Notifications** section has a **Select users to notify** picker listing the users on your account. Selected users get email when Auto Self-Healing is triggered, when it completes and when it needs attention. Add at least one user when **Auto save code** is Off, because the review email is the only way a suggested fix reaches a person.

## FAQ

### How is Auto Self-Healing different from the Self-Healing tool?

Auto Self-Healing runs on its own against trigger rules you configure per scraper. The [Self-Healing tool](/products/scraper-studio/self-healing-tool) is manual: you open a scraper in the Scraper Studio IDE, describe the fix in plain language and review the diff before accepting it. Auto Self-Healing needs no prompt.

### Does Auto Self-Healing change my scraper without asking?

Only when **Auto save code** is On. With **Auto save code** Off, Bright Data Scraper Studio still runs the healing job but does not save the generated code, and emails the users selected under **Notifications** to review the suggested fix first.

### Why did Auto Self-Healing not start after my scraper failed?

Check the failure's error code first. Auto Self-Healing starts only for the six error codes listed on this page, so a scraper that fails with any other code never triggers it. If the code is supported, check the other trigger rules set on the scraper: the run may have had fewer inputs than **Minimum Inputs Threshold**, or the scraper may still be inside its **Cooldown Period** or have already hit **Max Auto-Healing Jobs Per Day**. Failed healing jobs count toward both limits.

### Can I configure Auto Self-Healing through the API?

You can turn it on. Send the scraper ID and trigger rules to the [Enable Auto Self-Healing](/api-reference/scraper-studio-api/ai-flow/enable-auto-self-healing) endpoint of the [AI Flow API](/api-reference/scraper-studio-api/ai-flow/overview). The endpoint takes the same settings as the **Auto Self-Healing** tab, including `sr_threshold`, `trigger_frequency`, `min_inputs_threshold`, `auto_save`, `cooldown_period`, `max_jobs_per_day` and `notification_emails`.

Changing those settings afterward is control panel work. The API creates them once per scraper and has no endpoint to read, update, delete or disable them. To start a self-healing job on demand instead, use [Trigger Self-Healing](/api-reference/scraper-studio-api/ai-flow/trigger-self-healing).

### Do the settings affect runs that already finished?

No. Auto Self-Healing settings apply to future runs of the scraper. Runs that already completed are not changed or reprocessed.

## Related

<CardGroup>
  <Card title="Self-Healing tool" icon="wand-magic-sparkles" href="/products/scraper-studio/self-healing-tool">
    Fix a scraper on demand from a plain-language prompt
  </Card>

  <Card title="Scraper Studio error codes" icon="triangle-exclamation" href="/products/scraper-studio/error-codes">
    What each scraper error code means and how to resolve it
  </Card>

  <Card title="Trigger Self-Healing API" icon="code" href="/api-reference/scraper-studio-api/ai-flow/trigger-self-healing">
    Start a self-healing job from the AI Flow API
  </Card>

  <Card title="Initiate collection and delivery" icon="paper-plane" href="/products/scraper-studio/initiate-collection-and-delivery-options">
    Run a production scraper and configure delivery
  </Card>
</CardGroup>


# Web scraping basics in Scraper Studio
Source: https://docs.brightdata.com/products/scraper-studio/basics-of-web-scraping

Understand how Scraper Studio IDE scrapers are structured, from inputs and interaction code to parsing, stages, workers, and output records.

Bright Data Scraper Studio IDE scrapers are built from a few core parts: **inputs**, **interaction code**, **parser code**, **stages**, **workers**, and **output records**.

This page explains how those parts work together so you can understand, edit, and debug scraper code with confidence.

For a step-by-step build walkthrough, see [**Develop a scraper with the IDE**](/products/scraper-studio/develop-a-scraper).

## Prerequisites

* Basic JavaScript familiarity (variables, functions, async control flow)
* An active [Bright Data account](https://brightdata.com/)

## **Basic scraper flow**

A Scraper Studio IDE scraper usually follows this flow:

1. The scraper receives an **input**, such as a URL, keyword, location, or custom value.
2. **Interaction code** uses that input to open a page, send a request, click, scroll, paginate, or create the next stage.
3. **Parser code** extracts structured data from the loaded page or response.
4. The scraper saves records to the output dataset with `collect()` or `set_lines()`.
5. The final output is delivered according to the scraper’s delivery preferences.

## **Inputs**

Inputs are the values passed into a scraper run.

A scraper might use:

* `url`, for page-based scraping
* `keyword`, for search or discovery flows
* `location`, for location-based searches
* `country`, `date`, `category`, or any other custom field

The available input fields are defined in the scraper’s [**input schema**](/products/scraper-studio/input-and-output-schema#what-is-the-input-schema).

Interaction code reads these values from the `input` object:

```js theme={null}
navigate(input.url);
```

For a keyword-based scraper:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);
```

A scraper does not always need external input. For example, a scraper can use a hardcoded URL if it always collects from the same page.

## **Interaction code**

Interaction code controls how the scraper reaches the data.

It can:

* Navigate to a page
* Send HTTP requests
* Wait for page elements
* Click buttons
* Type into forms
* Scroll through a page
* Handle pagination
* Create additional crawl stages

A simple interaction flow looks like this:

```js theme={null}
navigate(input.url);
wait('.product-title');

const data = parse();
collect(data);
```

In this example:

* `navigate(input.url)` opens the page from the input.
* `wait('.product-title')` waits until the expected page element appears.
* `parse()` runs the parser code.
* `collect(data)` saves the extracted record.

Interaction code is responsible for **getting to the right page or response**. It should not contain most of the extraction logic. That belongs in parser code.

## **Parser code**

Parser code extracts structured fields from the page HTML or response.

Parser code commonly uses Cheerio, a jQuery-like API, to read page elements:

```js theme={null}
return {
  title: $('h1').text_sane(),
  price: $('.price').text_sane(),
  availability: $('.stock-status').text_sane(),
};
```

The parser returns a JavaScript object. That object becomes the structured data your scraper can collect.

For example, a parser can return product data, profile data, listings, article content, or links that the interaction code will use in the next stage.

## `parse() `**and** `collect()`

`parse()` and `collect()` connect interaction code, parser code, and final output.

### `parse()`

`parse()` runs the parser code for the current page or response and returns its result.

Example:

```js theme={null}
let data = parse();
```

### `collect()`

`collect()` appends one record to the output dataset.

Example:

```js theme={null}
collect({
  title: data.title,
  price: data.price,
  url: location.href,
});
```

## **Multi-stage scrapers**

Some scrapers need more than one step to reach the final data.

For example:

1. Start from a search page.
2. Discover result pages.
3. Open each result page.
4. Extract final details.

Scraper Studio supports this pattern with **stages**.

A stage is a separate crawl step. `next_stage()` sends new input values to the next stage.

Example:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);

const results = parse().results;

for (const result of results) {
  next_stage({ url: result.url });
}
```

Then the next stage can use the new `url` input:

```js theme={null}
navigate(input.url);

const data = parse();
collect(data);
```

Multi-stage scrapers are useful for:

* Search results → detail pages
* Category pages → product pages
* Listing pages → profile pages
* Pagination flows
* Discovery workflows where one page creates many child pages

Scraper Studio can run stages across workers, so this pattern is usually more scalable than processing every page serially in one long script.

## **Parent and child crawls**

When a scraper uses `next_stage()`, it creates a parent-child relationship between crawls.

For example:

* The search page is the **parent** crawl.
* Each result page created from it is a **child** crawl.

This relationship is useful when debugging. In the crawl inspector, you can see which input or page created another page, inspect child pages, and trace where failures happened in a multi-stage flow.

## **Code workers and Browser workers**

Scraper Studio supports two worker types.

### **Code worker**

A **Code worker** uses HTTP requests and raw responses.

Use a Code worker when:

* The data is available in the raw HTML
* The data is available from a public JSON endpoint
* The page does not require browser interaction
* You want faster and more cost-efficient scraping

Code workers cannot click, scroll, type, or run browser-only functions.

### **Browser worker**

A **Browser worker** uses a real headless browser.

Use a Browser worker when:

* The page renders data with JavaScript
* You need to click, scroll, type, or interact with the page
* You need to wait for elements to appear
* You need to capture browser network traffic
* The site requires browser-like behavior

Start with a Code worker when possible. Switch to a Browser worker when the target data is not available in the raw response or when browser interaction is required.

For the complete comparison, see [**Worker types**](/products/scraper-studio/worker-types).\\

## How does Scraper Studio handle blocking and CAPTCHAs?

Scraping at scale can trigger site defenses such as:

* IP blocking
* Rate limits
* CAPTCHAs
* Fingerprinting
* Bot detection

Scraper Studio runs on Bright Data’s proxy and unblocking infrastructure, so you do not need to manage proxy rotation, sessions, or retry logic yourself.

Depending on the scraper configuration and worker type, Scraper Studio can:

* Route requests through Bright Data proxy infrastructure
* Retry blocked requests
* Use browser-like fingerprints for Browser workers
* Support CAPTCHA-solving workflows with `solve_captcha()` when applicable

Your scraper code should focus on reaching the right pages and extracting the required data. Bright Data handles the access infrastructure behind the scenes.

## **How schema fits into scraper structure**

The scraper code and schema work together.

### **Input schema**

The input schema defines what values the scraper can receive.

Example input fields:

```js theme={null}
{
  "url": "https://example.com/product/1",
  "country": "US"
}
```

Interaction code reads those values from `input`.

### **Output schema**

The output schema defines what fields the scraper returns.

It is usually generated from the records passed to `collect()`.

Example collected record:

```js theme={null}
collect({
  title: data.title,
  price: data.price,
  availability: data.availability,
});
```

Those fields become part of the output schema.

For more details, see [**Input and output schema**](/products/scraper-studio/input-and-output-schema).

## **Common scraper patterns**

### **Single-page scraper**

Use this pattern when each input maps to one final page.

Example:

```js theme={null}
navigate(input.url);
collect(parse());
```

Best for:

* Product pages
* Profile pages
* Article pages
* Detail pages

***

### **Search or discovery scraper**

Use this pattern when an input creates multiple result pages.

Example:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);

const results = parse().results;

for (const result of results) {
  next_stage({ url: result.url });
}
```

Best for:

* Search pages
* Category pages
* Directory listings
* Marketplace discovery

***

### **Multi-page detail scraper**

Use this pattern when a scraper must move from a list page to many detail pages.

Example flow:

**Input keyword → Search page → Result URLs → Detail pages → Output records**

Best for:

* Product discovery
* Lead generation
* Local business listings
* Review collection
* Job listings

***

## **Debugging mental model**

When a scraper does not return the expected data, check the flow in order:

1. **Input**, Did the scraper receive the expected input values?
2. **Interaction code**, Did it reach the correct page or response?
3. **Parser code**, Did the selectors extract the expected fields?
4. **Stages**, Did `next_stage()` create the expected child pages?
5. **Output records**, Did `collect()` emit the expected structure?
6. **Schema**, Does the output schema include the returned fields?
7. **Worker type**, Does the page require Browser worker behavior?

This flow helps isolate whether the issue is caused by input data, navigation, parsing, staging, schema, or worker configuration.

## Related

<CardGroup>
  <Card title="Worker types" icon="server" href="/products/scraper-studio/worker-types">
    Choose between Browser worker and Code worker
  </Card>

  <Card title="Scraper Studio functions" icon="code" href="/products/scraper-studio/functions">
    Full reference for interaction and parser commands
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/products/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>

  <Card title="Best practices" icon="list-check" href="/products/scraper-studio/best-practices">
    Recommended patterns for fast, reliable scrapers
  </Card>
</CardGroup>


# Scraper Studio IDE best practices
Source: https://docs.brightdata.com/products/scraper-studio/best-practices

Bright Data Scraper Studio IDE best practices for dead page detection, request batching, pagination, popups, tagged responses, timeouts and retries.

This guide shows the coding patterns the Bright Data Scraper Studio team recommends for writing fast, reliable scrapers in the IDE. Each section contrasts a common mistake with the preferred pattern and explains the reason.

## How do I detect dead pages reliably?

When using `navigate()`, add a `dead_page()` condition so the scraper does not retry pages that do not exist. Bright Data Scraper Studio automatically marks HTTP 404 responses as dead, but many sites return 200 with a "not found" template, so you must check for that yourself.

Do not wrap `wait()` in a `try/catch` and call `dead_page()` from the `catch` block. A thrown `wait()` only tells you the selector did not appear within the timeout, not that the page is actually dead.

<CodeGroup>
  ```js Bad theme={null}
  try {
    // Waits 30 seconds for 'ok-selector' even if the page is already dead
    wait('ok-selector');
  } catch (e) {
    // You cannot prove the page is dead from a wait timeout alone
    dead_page("Page doesn't exist");
  }
  ```

  ```js Good theme={null}
  wait('ok-selector, 404-selector');
  if (el_exists('404-selector'))
    dead_page();
  ```
</CodeGroup>

## How do I minimize requests to the browser?

Interaction commands like `click`, `type`, `el_exists`, `el_is_visible`, `wait`, and `wait_visible` each send a request to the browser. Combine selectors into a single call instead of chaining several calls.

<CodeGroup>
  ```js Bad theme={null}
  if (!(el_exists('#price1')) || el_exists('#price2')
    || el_exists('#price3') || el_exists('#discount'))
  {
      dead_page('No price found');
  }
  ```

  ```js Good theme={null}
  if (!el_exists('#price1, #price2, #price3, #discount'))
    dead_page('No price found');
  ```
</CodeGroup>

## How do I paginate without blocking parallelization?

When a site has paginated results and you want data from every page, call `rerun_stage()` once from the root page for every page you need. Do not call `rerun_stage()` from inside each page as you walk the pagination: that serializes the work and Bright Data Scraper Studio cannot parallelize the requests.

<CodeGroup>
  ```js Bad theme={null}
  navigate(input.url);
  let $ = load_html(html());
  let next_page_url = $('.next_page').attr('href');
  rerun_stage({url: next_page_url});
  ```

  ```js Good theme={null}
  let url = new URL(input.url);
  if (input.page)
      url.searchParams.set('page', input.page);
  navigate(url);
  // input.page only exists when this stage was re-run for a specific page.
  // On the root page it's undefined, so we fall through to fan out.
  if (input.page)
      return;

  let $ = load_html(html());
  let total_products = +$('.total_pages').text();
  let total_pages = Math.ceil(total_products / 20);
  total_pages = Math.min(total_pages, 50);

  for (let page = 2; page <= total_pages; page++)
      rerun_stage({url: input.url, page});
  ```
</CodeGroup>

Avoid collecting all pages in a single session. Each session has a 16MB result size limit, and that limit counts the total accumulated data in the session, including all collected lines, parsed results, children and parser metadata, not just the size of the rendered page. Calling `rerun_stage({url: input.url, page})` once per page processes one page per session and keeps each session within the limit.

## How do I close popups without waiting for them?

Use `close_popup('popup_selector', 'close_button_selector')` to register a background watcher that closes popups whenever they appear. Do not poll for a popup with `wait_visible()` before each interaction: popups can appear at any time, and explicit waits add latency on every step.

<CodeGroup>
  ```js Bad theme={null}
  navigate('https://example.com');
  try {
    wait_visible('.cky-btn-accept', {timeout: 5000});
    click('.cky-btn-accept');
  } catch (e) {
      console.log('Accept cookies button does not exist, continue');
  }
  ```

  ```js Good theme={null}
  // Runs in the background with no per-step latency.
  // The watcher checks for the popup before every interaction automatically.
  close_popup('.cky-btn-accept', '.cky-btn-accept');
  navigate('https://example.com');
  click('.open-product-full-info');
  ```
</CodeGroup>

## How do I wait for a tagged response before parsing?

When you use `tag_response()` to capture a background API call, follow it with `wait_for_parser_value()` to make sure the request has finished before you read `parser`. Without the wait, the parser may run before the response has arrived and `parser.<field>` will be `undefined`.

<CodeGroup>
  ```js Bad theme={null}
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // Parser code:
  // The request may not have finished yet; product could be undefined
  let {product} = parser;
  return product.data;
  ```

  ```js Good theme={null}
  tag_response('product', /api\/product/);
  navigate('https://example.com');
  wait_for_parser_value('product');

  // Parser code:
  let {product} = parser;
  return product.data;
  ```

  ```js Good (chained navigation) theme={null}
  tag_response('product', /api\/product/);
  navigate('https://example.com');

  // wait_for_parser_value returns the value so you can use it in interaction code
  let product = wait_for_parser_value('product');
  navigate(product.reviews_url);
  tag_html('reviews_html');

  // Parser code:
  let {product, reviews_html} = parser;
  let $ = load_html(reviews_html);
  let reviews = $('.review').toArray().map(v => $(v).text());
  return {
    ...product.data,
    reviews,
  };
  ```
</CodeGroup>

## Should I throw custom error messages?

No. Let built-in errors from Bright Data Scraper Studio bubble up. They include the selector, the timeout, and the stage, which is more useful than a hand-written "Page not loaded properly". Only throw a custom error when you are checking a domain-specific condition that Bright Data Scraper Studio cannot detect on its own, such as a missing product title.

<CodeGroup>
  ```js Bad theme={null}
  try {
    wait('selector1');
    // some code
    wait('selector2');
    // some code
  } catch (e) {
    throw "Page not loaded properly"
  }
  ```

  ```js Good theme={null}
  // Crawler error: waiting for selector "selector1" failed: timeout 30000ms exceeded
  wait('selector1');
  // some code
  wait('selector2');
  // some code
  ```

  ```js Good (domain-specific check) theme={null}
  if (!el_exists('.product-title'))
      throw new Error('Failed to load product page');
  ```
</CodeGroup>

## How do I handle slow websites without over-extending timeouts?

Keep the default 30-second timeout for most waits. If a specific page is consistently slow, raise it to 45 or 60 seconds. Do not push beyond 60 seconds: a slower peer is usually the cause, and Bright Data Scraper Studio automatically retries with a fresh peer session when a page reports a timeout error.

<CodeGroup>
  ```js Bad theme={null}
  // 120 seconds is too long; the platform cannot recycle a stuck peer
  wait('selector', {timeout: 120000});
  ```

  ```js Good theme={null}
  wait('selector');                       // default 30 seconds
  wait('selector', {timeout: 45000});     // 45 seconds for slightly slow pages
  wait('selector', {timeout: 60000});     // 60 seconds for consistently slow pages
  ```
</CodeGroup>

## Should I build my own retry loop?

No. Bright Data Scraper Studio handles retries at the job level with a new peer session. A custom retry loop inside your scraper reuses the same session, which is the reason the first attempt failed. Report the error and let Bright Data Scraper Studio retry.

<CodeGroup>
  ```js Bad theme={null}
  let counter = input.counter || 5;
  while (counter > 1) {
    try {
      wait('selector', {timeout: 500});
      click('selector');
      type('selector');
      // some code
      break;
    } catch (e) {
      // rerun_stage creates a new session but this pattern spends extra CPM
      return rerun_stage({...input, counter: --counter});
    }
  }
  ```

  ```js Good theme={null}
  navigate('https://example.com');
  wait('h1');
  ```
</CodeGroup>

## Should I wrap parser expressions in try/catch?

No. Use optional chaining (`?.`) and nullish coalescing (`??`) instead. A silent `try/catch` around a property access hides real bugs, and a `try/catch` around a `wait()` wastes browser time.

<CodeGroup>
  ```js Bad theme={null}
  try {
    const example = obj.prop;
  } catch (e) {}
  ```

  ```js Bad theme={null}
  // Wasting browser time for no reason
  try { wait('selector'); } catch (e) {}
  try { wait_network_idle({timeout: 8000}); } catch (e) {}
  try { wait_page_idle(); } catch (e) {}
  ```

  ```js Good theme={null}
  const example = object?.prop;
  const example2 = object.prop ?? undefined;
  const example3 = object.prop ? object.prop : undefined;
  ```
</CodeGroup>

## How do I extract values from a set of elements in parser code?

Use `toArray().map()` instead of `each()`. It is shorter, returns a real array, and reads as a single expression.

<CodeGroup>
  ```js Bad theme={null}
  const links = [];
  $('.card.product-wrapper').each(function (i, el) {
    links.push({url: $(this).find('h4 a').attr('href')});
  })
  return links;
  ```

  ```js Good theme={null}
  const links = $('.card.product-wrapper').toArray().map(v => ({
    url: $(v).find('h4 a').attr('href'),
  }));
  ```
</CodeGroup>

## How do I normalize text in parser code?

Call `$(selector).text_sane()`. Bright Data Scraper Studio adds this custom method to the Cheerio prototype: it collapses every run of whitespace to a single space and trims the result. For numeric extraction, strip non-digits with a regex.

<CodeGroup>
  ```js Bad theme={null}
  $.prototype.clearText = function () {
    return this.text().replace(/\s+/g, ' ').trim();
  }
  ```

  ```js Good theme={null}
  let name = $('a').text_sane();

  // For digits-only extraction:
  let value = +$('a').text().replace(/\D+/g, '');
  ```
</CodeGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio functions" icon="code" href="/products/scraper-studio/functions">
    Full reference for Bright Data Scraper Studio interaction and parser commands
  </Card>

  <Card title="Worker types" icon="server" href="/products/scraper-studio/worker-types">
    Choose between Browser worker and Code worker for your scraper
  </Card>
</CardGroup>


# Build a scraper with the Bright Data CLI
Source: https://docs.brightdata.com/products/scraper-studio/build-with-the-cli

Use the Bright Data CLI to create, run and self-heal a Scraper Studio scraper from your terminal or any coding agent like Claude Code or Cursor.

The Bright Data CLI builds Bright Data Scraper Studio scrapers from your terminal in three commands: log in with `bdata login`, then `bdata scraper create` and `bdata scraper run`. Run it on demand with `npx`, so there is nothing to install. This tutorial walks you through building a Hacker News top-stories scraper end to end. The CLI runs unchanged inside the embedded terminal of any coding agent like Claude Code, Cursor or Codex.

**Time to complete:** about 10 minutes (AI generation runs in the background)

## Prerequisites

* A Bright Data account ([sign up free](https://brightdata.com/?hs_signup=1\&utm_source=docs), no card required)
* A terminal. Any embedded terminal works too: Claude Code, Cursor, Codex, VS Code

## Run the Bright Data CLI with npx

You do not install anything. Run the CLI on demand with `npx`, which fetches the latest version each time:

```bash theme={null}
npx -p @brightdata/cli bdata --version
```

To keep the rest of this tutorial's commands short, alias `bdata` for your shell session. Otherwise, prefix any `bdata` command below with `npx -p @brightdata/cli`:

```bash theme={null}
alias bdata="npx -p @brightdata/cli bdata"
```

The CLI is published as `@brightdata/cli` on npm. The `bdata` and `brightdata` commands are interchangeable. Prefer a permanent command instead of npx? Install it globally with `npm install -g @brightdata/cli`.

## Build your first scraper from the terminal

<Steps>
  <Step title="Log in">
    Run `bdata login`. The CLI opens a browser tab so you can authorize it against your Bright Data account, then stores your API key locally. You do not paste or copy a key.

    ```bash theme={null}
    bdata login
    ```

    > **Expected result:**
    >
    > ```text theme={null}
    > Opening browser for Bright Data authentication...
    > Logged in successfully. Key: 2e75****12bf
    > Checking for required zones...
    > Zone "cli_unlocker" already exists.
    > Zone "cli_browser" already exists.
    > ```

    The two zones (`cli_unlocker` and `cli_browser`) are the Web Unlocker API and Browser API endpoints the CLI uses when running scrapers. Bright Data creates them automatically on first login.
  </Step>

  <Step title="Create the scraper">
    Pass a target URL and one sentence describing the data you want. Bright Data's AI Agent generates the output schema, writes the scraper code and returns a Collector ID.

    ```bash theme={null}
    bdata scraper create https://news.ycombinator.com \
      "Extract top stories: title, url, points, author, comment count"
    ```

    The AI pipeline runs in seven stages, printed live: `user_intent_analyzer`, `planner`, `collector_maintainer`, `output_schema_generator`, `code_generator`, `input_schema_generator`, `preview_runner` and `preview_picker`. Typical wall-clock time is 5 to 15 minutes; complex targets can take up to 25 minutes.

    > **Expected result:**
    >
    > ```text theme={null}
    > Template created: c_mpohus372o5tmid1jk
    > Triggering AI generation...
    > Generating scraper...
    > Step: user_intent_analyzer — polling (attempt 1/600)
    > ...
    > Done in 280 poll attempts.
    > {"status":"done","completed_steps":[...],"step":"preview_picker"}
    > ```

    Save the Collector ID (the `c_*` string). It is the stable handle for every subsequent run, schedule or API call on this scraper.
  </Step>

  <Step title="Run the scraper">
    Pass the Collector ID and a URL. Use `--pretty` to format the JSON output.

    ```bash theme={null}
    bdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --pretty
    ```

    The CLI tries realtime mode first. If the scraper triggers more pages than the realtime limit allows, the CLI silently falls back to batch mode (`POST /dca/trigger` then poll `GET /dca/dataset`) and continues. No flag needed.

    > **Expected result:** a JSON array, one row per result.
    >
    > ```json theme={null}
    > [
    >   {
    >     "title": "Last.fm is now independent",
    >     "url": "https://support.last.fm/t/last-fm-is-now-independent/118591",
    >     "points": 447,
    >     "author": "twistslider",
    >     "comment_count": 131
    >   },
    >   {
    >     "title": "DuckDuckGo search saw 28% more visits after Google said people love AI mode",
    >     "url": "https://www.pcgamer.com/hardware/duckduckgos-ai-free-search-saw-nearly-28-percent-more-visits-in-the-week-following-googles-insistence-that-people-love-ai-mode/",
    >     "points": 418,
    >     "author": "HelloUsername",
    >     "comment_count": 212
    >   }
    > ]
    > ```
  </Step>
</Steps>

## How do I use this from Claude Code, Cursor or Codex?

The Bright Data CLI runs inside any embedded terminal as-is. The coding agent is not building the scraper itself; the CLI calls Bright Data's AI Agent, and the coding agent calls the CLI on your behalf.

Two integrations make the CLI feel native inside a coding agent:

**Pin the Collector ID in the agent's rules file** so the agent re-uses your scraper across sessions instead of building a fresh one every time:

```text CLAUDE.md / .cursor/rules / CODEX.md theme={null}
SCRAPER_STUDIO_COLLECTOR_ID=c_mpohus372o5tmid1jk
HACKER_NEWS_SCRAPER_USAGE="bdata scraper run $SCRAPER_STUDIO_COLLECTOR_ID <url> --pretty"
```

**Wire Bright Data's MCP server into your agent** with `brightdata add mcp`. The MCP server is separate from the Scraper Studio CLI but gives the agent additional scraping tools (`scrape_as_markdown`, `search_engine` and others) it can call directly:

```bash theme={null}
brightdata add mcp                # interactive: pick Claude Code, Cursor or Codex
```

See the [Bright Data MCP server overview](/products/mcp-server/overview) for what the MCP exposes.

## What just happened?

Three CLI commands mapped to four Bright Data Scraper Studio API endpoints. Use this table to translate the CLI flow into raw HTTP calls when you are ready to integrate without the CLI:

| You ran | Bright Data API endpoint behind it |
| - | - |
| `bdata login` | Local credential store. Stores the API key from [Account Settings](https://brightdata.com/cp/setting). |
| `bdata scraper create` | `POST /dca/collector` then `POST /dca/collectors/{c_*}/automate_template` |
| `bdata scraper run` (small input) | `POST /dca/trigger_immediate` then `GET /dca/get_result` |
| `bdata scraper run` (large input) | `POST /dca/trigger` then poll `GET /dca/dataset?id=j_*` |

For a worked example of the underlying API in cURL, Python and Node.js, see the [Bright Data Scraper Studio API quickstart](/products/scraper-studio/quickstart). For every endpoint, see the [Scraper Studio API reference](/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level).

## How do I fix a scraper when the site changes?

When a target site is redesigned and a scraper starts returning null or missing fields, fix it in place with `bdata scraper heal`. Self-healing keeps the same Collector ID, so every trigger, schedule and integration that references the scraper keeps working. The flow is run, inspect, heal, approve, re-run.

<Steps>
  <Step title="Heal the scraper">
    Pass the Collector ID and a plain-language description of what broke. Keep the prompt under 1,000 characters.

    ```bash theme={null}
    bdata scraper heal c_mpohus372o5tmid1jk \
      "The points and comment_count fields return null since the site redesign. Re-capture them from the new markup." \
      --url https://news.ycombinator.com
    ```

    By default, `heal` stops at an approval gate so you can review the proposed fix before it goes live.

    > **Expected result:** the command returns an envelope with `status: "awaiting_approval"` and a `preview_result` showing sample output from the proposed fix, plus a `next_step` hint with the command to run next.
  </Step>

  <Step title="Approve or reject the fix">
    Review the preview. If it looks right, approve it. The fix commits to the existing scraper and the Collector ID does not change.

    ```bash theme={null}
    bdata scraper approve c_mpohus372o5tmid1jk --url https://news.ycombinator.com
    ```

    To discard the proposed fix and try a sharper prompt instead, reject it:

    ```bash theme={null}
    bdata scraper approve c_mpohus372o5tmid1jk --reject
    ```

    > **Expected result:** on approval, `status` advances to `done`. On reject, the scraper is left unchanged so you can run `heal` again with a clearer prompt.
  </Step>

  <Step title="Re-run to verify">
    Run the healed scraper on the same URL and confirm the previously broken fields are populated.

    ```bash theme={null}
    bdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --pretty
    ```
  </Step>
</Steps>

<Tip>
  For unattended workflows, add `--auto-approve` to the `heal` command. It approves the fix automatically and polls through to `done` in one step. Use it only when you trust the heal without a manual review.
</Tip>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why did `bdata scraper create` take longer than 10 minutes?">
    AI generation timing depends on target complexity. Simple single-page scrapers finish in 5 to 10 minutes. Pages with lazy-load, pagination or anti-bot challenges can take 15 to 25 minutes. The CLI polls Bright Data's AI Flow API every five seconds and prints the current stage, so you can leave it running and check back. No action is needed while you wait.
  </Accordion>

  <Accordion title="Why did the CLI switch from realtime to batch mode mid-run?">
    Realtime mode caps the number of page loads per request. When a scraper triggers more pages than the realtime limit allows, the CLI prints `Realtime page limit exceeded, switching to batch mode...`, submits the same inputs to `POST /dca/trigger`, and polls `GET /dca/dataset?id=j_*` until the snapshot is ready. The switch is automatic and the final JSON shape is identical. See [Scraper Studio specifications](/products/scraper-studio/specifications) for the page-load limits.
  </Accordion>

  <Accordion title="Why are some rows missing fields like `points` or `comment_count`?">
    The AI Agent's generated schema is per-row best-effort, not strict. Jobs posts, "Show HN" entries and very new submissions on Hacker News do not always have a points or comment count yet, so the scraper returns the row with those fields omitted rather than inventing a value. Treat missing fields as `null` in your own code. To enforce a stricter schema, open the scraper in [Scraper Studio](/products/scraper-studio/ai-agent) or rewrite the schema with the [Self-Healing tool](/products/scraper-studio/self-healing-tool).
  </Accordion>

  <Accordion title="Can I trigger this scraper from my own code instead of the CLI?">
    Yes. The Collector ID returned by `bdata scraper create` (the `c_*` string) is the same handle the Bright Data Scraper Studio API uses. Pass it to `POST /dca/trigger` from any HTTP client. See the [Bright Data Scraper Studio API quickstart](/products/scraper-studio/quickstart) for cURL, Python and Node.js examples.
  </Accordion>

  <Accordion title="How do I fix the scraper when the target site changes?">
    Fix it in place with `bdata scraper heal`, which keeps the same Collector ID. See [How do I fix a scraper when the site changes?](#how-do-i-fix-a-scraper-when-the-site-changes) above for the full run, heal, approve, re-run flow. Two alternatives:

    * **Control panel:** use the [Self-Healing tool](/products/scraper-studio/self-healing-tool) to describe the fix in plain language.
    * **Direct API:** the `heal` and `approve` commands wrap a three-call loop. `POST /dca/collectors/{c_*}/refactor_template` with the prompt, poll `GET .../refactor_template/progress` until `status` is `pending_answer`, then `POST .../resume_automation_job` to approve or reject. See [Trigger Self-Healing](/api-reference/scraper-studio-api/ai-flow/trigger-self-healing) and [Resume Self-Healing Job](/api-reference/scraper-studio-api/ai-flow/resume-self-healing-job). For a Node.js implementation, see the [Scraper Studio Self-Healing demo](https://github.com/anil-bd/scraper-studio-self-healing-demo).
  </Accordion>

  <Accordion title="Does `bdata login` work without a browser, for example in CI?">
    The `bdata login` command requires a browser callback. For headless environments, export your API key as `BRIGHTDATA_API_KEY` and the CLI uses it directly without a login step:

    ```bash theme={null}
    export BRIGHTDATA_API_KEY="your_api_key_here"
    bdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com
    ```

    Copy the key from [Account Settings](https://brightdata.com/cp/setting).
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Build with the AI Agent" icon="wand-magic-sparkles" href="/products/scraper-studio/ai-agent">
    Build the same scraper from the Bright Data control panel instead of the terminal
  </Card>

  <Card title="Scraper Studio API quickstart" icon="code" href="/products/scraper-studio/quickstart">
    Trigger an existing scraper from cURL, Python or Node.js
  </Card>

  <Card title="Self-Healing tool" icon="screwdriver-wrench" href="/products/scraper-studio/self-healing-tool">
    Fix a scraper with a plain-language prompt when a target site changes
  </Card>

  <Card title="Bright Data CLI overview" icon="terminal" href="/products/cli/overview">
    Every `bdata` command, with examples
  </Card>
</CardGroup>


# Scraper Studio coding agent prompts
Source: https://docs.brightdata.com/products/scraper-studio/coding-agent-prompts

Copy-pasteable Claude Code, Cursor and Codex prompts to build a Bright Data Scraper Studio scraper: a simple build-and-run prompt plus a full self-heal loop.

Use these copy-pasteable prompts to build a Bright Data Scraper Studio scraper through Claude Code, Cursor or Codex. Start with the one-prompt build-and-run if you just want a scraper fast: swap in your URL and the fields you want, paste, done. The longer flows below add the full build, run, heal, approve, re-run loop for when you need to extend a scraper's schema in place.

## Prerequisites

* A Bright Data account ([sign up free](https://brightdata.com/?hs_signup=1\&utm_source=docs), no card required).
* A coding agent with terminal access: Claude Code, Cursor or Codex.

You do not install the Bright Data CLI ahead of time. The prompts below run it through `npx`, which fetches the latest version on demand, so there is no global dependency to maintain.

## Build a scraper in one prompt

If you just want a scraper fast, paste this prompt and replace the two values in angle brackets: the target URL and the fields you want. The agent runs the Bright Data CLI through `npx`, builds the scraper and runs it once. No self-healing.

```text Prompt theme={null}
Build and run a Bright Data scraper. Run every Bright Data CLI command through `npx -p @brightdata/cli` so nothing is installed globally. Replace <TARGET_URL> and <FIELDS TO EXTRACT>, then do each step in order and stop if a step fails:

1. Authenticate by running `npx -p @brightdata/cli bdata login`. npx fetches the CLI on demand, so there is nothing to install.
2. Create a Bright Data scraper for <TARGET_URL> that extracts: <FIELDS TO EXTRACT>. Report the Collector ID.
3. Run that scraper on the same URL and pretty-print the result.
```

For example, to scrape a product page, the filled-in second step reads:

```text Prompt theme={null}
2. Create a Bright Data scraper for https://shopalto.xyz/product/aurora-wireless-headphones that extracts: product name, price, description and rating. Report the Collector ID.
```

> **Expected result:** the agent reports a Collector ID like `c_mpohus372o5tmid1jk`, then prints a JSON array with one row containing the fields you asked for.

<Tip>
  Save the Collector ID. Reuse it to run the scraper on new URLs, or to extend its schema later with the self-heal flow below.
</Tip>

## Build, run and self-heal in one prompt

To run the full build, run, heal, approve, re-run loop in action, paste this single prompt and let the agent work through every step. The pattern is deliberate: build a minimal scraper first, then heal it to extend the schema, so the heal envelope's `preview_result` is easier to verify against a known-good baseline. The agent runs every Bright Data CLI command through `npx`, so nothing is installed globally.

```text Prompt theme={null}
Build, run, heal and verify a Bright Data scraper end to end. Run every Bright Data CLI command through `npx -p @brightdata/cli` so nothing is installed globally. Do every step in order and stop if a step fails:

1. Authenticate by running `npx -p @brightdata/cli bdata login`. npx fetches the CLI on demand, so there is nothing to install.
2. Create a Bright Data scraper for https://shopalto.xyz/product/aurora-wireless-headphones that extracts two fields: product name and price. Report the Collector ID.
3. Run that scraper on the same URL and pretty-print the result. Expect one row with name and price.
4. Heal the scraper in place to also capture description, image url and rating alongside the existing name and price. Keep the same Collector ID, anchor the heal on the same URL and show the approval envelope.
5. When the preview shows all five fields, approve the fix anchored on the same URL.
6. Run the scraper on the same URL again and confirm all five fields come back: name, price, description, image_url and rating.
```

> **Expected result:** the agent ends with a JSON row containing `name`, `price`, `description`, `image_url` and `rating`, and the Collector ID is unchanged from step 2.

## Run the flow step by step

Work through the prompts below one at a time when you want to inspect each Collector ID, run result and heal envelope before moving on.

<Steps>
  <Step title="Prompt the agent to authenticate the CLI">
    ```text Prompt theme={null}
    Run every Bright Data CLI command through `npx -p @brightdata/cli` so nothing is installed globally. Authenticate by running `npx -p @brightdata/cli bdata login`, then confirm the version with `npx -p @brightdata/cli bdata --version` before continuing.
    ```

    > **Expected result:** the agent prints a `bdata` version and confirms it is authenticated. npx fetches the CLI on demand, so nothing is installed globally.
  </Step>

  <Step title="Prompt the agent to build a minimal scraper">
    ```text Prompt theme={null}
    Create a Bright Data scraper for https://shopalto.xyz/product/aurora-wireless-headphones that extracts just two fields: product name and price. Show me the Collector ID when it is done.
    ```

    > **Expected result:** the agent reports a Collector ID like `c_mpohus372o5tmid1jk`. Hold onto it; the rest of the prompts reuse the same ID.
  </Step>

  <Step title="Prompt the agent to run it">
    ```text Prompt theme={null}
    Run that scraper on https://shopalto.xyz/product/aurora-wireless-headphones and pretty-print the result.
    ```

    > **Expected result:** a JSON array with one row, populated with `name` and `price` only.
  </Step>

  <Step title="Prompt the agent to heal and add more fields">
    ```text Prompt theme={null}
    Extend the scraper in place. Heal it to also capture description, image url and rating alongside the existing name and price. Keep the same Collector ID. Anchor the heal on https://shopalto.xyz/product/aurora-wireless-headphones and show me the approval envelope when it is ready.
    ```

    > **Expected result:** the agent reports `status: "awaiting_approval"` with a `preview_result` row that now shows five fields.
  </Step>

  <Step title="Prompt the agent to approve the fix">
    ```text Prompt theme={null}
    The preview looks good. Approve the fix, anchored on https://shopalto.xyz/product/aurora-wireless-headphones.
    ```

    > **Expected result:** `status` advances to `done`. The Collector ID is unchanged.
  </Step>

  <Step title="Prompt the agent to verify the expanded schema">
    ```text Prompt theme={null}
    Run the scraper on https://shopalto.xyz/product/aurora-wireless-headphones again and confirm all five fields now come back: name, price, description, image_url and rating.
    ```

    > **Expected result:** the same JSON shape as the earlier run, now with three additional fields per row.
  </Step>
</Steps>

<Tip>
  For an unattended variant, ask the agent to add `--auto-approve` to the heal call. The agent skips the approval gate and polls through to `done` in one step. Use it only when you trust the heal without a manual review.
</Tip>

## Related

<CardGroup>
  <Card title="Build with the Bright Data CLI" icon="terminal" href="/products/scraper-studio/build-with-the-cli">
    The canonical CLI tutorial: install, log in, create, run, heal
  </Card>

  <Card title="Self-Healing tool" icon="screwdriver-wrench" href="/products/scraper-studio/self-healing-tool">
    Fix a scraper from the Bright Data control panel
  </Card>

  <Card title="Scraper Studio API quickstart" icon="code" href="/products/scraper-studio/quickstart">
    Trigger an existing scraper from cURL, Python or Node.js
  </Card>

  <Card title="Bright Data CLI commands" icon="book" href="/products/cli/commands">
    Flag reference for scraper create, heal and approve
  </Card>
</CardGroup>


# Complete Scraper Studio IDE examples
Source: https://docs.brightdata.com/products/scraper-studio/complete-examples

Browse 6 end-to-end Bright Data Scraper Studio IDE examples covering interaction code, parser code, multi-result handling and advanced site navigation.

<Warning>
  This article applies only to the IDE Normal V2 version, which is for internal use and not available to customers.
</Warning>

## Introduction

The collect and parse commands have been removed. The data will be returned from parser code as an object or array, and it will be automatically saved to the output:

<CodeGroup>
  ```js Interaction code theme={null}
  // Old code
  navigate("https://example.com");
  collect(parse());

  // New code
  navigate("https://example.com");

  // New code alternative
  navigate("https://example.com");
  tag_html("html_key");
  ```

  ```js Parser code theme={null}
  // Old code
  return {
      title: $('h1').text(),
  };

  // New code
  return {
      title: $('h1').text(),
  };

  // or
  let $ = load_html(parser.html_key);
  return {
      title: $('h1').text(),
  };
  ```
</CodeGroup>

New commands have been added to provide access to the data from the interaction code: `tag_html`, `tag_request`, `tag_graphql`

In addition, some existing commands have been updated: `tag_response`, `tag_sitemap`, `tag_all_responses`. See [IDE documentation](/products/scraper-studio/develop-a-scraper) for more details.

When using any tag commands, you can provide a custom name. You can then access the data using this name in the parser code under parser.`YOUR_KEY`.

For `tag_html`, current browser location URL will be saved under parser.`YOUR_KEY_url`.

For simple cases when only a single `tag_html` is needed, it can be skipped, and it will be automatically saved under parser.page.

<CodeGroup>
  ```js Interaction code theme={null}
  navigate("https://example.com/1");
  tag_html("page1");
  navigate("https://example.com/2");
  tag_html("page2");
  navigate("https://example.com/3");
  tag_html("page3");
  ```

  ```js Parser code theme={null}
  {page1, page1_url, page2, page2_url, page3, page3_url} = parser;
  let $ = load_html(page2);
  return {
    title2: $('h1').text(),
  };
  ```
</CodeGroup>

Sometimes, it's necessary to get parsed data within the interaction code and use it to make request. See examples how to do it:

<CodeGroup>
  ```js Interaction code theme={null}
  navigate("https://example.com/1");
  tag_html("page1");
  let page_html = html();
  let page_html2 = wait_for_parser_value("page1"); // the same
  let $ = load_html(page_html);
  let req_id = $('.product-id').text();
  tag_request("product_json", {url: "https://example.com/product/"+req_id});
  ```

  ```js Parser code theme={null}
  {product_json} = parser;
  return product_json;
  ```
</CodeGroup>

## How to return multiple results

To collect multiple results, array can be returned from the parser code.

<CodeGroup>
  ```js Interaction code theme={null}
  navigate("https://example.com/products");
  ```

  ```js Parser code theme={null}
  let items = $(".product").toArray().map(v=>$(v)).map(v=>({
    title: v.find(".title").text(),
    price: v.find(".price").text(),
    url: new URL(v.find("a").attr("href")),
  }));
  return items;
  ```
</CodeGroup>

## How to reparse collected data

Reparse is a new feature that allows to reparse the data that was already collected. It can be useful when you want to change the parser code without rerunning the entire interaction code:

<img alt="Scraper Studio IDE with the 'Run only parser code' button highlighted between the Interaction code and Parser code panels" />

## `next_stage` and `rerun_stage`

When scraper has more than one step, the parser code is only available in the last step. All other steps can only have `next_stage` calls. To parse something from the page, `load_html` should be used:

<CodeGroup>
  ```js Interaction code step 1 theme={null}

  navigate(input.domain_url);
  tag_html('html');
  const $ = load_html(wait_for_parser_value('html'));
  $('a.layout-categories-category__link').toArray()
    .map(v => new URL($(v).attr('href'), location.href))
    .filter(x => !x?.href.includes('home')).forEach(i => {
    next_stage({url: i})
  });
  ```

  ```js Interaction code step 2 theme={null}
  block(['*.ico', '*.png', '*.jpg', '/images/', '*gif']);
  navigate(input.url);
  wait('.view-option-selector-button, .product-groups_empty-list');
  if(el_exists('.product-groups_empty-list'))
    dead_page('There are no products in this category')
  wait('[aria-describedby="onetrust-policy-text"]');
  click('button#onetrust-reject-all-handler');
  wait_hidden('[aria-describedby="onetrust-policy-text"]');
  $('.view-option-selector-button').eq(2).click();
  wait_page_idle(2000);
  scroll_to('bottom');
  wait_page_idle(2000);
  ```

  ```js Parser code theme={null}
  return $('a[data-qa-action="product-click"]').toArray()
    .map(v => ({url: new URL($(v).attr('href'))}));
  ```
</CodeGroup>

## Basic PDP scraper

<CodeGroup>
  ```js Interaction code theme={null}
  let url = new URL(input.url.replace('https://www.slintel.com','https://6sense.com'));
  url = new URL(url.pathname, 'https://6sense.com');
  navigate(url);
  if (location.href === 'https://6sense.com/company')
    dead_page(`Page not found`);
  tag_html('html');
  ```

  ```js Parser Code theme={null}
  const $ = load_html(parser.html)
  const nextData = JSON.parse($('#__NEXT_DATA__').html());
  const pageProps = nextData.props.pageProps;
  const companyInfo = pageProps.company_data.companyInfo;

  const linkedin = companyInfo.linkedin ?
    (companyInfo.linkedin.includes('http') ? companyInfo.linkedin :
      'https://'+companyInfo.linkedin) : null;
  const techCategories = pageProps.company_data?.technologies_mapper_view?.categories
    ? Object.values(pageProps.company_data.technologies_mapper_view.categories).map(v => Object.keys(v)).flat()
    : null;
  const pageData = {
      "name": companyInfo.name,
      "about": companyInfo.company_description,
      "num_employees": companyInfo.employee_range,
      "type": companyInfo.company_type,
      "industries": companyInfo.industry_v2_ranked.filter(v=>v),
      "techstack_arr": techCategories,
      "country_code": companyInfo.country,
      "website": companyInfo.display_domain
        ? new URL(companyInfo.display_domain.includes('http')
            ? companyInfo.display_domain
            : 'https://'+companyInfo.display_domain)
        : null,
      "social_media_urls": linkedin,
      "company_news": pageProps.company_data.company_news.map(v=>({
        title: "company_news_data",
        date: "",
        link: "",
      })),
      "last_updated": new Date(companyInfo.last_updated_at*1e3),
      "url": new URL(parser.html_url),
      "logo": companyInfo.logo,
      "location": companyInfo.location,
      "region": [companyInfo.country, companyInfo.state].filter(v=>v).join(', '),
      "id": nextData.query.companyid,
      "slintel_resources": companyInfo.recommended_companies.map(v=>({
        link: v.display_domain ? new URL(v.display_domain.includes('http') ? v.display_domain : 'https://'+v.display_domain) : null,
        title: v.name,
        type: v.company_type,
      })),
      "stock_symbol": companyInfo.stock_symbol,
  };
  return pageData;
  ```
</CodeGroup>

## Multiple navigates example

<CodeGroup>
  ```js Interaction code theme={null}
  const tabs = [
    'topactivity',
    'answers',
    'questions',
    'tags',
    'articles',
    'badges',
    'bookmarks',
    'bounties'
  ];
  function loadTab(url, name) {
    return new Promise(async (resolve, reject)=>{
      try {
          const tabUrl = new URL(url);
          tabUrl.searchParams.set('tab', name);
          navigate(tabUrl, { allow_status: [404] });
          const html_ = html();
          tag_html(name);
          resolve(html_);
      } catch(e) { reject(e); }
    });
  }
  const userIdFromUrl = (input.url && input.url.includes('https://stackoverflow.com/users/'))
      ? input.url.replace('https://stackoverflow.com/users/', '').split('/').shift()
      : null;
  const userId = input.user_id || userIdFromUrl || 1;
  const userUrl = `https://stackoverflow.com/users/${userId}`;
  navigate(userUrl, { allow_status: [404] });
  tag_html('user');
  Promise.all(tabs.map( async tabName => loadTab(userUrl, tabName)));
  ```

  ```js Parser code theme={null}
  const steps = [
    'user',
    'topactivity',
    'answers',
    'questions',
    'tags',
    'articles',
    'badges',
    'bookmarks',
    'bounties',
    'finally'
  ];
  const parse = Handlers();
  let missed_parser_data = Object.keys(parse)
    .filter(handler_key=>!steps.find(sk=> sk == handler_key));
  if (missed_parser_data.length)
      throw new Error('missed parser data')

  return steps.reduce((acc, step) => {
      console.log('handling: '+step)
      if (step=='finally')
          return parse.finally(acc);
      let page_source = parser[step];
      console.log(parser[step]);
      console.log('parser[step]');
      if (!page_source)
        throw('unexpected empty data, data not saved')
      const $ = load_html(page_source);
      const data_chunk = parse[step]($);
      acc = { ...acc, ...data_chunk };
      return acc;
  }, {});

  function Handlers() {
    return {
      'finally': (res) =>{
        res.url = new URL(res.url);
        res.answers.map(v => v.tags = res.tags);
        res.answers.map(v => v.url = new URL(v.url));
        res.questions.map(v => v.url = new URL(v.url));
        res.top_posts.map(v => v.date = new Date(v.date));
        res.active_from = new Date(res.active_from)
        return res;
      },
      'user': ($)=>{
        const grid = $('#main-content .d-grid > .grid--item')
          .toArray().map(v=>$(v));
        let collectives = grid.find(v=>v.find('> div').text()
          .includes('Collectives'));
        if (collectives?.length) {
            collectives = collectives.find('.fl1').toArray()
            .map(v=>({
                name: $(v).find('.fs-body2').text_sane() || null,
                text: $(v).find('.fs-caption').text_sane() || null,
            }));
        }
        else
          collectives = [];
        let communities = grid.find(v=>v.find('> div').text()
          .includes('Communities'));
        if (communities?.length) {
            communities = communities.find('li.flex--item')
              .toArray().map(v=>({
                name: $(v).find('.fl-grow1').text_sane() || null,
                score: $(v).find('.fl-shrink0').text_sane()
                  .replace(/,/gm, '') || null,
              }));
        }
        else
          communities = [];
        let badges = $('.flex__fl-equal > .flex--item').toArray()
          .map(v=>{
            let $v = $(v);
            return {
                badge_type: $v.find('.mr12 .fc-gold').length
                  ? 'gold'
                  : $v.find('.mr12 .fc-silver').length
                      ? 'silver'
                      : $v.find('.mr12 .fc-bronze').length
                          ? 'bronze'
                          : 'unknown',
                badge_name: $v.find('.fs-caption').text_sane()
                  .replace(' badges', '') || null,
                number_of_badges: $v.find('.fs-title').text()
                  .replace(/,/gm, '') || null,
                badges: $v.find('a.badge').toArray().map(b=>({
                    name: $(b).text_sane() || null,
                    description: $(b).attr('title') || null
                }))
            };
        });
        return {
          url: new URL(parser.user_url),
          id: parser.user_url.split('/').pop(),
          'id#': (input.url && input.url
              .includes('https://stackoverflow.com/users/'))
              ? input.url?.match(/https:\/\/stackoverflow.com/users/(d{1,15}).*/)?.[1]/gm)
              : input.user_id
            || 1,
          user_id: +$('[property="og:url"]').attr('content')
            .match(/https:\/\/stackoverflow.com/users/(d{1,15}).*/)?.[1]/)/gm
              || +input.url?.match(/https:\/\/stackoverflow.com/users/(d{1,15}).*/)?.[1]/gm)
              || +input.user_id
              || null,
          name: $('.fs-headline2').text_sane() || null,
          type: $('#mainbar-full > div:first-child .s-badge')
            .text_sane() || null,
          title: $('#mainbar-full > div:first-child .fs-title')
            .text_sane() || null,
          active_from: new Date(
            $('#mainbar-full > div:first-child .list-reset span[title]').attr('title')),
          last_seen: $('#mainbar-full > div:first-child .fs-title + ul li:last-child')
            .text_sane() || null,
          linkes: $('#mainbar-full > div:first-child ul.list-reset:last-child a')
            .toArray().map(v => $(v).attr('href')),
          location: $('#mainbar-full > div:first-child ul.list-reset:last-child li:last-child div[title]')
            .attr('title') || null,
          stats: $('#stats .flex--item').toArray()
            .map(v => $(v).text_sane()).filter(v => v),
          about: $('#main-content .s-prose p').toArray()
            .map(v => $(v).text_sane()) || null, //.join('\r'),
          collectives,
          communities,
          badges,
          top_tags: $('#top-tags .p12').toArray().map(v=>({
              name: $(v).find('.s-tag').text_sane() || null,
              score: $(v).find('.d-flex > .d-flex:nth-child(1)')
                .text_sane().replace(' Score', '')
                .replace(/,/gm, '') || null,
              posts: $(v).find('.d-flex > .d-flex:nth-child(2)')
                .text_sane().replace(' Posts', '')
                .replace(/,/gm, '') || null,
              posts_percent: $(v).find('.d-flex > .d-flex:nth-child(3)')
                .text_sane().replace(' Posts %', '').replace(/,/gm, ''),
          })),
          top_posts: $('#js-top-posts .p12 .d-flex').toArray().map(v=>({
              type: $(v).find('.iconQuestion').length ? 'question'
                : ($(v).find('.iconAnswer').length ? 'answer' : 'none'),
              score: $(v).find('.s-badge').text_sane()
                .replace(/,/gm, '') || null,
              text: $(v).find('a.d-table')
                .text_sane() || null,
              date: new Date($(v).find('.relativetime')
                .attr('title')),
          })),
          top_meta_posts: $('#js-top-posts + div .p12 .d-flex')
            .toArray().map(v=>({
              score: $(v).find('.s-badge').text_sane()
                .replace(/,/gm, '') || null,
              text: $(v).find('a.d-table').text_sane() || null,
          })),
          top_network_posts: $('#js-top-posts + div + div .p12 .d-flex')
            .toArray().map(v=>({
              score: $(v).find('.s-badge').text_sane()
                .replace(/,/gm, '') || null,
              text: $(v).find('a.d-table').text_sane() || null,
          }))
        };
      },
      'topactivity': ($) => {
          let summary_graph_data;
          try {
              summary_graph_data = JSON.parse(
                /graphDatas[^[]+([[^]]+])/gm.exec(
                  $('*').first().html())?.[1]);
          } catch(e) {
              console.log('graphData not found')
          }
          let [summary_people_reached, summary_posts_edited,
            summary_helpful_flags, summary_votes_cast] =
            $('div:not(.js-highlight-box-reputation) > h1.flex--item + div .flex--item .fs-body3')
              .toArray().map(v=>$(v).text_sane().replace(/,/gm, '') || null);
          return {
              summary_reputation: +$('#top-cards h4.fs-headline1')
                .text().replace(/D+/gm, ''),
              summary_top_overall: $('a[href*="alltime"]')
                .first().text_sane() || null,
              summary_next_tag_badge: $('#rep-card-next-tag-badge a')
                .text_sane() || null,
              summary_graph_data,
              summary_next_tag_score:
                $('div.fl-shrink1 + div.fl-grow1 .fs-fine')
                  .first().text_sane().replace(/,/gm, '') || null,
              summary_next_tag_answers:
                $('div.fl-shrink1 + div.fl-grow1 .fs-fine')
                  .last().text_sane().replace(/,/gm, '') || null,
              summary_badges: $('h3 +div .s-badge').toArray()
                .map(v => $(v).attr('title')).join(', '),
              summary_last_badge: $('#badge-card-last').text_sane() || null,
              summary_next_badge: {
                  name: $('#js-badge-card-next').text_sane() || null,
                  progress: $('h4.flex--item.ws-nowrap + span')
                    .text_sane() || null
              },
              summary_people_reached,
              summary_posts_edited,
              summary_helpful_flags,
              summary_votes_cast,
          };
      },
      'answers': ($) => {
          return {
              answers: $('#js-post-summaries .s-post-summary')
                .toArray().map(p=>{
                  let $p = $(p);
                  return {
                      id: $p.attr('data-post-id') || null,
                      votes: $p.find('.s-post-summary--stats-item-number')
                        .text().replace(/,/gm, '') || null,
                      accepted: !!$p.find('svg.iconCheckmarkSm').length,
                      url: new URL($p.find('.answer-hyperlink')
                        .attr('href'), location.href),
                      text: $p.find('.answer-hyperlink').text_sane() || null,
                      tags: $p.find('.post-tag').toArray()
                        .map(v => $(v).text_sane() || null ).map(name=>({name}))
                  };
              }),
          }
      },
      'questions': ($) => {
          return {
              questions: $('#js-post-summaries .s-post-summary')
                .toArray().map(p=>{
                  let $p = $(p);
                  return {
                      id: $p.attr('data-post-id') || null,
                      votes: $p.find('.s-post-summary--stats-item-number')
                        .text().replace(/,/gm, '') || null,
                      accepted: !!$p.find('svg.iconCheckmarkSm').length,
                      answer_count:
                        $p.find('.s-post-summary--stats-item:nth-child(2) .s-post-summary--stats-item-number')
                        .text_sane().replace(/,/gm, '') || null,
                      url: new URL($p.find('.s-link').attr('href'),
                        location.href),
                      text: $p.find('.s-link').text_sane() || null,
                      tags: $p.find('.post-tag').toArray()
                        .map(v => $(v).text_sane() || null)
                  };
              }),
          };
      },
      'tags': ($) => {
          return {
              tags: $('#user-tab-tags .ba .p12').toArray()
                .map(v=>$(v)).map(v=>({
                  name: v.find('.post-tag').text_sane() || null,
                  badge: v.find('.badge-tag').attr('title') || null,
                  description: v.attr('title') || null,
                  score: v.find('.flex--item:first-child > .fs-body3')
                    .text_sane().replace(/,/gm, '') || null,
                  posts: v.find('.flex--item:last-child > .fs-body3')
                    .text_sane().replace(/,/gm, '') || null,
              })),
          };
      },
      'articles': ($) => {
          return {
              articles_count: $('h2.fs-title').text()
                .replace(/D+/gm, '') || null
          };
      },
      'badges': ($) => {
          return {
              badges: $('#user-tab-badges .grid--item').toArray()
                .map(v => ({
                  name: $(v).find('.mbn4').text_sane() || null,
                  count: $(v).find('.ml4').text_sane()
                    .replace(/D+/gm, '') || 0
                })),
          };
      },
      'bookmarks': ($) => {
          return {
              bookmarks: $('#js-post-summaries .s-post-summary')
                .toArray().map(p=>{
                  let $p = $(p);
                  return {
                      id: $p.attr('data-post-id'),
                      votes:
                        $p.find('.s-post-summary--stats-item__emphasized .s-post-summary--stats-item-number')
                          .text_sane().replace(/,/gm, '') || null,
                      views: $p.find('.is-supernova .s-post-summary--stats-item-number')
                        .text_sane().replace(/,/gm, '') || null,
                      accepted: !!$p.find('svg.iconCheckmarkSm').length,
                      answer_count: $p.find('.s-post-summary--stats-item:nth-child(2) .s-post-summary--stats-item-number')
                        .text_sane().replace(/,/gm, '') || null,
                      url: new URL($p.find('.s-link').attr('href'),
                        location.href).href,
                      text: $p.find('.s-link').text_sane() || null,
                      tags: $p.find('.post-tag').toArray()
                        .map(v => $(v).text_sane() || null)
                  };
              })
          };
      },
      'bounties': ($) => {
          return {
              bounties_count: $('h2.fs-title').text()
                .replace(/D+/gm, '') || null
          };
      },
    }
  }
  ```
</CodeGroup>

## Multiple `tag_response`

<CodeGroup>
  ```js Interaction code theme={null}
  close_popup('._1piuevz', '._1piuevz');
  tag_response('stay', /\/StaysPdpSections/);
  tag_response('calendar', /\/PdpAvailabilityCalendar/);
  tag_response('reviews', /api\/v3\/StaysPdpReviews/);
  navigate(input.url+'?enable_auto_translate=false#availability-calendar');
  if (el_exists('img[src*="error_pages/404"]'))
    return dead_page('Page not found');
  const room_id = /\/(\d+)(?:\?|$)/.exec(input.url)?.[1];
  if (el_exists('._wgmchy ._1qx9l5ba'))
    click('._wgmchy ._1qx9l5ba');
  wait('#data-state, #data-deferred-state',{timeout: 6e4});
  wait_for_parser_value('stay');
  wait_for_parser_value('calendar');
  wait_for_parser_value('reviews');
  tag_html('html');
  ```

  ```js Parser code theme={null}
  let room_id = /([0-9]+)(?:\?|$)/.exec(input.url)?.[1];
  const $ = load_html(parser.html);
  let price = +$('[data-section-id="BOOK_IT_SIDEBAR"] ._14y1gc ._tyxjp1')
    .first().text().replace(/[^[0-9].,]+/gm,'')
  let currency = $('._tyxjp1').last().text().replace(/[0-9,]/g, '').trim()
  let data = JSON.parse($('#data-state, #data-deferred-state').html())
  price = price ? new Money(price, currency) : null
  let avatar = $('._9ofhsl').attr('src')
  let name = $('.tehcqxo h2.hnwb2pb').text().split('by')?.[1]?.trim()
    || $('._cv5qq4 ._14i3z6h').text().split('by')?.[1]?.trim()
  let { stay, calendar, reviews} = parser;
  let cd = data.niobeMinimalClientData.find(f=>f.find(f2=>
    f2?.data?.presentation?.stayProductDetailPage))?.find(f2=>
    f2?.data?.presentation?.stayProductDetailPage)
    .data?.presentation?.stayProductDetailPage?.sections;
  let sections = stay.data.presentation.stayProductDetailPage.sections
    .sections || [];
  sections = sections.concat(cd?.sections);
  function get_section(name) {
    return sections.find(v=>v.sectionId == name).section;
  }

  let metadata = stay.data.presentation.stayProductDetailPage.sections
    .metadata || cd?.metadata;
  let category_rating = [];
  sections.find(v=>v?.sectionId == "REVIEWS_DEFAULT")?.section
    ?.ratings?.forEach(r=>{
      category_rating.push({
      name: r.label,
      value: r.localizedRating,
    });
  });
  let sec_sheet = get_section("BOOK_IT_CALENDAR_SHEET");
  let sec_book_it = get_section("BOOK_IT_SIDEBAR");
  price = sec_book_it.structuredDisplayPrice.price
    ?.replace(/[^[0-9].]/,'') || price;
  currency = data.userAttributes?.curr || currency;
  let available_dates = [];
  calendar.data.merlin.pdpAvailabilityCalendar.calendarMonths.forEach(m=>{
    m.days.forEach(d=>{
      if (d.available) available_dates.push(d.calendarDate);
    });
  });
  let image = metadata.sharingConfig.imageUrl ||
    sections.find(v=>v.sectionId == "PHOTO_TOUR_SCROLLABLE_MODAL")
      .section.mediaItems[0].baseUrl;
  if (image) image = new Image(image);
  avatar = sections.find(v=>v?.sectionId == "HOST_PROFILE_DEFAULT")
    ?.section?.hostAvatar?.avatarImage?.baseUrl || avatar;
  if (avatar) avatar = new Image(avatar);
  return {
    name: metadata.sharingConfig.title,
    price,
    image,
    description: sections.find(v=>v?.sectionId == "DESCRIPTION_MODAL")
      ?.section?.items?.map(v=>((v?.title||'')+' '+v?.html?.htmlText).trim()
    )?.join(', '),
    category: metadata.seoFeatures.breadcrumbDetails[1].linkText,
    availability: sec_sheet.available.toString(),
    reviews: reviews.data.presentation.stayProductDetailPage.reviews
      .reviews.map(r=>r.localizedReview?.comments || r.comments),
    ratings: metadata.sharingConfig.starRating,
    seller_info: {
        name: sections.find(v=>v?.sectionId == "HOST_PROFILE_DEFAULT")
          ?.section?.title || name,
      url: new URL(`https://www.airbnb.ru/contact_host/${room_id}/send_message`),
        avatar,
        features: sections.find(v=>v?.sectionId == "HOST_PROFILE_DEFAULT")
          ?.section?.hostFeatures?.map(f=>({
            name: f.title,
            value: f.subtitle
          }))
      },
    breadcrumbs: sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")
      ?.section?.previewLocationDetails?.[0]?.title,
    location: sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")
      ?.section?.previewLocationDetails?.[0]?.title,
    lat: metadata.loggingContext.eventDataLogging.listingLat ||
      sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")?.section?.lat,
    long: metadata.loggingContext.eventDataLogging.listingLng ||
      sections.find(v=>v?.sectionId == "LOCATION_DEFAULT")?.section?.long,
    guests: sec_book_it.maxGuestCapacity || sections
      .find(v=>v?.sectionId == "AVAILABILITY_CALENDAR_DEFAULT")
        ?.section?.maxGuestCapacity,
    pets_allowed: sec_book_it.petsAllowed,
    description_items: sections.find(v=>
        v?.sectionId == "AVAILABILITY_CALENDAR_DEFAULT")?.section
          ?.descriptionItems.map(v=>v.title),
    category_rating,
    house_rules: sections.find(v=>v?.sectionId == "POLICIES_DEFAULT")
      ?.section?.houseRules?.map(r=>r?.title),
    details: sections.find(v=>v?.sectionId == "OVERVIEW_DEFAULT")
      ?.section?.detailItems?.map(f=>f?.title),
    highlights: sections.find(v=>v?.sectionId == "HIGHLIGHTS_DEFAULT")
      ?.section?.highlights?.map(f=>({
        name: f.title,
        value: f.subtitle
      })),
    arrangement_details: sections.find(v=>
        v?.sectionId == "SLEEPING_ARRANGEMENT_DEFAULT")?.section
          ?.arrangementDetails?.map(f=>({
            name: f.title,
            value: f.subtitle
          })),
    amenities:  sections.find(v=>v?.sectionId == "AMENITIES_DEFAULT")
      ?.section?.seeAllAmenitiesGroups?.map(g=>({
        group_name: g.title,
        items: g.amenities.filter(f=>f.available).map(f=>({
          name: f.title,
          value: f.subtitle
        }))
    })),
    images: sections.find(v=>v?.sectionId == "HERO_DEFAULT")
      ?.section?.previewImages?.map(v=>new Image(v?.baseUrl)),
    available_dates,
    url: new URL(input.url),
    final_url: new URL(location.href),
  };
  ```
</CodeGroup>


# Develop a scraper with the IDE
Source: https://docs.brightdata.com/products/scraper-studio/develop-a-scraper

Build a custom web scraper in the Bright Data Scraper Studio IDE: write interaction and parser code, preview results, debug runs, and ship to production.

This guide walks through building a custom web scraper in the Bright Data Scraper Studio IDE from scratch. You will write interaction code that navigates the target site, parser code that extracts structured fields, and then save the scraper to production and configure delivery. By the end, you will have a runnable scraper you can trigger by API, manually, or on a schedule.

## Prerequisites

* An active [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with access to Scraper Studio
* Basic JavaScript familiarity (variables, functions, control flow)
* A target URL you want to scrape

<Tip>
  If you prefer describing the scraper in plain language instead of writing code, use the [Scraper Studio AI Agent](/products/scraper-studio/ai-agent). The agent generates the same kind of scraper the IDE would produce.
</Tip>

## How do I build a scraper in the IDE?

<Steps>
  <Step title="Open the Scraper Studio IDE">
    Go to [brightdata.com/cp/scrapers](https://brightdata.com/cp/scrapers), click **Scraper Studio**, then click **Open IDE** to open an empty scraper.
  </Step>

  <Step title="Start from scratch or pick a template">
    You can start from a blank scraper or use a template.

    Templates are pre-built scraper starters for common patterns and sites. Use a template when your target site or scraping pattern is similar to one of the available options.

    Use a blank scraper when you want full control over the scraping flow from the beginning.
  </Step>

  <Step title="Write interaction code">
    Interaction code navigates the target site and captures the data you need into the parser. Select **Interaction code** from the left sidebar and write the code in the main editor.

    A minimal interaction script:

    ```js theme={null}
    navigate(input.url);
    wait('.product-title');

    let data = parse();
    collect(data);
    ```

    In this example:

    * `navigate(input.url)` opens the page provided in the input.
    * `wait('.product-title')` waits for the expected element.
    * `parse()` runs the parser code.
    * `collect(data)` adds the parsed record to the output dataset.

    For a multi-page scrape, fan out with `next_stage()`:

    ```js theme={null}
    navigate(input.url);
    wait('.listing');
    let listings = parse().listings;
    for (let url of listings)
      next_stage({url});
    ```

    See [Scraper Studio functions](/products/scraper-studio/functions) for the full list of interaction commands.
  </Step>

  <Step title="Write parser code">
    Parser code reads the HTML or response loaded by interaction code and returns a structured JavaScript object.

    Select **Parser code** from the left sidebar and define the fields you want to extract.

    Parser code commonly uses Cheerio’s jQuery-like `$` selector:

    ```js theme={null}
    return {
      title: $('h1').text_sane(),
      price: new Money(+$('.price').text().replace(/\D+/g, ''), 'USD'),
      image: new Image($('img.product').attr('src')),
      listings: $('.listing a').toArray().map(el => $(el).attr('href')),
    };
    ```

    The object returned by parser code is available wherever interaction code calls `parse()`. See [Scraper Studio functions](/products/scraper-studio/functions#parser-functions) for the parser helpers Bright Data Scraper Studio provides.
  </Step>

  <Step title="Choose a worker type">
    In the **Settings** panel, pick the worker type:

    * **Code worker** (faster): for static HTML pages and public JSON endpoints
    * **Browser worker**: for JavaScript-rendered pages, clicks, scrolling, popups, or captured background traffic

    Start with **Code worker** when possible. Switch to **Browser worker** if the data you need is not available in the raw response or if you need [browser-only](/products/scraper-studio/functions#browser-only-functions) functions.

    See [**Worker types**](/products/scraper-studio/worker-types) for the full comparison.
  </Step>

  <Step title="Run a preview">
    Use **Preview** to test the scraper before making it active for production use.

    Preview runs the scraper code against the input selected in the **Input** tab at the bottom-left of the IDE. Use it to test interaction logic, parser logic, output structure, and errors before running the scraper on a larger input set.

    The results appear in the **Output** tab. Use the **Run log** and **Browser network** tabs to debug failed runs.

    > **Expected result:** the Output tab shows a structured record with the fields defined in your parser code.
  </Step>

  <Step title="Save to production">
    When the preview returns the expected output, click **Finish editing** in the top-right corner. For an existing production scraper, click **Save to production** to apply your changes.

    The scraper appears under **My Scrapers** in the control panel and can be triggered by API, manually, or on a schedule.
  </Step>

  <Step title="Configure delivery">
    Open the scraper from **My Scrapers** and configure **Delivery preferences**. Choose a delivery destination, such as API download, webhook, Amazon S3, GCS, Azure, SFTP, Snowflake or email and a file format (JSON, NDJSON, CSV, XLSX). See [Initiate collection and delivery](/products/scraper-studio/initiate-collection-and-delivery-options) for all available options.
  </Step>

  <Step title="Initiate the scraper">
    After the scraper is active and delivery is configured, start a production run. Choose the initiation method that matches your workflow:

    * [Initiate by API](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run) - start a run from your application or automation workflow.
    * [Initiate manually](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run) - start a run from the control panel by entering inputs or uploading a file.
    * [Schedule a scraper](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run) - run the scraper automatically on a recurring schedule.
  </Step>
</Steps>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I debug a scraper that fails on a specific input?">
    Open the scraper in the Bright Data Scraper Studio IDE and check the **Last errors** tab. Every failed input is stored with its exact error message and error code (up to the most recent 1,000 failures). Re-run the failing input from the IDE to reproduce the problem locally, fix the interaction or parser code, and save a new production version.
  </Accordion>

  <Accordion title="Can I edit a scraper that was generated by the AI Agent?">
    Yes. Every scraper in Bright Data Scraper Studio, regardless of how it was created, can be opened and edited in the IDE. You can change extraction logic, tweak selectors, add or remove output fields, and change the worker type.
  </Accordion>

  <Accordion title="How do I add fields to the output schema?">
    Click **Edit Schema** in the IDE's output schema panel and add the new fields, or return them from parser code and Bright Data Scraper Studio prompts you to update the schema when you save to production.
  </Accordion>

  <Accordion title="What's the difference between collect() and set_lines()?">
    Use `collect()` to append one record at a time; it is the default way to emit data. Use `set_lines()` when you are collecting records progressively and want the most recent snapshot delivered even if a later step throws an error. Every call to `set_lines()` overrides the previous one. See [collect](/products/scraper-studio/functions#collect-append-a-record-to-the-dataset) and [set\_lines](/products/scraper-studio/functions#set-lines-set-output-lines-overriding-previous-calls).
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio functions" icon="code" href="/products/scraper-studio/functions">
    Full reference for interaction and parser commands
  </Card>

  <Card title="Best practices" icon="list-check" href="/products/scraper-studio/best-practices">
    Recommended patterns for fast, reliable scrapers
  </Card>

  <Card title="Scraper Studio IDE interface" icon="display-code" href="/products/scraper-studio/scraper-studio-ide-interface">
    Reference for every panel and control in the IDE
  </Card>

  <Card title="Self-Healing tool" icon="wand-magic-sparkles" href="/products/scraper-studio/self-healing-tool">
    Fix broken scrapers and add fields with plain-language prompts
  </Card>
</CardGroup>


# Scraper Studio error codes
Source: https://docs.brightdata.com/products/scraper-studio/error-codes

Look up Bright Data Scraper Studio error codes, status codes and warnings, with the meaning and suggested fix for each collection failure.

This reference lists the error codes Bright Data Scraper Studio returns when a crawl, parser, request, validation or delivery step fails during a collection run, and the suggested action for each one.

Read the `error_code`, `status_code` and raw `error` message together to understand what failed and what to do next.

<Note>
  These are Scraper Studio collection errors, not API authentication or API request errors. For proxy-layer HTTP errors returned outside Scraper Studio, see the [Error catalog](/proxy-networks/errorCatalog).
</Note>

## How do I read a Scraper Studio error?

Scraper Studio uses five system fields to describe the status of each record.

| Field | Type | What it tells you |
| - | - | - |
| `error_code` | Machine-readable identifier | Why the crawl failed, for example `dead_page`, `bad_input`, `blocked`, `crawl_error`, `parse_error` or `load_sitemap`. Use this field for filtering, automation or retry logic |
| `error` | Human-readable message | The detailed failure reason, for example `Crawler error: Cannot find product title` |
| `status_code` | HTTP-like number | A summary of the crawl result. Optional, see the status code table below |
| `warning` | Human-readable message | A non-fatal issue on a record that was still delivered |
| `warning_code` | Machine-readable identifier | The machine-readable version of `warning`, for example `dead_page` or `validation` |

Branch on `error_code` rather than on the raw `error` string, because the message text changes as scrapers are updated:

```js theme={null}
if (line.error_code === 'dead_page') {
  // Handle expired or removed URL
}
```

### What do the Scraper Studio status codes mean?

`status_code` summarizes the crawl result as an HTTP-like numeric value.

| Status code | Meaning |
| - | - |
| 400 | Bad request or invalid page response |
| 403 | Access blocked or denied by the target site |
| 404 | Page not found, removed or invalid URL |
| 407 | Account is suspended or access is restricted |
| 408 | Request timed out. The target site did not respond in time |
| 421 | Request was routed to the wrong server |
| 429 | Too many requests. Rate limit reached |
| 500 | Crawl, proxy or navigation failed before Scraper Studio received a valid page response |
| 503 | Target site or service is temporarily unavailable, overloaded or timed out |

<Warning>
  `status_code` is sometimes missing or `undefined`, because some error paths do not assign a numeric status code. Treat `status_code` as optional and do not assume it is always present.
</Warning>

## How do errors and warnings differ?

An error means the record failed. A warning means the record was delivered but something should be reviewed.

* **Error:** the record failed and should be treated as unsuccessful. A failed record usually includes `error`, `error_code` and `status_code`
* **Warning:** the record was delivered, but something should be reviewed. A delivered record with a non-fatal issue usually includes `warning`, `warning_code` and `status_code`
* **Successful record:** none of `error`, `error_code`, `warning` or `warning_code` is populated

Warnings occur when a partial crawl returned data but also hit an issue, when a normally failing condition was configured as a non-error, or when output validation found an issue but the record was still kept.

When a `dead_page` error is downgraded to a warning, the output includes:

```text theme={null}
warning_code = dead_page
warning = Dead page detected
```

Schema validation warnings usually use:

```text theme={null}
warning_code = validation
```

The same underlying issue can appear either as an error or as a warning, depending on the scraper logic, validation rules and output schema settings.

## Where do Scraper Studio errors come from?

Scraper Studio errors come from one of three layers.

### What causes scraper errors?

Scraper errors come from the scraper's interaction code, parser code or input handling. Examples include invalid input, `wait_element_timeout`, `parse_error`, `click_timeout`, `dead_page`, `bad_input` and `blocked`.

Fix these by updating the scraper logic, parser selectors, validation rules or input data.

### What causes proxy and unblocker errors?

Proxy and unblocker errors come from Bright Data's proxy, routing or unblocking layer. Examples include proxy connection issues, target website blocking, geo or zone configuration issues, no available peers and rate limiting.

Fix these by retrying, reducing the request rate, changing country or geo settings, or contacting Bright Data support if the issue persists.

### What causes platform and infrastructure errors?

Platform and infrastructure errors come from the Scraper Studio platform, browser worker, parser sandbox, storage layer or internal infrastructure. Examples include worker timeout, browser disconnected, parser memory limit exceeded, upload failure and WebSocket connection issues.

These are often transient and are frequently resolved by retrying. If the issue persists, open a support ticket with the scraper ID, job ID, failed input and raw error message.

## Common scraper error codes

These error codes indicate scraper execution issues. The request may have failed because of invalid input, a missing or changed page element, target blocking, parsing problems, rate limits, CAPTCHA handling or scraper logic that needs to be updated.

| Error code | Meaning | Suggested action |
| - | - | - |
| `dead_page` | The scraper detected that the page does not exist or is no longer relevant. | Check whether the page still opens manually. Remove expired URLs or fix discovery logic that produces stale links. |
| `bad_input` | The scraper marked the input as invalid and skipped retries. This happens when required input fields are missing, the URL is invalid or the page is not the expected type. | Validate inputs before triggering the scraper. Remove invalid URLs or update discovery logic to avoid unsupported page types. |
| `blocked` | The `blocked()` function was used in the scraper code, or the target website refused access to the page. | Retry later, reduce the request rate, or review country, session, CAPTCHA and block-handling logic. |
| `crawl_error` | A general crawl execution error occurred. This happens when the page did not load correctly, required page data was missing, the browser session closed or scraper code tried to read missing data. | Open Debug crawl or Crawl inspector for the failed input. Check page loading, add null checks and rerun failed pages. |
| `wait_element_timeout` | The scraper waited for an element that did not appear in time. | Confirm the selector still exists and is stable. Increase the timeout or handle alternate page layouts if the page loads slowly. |
| `ajax_request_error` | A background request failed or timed out during page execution. | Review network requests in preview or debug mode. If the request is optional, relax validation or add fallback logic. |
| `collector_request_validation` | A custom request validation rule rejected an AJAX or network response, usually from `verify_requests()` logic. | Review the validation callback and confirm the rejected response is required. Relax the rule if the request is optional. |
| `captcha_timeout` | CAPTCHA solving did not complete within the expected time. | Retry the crawl and check whether the target repeatedly shows CAPTCHA. Review CAPTCHA handling and job deadline settings. |
| `close_popup_fail` | Scraper Studio failed to close a popup, such as a consent manager or modal. | Check whether the popup selector changed or appears conditionally. Update popup handling or make the scraper tolerate the popup if it does not block extraction. |
| `click_timeout` | A click action did not complete within the timeout. The element may be missing, hidden, disabled or not clickable. | Confirm the selector matches a visible, clickable element. Add `wait(selector)` before clicking or update the click logic. |
| `tag_response` | A tagged response callback failed, or the tagged response returned an unexpected status or format. | Review the tagged response callback and confirm the expected response exists. Check the browser network tab in the IDE to verify that the response loads correctly, and add checks before reading fields from it. |
| `load_sitemap` | Scraper Studio failed to load or parse a sitemap. Causes include fetch failure, request timeout or invalid sitemap format. | Open the sitemap URL manually and confirm it is reachable and valid. |
| `load_more_timeout` | The scraper waited for more items to load, but no new items appeared before the timeout. | Confirm the "load more" selector and list container still exist. Add a stop condition when no more results are available. |
| `child_input_size_validation` | A child input created by `next_stage()` exceeded the allowed input size. | Reduce the data passed to `next_stage()`. Pass only fields needed by the next stage, such as URL, ID or small metadata values. |
| `detect_block` | Scraper Studio detected block-page content, such as "Access Denied", sign-in walls or other known blocking patterns. | Open the failed page manually and confirm whether it shows a block page. If many inputs fail, reduce the request rate or review location and session behavior. |
| `ERR_INVALID_URL` | A URL value is invalid or not in a supported format. | Validate input URLs before triggering the scraper. Make sure URLs include `http://` or `https://` and do not contain malformed characters. |
| `bad_cmd_arg` | An argument passed to an IDE command is invalid or failed validation. This happens when a command receives a value in the wrong format, a value whose type does not match the expected schema, or is missing a required field. For example, a command that expects a number receives text. | Check the arguments passed to the failing command and correct the format, type or missing field. This code is also fixable by [Auto Self-Healing](/products/scraper-studio/auto-self-healing), which can adjust the generated code or command parameters so they pass validation. |
| `not_supported_cmd` | The scraper used a function that is not supported by the selected worker type. | Change the worker type or replace the function. Use a Browser worker for browser-only actions such as click, scroll, type and wait. See [Worker types](/products/scraper-studio/worker-types). |
| `detached_element` | The scraper referenced an element that was removed or re-rendered before the action completed. | Re-select the element immediately before interacting with it. Add waits after page updates and avoid storing element handles across DOM changes. |
| `timeout` | The scraper timed out while waiting for an element, request, response or page action to complete. | Confirm that the expected element or response exists. Increase the timeout only when needed and add fallback logic for optional or slow-loading content. |

### How do `block` and `blocked` differ?

`block` and `blocked` are different error codes. `blocked` is raised by scraper logic, while `block` is raised by the layer that fetched the page.

`blocked` is usually raised by scraper logic. The scraper calls `blocked()` when it detects a blocked page, login wall, CAPTCHA page or other condition that should mark the crawl as blocked:

```js theme={null}
blocked('Login page was shown');
```

`block` usually comes from navigation, request rejection, target-site blocking or proxy-level response handling. It may include the real HTTP status returned by the target site or upstream layer. Observed status codes for `block` are:

```text theme={null}
400, 401, 403, 404, 405, 409, 410, 418, 429, 500, 503
```

In short:

* `blocked` is collector-level block detection, usually raised by scraper logic
* `block` is target, proxy or navigation-level rejection, often with an HTTP status

## Navigation and browser error codes

These error codes indicate navigation or browser loading issues. The scraper may have failed because the page did not load in time, the browser could not reach the URL, the target kept network requests open, or the connection timed out or closed before completion.

| Error code | Meaning | Suggested action |
| - | - | - |
| `bad_navigate` | The browser failed to navigate to the requested URL. | Open the URL manually and check whether it redirects or blocks access. Retry the crawl if the failure is temporary. |
| `navigation_timeout` | The page did not finish navigation within the allowed time. | Increase the navigation timeout only if needed. Prefer `wait(selector)` or a different `wait_until` strategy instead of waiting for full page load. |
| `domcontentloaded_event_timeout` | The browser timed out while waiting for the `DOMContentLoaded` event. The page did not reach the expected load state in time. | If full page load is not required, use `navigate(input.url, { wait_until: 'navigate' })` and then `wait(selector)` for the element you need. |
| `networkidle_event_timeout` | The browser timed out while waiting for network activity to become idle. Some pages never reach network idle because they keep background requests open. | Avoid relying on full network idle for pages with continuous background traffic. Use `wait_until: 'navigate'` and wait for a specific selector instead. |
| `load_event_timeout` | The page did not fire the full `load` event in time. | Avoid waiting for full page load if it is not required. Use selector-based waits for the content needed by the parser. |
| `document_load_failed` | The browser started navigation, but the main document failed to load. Causes include an HTTP failure, SSL/TLS issue, empty response, missing credentials, redirect issue or proxy and peer problem. | Retry and verify the target URL opens in a browser. If the failure persists, try a different geo or open a support ticket with the job ID and full error. |
| `net_err_timed_out` | The network request timed out. | Retry and check target stability. Reduce concurrency if the timeout affects many inputs. |
| `net_err_closed` | The target site closed the connection unexpectedly. | Check whether the site is available and retry. If it happens frequently, review blocking or rate behavior. |
| `net_err_cert_date_invalid` | The SSL/TLS certificate presented by the server is not valid for the current date. | Verify that the target URL opens correctly in a browser and that the site certificate is valid. |
| `net_err_http2_protocol_error` | The browser encountered an HTTP/2 protocol error while loading the target page or resource. | Retry the request. If it persists, confirm whether the target site loads normally in a browser. |
| `net_err_cert_authority_invalid` | The target site's SSL/TLS certificate is signed by an untrusted or unknown certificate authority. | Verify that the target URL opens correctly in a browser and that the certificate is trusted. |

### Browser and infrastructure lifecycle errors

These error codes indicate that the browser session, runner or browser-control connection was interrupted during the crawl. They are usually transient platform or browser lifecycle errors.

Common lifecycle error codes are `runner_disconnected`, `network_error`, `cdp_conn_err`, `cdp_cmd_timeout`, `cdp_disconnect`, `bad_browser`, `browser_disconnected` and `ipc_timeout`.

**Suggested action:** retry the job. If the error persists, open a support ticket with the job ID, response IDs, failed input and raw error message.

### Rate limit variants

`global_rate_limit` and `bucket_rate_limit` mean that requests to the target domain are being rate limited. This usually happens when the target site is sensitive to high request volume or too many requests are sent in parallel.

**Suggested action:** retry after a short delay. If the issue repeats, reduce concurrency and queue jobs instead of running many jobs in parallel.

## Job lifecycle error codes

These error codes indicate that the collection did not complete because of runtime, deadline, cancellation or page-volume limits.

| Error code | Meaning | Suggested action |
| - | - | - |
| `job_run_timeout` | The collection or crawl exceeded the allowed runtime. This happens during long waits, slow page actions or CAPTCHA solving. | Optimize scraper logic and check for loops, long waits or repeated CAPTCHA solving. Reduce work per request or increase the deadline if available. |
| `crawl_timeout` | The crawler did not return a result within the internal timeout. | Retry the crawl. Simplify the crawl logic or reduce page complexity if it repeats. |
| `deadline_timeout` | The job reached its configured deadline. | Increase the deadline or reduce work per request. For large workloads, split the job into smaller runs. |
| `too_many_pages` | The job created too many child pages. | Reduce the number of child pages generated per input. Use batch collection for high fan-out jobs. |
| `uncrawled_page` | The page result was requested before the page was crawled, usually because the job deadline was reached. | Increase the deadline or reduce the number of pages created by the scraper. |
| `aborted_page` | The crawl was aborted because the job was canceled. | No action is required if the job was intentionally canceled. Otherwise, rerun the affected inputs. |

## Infrastructure and storage error codes

These error codes indicate platform, worker, storage or delivery issues. The collection may have failed because an internal service was unavailable, a worker was overloaded, the result was too large or delivery to an external destination failed.

| Error code | Meaning | Suggested action |
| - | - | - |
| `infra_error` | An internal infrastructure error occurred. | Retry the request. If the issue persists, contact support with the job or response ID. |
| `page_too_big` | The loaded page exceeded the Scraper Studio page size limit of 16 MB. | Collect less data per page. Avoid storing large HTML blobs or unnecessary fields. |
| `crawl_request_failed` | The crawl runner could not connect to a crawler worker after retries. | Retry the job. Escalate to support if the issue persists. |
| `worker_too_busy` | The crawler worker was overloaded. | Retry later and reduce concurrency. |
| `external_upload_fail` | Uploading a result or media file to an external destination failed. | Verify delivery destination configuration, credentials, permissions and path settings. |
| `failed_media_upload` | Scraper Studio failed to save a media file. | Retry the failed page and confirm the media URL is reachable. If the failure persists, check delivery and storage settings or contact support. |

## Proxy and unblocker error codes

These error codes indicate a routing or connection issue between Scraper Studio and the underlying proxy network. They usually happen when the proxy network cannot establish or maintain a stable connection to the target site.

| Error code | Meaning | Suggested action |
| - | - | - |
| `proxy` | A proxy-layer failure occurred during navigation or request. Possible causes include no peer availability, DNS failure, SSL issues, target rejection, timeout or protection pages. | Retry, switch country if needed and verify the target is accessible. If the failure persists, contact support with the job ID and raw error. |
| `proxy_error` | The proxy layer could not connect to the target website or received an unexpected upstream response. | Retry and verify the target URL. If the issue repeats, try another country or escalate with the job ID and error details. |
| `net_err_tunnel` | The browser could not establish a tunnel connection through the proxy. | Check whether the website is available and retry. Escalate if the issue persists across many inputs. |
| `no_peers` | Scraper Studio failed to establish a connection with a peer. | Retry later or remove restrictive peer settings such as country, location or session constraints. |

## Parser and payload error codes

These error codes indicate parser execution or payload-size issues. The scraper may have failed because parser code encountered invalid or missing data, the payload sent to the parser was too large, or parser execution exceeded memory or CPU limits.

| Error code | Meaning | Suggested action |
| - | - | - |
| `parse_error` | Parser code failed while extracting or processing data. Common causes include syntax errors, blocked or invalid content, missing fields, invalid URLs, or reading properties from `null` or `undefined`. | Run a preview with the failing input and inspect the parser code. Add defensive checks and validate selectors. |
| `parse_request_payload_large` | The payload sent to the parser exceeded the size limit. | Reduce the amount of data sent to the parser. Extract only the required HTML section or response fields. |
| `parse_mem_limit_exceeded` | Parser execution exceeded the memory limit, often because of very large HTML, JSON, arrays or embedded data. | Reduce the parser payload and avoid storing large objects in memory. Extract only the required fields. |
| `parse_cpu_limit_exceeded` | Parser execution exceeded the CPU limit, often because of heavy loops, regex or transformations. | Simplify parser logic and reduce loops over large datasets. Move unnecessary processing out of the parser. |
| `parse_req_error` | The parser request payload exceeded the allowed field size. | Reduce the size of the request or parsed payload. Avoid sending very large fields, files or HTML blocks into parser processing. |

## Access and permissions error codes

These error codes indicate an access or compliance issue. The request was stopped because the target is restricted by Bright Data's compliance safeguards or because account permissions need review.

| Error code | Meaning | Suggested action |
| - | - | - |
| `brul` | The target is restricted by Bright Data compliance. | If access is required, contact `compliance@brightdata.com` and request permission for the blocked resource. |

## How to troubleshoot a failed Scraper Studio collection

Work through these steps in order when a collection run returns errors.

1. Check the `error_code`.
2. Check the `status_code`, if present.
3. Read the raw `error` message.
4. Open the failed URL manually to confirm whether the page exists and is accessible.
5. Use Debug crawl or Crawl inspector to inspect the failed input, crawl stage, children, files, warnings and output records.
6. If the error is parser-related, run a preview and inspect HTML, Output and Last errors.
7. If many inputs fail with the same error, check the request rate, concurrency, blocking, worker type and recent target-site changes.
8. If the issue persists, open a support ticket with the scraper ID, job or response ID, failed input and raw error message.

## FAQs

### Why is `status_code` missing from my failed record?

Some Scraper Studio error paths do not assign a numeric status code, so `status_code` is sometimes missing or `undefined`. Treat the field as optional and branch on `error_code` instead.

### Does a warning mean the record was lost?

No. A warning means the record was delivered but something should be reviewed, such as a partial crawl, a condition configured as a non-error or an output validation issue. Only records with `error` and `error_code` are unsuccessful.

### Which errors should I retry automatically?

Retry transient platform, browser lifecycle, proxy and rate limit errors, such as `infra_error`, `runner_disconnected`, `browser_disconnected`, `worker_too_busy`, `proxy_error`, `global_rate_limit` and `bucket_rate_limit`. Do not retry `bad_input`, `ERR_INVALID_URL` or `dead_page`, because those need an input or discovery-logic fix.


# Scraper Studio FAQs
Source: https://docs.brightdata.com/products/scraper-studio/faqs

FAQs about Bright Data Scraper Studio: scraper types, inputs and outputs, billing, limits, snapshots and reporting issues for custom scraper builds.

This page answers the questions the Bright Data support team hears most often about Scraper Studio. If you need a walkthrough instead of a quick answer, start with [Understanding Scraper Studio](/products/scraper-studio/introduction).

## Frequently asked general questions

<AccordionGroup>
  <Accordion title="What is a Bright Data web scraper?">
    A Bright Data web scraper is an automated script that collects public web data at scale through Bright Data's proxy and unblocking infrastructure. It returns the collected data in a structured format, such as JSON, NDJSON, CSV or XLSX. (Parquet is also supported for selected delivery options.) Results can be delivered to an API endpoint, webhook, cloud storage, Snowflake or SFTP. Bright Data maintains hundreds of pre-built scrapers for popular sites in the [Scrapers Library](https://brightdata.com/products/web-scraper).
  </Accordion>

  <Accordion title="What is Bright Data Scraper Studio?">
    Bright Data Scraper Studio is a cloud-hosted environment for building custom scrapers. It offers two modes: an AI Agent that generates a scraper from a natural-language description, and an IDE where you write JavaScript directly. Both modes run on the same Bright Data proxy and unblocking infrastructure. See [Understanding Scraper Studio](/products/scraper-studio/introduction).
  </Accordion>

  <Accordion title="What is the difference between Scraper Studio and the Scrapers Library?">
    The [Scrapers Library](https://brightdata.com/products/web-scraper) contains pre-built scrapers Bright Data maintains for popular sites such as Amazon, LinkedIn, and Instagram. Bright Data Scraper Studio is the environment you use to build custom scrapers when the site you need is not in the library.
  </Accordion>

  <Accordion title="Can one scraper collect data from multiple websites?">
    Yes. A single scraper can navigate to any URL you pass in as input. If you need different extraction logic per site, use multiple stages (`next_stage()`) or build one scraper per site.
  </Accordion>

  <Accordion title="Can Scraper Studio discover URLs, or only scrape URLs I provide?">
    You do not have to provide every URL. The Bright Data Scraper Studio AI Agent can build different scraper types depending on what input you already have:

    * **PDP**: provide a list of product URLs you already have; get one row per URL.
    * **Discovery**: provide a category or listing URL; get one row per item found on that listing.
    * **Discovery + PDP**: provide a category or listing URL; get full per-product detail for every item.
    * **Search**: provide a keyword and optional country when you do not have URLs.
    * **Sitemap**: provide a domain or `sitemap.xml` URL; get either all URLs found in the sitemap or full per-page detail for every URL.

    Each scraper is scoped to one data shape, so the AI Agent is not a general crawler; do not pass a homepage and ask for "everything." For deeper link discovery across a site, build a multi-stage scraper in the Bright Data Scraper Studio IDE with `next_stage()`, `rerun_stage()` and `load_sitemap()`. See [What can the AI Agent build?](/products/scraper-studio/ai-agent#what-can-the-ai-agent-build) and [Functions](/products/scraper-studio/functions).
  </Accordion>

  <Accordion title="Can Scraper Studio scrape mobile apps?">
    Bright Data Scraper Studio scrapes the web, not native mobile apps. For mobile layouts, the Browser worker can emulate a mobile device with `emulate_device('iPhone X')` so the target site serves its mobile web pages. Native iOS or Android app data is out of scope. See [Functions](/products/scraper-studio/functions).
  </Accordion>
</AccordionGroup>

## Inputs, outputs, and schemas

<AccordionGroup>
  <Accordion title="What is a scraper input?">
    An input is the parameter set Bright Data Scraper Studio passes into the scraper for a single run. Typical inputs are a URL, a search keyword, a product ID or ASIN, a profile handle, or a date range. Multiple inputs can be passed in one job via CSV upload or the API.
  </Accordion>

  <Accordion title="What is a scraper output?">
    The output is the structured data the scraper returns for an input. Bright Data Scraper Studio can deliver output in JSON, NDJSON, CSV, XLSX or Parquet depending on the scraper's delivery preferences and selected delivery option.

    ```text theme={null}
    Note: Parquet is not available for API download, Email, Webhook, or OCI PAR delivery.
    ```
  </Accordion>

  <Accordion title="Why did I receive more records than inputs?">
    One input can generate multiple records. For example, if you submit 5 product listing URLs and each listing page contains 20 products, the scraper returns 100 records from 5 inputs. The statistics page counts records, not inputs.
  </Accordion>

  <Accordion title="What is a search scraper?">
    A search scraper takes a keyword as input instead of a URL. Bright Data Scraper Studio runs a search on the target site and extracts data from the result pages. Use a search scraper when you do not have specific URLs to scrape.
  </Accordion>

  <Accordion title="What is a discovery scraper?">
    A discovery scraper collects data from listing pages such as search results, category pages, or directories. It extracts fields that appear directly on the listing (titles, prices, ratings) and can also collect product URLs or IDs for a follow-up product-page scrape.
  </Accordion>

  <Accordion title="What do I do if I updated the schema of a managed scraper while Bright Data is still working on it?">
    When the input or output schema changes, the scraper must be updated to match. If you trigger the scraper before Bright Data has updated it, you will see an `input(output)_schema_incompatible` error.

    To trigger the scraper anyway and ignore the schema mismatch, click **Trigger anyway** in the UI or add a parameter to your API request:

    * Output schema incompatible: `override_incompatible_schema=1`
    * Input schema incompatible: `override_incompatible_input_schema=1`

    ```bash theme={null}
    curl "https://api.brightdata.com/dca/trigger?scraper=ID_COLLECTOR&queue_next=1&override_incompatible_schema=1" \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer API_KEY" \
      -d '[{"url":"https://targetwebsite.com/product_id/"}]'
    ```
  </Accordion>
</AccordionGroup>

## Building and editing scrapers

<AccordionGroup>
  <Accordion title="How do I start building a scraper?">
    You have three options in Bright Data Scraper Studio:

    * **Build with the AI Agent**: describe the data you want in plain language. See [Scraper Studio AI Agent](/products/scraper-studio/ai-agent).
    * **Build in the IDE**: write JavaScript directly. See [Develop a scraper with the IDE](/products/scraper-studio/develop-a-scraper).
    * **Request a managed scraper**: Bright Data's data team builds and maintains the scraper for you.
  </Accordion>

  <Accordion title="Can I edit the code in the IDE after the AI Agent builds a scraper?">
    Yes. Every scraper, including ones the AI Agent generated, can be opened and edited in the Bright Data Scraper Studio IDE. You can change extraction logic, modify selectors, add or remove output fields, and tune performance. If you prefer not to write code, use the [Self-Healing tool](/products/scraper-studio/self-healing-tool) to request changes in plain language.
  </Accordion>

  <Accordion title="How does the AI Agent build a scraper?">
    Pass the AI Agent a target URL and an optional description of the data you want. The agent asks clarifying questions, generates an output schema for your review, and writes the full scraper code once you approve the schema. You can then run the scraper immediately or schedule recurring runs. See [Scraper Studio AI Agent](/products/scraper-studio/ai-agent) for a full walkthrough.
  </Accordion>

  <Accordion title="Do I own the scraper code, and can I export it?">
    Yes. You own every line of the scraper, including code the AI Agent generates, and you can read and edit it in the Bright Data Scraper Studio IDE. Scrapers are plain JavaScript, so you can copy the code out and keep it in your own repository. To run a scraper outside Bright Data you would need to supply your own proxy and unblocking infrastructure.
  </Accordion>

  <Accordion title="Does Scraper Studio work on JavaScript-heavy or dynamic pages?">
    Yes. Choose the Browser worker for sites that render content with JavaScript; it runs a full headless browser so you can wait for elements, click, scroll and capture background network calls. Choose the Code worker for static HTML and HTTP responses, which is faster and cheaper. See [Worker types](/products/scraper-studio/worker-types).
  </Accordion>
</AccordionGroup>

## Self-Healing

<AccordionGroup>
  <Accordion title="Is Self-Healing automatic, or do I trigger it?">
    You trigger Self-Healing; it does not fire automatically when a target site's DOM changes. You can trigger it three ways:

    * **Control panel**: open the scraper in the Bright Data Scraper Studio IDE, describe the fix in plain language and accept the AI-generated diff. See [Self-Healing tool](/products/scraper-studio/self-healing-tool).
    * **Bright Data CLI**: run `bdata scraper heal <collector_id>` then `bdata scraper approve`. Add `--auto-approve` for unattended workflows. See [Build a scraper with the Bright Data CLI](/products/scraper-studio/build-with-the-cli#how-do-i-fix-a-scraper-when-the-site-changes).
    * **Bright Data API**: call `POST /dca/collectors/{collector_id}/refactor_template`. See [Trigger Self-Healing](/api-reference/scraper-studio-api/ai-flow/trigger-self-healing).

    Each path repairs the code you own and keeps the same Collector ID. The refactor runs on Bright Data infrastructure, not on your machines, and can take up to 15 minutes; Bright Data emails you when the diff is ready.
  </Accordion>
</AccordionGroup>

## Running and triggering scrapers

<AccordionGroup>
  <Accordion title="What are the options for triggering a scraper run?">
    Bright Data Scraper Studio supports three trigger methods:

    * **By API**: regular request, queue request, or replace request
    * **Manually**: from the control panel
    * **On a schedule**: hourly, daily, weekly, or custom

    See [Initiate collection and delivery](/products/scraper-studio/initiate-collection-and-delivery-options).
  </Accordion>

  <Accordion title="What is a queued API request?">
    A queued request tells Bright Data Scraper Studio to wait until the previous request for the same scraper finishes before starting the next one. Use it when you want serial execution instead of running multiple jobs in parallel.
  </Accordion>

  <Accordion title="What is the parallel job limit?">
    Bright Data Scraper Studio runs up to **100 batch jobs in parallel** per scraper. Additional jobs queue automatically and start as capacity frees up. See [Scraper Studio specifications](/products/scraper-studio/specifications) for full limits.
  </Accordion>

  <Accordion title="How do I debug a real-time scraper?">
    In the Bright Data Scraper Studio dashboard, click the **Bug** icon under **Failed crawls** to open the scraper in the IDE. Failed inputs appear in the **Last errors** tab with the exact error message and error code. Bright Data stores the last 1,000 errors per virtual job so you can re-run failed inputs and diagnose the issue.
  </Accordion>
</AccordionGroup>

## Blocking and unblocking

<AccordionGroup>
  <Accordion title="How does Scraper Studio handle blocking and CAPTCHAs?">
    Bright Data Scraper Studio runs every scraper on Bright Data's proxy and unblocking network, with automatic retries and real-user fingerprinting built in. The IDE provides `solve_captcha()` to solve CAPTCHAs, `detect_block()` and `blocked()` to detect and report blocks, and `country()` to route a request through a specific country when a site is geo-restricted. See [Functions](/products/scraper-studio/functions).
  </Accordion>
</AccordionGroup>

## Billing and limits

<AccordionGroup>
  <Accordion title="What is a CPM in Scraper Studio billing?">
    CPM stands for "cost per mille", meaning 1,000 page loads. Bright Data Scraper Studio bills page loads in CPM units. Current rates are on the [pricing page](https://brightdata.com/pricing/web-scraper/studio).
  </Accordion>

  <Accordion title="Which operations count as a billable event?">
    A billable event is any function that causes Bright Data Scraper Studio to load a page or perform a network request:

    * `navigate()`
    * `request()`
    * `load_more()`
    * Media file download (billed per GB, separate from CPM)
  </Accordion>

  <Accordion title="Does Scraper Studio have its own free trial allotment?">
    Scraper Studio does not have a separate page-load or record allotment, but it is covered by the account-level free tier. Every new account gets 5,000 free credits per month, a single shared pool usable across the Web Unlocker API, SERP API, Web Scraper API, Scraper Studio and Browser API. In the free tier, Scraper Studio consumes one credit per page load drawn from that pool; records are not billed by default. New accounts also get a one-time onboarding bonus credit usable on any Bright Data product. See the [free tier](/general/account/billing-and-pricing/free-tier) and [billing](/general/account/billing-and-pricing/billing) pages.
  </Accordion>
</AccordionGroup>

## Snapshots and data retention

<AccordionGroup>
  <Accordion title="How long are snapshots available after a collection?">
    Snapshot retention depends on the collection type:

    * **Batch collections**: 16 days
    * **Real-time collections**: 7 days

    After that, snapshots are permanently deleted. Bright Data does not recover expired data. Download or export your data before the retention window closes, or configure the scraper to deliver results automatically via webhook, API download, or cloud storage.
  </Accordion>
</AccordionGroup>

## How to report issues

<AccordionGroup>
  <Accordion title="How do I report an issue with a scraper?">
    Open the scraper in the Bright Data Scraper Studio control panel and select **Report an issue** from the three-dots menu. Bright Data routes the ticket to a different team based on the issue type:

    * **Data** (missing fields, missing records, parsing errors): routed to the scraper engineer. Available only for managed scrapers.
    * **Collection and delivery** (incomplete delivery, slow scraper): routed to the support team.
    * **Other** (UI issue, product question): routed to the account manager.

    Include the affected job ID, a description of the problem, and a screenshot or file if it helps show the issue.
  </Accordion>

  <Accordion title="What information should I include in a bug report?">
    Include:

    * The issue category (wrong data, missing records, delivery problem, IDE issue, other)
    * A description of the exact problem
    * The affected job ID
    * A screenshot or file that shows the issue, if possible

    Bright Data opens a ticket automatically and the R\&D team handles it.
  </Accordion>

  <Accordion title="How do I know Bright Data is working on a managed-scraper request?">
    You receive an email when a Bright Data engineer starts building the scraper and another email when it is ready. You can also track the status on the Scrapers dashboard.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Understanding Scraper Studio" icon="book-open" href="/products/scraper-studio/introduction">
    How Bright Data Scraper Studio works and when to use it
  </Card>

  <Card title="Specifications" icon="file-lines" href="/products/scraper-studio/specifications">
    Infrastructure limits, billing, and data retention
  </Card>
</CardGroup>


# Scraper Studio dashboard features
Source: https://docs.brightdata.com/products/scraper-studio/features

Reference for the Bright Data Scraper Studio dashboard: scraper types, statuses, run statistics columns and how to download collected data.

The Bright Data Scraper Studio dashboard is where every scraper lives. Use it to inspect scraper properties, trigger runs, configure delivery, manage versions and review collection results and statistics. This page is a reference for the controls on the **My Scrapers** page and the Runs tab.

## The Scrapers dashboard

Every scraper you use, whether generated by the AI Agent, built in the Bright Data Scraper Studio IDE, or built by Bright Data teams, appears under **My Scrapers** on the Scrapers dashboard.

<Note>
  The **My Scrapers** page lists every scraper type, not only Scraper Studio scrapers.
</Note>

### Which scraper types appear on the dashboard?

The **My Scrapers** page lists three scraper types, distinguished by who builds and maintains each scraper.

| Type | Description |
| - | - |
| **Scraper API** | 700+ pre-built scrapers, built and maintained by Bright Data |
| **Scraper Studio** | Scrapers built and maintained by customers or AI |
| **Scraper Studio Managed** | Scrapers built and maintained by the Bright Data team |

### What does each scraper status mean?

Each scraper and run carries a status that shows where it is in the build and collection lifecycle.

| Status | Description |
| - | - |
| **Ready** | The run has been completed |
| **Canceled** | The run was canceled by the customer or system |
| **Active** | The scraper is saved to production and ready to initiate, but has not been triggered yet |
| **Draft** | The scraper is still being built and is not yet saved to production |
| **Running** | The collection is running |

To open a specific scraper's dashboard, click the scraper.

## What does the collection Runs page show?

The Runs page shows per-collection metrics for every run of a scraper.

<img alt="Statistics action menu" />

<img alt="Collector runs" />

| Column | Description |
| - | - |
| **ID** | Unique identifier for the collection job |
| **Trigger** | Who triggered the job and how (API, UI, or schedule) |
| **Template** | Template version number |
| **Inputs** | Number of inputs submitted to the collection |
| **Records** | Number of records the scraper returned |
| **Failed crawls** | Number of pages that failed to crawl |
| **Fulfillment** | Total number of unique pages discovered during scraping, including pages that were found but not necessarily scraped |
| **Success rate** | Percentage of inputs that produced successful records |
| **Queued at** | Timestamp when the job entered the queue |
| **Started at** | Timestamp when the scraper started collecting |
| **Finished at** | Timestamp when the scraper finished collecting |
| **Job time** | Total job duration |
| **Estimated time left** | Time remaining for an in-progress job |
| **Queue** | Name of the queue the job is running in (from the trigger's queue name) |
| **Page Loads** | Total page loads consumed by the job |
| **Spent** | Total amount spent on this collection run |

## Collection run actions

The three-dot **Actions** menu includes the following options. Available actions may vary depending on the run status and delivery configuration.

<img alt="Three dots menu on a job row" />

### **Redeliver results**

Use **Redeliver results** to send collected results again to the configured delivery destination.

You can choose:

* **Dataset only**, redelivers only the structured output data.
* **Dataset + media**, redelivers the structured output data together with collected media files, such as images, videos, PDFs, or documents.

Use this when the original delivery failed, the destination was unavailable, or you updated the destination and want to send the same results again.

### **Rerun or cancel a collection**

Use **Rerun job** to start a new run from an existing collection.

You can choose:

* **Rerun all from beginning**, starts a new run using all original input values.
* **Rerun failed pages**, starts a new run only for pages that failed in the selected collection.

Use **Cancel collection** to stop an active collection before it finishes. Data already collected may still be available, depending on the run status and delivery settings.

### **Inspect results and errors**

Use **Quick view** to preview up to 100 collection records in JSON format directly in the control panel.

Use **Errors** to review failed inputs and error details.

Use **Activity** to monitor a collection run over time. The page shows run status, start and finish times, success rate, crawl count, and performance charts. You can change the visible time range, such as **5 min**, **1 h**, **1 d**, or **all**.

The Activity page includes:

* **Run rate** - shows how many pages were crawled, failed, or retried at each point in time, along with the success rate.
* **Pages** - shows discovered pages, open pages, retriable pages, and pages currently being crawled.
* **Inputs** - shows how many input rows were submitted and prepared for crawling.
* **Crawl rate** - shows the system-calculated maximum number of allowed workers and the actual number of workers assigned to the run.
* **Crawl time per page** -  shows the average time spent crawling each page.

Use **Activity** to investigate slow runs, error spikes, retries, or changes in crawl performance.

### **Debug crawl**

Use **Debug crawl** to investigate failed or unexpected scraper behavior.

## How do I download the data from the dashboard?

Click the **Download file options** button, select a file format, and the download starts immediately.

<Note>
  Real-time job outputs are stored on Bright Data's side but cannot be downloaded from the dashboard. To retrieve them, use the Scraper Studio API or send them to one of the delivery destinations configured in your delivery options.
</Note>

## How do I trigger a scraper and get results?

To trigger a scraper, use the three initiation options documented on [Initiate collection and delivery](/products/scraper-studio/initiate-collection-and-delivery-options):

* [Initiate by API](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run)
* [Initiate manually](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run)
* [Schedule a scraper](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-trigger-a-scraper-run)

To retrieve results, open the scraper from My scrapers and select **Runs** tab. This opens the collection statistics page, where you can download the data.

## Related

<CardGroup>
  <Card title="Initiate collection and delivery" icon="truck" href="/products/scraper-studio/initiate-collection-and-delivery-options">
    Configure trigger methods, file formats and delivery destinations
  </Card>

  <Card title="Scraper Studio IDE interface" icon="display-code" href="/products/scraper-studio/scraper-studio-ide-interface">
    Reference for every panel and control in the IDE
  </Card>
</CardGroup>


# Scraper Studio functions reference
Source: https://docs.brightdata.com/products/scraper-studio/functions

Reference for Bright Data Scraper Studio interaction and parser functions: navigation, waits, selectors and parser helpers with parameters and 30+ examples.

This reference documents every function available in Bright Data Scraper Studio's IDE: the interaction code that controls a browser session, and the parser code that turns HTML into structured records. Each function lists its parameters, return value, and a runnable example.

<Note>
  Functions marked with **⭐** work only with the Browser worker and throw an error when called from a Code worker. See [Browser-only functions](#browser-only-functions) for the full list.
</Note>

## How is Scraper Studio code organized?

A Bright Data Scraper Studio scraper uses two code types:

| Code type | Role | Language and libraries |
| - | - | - |
| Interaction code | Navigates the target site: URL requests, clicks, scrolls, waits, and background traffic capture | JavaScript + Bright Data browser commands |
| Parser code | Extracts and structures data from the HTML returned by interaction code | JavaScript + Cheerio (`$`) |

You move data from one to the other with `parse()` (which runs the parser) and `collect()` (which appends a record to the final dataset).

## Interaction functions

Interaction functions run in the scraper's main JavaScript context and drive the browser or HTTP client. Use them to navigate, wait for elements, interact with the page, capture network traffic, and hand off data to the parser.

### Global objects

| Name | Type | Description |
| - | - | - |
| `input` | object | Input for the current stage, set by the trigger or by a previous `next_stage()`/`run_stage()`/`rerun_stage()` call. |
| `job` | object | Metadata about the current job (for example `job.created`, the job start timestamp). |
| `location` | object | Info about the current browser location. Field: `href`. |
| `parser` | object | Values captured by `tag_response`, `tag_script`, and related tagging functions, available after `wait_for_parser_value()`. |

```js theme={null}
navigate(input.url);
let {created} = job;
console.log('current url', location.href);
```

### Navigation

#### `navigate`, Load a URL in the browser

Navigates the browser to a URL. A 404 status throws a `dead_page` error by default; override with `allow_status`.

**Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `url` | string or URL | Yes | None | Target URL |
| `opt.wait_until` | string | No | `load` | `load`, `domcontentloaded`, `networkidle0`, or `networkidle2` |
| `opt.timeout` | number | No | `30000` | Navigation timeout in milliseconds |
| `opt.referer` | string | No | None | `Referer` header to send |
| `opt.allow_status` | number\[] | No | `[]` | HTTP status codes to accept without throwing |
| `opt.fingerprint` | object | No | None | Override browser fingerprint (`screen.width`, `screen.height`) |
| `opt.sniff_mime` | boolean | No | `false` | Detect the MIME type and store it as `sniffed_mime`. On code workers, only `text/html` and `application/pdf` are detected |

```js theme={null}
navigate(input.url);
navigate('https://example.com');
navigate('https://example.com', {wait_until: 'domcontentloaded'});
navigate('https://example.com', {referer: 'https://google.com'});
navigate('https://example.com', {timeout: 45000});
navigate('https://example.com', {allow_status: [404]});
navigate('https://example.com', {
  fingerprint: {screen: {width: 400, height: 400}},
});
navigate('https://example.com', {sniff_mime: true});
```

#### `request`, Make a direct HTTP request

Sends an HTTP request without using a browser. Use on Code worker, or on Browser worker when you want to bypass the browser.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` \| `options` | string or object | Yes | URL string, or an object with `url`, `method`, `headers`, `body` |

```js theme={null}
let res = request('https://www.example.com');
let res = request({
  url: 'https://www.example.com',
  method: 'POST',
  headers: {'Content-type': 'application/json'},
  body: {hello: 'world'},
});
```

#### `next_stage`, Queue input for the next stage

Runs the next stage of the scraper in a new browser session with the given input.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `input` | object | Yes | Input object passed to the next stage |

```js theme={null}
next_stage({url: 'https://example.com', page: 1});
```

#### `run_stage`, Run a specific stage

Runs a named stage of the scraper in a new browser session.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `stage` | number | Yes | Stage index (starts at 1) |
| `input` | object | Yes | Input object passed to that stage |

```js theme={null}
run_stage(2, {url: 'https://example.com', page: 1});
```

#### `rerun_stage`, Re-run the current stage with new input

Runs this stage again with a new input. Use it to fan out work (for example, one re-run per page in a pagination).

```js theme={null}
rerun_stage({url: 'https://example.com/other-page'});
```

#### `load_sitemap`, Read URLs from an XML sitemap

Loads a sitemap XML file and returns the URL list. Supports sitemap indexes and gzip-compressed sitemaps.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `options.url` | string | Yes | Sitemap URL |

```js theme={null}
let {pages} = load_sitemap({url: 'https://example.com/sitemap.xml.gz'});
let {children} = load_sitemap({url: 'https://example.com/sitemap-index.xml'});
```

#### `resolve_url`, Follow a URL through redirects

Returns the final URL that the given URL argument leads to.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | string or URL | Yes | URL to resolve |

```js theme={null}
let {href} = parse().anchor_elem_data;
collect({final_url: resolve_url(href)});
```

#### `redirect_history`, Get the redirect chain

Returns the history of URL redirects since the last `navigate()` call.

```js theme={null}
navigate('http://google.com');
let redirects = redirect_history();
// ['http://google.com', 'http://www.google.com', 'https://www.google.com/']
```

#### `response_headers`, Read the last response headers

Returns the response headers from the last page load.

```js theme={null}
let headers = response_headers();
console.log('content-type', headers['content-type']);
```

#### `status_code`, Read the last response status

Returns the HTTP status code of the last page load.

```js theme={null}
collect({status_code: status_code()});
```

### Waiting on the page ⭐

All wait functions are Browser worker only.

#### ⭐ `wait`, Wait for an element to appear

**Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `selector` | string | Yes | None | CSS selector to wait for |
| `opt.timeout` | number | No | `30000` | Timeout in milliseconds |
| `opt.hidden` | boolean | No | `false` | Wait for the element to be hidden instead of visible |
| `opt.inside` | string | No | None | Selector of an iframe to look inside |

```js theme={null}
wait('#welcome-splash');
wait('.search-results .product');
wait('[href^="/product"]');
wait('#welcome-splash', {timeout: 5000});
wait('#welcome-splash', {hidden: true});
wait('#welcome-splash', {inside: '#iframe_id'});
```

#### ⭐ `wait_any`, Wait for any of several conditions

Waits for any matching condition to succeed. Returns when the first selector resolves.

```js theme={null}
wait_any(['#title', '#notfound']);
```

#### ⭐ `wait_visible`, Wait for an element to be visible

**Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `selector` | string | Yes | None | CSS selector |
| `opt.timeout` | number | No | `30000` | Timeout in milliseconds |

```js theme={null}
wait_visible('#welcome-splash');
wait_visible('#welcome-splash', {timeout: 5000});
```

#### ⭐ `wait_hidden`, Wait for an element to disappear

**Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `selector` | string | Yes | None | CSS selector |
| `opt.timeout` | number | No | `30000` | Timeout in milliseconds |

```js theme={null}
wait_hidden('#welcome-splash');
wait_hidden('#welcome-splash', {timeout: 5000});
```

#### ⭐ `wait_for_text`, Wait for text content

Waits for an element on the page to contain the given text.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `selector` | string | Yes | CSS selector |
| `text` | string | Yes | Text to wait for |

```js theme={null}
wait_for_text('.location', 'New York');
```

#### `wait_for_parser_value`, Wait for a parser field to be populated

Use after `tag_response()` or `tag_script()` to wait until the captured data is available.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `field` | string | Yes | Parser field path to wait on |
| `validate_fn` | function | No | Optional callback returning `true` when the value is valid |
| `opt.timeout` | number | No | Timeout in milliseconds |

```js theme={null}
wait_for_parser_value('profile');
wait_for_parser_value('listings.0.price', v => parseInt(v) > 0, {timeout: 5000});
```

#### ⭐ `wait_network_idle`, Wait until the browser network settles

Waits until the browser network has been idle for a given period.

**Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `opt.timeout` | number | No | `500` | Milliseconds of idleness required |
| `opt.ignore` | array | No | `[]` | Patterns (string or RegExp) for requests to exclude |

```js theme={null}
wait_network_idle();
wait_network_idle({
  timeout: 1e3,
  ignore: [/long_request/, 'https://example.com'],
});
```

#### ⭐ `wait_page_idle`, Wait until DOM mutations stop

Waits until no changes are made to the DOM tree for a given period.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `opt.idle_timeout` | number | No | Milliseconds of stability required |
| `opt.ignore` | array | No | Selectors to exclude from mutation monitoring |

```js theme={null}
wait_page_idle();
wait_page_idle({
  ignore: ['.live-clock', '.carousel'],
  idle_timeout: 1000,
});
```

### Element interaction ⭐

All interaction functions require Browser worker.

#### ⭐ `click`, Click an element

Clicks an element, waiting for it to appear first.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `selector` | string or array | Yes | CSS selector or Shadow DOM selector path |
| `opt.coordinates` | `{x, y}` | No | Click the closest match to given page coordinates |

```js theme={null}
click('#show-more');
$('#show-more').click();

// Click the map pin closest to the center of a map
let box = bounding_box('#map');
let center = {x: (box.left + box.right) / 2, y: (box.top + box.bottom) / 2};
click('.map-pin', {coordinates: center});
```

#### ⭐ `right_click`, Right-click an element

Same as `click` but uses the right mouse button.

```js theme={null}
right_click('#item');
```

#### ⭐ `hover`, Hover over an element

Moves the cursor over an element, waiting for it to appear first.

```js theme={null}
hover('#item');
```

#### ⭐ `mouse_to`, Move the cursor to a coordinate

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `x` | number | Yes | Target X position |
| `y` | number | Yes | Target Y position |

```js theme={null}
mouse_to(0, 0);
```

#### ⭐ `type`, Enter text into an input

Waits for the input to appear, then types the given text.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `selector` | string | Yes | CSS selector |
| `text` | string or array | Yes | Text to type, or an array of strings and special keys |
| `opt.replace` | boolean | No | Clear existing text before typing |

```js theme={null}
type('#location', 'New York');
type('#location', 'New York', {replace: true});
type('[id$=input-box]', 'search term');
type('#search', ['Some text', 'Enter']);
type('#search', ['Backspace']);
```

#### ⭐ `press_key`, Press a special key

Types special keys like Enter or Backspace in the currently focused input.

```js theme={null}
press_key('Enter');
press_key('Backspace');
```

#### ⭐ `select`, Pick a value from a select element

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `selector` | string | Yes | CSS selector of a `<select>` element |
| `value` | string | Yes | Option value or visible text |

```js theme={null}
select('#country', 'Canada');
```

#### ⭐ `scroll_to`, Scroll an element into view

Scrolls the page so a target element is visible. Defaults to natural scrolling; pass `immediate: true` to jump.

```js theme={null}
scroll_to('.author-profile');
scroll_to('top');
scroll_to('bottom');
scroll_to('top', {immediate: true});
```

#### ⭐ `scroll_to_all`, Scroll through every matching element

```js theme={null}
scroll_to_all('.author-profiles');
```

#### ⭐ `load_more`, Trigger lazy-loaded content

Scrolls to the bottom of a list to trigger infinite-scroll loading.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `selector` | string | Yes | Container element holding the lazy-loaded items |
| `opt.children` | string | No | Selector for the individual items |
| `opt.trigger_selector` | string | No | Selector for an explicit "load more" button |
| `opt.timeout` | number | No | Timeout in milliseconds |

```js theme={null}
load_more('.search-results');
load_more('.search-results', {
  children: '.result-item',
  trigger_selector: '.btn-load-more',
  timeout: 10000,
});
```

#### ⭐ `close_popup`, Auto-close popups in the background

Registers a background watcher that closes a popup whenever it appears. See [Best practices](/products/scraper-studio/best-practices) for the recommended pattern.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `popup_selector` | string | Yes | Selector for the popup container |
| `close_selector` | string | Yes | Selector for the element that closes it |
| `opt.click_inside` | string | No | Parent iframe selector, if the close button is inside an iframe |

```js theme={null}
close_popup('.popup', '.popup_close');
close_popup('iframe.with-popup', '.popup_close', {click_inside: 'iframe.with-popup'});
```

#### ⭐ `solve_captcha`, Solve CAPTCHAs on the page

```js theme={null}
solve_captcha();
solve_captcha({type: 'simple', selector: '#image', input: '#input'});
```

#### ⭐ `bounding_box`, Get an element's page coordinates

Returns the page-relative bounding box of the first matched element.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `selector` | string | Yes | CSS selector |

```js theme={null}
let box = bounding_box('.product-list');
// box == {top, right, bottom, left, x, y, width, height}
```

#### `el_exists`, Check if an element is on the page

**Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `selector` | string | Yes | None | CSS selector |
| `timeout` | number | No | `0` | Wait up to N milliseconds for the element |

```js theme={null}
el_exists('#example');            // true
el_exists('.does_not_exist');     // false
el_exists('.does_not_exist', 5e3); // false after 5 seconds
```

#### `el_is_visible`, Check if an element is visible

**Parameters**

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `selector` | string | Yes | None | CSS selector |
| `timeout` | number | No | `0` | Wait up to N milliseconds for visibility |

```js theme={null}
el_is_visible('#example');
el_is_visible('.is_not_visible', 5e3);
```

#### ⭐ `track_event_listeners`, Start tracking browser event listeners

Must be called before `disable_event_listeners()`.

```js theme={null}
track_event_listeners();
```

#### ⭐ `disable_event_listeners`, Disable event listeners

Stops all event listeners from running on the page.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `event_types` | string\[] | No | Specific event types to disable |

```js theme={null}
disable_event_listeners();
disable_event_listeners(['hover', 'click']);
```

#### ⭐ `freeze_page`, Stop further page changes

Forces the page to stop changing, so HTML snapshots reflect exactly what the scraper saw. Experimental.

```js theme={null}
freeze_page();
```

### Network and response tagging ⭐

Tagging captures background network traffic and exposes it to the parser. All `tag_*` functions are Browser worker only.

#### ⭐ `tag_response`, Save one matching response

Saves the response data from a matching browser request.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `field` | string | Yes | Name of the parser field to populate |
| `pattern` | RegExp or function | Yes | URL pattern or match function |
| `opt.jsonp` | boolean | No | Parse JSONP response bodies (auto-detected when possible) |
| `opt.allow_error` | boolean | No | Capture responses with non-2xx status codes |

```js theme={null}
tag_response('resp', /url/, {jsonp: true});
tag_response('resp', /url/, {allow_error: true});

tag_response('resp', (req, res) => {
  if (req.url.includes('/api/')) {
    return {
      request_body: req.body,
      request_headers: req.headers,
      response_body: res.body,
      response_headers: res.headers,
    };
  }
});

tag_response('teams', /\/api\/teams/);
navigate('https://example.com/sports');
let teams = parse().teams;
for (let team of teams)
  collect(team);
```

#### ⭐ `tag_all_responses`, Save every matching response

Saves the response data from every matching request as an array.

```js theme={null}
tag_all_responses('profiles', /\/api\/profile/);
navigate('https://example.com/sports');
let profiles = parse().profiles;
for (let profile of profiles)
  collect(profile);
```

#### ⭐ `tag_script`, Extract JSON embedded in a `<script>` tag

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `field` | string | Yes | Parser field name |
| `selector` | string | Yes | Script tag selector |

```js theme={null}
tag_script('ssr_state', '#__SSR_DATA__');
navigate('https://example.com/');
collect(parse().ssr_state);
```

#### ⭐ `tag_window_field`, Tag a value on the browser `window`

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `field` | string | Yes | Parser field name |
| `key` | string | Yes | `window` property to read |

```js theme={null}
tag_window_field('initData', '__INIT_DATA__');
```

#### ⭐ `tag_image`, Capture an image URL from a DOM element

```js theme={null}
tag_image('image', '#product-image');
```

#### ⭐ `tag_video`, Capture a video URL from a DOM element

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `field` | string | Yes | Parser field name |
| `selector` | string | Yes | Element selector |
| `opt.download` | boolean | No | Download the video file |

```js theme={null}
tag_video('video', '#product-video', {download: true});
```

#### ⭐ `tag_html`, Save the HTML of the current page

**Parameters**

| Parameter | Type | Required | Description |
| :- | :- | :- | :- |
| `name` | string | Yes | Name of the tagged field. Must be alphanumeric. |

The tagged value can be accessed:

* In interaction code with `wait_for_parser_value('field_name')`
* In parser code with `parser.field_name` or `parser['field_name']`

Scraper Studio also adds the page URL with the `_url` suffix. For example, if the field name is `html`, the page URL is available as `parser.html_url`.

```js theme={null}
tag_html('html');
tag_html('html', { iframe: true });
tag_html('html', {as_doc: true});
tag_html('html', {load_stylesheets: true});
tag_html('html', {shadow: false});
```

#### ⭐ `tag_screenshot`, Save a screenshot of the page

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `field` | string | Yes | Parser field name |
| `opt.filename` | string | No | Output filename |
| `opt.full_page` | boolean | No | Defaults to `true` |

```js theme={null}
tag_screenshot('html_screenshot', {filename: 'screen'});
tag_screenshot('view', {full_page: false});
```

#### ⭐ `tag_serp`, Parse the page as a search engine result page

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `field` | string | Yes | Parser field name |
| `type` | string | Yes | Parser type: `google`, `bing`, etc. |

```js theme={null}
tag_serp('serp_bing_results', 'bing');
tag_serp('serp_google_results', 'google');
```

#### ⭐ `capture_graphql`, Capture and replay GraphQL queries

Captures a GraphQL request so you can replay it with different variables.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `options.payload` | object | Yes | Key-value pairs that match the target request payload |
| `options.url` | RegExp | No | URL pattern for the GraphQL endpoint (defaults to `/graphql/`) |

```js theme={null}
let q = capture_graphql({
  payload: {id: 'ProfileQuery'},
});
navigate('https://example.com');

let [first_query, first_response] = q.wait_captured();
collect(first_response.data.profile);

let second = q.replay({
  variables: {other_id: 2},
});
collect(second.data.profile);
```

### Data collection

#### `parse`, Run the parser code

Runs the parser code and returns the structured result.

```js theme={null}
let page_data = parse();
collect({
  title: page_data.title,
  price: page_data.price,
});
```

#### `collect`, Append a record to the dataset

Adds one record to the scraper's output.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `data_line` | object | Yes | Fields to collect |
| `validate_fn` | function | No | Callback that throws on invalid data |

```js theme={null}
collect({price: data.price});
collect(product, p => {
  if (!p.title)
    throw new Error('Product is missing a title');
});
```

#### `set_lines`, Set output lines, overriding previous calls

Each call to `set_lines()` overrides the previous one. Useful when the scraper collects partial data and you want the last known state delivered if a later step throws.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `lines` | object\[] | Yes | Array of records |
| `validate_fn` | function | No | Validation callback, run once per line |

```js theme={null}
set_lines(products_so_far);
set_lines(products_so_far, p => {
  if (!p.price)
    throw new Error('Missing price');
});
```

#### `html`, Get the HTML of the current page

Use `html()` when you need to read, inspect, or collect the current page HTML from interaction code.

```js theme={null}
html();
html({iframe: true});
html({iframe: true, order: 'bfs'});
```

#### `load_html`, Load an HTML string into Cheerio

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `html` | string | Yes | HTML to parse |

```js theme={null}
let $$ = load_html('<p id="p1">p1</p><p id="p2">p2</p>');
collect({data: $$('#p2').text()});
```

### Marking a crawl as a failure

#### `bad_input`, Mark the input as invalid

Prevents any retries and reports `error_code=bad_input`.

```js theme={null}
bad_input();
bad_input('Missing search term');
```

#### `blocked`, Mark the page as blocked

Reports that the site refused access. `error_code=blocked`.

```js theme={null}
blocked();
blocked('Login page was shown');
```

#### `dead_page`, Mark a URL as a dead link

Flags the page so it can be filtered from future collections. `error_code=dead_page`.

```js theme={null}
dead_page();
dead_page('Product was removed');
```

#### ⭐ `detect_block`, Detect blocking conditions on the page

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `resource.selector` | string | Yes | Element to check |
| `condition.exists` | boolean | No | Fail if the element exists |
| `condition.has_text` | string or RegExp | No | Fail if the element contains matching text |

```js theme={null}
detect_block({selector: '.foo'}, {exists: true});
detect_block({selector: '.bar'}, {has_text: 'text'});
detect_block({selector: '.baz'}, {has_text: /regex_pattern/});
```

### Session and routing

#### `country`, Route through a specific country

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `code` | string | Yes | Two-character ISO country code |

```js theme={null}
country('us');
```

#### ⭐ `proxy_location`, Fine-grained proxy location

Prefer `country()` unless you need precise geographic control.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `configuration.country` | string | No | Two-character ISO country code |
| `configuration.lat` | number | No | Latitude, range `[-85, 85]` |
| `configuration.long` | number | No | Longitude, range `[-180, 180]` |
| `configuration.radius` | number | No | Radius in kilometers |

```js theme={null}
proxy_location({country: 'us'});
proxy_location({lat: 37.7749, long: 122.4194});
proxy_location({lat: 37.7749, long: 122.4194, country: 'US', radius: 100});
```

#### `preserve_proxy_session`, Reuse the proxy session across child stages

```js theme={null}
preserve_proxy_session();
```

#### `set_session_cookie`, Set a cookie for the current session

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `domain` | string | Yes | Cookie domain |
| `name` | string | Yes | Cookie name |
| `value` | string | Yes | Cookie value |

```js theme={null}
set_session_cookie('example.com', 'session_id', 'abc123');
```

#### `set_session_headers`, Set extra HTTP headers

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `headers` | object | Yes | Header key-value pairs |

```js theme={null}
set_session_headers({'X-Custom-Header': 'value'});
```

### Browser configuration ⭐

Browser worker only.

#### ⭐ `browser_size`, Get the current browser window size

Returns `{width, height}` in pixels.

```js theme={null}
let size = browser_size();
console.log(size.width, size.height);
```

#### ⭐ `emulate_device`, Emulate a mobile device

Switches the user agent, screen resolution, and device pixel ratio to match a named device.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `device` | string | Yes | Device name, e.g. `iPhone X`, `Pixel 2` |

```js theme={null}
emulate_device('iPhone X');
emulate_device('Pixel 2');
```

<Accordion title="Full list of supported device names">
  * Blackberry PlayBook / landscape
  * BlackBerry Z30 / landscape
  * Galaxy Note 3 / landscape
  * Galaxy Note II / landscape
  * Galaxy S III / S5 / S8 / S9+ (each with landscape)
  * Galaxy Tab S4 / landscape
  * iPad / iPad Mini / iPad Pro / iPad Pro 11 / iPad (gen 6) / iPad (gen 7) (each with landscape)
  * iPhone 4, 5, 6, 6 Plus, 7, 7 Plus, 8, 8 Plus, SE, X, XR, 11, 11 Pro, 11 Pro Max, 12 / 12 Mini / 12 Pro / 12 Pro Max, 13 / 13 Mini / 13 Pro / 13 Pro Max (each with landscape)
  * JioPhone 2 / landscape
  * Kindle Fire HDX / landscape
  * LG Optimus L70 / landscape
  * Microsoft Lumia 550, 950 (950 with landscape)
  * Nexus 4, 5, 5X, 6, 6P, 7, 10 (each with landscape)
  * Nokia Lumia 520 / landscape, Nokia N9 / landscape
  * Pixel 2, 2 XL, 3, 4, 4a (5G), 5 (each with landscape)
  * Moto G4 / landscape
</Accordion>

#### ⭐ `emulate_geolocation`, Set browser geolocation

Configures the browser location for the crawl and grants the page access to the browser’s geolocation.

Use `emulate_geolocation()` when the target website changes content based on the browser’s latitude and longitude, or when the page requests access to browser location.

**Parameters**

| **Parameter** | **Type** | **Required** | **Description** |
| :- | :- | :- | :- |
| `geolocation` | object | Yes | Object with the desired browser location. |
| `geolocation.lat` | number | Yes | Latitude. Must be in range `[-85, 85]`. |
| `geolocation.long` | number | Yes | Longitude. Must be in range `[-180, 180]`. |
| `geolocation.acc` | number | No | Accuracy in meters. Must be in range `5-5000`. Values `5-20` behave like GPS-level accuracy; values `100-1000` behave like coarse IP/Wi-Fi location. |

```javascript theme={null}
emulate_geolocation(geolocation)
```

**Examples**

Set browser location:

```javascript theme={null}
emulate_geolocation({ lat: 37.7749, long: 122.4194 });
```

Use before navigation when the page reads location on load:

```javascript theme={null}
emulate_geolocation({ lat: 37.7749, long: 122.4194, acc: 10 });

navigate(input.url);
wait('.store-list');

const data = parse();
collect(data);
```

#### ⭐ `font_exists`, Check browser font support

Asserts that the browser can render the given font family.

```js theme={null}
font_exists('Liberation Mono');
```

#### ⭐ `html_capture_options`, Configure HTML capture

Controls how the HTML snapshot is captured.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `options.coordinate_attributes` | boolean | No | Embed element coordinates as attributes |

```js theme={null}
html_capture_options({
  coordinate_attributes: true,
});
```

#### `embed_html_comment`, Inject a comment into the page HTML

Embeds metadata inside HTML snapshots.

```js theme={null}
embed_html_comment('trace-id: asdf123');
```

### Debugging and observability

#### `console`, Log from interaction code

```js theme={null}
console.log(1, 'brightdata', [1, 2], {key: 'value'});
console.error('something went wrong');
```

#### ⭐ `verify_requests`, Monitor failed browser requests

Fires a callback on every failed browser request.

**Parameters**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `callback` | function | Yes | Called with `{url, error, type, response}` for each failed request |

```js theme={null}
verify_requests(({url, error, type, response}) => {
  if (response.status != 404 && type == 'Font')
    throw new Error('Font failed to load');
});
```

### Value constructors

Bright Data Scraper Studio provides typed constructors for structured output fields.

#### `Image`, `Video`, `Pdf`,  `Doc`, `Money`

| Constructor | Arguments | Use |
| - | - | - |
| `Image(src)` | `src`: image URL or data URI | Collect image data |
| `Video(src)` | `src`: video URL | Collect video data |
| `Pdf(src)` | `src`: PDF URL | Collect Pdf files |
| `Doc(src)` | `src`: document file URL | Collect document files |
| `Money(value, currency)` | `value`: number, `currency`: ISO code | Collect monetary values |

## **Supported downloaded file types**

Scraper Studio supports downloading files through media and document field constructors.

Use:

* `new Image()` for image files
* `new Video()` for video files
* `new Pdf()` for PDF files
* `new Doc()` for supported document, text, audio, video, and structured file types

### **Supported** `new Doc() `**content types**

`new Doc()` supports the following content types:

```text theme={null}
application/json
application/pdf
application/rtf
application/vnd.openxmlformats-officedocument.wordprocessingml.document
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
application/vnd.ms-excel
application/xml
application/vnd.oasis.opendocument.spreadsheet
audio/mp3
audio/mp4
audio/webm
text/csv
text/html
text/plain
text/vtt
text/xml
video/iso.segment
video/MP2T
video/mp2t
video/mp4
video/webm
```

example:

```js theme={null}
let img = new Image('https://example.com/image.png');
let vid = new Video('https://example.com/video.mp4');
let pdf = new Pdf('https://example.com/document.pdf');
let doc = new Doc('https://example.com/file.csv');
let price = new Money(10, 'USD');

collect({
image: img, 
video: vid, 
pdf, 
document: doc, 
product_price: price
});
```

#### `URL`

Standard Node.js `URL` class.

```js theme={null}
let u = new URL('https://example.com');
```

## `hash`**, Compute a hash digest**

Computes a hash digest of a string and returns it as a hexadecimal string.

Use `hash()` when you need a stable identifier, deduplication key, or checksum from a text value in interaction code.

### **Syntax**

```javascript theme={null}
hash(data, algorithm)
```

### **Arguments**

| **Argument** | **Type** | **Required** | **Default** | **Description** |
| - | - | - | - | - |
| `data` | string | Yes | None | The string to hash. |
| `algorithm` | string | No | `sha256` | Hash algorithm to use. One of: `sha256`, `sha1`, `sha512`, `md5`. |

### **Examples**

Use the default `sha256` algorithm:

```javascript theme={null}
const id = hash('some text');
```

Use `md5`:

```javascript theme={null}
const id = hash('some text', 'md5');
```

## Parser functions

Parser code runs after interaction code calls `parse()`. It receives the captured HTML and any tagged data, and returns a single record (or array of records) to the interaction code. Parser code uses Cheerio, a jQuery-compatible HTML parser.

### Globals available in parser code

| Name | Type | Description |
| - | - | - |
| `$` | Cheerio instance | Loaded with the page HTML |
| `input` | object | Current stage input |
| `location` | object | Current browser location; field: `href` |
| `parser` | object | Values tagged during interaction (from `tag_response`, `tag_script`, and related) |

```js theme={null}
let url = input.url;
let current_url = location.href;
$('#example').text();
```

### Cheerio helpers

Bright Data Scraper Studio adds custom Cheerio methods on top of the standard API.

#### `$(selector).text_sane()`, Normalize whitespace

Returns `text()` with all whitespace runs collapsed to a single space and trimmed.

```js theme={null}
let name = $('a').text_sane();                   // "foo bar baz"
let raw  = $('a').text();                        // "foo   bar\n\n\t baz"
```

#### `$(selector).filter_includes(text)`, Filter elements by text content

Filters a selection to elements whose text includes the given substring. Chainable with the rest of the Cheerio API.

```js theme={null}
$('.selector').filter_includes('text').click();
```

### Parser value constructors

`Image`, `Video`, `PDF` and `Money` are also available in parser code and work the same way.

```js theme={null}
let img = new Image('https://example.com/image.png');
let price = new Money(10, 'USD');
let p = new Pdf('https://example.com/document.pdf')
collect({image: img, product_price: price});
```

## **Validate downloaded media type**

Use `validate_type` to check that the downloaded file content matches the expected media type. This option is supported by `new Pdf()`, `new Image()`, and `new Video()`.

When `validate_type` is enabled, Scraper Studio validates the downloaded file after fetching it. If the file content does not match the expected type, the field returns an error instead of a valid downloaded file.

Example:

```javascript theme={null}
return {
  pdf: new Pdf('https://example.com/pdf', { validate_type: true }),
  image: new Image('https://example.com/image', { validate_type: true }),
  video: new Video('https://example.com/video', { validate_type: true }),
};
```

Validation failure example:

```json theme={null}
{
  "pdf": {
    "remote_url": "https://example.com/pdf",
    "error": "downloaded file type \"image\" does not match the expected \"pdf\" type",
    "validated_type": "image",
    "error_code": "wrong_file_type"
  }
}
```

<Tip>
  For full Cheerio API documentation, see the [Cheerio website](https://cheerio.js.org/).
</Tip>

## Shadow DOM support

Interaction commands that accept a selector also accept an **array** of selectors, letting you reach into Shadow DOM trees. Use this with `click`, `wait`, `type`, and other interaction functions.

When you pass an array:

* One selector must target the shadow host element
* Every selector after it is resolved inside that shadow root

```js theme={null}
click(['body', 'my-shadow-host', 'button.submit']);
```

In that example, `my-shadow-host` is the element with the shadow root attached, and `button.submit` is resolved inside that shadow root.

## Browser-only functions

The following functions require Browser worker and throw `not_supported_in_code_worker` when called from a Code worker. Use this list to decide which worker your scraper needs.

| Category | Functions |
| - | - |
| Waits | `wait`, `wait_any`, `wait_for_text`, `wait_visible`, `wait_hidden`, `wait_network_idle`, `wait_page_idle` |
| Interaction | `click`, `right_click`, `hover`, `mouse_to`, `type`, `press_key`, `select`, `scroll_to`, `scroll_to_all`, `load_more`, `close_popup`, `solve_captcha`, `bounding_box`, `detect_block` |
| Tagging | `tag_response`, `tag_all_responses`, `tag_script`, `tag_window_field`, `tag_image`, `tag_video`, `tag_screenshot`, `tag_serp`, `capture_graphql` |
| Browser config | `browser_size`, `emulate_device`, `emulate_geolocation`,`font_exists`, `html_capture_options`, `freeze_page`, `track_event_listeners`, `disable_event_listeners` |
| Session and routing | `proxy_location` |
| Debugging | `verify_request` |

See [Worker types](/products/scraper-studio/worker-types) to choose between Browser worker and Code worker.

## Related

<CardGroup>
  <Card title="Best practices" icon="list-check" href="/products/scraper-studio/best-practices">
    Recommended patterns for writing fast, reliable scrapers
  </Card>

  <Card title="Worker types" icon="server" href="/products/scraper-studio/worker-types">
    When to use Browser worker vs Code worker
  </Card>

  <Card title="Basics of web scraping" icon="graduation-cap" href="/products/scraper-studio/basics-of-web-scraping">
    Core concepts: interaction, parsing, stages, and scale
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/products/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>
</CardGroup>


# Initiate collection and delivery
Source: https://docs.brightdata.com/products/scraper-studio/initiate-collection-and-delivery-options

Trigger a Bright Data Scraper Studio collection by API, manually or on a schedule, then deliver results to webhook, Amazon S3, Snowflake, SFTP or email.

After you save a scraper to production in Bright Data Scraper Studio, you can start collection runs manually, by API, or on a schedule. You can also configure how results are delivered, which file format is used, what data is included, and when notifications are sent.

This page explains how to initiate Scraper Studio runs and configure delivery preferences.

## Prerequisites

* A scraper saved to production in the [Bright Data Scraper Studio](https://brightdata.com/cp/scrapers)
* An API key if you want to initiate runs or download results by API ([create one](https://brightdata.com/cp/setting))
* Destination credentials if you want to deliver results to webhook, cloud storage, SFTP or email

## How do I save a scraper to production?

While you edit code in the Bright Data Scraper Studio IDE, the system auto-saves your work as a development draft. For a new scraper, click **Finish editing** in the top-right corner when you are ready to make it available outside the IDE. For an existing production scraper, click **Save to production** to publish your changes.

Production scrapers appear under **My Scrapers** with an **Active** or **Ready** status. Unsaved scrapers remain in **Draft** status and cannot be initiated outside the IDE.

<Frame>
  <img alt="My Scrapers dashboard showing saved scrapers" />

  <img alt="My Scrapers dashboard showing saved scrapers" />
</Frame>

## How do I trigger a scraper run?

Bright Data Scraper Studio supports three ways to start a collection run.

<Tabs>
  <Tab title="Initiate by API">
    Use **Initiate by API** to start a collection from your application or automation workflow. Before using the API, create an API key. Go to [Dashboard > Account settings > API key](https://brightdata.com/cp/setting).

    For a full API walkthrough, see **[Getting started with the API](/products/scraper-studio/quickstart).**

    <Frame>
      <img alt="Initiate scraper by API" />
    </Frame>

    The API-trigger panel provides:

    1. **Inputs:** provide input values manually or through the API request body
    2. **Trigger behavior:** Run several requests in parallel by assigning them a queue name or queue additional jobs to run after earlier ones finish
    3. **API request preview:** A ready-to-run request example, including the endpoint and request body. Select the **Linux Bash** viewer for `curl`. The API response includes a `collection_id`. Use this ID to fetch results later when delivery is configured as API download.

    <Note>
      When delivery is set to **API download**, you must call the "Receive data" API endpoint to retrieve results. When delivery is configured as **webhook** or **cloud storage**, Bright Data sends the results to the configured destination automatically.
    </Note>
  </Tab>

  <Tab title="Initiate manually">
    Use **Initiate manually** to start a collection from the Bright Data control panel without writing a code.

    ## Open the Initiate manually page

    1. Go to **My scrapers**
    2. Select the scraper you want to run
    3. Open the **Initiate manually** tab

    The page shows the input fields required for that scraper. These fields come from the scraper’s input schema. For example, one scraper may require a `url`, while another may require `keyword` and `location`.

    ## Configure trigger behavior

    Use **Trigger behavior** to control how this run is grouped or queued.

    | Option | Description |
    | - | - |
    | Custom queue name | Optional name used to group related jobs in the same queue. |

    Run requests in parallel, or queue jobs so they start after earlier jobs finish. Use a queue name to group related jobs.

    If you do not need custom queue behavior, leave this field empty.

    ## Add inputs manually

    Type the values for this run, such as URLs, keywords, locations, or other required fields. Required fields vary by scraper.

    Each input row represents one item the scraper will process.

    To add another input row, click **Add another input**

    ## **Upload an input file**

    For larger input sets, upload a file instead of entering values one by one.

    Use **Attach a CSV file** to upload multiple inputs at once in CSV, TXT or JSON format (max 1GB). Empty rows are ignored.

    You can click **Download our example** to download a template for the current scraper. Use the example file to confirm:

    * Which columns are required
    * How input field names should be written
    * What format the uploaded file should use

    The uploaded file must match the scraper’s input schema. For example, if the scraper requires `search` and `location`, the file should include matching columns.

    ## **Set a deadline**

    Use **Deadline** to set the maximum amount of time the collection can run.

    If the collection is still running when the deadline is reached, Bright Data stops the collection and delivers the data collected so far.

    Supported values include durations or a future timestamp.

    Examples:

    | Format | Example |
    | - | - |
    | Hours | `1h` |
    | Minutes | `25m` or `30min` |
    | Seconds | `10s` |
    | Timestamp | `2026-06-09T19:14:12.056Z` |

    Use a deadline when you want to limit run time or receive partial results by a specific time.

    ## **Skip delivery**

    Enable **Skip delivery** if you want to run the scraper without sending results to the configured delivery destination.

    If **Skip delivery** is disabled, the run uses the scraper’s configured delivery preferences.

    ## **Start the run**

    After entering inputs or uploading a file:

    1. Review the input values.
    2. Configure optional settings, such as queue name, deadline, or skip delivery.
    3. Click **Start**.

    The collection starts and appears in the scraper’s **Runs** tab.
  </Tab>

  <Tab title="Schedule a scraper">
    Use scheduled runs to collect data automatically on a recurring basis.

    Scheduling is useful when you need fresh data hourly, daily, weekly, or on a custom schedule.

    **Step 1, configure the schedule:**

    1. Pick a start date and time
    2. Choose a frequency: hourly, daily, weekly, or custom
    3. Set a deadline for the scraper to finish
    4. Review your configuration before saving

    <Frame>
      <img alt="Schedule configuration screen" />
    </Frame>

    **Step 2, set inputs:**

    1. Upload a CSV file with a large input set (for example, a list of URLs). Download the CSV template to match the expected format
    2. Enter input values manually in the form

    <Frame>
      <img alt="Enter input values for a scheduled run" />
    </Frame>
  </Tab>
</Tabs>

## What are the rate limits and concurrency limits?

Bright Data Scraper Studio enforces concurrency limits per scraper, based on whether the request is batch or real-time.

| Collection type | Concurrency limit |
| - | - |
| Batch | Up to 100 concurrent requests per scraper |
| Real-time | 50K requests/min per customer |

When the batch limit is exceeded, Bright Data returns this error: `Maximum limit of 100 jobs per scraper has been exceeded. Please reduce the number of parallel jobs.`

## Batch vs real-time collection

Scraper Studio supports batch and real-time collection. Each method is optimized for a different use case.

| | Batch collection | Real-time collection |
| - | - | - |
| Input size | Many inputs per job (list of URLs or keywords) | One input per request |
| Response timing | Results are returned after the job completes. | Response is returned in real time. |
| Retention | 16 days | 7 days |
| Concurrency limit | up to 100 concurrent jobs per scraper | 50K requests/min per customer |
| Use when | You are building a dataset and can wait | You need an answer inside a live request |

Use batch collection for larger jobs and scheduled datasets. Use real-time collection for low-latency workflows that need a response for one input.

## How do I configure delivery?

Open **My Scrapers**, click a scraper row, and choose **Delivery preferences** to set where and how Bright Data Scraper Studio delivers results.

<AccordionGroup>
  <Accordion title="When should I receive the data?">
    * **On job Completion (batch):** Delivers results after the full collection run finishes. Use when you are collecting multiple inputs and can wait until the run completes.
      * **Split delivery to small batches:** Delivers partial result batches as they become available. Enter the number of data lines each batch should contain. Entering `10000` means each delivered file or payload contains up to 10,000 result lines.
    * **Real-time (single request):** Returns data for a single request in real time.
      * **Skip retries:** do not retry on error (speeds up collection at the cost of completeness)
  </Accordion>

  <Accordion title="Which file formats are supported?">
    * JSON
    * NDJSON
    * CSV
    * XLSX
    * Parquet

    **Parquet** is not available for the following delivery options:

    * API download
    * Email
    * Webhook
    * OCI PAR
  </Accordion>

  <Accordion title="Which delivery destinations are supported?">
    * Email
    * API download (pull via REST API)
    * Webhook (push via HTTPS POST)
    * Cloud storage: Amazon S3, Google Cloud Storage, Azure Blob Storage, Alibaba Cloud OSS, Google Cloud PubSub, OCI PAR
    * Snowflake
    * SFTP / FTP

    <Note>
      Media files cannot be delivered via Email or API download. Use cloud storage, SFTP, or webhook when collecting images, videos, or other binary content.
    </Note>
  </Accordion>

  <Accordion title="How can I control what goes in the batch output?">
    Use **Data preferences** to decide which records are included in delivery.

    * Results and errors in separate files
    * Results and errors in one combined file
    * Only successful results
    * Only errors
  </Accordion>

  <Accordion title="How are result files named?">
    Scraper Studio adds a status suffix to delivered result files based on the selected data preference:

    * **Only successful results**: one file, `<filename>.success.<extension>`
    * **Only errors**: one file, `<filename>.errors.<extension>`
    * **Results and errors in separate files**: two files, `<filename>.success.<extension>` and `<filename>.errors.<extension>`
    * **Results and errors in one combined file**: one file, `<filename>.<extension>`

    For example, with JSON delivery, files can be named:

    products.success.json<br />products.errors.json<br />products.json
  </Accordion>

  <Accordion title="Which notifications can I enable?">
    Use **Notifications** to receive updates about completed runs, low success rates, or delivery problems.

    Notifications can be configured separately for production and development.

    * **Completion notifications** (Email, Webhook, None) - use **When finished, notify me by** to choose whether Scraper Studio sends a notification after a run completes.
    * **Low success rate notifications** - use **Notify me about low success rates** to receive alerts when scraper success rates drop.
    * **Delivery problem notifications** - use **Notify me about problems with delivery** to receive alerts when Scraper Studio cannot deliver results to the configured destination.
  </Accordion>

  <Accordion title="What is Development delivery settings?">
    The **Development** setting controls whether development runs use the same delivery settings as production. Use separate development settings when testing a new destination, webhook, or file format before applying it to production runs.
  </Accordion>

  <Accordion title="What happens if an S3 file with the same name already exists?">
    If Scraper Studio delivers a file to S3 and an object with the same key already exists, the existing S3 object is overwritten.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio specifications" icon="file-lines" href="/products/scraper-studio/specifications">
    Infrastructure limits, billing, and data retention
  </Card>

  <Card title="WARC snapshots" icon="file-zipper" href="/products/scraper-studio/warc-ide">
    Archive raw HTTP responses alongside collected data
  </Card>
</CardGroup>


# Input and output schema
Source: https://docs.brightdata.com/products/scraper-studio/input-and-output-schema

Define a Bright Data Scraper Studio IDE collector's input fields and structured output schema, across 18 output field types with validation and PII flags.

The input and output schema defines the data contract for a Bright Data Scraper Studio IDE collector: which fields a collection run accepts and which structured fields the collector returns.

* **Input schema** defines the fields a collection run accepts, such as `url`, `keyword`, `country`, `date`, or any custom field your interaction code reads from `input`.
* **Output schema** defines the structured fields the scraper returns, based on the data emitted by `collect()`.

Both schemas are configured in the Bright Data Scraper Studio IDE. Schema changes are applied to the production collector when you click **Save to Production**.

## What is the input schema?

The input schema defines the values your scraper can receive at runtime.

A scraper often uses a `url` input, but inputs are not limited to URLs. Depending on the collector logic, inputs can be keywords, locations, dates, IDs, countries, or any custom parameter.

Your interaction code reads input values through the `input` object:

```js theme={null}
navigate(input.url);
wait('.product-title');

const data = parse();
collect(data);
```

For a keyword-based scraper:

```js theme={null}
navigate(`https://example.com/search?q=${input.keyword}`);
wait('.search-results');

collect(parse());
```

A scraper can also run without user-provided input if the target URL or collection logic is hardcoded in the scraper code.

## Define input parameters

To define the input schema in the Bright Data Scraper Studio IDE:

1. Open your collector in the **Scraper Studio IDE**.
2. Go to the **Code** tab.
3. Click **Add input parameter**.
4. Enter a field name, for example `url`, `keyword`, `country`, or `date`.
5. Add an optional description.
6. Select the field type.
7. Mark the field as **Required** if the collector cannot run without it.
8. Click **Save**.
9. Click **Save to Production** when the collector is ready.

After a collector has already been saved, click **Edit schema** in the IDE to update its input schema.

### What are the input parameter settings?

| Setting | Description |
| - | - |
| **Field name** | The key used in code as `input.<field_name>`. |
| **Description** | Optional explanation of what value the user should provide. |
| **Type** | The expected value type, such as text/string, boolean, date, or country. |
| **Required** | If enabled, each collection input must include this field. |
| **Predefined values** | Optional fixed choices, when supported by the selected type. Example: `country` type. |
| **Case-insensitive** | Treats matching values as case-insensitive, when supported by the field configuration. |

## What do collection inputs look like?

A URL-based collector can accept one or more URLs:

```json theme={null}
[
  { "url": "https://example.com/product/1" },
  { "url": "https://example.com/product/2" }
]
```

A collector can also accept multiple input fields:

```json theme={null}
[
  {
    "url": "https://example.com/search",
    "keyword": "standing desk",
    "country": "US"
  },
  {
    "url": "https://example.com/search",
    "keyword": "monitor arm",
    "country": "GB"
  }
]
```

Only fields marked as **Required** must be provided for every input object. Optional fields can be omitted.

## What is the output schema?

The output schema defines the data point structure and how the data is organized.

In the Bright Data Scraper Studio IDE, the output schema is usually generated from the object passed to `collect()`.

```js theme={null}
collect({
  title: $('.product-title').text_sane(),
  price: new Money(+$('.price').text().replace(/\D+/g, ''), 'USD'),
  availability: $('.stock-status').text_sane(),
});
```

This produces output fields such as:

```json theme={null}
{
  "title": "ErgoDesk Pro",
  "price": {
    "value": 349.99,
    "currency": "USD"
  },
  "availability": "In stock"
}
```

When the scraper is saved, Scraper Studio detects the collected data structure and creates or updates the output schema.

## Update the output schema

There are two ways to update the output schema: automatically from parser code or manually in the schema editor.

### Update the schema automatically

1. Add or change fields in your parser code.
2. Run a preview to confirm that required fields return as expected.
3. Click **Save to Production**.
4. If Scraper Studio detects schema changes, click **Update schema**.
5. Click **Save to Production** again.

### Update the schema manually

1. Click **Edit schema** in the IDE.
2. Add or edit fields by name and type.
3. Configure required flags, default values, formatting, validation, or PII settings.
4. Save the schema.
5. Click **Save to Production**.

## What is the Output Schema Editor?

The Output Schema Editor defines exactly which fields your collector returns and how each field is validated, formatted and delivered.

The editor has two views:

| View | Description |
| - | - |
| **Table view** | Visual list of fields with toggles and field configuration. |
| **JSON view** | Direct JSON editing for the schema object. |

Clicking a field row opens the configuration side panel for that field.

## How is an output schema structured?

An output schema is a JSON object with a top-level `type` and a `fields` object:

```json theme={null}
{
  "type": "object",
  "fields": {
    "title": {
      "type": "text",
      "active": true
    },
    "price": {
      "type": "price",
      "active": true
    }
  }
}
```

## What properties can output fields have?

These properties apply to user-defined output fields.

| Property | Type | Description |
| - | - | - |
| `type` | string | Field type, such as `text`, `number`, `price`, `image`, or `object`. |
| `active` | boolean | Whether the field is included in the output. Default: `true`. |
| `required` | boolean | If `true`, rows with no valid value for this field are marked as errors. |
| `default_value` | string | Value used when the field cannot be populated. |
| `description` | string | Human-readable explanation of the field. |
| `pii` | boolean | Marks the field as containing personally identifiable information. |
| `custom_formatting` | object | Custom JavaScript formatter for advanced output shaping. |
| `custom_validation` | object | Define validation rules that run on every collected record. |

## Configure a field in the side panel

The side panel contains field-specific settings.

| Setting | Description |
| - | - |
| **Field name** | The key used in the output JSON. Available for user-defined fields. |
| **Display name** | Optional UI label, separate from the output key. |
| **Data type** | The field type. Changing the type resets type-specific settings. |
| **Active** | Includes or excludes the field from output. |
| **Required** | Marks rows as errors when this field is missing or invalid. |
| **Default value** | Fallback value when the field cannot be populated. |
| **Description** | Optional human-readable description of the field. |
| **Contains PII** | Marks the field as containing personally identifiable information. |
| **Format** | Type-specific output formatting. Example: price/money type. |
| **Download** | For media/file fields, downloads the file to configured storage. |
| **Array values** | Defines the item type for `array` fields. |
| **Subfields** | Defines nested fields for `object` fields. |
| **Normalize** | Controls empty array behavior. |
| **Set as quick filter** | Exposes the field as a filter in the dataset viewer. |
| **Quick filter operator** | Defines the comparison operator used by the quick filter. |

## What default values are available?

Available default values depend on the field type.

| Option | Output behavior | Available for |
| - | - | - |
| `undefined` | Field is omitted from the output. | All types |
| `null` | Field is returned as `null`. | All types |
| `""` | Empty string. | `text` |
| `false` | Boolean false. | `boolean` |
| `0` | Numeric zero. | `number`, `price` |
| `[]` | Empty array. | `array` |

## What output field types are available?

Scraper Studio supports the following user-defined output field types.

### `text`

Free-form text.

```json theme={null}
{
  "type": "text",
  "active": true,
  "required": false,
  "default_value": "null"
}
```

Example value:

```json theme={null}
"Laptop 15-inch Pro"
```

### `number`

Integer or decimal number. Numeric strings can be converted to numbers.

```json theme={null}
{
  "type": "number",
  "active": true,
  "format": {
    "decimal_places": 2
  },
  "default_value": "zero"
}
```

Example value:

```json theme={null}
11.23
```

### `url`

A URL string. Only `http://` and `https://` URLs are accepted.

```json theme={null}
{
  "type": "url",
  "active": true,
  "required": true
}
```

Example value:

```json theme={null}
"https://example.com/product/123"
```

### `price`

A monetary value represented as a numeric value and currency code.

```json theme={null}
{
  "type": "price",
  "active": true,
  "format": {
    "preset": "us_style"
  }
}
```

Example value:

```json theme={null}
{
  "value": 99.99,
  "currency": "USD"
}
```

Price format presets:

| Preset | Description | Example |
| - | - | - |
| `us_style` | US-style formatting. | `$1,234.56` |
| `locale` | Locale-aware formatting. Requires locale. | `1.234,56 €` |
| `number` | Numeric value only. | `1234.56` |
| `raw` | Raw object. | `{ "value": 1234.56, "currency": "USD" }` |
| `custom` | Template using `{[symbol]}`, `{[value]}`, `{[currency]}`. | `USD 1234.56` |

### `boolean`

A true/false value.

```json theme={null}
{
  "type": "boolean",
  "active": true,
  "default_value": "false"
}
```

Example value:

```json theme={null}
true
```

### `date`

Date or timestamp value.

```json theme={null}
{
  "type": "date",
  "active": true,
  "format": {
    "preset": "iso"
  }
}
```

Date format presets:

| Preset | Description | Example |
| - | - | - |
| `iso` | ISO 8601 string. | `2024-03-15T10:30:00.000Z` |
| `timestamp` | Unix timestamp in milliseconds. | `1710494400000` |
| `locale` | Locale-aware readable date. | `March 15, 2024 at 10:30:00 AM UTC` |

Locale formatting can include:

* Locale, for example `en-US`, `fr-FR`, `ru-RU`
* Date style: `long`, `medium`, `short`
* Time style: `long`, `medium`, `short`

### `country`

A two-letter ISO 3166-1 alpha-2 country code.

```json theme={null}
{
  "type": "country",
  "active": true
}
```

Example value:

```json theme={null}
"US"
```

### `phone`

A phone number parsed into structured components.

```json theme={null}
{
  "type": "phone",
  "active": true
}
```

Example value:

```json theme={null}
{
  "area_code": 1,
  "number": 5555555555,
  "extension": "1234"
}
```

### `image`

A downloaded or referenced image.

```json theme={null}
{
  "type": "image",
  "active": true,
  "download": true,
  "format": {
    "behavior": "object",
    "content_type": true
  }
}
```

When **Download** is enabled, the file is stored in the configured delivery destination. File downloads are billed separately from page loads where applicable.

### `video`, `pdf` and `doc`

These file types use the same download and behavior settings as `image`.

```json theme={null}
{
  "type": "video",
  "active": true,
  "download": true
}
```

Supported file field types:

| Type | Description |
| - | - |
| `video` | Downloaded or referenced video file. |
| `pdf` | Downloaded or referenced PDF file. |
| `doc` | Downloaded or referenced document file. |

## **File field output options**

For downloaded file fields, such as `image`, `video`, `pdf`, and `doc`, the output schema editor lets you control how file metadata is returned.

These settings appear when the field behavior is set to **Object**.

### **Behavior**

Use **Behavior** to choose how the file field is returned.

* **Simple**: returns only the downloaded file path or the original remote URL.
* **Object**: returns an object with file metadata, such as `file_path`, `remote_url`, `content_type`, `file_size`, and `response_headers`, depending on which options are enabled.

Use **Object** when you need more than the file path, for example when validating file type, checking file size, or debugging download headers.

### **Include content type**

Enable **Include content type** to include the file MIME type in the output.

Example:

```json theme={null}
{
  "content_type": "image/jpeg"
}
```

Use this to confirm whether the downloaded file is an image, PDF, video, or another media type.

### **Include file size**

Enable **Include file size** to include the downloaded file size in bytes.

Example:

```json theme={null}
{
  "file_size": 123456
}
```

Use this to validate file size, detect empty or unexpectedly large downloads, or troubleshoot failed media processing.

### **Include response headers**

Enable **Include response headers** to include the HTTP response headers received when Scraper Studio downloads the file.

Example:

```json theme={null}
{
  "response_headers": {
    "accept-ranges": "bytes",
    "age": "21753",
    "cache-control": "public, max-age=31557600",
    "content-type": "image/jpeg",
    "date": "Sun, 05 Jul 2026 12:43:07 GMT",
    "last-modified": "Sun, 05 Jul 2026 06:40:34 GMT",
    "source-length": "2088714",
    "source-type": "image/jpeg",
    "vary": "Accept"
  }
}
```

Response headers can help you debug file downloads, verify content type, inspect cache behavior, and troubleshoot unexpected media responses.

### **Example output**

When **Behavior** is set to **Object** and all metadata options are enabled, the output can look like this:

```json theme={null}
{
  "image": {
    "file_path": "image.jpg",
    "remote_url": "https://example.com/image",
    "content_type": "image/jpeg",
    "file_size": 123456,
    "response_headers": {
      "accept-ranges": "bytes",
      "age": "21753",
      "cache-control": "public, max-age=31557600",
      "content-type": "image/jpeg",
      "date": "Sun, 05 Jul 2026 12:43:07 GMT",
      "last-modified": "Sun, 05 Jul 2026 06:40:34 GMT",
      "source-length": "2088714",
      "source-type": "image/jpeg",
      "vary": "Accept"
    }
  }
}
```

### `array`

An ordered list of values. The element type is defined with `items`.

```json theme={null}
{
  "type": "array",
  "active": true,
  "normalize": {
    "empty": "keep"
  },
  "default_value": "empty_array",
  "items": {
    "type": "text"
  }
}
```

Empty array behavior:

| Option | Description |
| - | - |
| `keep` | Keep empty arrays as `[]`. |
| `drop` | Replace empty arrays with the configured default value. |

Array of nested objects:

```json theme={null}
{
  "type": "array",
  "active": true,
  "items": {
    "type": "object",
    "fields": {
      "name": {
        "type": "text",
        "active": true
      },
      "price": {
        "type": "price",
        "active": true
      }
    }
  }
}
```

### `object`

A nested object with its own subfields.

```json theme={null}
{
  "type": "object",
  "active": true,
  "fields": {
    "title": {
      "type": "text",
      "active": true
    },
    "price": {
      "type": "price",
      "active": true
    },
    "in_stock": {
      "type": "boolean",
      "active": true
    }
  }
}
```

### What HTML conversion field types are available?

| Type | Description | Example value |
| - | - | - |
| `html2text` | HTML converted to readable text. | `Product title\nDescription text` |
| `html2markdown` | HTML converted to Markdown. | `## Product title` |
| `html2html` | Raw HTML content. | `<div class="product"><h1>Title</h1></div>` |
| `html2ldjson` | Structured data from `application/ld+json` scripts. | `{"@type":"Product","name":"Widget"}` |

Example:

```json theme={null}
{
  "type": "html2markdown",
  "active": true
}
```

## How do I validate field values?

Custom validation lets you define JavaScript rules that run on every collected value for a field.

Throw an error to mark the value as invalid:

```js theme={null}
function validate(v) {
  if (!v)
    throw new Error('Value is required');

  return true;
}
```

Rows that fail validation are treated as error rows when validation is configured for required output quality.

## How do I format field values?

Custom formatting lets you transform a field value before output delivery.

```js theme={null}
function process(value) {
  return value;
}
```

Use custom formatting when built-in formatting options do not match the required output shape.

## When do I use collect() vs set\_lines()?

The way records are emitted affects the output dataset.

| Function | Behavior | Use when |
| - | - | - |
| `collect(data)` | Appends one record to the dataset. | Most scrapers. |
| `set_lines(data)` | Replaces previously emitted records with the latest set. | Progressive collection where the latest snapshot should be preserved. |

Example with `collect()`:

```js theme={null}
collect({
  title,
  price,
  availability,
});
```

Example with `set_lines()`:

```js theme={null}
set_lines(products);
```

## What system fields can I add?

System fields are generated by Scraper Studio. Their names and types are fixed. You can toggle them on or off in the output schema configuration under **Additional data**.

| Field | Type | Default | Description |
| - | - | - | - |
| `input` | string / object | On | The input value or object that triggered the crawl. |
| `prime_input` | string / object | Off | The original root input when discovery or pagination is used. |
| `error` | string | On | Explanation of why collection failed for the row. |
| `error_code` | string | On | Structured error code, such as `validation` or `timeout`. |
| `warning` | string | On | System-level warning for the row. |
| `warning_code` | string | On | Structured warning code. |
| `status_code` | number | Off | HTTP-like crawl result code, such as `200` or `404`. |
| `timestamp` | date | Off | Date and time the page was collected. |
| `requested_timestamp` | date | Off | Date and time the job was triggered. |
| `page_id` | string | Off | Unique identifier for the page crawl. |
| `job_id` | string | Off | ID of the job that produced the row. |
| `collector_id` | string | Off | ID of the collector. |
| `collector_queue` | string | Off | Queue the job was submitted to. |
| `crawl_type` | string | Off | Crawl or parser type used for the row. |
| `screenshot` | file | Off | Screenshot of the browser page at collection time. |
| `html` | file | Off | Full HTML snapshot of the page. |
| `warc` | file | Off | WARC archive of the page. |

When `screenshot`, `html`, or `warc` are active, the files are downloaded to the configured storage destination.

## How do I add a screenshot watermark?

When the `screenshot` system field is enabled, a watermark can be added to the screenshot. Each watermark item has a label and a data source.

| Source | Description |
| - | - |
| Browser URL | URL the browser was on when the screenshot was taken. |
| Timestamp | Timestamp of the screenshot capture. |
| Input value | Value from the collector input, such as `url` or `config.country`. |

## What does a full output schema look like?

```json theme={null}
{
  "type": "object",
  "fields": {
    "url": {
      "type": "url",
      "active": true,
      "required": true
    },
    "title": {
      "type": "text",
      "active": true
    },
    "price": {
      "type": "price",
      "active": true,
      "format": {
        "preset": "us_style"
      },
      "default_value": "zero"
    },
    "rating": {
      "type": "number",
      "active": true,
      "format": {
        "decimal_places": 1
      }
    },
    "in_stock": {
      "type": "boolean",
      "active": true,
      "default_value": "false"
    },
    "listed_date": {
      "type": "date",
      "active": true,
      "format": {
        "preset": "iso"
      }
    },
    "country": {
      "type": "country",
      "active": true
    },
    "images": {
      "type": "array",
      "active": true,
      "normalize": {
        "empty": "keep"
      },
      "default_value": "empty_array",
      "items": {
        "type": "image",
        "download": true
      }
    },
    "seller": {
      "type": "object",
      "active": true,
      "fields": {
        "name": {
          "type": "text",
          "active": true
        },
        "phone": {
          "type": "phone",
          "active": true
        }
      }
    }
  }
}
```

## Related

<CardGroup>
  <Card title="Develop a scraper" icon="wrench" href="/products/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>

  <Card title="Functions reference" icon="code" href="/products/scraper-studio/functions">
    Interaction and parser functions with parameters and examples
  </Card>

  <Card title="Initiate collection and delivery" icon="paper-plane" href="/products/scraper-studio/initiate-collection-and-delivery-options">
    Trigger collection and deliver output to your destination
  </Card>

  <Card title="Trigger a scraper (API)" icon="bolt" href="/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method">
    Run a published collector for batch collection by API
  </Card>
</CardGroup>


# When to use Scraper Studio
Source: https://docs.brightdata.com/products/scraper-studio/introduction

Decide when Bright Data Scraper Studio fits your use case and whether to build with the AI Agent or the JavaScript IDE, with a side-by-side comparison.

Bright Data Scraper Studio is a cloud-hosted environment for building, running, and managing custom web scrapers, running entirely on Bright Data's proxy and unblocking infrastructure. This page explains when to choose Scraper Studio over other Bright Data products and which build mode fits your use case.

For a visual overview, runnable example and the full list of build paths, see the [Scraper Studio overview](/products/scraper-studio/overview).

## Which development mode to use

Bright Data Scraper Studio offers two ways to build scrapers:

| Mode | How it works | Best for |
| - | - | - |
| AI Agent | Describe the data you want in plain language. Bright Data AI generates a schema and writes the scraper code | No-code users, fast prototyping |
| IDE | Write and test JavaScript directly in a browser-based code editor with debugging tools | Developers who need full control |

Both modes produce the same type of scraper: meaning you're never locked into one approach. A scraper built by AI Agent can be opened and edited in the IDE at any time, and any scraper can be updated using the [Self-healing tool](/products/scraper-studio/self-healing-tool).

## When to use Scraper Studio vs. other Bright Data products

Use Scraper Studio when the data you need isn't in the [Datasets Marketplace](/datasets/marketplace), you want ownership of the scraper logic, and you don't want to manage proxies or infrastructure yourself.

| Scenario | Recommended product |
| - | - |
| Need data from a popular site with zero setup | [Datasets Marketplace](/datasets/marketplace) |
| Need a scraper built and maintained by Bright Data | [Managed Services](https://brightdata.com/pricing/managed-services) |
| Need to build a custom scraper using AI or code on Bright Data's infrastructure | Scraper Studio |

## AI Agent vs. IDE: Key trade-offs

| | AI Agent | IDE |
| - | - | - |
| Setup time | Minutes, describe and run | Longer, write, test, debug |
| Code control | AI writes the code | You own every line |
| Customization | Via Self-healing tool prompts | Direct JavaScript editing |
| Best for | Fast scraper creation, non-technical users | Complex logic, multi-stage scrapers |

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Should I use AI Agent or IDE mode?">
    Use AI Agent if you want to get started fast or you're not a developer. Use Bright Data IDE mode if you need full control over scraper logic or are building complex, multi-stage scrapers.
  </Accordion>

  <Accordion title="Can I switch between AI Agent and IDE?">
    Yes. Any scraper created in AI Agent mode can be opened and edited in the IDE. You can also use the [Self-Healing Tool](/products/scraper-studio/self-healing-tool) to update scrapers using plain language prompts.
  </Accordion>

  <Accordion title="What's the difference between Scraper Studio and Scrapers Library?">
    [Scrapers Library](https://brightdata.com/products/web-scraper) contains pre-built scrapers for popular sites. Bright Data Scraper Studio is for building custom scrapers from scratch when your target site isn't in the library.
  </Accordion>

  <Accordion title="Do I need to manage proxies or servers?">
    No. Bright Data Scraper Studio handles all proxy management and infrastructure automatically.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup>
  <Card title="Build with AI Agent" icon="robot" href="/products/scraper-studio/ai-agent">
    Build your first scraper using plain language prompts
  </Card>

  <Card title="Explore the IDE" icon="code" href="/products/scraper-studio/scraper-studio-ide-interface">
    Get to know the browser-based code editor
  </Card>

  <Card title="Worker types" icon="server" href="/products/scraper-studio/worker-types">
    Understand how Scraper Studio runs your jobs
  </Card>
</CardGroup>

## Where to learn more

<CardGroup>
  <Card title="Scraper Studio Specifications" icon="file-lines" href="/products/scraper-studio/specifications">
    View infrastructure limits, billing model, and data retention rules
  </Card>
</CardGroup>


# Scraper Studio
Source: https://docs.brightdata.com/products/scraper-studio/overview

Build custom web scrapers with Bright Data Scraper Studio: AI Agent, JavaScript IDE or CLI, running on Bright Data's proxy and unblocking infrastructure.

<div>
  <div>
    <div>
      <div>
        <span>Scraper Studio</span>

        <h1>Build a custom scraper for any website</h1>

        <p>
          No pre-built scraper for your target site? Describe the data you want and build one on Bright Data's proxy and unblocking infrastructure. No servers, proxy rotation or retry logic to manage.
        </p>

        <div>
          <a href="/products/scraper-studio/quickstart">Start building</a>
        </div>
      </div>

      <div>
        <img alt="Bright Data Scraper Studio hero illustration" />
      </div>
    </div>

    <div>
      <span>💡</span>
      <span>Prefer no code? Describe your target in plain language and let the <a href="/products/scraper-studio/ai-agent">AI Agent</a> generate the scraper from your dashboard.</span>
    </div>

    ## Create a scraper from your terminal

    Install the Bright Data CLI, log in, then pass a target URL and one sentence describing the data you want. Bright Data's AI Agent generates the output schema, writes the scraper code and returns a Collector ID.

    ```bash theme={null}
    npm install -g @brightdata/cli
    bdata login
    bdata scraper create https://news.ycombinator.com \
      "Extract top stories: title, url, points, author, comment count"
    ```

    The same scraper opens in the AI Agent or the IDE for edits, and runs unchanged inside the embedded terminal of any coding agent like Claude Code, Cursor or Codex. See the full walkthrough in [Build a scraper with the Bright Data CLI](/products/scraper-studio/build-with-the-cli).

    ## Which way to build

    <CardGroup>
      <Card title="AI Agent" icon="robot" href="/products/scraper-studio/ai-agent">
        Describe the data in plain language. Bright Data AI generates the schema and writes the scraper code. No-code, fastest to a working scraper.
      </Card>

      <Card title="IDE" icon="code" href="/products/scraper-studio/scraper-studio-ide-interface">
        Write and debug JavaScript in a browser-based editor. Full control over interaction and parsing logic.
      </Card>

      <Card title="Bright Data CLI" icon="terminal" href="/products/scraper-studio/build-with-the-cli">
        Create, run and self-heal scrapers from your terminal or any coding agent. **New.**
      </Card>
    </CardGroup>

    Every scraper produces the same output regardless of how you build it. A scraper started in the AI Agent can be opened and edited in the IDE at any time, so you are never locked into one approach.

    ## How it works

    Every Bright Data Scraper Studio scraper performs two core operations, then keeps itself running as the target site changes.

    <CardGroup>
      <Card title="Interaction" icon="arrow-pointer">
        Navigate to a target URL, handle pagination, click elements or send HTTP requests.
      </Card>

      <Card title="Parsing" icon="brackets-curly">
        Read the page HTML and extract structured fields into a defined schema: JSON, CSV, NDJSON or XLSX.
      </Card>

      <Card title="Self-healing" icon="wand-magic-sparkles" href="/products/scraper-studio/self-healing-tool">
        When a site layout changes and a scraper breaks, update it with a plain-language prompt instead of rewriting selectors.
      </Card>
    </CardGroup>

    <iframe title="Scrape ANY website - Scraper Studio by Bright Data" />

    ## When to use Scraper Studio

    Use Bright Data Scraper Studio when the data you need is not in the [Scraper library](https://brightdata.com/cp/scrapers/browse), you want ownership of the scraper logic and you do not want to manage proxies or infrastructure yourself. For the full comparison and the AI Agent vs IDE trade-offs, see [Understanding Scraper Studio](/products/scraper-studio/introduction).

    <CardGroup>
      <Card title="Pre-built scrapers" icon="layer-group" href="/products/scrapers/overview">
        Need a popular site with zero setup? Use the pre-built scrapers in the Web Scraper API library instead.
      </Card>

      <Card title="Managed services" icon="screwdriver-wrench" href="https://brightdata.com/pricing/managed-services">
        Want a scraper built and operated for you? Bright Data's team builds custom scrapers for your targets. **No code required.**
      </Card>

      <Card title="Datasets marketplace" icon="store" href="/left-over/marketplace-overview">
        Skip scraping entirely. Buy ready-made datasets refreshed on a schedule. **No code required.**
      </Card>
    </CardGroup>

    ## What you can build

    <CardGroup>
      <Card title="Niche site scraping" icon="globe" href="/products/scraper-studio/quickstart">
        Extract structured data from any site without a pre-built scraper, from regional marketplaces to industry directories.
      </Card>

      <Card title="Price monitoring" icon="tag" href="/products/scraper-studio/ai-agent">
        Track prices, stock and listings on sites the standard scraper library does not cover.
      </Card>

      <Card title="AI and RAG ingestion" icon="robot" href="/products/scraper-studio/build-with-the-cli">
        Turn target pages into clean JSON or NDJSON to feed model training and retrieval pipelines.
      </Card>

      <Card title="Lead generation" icon="user-magnifying-glass" href="/products/scraper-studio/ai-agent">
        Pull contacts and company data from directories and listings into your sales pipeline.
      </Card>

      <Card title="Content aggregation" icon="newspaper" href="/products/scraper-studio/develop-a-scraper">
        Collect articles, listings or reviews from many sources into one structured feed.
      </Card>

      <Card title="Market research" icon="chart-line" href="/products/scraper-studio/complete-examples">
        Aggregate competitor activity, catalog data and trends from sites that change often.
      </Card>
    </CardGroup>

    ## Where to learn more

    <CardGroup>
      <Card title="Get started" icon="rocket">
        [Quickstart](/products/scraper-studio/quickstart)

        [Build with AI Agent](/products/scraper-studio/ai-agent)

        [Build with the CLI](/products/scraper-studio/build-with-the-cli)
      </Card>

      <Card title="IDE" icon="code">
        [IDE interface](/products/scraper-studio/scraper-studio-ide-interface)

        [Develop a scraper](/products/scraper-studio/develop-a-scraper)

        [Functions reference](/products/scraper-studio/functions)
      </Card>

      <Card title="Operations" icon="gauge-high">
        [Specifications](/products/scraper-studio/specifications)

        [Delivery options](/products/scraper-studio/initiate-collection-and-delivery-options)

        [Best practices](/products/scraper-studio/best-practices)
      </Card>

      <Card title="API basics" icon="code-branch">
        [Scraper Studio API](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method)

        [Worker types](/products/scraper-studio/worker-types)

        [FAQs](/products/scraper-studio/faqs)
      </Card>
    </CardGroup>
  </div>
</div>


# Bright Data Scraper Studio API quickstart
Source: https://docs.brightdata.com/products/scraper-studio/quickstart

Trigger a published Bright Data Scraper Studio collector and download structured JSON in three steps. Copy-paste examples in cURL, Node.js and Python.

This guide sends your first request to the Bright Data Scraper Studio API: trigger a published collector from your own code and get structured JSON back.

<Note>
  **No collector yet?** A collector is the published scraper you trigger here. Build one in minutes, then come back with its Collector ID (`c_...`):

  * **Fastest, from your terminal or coding agent:** [Build a scraper with the Bright Data CLI](/products/scraper-studio/build-with-the-cli). Three commands; the AI Agent writes the scraper. Runs as-is inside Claude Code, Cursor or Codex.
  * **No code, in the control panel:** [Build a scraper with the AI Agent](/products/scraper-studio/ai-agent).
  * **Full control:** [Build a scraper in the IDE](/products/scraper-studio/develop-a-scraper).

  This quickstart picks up once you have a Collector ID.
</Note>

The Bright Data Scraper Studio API is built around two HTTP calls:

1. `POST /dca/trigger`, which queues one or more inputs and returns a snapshot ID.
2. `GET /dca/dataset?id=<snapshot_id>`, which serves the snapshot once it is ready.

<Tip>
  Typical time to first record is about three minutes for a collector with one to ten inputs.
</Tip>

## Prerequisites

* An active [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with a payment method on file
* An **API key** from [Account Settings → API Tokens](https://brightdata.com/cp/setting)
* A **Collector ID** from a scraper you built with the [CLI](/products/scraper-studio/build-with-the-cli), [AI Agent](/products/scraper-studio/ai-agent) or [IDE](/products/scraper-studio/develop-a-scraper); the ID starts with `c_`

Set both values as environment variables once and reuse them across every snippet below:

```bash theme={null}
export BRIGHTDATA_API_KEY="YOUR_API_KEY"
export BRIGHT_DATA_COLLECTOR_ID="c_xxxxxxxxxxxxxxxx"
```

## Make your first request

<Steps>
  <Step title="Authenticate every call">
    Every Bright Data Scraper Studio API call uses bearer-token authentication. Add this header to every request:

    ```http theme={null}
    Authorization: Bearer YOUR_BRIGHT_DATA_API_TOKEN
    ```

    A missing or invalid token returns `401 Unauthorized`.
  </Step>

  <Step title="Trigger your collector">
    Send the inputs you want the collector to process as a JSON array in the request body. Each object in the array must match the input schema you defined when you built the collector. The default schema is a single `url` field.

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/dca/trigger?collector=$BRIGHT_DATA_COLLECTOR_ID&queue_next=1" \
        -H "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[
          {"url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker"},
          {"url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage"}
        ]'
      ```

      ```python Python theme={null}
      import os
      import requests

      API_TOKEN    = os.environ["BRIGHTDATA_API_KEY"]
      COLLECTOR_ID = os.environ["BRIGHT_DATA_COLLECTOR_ID"]

      response = requests.post(
          f"https://api.brightdata.com/dca/trigger?collector={COLLECTOR_ID}&queue_next=1",
          headers={
              "Authorization": f"Bearer {API_TOKEN}",
              "Content-Type": "application/json",
          },
          json=[
              {"url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker"},
              {"url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage"},
          ],
      )
      response.raise_for_status()
      snapshot_id = response.json()["collection_id"]
      print(snapshot_id)  # j_abc123def456
      ```

      ```js Node.js theme={null}
      const triggerUrl =
        `https://api.brightdata.com/dca/trigger` +
        `?collector=${process.env.BRIGHT_DATA_COLLECTOR_ID}&queue_next=1`;

      const response = await fetch(triggerUrl, {
        method: "POST",
        headers: {
          Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify([
          { url: "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker" },
          { url: "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage" },
        ]),
      });

      const { collection_id: snapshotId } = await response.json();
      console.log(snapshotId); // j_abc123def456
      ```
    </CodeGroup>

    The Bright Data Scraper Studio API responds with a single snapshot ID:

    ```json theme={null}
    {
      "collection_id": "j_abc123def456"
    }
    ```

    Keep this ID. You will use it as the `snapshot_id` in step 3.

    <Note>
      `queue_next=1` runs your inputs immediately. Omit it (or set `0`) to enqueue them behind any in-flight work for the same collector.
    </Note>
  </Step>

  <Step title="Poll until ready, then download">
    The same `/dca/dataset` endpoint serves both the in-progress and ready responses. Poll it every five seconds until the response is a JSON array.

    <CodeGroup>
      ```bash cURL theme={null}
      # Poll every 5 seconds until the response is a JSON array (not an object).
      while :; do
        response=$(curl -s \
          "https://api.brightdata.com/dca/dataset?id=$SNAPSHOT_ID" \
          -H "Authorization: Bearer $BRIGHTDATA_API_KEY")
        if [[ "${response:0:1}" == "[" ]]; then
          echo "$response" > results.json
          break
        fi
        sleep 5
      done
      ```

      ```python Python theme={null}
      import json
      import time

      while True:
          response = requests.get(
              f"https://api.brightdata.com/dca/dataset?id={snapshot_id}",
              headers={"Authorization": f"Bearer {API_TOKEN}"},
          )
          response.raise_for_status()
          body = response.json()
          if isinstance(body, list) and body:
              with open("results.json", "w") as f:
                  json.dump(body, f, indent=2)
              break
          time.sleep(5)
      ```

      ```js Node.js theme={null}
      const datasetUrl =
        `https://api.brightdata.com/dca/dataset?id=${snapshotId}`;

      while (true) {
        const response = await fetch(datasetUrl, {
          headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}` },
        });
        const body = await response.json();
        if (Array.isArray(body) && body.length > 0) {
          await fs.writeFile("results.json", JSON.stringify(body, null, 2));
          break;
        }
        await new Promise((r) => setTimeout(r, 5000));
      }
      ```
    </CodeGroup>

    While the snapshot is building, the response is a status object:

    ```json theme={null}
    { "status": "building" }
    ```

    When the snapshot is ready, the response is a JSON array. One row per successful input by default:

    ```json theme={null}
    [
      {
        "url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker",
        "title": "Echo Portable Speaker",
        "price": 49.99,
        "availability": "in stock",
        "input": { "url": "https://ecommerce-shop-brd.vercel.app/product/echo-portable-speaker" }
      },
      {
        "url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage",
        "title": "Nimbus Cloud Storage",
        "price": 12.99,
        "availability": "in stock",
        "input": { "url": "https://ecommerce-shop-brd.vercel.app/product/nimbus-cloud-storage" }
      }
    ]
    ```

    The exact field set depends on the output schema you defined when you built the collector.
  </Step>
</Steps>

## How long does this take?

The first record usually arrives within a minute, but total time depends on the collector and the target site. Measured against a typical e-commerce product page collector:

| Input count | Typical wall-clock time |
| - | - |
| 1 to 10 URLs | 30 to 90 seconds |
| 11 to 100 URLs | 2 to 5 minutes |
| 100+ URLs | 5+ minutes. Use [push delivery](/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level) instead of polling. |

For long-running jobs, swap polling for a [push delivery destination](/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level) (webhook, S3, GCS, Azure, SFTP or email) so Bright Data calls you when the snapshot is ready.

## What do the IDs mean?

Three identifiers appear in Bright Data Scraper Studio. They are easy to confuse because the trigger response uses one name for a value that another endpoint reads under a different name.

| Term | Looks like | What it identifies |
| - | - | - |
| **Collector ID** | `c_xxxxxxxxxxxxxxxx` | The published scraper definition. Stable. You pass it as the `collector` query parameter on `/dca/trigger`. |
| **Collection ID** (returned as `collection_id`) | `j_xxxxxxxxxxxxxxxx` | One run of the collector. The trigger response field is `collection_id`, but every other endpoint refers to the same value as `snapshot_id`. They are the same string. |
| **Dataset** | a JSON array | The result rows produced by one run. The `/dca/dataset` endpoint returns this when the run is finished. |

<Tip>
  Treat `collection_id` from the trigger response as your `snapshot_id` everywhere else. They are the same value under two names.
</Tip>

## What errors might I see?

| Status | Meaning | Fix |
| - | - | - |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `404 Not Found` | Collector ID does not exist or your account does not have access | Open the collector in [Scraper Studio](https://brightdata.com/cp/scrapers) and re-copy the ID |
| `422 Unprocessable Entity` | The objects in your request body do not match the collector's input schema | Confirm field names against the **Inputs** tab of your collector |
| `5xx` | Transient Bright Data API error | Retry with exponential backoff, for example 1s, 2s, 4s |
| `[]` (empty array) | Snapshot has no rows, or the snapshot expired | Batch results are retained for 16 days, real-time results for 7 days. See [Specifications](/products/scraper-studio/specifications) |

## Use a production-grade starter template

These open-source repositories are exactly the calls above, hardened with environment-variable config, retry/backoff for transient failures, library helpers and a complete `README`. Fork either and you have a runnable client in 30 seconds.

<CardGroup>
  <Card title="Node.js starter" icon="node-js" href="https://github.com/brightdata/bright-data-scraper-studio-nodejs-project">
    Node 18+, ES modules, dotenv, retry/backoff, \~150 LOC
  </Card>

  <Card title="Python starter" icon="python" href="https://github.com/brightdata/bright-data-scraper-studio-python-project">
    Python 3.8+, `requests`, `python-dotenv`, retry/backoff, \~150 LOC
  </Card>
</CardGroup>

Both repositories ship with a CodeSandbox devcontainer so you can fork and run in your browser without any local setup.

## Next steps

<CardGroup>
  <Card title="Choose a delivery type" icon="paper-plane" href="/api-reference/scraper-studio-api/Choose_a_delivery_type_on_request_level">
    Skip polling. Have Bright Data push results to a webhook, S3, GCS or email when the snapshot is ready.
  </Card>

  <Card title="Trigger a batch collection" icon="layer-group" href="/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method">
    Send hundreds or thousands of inputs in a single request and receive results in batches.
  </Card>

  <Card title="Run a synchronous real-time job" icon="bolt" href="/api-reference/scraper-studio-api/initiate-a-realtime-job/sync-realtime-job">
    For low-input, latency-sensitive workloads. Trigger and receive results in a single HTTP call.
  </Card>

  <Card title="Build a new collector" icon="screwdriver-wrench" href="/products/scraper-studio/build-with-the-cli">
    Need a collector that does not exist yet? Build one with the CLI, the AI Agent or the IDE.
  </Card>
</CardGroup>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I create the collector in the first place?">
    Build a Scraper Studio scraper with any of three paths, then use the Collector ID (`c_...`) it returns here:

    * [**Bright Data CLI**](/products/scraper-studio/build-with-the-cli) is the fastest. Run `bdata scraper create <url> "<what to extract>"` and the AI Agent writes the scraper. The CLI runs as-is inside Claude Code, Cursor or Codex.
    * [**AI Agent**](/products/scraper-studio/ai-agent) builds the scraper from a natural-language prompt in the control panel, no code required.
    * [**IDE**](/products/scraper-studio/develop-a-scraper) gives you full control over the scraper code.
  </Accordion>

  <Accordion title="What is the difference between the Collection API and the AI Flow API?">
    The **Collection API** (`/dca/*`, this page) runs an existing collector to **get data**. The [**AI Flow API**](/api-reference/scraper-studio-api/ai-flow/overview) runs the AI Agent to **create or self-heal** a collector. Most developers integrating Bright Data Scraper Studio into a product use the Collection API.
  </Accordion>

  <Accordion title="Can I send different input shapes in the same request?">
    Yes, as long as every object in the array conforms to the collector's input schema. If your collector accepts both `url` and `keyword` as input fields, you can mix them in one request. Fields you do not include are treated as `null`.
  </Accordion>

  <Accordion title="How do I retry failed inputs of batch job without re-running the successful ones?">
    Open **My Scrapers**, select the relevant scraper, and go to the **Runs** tab. Find the failed batch job, click the three-dot actions menu on the job row, and select **Rerun job**.

    Choose **Rerun failed pages** to retry only the failed pages, or **Rerun all from beginning** to run all original inputs again.

    For API workflows, use the [**<u>Rerun job API</u>**](https://docs.brightdata.com/api-reference/scraper-studio-api/rerun-job) with the `failed_only` option.

    Only jobs whose data has not expired can be rerun.
  </Accordion>

  <Accordion title="Is there a rate limit?">
    Yes. Per-account concurrency limits apply per collector. See [Specifications](/products/scraper-studio/specifications) for current limits. The starter templates linked above already implement exponential backoff for transient `5xx` responses.
  </Accordion>
</AccordionGroup>


# Scraper Studio IDE interface reference
Source: https://docs.brightdata.com/products/scraper-studio/scraper-studio-ide-interface

Reference for the Bright Data Scraper Studio JavaScript IDE: templates, stages, debug tabs, input controls, 2 worker settings and the Self-Healing tool.

The Bright Data Scraper Studio IDE is the browser-based JavaScript editor where you write, test, and debug custom scrapers. This page is a reference for every panel, control, and dashboard action you see in the IDE, with links to the guides that show each feature in use.

## What the IDE panel contains

The IDE panel is where you write and test your scraper code. Each labeled component below corresponds to a section of the IDE interface.

<Frame>
  <img alt="Light mode interface" />

  <img alt="Light mode interface" />
</Frame>

### A - Templates

A library of pre-built scraper code created by Bright Data's engineers, covering common websites and scraping patterns. Templates are starting points and may require adjustments if a target website's structure has changed.

### B - Stages

Stages allow a scraper to operate across multiple steps in sequence. Each stage receives input from the previous one via next\_stage() or run\_stage(). Use stages when scraping requires navigating across multiple page types - for example, collecting URLs from a listing page, then extracting details from each URL.

> See [Scraper Studio functions](/products/scraper-studio/functions) for the full command reference.

### C - Functions reference

An in-IDE reference panel listing all available scraping functions with descriptions and usage examples.

> See [Interaction functions](/products/scraper-studio/functions#interaction-functions) and [Parser functions](/products/scraper-studio/functions#parser-functions).

### D - Debugging tabs

| Tab | Description |
| - | - |
| **Input** | Define input parameters and select an input set to run a preview test |
| **Output** | Structured data returned by the scraper after a preview run |
| **Children** | Input sets passed to the next stage in a multi-stage scraper |
| **Run log** | Full code execution log for the most recent preview |
| **Browser network** | Browser-level network activity log (equivalent to DevTools > Network tab) |
| **Last errors** | The most recent error messages, including error codes and affected inputs (last 1,000 stored) |
| **Crawl inspector** | All pages crawled during a batch job, including successes and failures. For multi-stage scrapers, use **Search for children** to view pages generated from each parent |
| **Output schema** | Field names and data types for the scraper's output. Click **Edit Schema** to modify input or output schema |

### Preview output modes

When you run a preview, the Output tab can show results in two modes:

**Raw output** - shows the records exactly as they were collected by the scraper code, before schema formatting or processing is applied.

**Formatted output** - shows the records after they are processed according to the output schema, including field types, formatting rules, default values, validation, and other schema settings.

Use Raw output when debugging parser code or checking what collect() returned.

Use Formatted output when verifying the final structure that will be delivered in production runs.

For example, a price field may appear as raw text in Raw output, but as a structured price object or formatted value in Formatted output, depending on the output schema configuration.

### E - Input

| Control | Description |
| - | - |
| **Add input parameter** | Define a new input parameter by name and type |
| **New input** | Add a value to an input set for testing |
| **Preview** | Run the scraper against a selected input set |

### F - Settings

| Setting | Description |
| - | - |
| **Worker** | Select Browser Worker or Code Worker for this scraper |
| **Error mode** | Define scraper behavior when an error occurs |
| **Take screenshot** | Capture screenshots of loaded pages during preview runs |
| **Worker per stage** | Assign a different worker type to each stage instead of using one worker for the whole scraper |

> See [Worker types](/products/scraper-studio/worker-types) for guidance on choosing between Browser worker and Code worker.

### G - Self-Healing Tool

AI-powered code refactor. Accepts plain-language prompts to fix errors or modify input/output fields without manual code editing.

> See [Self-Healing tool](/products/scraper-studio/self-healing-tool).

### H - Preview

**Preview** runs the scraper code against the input selected in the **Input** tab at the bottom-left of the IDE. Use it to test your interaction and parser logic before saving the scraper to production. Preview results appear in the **Output** debugging tab.

Scraper Studio provides two preview modes:

* **Preview (browser)**, runs the scraper in an interactive browser view. Use this mode to inspect page behavior, clicks, scrolling, JavaScript rendering, and browser-only interactions.
* **HTML**, shows the loaded page HTML or response content used by the parser. Use this mode to debug selectors, parser logic, and extracted fields.

## Scraper Dashboard Menu

The Dashboard lists all your scrapers under **My Scrapers**. Each scraper has an action menu with the following options:

| Action | Description |
| - | - |
| **Initiate manually** | Start a collection run directly from the UI. See [Initiate manually](/products/scraper-studio/initiate-collection-and-delivery-options#initiate-manually). |
| **Initiate by API** | Trigger a collection programmatically via API. See [Initiate via API](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method) |
| **Run on schedule** | Configure a recurring collection - hourly, daily, weekly, or at a custom interval |
| **Delivery preferences** | Set the output format and delivery destination for completed jobs |
| **Code** | Open and edit the scraper in the IDE |
| **Runs** | View recent and queued collection runs, run status, records, inputs, success rate, cost breakdown, and run-level actions. |
| **Report an issue** | Submit a report for platform, scraper, or data quality issues |


# Fix scrapers with the Self-Healing tool
Source: https://docs.brightdata.com/products/scraper-studio/self-healing-tool

Use the Bright Data Scraper Studio Self-Healing tool to fix broken scrapers and add or remove output fields from plain-language prompts in 1 click.

The Self-Healing tool is an AI-powered code refactor assistant in Bright Data Scraper Studio that rewrites parts of a scraper from a plain-language prompt. Use it when a target site changes and your scraper stops returning the expected data, or when you need to add or remove output fields without editing the JavaScript by hand.

<Tip>
  **When to use it:** the scraper stops returning expected data, the price or title field returns `undefined`, or you need to add new fields (`price`, `image`, `rating`) without writing code.
</Tip>

<Note>
  The Self-Healing tool is manual: you write the prompt and review the diff. To let Bright Data Scraper Studio fix a scraper on its own when its success rate drops or a supported error occurs, configure [Auto Self-Healing](/products/scraper-studio/auto-self-healing) on the scraper.
</Note>

## Prerequisites

* An active [Bright Data account](https://brightdata.com/)
* An existing scraper in Bright Data Scraper Studio (saved in development mode)
* Access to the Scraper Studio IDE

## How do I fix a scraper with the Self-Healing tool?

<Steps>
  <Step title="Open the Self-Healing tool">
    In the Bright Data Scraper Studio IDE, open the scraper you want to fix and locate the Self-Healing tool panel.

    <Frame>
      <img alt="Self-Healing tool location in the Scraper Studio IDE" />
    </Frame>

    > **Expected result:** a text input field appears, ready to accept your instruction.

    <Frame>
      <img alt="Refactor collector panel" />
    </Frame>
  </Step>

  <Step title="Describe the fix or change you need">
    Type your request in plain language. Be specific about what is broken and which fields are affected.

    ```txt Example prompts theme={null}
    Add 'price' and 'image' fields to the output

    The 'price' value is returning 'undefined', please fix

    The 'price' field is returning incorrect data from HTML, switch to using tag_response() to capture '/api/price' instead
    ```

    > **Expected result:** the AI processes your prompt and produces a code diff in the editor.

    <Note>
      Refactoring can take up to 15 minutes. You do not need to stay on the page: Bright Data sends an email when the diff is ready, and you can review it at your convenience.

      <Frame>
        <img alt="Email notification when refactoring is complete" />
      </Frame>
    </Note>
  </Step>

  <Step title="Review the proposed changes">
    Examine the AI-generated diff in the code template. Verify it matches your intent before accepting.

    * **Accept:** saves the changes to a draft
    * **Decline:** discards the suggestion; your original code remains unchanged

    > **Expected result:** if accepted, the editor shows the updated code and saves it to the draft.
  </Step>

  <Step title="Run a preview">
    After accepting, run a preview to confirm the scraper returns the expected data.

    <Frame>
      <img alt="Run a preview button in the IDE" />
    </Frame>

    > **Expected result:** the output file contains the new or fixed fields with valid, non-undefined values.

    <Frame>
      <img alt="View and download preview results" />
    </Frame>
  </Step>

  <Step title="Save to production">
    Once the preview looks correct, save the scraper to production.

    <Frame>
      <img alt="Save to production button" />
    </Frame>

    <Note>
      If you added or renamed fields, Bright Data Scraper Studio prompts you to update the output schema. Click **Update Schema**, then **Save to Production**.

      <Frame>
        <img alt="Update schema prompt" />
      </Frame>
    </Note>

    > **Expected result:** the refactored scraper is live and collecting data with the new configuration.
  </Step>
</Steps>

## Troubleshooting

| Problem | Likely cause | Resolution |
| - | - | - |
| AI-generated code does not fix the issue | Prompt was too vague | Re-prompt with specific field names and an example error message |
| Preview still returns undefined values | Target site structure changed | Inspect the live page and include the expected HTML element or selector in your prompt |
| Changes do not appear after accepting | Browser cache issue | Refresh the IDE and re-check the development mode draft |
| The refactor runs for more than 15 minutes | Complex change or heavy prompt | Break the request into smaller prompts (one field at a time) |

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does the Self-Healing tool work on every scraper?">
    Yes. The Self-Healing tool works on any scraper saved in development mode in Bright Data Scraper Studio, regardless of whether the scraper was built by the AI Agent, from a template, or written from scratch in the IDE.
  </Accordion>

  <Accordion title="Can I undo a Self-Healing change?">
    Yes. Accepted changes go to a draft first; they only affect production after you click **Save to Production**. If you already saved to production, open the **Versions** menu on the scraper dashboard to roll back to an earlier version.
  </Accordion>

  <Accordion title="What happens if I change the output schema?">
    The Self-Healing tool can add or remove fields, but you must confirm the schema change before saving to production. Bright Data Scraper Studio prompts you with **Update Schema** when the new output no longer matches the current schema.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio AI Agent" icon="robot" href="/products/scraper-studio/ai-agent">
    Build a new scraper from natural-language prompts
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/products/scraper-studio/develop-a-scraper">
    Build and edit scrapers directly in the IDE
  </Card>

  <Card title="Auto Self-Healing" icon="wand-magic-sparkles" href="/products/scraper-studio/auto-self-healing">
    Fix a scraper automatically from per-scraper trigger rules
  </Card>
</CardGroup>


# Scraper Studio specifications
Source: https://docs.brightdata.com/products/scraper-studio/specifications

Bright Data Scraper Studio infrastructure limits, billing model (CPM + per-GB downloads) and data retention windows for batch and real-time collections.

This reference covers Bright Data Scraper Studio's infrastructure limits, billing model, and data retention rules for batch and real-time collections.

## Billing

Bright Data Scraper Studio billing is based on page loads and file downloads.

| Item | Unit | Rate |
| - | - | - |
| Page loads | CPM (1,000 page loads) | See [Pricing page](https://brightdata.com/pricing/web-scraper/studio) |
| File downloads | Per GB | Billed separately from page loads |

**What counts as a page load:** One URL request processed by Bright Data Scraper Studio infrastructure, regardless of response size.

<Note>
  File downloads are billed at a separate per-GB rate and do not count toward CPM. Check your [Billing dashboard](https://brightdata.com/cp/billing/overview) for current rates.
</Note>

## Infrastructure limits

| Item | Limit | Behavior when exceeded |
| - | - | - |
| Parallel batch jobs | Up to 100 simultaneous jobs per scraper | Additional jobs queue automatically |
| Job queue size | Unlimited | Jobs run as capacity becomes available |
| `/trigger_immediate` real-time collection requests | 50K requests/min per customer | Requests above the limit return a `429 Too Many Requests` error |

## Data retention

| Data type | Retention period | Behavior after expiry |
| - | - | - |
| Batch collection results | 16 days | Permanently deleted |
| Real-time results | 7 days | Permanently deleted |

<Warning>
  Export your data before the retention period expires. Bright Data does not recover expired data.
</Warning>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What happens when I exceed 100 parallel jobs on one scraper?">
    Additional jobs queue automatically. No jobs are dropped or cancelled. Jobs run in the order they were submitted as capacity becomes available.
  </Accordion>

  <Accordion title="What happens to my data after the retention period?">
    Data is permanently deleted after 16 days (batch) or 7 days (real-time). Bright Data does not recover expired data. Export your results before expiry.
  </Accordion>

  <Accordion title="Are file downloads included in my CPM billing?">
    No. File downloads are billed separately at a per-GB rate. CPM covers page loads only. Both charges appear in your [Billing dashboard](https://brightdata.com/cp/billing/overview).
  </Accordion>

  <Accordion title="What counts as a page load?">
    One page load equals one URL request processed by Bright Data Scraper Studio infrastructure, regardless of page size or response content.
  </Accordion>

  <Accordion title="What is the difference between page loads and records?">
    A page load is a URL request processed by Bright Data infrastructure. In Scraper Studio, actions such as `navigate()`, `request()`, or `load_more()` can generate page loads. Page loads are used for usage and billing calculations, and are billed in CPM units, meaning per 1,000 page loads.

    A record is a structured data item extracted from the loaded page or request response. For example, if one product listing page is loaded and the scraper extracts 20 products from it, that counts as 1 page load and 20 records.

    Page loads and records are not always the same. One page load can produce zero, one, or many records, depending on the website structure and scraper logic. In Scraper Studio, billing is based on page loads by default, while records represent the amount of data returned.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Understanding Scraper Studio" icon="book-open" href="/products/scraper-studio/introduction">
    Understand how Scraper Studio works and when to use it
  </Card>

  <Card title="Pricing & Billing" icon="credit-card" href="https://brightdata.com/cp/billing/overview">
    Full billing details for all Bright Data products
  </Card>
</CardGroup>


# Scraper Studio video tutorials
Source: https://docs.brightdata.com/products/scraper-studio/videos

Watch Bright Data Scraper Studio video tutorials on building scrapers, handling pagination, using templates, debugging and scraping dynamic sites.

This page is an index of video tutorials for Bright Data Scraper Studio. Each video pairs with a written guide in the docs. Pick the topic that matches what you are building and jump straight in.

## How to get started

### Introduction to Bright Data Scraper Studio

A guided tour of the Bright Data Scraper Studio IDE: templates, proxy networks, and how to build multiple scrapers in one flow. Start here if you have never built a scraper on Bright Data before.

<iframe title="Introduction to Bright Data Web Scraper IDE" />

**Pair with:** [Understanding Scraper Studio](/products/scraper-studio/introduction)

### Platform overview: project setup, proxies, and automation

A walkthrough of essential Bright Data Scraper Studio features: project setup, proxy creation and management, and scheduling automated collection runs.

<iframe title="Industrial-scale web scraping with AI and proxy networks" />

**Pair with:** [Scraper Studio IDE interface](/products/scraper-studio/scraper-studio-ide-interface)

## How to build scrapers

### Scrape data from Amazon search results

How to scrape Amazon search results, build a scraper that walks paginated results, and rely on the Bright Data proxy network to avoid blocks.

<iframe title="Scrape Amazon search results" />

**Pair with:** [Develop a scraper](/products/scraper-studio/develop-a-scraper)

### Walk search results with `for` loops

How to use a `for` loop to navigate hundreds of result pages, extract links to each listing, and collect data with `parse()` and `collect()`. Covers proxy manager setup, basic templates, input targeting, running and testing code, and reading logs.

<iframe title="Walk search results with for loops" />

**Pair with:** [Web scraping basics](/products/scraper-studio/basics-of-web-scraping)

### Use templates and deploy multiple scrapers

How to start from an IDE template, build a Walmart scraper, deploy it to the proxy network, and collect the data into a single API response.

<iframe title="Use IDE templates and proxy networks" />

**Pair with:** [Scraper Studio functions](/products/scraper-studio/functions)

### Build a Python scraper end-to-end

Building a Python project that uses Bright Data Scraper Studio templates, modifies the code, previews results, configures delivery, and retrieves data via API.

<iframe title="Build a Python scraper end-to-end" />

**Pair with:** [Initiate collection and delivery](/products/scraper-studio/initiate-collection-and-delivery-options)

## Handling challenging sites

### Scrape dynamic sites with utility functions

How to scrape a heavily dynamic site with Bright Data's browser helpers: waiting for grids to render, looping over grid cells, and using `next_stage()` to fan out detail collection.

<iframe title="Scrape dynamic sites with utility functions" />

**Pair with:** [Best practices](/products/scraper-studio/best-practices)

### Automate Airbnb with a Python scraper

How to customize a Bright Data Scraper Studio template to scrape Airbnb, plus the API flow for triggering the scraper and retrieving results.

<iframe title="Automate Airbnb with Python" />

**Pair with:** [Scraper Studio AI Agent](/products/scraper-studio/ai-agent)

## Debugging and delivery

### Debug a scraper and configure delivery

How to debug a scraper in the IDE, read the run log and errors, and choose a delivery method (API endpoint or Amazon S3).

<iframe title="Debug a scraper and configure delivery" />

**Pair with:** [Scraper Studio IDE interface](/products/scraper-studio/scraper-studio-ide-interface)

### End-to-end data engineering with Tableau

A longer walkthrough: proxy manager, API integrations, building a scraper from a template, using input for products or categories, running code, and reading logs for debugging.

<iframe title="End-to-end data engineering project" />

**Pair with:** [Features reference](/products/scraper-studio/features)

## Related

<CardGroup>
  <Card title="Understanding Scraper Studio" icon="book-open" href="/products/scraper-studio/introduction">
    How Bright Data Scraper Studio works and when to use it
  </Card>

  <Card title="Develop a scraper" icon="wrench" href="/products/scraper-studio/develop-a-scraper">
    Step-by-step walkthrough of building a scraper in the IDE
  </Card>
</CardGroup>


# WARC snapshots in Scraper Studio
Source: https://docs.brightdata.com/products/scraper-studio/warc-ide

Enable WARC file output in Bright Data Scraper Studio to archive the full HTTP response captured during a browser-worker scrape, ISO 28500 compliant.

Bright Data Scraper Studio can return a WARC (Web ARChive) file alongside every scraped page, capturing the exact HTTP responses the browser received during the crawl. Use this for digital preservation, audit trails, research reproducibility, or any workflow that requires byte-level evidence of what the site served.

## What is a WARC file?

WARC is an ISO-standard file format (ISO 28500) for storing web crawls and HTTP interactions. A single WARC file contains the raw request and response pairs, headers, timestamps, and payload bytes from every browser-side fetch during page load, HTML, CSS, JavaScript, images, and XHR requests.

<Note>
  WARC snapshots are available only on Browser worker scrapers. Code worker scrapers do not run a browser, so there is no browser-level network traffic to archive.
</Note>

## How do I enable WARC output on a scraper?

<Steps>
  <Step title="Open the scraper in the Bright Data Scraper Studio IDE">
    Go to [brightdata.com/cp](https://brightdata.com/cp/scrapers), select the scraper you want to archive, and click **Code** Tab to open it in the IDE. Then click **Edit schema** at the bottom of the **Output schema** section in IDE.
  </Step>

  <Step title="Enable the warc_snapshot field">
    In the **Output Schema** panel, find the `additional_data` section and click the eye icon next to `warc_snapshot` to turn it on.
  </Step>

  <Step title="Save and run a job">
    Save the scraper to production and trigger a run. The WARC file is produced for every page the scraper collects.
  </Step>

  <Step title="Retrieve the WARC files">
    Bright Data delivers the WARC files using whatever delivery method you configured for the scraper: API download, webhook, S3, Google Cloud Storage, Azure, SFTP, or email.

    See [Initiate collection and delivery](/products/scraper-studio/initiate-collection-and-delivery-options) for delivery options.
  </Step>
</Steps>

## How do I maximize what the WARC captures?

WARC capture records every request the browser makes during page load, but only while the browser is actively loading the page. To capture more, give the browser time to finish loading before the scraper moves on:

* Call `wait_network_idle()` near the end of the interaction code so the browser drains in-flight XHR and fetch requests before Bright Data Scraper Studio finalizes the WARC file.
* Prefer Browser worker over Code worker. Only browser-worker network traffic is recorded; raw `request()` calls in code-worker scrapers are not.
* If the page lazy-loads media via scroll, call `scroll_to('bottom')` or `load_more()` before `wait_network_idle()` so the browser actually fetches those resources.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What is recorded inside a Bright Data Scraper Studio WARC file?">
    Every browser-side request and response captured during page load: HTML documents, CSS, JavaScript, images, fonts, XHR, and fetch calls. Each entry includes the request line, headers, and response payload as the browser received them.
  </Accordion>

  <Accordion title="Does WARC output work with Code worker scrapers?">
    No. WARC snapshots require Browser worker because the capture runs at the browser network layer. Code worker scrapers issue raw HTTP requests directly, with no browser to record traffic from.
  </Accordion>

  <Accordion title="How are WARC files delivered and how much do they cost?">
    WARC files are delivered through the scraper's configured delivery method (API download, webhook, cloud storage, SFTP, or email). File downloads are billed per GB, separately from CPM page loads. See [Scraper Studio specifications](/products/scraper-studio/specifications) for current rates.
  </Accordion>

  <Accordion title="How long does Bright Data keep WARC snapshots?">
    WARC snapshots follow the scraper's snapshot retention: 16 days for batch collections and 7 days for real-time collections. Export or download the files before the retention window closes. Bright Data does not recover expired data.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio specifications" icon="file-lines" href="/products/scraper-studio/specifications">
    Billing model, retention periods and infrastructure limits
  </Card>

  <Card title="Initiate collection and delivery" icon="truck" href="/products/scraper-studio/initiate-collection-and-delivery-options">
    Set the delivery destination for WARC files and collected data
  </Card>
</CardGroup>


# Scraper Studio worker types
Source: https://docs.brightdata.com/products/scraper-studio/worker-types

Choose between 2 worker types in Bright Data Scraper Studio (Browser worker or Code worker) based on whether your site needs UI interaction or HTTP requests.

Bright Data Scraper Studio runs every scraper on one of two worker types: Browser worker (a real headless browser) or Code worker (raw HTTP requests). Pick the one that matches the minimum level of interaction your target site needs, Code worker is faster and cheaper, so start there and switch only if Code worker cannot reach the data.

## Browser worker vs Code worker

| | Browser worker | Code worker |
| - | - | - |
| Execution model | Headless browser session | Direct HTTP requests (like `curl` or `requests.get`) |
| Runs JavaScript | Yes | No |
| Clicks, scrolls, form input | Yes | No |
| Best for | Dynamic pages, SPAs, login flows, infinite scroll, GraphQL capture | Static HTML, sitemap crawls, public JSON APIs |
| Speed | Slower (browser startup, full page load) | Faster (single HTTP round trip) |

## Should I assign workers per scraper or per stage?

By default, Bright Data Scraper Studio scrapers run in Worker per scraper mode, where every stage shares one worker type. Worker per stage is available to all users and lets you assign a different worker type to each stage.

### When should I use Worker per scraper?

Use Worker per scraper when every stage needs the same worker type:

* **All stages need a Browser worker.** For example, Stage 1 navigates a search page where clicking or typing triggers the results, and Stage 2 scrolls through a dynamic product listing.
* **All stages need a Code worker.** For example, Stage 1 fetches all available URLs and Stage 2 loads each product page directly over HTTP.

### When should I use Worker per stage?

Use Worker per stage when stages have different interaction requirements:

* **Stage 1 needs a Code worker.** For example, fetching a list of product URLs from a category page.
* **Stage 2 needs a Browser worker.** For example, loading each product page that renders its price and reviews client-side with JavaScript.

Assigning the right worker to each stage avoids starting a full browser session where it is not needed, which reduces runtime.

### How do I configure Worker per stage?

1. Open your scraper in the Bright Data Scraper Studio IDE.
2. In the **Settings** dropdown, turn on **Worker per stage**.
3. For each stage, set the **Worker** to **Browser worker** or **Code worker**.
4. Save your scraper.

If you assign a Code worker to a stage that calls browser-only functions such as `wait`, `click` or `scroll_to`, Bright Data Scraper Studio throws an `Incompatible worker` error:

```text theme={null}
Click function is not supported for worker type = Code. To use it you should change the code settings to worker type = Browser.
```

For the full list of browser-only functions, see [Which functions are Browser worker](https://docs.brightdata.com/datasets/scraper-studio/functions#browser-only-functions)?

## When should I use Browser worker?

Use Browser worker when any of the following is true:

* The target data is rendered client-side by JavaScript and is not present in the raw HTML response
* You need to click, scroll, hover, or type to reach or reveal the data
* You need to solve a cookie banner or dismiss a popup before the content renders
* You need to capture network traffic with `tag_response`, `tag_script`, or `capture_graphql`
* You need to log in, hold a session, or interact with a form

## When should I use Code worker?

Use Code worker when all of the following are true:

* The full target data is present in the raw HTML response or in a public JSON endpoint
* No JavaScript execution is required to render the data
* No click, scroll, or type interaction is required
* You are crawling sitemaps, RSS feeds, or API endpoints

<Tip>
  Start with Code worker. If the data you need is not in the raw response, switch to Browser worker. You can change worker type on the same scraper at any time.
</Tip>

## Which functions are Browser worker?

Some Bright Data Scraper Studio functions depend on a live browser session and throw an error when called from a Code worker. The table below shows common examples of browser worker-only functions, not the full list. For the complete and up-to-date function list, see **[<u>Scraper Studio functions</u>](https://docs.brightdata.com/datasets/scraper-studio/functions#browser-only-functions).**

| Category | Functions |
| - | - |
| Waiting on the DOM | `wait`, `wait_any`, `wait_for_text`, `wait_hidden`, `wait_visible`, `wait_network_idle`, `wait_page_idle` |
| Scrolling | `scroll_to`, `scroll_to_all`, `load_more` |
| Traffic tagging | `tag_response`, `tag_all_responses`, `tag_script`, `tag_image`, `tag_video`, `tag_screenshot`, `tag_window_field`, `tag_serp`, `capture_graphql` |
| Keyboard and mouse input | `click`, `right_click`, `hover`, `mouse_to`, `press_key`, `type` |
| Browser configuration | `browser_size`, `emulate_device`, `freeze_page`, `emulate_geolocation` |
| Anti-bot | `solve_captcha`, `close_popup` |

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can I switch worker type after building the scraper?">
    Yes. Open the scraper in the Bright Data Scraper Studio IDE and change the worker type in the **Settings** panel. If you switch from Browser worker to Code worker, remove any calls to the browser-only functions listed above or the scraper will throw an error on the next run.
  </Accordion>

  <Accordion title="Is Code worker really faster than Browser worker?">
    Yes. Code worker issues a single HTTP request with no browser boot and no page render, so the round trip completes in a fraction of the time a browser-worker run takes. The exact speedup depends on the target site, but Code worker jobs typically finish in seconds.
  </Accordion>

  <Accordion title="Does Browser worker support capturing background API calls?">
    Yes. Use `tag_response` or `tag_all_responses` to capture any XHR or fetch the page makes, and `capture_graphql` to capture and replay GraphQL queries. See [Scraper Studio functions](/products/scraper-studio/functions) for the full reference.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup>
  <Card title="Scraper Studio functions" icon="code" href="/products/scraper-studio/functions">
    Full reference for interaction and parser commands
  </Card>

  <Card title="Best practices" icon="list-check" href="/products/scraper-studio/best-practices">
    Recommended patterns for writing efficient scrapers
  </Card>
</CardGroup>


# Amazon Scraper API
Source: https://docs.brightdata.com/products/scrapers/amazon/introduction

Extract data from Amazon products, reviews, sellers and search results with the Bright Data [Amazon Scraper API](https://brightdata.com/products/web-scraper/amazon). Best for up to 20 URLs per sync request.

Send an Amazon URL, get structured JSON back. The Bright Data Amazon Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/amazon?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 Amazon records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more Amazon URLs to the Bright Data Amazon Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (products, reviews, sellers, global products, or search) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data Amazon Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/amazon/quickstart).

```json theme={null}
{
  "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
  "asin": "B0FQFB8FMG",
  "brand": "Apple",
  "initial_price": 249,
  "final_price": 199,
  "currency": "USD",
  "rating": 4.4,
  "reviews_count": 14779,
  "seller_name": "Amazon.com",
  "availability": "In Stock"
}
```

## Supported data types

<CardGroup>
  <Card title="Products" icon="box" href="/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url">
    Product titles, prices, ratings, reviews count, seller info, and availability. Discover products by best sellers, category, keyword, or UPC.
  </Card>

  <Card title="Reviews" icon="star" href="/api-reference/scrapers/e-commerce-apis/amazon-reviews-collect-by-url">
    Review text, ratings, reviewer details, verified purchase status, and review dates.
  </Card>

  <Card title="Sellers Info" icon="store" href="/api-reference/scrapers/e-commerce-apis/amazon-sellers-info-collect-by-url">
    Seller names, ratings, feedback counts, and business details.
  </Card>

  <Card title="Products Global" icon="globe" href="/api-reference/scrapers/e-commerce-apis/amazon-products-global-collect-by-url">
    Product data from Amazon marketplaces worldwide. Discover by brand, category, keywords, or seller.
  </Card>

  <Card title="Products Search" icon="magnifying-glass" href="/api-reference/scrapers/e-commerce-apis/amazon-products-search-collect-by-url">
    Search results for any keyword on Amazon, including product listings and pagination.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each Amazon data type uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| Products | `gd_l7q7dkf244hwjntr0` |
| Reviews | `gd_le8e811kzy4ggddlq` |
| Sellers Info | `gd_lhotzucw1etoe5iw1k` |
| Products Global | `gd_lwhideng15g8jg63s7` |
| Products Search | `gd_lwdb4vjm1ehb499uxs` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data Amazon Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

Amazon changes how its pages are served, and the Bright Data Amazon Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between URL collection and discovery?

**URL collection** scrapes a specific Amazon page you provide (e.g., a product URL). **Discovery** finds Amazon content matching search criteria (e.g., all products in a category or matching a keyword) and scrapes the results. Discovery is accepted on both endpoints. On `/scrape` it usually runs past the 1-minute limit and returns HTTP `202` with a `snapshot_id`, so use the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint for discovery.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/amazon/quickstart">
    Scrape your first Amazon product in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/amazon/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# Amazon scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/amazon/quickstart

Set up the Bright Data Amazon Scraper API and collect your first product, review or seller as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape an Amazon product and get structured JSON data using the Bright Data Amazon Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/amazon?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/amazon?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Products endpoint**. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.amazon.products(url="https://www.amazon.com/dp/B0FQFB8FMG")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.amazon.com/dp/B0FQFB8FMG"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l7q7dkf244hwjntr0", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.amazon.com/dp/B0FQFB8FMG"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.amazon.com/dp/B0FQFB8FMG" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the returned records from `result.data`. It waits up to 240 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data Amazon Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of product data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data Amazon Scraper API returns a JSON array with structured product data:

    ```json theme={null}
    [
      {
        "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
        "asin": "B0FQFB8FMG",
        "brand": "Apple",
        "initial_price": 249,
        "final_price": 199,
        "currency": "USD",
        "rating": 4.4,
        "reviews_count": 14779,
        "seller_name": "Amazon.com",
        "availability": "In Stock"
      }
    ]
    ```

    Each product object includes fields covering pricing, ratings, seller info, and more. See the [full response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Amazon product using the Bright Data Amazon Scraper API.

## Common questions

### Can I scrape multiple products in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.amazon.com/dp/B0FQFB8FMG"},
  {"url": "https://www.amazon.com/dp/B09V3KXJPB"},
  {"url": "https://www.amazon.com/dp/B0BDJ279KF"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the Amazon product URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.amazon.com/dp/{ASIN}`.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | `client.scrape.amazon.products(url="https://www.amazon.com/dp/B0FQFB8FMG")`; see the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines amazon_product "https://www.amazon.com/dp/B0FQFB8FMG" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/amazon/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Amazon Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/amazon/send-first-request

Send synchronous requests to all 5 Bright Data Amazon Scraper API endpoints with copy-paste examples for products, reviews, sellers, global and search.

This guide shows you how to send a synchronous request to each Bright Data Amazon Scraper API endpoint. It covers products, reviews, sellers info, products global, and products search.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/amazon?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/amazon/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.amazon.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape Amazon products

**Dataset ID:** `gd_l7q7dkf244hwjntr0`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0FQFB8FMG"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
      "asin": "B0FQFB8FMG",
      "brand": "Apple",
      "initial_price": 249,
      "final_price": 199,
      "currency": "USD",
      "rating": 4.4,
      "reviews_count": 14779,
      "seller_name": "Amazon.com",
      "availability": "In Stock"
    }
  ]
  ```
</Accordion>

[Full Products response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url)

### Which output fields does the Amazon products scraper return?

The Amazon products scraper (`gd_l7q7dkf244hwjntr0`, `collect_by_url`) returns 102 output fields.

<Accordion title="Output fields (102)">
  | Field | Type | Description |
  | - | - | - |
  | `title` | text | Product title |
  | `seller_name` | text | Seller name |
  | `brand` | text | Product brand |
  | `description` | text | A brief description of the product |
  | `initial_price` | price | Initial price |
  | `currency` | text | Currency of the product |
  | `availability` | text | Product availability |
  | `reviews_count` | number | Number of reviews |
  | `categories` | array | Product categories |
  | `parent_asin` | text | Parent ASIN of the product |
  | `asin` | text | Unique identifier for each product |
  | `buybox_seller` | text | Seller in the buy box |
  | `number_of_sellers` | number | Number of sellers for the product |
  | `root_bs_rank` | number | Best sellers rank in the general category |
  | `ISBN10` | text | ISBN-10 identifier for books |
  | `answered_questions` | number | Number of answered questions |
  | `domain` | url | URL of the product domain |
  | `images_count` | number | Number of images |
  | `url` | url | URL that links directly to the product |
  | `video_count` | number | Number of videos |
  | `image_url` | url | URL that links directly to the product image |
  | `item_weight` | text | Weight of the product |
  | `rating` | number | Product rating |
  | `product_dimensions` | text | Dimensions of the product |
  | `seller_id` | text | Unique identifier for each seller |
  | `image` | url | URL that links directly to the product image |
  | `date_first_available` | text | Date when the product first became available |
  | `discount` | text | Product discount information |
  | `model_number` | text | Model number of the product |
  | `manufacturer` | text | Manufacturer of the product |
  | `department` | text | Department to which the product belongs |
  | `plus_content` | boolean | Boolean indicating the presence of additional content |
  | `upc` | text | Universal Product Code |
  | `video` | boolean | Boolean indicating the presence of videos |
  | `top_review` | text | Top review for the product |
  | `final_price_high` | price | Highest value of the final price when it is a range |
  | `final_price` | price | Final price of the product |
  | `variations` | array | Details about the same product in different variations |
  | `delivery` | array | Delivery-related information |
  | `features` | array | Product features |
  | `format` | array | Books format-related information |
  | `buybox_prices` | object | Product price details |
  | `input_asin` | text | Input ASIN (currently inactive) |
  | `ingredients` | text | Ingredients of the product, relevant mostly for food products |
  | `origin_url` | url | Source page URL used to extract this record |
  | `bought_past_month` | number | Units bought in the past month (as shown by Amazon) |
  | `is_available` | boolean | Indication if the product is still available |
  | `root_bs_category` | text | best seller root category |
  | `bs_category` | text | best seller category |
  | `bs_rank` | number | best seller rank in the specific category |
  | `badge` | text | product badge. for example: #1 Best Seller or Amazons Choice |
  | `subcategory_rank` | array | Best Sellers rank entries by subcategory |
  | `amazon_choice` | boolean | Specifies if the product is amazons choice |
  | `images` | array | URLs of the product images |
  | `product_details` | array | Full product details |
  | `prices_breakdown` | object | Breakdown of list/typical pricing and deal status |
  | `country_of_origin` | text | Country of origin of the product |
  | `from_the_brand` | array | Brand-provided promotional media shown on the page |
  | `product_description` | array | Media embedded in the product description section |
  | `seller_url` | url | Seller storefront/profile URL on Amazon |
  | `customer_says` | text | customer\_says |
  | `sustainability_features` | array | Sustainability badges/certifications with references |
  | `climate_pledge_friendly` | boolean | Whether the product shows the Climate Pledge Friendly badge |
  | `videos` | array | URLs of the products videos |
  | `other_sellers_prices` | array | Offers from other sellers for the same product |
  | `downloadable_videos` | array | Direct media URL |
  | `editorial_reviews` | array | The Editorial Reviews of the book |
  | `about_the_author` | text | About the author information |
  | `zipcode` | text | ZIP/postal code used for delivery and availability estimates |
  | `coupon` | text | coupon |
  | `sponsered` | boolean | sponsored |
  | `store_url` | url | The products store URL |
  | `ships_from` | text | Where the item ships from |
  | `city` | text | City related to shipping or seller/location context |
  | `customers_say` | object | Amazons Customers say summary extracted from reviews |
  | `max_quantity_available` | number | Maximum quantity allowed to add to cart |
  | `variations_values` | array | Variations and their possible values |
  | `language` | text | Language of the product page/content |
  | `return_policy` | text | Return policy text shown on the product page |
  | `inactive_buy_box` | object | Price information when the Buy Box is unavailable/inactive |
  | `buybox_seller_rating` | number | The rating of the buy box seller |
  | `premium_brand` | boolean | Is it premium brand |
  | `amazon_prime` | boolean | Does it have amazon prime delivery |
  | `coupon_description` | text | coupon description |
  | `all_badges` | array | all badges |
  | `sponsored` | boolean | Amazon Sponsored flag |
  | `variant_attributes` | array | Current variant attributes as name/value pairs |
  | `safety_information` | text | Safety Information |
  | `subcategory_link` | array | Best Sellers link entries by subcategory |
  | `is_frequently_returned_item_badge` | boolean | Indicates whether the badge is present |
  | `frequently_returned_item_message` | text | The text shown inside the warning box |
  | `is_customers_usually_keep` | boolean | Indicates whether customers usually keep this item |
  | `title_badge` | text | Title of the badge |
  | `review_videos` | array | review\_videos |
  | `bought_past_month_text` | text | Units bought in the past month (as displayed by Amazon), in text format. |
  | `is_high_price` | boolean | Indicates whether the product is tagged as high price. |
  | `title_highlight` | text | Captures the supplementary marketing/highlight text that Amazon renders directly after the product title on the product page |
  | `title_clean` | text | The actual product title as defined by the seller/brand, excluding any Amazon-rendered highlight text that may appear next to/after it on the page |
  | `customers_say_topics` | array | Structured breakdown of the "Customers say" section |
  | `brand_url` | url | Product brand URL |
  | `variant_condition` | text | The condition of a product variant (e.g., New, Renewed, Refurbished - Excellent). |
  | `is_aplus_premium` | boolean | Indicates whether the product is Premium A+ |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_l7q7dkf244hwjntr0.json`](/scrapers/gd_l7q7dkf244hwjntr0.json)

## How to scrape Amazon reviews

**Dataset ID:** `gd_le8e811kzy4ggddlq`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_le8e811kzy4ggddlq&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0FQFB8FMG"}]'
```

Add `max_reviews` to cap how many reviews a request returns: `[{"url": "https://www.amazon.com/dp/B0FQFB8FMG", "max_reviews": 50}]`.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "rating": 5,
      "author_name": "Jer***s",
      "helpful_count": 62,
      "asin": "B0FQFB8FMG",
      "url": "https://www.amazon.com/dp/B0FQFB8FMG",
      "product_name": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
      "product_rating": 4.4,
      "product_rating_max": 5,
      "product_rating_count": 14779,
      "review_header": "The best"
    }
  ]
  ```
</Accordion>

[Full Reviews response schema](/api-reference/scrapers/e-commerce-apis/amazon-reviews-collect-by-url)

### Which output fields does the Amazon reviews scraper return?

The Amazon reviews scraper (`gd_le8e811kzy4ggddlq`, `collect_by_url`) returns 27 output fields.

<Accordion title="Output fields (27)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The URL or link to the review on Amazon |
  | `product_name` | text | The name of the product |
  | `product_rating` | number | The average rating of the product |
  | `product_rating_object` | object | Object representing the breakdown of product ratings |
  | `product_rating_max` | number | The maximum product rating |
  | `rating` | number | The rating given by the reviewer for the product |
  | `author_name` | text | The name of the person who wrote the review |
  | `asin` | text | The Amazon Standard Identification Number of the product |
  | `product_rating_count` | number | The total count of ratings for the product |
  | `review_header` | text | The header or title of the review |
  | `review_id` | text | The unique identifier for each review |
  | `review_text` | text | The textual content of the review |
  | `author_id` | text | The unique identifier for the review author |
  | `author_link` | url | Link to the author's profile or page |
  | `badge` | text | Any badge or recognition associated with the review author |
  | `brand` | text | The brand of the product being reviewed |
  | `review_posted_date` | text | The date when the review was posted |
  | `review_country` | text | The country associated with the reviewer |
  | `review_images` | array | Any images attached to the review |
  | `helpful_count` | number | The count of users who found the review helpful |
  | `is_amazon_vine` | boolean | is\_amazon\_vine |
  | `is_verified` | boolean | is\_verified |
  | `variant_asin` | text | variant\_asin |
  | `variant_name` | text | variant\_name |
  | `videos` | array | videos |
  | `categories` | array | The product's categories |
  | `department` | text | The product's department |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_le8e811kzy4ggddlq.json`](/scrapers/gd_le8e811kzy4ggddlq.json)

## How to scrape Amazon sellers info

**Dataset ID:** `gd_lhotzucw1etoe5iw1k`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lhotzucw1etoe5iw1k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/sp?seller=A17MC6HOH9AVE6"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "seller_name": "Adorama",
      "seller_id": "A17MC6HOH9AVE6",
      "url": "https://www.amazon.com/sp?seller=A17MC6HOH9AVE6",
      "description": "At Adorama, we believe everyone is a creator. Our mission since 1974 is to inspire, educate and equip to make dreams a reality. For more than 40 years we hav...",
      "stars": "4.5 out of 5 stars",
      "shipping_policies": "This item is Fulfilled by Amazon.com and ships based on Amazon.com Shipping Rates and Policies .",
      "privacy_security": "Amazon knows that you care how information about you is used and shared, and we appreciate your trust that we will do so carefully and sensibly. By visiting...",
      "help_content": "For questions about a charge that has been made to your credit card, please contact Amazon. Questions about how to place an order? Search Amazon Help.",
      "products_link": "https://www.amazon.com/s?ie=UTF8&marketplaceID=ATVPDKIKX0DER&me=A17MC6HOH9AVE6",
      "buisness_name": "Adorama Inc"
    }
  ]
  ```
</Accordion>

[Full Sellers Info response schema](/api-reference/scrapers/e-commerce-apis/amazon-sellers-info-collect-by-url)

### Which output fields does the Amazon sellers info scraper return?

The Amazon sellers info scraper (`gd_lhotzucw1etoe5iw1k`, `collect_by_url`) returns 29 output fields.

<Accordion title="Output fields (29)">
  | Field | Type | Description |
  | - | - | - |
  | `seller_id` | text | Unique identifier for the seller |
  | `url` | url | The link to the seller's page on Amazon |
  | `seller_name` | text | Name of the Amazon seller |
  | `description` | text | Brief overview or summary of the seller |
  | `detailed_info` | array | Comprehensive information about the seller |
  | `stars` | text | Average star rating based on feedback |
  | `feedbacks` | array | Total received feedbacks |
  | `return_policy` | array | Information about the seller's return policy |
  | `shipping_policies` | text | Details about the seller's shipping policies |
  | `privacy_security` | text | Information about the seller's privacy and security practices |
  | `privacy_policy` | text | The seller's privacy policy details |
  | `tax_info` | text | Information regarding the seller's tax-related policies |
  | `help_content` | text | Content or resources provided for customer assistance |
  | `products_link` | text | Link or reference to the seller's products |
  | `buisness_name` | text | Official name of the seller's business |
  | `buisness_address` | text | Physical address of the seller's business |
  | `rating_positive` | text | Percentage of positive ratings received |
  | `brands` | array | Brands associated with the seller |
  | `feedbacks_percentages` | object | Percentage breakdown of feedback types |
  | `rating_count_m12` | number | Total rating count for the last 12 months |
  | `rating_count_m3` | number | Total rating count for the last 3 months |
  | `rating_count_lifetime` | number | Total lifetime rating count |
  | `rating_count_m1` | number | Total rating count for the last 1 month |
  | `country` | country | The country associated with the seller |
  | `email` | text | Email of the seller |
  | `seller_phone_number` | text | Phone number of the seller |
  | `rating_count` | number | Rating count |
  | `delivery_rates` | text | Information about the seller's delivery rates |
  | `products_count` | number | Total number of products offered by the seller |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lhotzucw1etoe5iw1k.json`](/scrapers/gd_lhotzucw1etoe5iw1k.json)

## How to scrape Amazon products globally

**Dataset ID:** `gd_lwhideng15g8jg63s7`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.co.uk/dp/B0FQFB8FMG"}]'
```

<Accordion title="Example response (illustrative, not captured)">
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
      "asin": "B0FQFB8FMG",
      "final_price": 229.00,
      "currency": "GBP",
      "rating": 4.7,
      "reviews_count": 32150,
      "seller_name": "Amazon.co.uk",
      "brand": "Apple",
      "availability": "In Stock",
      "domain": "amazon.co.uk",
      "url": "https://www.amazon.co.uk/dp/B0FQFB8FMG"
    }
  ]
  ```
</Accordion>

[Full Products Global response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-global-collect-by-url)

### Which output fields does the Amazon global products scraper return?

The Amazon global products scraper (`gd_lwhideng15g8jg63s7`, `collect_by_url`) returns 73 output fields.

<Accordion title="Output fields (73)">
  | Field | Type | Description |
  | - | - | - |
  | `title` | text | Product title |
  | `seller_name` | text | Seller name |
  | `brand` | text | Product brand |
  | `description` | text | A brief description of the product |
  | `initial_price` | price | Initial price |
  | `currency` | text | Currency of the product |
  | `availability` | text | Product availability |
  | `reviews_count` | number | Number of reviews |
  | `categories` | array | Product categories |
  | `parent_asin` | text | Parent ASIN of the product |
  | `asin` | text | Unique identifier for each product |
  | `buybox_seller` | text | Seller in the buy box |
  | `number_of_sellers` | number | Number of sellers for the product |
  | `root_bs_rank` | number | Best Sellers Rank |
  | `answered_questions` | number | Number of answered questions |
  | `domain` | url | URL of the product domain |
  | `images_count` | number | Number of images |
  | `url` | url | URL that links directly to the product |
  | `video_count` | number | Number of videos |
  | `image_url` | url | URL that links directly to the product image |
  | `item_weight` | text | Weight of the product |
  | `rating` | number | Product rating |
  | `product_dimensions` | text | Dimensions of the product |
  | `seller_id` | text | Unique identifier for each seller |
  | `date_first_available` | text | Date when the product first became available |
  | `discount` | text | Product discount information |
  | `model_number` | text | Model number of the product |
  | `manufacturer` | text | Manufacturer of the product |
  | `department` | text | Department to which the product belongs |
  | `plus_content` | boolean | Boolean indicating the presence of additional content |
  | `upc` | text | Universal Product Code |
  | `video` | boolean | Boolean indicating the presence of videos |
  | `top_review` | text | Top review for the product |
  | `final_price_high` | price | Highest value of the final price when it is a range |
  | `final_price` | price | Final price of the product |
  | `variations` | array | Details about the same product in different variations |
  | `delivery` | array | Delivery-related information |
  | `features` | array | Product features |
  | `format` | array | Format-related information |
  | `buybox_prices` | object | Product price details |
  | `input_asin` | text | Input ASIN used to trigger the collection |
  | `ingredients` | text | Ingredients of the product, relevant mostly for food products |
  | `origin_url` | url | Original source URL of the product page |
  | `bought_past_month` | number | Number of units bought in the past month |
  | `is_available` | boolean | Indication if the product is still available |
  | `root_bs_category` | text | Best seller root category |
  | `bs_category` | text | Best seller category |
  | `bs_rank` | number | Best seller rank |
  | `badge` | text | Product badge (e.g., #1 Best Seller, Amazon's Choice) |
  | `images` | array | URLs of the product images |
  | `country_of_origin` | text | Country of origin of the product |
  | `product_details` | array | Full product details |
  | `prices_breakdown` | object | Full price breakdown |
  | `unit_price` | object | Price per unit details |
  | `other_sellers_prices` | array | Alternative seller offers with pricing and delivery details |
  | `measurement` | object | Product measurement quantity and unit |
  | `product_rating_object` | object | Object representing the breakdown of product ratings |
  | `sustainability_features` | array | Product sustainability certifications and eco-friendly features |
  | `climate_pledge_friendly` | boolean | Whether the product is Climate Pledge Friendly certified |
  | `coupon` | object | Available coupon discount details |
  | `categories_with_urls` | array | Product category hierarchy with navigation URLs |
  | `description_html` | text | The product's description including HTML line breakers |
  | `sponsered` | boolean | Whether the product listing is sponsored (legacy field) |
  | `fba_sellers_count` | number | Number of Fulfillment by Amazon (FBA) sellers for this product |
  | `fbm_sellers_count` | number | Number of Fulfillment by Merchant (FBM) sellers for this product |
  | `is_amazon_as_seller` | boolean | Whether Amazon is one of the sellers for this product |
  | `publisher_images` | array | Image URLs provided by the publisher or manufacturer |
  | `seller_url` | url | Seller URL |
  | `store_url` | url | Store URL |
  | `coupon_text` | text | Coupon text |
  | `is_sponsored_search_page` | boolean | Indicates whether the product is marked as sponsored on the search page results |
  | `products_in_stock` | number | Number of products in stock |
  | `variant_condition` | text | The condition of a product variant (e.g., New, Renewed, Refurbished - Excellent). |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lwhideng15g8jg63s7.json`](/scrapers/gd_lwhideng15g8jg63s7.json)

## How to scrape Amazon product search

**Dataset ID:** `gd_lwdb4vjm1ehb499uxs`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwdb4vjm1ehb499uxs&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "wireless earbuds", "url": "https://www.amazon.com", "pages_to_search": 1}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "asin": "B0HBWW3958",
      "final_price": 19.97,
      "currency": "USD",
      "rating": 4.8,
      "sponsored": "false",
      "keyword": "wireless earbuds",
      "url": "https://www.amazon.com/Fhumsh-Bluetooth-Headphones-Canceling-Waterproof/dp/B0HBWW3958/ref=sr_1_1?dib=eyJ2IjoiMSJ9.n_qRtmpiBndk1m3mKOID72PJfuCyjFoG2s-QCKILN6E...",
      "name": "Wir***.",
      "initial_price": 249.99,
      "sold": 0
    }
  ]
  ```
</Accordion>

[Full Products Search response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-search-collect-by-url)

### Which output fields does the Amazon product search scraper return?

The Amazon product search scraper (`gd_lwdb4vjm1ehb499uxs`, `collect_by_url`) returns 28 output fields.

<Accordion title="Output fields (28)">
  | Field | Type | Description |
  | - | - | - |
  | `asin` | text | Unique identifier for each product |
  | `url` | url | URL that links directly to the product |
  | `name` | text | Product name |
  | `sponsored` | text | Indicates if the product listing is a sponsored/paid advertisement placement |
  | `initial_price` | number | Initial/original price of the product before any discount |
  | `final_price` | number | Final price of the product after any applicable discount |
  | `currency` | text | Currency code in which the product price is denominated |
  | `sold` | number | Number of times the product was sold |
  | `rating` | number | Average product rating from customer reviews (1-5 scale) |
  | `num_ratings` | number | Total number of customer ratings the product has received |
  | `variations` | array | Details about the same product in different variations (e.g., color, size, style options) |
  | `badge` | text | Product badge displayed on listing (e.g., '#1 Best Seller', 'Amazon's Choice', 'Limited time deal') |
  | `business_type` | text | Store/seller business type badge (e.g., 'Small Business', 'Black-owned business') |
  | `brand` | text | Brand name of the product |
  | `delivery` | array | Delivery-related information including delivery dates, shipping options, and conditions |
  | `keyword` | text | Search keyword/query used to find the product |
  | `image` | url | URL that links directly to the product image |
  | `domain` | url | URL of the Amazon regional domain where the product was listed |
  | `bought_past_month` | number | Number of times this product was bought in the past month (as displayed on the listing) |
  | `page_number` | number | Search result page number on which this product appears |
  | `rank_on_page` | number | Position/rank of the item within the search results page |
  | `is_prime` | boolean | Indicates whether the product is eligible for Amazon Prime shipping |
  | `is_subscribe_and_save` | boolean | Indicates whether the product is eligible for Subscribe & Save discount |
  | `is_coupon` | boolean | Indicates whether the product has an available coupon discount |
  | `sponsored_video` | url | URL of the sponsored video shown on the product listing |
  | `is_banner_product` | boolean | Indicates whether the product is featured in the banner at the top of the search results page |
  | `is_amazon_fresh` | boolean | Indicates whether the product is sold via Amazon Fresh grocery service |
  | `total_results` | number | Approximate total number of products found for the search query (may display as "over X results") |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lwdb4vjm1ehb499uxs.json`](/scrapers/gd_lwdb4vjm1ehb499uxs.json)

## Quick reference: dataset IDs

| Endpoint | Dataset ID | Input format |
| :- | :- | :- |
| Products | `gd_l7q7dkf244hwjntr0` | `amazon.com/dp/{ASIN}` |
| Reviews | `gd_le8e811kzy4ggddlq` | `amazon.com/dp/{ASIN}` |
| Sellers Info | `gd_lhotzucw1etoe5iw1k` | `amazon.com/sp?seller={SELLER_ID}` |
| Products Global | `gd_lwhideng15g8jg63s7` | `amazon.{domain}/dp/{ASIN}` |
| Products Search | `gd_lwdb4vjm1ehb499uxs` | `keyword` + `url` + `pages_to_search` |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# ChatGPT Scraper API
Source: https://docs.brightdata.com/products/scrapers/chatgpt/introduction

Use the Bright Data [ChatGPT Scraper API](https://brightdata.com/products/web-scraper/chatgpt) to extract structured search results, citations and answers. Best for up to 20 inputs per sync request.

Send a prompt, get structured search results back. The Bright Data ChatGPT Scraper API handles proxies, browser automation, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/chatgpt?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 ChatGPT records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send a prompt to the Bright Data ChatGPT Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON with the answer, citations, and sources.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use the `dataset_id` for ChatGPT Search and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data ChatGPT Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/chatgpt/quickstart).

```json theme={null}
{
  "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
  "prompt": "Top hotels in New York",
  "answer_text": "Map data is currently unavailable Aman New York 4.3 Отель 2 450 $ The Plaza Hotel The Carlyle, A Rosewood Hotel 4.5 Отель 1 359 $ The Mark Hotel 4.5 Отель 2...",
  "model": null,
  "web_search_triggered": true,
  "citations": [
    {
      "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
      "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
      "description": "Time Out Worldwide",
      "icon": null
    }
  ],
  "search_sources": [
    {
      "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
      "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
      "snippet": null,
      "rank": 1
    }
  ],
  "prompt_sent_at": "2026-09-06T10:22:47.311Z",
  "answer_html": "<html lang=\"en-US\" dir=\"ltr\" data-theme=\"light\" data-contrast=\"default\" data-build=\"prod-4ec31e730ff961987ab0f9a7e9dd6248f66da3b0\" data-close-image-viewer=\"C...",
  "is_map": true
}
```

## Which capabilities are supported

<CardGroup>
  <Card title="Search with Citations" icon="quote-right" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Get structured answers with source citations, positions, and linked references from ChatGPT web search.
  </Card>

  <Card title="Follow-up Prompts" icon="comments" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Send an additional prompt to get follow-up answers within the same search context.
  </Card>

  <Card title="Shopping and Map Results" icon="store" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Detect when ChatGPT returns shopping product cards or map-based results for location queries.
  </Card>

  <Card title="Web Search Control" icon="globe" href="/products/scrapers/concepts/query-fan-out">
    Use `web_search` to allow or disable live web search and `web_search_triggered` to know whether a search actually ran.
  </Card>
</CardGroup>

## Which dataset ID to use

The ChatGPT Scraper API uses one `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| ChatGPT Search | `gd_m7aof0k82r803d5bjm` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Which other AI answer engines have a scraper

The scraper library also covers five other engines. Each takes a prompt and returns the answer with its citations; each link opens the scraper in the Control Panel, and each country list says where the engine can be targeted.

| Engine | Scraper | Country list |
| :- | :- | :- |
| Perplexity | [Open in the Control Panel](https://brightdata.com/cp/scrapers/browse?domain=perplexity.ai) | [Countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/perplexity_countries.csv) |
| Gemini | [Open in the Control Panel](https://brightdata.com/cp/scrapers/browse?domain=gemini.google.com) | [Countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/gemini_countries.csv), European countries not available |
| Copilot | [Open in the Control Panel](https://brightdata.com/cp/scrapers/browse?domain=copilot.microsoft.com) | [Countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/copilot_countries.csv) |
| Google AI Mode | [Open in the Control Panel](https://brightdata.com/cp/scrapers/browse?domain=google.com) | [Countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/google_aimode_countries.csv) |
| Grok | Currently unavailable | [Countries](https://github.com/brightdata/answer-engines-country-codes/blob/main/grok_countries.csv) |

ChatGPT's own country list is on [GitHub](https://github.com/brightdata/answer-engines-country-codes/blob/main/chatgpt_countries.csv). Web search control differs by engine: ChatGPT and Grok take the `web_search` input, Gemini decides on its own. See [Query fan-out and web search control](/products/scrapers/concepts/query-fan-out).

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live ChatGPT search session. There is no cached or stale data. Processing time varies with prompt complexity, whether web search is enabled and scraper workload. The Bright Data ChatGPT Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously.

### Why do response times change over time?

OpenAI changes how its pages are served, and the Bright Data ChatGPT Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### Can I maintain conversation context across requests?

No. Each request starts a fresh ChatGPT session. There is no memory or context carried over between requests. To ask a follow-up question within a single request, use the `additional_prompt` field.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/chatgpt/quickstart">
    Search ChatGPT with your first prompt in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/chatgpt/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# ChatGPT scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/chatgpt/quickstart

Set up the Bright Data ChatGPT Scraper API and send your first prompt to receive structured JSON with search results and citations in under 5 minutes.

This tutorial shows you how to send a search prompt to ChatGPT and get structured JSON data using the Bright Data ChatGPT Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/chatgpt?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/chatgpt?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **ChatGPT Search endpoint**. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.chatgpt.prompt("Top hotels in New York")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_m7aof0k82r803d5bjm", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://chatgpt.com/", prompt: "Top hotels in New York" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the returned records from `result.data`. It waits up to 120 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data ChatGPT Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of search results, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data ChatGPT Scraper API returns a JSON array with structured search data:

    ```json theme={null}
    [
      {
        "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
        "prompt": "Top hotels in New York",
        "answer_text": "Map data is currently unavailable Aman New York 4.3 Отель 2 450 $ The Plaza Hotel The Carlyle, A Rosewood Hotel 4.5 Отель 1 359 $ The Mark Hotel 4.5 Отель 2...",
        "model": null,
        "web_search_triggered": true,
        "citations": [
          {
            "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
            "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
            "description": "Time Out Worldwide",
            "icon": null
          }
        ],
        "search_sources": [
          {
            "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
            "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
            "snippet": null,
            "rank": 1
          }
        ],
        "prompt_sent_at": "2026-09-06T10:22:47.311Z",
        "answer_html": "<html lang=\"en-US\" dir=\"ltr\" data-theme=\"light\" data-contrast=\"default\" data-build=\"prod-4ec31e730ff961987ab0f9a7e9dd6248f66da3b0\" data-close-image-viewer=\"C...",
        "is_map": true
      }
    ]
    ```

    Each result object includes the answer text, citations with source URLs, and metadata. See the [full response schema](/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt).
  </Step>
</Steps>

You've successfully searched ChatGPT with your first prompt using the Bright Data ChatGPT Scraper API.

## Common questions

### Can I send multiple prompts in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 inputs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"},
  {"url": "https://chatgpt.com/", "prompt": "Best restaurants in Paris"},
  {"url": "https://chatgpt.com/", "prompt": "Things to do in Tokyo"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify that the `url` field is set to `https://chatgpt.com/` and the `prompt` field is not empty. Prompts must be 4,096 characters or fewer.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | `client.scrape.chatgpt.prompt(prompt="Top hotels in New York", web_search=True)`; see the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines list` prints every pipeline name, then run `bdata pipelines <pipeline> "<url>" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/chatgpt/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Search ChatGPT with hundreds of prompts in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# ChatGPT Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/chatgpt/send-first-request

Make synchronous requests to the Bright Data ChatGPT Scraper API with copy-paste examples for search, targeting across 195 countries and follow-up prompts.

This guide shows you how to send synchronous requests to the Bright Data ChatGPT Scraper API. It covers basic search, country-targeted search, and follow-up prompts.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/chatgpt?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/chatgpt/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://chatgpt.com/", "prompt": "Your search prompt here"}]
```

The `url` field is always `https://chatgpt.com/`. The `prompt` field contains your search query.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 inputs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape ChatGPT Search

**Dataset ID:** `gd_m7aof0k82r803d5bjm`

### How to send a basic search

Send a prompt and get a structured answer with citations:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
      "prompt": "Top hotels in New York",
      "answer_text": "Map data is currently unavailable Aman New York 4.3 Отель 2 450 $ The Plaza Hotel The Carlyle, A Rosewood Hotel 4.5 Отель 1 359 $ The Mark Hotel 4.5 Отель 2...",
      "answer_text_markdown": "*   Map data is currently unavailable![](https://images.openai.com/static-rsc-1/3CY66dbP3KXwQ7yDckANu6xIJ-NtQwAsXzoo2jAaWY6HKEHzvQ6cRzvjKFZEX9NpW5wWXY-HzQqfO...",
      "model": null,
      "web_search_triggered": true,
      "is_map": true,
      "shopping_visible": false,
      "citations": [
        {
          "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
          "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
          "description": "Time Out Worldwide",
          "icon": null
        }
      ],
      "search_sources": [
        {
          "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
          "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
          "snippet": null,
          "rank": 1
        }
      ]
    }
  ]
  ```
</Accordion>

### Search with country targeting

Use the `country` field to get location-specific results:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Best local restaurants", "country": "JP"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://chatgpt.com/?q=Best%20local%20restaurants",
      "prompt": "Best local restaurants",
      "answer_text": "Map data is currently unavailable すしレストラン FUJIYAMA TOKYO 新宿東口店 4.7 寿司店 indian restaurant khana (HALAL) 4.4 インド料理店 ￥1,000～2,000 神戸鉄板焼 白秋 4.7 ステーキハウス ￥10,000 以...",
      "model": null,
      "web_search_triggered": false,
      "is_map": true,
      "citations": [],
      "prompt_sent_at": "2026-09-06T10:23:10.445Z",
      "answer_html": "<html lang=\"en-US\" dir=\"ltr\" data-theme=\"light\" data-contrast=\"default\" data-build=\"prod-4ec31e730ff961987ab0f9a7e9dd6248f66da3b0\" data-close-image-viewer=\"C...",
      "country": "JP"
    }
  ]
  ```
</Accordion>

### Search with follow-up prompt

Use the `additional_prompt` field to ask a follow-up question in the same session:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York", "additional_prompt": "Which of these are pet-friendly?"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
      "prompt": "Top hotels in New York",
      "answer_text": "Map data is currently unavailable The St. Regis New York 4.5 Hotel $2,201 Park Hyatt New York 4.6 Hotel $3,191 The Carlyle, A Rosewood Hotel 4.5 Hotel $1,359...",
      "additional_answer_text": "Map data is currently unavailable Park Hyatt New York 4.6 Hotel The Manner 4.6 Resort hotel Refinery Hotel 4.5 Hotel Made Hotel 4.4 Hotel New York Hilton Mid...",
      "model": null,
      "web_search_triggered": true,
      "citations": [
        {
          "url": "https://www.cntraveler.com/gallery/best-hotels-in-new-york-city?utm_source=chatgpt.com",
          "title": "35 Best Hotels in New York City We Won't Shut Up About | Condé Nast Traveler",
          "description": "Condé Nast Traveler",
          "icon": null
        }
      ],
      "prompt_sent_at": "2026-09-06T10:23:07.451Z",
      "answer_html": "<html lang=\"en-US\" dir=\"ltr\" data-theme=\"light\" data-contrast=\"default\" data-build=\"prod-4ec31e730ff961987ab0f9a7e9dd6248f66da3b0\" data-close-image-viewer=\"C...",
      "is_map": true
    }
  ]
  ```
</Accordion>

[Full ChatGPT Search response schema](/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt)

### Which output fields does the ChatGPT Search scraper return?

The ChatGPT Search scraper (`gd_m7aof0k82r803d5bjm`, `collect_by_url`) returns 28 output fields.

<Accordion title="Output fields (28)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | ChatGPT page URL |
  | `prompt` | text | The input prompt |
  | `answer_html` | text | The answer of ChatGPT search |
  | `answer_text` | text | Answer text in plain text |
  | `links_attached` | array | Hyperlinks included in the response text, along with their position and linked words. |
  | `citations` | array | Sources directly referenced in the answer, often linked to specific facts or claims. |
  | `country` | country | Country from which to perform the search |
  | `is_map` | boolean | Indication whether a map package result was generated |
  | `references` | array | Links grouped under the References section |
  | `shopping` | array | Product recommendation cards from ChatGPT's Shopping panel |
  | `shopping_visible` | boolean | Whether the Shopping panel appeared for this answer |
  | `index` | number | The index column lets you assign a unique ID to each crawl request for easy tracking. |
  | `answer_text_markdown` | html2markdown | Answer text in markdown format. |
  | `web_search_triggered` | boolean | Was a web search triggered by ChatGPT when returning the answer |
  | `additional_prompt` | text | The additional\_prompt is a follow-up input sent after receiving the first answer, aiming to clarify, expand, or refine the initial response. The system processes this prompt and returns the result as additional\_answer\_text. |
  | `additional_answer_text` | text | The additional\_answer\_text is the system's response to the additional\_prompt, which follows the initial interaction. It provides additional information, clarification, or a refined answer based on the user's follow-up input. |
  | `map` | array | Map package result |
  | `search_sources` | array | A list of external web pages ChatGPT used to gather information, usually shown at the bottom of the response. |
  | `search_sources_more` | array | A list of external web pages ChatGPT used to gather information, usually shown at the bottom of the response (from "More" partition). |
  | `response_raw` | text | Raw data of ChatGPT's response |
  | `response_raw_additional_prompt` | text | Raw data of ChatGPT's response for additional prompt. |
  | `answer_section_html` | text | The answer's section html |
  | `model` | text | Model used for answer |
  | `web_search_query` | array | Model-generated web search queries (exact strings, in execution order) |
  | `prompt_sent_at` | date | exact prompt timestamp |
  | `answer_text_raw` | text | Original answer\_text as extracted, without trimming or whitespace normalization (may include leading/trailing spaces and newline characters). |
  | `business_locations` | array | Please consider adding new fields, attaching example of JSON we can get for each business location mentioned in answer. Array of business location entities returned when the answer includes local business results. Each entry contains the business ID, coordinates, name, category, address, contact info, ratings, hours, images, and open/closed status. |
  | `ads` | array | Array of advertisement's card data. |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_m7aof0k82r803d5bjm.json`](/scrapers/gd_m7aof0k82r803d5bjm.json)

## Quick reference: dataset ID

| Endpoint | Dataset ID | Input |
| :- | :- | :- |
| ChatGPT Search | `gd_m7aof0k82r803d5bjm` | `url` + `prompt` |

## Input fields

| Field | Required | Description |
| :- | :- | :- |
| `url` | Yes | Always `https://chatgpt.com/` |
| `prompt` | Yes | Search prompt (max 4,096 characters) |
| `country` | No | Country code for location-targeted results |
| `index` | No | Unique tracking ID (number) |
| `require_sources` | No | Return error if no sources found (boolean) |
| `additional_prompt` | No | Follow-up prompt within the same session |
| `web_search` | No | Allow (`true`, the default) or disable (`false`) web search during the run. Read `web_search_triggered` in the response to know whether a search ran; see [Query fan-out and web search control](/products/scrapers/concepts/query-fan-out) |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Search ChatGPT with hundreds of prompts in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Query fan-out and web search control
Source: https://docs.brightdata.com/products/scrapers/concepts/query-fan-out

Use the web_search input to control whether LLM scrapers run a web search and read web_search_triggered (1 = a search ran for the request) to confirm.

Query fan-out is the mechanism Bright Data LLM Scrapers use to control and report external web search activity during a run. Use the `web_search` input to decide whether a web search is allowed, and read the `web_search_triggered` output field to know whether a web search actually occurred.

<Note>
  `web_search` is a **permission**. `web_search_triggered` is the **actual behavior**. They are not the same, set `web_search: true` and the model may still decide not to search; set `web_search: false` and `web_search_triggered` will always return `false`.
</Note>

## Which scrapers support query fan-out

| LLM Scraper | Query fan-out support |
| :- | :- |
| [ChatGPT](/products/scrapers/chatgpt/introduction) | Available |
| Grok | Currently unavailable |

Gemini does not currently expose a `web_search` control. The decision to search the web is made internally by Gemini and cannot be forced or disabled from the scraper input.

## Input: `web_search`

| Field | Type | Required | Default | Meaning |
| :- | :- | :- | :- | :- |
| `web_search` | boolean | No | `true` | Controls whether web search is allowed during the run |

**Values**

* `true` or omitted: web search is allowed. The scraper enables the Web Search button in the LLM UI and the model may choose to use it.
* `false`: web search is disabled. The scraper does not enable the Web Search button, and the model will not trigger a search.

## Output: `web_search_triggered`

| Field | Type | Always returned | Meaning |
| :- | :- | :- | :- |
| `web_search` | boolean | No | Echoes the input value (defaults to `true` if omitted). Does not indicate whether a search actually happened. |
| `web_search_triggered` | boolean | Yes | `true` only if the model actually triggered a web search during the run; `false` otherwise. |

Use `web_search_triggered` when you need to confirm whether the model's answer was grounded in live web results.

## Example: disable web search

The request below passes `web_search: false` to force an offline answer.

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&notify=false&include_errors=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "url": "https://chatgpt.com/",
      "prompt": "Top hotels in New York",
      "country": "",
      "web_search": false,
      "additional_prompt": ""
    }
  ]'
```

**What to expect**

* The response includes `web_search: false`.
* The response includes `web_search_triggered: false` because searching was not allowed.

## How to interpret results

### When `web_search_triggered` is `true`

A response with `web_search_triggered: true` means the model actually ran an external web search during the run. If the response also includes prompt-derived structured fields (for example `is_map: true` with a populated map payload, or `citations`), those fields were produced from live search results.

### Why `map` can be `null` even when search happened

Even if `web_search_triggered: true`, fields like `map` or `citations` can still be empty or `null`. The reason:

* `web_search_triggered` only tells you whether web search **ran**.
* Fields like `map`, `shopping_visible`, and `citations` reflect what the model **chose to output**, which depends on the prompt and the model's final answer format.

Do not use output fields like `map` as proof that web search happened. Use `web_search_triggered` for that.

## Summary

* Set `web_search` on the input to control whether web search is **allowed**.
* Read `web_search_triggered` on the output to know whether web search **actually occurred**.
* Do not rely on prompt-derived output fields (`map`, `citations`, `shopping_visible`) as a signal that a web search ran. Those fields depend on the prompt and the model's response format, not on search activity.

## See also

* [ChatGPT Scraper API introduction](/products/scrapers/chatgpt/introduction)
* [ChatGPT Scraper API endpoints](/products/scrapers/chatgpt/send-first-request)
* [ChatGPT Search by prompt API reference](/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt)
* [AI Scrapers overview](/products/scrapers/chatgpt/introduction)


# Scraper API error codes
Source: https://docs.brightdata.com/products/scrapers/error-codes

Look up Bright Data Scraper API error codes: HTTP 400, 401, 404 and 429 messages with fixes, the 429 IP block rule and record-level errors like dead_page.

This reference lists the errors the Bright Data Scraper API returns, what each one means and what to do about it.

Scraper API errors come in two layers:

* **HTTP errors:** the request itself failed. The API answers with a 4xx status and no job runs
* **Record errors:** the request succeeded, but one input could not be scraped. The failed record carries an `error_code` field inside the results

## What do the Scraper API HTTP errors mean?

The Scraper API returns these HTTP errors from `POST /datasets/v3/trigger` and `POST /datasets/v3/scrape`.

| Status | Message | Meaning | Retry? | What to do |
| - | - | - | - | - |
| 400 | `{"error": "Invalid input provided", "code": "validation_error", "errors": [[FIELD, REASON]]}` | An input field failed validation. `errors` names the field and the reason, for example `["url", "This field must be a valid url"]` | No | Fix the input value named in `errors` and resend |
| 400 | `{"error": "Parser cannot parse input: ...", "code": "parse_error"}` | The request body is not valid JSON | No | Fix the JSON and resend |
| 400 | `No data to trigger` | The request holds no inputs | No | Send at least one input |
| 400 | `Should be at least LIMIT inputs` | The request holds fewer inputs than the scraper requires. Returned by `/trigger` | No | Send at least the number of inputs the message names |
| 401 | `Credentials are missing` | No `Authorization` header was sent | No | Send `Authorization: Bearer YOUR_API_KEY` |
| 401 | `Auth method is not supported` | The `Authorization` header is not in a supported format | No | Send `Authorization: Bearer YOUR_API_KEY` |
| 401 | `Invalid credentials` | The API key is wrong | No | Check the API key and resend |
| 404 | `Collector not found` | The request has no `dataset_id` query parameter | No | Add the `dataset_id` query parameter |
| 404 | `dataset does not exist` | No scraper matches the `dataset_id` | No | Check the `dataset_id` value |
| 429 | `You have too many running jobs for this dataset. Please wait until some of them finish or consider combining multiple inputs into a single request. Running jobs: RUNNING_JOBS>=JOBS_LIMIT` | You exceeded the concurrent job limit of 5,000 active jobs or snapshots | Yes, after waiting | Wait the seconds in the `Retry-After` header, or back off 2, 4, 8, 16 and 32 seconds. See [the 429 block rule](#what-happens-if-i-get-too-many-429-errors) |
| 202 | `Your request is still in progress and cannot be retrieved in this call.` | **Not an error.** A `/scrape` request ran past 1 minute and the job continues asynchronously. The body carries a `snapshot_id` | No | Poll [Monitor progress](/api-reference/scrapers/management-apis/monitor-progress) with the `snapshot_id`, then [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot) |

Unless a row names one endpoint, `/trigger` and `/scrape` return the same message. The `validation_error` and `parse_error` bodies are JSON. Every other message is plain text.

## What happens if I get too many 429 errors?

Bright Data blocks any IP that receives 25 or more 429 responses within 5 minutes. A blocked IP is refused on every API request until [Bright Data support](mailto:support@brightdata.com) clears it.

Treat a 429 as a signal to slow down, not to retry at once:

1. Stop sending new requests as soon as you receive a 429.
2. Wait the number of seconds in the `Retry-After` header. If the header is missing, back off 2, 4, 8, 16 and 32 seconds.
3. Reduce concurrency if 429 responses keep coming.

<Warning>
  Ten or more 429 responses within 5 minutes means you are close to the 25-in-5-minutes block threshold. Reduce the request rate right away.
</Warning>

The retry code is in [Getting a 429 Too Many Requests error?](/products/scrapers/scrapers-library/async-requests#getting-a-429-too-many-requests-error) on the async guide.

## What do Scraper API record errors mean?

A record error means the Scraper API job ran, but one input returned no data. The failed record appears in the results only when the request sets `include_errors=true`. Branch on the `error_code` field, not on the free-text `error` message, because the message text changes as scrapers are updated.

Bright Data does not charge for failed records.

| `error_code` | Meaning |
| - | - |
| `dead_page` | The page does not exist or is no longer available, for example a 404 or a removed product |
| `bucket_rate_limit` | Requests to the target domain are being rate limited |
| `global_rate_limit` | Requests to the target domain are being rate limited |

A `dead_page` record from `POST /datasets/v3/scrape` with `include_errors=true` looks like this. The request itself returns HTTP 200:

```json theme={null}
[
  {
    "timestamp": "2026-09-30T08:37:27.027Z",
    "input": {
      "url": "https://www.amazon.com/dp/B09XXEFFA4",
      "asin": "",
      "zipcode": "",
      "language": ""
    },
    "error": "The navigation resulted in a dead page (404 status code)",
    "error_code": "dead_page"
  }
]
```

The record keeps the original `input`, so you can match the error back to the URL you sent. For the full list of record error codes, see [Scraper Studio error codes](/products/scraper-studio/error-codes).

## Is an empty result an error?

No. An empty result (`[]`) means the job returned no data. It is not an HTTP error. To see why an input returned nothing, resend the request with `include_errors=true` and read the `error_code` on each record.

## Related pages

* [How to scrape in bulk with async requests](/products/scrapers/scrapers-library/async-requests)
* [Scraper async requests reference](/api-reference/rest-api/scraper/asynchronous-requests)
* [Scraper sync requests reference](/api-reference/scrapers/synchronous-requests)
* [Scraper API FAQs](/products/scrapers/scrapers-library/faqs)


# Facebook Scraper API
Source: https://docs.brightdata.com/products/scrapers/facebook/introduction

Extract data from Facebook profiles, pages, posts, marketplace and events across 10 endpoints with the Bright Data [Facebook Scraper API](https://brightdata.com/products/web-scraper/facebook).

Send a Facebook URL, get structured JSON back. The Bright Data Facebook Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/facebook?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 Facebook records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more Facebook URLs to the Bright Data Facebook Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, posts, marketplace, events, and more) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data Facebook Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/facebook/quickstart).

```json theme={null}
{
  "name": "Mark Zuckerberg",
  "url": "https://www.facebook.com/zuck",
  "id": "4",
  "profile_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_tt6&cstp=mx711x711&ctp=s200x200&_nc_cat=...",
  "cover_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?stp=dst-png&cstp=mx820x360&ctp=s820x360&_nc_cat=110&...",
  "location": "Palo Alto, California",
  "city": "Palo Alto"
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    Names, follower counts, bios, verification status, and profile details.
  </Card>

  <Card title="Page Posts" icon="newspaper" href="/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url">
    Posts from Facebook pages by profile URL, including text, reactions, and media.
  </Card>

  <Card title="Posts" icon="image" href="/api-reference/scrapers/social-media-apis/facebook-posts-collect-by-url">
    Individual post data by post URL or posts by group URL.
  </Card>

  <Card title="Marketplace" icon="shop" href="/api-reference/scrapers/social-media-apis/facebook-marketplace-collect-by-url">
    Product listings, prices, seller details, and item descriptions.
  </Card>

  <Card title="Events" icon="calendar" href="/api-reference/scrapers/social-media-apis/facebook-events-collect-by-url">
    Event details including dates, locations, descriptions, and attendance.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/facebook-comments-collect-by-url">
    Comment text, reactions, replies, and commenter details for any post.
  </Card>

  <Card title="Reels" icon="film" href="/api-reference/scrapers/social-media-apis/facebook-reels-collect-by-url">
    Video URLs, view counts, and engagement data from Facebook reels by profile URL.
  </Card>

  <Card title="Company Reviews" icon="star" href="/api-reference/scrapers/social-media-apis/facebook-company-reviews-collect-by-url">
    Business reviews, ratings, and reviewer details from Facebook pages.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each Facebook data type uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| Pages Posts by Profile URL | `gd_lkaxegm826bjpoo9m5` |
| Comments | `gd_lkay758p1eanlolqw8` |
| Posts by group URL | `gd_lz11l67o2cb3r0lkj3` |
| Posts by post URL | `gd_lyclm1571iy3mv57zw` |
| Marketplace | `gd_lvt9iwuh6fbcwmx1a` |
| Profiles | `gd_mf0urb782734ik94dz` |
| Pages and Profiles | `gd_mf124a0511bauquyow` |
| Events | `gd_m14sd0to1jz48ppm51` |
| Reels by profile URL | `gd_lyclm3ey2q6rww027t` |
| Company Reviews | `gd_m0dtqpiu1mbcyc2g86` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data Facebook Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

Facebook changes how its pages are served, and the Bright Data Facebook Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between URL collection and discovery?

**URL collection** scrapes a specific Facebook page you provide (e.g., a profile URL). **Discovery** finds Facebook content matching search criteria (e.g., all posts from a page URL) and scrapes the results. Discovery is accepted on both endpoints. On `/scrape` it usually runs past the 1-minute limit and returns HTTP `202` with a `snapshot_id`, so use the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint for discovery.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/facebook/quickstart">
    Scrape your first Facebook profile in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/facebook/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# Facebook scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/facebook/quickstart

Set up the Bright Data Facebook Scraper API and collect your first profile, page or post as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape a Facebook profile and get structured JSON data using the Bright Data Facebook Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/facebook?hs_signup=1\&utm_source=docs)
* cURL, Python 3, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/facebook?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint** with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.facebook.com/zuck"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_mf0urb782734ik94dz", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.facebook.com/zuck"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.facebook.com/zuck" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    You should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data Facebook Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of profile data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data Facebook Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "name": "Mark Zuckerberg",
        "url": "https://www.facebook.com/zuck",
        "id": "4",
        "profile_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_tt6&cstp=mx711x711&ctp=s200x200&_nc_cat=...",
        "cover_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?stp=dst-png&cstp=mx820x360&ctp=s820x360&_nc_cat=110&...",
        "location": "Palo Alto, California",
        "city": "Palo Alto"
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Facebook profile using the Bright Data Facebook Scraper API.

## Common questions

### Can I scrape multiple profiles in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.facebook.com/zuck"},
  {"url": "https://www.facebook.com/NASA"},
  {"url": "https://www.facebook.com/natgeo"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the Facebook profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.facebook.com/username`.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | Call `client.scrape.<platform>.<endpoint>(url="...")`; the method list is in the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines list` prints every pipeline name, then run `bdata pipelines <pipeline> "<url>" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/facebook/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Facebook Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/facebook/send-first-request

Send synchronous requests to the Bright Data Facebook Scraper API across 9 endpoints with examples for profiles, page posts, marketplace and comments.

This guide shows you how to send a synchronous request to each Bright Data Facebook Scraper API endpoint. It covers profiles, page posts, posts, marketplace listings, and comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/facebook?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/facebook/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.facebook.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape Facebook profiles

**Dataset ID:** `gd_mf0urb782734ik94dz`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "name": "Mark Zuckerberg",
      "url": "https://www.facebook.com/zuck",
      "id": "4",
      "profile_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_tt6&cstp=mx711x711&ctp=s200x200&_nc_cat=...",
      "cover_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?stp=dst-png&cstp=mx820x360&ctp=s820x360&_nc_cat=110&...",
      "location": "Palo Alto, California",
      "city": "Palo Alto"
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url)

### Which output fields does the Facebook profiles scraper return?

The Facebook profiles scraper (`gd_mf0urb782734ik94dz`, `collect_by_url`) returns 11 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | URL |
| `name` | text | The name of the person |
| `id` | text | The Facebook profile ID |
| `profile_photo` | image | The profile photo |
| `cover_photo` | image | The profile's cover photo |
| `work` | array | The working places of the profile |
| `college` | array | College data of the profile |
| `high_school` | array | High school data of the profile |
| `photos` | array | The profile's photos |
| `location` | text | The location where the profile is from |
| `city` | text | The city where the profile is from |

Machine-readable version with the input schema: [`/scrapers/gd_mf0urb782734ik94dz.json`](/scrapers/gd_mf0urb782734ik94dz.json)

## How to scrape Facebook page posts

**Dataset ID:** `gd_lkaxegm826bjpoo9m5`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkaxegm826bjpoo9m5&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/reel/28631238109803230/",
      "num_comments": 82,
      "date_posted": "2026-09-04T15:07:02.000Z",
      "post_id": "1620874212741282",
      "user_url": "https://www.facebook.com/NASA",
      "user_username_raw": "NAS***n",
      "content": "AvGeeks, assemble!\n\nMAX POWER, America’s newest and most exciting aerospace technology expo and air show, is touching down in Florida on Nov. 7–8.\n\nJUST CONF...",
      "num_shares": 62,
      "page_name": "NASA - National Aeronautics and Space Administration",
      "profile_id": "100044561550831"
    }
  ]
  ```
</Accordion>

[Full Page Posts response schema](/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url)

### Which output fields does the Facebook page posts scraper return?

The Facebook page posts scraper (`gd_lkaxegm826bjpoo9m5`, `collect_by_url`) returns 52 output fields.

<Accordion title="Output fields (52)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | Facebook post URL |
  | `post_id` | text | Unique identifier for each Facebook post |
  | `user_url` | url | Unique identifier for each Facebook post |
  | `user_username_raw` | text | Username of the user who posted the content |
  | `content` | text | Text or media content of the post |
  | `date_posted` | date | Date and time when the post was published |
  | `hashtags` | array | Hashtags used in the post |
  | `num_comments` | number | Number of comments on the post |
  | `num_shares` | number | Number of shares of the post |
  | `num_likes_type` | object | Type of likes received: The data point "count\_reactions\_type" contains all reactions received. |
  | `page_name` | text | Name of the Facebook page where the post was published |
  | `profile_id` | text | Unique identifier for the user's profile |
  | `page_intro` | text | Introduction or description of the Facebook page |
  | `page_category` | text | Category of the Facebook page |
  | `page_logo` | image | Logo of the Facebook page |
  | `page_external_website` | text | External website associated with the Facebook page |
  | `page_likes` | number | Number of likes on the Facebook page |
  | `page_followers` | number | Number of followers of the Facebook page |
  | `page_is_verified` | boolean | Verification status of the Facebook page |
  | `original_post` | object | Indicates if the post is original or a repost |
  | `attachments` | array | Media attachments included in the post |
  | `other_posts_url` | array | Web address of other posts by the same user |
  | `post_external_link` | url | External link included in the post |
  | `post_external_title` | text | Title of the external link |
  | `post_external_image` | url | Post external link image |
  | `page_url` | url | Web address of the Facebook page |
  | `header_image` | image | Header image of the Facebook page |
  | `avatar_image_url` | text | The URL of the avatar image of the Facebook page |
  | `profile_handle` | text | The handle or username of the Facebook page |
  | `has_handshake` | text | Indicates if the post has a handshake |
  | `is_sponsored` | boolean | Indicates whether the post is sponsored or not |
  | `sponsor_name` | text | The name of the sponsor if the post is sponsored |
  | `shortcode` | text | The shortcode of the post URL |
  | `video_view_count` | number | The number of views if the post contains a video |
  | `likes` | number | The number of likes on the post |
  | `post_image` | image | post image url if exists |
  | `post_type` | text | The type of the post |
  | `following` | number | Number of profiles following |
  | `link_description_text` | text | The text that is visible under the link title |
  | `count_reactions_type` | array | Type of reactions received |
  | `is_page` | boolean | Is the post from a page or a profile |
  | `page_phone` | text | Public phone number listed on the page |
  | `page_email` | text | Public email address listed on the page |
  | `page_creation_time` | date | Date the page was created |
  | `page_reviews_score` | text | Average page review score |
  | `page_reviewers_amount` | number | Total number of page reviewers |
  | `page_price_range` | text | Price range label shown on the page |
  | `about` | array | Key-value pairs extracted from the page’s About section |
  | `active_ads_urls` | array | Links to the page’s active ads in Facebook Ad Library |
  | `delegate_page_id` | text | ID of the page shown as responsible for this page |
  | `privacy_and_legal_info` | text | The privacy and legal info of the profile |
  | `play_count` | number | Represents the number of times the video started playing (or was clicked to play) |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lkaxegm826bjpoo9m5.json`](/scrapers/gd_lkaxegm826bjpoo9m5.json)

## Posts by post URL

**Dataset ID:** `gd_lyclm1571iy3mv57zw`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm1571iy3mv57zw&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl",
      "num_comments": 83,
      "date_posted": "2026-09-02T20:52:09.000Z",
      "post_id": "1619357056226331",
      "user_url": "https://www.facebook.com/NASA",
      "user_username_raw": "NAS***n",
      "content": "Red Moon over Louisiana\n\nOn the night of Aug. 27-28, the full moon slipped through Earth's shadow, creating a near-total lunar eclipse for skywatchers in the...",
      "num_shares": 164,
      "profile_id": "100044561550831",
      "page_logo": "https://scontent-nrt6-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s200x200&_nc_cat=1&ccb=..."
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/facebook-posts-collect-by-url)

### Which output fields does the Facebook posts by post URL scraper return?

The Facebook posts by post URL scraper (`gd_lyclm1571iy3mv57zw`, `collect_by_url`) returns 38 output fields.

<Accordion title="Output fields (38)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | URL |
  | `post_id` | text | Unique identifier for each Facebook post |
  | `user_url` | url | Unique identifier for each Facebook post |
  | `user_username_raw` | text | Username of the user who posted the content |
  | `content` | text | Text or media content of the post |
  | `date_posted` | date | Date and time when the post was published |
  | `hashtags` | array | Hashtags used in the post |
  | `num_comments` | number | Number of comments on the post |
  | `num_shares` | number | Number of shares of the post |
  | `num_likes_type` | array | Type of likes received (e.g., reactions, thumbs-up) |
  | `profile_id` | text | Unique identifier for the user's profile |
  | `page_logo` | url | Logo of the Facebook page |
  | `page_likes` | number | Number of likes on the Facebook page |
  | `page_followers` | number | Number of followers of the Facebook page |
  | `page_is_verified` | boolean | Verification status of the Facebook page |
  | `original_post` | object | Indicates if the post is original or a repost |
  | `attachments` | array | Attachments |
  | `post_external_link` | url | External link included in the post |
  | `post_external_title` | text | Title of the external link |
  | `page_url` | url | Web address of the Facebook page |
  | `header_image` | url | Header image of the Facebook page |
  | `avatar_image_url` | text | The URL of the avatar image of the Facebook page |
  | `profile_handle` | text | The handle or username of the Facebook page |
  | `has_handshake` | text | Indicates if the post has a handshake |
  | `is_sponsored` | boolean | Indicates whether the post is sponsored or not |
  | `sponsor_name` | text | The name of the sponsor if the post is sponsored |
  | `shortcode` | text | The shortcode of the post URL |
  | `video_view_count` | number | The number of views if the post contains a video |
  | `likes` | number | The number of likes on the post |
  | `post_image` | url | post image url if exists |
  | `post_type` | text | The type of the post |
  | `user_handle` | text | User handle |
  | `play_count` | number | Play count |
  | `video_title` | text | Video title |
  | `marketplace_price` | price | Price of the item from market place. This value is relevant for marketplace items that were shared in groups. |
  | `delegate_page_id` | text | ID of the page delegated as “responsible for this Page” |
  | `marketplace_is_sold` | text | Indicates whether the product has been sold, applicable only to marketplace posts |
  | `comments` | array | Comments of the post |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lyclm1571iy3mv57zw.json`](/scrapers/gd_lyclm1571iy3mv57zw.json)

## How to scrape Facebook Marketplace

**Dataset ID:** `gd_lvt9iwuh6fbcwmx1a`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvt9iwuh6fbcwmx1a&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/marketplace/item/123456789"}]'
```

<Accordion title="Example response (illustrative, not captured)">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/123456789",
      "title": "Vintage Coffee Table",
      "price": "$150",
      "location": "San Francisco, CA",
      "seller_name": "John Doe",
      "description": "Beautiful mid-century modern coffee table..."
    }
  ]
  ```
</Accordion>

[Full Marketplace response schema](/api-reference/scrapers/social-media-apis/facebook-marketplace-collect-by-url)

### Which output fields does the Facebook Marketplace scraper return?

The Facebook Marketplace scraper (`gd_lvt9iwuh6fbcwmx1a`, `collect_by_url`) returns 22 output fields.

<Accordion title="Output fields (22)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The direct URL of the Facebook Marketplace listing page |
  | `title` | text | The title of the listing as posted by the seller |
  | `initial_price` | number | The original listed price of the item before any discounts |
  | `final_price` | number | The current or discounted price of the item |
  | `currency` | text | The currency in which the price is listed |
  | `product_id` | text | The unique identifier assigned to the listing by Facebook Marketplace. |
  | `breadcrumbs` | array | A list of navigation breadcrumb items representing the category hierarchy of the listing |
  | `condition` | text | The condition of the listed item as reported by the seller |
  | `description` | text | The full textual description of the listing, as written by the seller |
  | `location` | text | The general location |
  | `country_code` | text | The two-letter ISO 3166-1 alpha-2 country code |
  | `root_category` | text | The root category the listing belongs to on Facebook Marketplace |
  | `images` | array | A list of URLs pointing to the listing's product images uploaded by the seller |
  | `seller_description` | text | A short bio or description from the seller's Facebook Marketplace profile |
  | `color` | text | The color of the listed item, if applicable and provided by the seller |
  | `brand` | text | The brand or manufacturer of the listed item, if applicable |
  | `videos` | array | A list of URLs pointing to any video content uploaded by the seller as part of the listing |
  | `profile_id` | text | The unique Facebook profile ID of the seller who posted the listing |
  | `listing_date` | date | The date and time when the listing was originally posted on Facebook Marketplace |
  | `car_miles` | number | The mileage of the vehicle as reported by the seller. Only relevant for car/vehicle listings |
  | `is_sold` | boolean | Indicates whether the product is sold |
  | `transmission` | text | Transmission type shown in vehicle details. Only relevant for car/vehicle listings |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lvt9iwuh6fbcwmx1a.json`](/scrapers/gd_lvt9iwuh6fbcwmx1a.json)

## How to scrape Facebook comments

**Dataset ID:** `gd_lkay758p1eanlolqw8`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkay758p1eanlolqw8&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl?locale=en_US",
      "comment_text": "Rayleigh scattering filtering out blue light explains that red moon color same physics as sunsets nice that they captured it from michoud where sls rockets a...",
      "post_id": "pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl",
      "post_url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl?locale=en_US",
      "comment_id": "Y29tbWVudDoxNjE5MzU3MDU2MjI2MzMxXzEwNjQ1NzgzOTMyMjAzNTQ=",
      "user_name": "Tus***a",
      "user_id": "615***",
      "date_created": "2026-09-03T00:51:39.000Z",
      "num_likes": 2,
      "num_replies": 0
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/facebook-comments-collect-by-url)

### Which output fields does the Facebook comments scraper return?

The Facebook comments scraper (`gd_lkay758p1eanlolqw8`, `collect_by_url`) returns 22 output fields.

<Accordion title="Output fields (22)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The URL of the page or post containing the comments |
  | `post_id` | text | Unique identifier for each post |
  | `post_url` | url | URL of the specific post |
  | `comment_id` | text | Unique identifier for each comment |
  | `user_name` | text | Name of the user who made the comment |
  | `user_id` | text | Unique identifier for each user |
  | `user_url` | url | URL of the user's profile |
  | `date_created` | date | Date and time when the comment was created |
  | `comment_text` | text | The actual text content of the comment |
  | `num_likes` | number | Number of likes or reactions received by the comment |
  | `num_replies` | number | Number of direct replies to the comment |
  | `attached_files` | array | Any files or attachments associated with the comment |
  | `video_length` | number | Length of video content, if applicable |
  | `source_type` | text | Type of source (e.g., Facebook, external link) |
  | `subtype` | text | Subcategory or specific type of the post or comment |
  | `type` | text | General category of the post or comment |
  | `commentator_profile` | url | |
  | `comment_link` | url | |
  | `reply` | boolean | |
  | `parent_comment_id` | text | Parent comment id |
  | `commentator_profile_url` | url | The URL of the profile picture of the commentator |
  | `attached_images` | array | Any images associated with the comment |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lkay758p1eanlolqw8.json`](/scrapers/gd_lkay758p1eanlolqw8.json)

## Quick reference: dataset IDs

| Endpoint | Dataset ID | URL pattern |
| :- | :- | :- |
| Pages Posts by Profile URL | `gd_lkaxegm826bjpoo9m5` | `facebook.com/{page_name}` |
| Comments | `gd_lkay758p1eanlolqw8` | `facebook.com/{user}/posts/{post_id}` |
| Posts by group URL | `gd_lz11l67o2cb3r0lkj3` | `facebook.com/groups/{group_id}` |
| Posts by post URL | `gd_lyclm1571iy3mv57zw` | `facebook.com/{user}/posts/{post_id}` |
| Marketplace | `gd_lvt9iwuh6fbcwmx1a` | `facebook.com/marketplace/item/{item_id}` |
| Profiles | `gd_mf0urb782734ik94dz` | `facebook.com/{username}` |
| Pages and Profiles | `gd_mf124a0511bauquyow` | `facebook.com/{page_or_profile}` |
| Events | `gd_m14sd0to1jz48ppm51` | `facebook.com/events/{event_id}` |
| Reels by profile URL | `gd_lyclm3ey2q6rww027t` | `facebook.com/{username}` |
| Company Reviews | `gd_m0dtqpiu1mbcyc2g86` | `facebook.com/{company_page}` |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Google Scraper API
Source: https://docs.brightdata.com/products/scrapers/google/introduction

Extract structured data from Google Maps, Shopping, SERP, Flights, Hotels and more using the Bright Data Google Scraper API. Handles up to 100 organic results.

Send a Google URL or a keyword, get structured JSON back. The Bright Data Google Scraper API covers Maps, Shopping, Search results, AI Mode Search, Flights and Hotels with consistent request and response shapes.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/google?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 Google records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more Google URLs, keywords or structured inputs to the Bright Data Google Scraper API. Bright Data handles proxies, CAPTCHAs and parsing, then returns clean JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the Google product and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single Google Maps place record returned by the Bright Data Google Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/google/quickstart).

```json theme={null}
{
  "place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ",
  "name": "The***s",
  "address": "5155 Peachtree Pkwy NW, Peachtree Corners, GA 30092, United States",
  "category": "Shopping mall",
  "rating": 4.6,
  "reviews_count": 5066,
  "url": "https://www.google.com/maps/place/The+Forum+Peachtree+Corners/@33.9808771,-84.2175823,17z/data=!3m1!4b1!4m6!3m5!1s0x88f5a1a57295954b:0xc4368b9aac3c4d1d!8m2!3...",
  "country": "United States",
  "description": "Outdoor mall with a European feel & a collection of upscale chains & boutiques, plus restaurants.",
  "main_image": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmZ8YyHocxqtXw40FHlo2WbKu1zLCxcFQrAWkwM9zj_O76dd_9Mpl-H9rjqS7GjsehkGXvpMA4xDse4qi1ysYEJTzwMpwLOqB3BGwkGap8c1-..."
}
```

## Supported data types

<CardGroup>
  <Card title="Google Maps" icon="map-location-dot" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Places, reviews, ratings, photos and community stats. Collect by URL or discover by CID, place ID or geographic location.
  </Card>

  <Card title="Google Maps Reviews" icon="star" href="/api-reference/scrapers/search-engines-apis/google-maps-reviews-collect-by-url">
    Full review text, ratings and reviewer metadata, filtered by a configurable lookback window.
  </Card>

  <Card title="Google Shopping" icon="bag-shopping" href="/api-reference/scrapers/search-engines-apis/google-shopping-collect-by-url">
    Product listings, pricing, merchants and specifications. Collect by URL or discover by keyword.
  </Card>

  <Card title="Google Shopping Search US" icon="store" href="/api-reference/scrapers/search-engines-apis/google-shopping-products-search-us-collect-by-url">
    US-focused product search results with expanded merchant and pricing coverage.
  </Card>

  <Card title="Google SERP 100 Results" icon="magnifying-glass" href="/products/serp-api/get-top-100-google-results">
    Up to 100 organic results per query with language, device and geographic targeting.
  </Card>

  <Card title="Google AI Mode Search" icon="robot" href="/api-reference/scrapers/search-engines-apis/google-ai-mode-search-collect-by-url">
    Answers and citations from Google's AI-powered search experience.
  </Card>

  <Card title="Google Flights" icon="plane" href="/api-reference/scrapers/search-engines-apis/google-flights-collect-by-url">
    Flight options, pricing and itineraries. Collect by URL or discover by route and dates.
  </Card>

  <Card title="Google Hotels" icon="bed" href="/api-reference/scrapers/search-engines-apis/google-hotel-collect-by-url">
    Hotel rates, availability and amenities. Collect by URL, filter URL or search parameters.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each Google product uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Product | Dataset ID |
| :- | :- |
| Google Maps full info | `gd_m8ebnr0q2qlklc02fz` |
| Google Maps Reviews | `gd_luzfs1dn2oa0teb81` |
| Google Shopping | `gd_ltppk50q18kdw67omz` |
| Google Shopping products search US | `gd_m31f2k0d2m1bah4f3b` |
| Google SERP 100 Results | `gd_mfz5x93lmsjjjylob` |
| Google AI Mode Search | `gd_mcswdt6z2elth3zqr2` |
| Google Flights | `gd_mhng7wen1rw0a3gvpf` |
| Google Hotels | `gd_mg3gjfmg12tc2n5d4d` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape against Google. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data Google Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

Google changes how its pages are served, and the Bright Data Google Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between Collect and Discover?

**Collect by URL** scrapes a specific Google page you provide, such as a single Maps place, a Shopping product or a SERP URL. **Discover** finds Google records matching search criteria such as a keyword, a CID or a geographic area, then scrapes the results. Discovery is most useful via async requests when you don't know the exact URLs up front.

### Can I target a specific country or language?

Yes. Most endpoints accept a `country` parameter (ISO 3166-1 alpha-2 code), and the SERP 100 endpoint also accepts `language` and `uule` for geographic targeting. See each endpoint's reference page for the full parameter list.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/google/quickstart">
    Scrape your first Google Maps place in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/google/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Google scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/google/quickstart

Set up the Bright Data Google Scraper API and collect your first Google Maps place as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape a Google Maps place and get structured JSON data using the Bright Data Google Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/google?hs_signup=1\&utm_source=docs)
* cURL, Python 3 or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/google?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Google Maps, Collect by URL** endpoint with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_m8ebnr0q2qlklc02fz", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    You should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data Google Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of result data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data Google Scraper API returns a JSON array with structured place data:

    ```json theme={null}
    [
      {
        "place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ",
        "name": "The***s",
        "address": "5155 Peachtree Pkwy NW, Peachtree Corners, GA 30092, United States",
        "category": "Shopping mall",
        "rating": 4.6,
        "reviews_count": 5066,
        "open_hours": {
          "Sunday": "12–6 PM",
          "Saturday": "10 AM–9 PM",
          "Friday": "10 AM–9 PM",
          "Thursday": "10 AM–9 PM",
          "Wednesday": "10 AM–9 PM",
          "Tuesday": "10 AM–9 PM",
          "Monday": "10 AM–9 PM"
        },
        "url": "https://www.google.com/maps/place/The+Forum+Peachtree+Corners/@33.9808771,-84.2175823,17z/data=!3m1!4b1!4m6!3m5!1s0x88f5a1a57295954b:0xc4368b9aac3c4d1d!8m2!3...",
        "country": "United States",
        "description": "Outdoor mall with a European feel & a collection of upscale chains & boutiques, plus restaurants."
      }
    ]
    ```

    Each place object includes location details, ratings, hours, photos and contact info. See the [full response schema](/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Google Maps place using the Bright Data Google Scraper API.

## Common questions

### Can I scrape multiple places in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 inputs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches or for discovery by keyword, CID or location, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"},
  {"url": "https://www.google.com/maps/place/Central+Park"},
  {"url": "https://www.google.com/maps/place/Times+Square"}
]
```

### Can I scrape Google Shopping or SERP instead?

Yes. Swap the `dataset_id` for the product you need. For example, Google Shopping Collect by URL uses `gd_ltppk50q18kdw67omz`, and Google SERP 100 uses `gd_mfz5x93lmsjjjylob`. See [Send your first request](/products/scrapers/google/send-first-request) for working examples of every endpoint.

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the Google URL is publicly accessible and correctly formatted. For Google Maps, the URL should follow the pattern `https://www.google.com/maps/place/...`. For Shopping and SERP, verify the URL works in an incognito browser window.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | Call `client.scrape.<platform>.<endpoint>(url="...")`; the method list is in the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines list` prints every pipeline name, then run `bdata pipelines <pipeline> "<url>" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/google/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape thousands of places or run discovery in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Google Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/google/send-first-request

Send synchronous requests to every Bright Data Google Scraper API endpoint with copy-paste examples for Maps, Reviews, Shopping, SERP, AI Mode, Flights and Hotels.

This guide shows you how to send a synchronous request to each Bright Data Google Scraper API endpoint. It covers Maps, Reviews, Shopping, SERP, AI Mode, Flights and Hotels.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/google?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/google/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.google.com/..."}]
```

The only things that change between endpoints are the `dataset_id`, the optional discovery query parameters and the input shape.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 inputs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## Google Maps, Collect by URL

Scrape a specific Google Maps place by its URL.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_m8ebnr0q2qlklc02fz", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ"}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ" }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url)

### Which output fields does the Google Maps scraper return?

The Google Maps scraper (`gd_m8ebnr0q2qlklc02fz`, `collect_by_url`) returns 39 output fields.

<Accordion title="Output fields (39)">
  | Field | Type | Description |
  | - | - | - |
  | `place_id` | text | Unique identifier for the place on Google Maps |
  | `url` | url | URL pointing to the business on Google Maps |
  | `country` | text | The country where the business is located |
  | `name` | text | The name of the business |
  | `category` | text | The category or type of the business |
  | `address` | text | The physical address of the business |
  | `description` | text | A detailed description of the business |
  | `business_details` | array | A list of structured key-value attributes providing additional details about the business (e.g., accessibility, payment options, amenities) |
  | `open_hours` | object | Operating hours of the business for each day of the week |
  | `reviews_count` | number | The total number of reviews for the business |
  | `rating` | number | The average rating given by customers |
  | `main_image` | url | URL or identifier of the main image associated with the business |
  | `lat` | number | Latitude coordinate of the business location |
  | `lon` | number | Longitude coordinate of the business location |
  | `services_provided` | array | List of services provided by the business |
  | `hotel_amenities` | array | Amenities offered by a hotel-type business |
  | `hotel_star_ratings` | text | Star ratings for hotels |
  | `open_website` | text | A link or indication of whether the business has a website that can be visited |
  | `phone_number` | text | The contact phone number for the business |
  | `permanently_closed` | boolean | Indicates whether the business has been permanently closed |
  | `photos_and_videos` | array | A list of URLs pointing to photos and videos associated with the business |
  | `people_also_search` | array | A list of related businesses that users frequently searched for alongside this business |
  | `web_results` | array | A list of web search results related to the business, including external links and previews |
  | `reservation_link` | url | A URL to an external reservation or booking platform for the business |
  | `questions_answers` | array | A list of community questions and their answers about the business |
  | `top_reviews` | array | A list of the most prominent customer reviews for the business, including reviewer details and ratings |
  | `reviews_snippets` | array | A list of short review snippets displayed for the business, each including the reviewer's name, image, and a text excerpt |
  | `directory_categories` | array | A list of directory categories associated with the business, including the category name and count of businesses within each |
  | `directory_locations` | array | A list of other business locations from the same chain or directory, with ratings, review counts, and category details |
  | `popular_times` | array | A list of popular visiting times for the business, broken down by day of the week and hour, with relative busyness percentages |
  | `cid_location` | text | The Google Customer ID (CID) associated with the specific location of the business |
  | `is_claimed` | boolean | Indicates whether the business owner has claimed and verified this Google Maps listing |
  | `fid_location` | text | The Feature ID (FID) associated with the business location, used internally by Google Maps |
  | `review_distribution` | object | The distribution of customer reviews broken down by star rating (1 through 5) |
  | `all_categories` | array | A complete list of all business categories assigned to the business on Google Maps |
  | `country_code` | text | The ISO 3166-1 alpha-2 country code of the country where the business is located |
  | `cid` | text | The Google Customer ID (CID) uniquely identifying the business on Google Maps |
  | `temporarily_closed` | boolean | Indicates whether the business is temporarily closed |
  | `category_index` | object | Indexing metadata for the business category, including Google Category IDs and Knowledge Graph entity references |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_m8ebnr0q2qlklc02fz.json`](/scrapers/gd_m8ebnr0q2qlklc02fz.json)

## Google Maps, Discover by CID

Find a Google Maps place using its Customer ID (CID) value.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=cid" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"CID": "14138641576607108381"}], "limit_per_input": 10}'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-discover-by-cid)

## Google Maps, Discover by place\_id

Find a place using its Google Maps place ID.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=place_id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ"}], "limit_per_input": 10}'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-discover-by-place-id)

## Google Maps, Discover by location

Find places near a geographic point using latitude, longitude, zoom level and a search keyword.

**Dataset ID:** `gd_m8ebnr0q2qlklc02fz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&format=json&type=discover_new&discover_by=location" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"country": "US", "lat": 40.7484, "long": -73.9857, "zoom_level": 14, "keyword": "coffee shop"}], "limit_per_input": 10}'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-discover-by-location)

## Google Maps Reviews, Collect by URL

Scrape reviews for a Google Maps place, optionally limiting to reviews posted within the last N days.

**Dataset ID:** `gd_luzfs1dn2oa0teb81`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_luzfs1dn2oa0teb81&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ", "days_limit": 30}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_luzfs1dn2oa0teb81", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.google.com/maps/place/?q=place_id:ChIJS5WVcqWh9YgRHU08rJqLNsQ", "days_limit": 30}],
  )

  print(response.json())
  ```
</CodeGroup>

[Full schema](/api-reference/scrapers/search-engines-apis/google-maps-reviews-collect-by-url)

### Which output fields does the Google Maps reviews scraper return?

The Google Maps reviews scraper (`gd_luzfs1dn2oa0teb81`, `collect_by_url`) returns 26 output fields.

<Accordion title="Output fields (26)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | Link to the Google Maps page of the place |
  | `place_id` | text | Unique identifier for the place |
  | `place_name` | text | Name of the place |
  | `country` | text | Country of the place |
  | `address` | text | Full address of the place |
  | `review_id` | text | Unique identifier for the review |
  | `reviewer_name` | text | Name of the reviewer |
  | `reviews_by_reviewer` | number | Total reviews by the reviewer |
  | `photos_by_reviewer` | text | Total photos by the reviewer |
  | `reviewer_url` | url | Link to the reviewer's profile |
  | `local_guide` | boolean | Indicates if the reviewer is a Local Guide |
  | `review_rating` | number | Star rating given |
  | `review` | text | Text of the review |
  | `review_date` | date | Date of the review |
  | `number_of_likes` | number | Likes given to the review |
  | `response_of_owner` | text | Owner's response to the review |
  | `response_date` | date | Date of owner's response |
  | `photos` | array | Photos included with the review |
  | `review_details` | array | |
  | `profile_pic_url` | url | |
  | `place_general_rating` | number | The general rating of the place |
  | `overall_place_riviews` | number | The number of overall reviews given to a place by users |
  | `questions_answers` | array | |
  | `fid_location` | text | |
  | `category` | text | The category or type of the business |
  | `cid` | text | Customer ID |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_luzfs1dn2oa0teb81.json`](/scrapers/gd_luzfs1dn2oa0teb81.json)

## Google Shopping, Collect by URL

Scrape a Google Shopping product page by its URL, with optional country targeting.

**Dataset ID:** `gd_ltppk50q18kdw67omz`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppk50q18kdw67omz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/search?ibp=oshop&q=JLab+Studio+2+Wireless+Headphones&prds=imageDocid:5923580954857402377,catalogid:13340055750063076763,productid:10724334734735144389,headlineOfferDocid:3470074678539476160,gpcid:9062160688233355186,mid:576462881232491926,pvt:hg,rds:PC_9062160688233355186|PROD_PC_9062160688233355186&pvorigin=25&hl=en&gl=us&shem=damc,pvflt,shrtsdl&shndl=37&udm=28&source=sh/x/prdct/hdr/m1/1", "country": "US"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-shopping-collect-by-url)

### Which output fields does the Google Shopping scraper return?

The Google Shopping scraper (`gd_ltppk50q18kdw67omz`, `collect_by_url`) returns 43 output fields.

<Accordion title="Output fields (43)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The URL or link to the product |
  | `product_id` | text | Unique identifier for the product |
  | `title` | text | Title or name of the product |
  | `product_description` | array | Description of the product |
  | `rating` | number | Average rating of the product |
  | `reviews_count` | number | Number of ratings or reviews for the product |
  | `images` | array | Images of the product |
  | `variations` | array | Product variations |
  | `tags` | array | Tags associated with the product |
  | `product_details` | text | Additional details about the product |
  | `amount_of_stars` | object | Distribution of star ratings |
  | `seller_name` | text | Name of the seller or vendor |
  | `delivery_price` | text | Price for delivery. |
  | `item_price` | text | Price of the item |
  | `total_price` | text | Total price including all costs |
  | `currency` | text | Currency code in which the product prices are denominated (e.g., USD, EUR, GBP) |
  | `product_specifications` | array | Specifications of the product |
  | `related_items` | array | Related items |
  | `country` | text | Country code or name where the product is being sold or where the listing was scraped from |
  | `buying_options` | array | The buying options of the product across different sellers, each with seller name, URL, price, and currency |
  | `variant_id` | text | Variant identifier, derived from product\_id (no separate variant ID in Google Shopping) |
  | `description` | text | Product description text, derived from product\_description array joined into single text, or from product\_details |
  | `product_category` | text | Product category path as text (not available in Google Shopping) |
  | `category_tree` | array | NAI-formatted category tree with name/url objects (not available in Google Shopping) |
  | `brand` | text | Brand name, extracted from product\_specifications where specification\_name='Brand' |
  | `image_url` | text | Main product image URL, derived from first element of images array |
  | `price` | price | Product price, parsed from item\_price text (remove \$ and extra text) |
  | `sale_price` | price | Sale/discounted price (not available in Google Shopping - no separate sale price) |
  | `availability` | text | Product availability status: default to 'in\_stock' for listed products |
  | `availability_date` | text | Expected delivery/availability date, extracted from delivery\_price text if present |
  | `group_id` | text | Group identifier for product variants, derived from product\_id |
  | `listing_has_variations` | boolean | Indicates if the product listing has multiple variations, derived from variations array |
  | `variant_attributes` | array | Current variant attributes for this product, derived from variations with variation\_name→name, variation\_value→value mapping |
  | `nai_variants` | array | variant data grouped by variant type, restructured from variations array |
  | `store_name` | text | Name of the store/seller, derived from seller\_name |
  | `seller_url` | text | URL to the seller's product page, extracted from first seller\_url in buying\_options array |
  | `seller_privacy_policy` | text | URL to the seller's privacy policy |
  | `seller_tos` | text | URL to the seller's terms of service |
  | `return_window` | number | Number of days allowed for returns, parsed from return\_policy text |
  | `target_countries` | array | List of country codes where product is available, derived from country wrapped in array |
  | `store_country` | text | Country code where the store is located, derived from country |
  | `category_urls` | array | List of category URLs (not available in Google Shopping) |
  | `reviews` | array | Review entries from customers for the product |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_ltppk50q18kdw67omz.json`](/scrapers/gd_ltppk50q18kdw67omz.json)

## Google Shopping, Discover by keyword

Find Google Shopping products matching a search term, with optional country targeting.

**Dataset ID:** `gd_ltppk50q18kdw67omz`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppk50q18kdw67omz&format=json&type=discover_new&discover_by=keyword" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": [{"keyword": "wireless headphones", "country": "US"}], "limit_per_input": 10}'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-shopping-discover-by-keyword)

## Google Shopping Products Search US, Collect by URL

US-focused Google Shopping search result scraper.

**Dataset ID:** `gd_m31f2k0d2m1bah4f3b`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m31f2k0d2m1bah4f3b&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/search?tbm=shop&q=wireless+headphones"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-shopping-products-search-us-collect-by-url)

### Which output fields does the Google Shopping products search US scraper return?

The Google Shopping products search US scraper (`gd_m31f2k0d2m1bah4f3b`, `collect_by_url`) returns 15 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | The URL of the product listing page |
| `product_id` | text | Unique identifier for the product |
| `title` | text | The product title |
| `final_price` | number | The final price after discounts or promotions |
| `initial_price` | number | The original price before discounts |
| `currency` | text | The currency of the product’s price |
| `rating` | number | The average customer rating of the product |
| `reviews_count` | number | The total number of reviews the product has |
| `shipping` | text | Shipping details like cost and delivery time |
| `image` | url | URL of the product image |
| `tags` | array | A list of keywords or categories related to the product |
| `small_business` | boolean | Whether the product is sold by a small business |
| `page` | number | The page number the product appears on |
| `location_on_page` | number | The product's position on the page (e.g., 1st, 2nd) |
| `id` | text | The product ID |

Machine-readable version with the input schema: [`/scrapers/gd_m31f2k0d2m1bah4f3b.json`](/scrapers/gd_m31f2k0d2m1bah4f3b.json)

## Google SERP 100 Results, Collect by URL

Scrape up to 100 organic results from a Google Search URL with fine-grained targeting.

**Dataset ID:** `gd_mfz5x93lmsjjjylob`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mfz5x93lmsjjjylob&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?q=best+coffee+nyc",
    "keyword": "best coffee nyc",
    "tbm": "",
    "language": "en",
    "uule": "",
    "brd_mobile": "",
    "tbs": "",
    "nfpr": "",
    "index": ""
  }]'
```

[Full schema](/products/serp-api/get-top-100-google-results)

### Which output fields does the Google SERP 100 results scraper return?

The Google SERP 100 results scraper (`gd_mfz5x93lmsjjjylob`, `collect_by_url`) returns 16 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | URL |
| `keyword` | text | keyword used in search |
| `general` | object | general |
| `related` | array | related |
| `pagination` | array | pagination |
| `organic` | array | organic |
| `people_also_ask` | array | people\_also\_ask |
| `navigation` | array | navigation |
| `language` | text | Input language |
| `country` | country | Input country |
| `aio_citations` | array | aio\_citations |
| `page_html` | text | HTML of first page |
| `aio_text` | text | aio\_text |
| `index` | text | input index |
| `local_pack` | array | local\_pack |
| `aio_markdown` | html2markdown | aio\_markdown |

Machine-readable version with the input schema: [`/scrapers/gd_mfz5x93lmsjjjylob.json`](/scrapers/gd_mfz5x93lmsjjjylob.json)

## Google AI Mode Search, Collect by URL

Scrape answers and citations from Google's AI Mode Search.

**Dataset ID:** `gd_mcswdt6z2elth3zqr2`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mcswdt6z2elth3zqr2&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?udm=50&q=how+to+train+for+a+marathon",
    "prompt": "how to train for a marathon",
    "country": "US"
  }]'
```

To get the answer in another language, add `hl` with a Google language code. This request sends an English prompt and returns the answer in German:

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mcswdt6z2elth3zqr2&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/search?udm=50&q=how+to+train+for+a+marathon",
    "prompt": "how to train for a marathon",
    "country": "DE",
    "hl": "de"
  }]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-ai-mode-search-collect-by-url)

### Which output fields does the Google AI Mode Search scraper return?

The Google AI Mode Search scraper (`gd_mcswdt6z2elth3zqr2`, `collect_by_url`) returns 12 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | Google AI's URL |
| `prompt` | text | The input prompt |
| `answer_html` | text | The answer of Google AI search |
| `answer_text` | text | The answer of Google AI search |
| `links_attached` | array | Links attached to answer |
| `citations` | array | citations |
| `index` | number | The index column lets you assign a unique ID to each crawl request for easy tracking. |
| `country` | country | Country to search from |
| `answer_text_markdown` | html2markdown | Answer text in markdown format |
| `shopping` | array | Shopping data from the AI mode |
| `answer_text_raw` | text | answer\_text\_raw: Original answer text as extracted, without trimming or whitespace normalization (may include leading/trailing spaces and newline characters). |
| `ads` | array | ads |

Machine-readable version with the input schema: [`/scrapers/gd_mcswdt6z2elth3zqr2.json`](/scrapers/gd_mcswdt6z2elth3zqr2.json)

## Google Flights, Collect by URL

Scrape flight options, pricing and itineraries from a Google Flights URL.

**Dataset ID:** `gd_mhng7wen1rw0a3gvpf`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mhng7wen1rw0a3gvpf&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/travel/flights?tfs=..."}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-flights-collect-by-url)

### Which output fields does the Google Flights scraper return?

The Google Flights scraper (`gd_mhng7wen1rw0a3gvpf`, `collect_by_url`) returns 6 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | \[Metadata] The exact Google Flights booking URL from the discovery collector (includes tfs). |
| `itinerary_id` | text | \[Metadata] Stable unique ID for this itinerary (e.g., hash of segments + pax/cabin or the tfs token) |
| `search` | object | Search widget values |
| `pricing` | object | Pricing deatils |
| `providers` | array | Booking options for this itinerary |
| `legs` | array | Trip legs (1=one way, 2=round trip, 3+=multi‑city) |

Machine-readable version with the input schema: [`/scrapers/gd_mhng7wen1rw0a3gvpf.json`](/scrapers/gd_mhng7wen1rw0a3gvpf.json)

## Google Flights, Discover by input filters

Find flights by origin, destination, dates and passenger counts.

**Dataset ID:** `gd_mhng7wen1rw0a3gvpf`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mhng7wen1rw0a3gvpf&format=json&type=discover_new&discover_by=input_filters" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [{
      "origin": "JFK",
      "destination": "LAX",
      "departure": "2026-06-15",
      "return": "2026-06-22",
      "trip_type": "round_trip",
      "adults": 1,
      "children": 0,
      "infants_in_seat": 0,
      "infants_on_lap": 0,
      "cabin": "economy"
    }],
    "limit_per_input": 10
  }'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-flights-discover-by-input-filters)

## Google Hotels, Collect by URL

Scrape a Google Hotels listing by its URL, with optional country targeting.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.google.com/travel/hotels/entity/...", "country": "US"}]'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-hotel-collect-by-url)

### Which output fields does the Google Hotels scraper return?

The Google Hotels scraper (`gd_mg3gjfmg12tc2n5d4d`, `collect_by_url`) returns 31 output fields.

<Accordion title="Output fields (31)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The URL of the hotel listing on Google. |
  | `hotel_id` | text | hotel unique id |
  | `hotel_name` | text | The official name of the hotel. |
  | `rating` | number | The overall rating of the hotel. |
  | `review_count` | text | The total number of reviews. |
  | `star_classification` | number | The star classification of the hotel. |
  | `address` | text | The full street address of the hotel. |
  | `phone_number` | text | The contact phone number for the hotel. |
  | `photos` | array | Collection of hotel photos with captions. |
  | `check_in_date` | date | Selected check-in date for price queries. |
  | `check_out_date` | date | Selected check-out date for price queries. |
  | `guest_number` | number | Number of guests for the booking query. |
  | `booking_options` | array | Available booking options from different platforms. |
  | `price_trend` | text | Current price trend information. |
  | `similar_hotels` | array | List of similar hotels with comparison information. |
  | `nearby_places` | array | List of nearby attractions and points of interest. |
  | `neighborhood_info` | object | Information about the hotel's neighborhood. |
  | `google_review_summary` | object | Summary of Google reviews including rating distribution. |
  | `third_party_reviews` | array | Reviews from third-party travel sites. |
  | `about_hotel` | text | Detailed description about the hotel, its location, and nearby attractions. |
  | `check_in_time` | text | Hotel check-in time. |
  | `check_out_time` | text | Hotel check-out time. |
  | `popular_amenities` | array | List of popular hotel amenities. |
  | `official_website` | url | Official hotel website URL. |
  | `alternative_hotels` | array | List of alternative hotels that users also viewed. |
  | `vacation_rentals_nearby` | array | Nearby vacation rental alternatives. |
  | `popular_hotels_in_city` | array | Popular hotels in the same city. |
  | `search_term` | text | search\_term |
  | `currency` | text | Currency |
  | `lat` | number | The latitude coordinate of the hotel |
  | `long` | number | The longitude coordinate of the hotel |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_mg3gjfmg12tc2n5d4d.json`](/scrapers/gd_mg3gjfmg12tc2n5d4d.json)

## Google Hotels, Discover by filter URL

Discover hotels from a filtered Google Hotels URL.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json&type=discover_new&discover_by=filter_url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [{
      "url": "https://www.google.com/travel/hotels/New+York?...",
      "country": "US",
      "currency": "USD"
    }],
    "limit_per_input": 10
  }'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-filter-url)

## Google Hotels, Discover by search

Discover hotels by destination, dates and guest count.

**Dataset ID:** `gd_mg3gjfmg12tc2n5d4d`

```bash cURL theme={null}
# limit_per_input caps the records returned for each input
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&format=json&type=discover_new&discover_by=search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [{
      "search_term": "New York",
      "check_in_date": "2026-06-15",
      "check_out_date": "2026-06-18",
      "guest_number": 2,
      "country": "US",
      "currency": "USD"
    }],
    "limit_per_input": 10
  }'
```

[Full schema](/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-search)

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape thousands of records or run discovery jobs in a single async request.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url">
    Full endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Instagram Scraper API
Source: https://docs.brightdata.com/products/scrapers/instagram/introduction

Extract structured data from Instagram profiles, posts, reels and comments with the Bright Data [Instagram Scraper API](https://brightdata.com/products/web-scraper/instagram). Best for up to 20 URLs per sync request.

Send an Instagram URL, get structured JSON back. The Bright Data Instagram Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/instagram?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 Instagram records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more Instagram URLs to the Bright Data Instagram Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, posts, reels, or comments) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data Instagram Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/instagram/quickstart).

```json theme={null}
{
  "full_name": "Instagram",
  "biography": "Discover what's new on Instagram 🔎✨",
  "followers": 686423902,
  "following": 286,
  "posts_count": 8579,
  "is_verified": true,
  "account": "instagram",
  "fbid": "17841400039600391",
  "id": "25025320",
  "profile_image_link": "https://scontent-iad3-2.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_..."
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url">
    Follower counts, bios, verification status, profile pictures. Discover profiles by username.
  </Card>

  <Card title="Posts" icon="image" href="/api-reference/scrapers/social-media-apis/instagram-posts-collect-by-url">
    Captions, likes, comments, hashtags, photos, and videos. Discover posts by profile URL.
  </Card>

  <Card title="Reels" icon="film" href="/api-reference/scrapers/social-media-apis/instagram-reels-collect-by-url">
    Video URLs, view counts, play counts, thumbnails. Discover reels or collect all reels from a profile.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/instagram-comments-collect-by-url">
    Comment text, likes, replies, commenter details for any post or reel.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each Instagram data type uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| Profiles | `gd_l1vikfch901nx3by4` |
| Posts | `gd_lk5ns7kz21pck8jpis` |
| Reels | `gd_lyclm20il4r5helnj` |
| Comments | `gd_ltppn085pokosxh13` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data Instagram Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

Instagram changes how its pages are served, and the Bright Data Instagram Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between URL collection and discovery?

**URL collection** scrapes a specific Instagram page you provide (e.g., a profile URL). **Discovery** finds Instagram content matching search criteria (e.g., all posts from a profile URL) and scrapes the results. Discovery is accepted on both endpoints. On `/scrape` it usually runs past the 1-minute limit and returns HTTP `202` with a `snapshot_id`, so use the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint for discovery.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/instagram/quickstart">
    Scrape your first Instagram profile in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/instagram/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# Instagram scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/instagram/quickstart

Set up the Bright Data Instagram Scraper API and collect your first profile, post or reel as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape an Instagram profile and get structured JSON data using the Bright Data Instagram Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/instagram?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/instagram?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint**. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.instagram.profiles(url="https://www.instagram.com/instagram")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.instagram.com/instagram"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1vikfch901nx3by4", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.instagram.com/instagram"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.instagram.com/instagram" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the profile data from `result.data`. It waits up to 180 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data Instagram Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of profile data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data Instagram Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "full_name": "Instagram",
        "biography": "Discover what's new on Instagram 🔎✨",
        "followers": 686423902,
        "following": 286,
        "posts_count": 8579,
        "is_verified": true,
        "url": "https://www.instagram.com/instagram",
        "account": "instagram",
        "fbid": "17841400039600391",
        "id": "25025320"
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Instagram profile using the Bright Data Instagram Scraper API.

## Common questions

### Can I scrape multiple profiles in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.instagram.com/instagram"},
  {"url": "https://www.instagram.com/natgeo"},
  {"url": "https://www.instagram.com/nasa"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the Instagram profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.instagram.com/username`.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | `client.scrape.instagram.profiles(url="https://www.instagram.com/instagram")`; see the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines instagram_profiles "https://www.instagram.com/instagram" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/instagram/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# Instagram Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/instagram/send-first-request

Send synchronous requests to all 4 Bright Data Instagram Scraper API endpoints with copy-paste examples for profiles, posts, reels and comments.

This guide shows you how to send a synchronous request to each Bright Data Instagram Scraper API endpoint. It covers profiles, posts, reels, and comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/instagram?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/instagram/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.instagram.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape Instagram profiles

**Dataset ID:** `gd_l1vikfch901nx3by4`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/instagram"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "full_name": "Instagram",
      "biography": "Discover what's new on Instagram 🔎✨",
      "followers": 686423902,
      "following": 286,
      "posts_count": 8579,
      "is_verified": true,
      "account": "instagram",
      "fbid": "17841400039600391",
      "id": "25025320",
      "profile_image_link": "https://scontent-iad3-2.cdninstagram.com/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_..."
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url)

### Which output fields does the Instagram profiles scraper return?

The Instagram profiles scraper (`gd_l1vikfch901nx3by4`, `collect_by_url`) returns 26 output fields.

<Accordion title="Output fields (26)">
  | Field | Type | Description |
  | - | - | - |
  | `account` | text | The username or handle of the Instagram account |
  | `fbid` | text | Facebook ID associated with the account |
  | `id` | text | Unique identifier for the Instagram account |
  | `followers` | number | The number of followers for the account |
  | `posts_count` | number | The total count of posts made by the account |
  | `is_verified` | boolean | Indicates whether the account is verified |
  | `external_url` | array | External websites that users may link to from their Instagram profiles, such as personal blogs or online stores |
  | `biography` | text | Brief descriptions or statements that users write to introduce themselves or share their interests and passions on Instagram |
  | `post_hashtags` | array | Keywords or phrases that the user specified in their top posts preceded by the "#" symbol that help categorize and discover content related to a specific topic |
  | `following` | number | The number of accounts that the account is following |
  | `posts` | array | Data regarding the top posts that the user has published |
  | `profile_image_link` | text | URL that link directly to the Instagram profile image |
  | `profile_url` | url | URL that link directly to the Instagram profile |
  | `profile_name` | text | The name associated with the account's profile |
  | `highlights_count` | number | The count of highlights (featured stories) on the account |
  | `highlights` | array | Data regarding the highlights that the user has published |
  | `full_name` | text | The full name associated with the account |
  | `is_private` | boolean | Indicates whether the account is private |
  | `bio_hashtags` | array | Keywords or phrases that the user specified in his bio preceded by the "#" symbol that help categorize and discover content related to a specific topic |
  | `url` | url | URL pointing to the account's profile |
  | `is_joined_recently` | boolean | Indicates if the account has joined Instagram recently |
  | `partner_id` | text | The partner ID associated with the account |
  | `email_address` | text | Email address extracted from profile description |
  | `external_url_title` | object | External websites that users may link to from their Instagram profiles, such as personal blogs or online stores, with their descriptions |
  | `pronouns` | text | The profile's pronouns (if available) |
  | `external_urls` | array | External URLs |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_l1vikfch901nx3by4.json`](/scrapers/gd_l1vikfch901nx3by4.json)

## How to scrape Instagram posts

**Dataset ID:** `gd_lk5ns7kz21pck8jpis`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk5ns7kz21pck8jpis&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/p/Cuf4s0MNqNr"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.instagram.com/p/Cuf4s0MNqNr",
      "user_posted": "tin***i",
      "description": "Pet tattoo with forget me nots 🖤💙💛\n.\n.\n.\n#tinybaki #littlepondstudio #cattattoo #pettattoo #forgetmenot #crayontattoo #forgetmenottattoo #forgetmenots #fl...",
      "num_comments": 97,
      "date_posted": "2023-07-10T01:21:31.000Z",
      "likes": 123941,
      "hashtags": [
        "#tinybaki"
      ],
      "content_type": "Carousel",
      "shortcode": "Cuf4s0MNqNr",
      "post_id": "3143480435228975979"
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/instagram-posts-collect-by-url)

### Which output fields does the Instagram posts scraper return?

The Instagram posts scraper (`gd_lk5ns7kz21pck8jpis`, `collect_by_url`) returns 40 output fields.

<Accordion title="Output fields (40)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The direct URL of the Instagram post |
  | `user_posted` | text | Username of the post creator |
  | `description` | text | Post text description |
  | `hashtags` | array | Hashtags used in the post |
  | `num_comments` | number | Number of comments |
  | `date_posted` | date | Post publication date |
  | `likes` | number | Number of likes on the post |
  | `photos` | array | URLs of attached photos, URLs can be expired due to Instagram policy |
  | `videos` | array | URLs of attached videos, URLs can be expired due to Instagram policy |
  | `location` | array | Geographical location associated with the post |
  | `location_details` | object | Detailed geographical location metadata as returned by Instagram |
  | `latest_comments` | array | Recent comments on the post |
  | `post_id` | text | Unique post identifier |
  | `discovery_input` | object | Discovery input values used to trigger the collection |
  | `has_handshake` | boolean | Indicates if the post has a handshake (collaborative agreement between accounts) |
  | `shortcode` | text | The shortcode of the Instagram post, used in the post URL path |
  | `content_type` | text | The type of content — Posts or Reels |
  | `pk` | text | The primary key of the media content as assigned by Instagram |
  | `content_id` | text | The content ID of the media item |
  | `engagement_score_view` | number | Video view count used as an engagement score metric |
  | `thumbnail` | text | The URL of the post's display image or video thumbnail |
  | `video_view_count` | text | The number of views on the video post |
  | `product_type` | text | The type of product associated with the post, such as 'clips' for Reels |
  | `coauthor_producers` | array | List of co-authors or producers who collaborated on the post |
  | `tagged_users` | array | List of users tagged in the post |
  | `video_play_count` | number | The number of times the video has been played |
  | `followers` | number | Number of followers the post owner has at the time of collection |
  | `posts_count` | number | The total count of posts made by the account at the time of collection |
  | `profile_image_link` | text | URL linking directly to the Instagram profile image of the post owner |
  | `is_verified` | boolean | Indicates whether the post owner's account is verified |
  | `partnership_details` | object | Details of the paid partnership brand associated with the post |
  | `user_posted_id` | text | The Instagram user ID of the account that posted the post |
  | `post_content` | array | List of media items (photos or videos) attached to the post, including carousel items |
  | `audio` | object | Audio track metadata associated with the post or Reel |
  | `profile_url` | url | URL of the Instagram profile that posted the post |
  | `videos_duration` | array | List of video durations for each video attached to the post |
  | `images` | array | List of image objects attached to the post |
  | `alt_text` | text | Accessibility alt text for the post's main image — descriptive text that conveys the meaning of the image for blind or visually impaired users |
  | `photos_number` | number | Total number of photos attached to the post |
  | `audio_url` | url | Direct URL of the audio track used in the post |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lk5ns7kz21pck8jpis.json`](/scrapers/gd_lk5ns7kz21pck8jpis.json)

## How to scrape Instagram reels

**Dataset ID:** `gd_lyclm20il4r5helnj`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm20il4r5helnj&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/reel/C5Rdyj_q7YN/"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/C5Rdyj_q7YN/",
      "user_posted": "dex***t",
      "description": "Bro is a cat-of-all-trades 🧳 \n\n#catoftheday #orangecatsofinstagram #orangecatbehavior #kitten #asmr #orangecat #catsofig #cardboardcat",
      "num_comments": 7899,
      "date_posted": "2024-04-02T20:44:39.000Z",
      "likes": 3481930,
      "views": null,
      "video_play_count": null,
      "length": "46.79999923706055",
      "shortcode": "C5Rdyj_q7YN"
    }
  ]
  ```
</Accordion>

[Full Reels response schema](/api-reference/scrapers/social-media-apis/instagram-reels-collect-by-url)

### Which output fields does the Instagram reels scraper return?

The Instagram reels scraper (`gd_lyclm20il4r5helnj`, `collect_by_url`) returns 27 output fields.

<Accordion title="Output fields (27)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | URL of the reel |
  | `user_posted` | text | Username of the reel creator |
  | `description` | text | Reel text description |
  | `hashtags` | array | Hashtags used in the post |
  | `num_comments` | number | Number of comments |
  | `date_posted` | date | Reel publication date |
  | `likes` | number | Number of likes |
  | `views` | number | Number of views |
  | `video_play_count` | number | The number of times the Reel has been played |
  | `top_comments` | array | Top comments |
  | `post_id` | text | Unique post identifier |
  | `thumbnail` | url | The URL of the reel's display image or video thumbnail |
  | `shortcode` | text | The shortcode of the Instagram reel |
  | `content_id` | text | The content ID of the media |
  | `product_type` | text | The type of product, such as "clips" |
  | `coauthor_producers` | array | Coauthor producers |
  | `tagged_users` | array | Tagged users |
  | `length` | text | Length of the reel |
  | `video_url` | url | The video url |
  | `audio_url` | url | link to the audio connected to the post |
  | `posts_count` | number | The profile's number of posts |
  | `followers` | number | The profile's number of followers |
  | `following` | number | The profile's number of following |
  | `user_profile_url` | url | User profile URL |
  | `is_paid_partnership` | boolean | Is the post sponsored |
  | `is_verified` | boolean | Is verified |
  | `profile_image_link` | url | profile image link |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lyclm20il4r5helnj.json`](/scrapers/gd_lyclm20il4r5helnj.json)

## How to scrape Instagram comments

**Dataset ID:** `gd_ltppn085pokosxh13`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppn085pokosxh13&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.instagram.com/p/Cuf4s0MNqNr"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.instagram.com/p/Cuf4s0MNqNr",
      "comment_user": "ink***e",
      "comment_user_url": "https://www.instagram.com/ink***e",
      "comment_date": "2026-08-18T03:37:10.000Z",
      "comment": "Wow! Awesome 🙌🙌🙌🔥🔥🔥🔥🔥",
      "likes_number": 0,
      "replies_number": 0,
      "comment_id": "18112992241972031",
      "post_url": "https://www.instagram.com/p/Cuf4s0MNqNr"
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/instagram-comments-collect-by-url)

### Which output fields does the Instagram comments scraper return?

The Instagram comments scraper (`gd_ltppn085pokosxh13`, `collect_by_url`) returns 14 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | URL |
| `comment_user` | text | The username commenting |
| `comment_user_url` | url | Url of the commenting user |
| `comment_date` | text | Date when the comment was made |
| `comment` | text | The comment of the comment |
| `likes_number` | number | Number of likes on the comment |
| `replies_number` | number | Number of replies on the comment |
| `replies` | array | replies on the comment |
| `hashtag_comment` | array | The hashtags used in the comment |
| `tagged_users_in_comment` | array | The usernames tagged in the comment |
| `post_url` | url | The URL of the post itself |
| `post_user` | text | The user posting the original post |
| `comment_id` | text | unique id for each comment |
| `post_id` | text | Post ID |

Machine-readable version with the input schema: [`/scrapers/gd_ltppn085pokosxh13.json`](/scrapers/gd_ltppn085pokosxh13.json)

## Quick reference: dataset IDs

| Endpoint | Dataset ID | URL pattern |
| :- | :- | :- |
| Profiles | `gd_l1vikfch901nx3by4` | `instagram.com/{username}` |
| Posts | `gd_lk5ns7kz21pck8jpis` | `instagram.com/p/{shortcode}` |
| Reels | `gd_lyclm20il4r5helnj` | `instagram.com/reel/{shortcode}` |
| Comments | `gd_ltppn085pokosxh13` | `instagram.com/p/{shortcode}` or `instagram.com/reel/{shortcode}` |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Scraper API limits
Source: https://docs.brightdata.com/products/scrapers/limits

Look up every Bright Data Scraper API limit in one table: 1-minute sync wait, 1 GB async input, 5,000 running jobs and 5 GB downloads.

This reference lists every documented Bright Data Scraper API limit in one table, with what happens when a request reaches each one.

## What are the Scraper API limits?

| Area | Limit | Value | What happens at the limit |
| - | - | - | - |
| Sync `/scrape` | Response wait | 1 minute | The API answers HTTP 202 with a `snapshot_id` and the job continues. The `retry-after` header says how long to wait before polling, 10 seconds at the time of writing. See [How to handle a 202 response](/api-reference/scrapers/synchronous-requests#how-to-handle-a-202-response) |
| Async `/trigger` | Input data per job | 1 GB | About tens of thousands of URLs. Split larger inputs across several jobs |
| Async `/trigger` | Minimum inputs | Set per scraper | Some scrapers need more than one input. A request with too few returns HTTP 400 `Should be at least LIMIT inputs` |
| `/trigger` and `/scrape` | Running jobs | 5,000 active jobs or snapshots | New requests return HTTP 429 `You have too many running jobs for this dataset` |
| `/trigger` and `/scrape` | HTTP 429 responses per IP | 25 within 5 minutes | Bright Data blocks the IP on every API request until [support](mailto:support@brightdata.com) clears it |
| Webhook delivery | Payload size | 1 GB | Use storage delivery for larger results |
| Webhook delivery | Response deadline | 30 seconds | Bright Data treats the delivery as failed and retries it. Return HTTP 200 before processing the payload. See [How to handle webhooks in production](/products/scrapers/scrapers-library/data-delivery#how-to-handle-webhooks-in-production) |
| [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot) | Snapshot retention | 30 days after the job completes | The snapshot can no longer be downloaded. Deliver results to storage or a webhook to keep them longer |
| [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot) | Download size per request | 5 GB | Download the snapshot in parts with `batch_size` and `part` |
| [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot) | Minimum `batch_size` for parts | 1,000 records | Use a `batch_size` of 1,000 or more |
| [Deliver snapshot](/api-reference/scrapers/delivery-apis/deliver-snapshot) | Delivered file size | 5 GB per file | HTTP 400. Lower `batch_size` so each file stays under 5 GB |
| [Streamed delivery](/products/scrapers/scrapers-library/stream-and-file-delivery) | Lines per batch | 10 to 100,000 | Set `stream_max_lines` within this range. Streamed delivery needs a storage or webhook destination |
| Instagram | Media link lifetime | 24 hours after collection | Media URLs in the records stop working. Download the media within 24 hours |
| LinkedIn | Posts per profile | The posts a profile shows publicly, typically about 10 | Older posts are not collected |

## How do I avoid the HTTP 429 limit?

Combine many inputs into one `/trigger` request instead of starting one job per input. A single job accepts up to 1 GB of input data, so fewer, larger jobs keep you under the 5,000 running jobs limit.

When a 429 arrives, stop sending, wait the seconds in the `Retry-After` header or back off 2, 4, 8, 16 and 32 seconds, then retry. The retry code is in [Getting a 429 Too Many Requests error?](/products/scrapers/scrapers-library/async-requests#getting-a-429-too-many-requests-error), and every Scraper API error message is listed on [Scraper API error codes](/products/scrapers/error-codes).

## FAQ

### How many URLs can I send in one Scraper API request?

Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. A `/scrape` request that cannot finish within 1 minute, for example because it holds many URLs, returns HTTP 202 with a `snapshot_id` and the job continues asynchronously. The asynchronous `/trigger` endpoint accepts up to 1 GB of input data per job. See [How to scrape in bulk with async requests](/products/scrapers/scrapers-library/async-requests).

### Does a sync request fail after 1 minute?

No. A `/scrape` request that runs past 1 minute returns HTTP 202 with a `snapshot_id`, and the job keeps running. Poll [Monitor progress](/api-reference/scrapers/management-apis/monitor-progress) with the `snapshot_id`, then fetch the records with [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot).


# LinkedIn Scraper API
Source: https://docs.brightdata.com/products/scrapers/linkedin/introduction

Use the Bright Data [LinkedIn Scraper API](https://brightdata.com/products/web-scraper/linkedin) to extract structured data from profiles, companies, jobs and posts. Best for up to 20 URLs per sync request.

Send a LinkedIn URL, get structured JSON back. The Bright Data LinkedIn Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 LinkedIn records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more LinkedIn URLs to the Bright Data LinkedIn Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, companies, jobs, or posts) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data LinkedIn Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/linkedin/quickstart).

```json theme={null}
{
  "name": "Satya Nadella",
  "city": "Redmond, Washington, United States",
  "country_code": "US",
  "current_company": {
    "name": "Microsoft",
    "company_id": "microsoft",
    "title": "Chairman and CEO",
    "location": "Greater Seattle Area"
  },
  "followers": 12151763,
  "about": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
  "id": "satyanadella",
  "position": "Chairman and CEO at Microsoft",
  "url": "https://ar.linkedin.com/in/satyanadella",
  "educations_details": "The University of Chicago Booth School of Business"
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Identity, location, current company, follower counts. Discover profiles by name or keyword.
  </Card>

  <Card title="Companies" icon="building" href="/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url">
    Employee counts, funding data, specialties, affiliated organizations.
  </Card>

  <Card title="Jobs" icon="briefcase" href="/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url">
    Salary data, requirements, application links. Discover jobs by keyword or search URL.
  </Card>

  <Card title="Posts" icon="message" href="/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url">
    Post content, engagement metrics, hashtags, comments. Discover posts by company or profile.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each LinkedIn data type uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| Profiles | `gd_l1viktl72bvl7bjuj0` |
| Companies | `gd_l1vikfnt1wgvvqz95w` |
| Jobs | `gd_lpfll7v5hcqtkxl6l` |
| Posts | `gd_lyy3tktm25m4avu764` |
| Discover new profiles | `gd_m8d03he47z8nwb5xc` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

<Note>
  Since November 13, 2025, LinkedIn has restricted public access to the **Position**, **Experience** and **Education** fields. Fill rates for those three dropped from 50-64 percent to roughly 2 percent, and they now return sticky data from cache rather than a fresh scrape. All other fields refresh normally, except `current_company.industry`, which has been unsupported since Aug. 7, 2025. See [LinkedIn data policy change](/products/scrapers/linkedin/data-policy-change) for the full field status table and alternatives.
</Note>

### Is the data scraped in real time?

Yes. Each request triggers a live scrape, with one exception: the Position, Experience and Education fields have been served from cache since LinkedIn restricted them on November 13, 2025 (see the note above). Every other field is fresh. Processing time varies with target-site conditions and scraper workload. The Bright Data LinkedIn Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

LinkedIn changes how its pages are served, and the Bright Data LinkedIn Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between URL collection and discovery?

**URL collection** scrapes a specific LinkedIn page you provide (e.g., a profile URL). **Discovery** finds LinkedIn pages matching search criteria (e.g., "software engineers in San Francisco") and scrapes the results. Discovery is accepted on both endpoints. On `/scrape` it usually runs past the 1-minute limit and returns HTTP `202` with a `snapshot_id`, so use the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint for discovery.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/linkedin/quickstart">
    Scrape your first LinkedIn profile in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/linkedin/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# LinkedIn scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/linkedin/quickstart

Set up the Bright Data LinkedIn Scraper API and collect your first profile, company or job as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape a LinkedIn profile and get structured JSON data using the Bright Data LinkedIn Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint**. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.linkedin.profiles(url="https://www.linkedin.com/in/satyanadella")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1viktl72bvl7bjuj0", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.linkedin.com/in/satyanadella"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.linkedin.com/in/satyanadella" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the returned records from `result.data`. It waits up to 180 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data LinkedIn Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of profile data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data LinkedIn Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "name": "Satya Nadella",
        "city": "Redmond, Washington, United States",
        "country_code": "US",
        "current_company": {
          "name": "Microsoft",
          "company_id": "microsoft",
          "title": "Chairman and CEO",
          "location": "Greater Seattle Area"
        },
        "followers": 12151763,
        "connections": 500,
        "url": "https://ar.linkedin.com/in/satyanadella",
        "id": "satyanadella",
        "position": "Chairman and CEO at Microsoft",
        "about": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more."
      }
    ]
    ```

    Each profile object carried 42 top-level fields when captured on September 6, 2026, covering identity, location, current company, follower counts and social activity. See the [full response schema](/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first LinkedIn profile using the Bright Data LinkedIn Scraper API.

<Note>
  Since November 13, 2025, LinkedIn has restricted public access to the **Position**, **Experience** and **Education** fields. Fill rates for those three dropped from 50-64 percent to roughly 2 percent, and they now return sticky data from cache rather than a fresh scrape. All other fields refresh normally, except `current_company.industry`, which has been unsupported since Aug. 7, 2025. See [LinkedIn data policy change](/products/scrapers/linkedin/data-policy-change) for the full field status table and alternatives.
</Note>

## Common questions

### Can I scrape multiple profiles in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.linkedin.com/in/satyanadella"},
  {"url": "https://www.linkedin.com/in/jeffweiner08"},
  {"url": "https://www.linkedin.com/in/rbranson"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the LinkedIn profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.linkedin.com/in/username`.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | `client.scrape.linkedin.profiles(url="https://www.linkedin.com/in/satyanadella")`; see the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines linkedin_person_profile "https://www.linkedin.com/in/satyanadella" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/linkedin/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# LinkedIn Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/linkedin/send-first-request

Send synchronous requests to all 4 Bright Data LinkedIn Scraper API endpoints with copy-paste examples for profiles, companies, jobs and posts.

This guide shows you how to send a synchronous request to each Bright Data LinkedIn Scraper API endpoint. It covers profiles, companies, jobs, and posts.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/linkedin/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.linkedin.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape LinkedIn profiles

**Dataset ID:** `gd_l1viktl72bvl7bjuj0`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "name": "Satya Nadella",
      "city": "Redmond, Washington, United States",
      "country_code": "US",
      "current_company": {
        "name": "Microsoft",
        "company_id": "microsoft",
        "title": "Chairman and CEO",
        "location": "Greater Seattle Area"
      },
      "about": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
      "followers": 12151763,
      "connections": 500,
      "id": "satyanadella",
      "position": "Chairman and CEO at Microsoft",
      "url": "https://ar.linkedin.com/in/satyanadella"
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url)

<Note>
  Since November 13, 2025, LinkedIn has restricted public access to the **Position**, **Experience** and **Education** fields. Fill rates for those three dropped from 50-64 percent to roughly 2 percent, and they now return sticky data from cache rather than a fresh scrape. All other fields refresh normally, except `current_company.industry`, which has been unsupported since Aug. 7, 2025. See [LinkedIn data policy change](/products/scrapers/linkedin/data-policy-change) for the full field status table and alternatives.
</Note>

### Which output fields does the LinkedIn profiles scraper return?

The LinkedIn profiles scraper (`gd_l1viktl72bvl7bjuj0`, `collect_by_url`) returns 42 output fields.

<Accordion title="Output fields (42)">
  | Field | Type | Description |
  | - | - | - |
  | `id` | text | A unique identifier for the person's LinkedIn profile |
  | `name` | text | Profile name |
  | `city` | text | Geographical location of the user |
  | `country_code` | text | Geographical location of the user |
  | `position` | text | The current job title or position of the profile<br />**Note:** Restricted by LinkedIn since Nov. 13, 2025. Usually empty. |
  | `about` | text | A concise profile summary. In some cases, only a truncated version with "…" is displayed on the website, and this is the version we capture |
  | `posts` | array | Contains information related to the user's last LinkedIn posts. It typically includes the post title, created date, URL link to the post, etc. |
  | `current_company` | object | Provides information about the user's current professional position. It typically includes the company name, the user's job title, the company ID, and the industry or sector to which the company belongs |
  | `experience` | array | Contains information about user's professional history. It typically includes the user's job title, length of time the user held the position, the geographic location of the company, the start and end date, the company name, URL link to the company profile, etc.<br />**Note:** Restricted by LinkedIn since Nov. 13, 2025. Usually empty. |
  | `url` | url | URL that link directly to the LinkedIn profile |
  | `people_also_viewed` | array | Provides a list of LinkedIn profiles that users who have viewed the user's profile, have viewed these as well |
  | `educations_details` | text | Provides information about the user's educational background |
  | `education` | array | Provides information about the user's educational background. It typically includes the degree, the start and end year, the filed, etc.<br />**Note:** Restricted by LinkedIn since Nov. 13, 2025. Usually empty. |
  | `recommendations_count` | number | A numeric count of the total number of recommendations that the user has received |
  | `avatar` | url | URL that link to the profile picture of the LinkedIn user |
  | `courses` | array | Contains information about courses or educational programs that the user has undertaken |
  | `languages` | array | Contains information about the user's proficiency in different languages |
  | `certifications` | array | Licenses & Certifications |
  | `recommendations` | array | Recommendations that the user has received from their connections or colleagues on LinkedIn |
  | `volunteer_experience` | array | Contains information related to the user's volunteer work |
  | `followers` | number | How many users/ companies following the profile |
  | `connections` | number | How many connections the profile has |
  | `current_company_company_id` | text | The id of the latest/current company of the profile |
  | `current_company_name` | text | The name of the latest/current company of the profile |
  | `publications` | array | Published works or presentations |
  | `patents` | array | Patents filed or granted |
  | `projects` | array | Professional or academic projects |
  | `organizations` | array | Memberships in professional organizations |
  | `location` | text | Geographical location of the user |
  | `input_url` | url | The URL that was entered when starting the scraping process |
  | `linkedin_id` | text | LinkedIn profile identifier |
  | `activity` | array | Any activity the user has regarding posts |
  | `linkedin_num_id` | text | Numeric LinkedIn profile ID |
  | `banner_image` | url | Banner image |
  | `honors_and_awards` | array | Awards and recognitions received |
  | `similar_profiles` | array | Profiles similar to the current one |
  | `default_avatar` | boolean | Is the avatar picture the default avatar empty picture |
  | `memorialized_account` | boolean | Boolean indicating if the account is memorialized |
  | `bio_links` | array | External links added to the bio |
  | `first_name` | text | First name of the user |
  | `last_name` | text | Last name of the user |
  | `influencer` | boolean | Indicator if the profile marked as influencer |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_l1viktl72bvl7bjuj0.json`](/scrapers/gd_l1viktl72bvl7bjuj0.json)

## How to scrape LinkedIn companies

**Dataset ID:** `gd_l1vikfnt1wgvvqz95w`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfnt1wgvvqz95w&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/company/microsoft"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "name": "Microsoft",
      "followers": 29034884,
      "employees_in_linkedin": 232354,
      "about": "Every company has a mission. What's ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for...",
      "industries": "Software Development",
      "company_size": "10,001+ employees",
      "headquarters": "Redmond, Washington",
      "website": "https://news.microsoft.com/",
      "id": "microsoft",
      "country_code": "US,AU,CA,FR,DE,JP,GB,DK,BE,FI,IT,KR,NL,NO,ES,SE,CH,BR,CN,IN,MX,RU,ZA,TR,AT,HK,IE,IL,NZ,PL,PT,SA,SG,SK,TW,AE,AR,CL,CO,EG,ID,MY,PH,RO,TH"
    }
  ]
  ```
</Accordion>

[Full Companies response schema](/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url)

### Which output fields does the LinkedIn companies scraper return?

The LinkedIn companies scraper (`gd_l1vikfnt1wgvvqz95w`, `collect_by_url`) returns 36 output fields.

<Accordion title="Output fields (36)">
  | Field | Type | Description |
  | - | - | - |
  | `id` | text | Unique to each company |
  | `name` | text | The name of the company |
  | `country_code` | text | The country where the company is located or headquartered |
  | `locations` | array | General information about the company's locations |
  | `followers` | number | The number of followers the company has on LinkedIn |
  | `employees_in_linkedin` | number | The number of employees listed on LinkedIn |
  | `about` | text | A description or summary of the company |
  | `specialties` | text | List of the company's specializations |
  | `company_size` | text | The number of employees in the company, as reported by the company |
  | `organization_type` | text | The type of organization |
  | `industries` | text | The industries to which the company belongs |
  | `website` | text | The official website of the company |
  | `crunchbase_url` | text | URL linking to the company's profile on Crunchbase |
  | `founded` | number | The year in which the company was founded |
  | `company_id` | text | A unique identifier for the company |
  | `employees` | array | Additional information about the company's employees |
  | `headquarters` | text | The location of the company's headquarters |
  | `image` | url | URL that links to the banner photo associated with the company's LinkedIn page |
  | `logo` | text | URL that links to the profile picture of the company's LinkedIn page |
  | `similar` | array | Information about similar companies |
  | `url` | url | The URL or link to the company's LinkedIn page |
  | `updates` | array | Information about the company's most recent posts on LinkedIn |
  | `slogan` | text | The company's slogan |
  | `affiliated` | array | Information about affiliated companies |
  | `funding` | object | Information related to the company's financial backing and investments |
  | `investors` | array | Information about the company's investors |
  | `formatted_locations` | array | Geographical location of the company |
  | `stock_info` | object | Information about the company's stock-related data. Include details such as the stock exchange where the company is listed (e.g., NYSE, NASDAQ) |
  | `get_directions_url` | array | The url of the directions provided by the company on linkedin |
  | `description` | text | raw description in html |
  | `additional_information` | text | Open-roles summary text extracted from LinkedIn |
  | `country_codes_array` | array | array of all relevant countries the company locate in |
  | `alumni` | number | Number of alumni on LinkedIn |
  | `alumni_information` | array | Aggregated alumni insights |
  | `website_simplified` | text | Company website root domain |
  | `unformatted_about` | text | Raw About text captured from the page |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_l1vikfnt1wgvvqz95w.json`](/scrapers/gd_l1vikfnt1wgvvqz95w.json)

## How to scrape LinkedIn jobs

**Dataset ID:** `gd_lpfll7v5hcqtkxl6l`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lpfll7v5hcqtkxl6l&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/jobs/view/3986111804"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "job_title": "Software Engineer",
      "company_name": "Epic",
      "job_location": "San Jose, CA",
      "job_seniority_level": "Entry level",
      "job_employment_type": "Full-time",
      "job_industries": "Software Development",
      "job_summary": "Please note that this position is based on our campus in Madison, WI, and requires relocation to the area. We recruit nationally and provide financial reloca...",
      "apply_link": null,
      "is_easy_apply": false,
      "url": "https://www.linkedin.com/jobs/view/3986111804?_l=en"
    }
  ]
  ```
</Accordion>

[Full Jobs response schema](/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url)

### Which output fields does the LinkedIn jobs scraper return?

The LinkedIn jobs scraper (`gd_lpfll7v5hcqtkxl6l`, `collect_by_url`) returns 27 output fields.

<Accordion title="Output fields (27)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The job posting's web link on LinkedIn |
  | `job_posting_id` | text | Unique identifier for each job listing |
  | `job_title` | text | Title of the advertised job position |
  | `company_name` | text | Name of the hiring company |
  | `company_id` | text | Unique identifier for each company |
  | `job_location` | text | Geographic location of the job |
  | `job_summary` | text | Brief overview of job responsibilities |
  | `job_seniority_level` | text | Seniority level of the position |
  | `job_function` | text | Specific department or function of the job |
  | `job_employment_type` | text | Type of employment offered |
  | `job_industries` | text | Industries associated with the job |
  | `job_base_pay_range` | text | Salary range for the position |
  | `company_url` | url | LinkedIn profile link of the hiring company |
  | `job_posted_time` | text | Timestamp for when the job was posted |
  | `job_num_applicants` | number | Number of applicants for the job |
  | `discovery_input` | object | Discovery input values |
  | `apply_link` | url | Link or information for job application |
  | `country_code` | country | 2 letter country code |
  | `title_id` | text | standardized LinkedIn job title ID |
  | `company_logo` | image | the logo image of the company posted the job |
  | `job_posted_date` | date | parsed date of the job posting time |
  | `job_poster` | object | Profile of the person who posted the job |
  | `application_availability` | boolean | Whether a user can still apply for this job |
  | `job_description_formatted` | text | The job description as it appears in LinkedIn |
  | `base_salary` | object | Structured base pay range with currency and pay period |
  | `salary_standards` | text | Employer-provided pay standards or notes |
  | `is_easy_apply` | boolean | Does it have easy apply |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lpfll7v5hcqtkxl6l.json`](/scrapers/gd_lpfll7v5hcqtkxl6l.json)

## How to scrape LinkedIn posts

**Dataset ID:** `gd_lyy3tktm25m4avu764`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyy3tktm25m4avu764&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/posts/satyanadella_activity-7180537307521769472"}]'
```

<Accordion title="Example response (illustrative, not captured)">
  ```json theme={null}
  [
    {
      "post_text": "Excited to share our latest AI innovations...",
      "num_likes": 45230,
      "num_comments": 1250,
      "date_posted": "2024-04-03T14:30:00.000Z",
      "hashtags": ["AI", "Innovation"],
      "user_followers": 10842560,
      "post_type": "original"
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url)

### Which output fields does the LinkedIn posts scraper return?

The LinkedIn posts scraper (`gd_lyy3tktm25m4avu764`, `collect_by_url`) returns 37 output fields.

<Accordion title="Output fields (37)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The web link to the individual LinkedIn post |
  | `id` | text | A unique identifier for each LinkedIn post |
  | `user_id` | text | The unique identifier for the user who created the post |
  | `use_url` | url | The web link to the profile of the user who created the post |
  | `title` | text | The title or main subject of the LinkedIn post, if applicable |
  | `headline` | text | A brief headline summarizing the post’s content |
  | `post_text` | text | The main text content of the LinkedIn post |
  | `date_posted` | date | The date and time when the post was published on LinkedIn |
  | `hashtags` | array | Keywords or phrases prefixed with a hash (#) used in the post to tag content |
  | `embedded_links` | array | RLs included within the post that link to external content |
  | `images` | array | Any images attached or embedded in the post |
  | `videos` | array | Any videos attached or embedded in the post |
  | `num_likes` | number | The total number of likes the post has received |
  | `num_comments` | number | The total number of comments the post has received |
  | `more_articles_by_user` | array | Links to other posts or articles written by the same user |
  | `more_relevant_posts` | array | Links to other posts that are relevant or related to the content of this post |
  | `top_visible_comments` | array | Top comments on post, only some comments if any are visible without a login |
  | `user_followers` | number | Number of followers of the user |
  | `user_posts` | number | User number of posts |
  | `user_articles` | number | Number of user articles |
  | `post_type` | text | article/post |
  | `account_type` | text | Author type of the posting account: 'Person' or 'Company |
  | `post_text_html` | text | The post text keeping the line breaks |
  | `repost` | object | Details of the original post that was reshared |
  | `tagged_companies` | array | Companies tagged or mentioned in the post |
  | `tagged_people` | array | People tagged or mentioned in the post |
  | `user_title` | text | The title of the post's author |
  | `author_profile_pic` | url | The post's author profile picture |
  | `num_connections` | number | The number of connections of the post's author |
  | `video_duration` | number | Duration of the post's video |
  | `external_link_data` | array | Preview cards for external links included in the post |
  | `video_thumbnail` | url | Thumbnail image URL for the attached video |
  | `document_cover_image` | url | Cover image URL for an attached document |
  | `document_page_count` | number | Total number of pages in the attached document |
  | `user_profile_pic` | url | The user's profile picture |
  | `user_name` | text | The name if the user posting |
  | `original_post_text` | text | The post's text including line breaks like how it appears on LinkedIn |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lyy3tktm25m4avu764.json`](/scrapers/gd_lyy3tktm25m4avu764.json)

## Quick reference: dataset IDs

| Endpoint | Dataset ID | URL pattern |
| :- | :- | :- |
| Profiles | `gd_l1viktl72bvl7bjuj0` | `linkedin.com/in/{username}` |
| Companies | `gd_l1vikfnt1wgvvqz95w` | `linkedin.com/company/{slug}` |
| Jobs | `gd_lpfll7v5hcqtkxl6l` | `linkedin.com/jobs/view/{id}` |
| Posts | `gd_lyy3tktm25m4avu764` | `linkedin.com/posts/{slug}` |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Scraper API
Source: https://docs.brightdata.com/products/scrapers/overview

Browse Bright Data Scraper API scrapers for Amazon, LinkedIn, Instagram, TikTok and thousands more sites. Pre-built scrapers return structured JSON on demand.

<Note>
  [Start now](https://brightdata.com/?hs_signup=1\&utm_source=docs) with **5,000 free credits per month**. No credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

  We’ll also match your **first account deposit up to \$500**.
</Note>

<div>
  <div>
    <div>
      <div>
        <span>Scraper API</span>

        <h1>Structured data from any website</h1>

        <p>
          Send a URL, receive structured JSON/CSV. No proxies, browsers, anti-bot systems or parsing to manage. Thousands of pre-built scrapers cover LinkedIn, Instagram, TikTok, Amazon, Google Maps and more.
        </p>

        <div>
          <a href="/products/scrapers/linkedin/quickstart">Start building</a>
        </div>
      </div>

      <div>
        <img alt="Bright Data Scraper API overview illustration" />
      </div>
    </div>

    <div>
      <span>💡</span>
      <span>Not ready for a full integration? Run any scraper from the <a href="https://brightdata.com/cp/scrapers/browse">no-code dashboard</a>.</span>
    </div>

    ## Your first request

    Replace `YOUR_API_KEY` with a key from your [account settings](https://brightdata.com/cp/setting/users). You'll receive one JSON record. The same request pattern works for every scraper in the library.

    <CodeGroup>
      ```bash cURL theme={null}
      curl "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"}]'
      ```

      ```python Python theme={null}
      import requests

      url = "https://api.brightdata.com/datasets/v3/scrape"
      headers = {
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      }
      params = {"dataset_id": "gd_l1viktl72bvl7bjuj0", "format": "json"}
      payload = [{"url": "https://www.linkedin.com/in/elad-moshe-05a90413/"}]

      response = requests.post(url, headers=headers, params=params, json=payload)
      print(response.json())
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.linkedin.com/in/elad-moshe-05a90413/" },
          ]),
        }
      );

      const data = await response.json();
      console.log(data);
      ```
    </CodeGroup>

    ## Which scrapers are most popular

    <div>
      <span>Most popular</span>
    </div>

    <CardGroup>
      <Card title="LinkedIn" icon="linkedin" href="/products/scrapers/linkedin/quickstart">
        Profiles, companies, jobs, posts.
      </Card>

      <Card title="Instagram" icon="instagram" href="/products/scrapers/instagram/quickstart">
        Profiles, posts, reels, comments.
      </Card>

      <Card title="TikTok" icon="tiktok" href="/products/scrapers/tiktok/quickstart">
        Profiles, posts, comments, shop.
      </Card>

      <Card title="Amazon" icon="amazon" href="/products/scrapers/amazon/quickstart">
        Products, reviews, sellers, search.
      </Card>
    </CardGroup>

    <h3>Social</h3>

    <CardGroup>
      <Card title="Facebook" icon="facebook" href="/products/scrapers/facebook/quickstart">
        Pages, posts, events.
      </Card>

      <Card title="X / Twitter" icon="x-twitter" href="/products/scrapers/twitter/quickstart">
        Profiles and posts.
      </Card>

      <Card title="YouTube" icon="youtube" href="/products/scrapers/youtube/quickstart">
        Channels, videos, comments.
      </Card>

      <Card title="Reddit" icon="reddit" href="/products/scrapers/reddit/quickstart">
        Subreddits, posts, comments.
      </Card>
    </CardGroup>

    <h3>AI & Search</h3>

    <CardGroup>
      <Card title="ChatGPT" icon="comments" href="/products/scrapers/chatgpt/quickstart">
        Conversations and prompts.
      </Card>

      <Card title="Google Search" icon="magnifying-glass" href="/products/scrapers/google/quickstart">
        SERPs, snippets, featured results.
      </Card>

      <Card title="Google Maps" icon="location-dot" href="/products/scrapers/google/quickstart">
        Places, reviews, hours.
      </Card>
    </CardGroup>

    <a href="https://brightdata.com/cp/scrapers/browse">Browse all scrapers →</a>

    <div>
      <span>🛠️</span>
      <span>Can't find the site you need? Build a custom scraper in minutes with AI-powered <a href="/products/scraper-studio/overview">Scraper Studio</a>.</span>
    </div>

    ## How it works

    Pick a request mode, then pick how you want the data delivered.

    ### Request modes

    <CardGroup>
      <Card title="Synchronous" icon="bolt" href="/concepts/sync-vs-async">
        One request, one response. Best for single URLs and real-time use cases.
      </Card>

      <Card title="Asynchronous" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
        Trigger a job, retrieve later. Handles thousands of URLs per request.
      </Card>

      <Card title="Discovery" icon="magnifying-glass" href="/products/scrapers/scrapers-library/faqs#what-is-the-difference-between-collect-and-discover-scrapers">
        Find records by keyword or category when you don't have specific URLs.
      </Card>
    </CardGroup>

    ### Which delivery options to use

    <CardGroup>
      <Card title="API download" icon="download" href="/api-reference/scrapers/delivery-apis/download-snapshot">
        Pull results from the API once a job completes.
      </Card>

      <Card title="Webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
        Push results to your endpoint as soon as a snapshot is ready.
      </Card>

      <Card title="Cloud storage" icon="cloud" href="/products/scrapers/scrapers-library/data-delivery">
        Deliver to S3, GCS, Azure, or Snowflake.
      </Card>

      <Card title="Streaming" icon="stream" href="/products/scrapers/scrapers-library/stream-and-file-delivery">
        Receive results in batches as they are scraped.
      </Card>
    </CardGroup>

    ## Beyond pre-built scrapers

    <CardGroup>
      <Card title="Custom scrapers" icon="code" href="/products/scraper-studio/overview">
        Build a scraper for any site using Scraper Studio. Pass a URL and describe the data you need.
      </Card>

      <Card title="Managed services" icon="screwdriver-wrench" href="https://brightdata.com/pricing/managed-services">
        Bright Data's team builds and operates custom scrapers for your targets. **No code required.**
      </Card>

      <Card title="Datasets marketplace" icon="store" href="/products/marketplace/dataset-view">
        Skip scraping entirely. Buy ready-made datasets refreshed on a schedule. **No code required.**
      </Card>
    </CardGroup>

    ## How to combine scrapers and delivery

    End-to-end tutorials that combine a scraper with a delivery option and a target system.

    <CardGroup>
      <Card title="LinkedIn profiles → your CRM" icon="user-magnifying-glass" href="/products/scrapers/tutorials/linkedin-to-crm">
        Pull profiles and company data with the LinkedIn scraper, then push them via webhook into HubSpot or Salesforce.
      </Card>

      <Card title="Amazon price monitor" icon="tag" href="/products/scrapers/tutorials/amazon-price-monitor">
        Schedule an async job over your SKU list and stream results into S3 for daily price and stock tracking.
      </Card>

      <Card title="Social listener" icon="bell" href="/products/scrapers/tutorials/social-listener">
        Use Google SERP as a discovery engine, then fan out to Instagram, TikTok and X scrapers to track mentions by keyword.
      </Card>
    </CardGroup>

    ## What you can build

    <CardGroup>
      <Card title="Lead enrichment" icon="user-magnifying-glass" href="/products/scrapers/linkedin/quickstart">
        Pull LinkedIn profiles and company data into your CRM or sales pipeline.
      </Card>

      <Card title="Price monitoring" icon="tag" href="/products/scrapers/amazon/quickstart">
        Track product prices, stock, and reviews across e-commerce sites.
      </Card>

      <Card title="Market research" icon="chart-line" href="/products/scrapers/instagram/quickstart">
        Aggregate social signals, competitor activity, and trending content.
      </Card>

      <Card title="AI training data" icon="robot" href="/concepts/web-scraper-api-vs-diy">
        Build large, structured datasets to train and fine-tune models.
      </Card>

      <Card title="Job aggregation" icon="briefcase" href="/products/scrapers/linkedin/quickstart">
        Collect job listings from LinkedIn and other boards into a single feed.
      </Card>

      <Card title="Brand monitoring" icon="bell" href="/products/scrapers/twitter/quickstart">
        Track mentions, hashtags, and sentiment across social platforms.
      </Card>
    </CardGroup>

    ## Do I have to call the API directly?

    No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

    | Client | Install | First call |
    | :- | :- | :- |
    | **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | Call `client.scrape.<platform>.<endpoint>(url="...")`; the method list is in the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
    | **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines list` prints every pipeline name, then run `bdata pipelines <pipeline> "<url>" --pretty`; see the [CLI commands](/products/cli/commands) |
    | **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

    ## Where to learn more

    <CardGroup>
      <Card title="Concepts" icon="lightbulb">
        [Sync vs async](/concepts/sync-vs-async)

        [Scraper API vs DIY](/concepts/web-scraper-api-vs-diy)
      </Card>

      <Card title="Library reference" icon="book">
        [Custom inputs](/api-reference/scrapers/synchronous-requests#custom-inputs)

        [Working with sources](/products/scrapers/scrapers-library/working-with-sources)
      </Card>

      <Card title="API basics" icon="code-branch">
        [API reference](/api-reference/rest-api/scraper/asynchronous-requests)

        [Error codes](/products/scrapers/error-codes)

        [FAQs](/products/scrapers/scrapers-library/faqs)
      </Card>

      <Card title="Operations" icon="gauge-high">
        [Deliver results](/products/scrapers/scrapers-library/data-delivery)

        [Stream and file delivery](/products/scrapers/scrapers-library/stream-and-file-delivery)

        [Deadline on a trigger](/products/scrapers/scrapers-library/async-requests#limits-and-constraints)
      </Card>
    </CardGroup>
  </div>
</div>


# Reddit Scraper API
Source: https://docs.brightdata.com/products/scrapers/reddit/introduction

Use the Bright Data Reddit Scraper API to extract structured data from posts, comments and subreddits. Best for up to 20 URLs per sync request.

Send a Reddit URL or a keyword, get structured JSON back. The Bright Data Reddit Scraper API handles proxies, CAPTCHAs and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/reddit?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 Reddit records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more Reddit URLs or keywords to the Bright Data Reddit Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (posts or comments) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data Reddit Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/reddit/quickstart).

```json theme={null}
{
  "post_id": "t3_1w8chn8",
  "url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/",
  "user_posted": "xq_***x",
  "title": "found a for loop and can't find an explanation. Can someone explain, please?",
  "num_upvotes": 8,
  "num_comments": 14,
  "date_posted": "2026-09-05T21:03:33.625Z",
  "community_name": "learnpython",
  "community_members_num": 1053086,
  "description": "Hey there, I just started the Project Euler Archive and started with the classic \"Find the sum of all the multiples of 3 or 5 below 1000.\" And when I wanted..."
}
```

## Supported data types

<CardGroup>
  <Card title="Posts" icon="images" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Titles, descriptions, upvotes, community stats and attached media. Collect by post URL or discover by keyword or subreddit URL.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/reddit-comments-collect-by-url">
    Comment text, replies, upvotes and post context. Collect by post or comment URL, with optional day-based filtering.
  </Card>
</CardGroup>

## Which endpoints are available

The Reddit Scraper API exposes two dataset families. Each family supports one or more input shapes.

| Dataset | Input | What it returns |
| :- | :- | :- |
| **Posts, Collect by URL** (`gd_lvz8ah06191smkebj4`) | `url` (post URL) | A single post with metadata, community info and media |
| **Posts, Discover by keyword** (`gd_lvz8ah06191smkebj4`) | `keyword`, `date`, `num_of_posts` | Posts matching a search term, filtered by date |
| **Posts, Discover by subreddit URL** (`gd_lvz8ah06191smkebj4`) | `url` (subreddit URL), `sort_by` | Posts from one subreddit, sorted by `new`, `top` or `hot` |
| **Comments, Collect by URL** (`gd_lvzdpsdlw09j6t702`) | `url` (post or comment URL), `days_back` | Comments from a post with full thread context |

## Which dataset IDs to use

Each Reddit data type uses its own `dataset_id`. Pass the ID as a query parameter on every request. The three Posts endpoints share one ID.

| Data type | Dataset ID |
| :- | :- |
| Posts | `gd_lvz8ah06191smkebj4` |
| Comments | `gd_lvzdpsdlw09j6t702` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape against Reddit. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data Reddit Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

Reddit changes how its pages are served, and the Bright Data Reddit Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between Collect and Discover?

**Collect by URL** scrapes a specific Reddit page you provide, a single post, a comment thread or a subreddit. **Discover** finds Reddit posts matching search criteria such as a keyword or a subreddit listing, then scrapes the results. Discovery is most useful via async requests when you don't know the exact URLs up front.

### Can I collect only recent comments from a post?

Yes. The Comments API accepts an optional `days_back` parameter. Pass an integer to limit results to comments posted within that many days.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/reddit/quickstart">
    Scrape your first Reddit post in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/reddit/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Reddit scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/reddit/quickstart

Set up the Bright Data Reddit Scraper API and collect your first post, comment or subreddit as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape a Reddit post and get structured JSON data using the Bright Data Reddit Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/reddit?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+ or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/reddit?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Posts, Collect by URL** endpoint. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.reddit.posts(
              url="https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"
          )
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_lvz8ah06191smkebj4", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the returned records from `result.data`. It waits up to 240 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data Reddit Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of post data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data Reddit Scraper API returns a JSON array with structured post data:

    ```json theme={null}
    [
      {
        "post_id": "t3_1w8chn8",
        "url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/",
        "user_posted": "xq_***x",
        "title": "found a for loop and can't find an explanation. Can someone explain, please?",
        "description": "Hey there, I just started the Project Euler Archive and started with the classic \"Find the sum of all the multiples of 3 or 5 below 1000.\" And when I wanted...",
        "num_upvotes": 8,
        "num_comments": 14,
        "date_posted": "2026-09-05T21:03:33.625Z",
        "community_name": "learnpython",
        "community_url": "https://www.reddit.com/r/learnpython/"
      }
    ]
    ```

    Each post object includes post details, community stats, engagement metrics and attached media. See the [full response schema](/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first Reddit post using the Bright Data Reddit Scraper API.

## Common questions

### Can I scrape multiple posts in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches or for discovery by keyword or subreddit, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"},
  {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"},
  {"url": "https://www.reddit.com/r/programming/comments/1csdf56/"}
]
```

### Can I scrape comments from a post?

Yes, with the separate Comments dataset. Use dataset ID `gd_lvzdpsdlw09j6t702` and pass the post URL:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"}]'
```

You can also pass `days_back` to limit results to comments posted within the last N days.

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the Reddit post URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.reddit.com/r/{subreddit}/comments/{post_id}/{slug}/`. Private subreddits and deleted posts cannot be scraped.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | `client.scrape.reddit.posts(url="https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/")`; see the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines reddit_posts "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/reddit/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of posts or run keyword discovery in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Reddit Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/reddit/send-first-request

Send synchronous requests to every Bright Data Reddit Scraper API endpoint with copy-paste examples for posts, comments and subreddit data across 3 surfaces.

This guide shows you how to send a synchronous request to each Bright Data Reddit Scraper API endpoint. It covers collecting posts, discovering posts and collecting comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/reddit?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/reddit/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.reddit.com/..."}]
```

The only things that change between endpoints are the `dataset_id` and the input shape.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## Posts, Collect by URL

Scrape a specific Reddit post by its URL.

**Dataset ID:** `gd_lvz8ah06191smkebj4`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_lvz8ah06191smkebj4", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/"}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/" }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "post_id": "t3_1w8chn8",
      "url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/",
      "user_posted": "xq_***x",
      "title": "found a for loop and can't find an explanation. Can someone explain, please?",
      "description": "Hey there, I just started the Project Euler Archive and started with the classic \"Find the sum of all the multiples of 3 or 5 below 1000.\" And when I wanted...",
      "num_upvotes": 8,
      "num_comments": 14,
      "date_posted": "2026-09-05T21:03:33.625Z",
      "tag": null,
      "community_name": "learnpython"
    }
  ]
  ```
</Accordion>

[Full Posts - Collect by URL schema](/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url)

### Which output fields does the Reddit posts scraper return?

The Reddit posts scraper (`gd_lvz8ah06191smkebj4`, `collect_by_url`) returns 27 output fields.

<Accordion title="Output fields (27)">
  | Field | Type | Description |
  | - | - | - |
  | `post_id` | text | Post ID |
  | `url` | url | URL of the post |
  | `user_posted` | text | Username of the post creator |
  | `title` | text | Title of the post |
  | `description` | text | Post text description |
  | `num_comments` | number | Number of comments |
  | `date_posted` | date | Post publication date |
  | `community_name` | text | Name of the community |
  | `num_upvotes` | number | Number of upvotes |
  | `photos` | array | URLs of attached photos |
  | `videos` | array | URLs of attached videos |
  | `tag` | text | The name of the tag |
  | `related_posts` | array | Related posts |
  | `comments` | array | Comments of the post |
  | `community_url` | url | URL of the community |
  | `community_description` | text | Description of the community |
  | `community_members_num` | number | Number of community members |
  | `community_rank` | object | Community ranked |
  | `post_karma` | number | post\_karma |
  | `bio_description` | text | bio\_description |
  | `embedded_links` | array | embedded\_links |
  | `description_markdown` | text | Post content with original line breaks and Markdown formatting |
  | `subreddit_icon_image` | url | Subreddit icon image |
  | `author_icon` | url | Author icon link |
  | `user_id` | text | posting user unique id |
  | `archived` | text | archived |
  | `locked_post` | boolean | Indicator if the post is locked and new comments cannot be posted. |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lvz8ah06191smkebj4.json`](/scrapers/gd_lvz8ah06191smkebj4.json)

## Posts, Discover by subreddit URL

Scrape recent posts from a specific subreddit, optionally sorted with `sort_by`. Values are case-sensitive and match the labels on Reddit, for example `Hot`. Lowercase `hot` is rejected with a validation error.

**Dataset ID:** `gd_lvz8ah06191smkebj4`

<Note>
  Discovery endpoints are best used asynchronously via [`/trigger`](/products/scrapers/scrapers-library/async-requests) since they may return many results. The sync example below is for quick testing.
</Note>

<CodeGroup>
  ```bash cURL theme={null}
  # limit_per_input caps the records returned for each input
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=subreddit_url" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input": [{"url": "https://www.reddit.com/r/learnpython/", "sort_by": "Hot"}], "limit_per_input": 10}'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "format": "json",
          "type": "discover_new",
          "discover_by": "subreddit_url",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      # limit_per_input caps the records returned for each input
      json={
          "input": [{"url": "https://www.reddit.com/r/learnpython/", "sort_by": "Hot"}],
          "limit_per_input": 10,
      },
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=subreddit_url",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      // limit_per_input caps the records returned for each input
      body: JSON.stringify({
        input: [{ url: "https://www.reddit.com/r/learnpython/", sort_by: "Hot" }],
        limit_per_input: 10,
      }),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

[Full Discover by subreddit URL schema](/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-subreddit-url)

## Posts, Discover by keyword

Find Reddit posts matching a search term, filtered by date.

**Dataset ID:** `gd_lvz8ah06191smkebj4`

<CodeGroup>
  ```bash cURL theme={null}
  # limit_per_input caps the records returned for each input
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=keyword" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input": [{"keyword": "machine learning", "date": "Past week", "num_of_posts": 20}], "limit_per_input": 10}'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "format": "json",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      # limit_per_input caps the records returned for each input
      json={
          "input": [{"keyword": "machine learning", "date": "Past week", "num_of_posts": 20}],
          "limit_per_input": 10,
      },
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&format=json&type=discover_new&discover_by=keyword",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      // limit_per_input caps the records returned for each input
      body: JSON.stringify({
        input: [{ keyword: "machine learning", date: "Past week", num_of_posts: 20 }],
        limit_per_input: 10,
      }),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

[Full Discover by keyword schema](/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-keyword)

## Comments, Collect by URL

Scrape all comments from a Reddit post or a specific comment thread, with optional filtering by age.

**Dataset ID:** `gd_lvzdpsdlw09j6t702`

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/", "days_back": 7}]'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={"dataset_id": "gd_lvzdpsdlw09j6t702", "format": "json"},
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      json=[{"url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/", "days_back": 7}],
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvzdpsdlw09j6t702&format=json",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify([
        { url: "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/", days_back: 7 }
      ]),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "comment_id": "p841ojc",
      "user_posted": "rec***e",
      "comment": "[List\\_comprehension](https://en.wikipedia.org/wiki/List_comprehension) have an interesting history. It use in functional programming language which python a...",
      "date_posted": "2026-09-06T05:58:16.000Z",
      "num_upvotes": 1,
      "num_replies": 0,
      "replies": null,
      "post_url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/",
      "post_id": "1w8chn8",
      "post_type": null
    }
  ]
  ```
</Accordion>

[Full Comments - Collect by URL schema](/api-reference/scrapers/social-media-apis/reddit-comments-collect-by-url)

### Which output fields does the Reddit comments scraper return?

The Reddit comments scraper (`gd_lvzdpsdlw09j6t702`, `collect_by_url`) returns 34 output fields.

<Accordion title="Output fields (34)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | URL of comment |
  | `comment_id` | text | ID of comment |
  | `user_posted` | text | Username of the user who posted the comment |
  | `comment` | text | Description of the comment |
  | `date_posted` | date | Date posted |
  | `post_url` | url | URL of the post this comment appears at |
  | `post_id` | text | ID of the post this comment appears at |
  | `community_name` | text | The name of the community the comment was posted at |
  | `community_url` | text | URL of the community where the comment was posted at |
  | `community_description` | text | Description of the community this comment was posted at |
  | `community_members_num` | text | Number of community members where the comment was posted at |
  | `community_rank` | object | |
  | `replies` | array | |
  | `num_upvotes` | number | Number of comment's upvotes |
  | `num_replies` | number | Number of replies to the comment |
  | `days_back` | number | Reproduce from Input |
  | `is_moderator` | boolean | A post has a "MOD" icon - this means it was posted by a moderator or bot in some cases |
  | `is_pinned` | boolean | pinned or stickied comment, placed on top of all |
  | `has_bot_in_username` | boolean | The username has a substring "bot" - This parameter can be an indirect sign of a bot In most cases, but can also occur in common usernames |
  | `is_locked` | boolean | The post has a "lock" icon - this means that comments are blocked by moderators and no one but them can comment on them. This parameter can be an indirect sign of a bot |
  | `is_admin_post` | boolean | hidden is labeled as "distinguished admin" |
  | `is_archived_post` | boolean | Indicates whether the post is archived or not |
  | `is_moderator_post` | boolean | Specifies if the post is made by a moderator |
  | `is_quarantined_post` | boolean | Indicates if the post is quarantined |
  | `is_not_safe_for_work_post` | boolean | Flags whether the post contains content not safe for work |
  | `is_eligible_for_content_blocking_post` | boolean | Specifies if the post is eligible for content blocking |
  | `is_promoted_post` | boolean | Indicates if the post is promoted content |
  | `post_language` | text | Language in which the post is written |
  | `post_state` | text | Current state/status of the post |
  | `post_type` | text | Type or category of the post |
  | `images` | array | Images from the comment |
  | `parent_comment_id` | text | |
  | `root_comment_id` | text | Links all replies to the original root comment |
  | `videos` | array | Video and GIF URLs |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lvzdpsdlw09j6t702.json`](/scrapers/gd_lvzdpsdlw09j6t702.json)

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape thousands of posts or run keyword discovery jobs in a single async request.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url">
    Full endpoint specs, parameters and response schemas.
  </Card>
</CardGroup>


# Scraper API reference
Source: https://docs.brightdata.com/products/scrapers/scrapers-library/api-reference

Full API reference for the Bright Data Scraper API, including endpoints for triggering collections, retrieving snapshots, and managing jobs.



# How to scrape in bulk with async requests
Source: https://docs.brightdata.com/products/scrapers/scrapers-library/async-requests

Trigger bulk Scraper API jobs with the async /trigger endpoint, monitor snapshot progress and download results. Works with every Bright Data scraper.

Use the asynchronous `/trigger` endpoint to scrape more than the recommended 20 URLs in one job, run discovery collections or deliver results to a webhook or cloud storage. The workflow is the same for every Bright Data scraper: trigger, poll, download. Only the `dataset_id` changes.

<Tip>
  Not sure whether to use sync or async? Read [Understanding sync vs. async requests](/concepts/sync-vs-async).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with an active API key
* The `dataset_id` for the scraper you want to run, from the table below
* Familiarity with the synchronous request flow for your scraper, for example [LinkedIn Scraper API endpoints](/products/scrapers/linkedin/send-first-request)

## Which dataset ID do I use?

Every scraper has its own `dataset_id`. The examples on this page use Instagram profiles discovered by username (`gd_l1vikfch901nx3by4`). Substitute the ID for the platform you are scraping.

| Scraper | Primary `dataset_id` | Endpoint reference |
| :- | :- | :- |
| LinkedIn | `gd_l1viktl72bvl7bjuj0` | [LinkedIn Scraper API](/products/scrapers/linkedin/introduction) |
| Instagram | `gd_l1vikfch901nx3by4` | [Instagram Scraper API](/products/scrapers/instagram/introduction) |
| TikTok | `gd_l1villgoiiidt09ci` | [TikTok Scraper API](/products/scrapers/tiktok/introduction) |
| Amazon | `gd_l7q7dkf244hwjntr0` | [Amazon Scraper API](/products/scrapers/amazon/introduction) |
| ChatGPT | `gd_m7aof0k82r803d5bjm` | [ChatGPT Scraper API](/products/scrapers/chatgpt/introduction) |
| Facebook | `gd_mf0urb782734ik94dz` | [Facebook Scraper API](/products/scrapers/facebook/introduction) |
| X (Twitter) | `gd_lwxmeb2u1cniijd7t4` | [X (Twitter) Scraper API](/products/scrapers/twitter/introduction) |
| YouTube | `gd_lk538t2k2p1k3oos71` | [YouTube Scraper API](/products/scrapers/youtube/introduction) |
| Reddit | `gd_lvz8ah06191smkebj4` | [Reddit Scraper API](/products/scrapers/reddit/introduction) |
| Google | `gd_m8ebnr0q2qlklc02fz` | [Google Scraper API](/products/scrapers/google/introduction) |

Each scraper exposes several endpoints, for example Amazon has separate IDs for products, reviews and sellers. The full list for each platform is on its introduction page, and every ID is browsable in the [scraper library](/products/scrapers/overview).

For the dataset ID of every pre-built scraper, including sites without an introduction page, read [scrapers.json](/scrapers.json). It lists the dataset ID, name, domain and collection methods of each scraper and refreshes daily. [scrapers-full.json](/scrapers-full.json) adds the input schema and output fields of every collection method. To get the same details through the API, call [Get all scrapers](/api-reference/scrapers/management-apis/get-scrapers) with your API key.

## Step 1: Trigger the collection

Send a `POST` request to the `/trigger` endpoint with an object body holding your inputs:

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"user_name":"zoobarcelona"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1vikfch901nx3by4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "user_name",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={"input": [{"user_name": "zoobarcelona"}], "limit_per_input": None},
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js (Axios) theme={null}
  import axios from "axios";

  const response = await axios.post(
    "https://api.brightdata.com/datasets/v3/trigger",
    { input: [{ user_name: "zoobarcelona" }], limit_per_input: null },
    {
      params: {
        dataset_id: "gd_l1vikfch901nx3by4",
        notify: false,
        include_errors: true,
        type: "discover_new",
        discover_by: "user_name",
      },
      headers: { Authorization: "Bearer YOUR_API_KEY" },
    }
  );

  console.log("Snapshot ID:", response.data.snapshot_id);
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l1vikfch901nx3by4",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "user_name",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/trigger?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ input: [{ user_name: "zoobarcelona" }], limit_per_input: null }),
  });

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

You should see a `200` response with a `snapshot_id`:

```json theme={null}
{
  "snapshot_id": "sd_m1a2b3c4d5e6f7g8h"
}
```

Save this ID. You need it to check progress and download results.

## Step 2: Monitor progress

Poll the snapshot status until it shows `ready`, and stop if it shows `failed` or `canceled`. This takes 30 seconds to several minutes depending on the number of URLs.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/progress/sd_m1a2b3c4d5e6f7g8h" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import time
  import requests

  snapshot_id = "sd_m1a2b3c4d5e6f7g8h"

  for attempt in range(60):  # stop after about 10 minutes
      status_response = requests.get(
          f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}",
          headers={"Authorization": "Bearer YOUR_API_KEY"},
      )
      status_response.raise_for_status()
      progress = status_response.json()
      status = progress.get("status")
      print(f"Status: {status}")

      if status == "ready":
          break
      if status in ("failed", "canceled"):
          raise RuntimeError(f"Snapshot {status}: {progress.get('error_message', 'no details')}")
      time.sleep(10)
  else:
      raise TimeoutError("Snapshot was not ready after 10 minutes")
  ```

  ```javascript Node.js theme={null}
  const snapshotId = "sd_m1a2b3c4d5e6f7g8h";
  const maxAttempts = 60; // stop after about 10 minutes

  for (let attempt = 1; ; attempt++) {
    const statusResponse = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshotId}`,
      { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
    );
    if (!statusResponse.ok) throw new Error(`HTTP ${statusResponse.status}`);
    const progress = await statusResponse.json();
    console.log("Status:", progress.status);

    if (progress.status === "ready") break;
    if (progress.status === "failed" || progress.status === "canceled") {
      throw new Error(`Snapshot ${progress.status}: ${progress.error_message ?? "no details"}`);
    }
    if (attempt === maxAttempts) throw new Error("Snapshot was not ready after 10 minutes");
    await new Promise((r) => setTimeout(r, 10000));
  }
  ```
</CodeGroup>

Status values:

| Status | Meaning |
| :- | :- |
| `starting` | The job is queued and has not begun scraping |
| `running` | Scraping is in progress |
| `ready` | Results are available for download |
| `failed` | The collection encountered an error |
| `canceled` | The job was canceled before it finished |

## Step 3: Download results

Once the status is `ready`, download the scraped data:

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/datasets/v3/snapshot/sd_m1a2b3c4d5e6f7g8h?format=json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -o results.json
  ```

  ```python Python theme={null}
  results_response = requests.get(
      f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}",
      params={"format": "json"},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )

  results = results_response.json()
  print(f"Collected {len(results)} records")
  ```

  ```javascript Node.js theme={null}
  const resultsResponse = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshotId}?format=json`,
    { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
  );

  const results = await resultsResponse.json();
  console.log(`Collected ${results.length} records`);
  ```
</CodeGroup>

You have triggered, monitored and downloaded a batch scraping job.

## Skip polling with webhooks

If you don't want to poll for status, add an `endpoint` parameter to receive results automatically:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"user_name":"zoobarcelona"}],"limit_per_input":null}' \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name&endpoint=https://your-server.com/webhook"
```

See [Deliver results to webhooks and cloud storage](/products/scrapers/scrapers-library/data-delivery) for the full setup.

## Limits and constraints

Input size, running job, download and delivery limits for the Scraper API are listed in one table on [Scraper API limits](/products/scrapers/limits).

The `deadline` query parameter sets how long the trigger request waits before returning an error: a duration such as `3m`, `15min` or `2h`, or an ISO timestamp such as `2026-09-30T18:00:00.000Z`. Without it the request returns a `snapshot_id` at once.

### How to limit records per input

When running a discovery collection, you can cap the number of results returned per input. In the API, set `limit_per_input` in the request body, next to `input`.

With `"limit_per_input": 10`, each input returns at most 10 records.

## Troubleshooting

Scraper API HTTP errors and record errors are listed with their meaning on [Scraper API error codes](/products/scrapers/error-codes).

### Getting a 429 Too Many Requests error?

You receive `429 Too Many Requests` when you exceed the concurrent job limit, 5,000 active jobs or snapshots. Bright Data blacklists any IP that collects 25 or more 429 responses within 5 minutes, and a blacklisted IP is blocked from every API request until [support](mailto:support@brightdata.com) clears it. So a 429 is a signal to slow down, not to retry at once.

1. Stop sending new requests as soon as you receive a 429.
2. Wait before retrying: the number of seconds in the `Retry-After` header if present, otherwise exponential backoff of 2, 4, 8, 16 and 32 seconds.
3. Reduce concurrency if 429s keep coming; you are over the limit.

<Warning>
  Ten or more 429 responses within 5 minutes means you are close to the 25-in-5-minutes blacklist threshold. Reduce the request rate right away.
</Warning>

<CodeGroup>
  ```python Bad: immediate retry theme={null}
  response = requests.post(api_url, json=data)

  if response.status_code == 429:
      requests.post(api_url, json=data)  # retrying at once is what gets an IP blacklisted
  ```

  ```python Good: Retry-After, then backoff theme={null}
  import time
  import requests

  resp = requests.post(api_url, json=data)

  if resp.status_code == 429:
      retry_after = resp.headers.get("Retry-After")
      wait_s = int(retry_after) if retry_after else 2
      time.sleep(wait_s)
      # retry after waiting, and double the wait if the 429 repeats
  ```
</CodeGroup>

If your IP is already blacklisted, [contact Bright Data support](mailto:support@brightdata.com) with the blocked address to request whitelisting.

### Snapshot status shows 'failed'?

Check that all input URLs are valid for the scraper you are calling. A LinkedIn URL sent to the Amazon `dataset_id` fails. Review the error details in the snapshot response or in the [Logs tab](https://brightdata.com/cp/scrapers) of your Bright Data dashboard.

### Results are incomplete or missing some URLs?

Some URLs may fail individually while the overall job succeeds. Check the snapshot response for any `errors` field. Retry failed URLs in a separate request.

## FAQ

### How many URLs can I send in one async request?

Async requests accept up to 1 GB of input data per job, which is tens of thousands of URLs. Bright Data recommends the synchronous endpoint for 20 URLs or fewer when you want the results in the same response. The 20-URL figure is a best practice, not a hard limit.

### How are inputs processed across concurrent requests?

All inputs are processed in parallel. Processing capacity is shared equally across all running jobs for a given scraper.

Start time does not affect priority either, jobs are not processed in first-in-first-out or last-in-first-out order. A job started an hour ago and a job started a minute ago receive the same share of capacity.

### Do I need a different dataset ID for each platform?

Yes. The `dataset_id` query parameter selects both the platform and the endpoint, for example Amazon products versus Amazon reviews. The table above lists the primary ID per platform, and each platform's introduction page lists the rest.

### How long does a snapshot stay available?

Snapshots are downloadable for 30 days after the job completes. Deliver results to a webhook or cloud storage if you need them retained longer.

## Related

* [Deliver results to webhooks and cloud storage](/products/scrapers/scrapers-library/data-delivery)
* [Understanding sync vs. async requests](/concepts/sync-vs-async)
* [Scraper API error codes](/products/scrapers/error-codes)


# How to deliver Scraper API results
Source: https://docs.brightdata.com/products/scrapers/scrapers-library/data-delivery

Deliver Bright Data Scraper API results to a webhook, Amazon S3, Google Cloud Storage or Snowflake. Destination table, IAM setup and the 14 webhook IPs.

This guide shows how to have Bright Data Scraper API jobs push results to your infrastructure instead of waiting for you to download them. Add an `endpoint` parameter for webhook delivery, or configure a cloud destination once and have every job write to it. The setup is identical for all scrapers; only the `dataset_id` changes.

<Tip>
  The examples use the Instagram profiles scraper (`gd_l1vikfch901nx3by4`), discovering profiles by username. Swap in the `dataset_id` for your platform from the [async requests table](/products/scrapers/scrapers-library/async-requests#which-dataset-id-do-i-use).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with an active API key
* Familiarity with the [async request workflow](/products/scrapers/scrapers-library/async-requests)
* For webhooks, a publicly accessible HTTPS endpoint (or a testing tool like [webhook.site](https://webhook.site))
* For a cloud destination, permission to create credentials in that account: an IAM role for Amazon S3, a service account key for Google Cloud, a user and role for Snowflake

## Which destination should I use?

Set a cloud destination once on the scraper's **Delivery settings** tab in the Control Panel. Set a webhook per request with the `endpoint` parameter. Both can be active for the same job.

| Destination | Best for | Setup |
| :- | :- | :- |
| API download | Testing and small jobs | Nothing. Fetch the snapshot with [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot) once it is ready |
| Webhook | Event-driven pipelines, payloads under 1 GB | The `endpoint` query parameter on the trigger request. See [webhook delivery](#how-to-deliver-results-to-a-webhook) |
| Amazon S3 | Large payloads, data lakes, retained history | A one-time IAM policy and role. See [S3 delivery](#how-to-deliver-results-to-amazon-s3) |
| Google Cloud Storage | Google Cloud data platforms | A one-time service account key. See [Google Cloud Storage delivery](#how-to-deliver-results-to-google-cloud-storage) |
| Snowflake | Loading straight into a warehouse | A one-time database, stage, role and user. See [Snowflake delivery](#how-to-deliver-results-to-snowflake) |
| Google Cloud Pub/Sub | Message-driven pipelines | The topic and credentials in the Control Panel |
| Microsoft Azure Storage | Azure data platforms | The container and credentials in the Control Panel |
| SFTP or FTP | Servers without a cloud API | The host, path and credentials in the Control Panel |

## Which output formats can I use?

Scraper API output formats are NDJSON (default), JSON, JSON lines, CSV and Parquet. Each one has its own API value, and not every value is accepted everywhere:

| Format | API value | `format` on `/scrape` | `format` on `/trigger` | `deliver.filename.extension` |
| :- | :- | :- | :- | :- |
| NDJSON (default) | `ndjson` | Yes | Yes | Yes |
| JSON | `json` | Yes | Yes | Yes |
| JSON lines | `jsonl` | Yes | Yes | Yes |
| CSV | `csv` | Yes | Yes | Yes |
| Parquet | `parquet` | Not listed | Not listed | Yes |

A `/scrape` request or a snapshot download with no `format` returns NDJSON, one record per line. Set `format=json` to get a JSON array instead. Verified on September 30, 2026.

"Not listed" means the value is not in the API specification for that parameter. NDJSON and JSON lines are separate API values, `ndjson` and `jsonl`.

## What are streamed delivery and file delivery?

Streamed delivery and file delivery change what a delivery contains:

* **Streamed delivery** sends results in batches of 10 to 100,000 lines while the job is still running, instead of one file when the job ends.
* **File delivery** adds the raw HTML, WARC or screenshot of each page next to the records.

Both need a storage or webhook destination, not API download. See [How to stream results and deliver files](/products/scrapers/scrapers-library/stream-and-file-delivery).

## How to deliver results to a webhook

When you trigger an async collection with an `endpoint` URL, Bright Data sends a `POST` request to that URL with the scraped data once the job completes. No polling required.

```text theme={null}
Your app --> POST /trigger (with webhook URL) --> Bright Data scrapes --> POST to your webhook
```

### Step 1: Set up a test webhook

For testing, use [webhook.site](https://webhook.site) to get a temporary public URL:

1. Open [webhook.site](https://webhook.site) in your browser
2. Copy the unique URL displayed (e.g., `https://webhook.site/abc-123-def`)
3. Keep the page open to monitor incoming requests

### Step 2: Trigger a collection with the webhook URL

Add the `endpoint` query parameter to your async `/trigger` request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"user_name":"zoobarcelona"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name&endpoint=https://webhook.site/abc-123-def&uncompressed_webhook=true"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1vikfch901nx3by4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "user_name",
          "endpoint": "https://webhook.site/abc-123-def",
          "uncompressed_webhook": "true",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={"input": [{"user_name": "zoobarcelona"}], "limit_per_input": None},
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js (Axios) theme={null}
  import axios from "axios";

  const response = await axios.post(
    "https://api.brightdata.com/datasets/v3/trigger",
    { input: [{ user_name: "zoobarcelona" }], limit_per_input: null },
    {
      params: {
        dataset_id: "gd_l1vikfch901nx3by4",
        notify: false,
        include_errors: true,
        type: "discover_new",
        discover_by: "user_name",
        endpoint: "https://webhook.site/abc-123-def",
        uncompressed_webhook: true,
      },
      headers: { Authorization: "Bearer YOUR_API_KEY" },
    }
  );

  console.log("Snapshot ID:", response.data.snapshot_id);
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l1vikfch901nx3by4",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "user_name",
    endpoint: "https://webhook.site/abc-123-def",
    uncompressed_webhook: "true",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/trigger?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ input: [{ user_name: "zoobarcelona" }], limit_per_input: null }),
  });

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</CodeGroup>

Key parameters:

| Parameter | Description |
| :- | :- |
| `endpoint` | Your HTTP endpoint URL that receives the `POST` payload |
| `uncompressed_webhook` | Set to `true` to receive uncompressed JSON (default is gzip) |
| `format` | Output format: `json`, `ndjson`, `jsonl` or `csv`. See [output formats](#which-output-formats-can-i-use) |

### Step 3: Verify delivery

Once the collection completes (typically 30-60 seconds for a few records), check your webhook.site page. You should see a `POST` request with the scraped data.

The payload is the same JSON array you would receive from a direct API download:

Each record is an Instagram profile. The fields are listed in the [Discover by username response sample](/api-reference/scrapers/social-media-apis/instagram-profiles-discover-by-username).

### How to handle webhooks in production

For production, point the `endpoint` URL to your own server endpoint.

```javascript server.js theme={null}
const express = require("express");
const app = express();

app.use(express.json({ limit: "100mb" }));

app.post("/webhook/scraper", (req, res) => {
  const records = req.body;
  console.log(`Received ${records.length} records`);

  for (const record of records) {
    console.log(`- ${record.account}`);
  }

  res.status(200).json({ received: true });
});

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

```python server.py theme={null}
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/webhook/scraper", methods=["POST"])
def handle_webhook():
    records = request.get_json()
    print(f"Received {len(records)} records")

    for record in records:
        print(f"- {record.get('account')}")

    return jsonify({"received": True}), 200

if __name__ == "__main__":
    app.run(port=3000)
```

<Warning>
  Return a `200` status code within 30 seconds to acknowledge receipt. If your endpoint fails or times out, Bright Data retries delivery.
</Warning>

### How to authenticate webhook deliveries

If your endpoint requires authentication, add the `auth_header` parameter. Bright Data sends its value as the `Authorization` header on every delivery to that endpoint. Verified on September 7, 2026. Earlier versions of this page named the parameter `webhook_header_Authorization`; the API ignores that name and delivers with no `Authorization` header, so replace it if you copied it.

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"user_name":"zoobarcelona"}],"limit_per_input":null}' \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name&endpoint=https://your-server.com/webhook&auth_header=Bearer+YOUR_SECRET_TOKEN"
```

### Which headers does a delivery carry?

Every webhook delivery is a `POST` with `Content-Type: application/json; charset=utf-8`, a `User-Agent` starting with `BRD dca-stage-deliver`, a `dca-collection-id` header holding the snapshot ID and a `dca-filename` header naming the file. Match deliveries to jobs with `dca-collection-id` rather than parsing the body. Observed on September 7, 2026.

### Which IPs do webhooks come from?

If your server uses an IP allowlist, add the following 14 Bright Data webhook source IPs. Every asynchronous webhook delivery from Bright Data, across the Scraper API, the AI scrapers and the SERP API, comes from one of them.

```text theme={null}
54.175.27.69
34.225.9.175
100.28.38.247
100.29.18.195
52.72.185.255
35.174.112.248
54.165.183.124
3.91.140.7
52.202.75.37
98.82.225.117
100.27.150.189
18.214.10.85
35.169.71.210
44.194.183.74
```

## How to deliver results to Amazon S3

Set up an IAM role once, then add a `deliver` block to each `/trigger` request that should write to your bucket.

### Step 1: Create the IAM policy and role

Bright Data writes to your bucket by assuming an IAM role in your AWS account. Create a policy that allows the writes, a role that Bright Data's delivery role can assume, and attach the role to the bucket.

<Frame>
  <img alt="How a delivery reaches an S3 bucket through an assumed IAM role" />
</Frame>

<Steps>
  <Step title="Create a policy">
    In the IAM console, open **Policies** and create a policy that allows `PutObject` and `GetObject` on the bucket.

    <Frame>
      <img alt="The Policies section of the IAM console" />
    </Frame>

    ```json theme={null}
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:PutObject", "s3:GetObject"],
          "Resource": "arn:aws:s3:::NAME-OF-YOUR-BUCKET/*"
        }
      ]
    }
    ```
  </Step>

  <Step title="Create a role">
    Open **Roles**, create a role, and attach the policy from step 1 under **Permission policies**. Note the role's ARN; it looks like `arn:aws:iam::<ROLE_ID>:role/<ROLE_NAME>` and goes into `credentials.role_arn`.

    <Frame>
      <img alt="The Roles section of the IAM console" />
    </Frame>

    The role's trust policy lets Bright Data's delivery role assume it. The external ID in the condition is the value you send as `credentials.external_id`:

    ```json theme={null}
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Principal": {
            "AWS": "arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery"
          },
          "Action": "sts:AssumeRole",
          "Condition": {
            "StringEquals": {
              "sts:ExternalId": "YOUR EXTERNAL ID"
            }
          }
        }
      ]
    }
    ```
  </Step>

  <Step title="Attach the role to the bucket">
    On the bucket, grant the role from step 2 access by its ARN.
  </Step>
</Steps>

### Step 2: Trigger a collection with an S3 `deliver` block

Add a `deliver` object to the `/trigger` request body, next to `input`. Bright Data writes the results of this job to your bucket:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [{"user_name": "zoobarcelona"}],
    "limit_per_input": null,
    "deliver": {
      "type": "s3",
      "bucket": "your-bucket-name",
      "credentials": {
        "role_arn": "arn:aws:iam::<ROLE_ID>:role/<ROLE_NAME>",
        "external_id": "YOUR_EXTERNAL_ID"
      },
      "filename": {"template": "{[snapshot_id]}", "extension": "json"}
    }
  }' \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name"
```

| `deliver` field | Description |
| :- | :- |
| `type` | `s3` |
| `bucket` | Your S3 bucket name. Required |
| `credentials` | `role_arn` and `external_id` from Step 1. Access keys work too: `aws-access-key` and `aws-secret-key` |
| `endpoint_url` | Host of S3-compatible storage. Only with access keys |
| `region` | Your S3 bucket region |
| `filename.template` | File name, with placeholders such as `{[snapshot_id]}`. Required |
| `filename.extension` | File format, for example `json`, `csv` or `parquet`. Required. See [output formats](#which-output-formats-can-i-use) |

### Step 3: Verify delivery

Once the collection completes, check your S3 bucket for the delivered file:

```bash theme={null}
aws s3 ls s3://your-bucket-name/
```

You should see a file named with the snapshot ID (e.g., `sd_m1a2b3c4d5e6f7g8h.json`). Download and inspect it:

```bash theme={null}
aws s3 cp s3://your-bucket-name/sd_m1a2b3c4d5e6f7g8h.json ./results.json
cat results.json | python -m json.tool | head -20
```

You can also verify delivery status using the [Monitor Delivery API](/api-reference/scrapers/management-apis/monitor-delivery).

## How to deliver results to Google Cloud Storage

Google Cloud Storage delivery authenticates with a service account key. Create the key, then paste its private key into the scraper's delivery settings.

1. Open the [Google Cloud console](https://console.cloud.google.com/), expand the menu and open **IAM & Admin**.

2. Click **Service accounts**.

   <Frame>
     <img alt="The Service accounts page under IAM and Admin" />
   </Frame>

3. Choose an existing service account or create one. If the button is missing, create a project first.

   <Frame>
     <img alt="The Create service account button" />
   </Frame>

   <Frame>
     <img alt="Creating a project before a service account" />
   </Frame>

4. Enter the name, ID and description, grant the account access to the bucket, and create it.

   <Frame>
     <img alt="The service account details form" />
   </Frame>

5. Click the service account's email address.

   <Frame>
     <img alt="The service account list with the email column" />
   </Frame>

6. Open the **Keys** tab, click **Add key**, then **Create new key**.

   <Frame>
     <img alt="The Add key menu on the Keys tab" />
   </Frame>

7. Choose **JSON**. The key file downloads to your machine.

   <Frame>
     <img alt="Choosing JSON as the key type" />
   </Frame>

8. Copy the `private_key` value from the downloaded file into the scraper's delivery settings, with the bucket name and the file format.

   <Frame>
     <img alt="The private_key field inside the downloaded JSON key file" />
   </Frame>

Trigger a collection as normal. Results land in the bucket without extra parameters.

## How to deliver results to Snowflake

Bright Data loads data through an internal named stage, using a user and role you create for it. Run the following in your Snowflake account, then enter the values in the scraper's delivery settings.

<Steps>
  <Step title="Choose or create a database">
    ```sql theme={null}
    CREATE DATABASE <database>;
    ```
  </Step>

  <Step title="Choose or create a schema">
    Every database has a `PUBLIC` schema. To use another one:

    ```sql theme={null}
    CREATE SCHEMA <schema>;
    ```
  </Step>

  <Step title="Choose or create a warehouse">
    Snowflake's guidance on sizing a warehouse for data loading applies; see [Warehouses overview](https://docs.snowflake.com/en/user-guide/warehouses-overview#impact-on-data-loading).

    ```sql theme={null}
    CREATE WAREHOUSE <warehouse>;
    ```
  </Step>

  <Step title="Choose or create an internal named stage">
    ```sql theme={null}
    CREATE STAGE <stage>;
    ```
  </Step>

  <Step title="Create a role that can write to the stage">
    ```sql theme={null}
    CREATE ROLE <role_name>;
    GRANT OPERATE ON WAREHOUSE <warehouse> TO ROLE <role_name>;
    GRANT WRITE ON STAGE <stage> TO ROLE <role_name>;
    ```
  </Step>

  <Step title="Create a user for Bright Data and grant it the role">
    ```sql theme={null}
    CREATE USER <user_name>
      PASSWORD = '<password>'
      LOGIN_NAME = <login>
      MUST_CHANGE_PASSWORD = FALSE
      DISABLED = FALSE
      COMMENT = 'user for Bright Data to upload data directly into Snowflake';

    GRANT ROLE <role_name> TO USER <user_name>;
    ```
  </Step>

  <Step title="Allowlist Bright Data's IPs if you use a network policy">
    If a [network policy](https://docs.snowflake.com/en/user-guide/network-policies) is active on the account, add these four addresses to it:

    ```sql theme={null}
    ALTER NETWORK POLICY <policy_name>
    SET ALLOWED_IP_LIST=(
      <existing_allowlisted_ips>,
      '35.169.71.210',
      '34.233.211.38',
      '44.194.183.74',
      '54.243.177.151');
    ```
  </Step>
</Steps>

Enter the database, schema, warehouse, stage, user and password in the scraper's delivery settings. For help with the setup, contact [support](mailto:support@brightdata.com).

## Troubleshooting

### Webhook not receiving data?

* Verify the URL is publicly accessible (not `localhost`)
* Check that your endpoint returns a `200` status code within 30 seconds
* Verify the 14 webhook IPs above are allowlisted if you have firewall rules

### Receiving compressed data?

If you omit `uncompressed_webhook=true`, data arrives gzip-compressed. Add `uncompressed_webhook=true` to your trigger URL, or decompress the payload on your server.

### Payload too large for your server?

Large collections can produce payloads up to 1 GB. Set `express.json({ limit: "100mb" })` in Express.js or equivalent in your framework. For very large datasets, use S3 delivery instead.

### Files not appearing in S3?

* Verify the IAM role ARN and external ID are correct
* Check that the bucket policy allows `s3:PutObject` from Bright Data's account
* Ensure the bucket region matches your configuration
* Review delivery status in the Bright Data dashboard under **Logs**

### Access denied errors on S3?

Verify the trust policy on your IAM role names Bright Data's delivery role in account `422310177405` and that the external ID in the trust policy matches the `external_id` you send.

## FAQ

### Does delivery configuration differ per platform?

No. Webhook parameters and cloud destination setup are identical for every Bright Data scraper. Only the `dataset_id` in the trigger request changes.

### Can I use a webhook and cloud storage at the same time?

Yes. Cloud delivery is configured per scraper in the Control Panel, and the `endpoint` parameter is set per request, so a single job can do both.

### What happens if my webhook is down when a job finishes?

Bright Data retries delivery. If your endpoint stays unavailable, download the snapshot directly using the `snapshot_id` returned by the trigger call; snapshots stay available for 30 days.

## Related

* [How to scrape in bulk with async requests](/products/scrapers/scrapers-library/async-requests)
* [How to stream results and deliver files](/products/scrapers/scrapers-library/stream-and-file-delivery)


# Scraper API FAQs
Source: https://docs.brightdata.com/products/scrapers/scrapers-library/faqs

Answers to the questions developers ask about the Bright Data Scraper API: setup, dataset IDs, sync and async requests, snapshots, delivery, billing and platform limits.

This page answers the questions developers ask most about the Bright Data Scraper API, from the first request to snapshot delivery and billing.

## Getting started

### What is the Scraper API?

The Bright Data Scraper API extracts fresh data on demand from websites through thousands of pre-built scrapers. You send a URL or a search input, and the API returns structured records in NDJSON (default), JSON, JSON lines, CSV and Parquet. Use it to automate data collection and feed other systems without writing or maintaining scrapers.

### How do I get started?

Open a Bright Data account, [create an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) in account settings, then follow the [quickstart](/quickstart), or the quickstart for your target site listed in the [Scraper API overview](/products/scrapers/overview). The first request is one `POST` call.

### How do I authenticate?

Send the API key in the `Authorization` header of every request:

```text theme={null}
Authorization: Bearer YOUR_API_KEY
```

### How do I test a scraper without writing code?

Open the scraper in the [Control Panel](https://brightdata.com/cp/scrapers/browse), enter your inputs, choose synchronous or asynchronous mode and a delivery method, then copy the generated code from the Code examples panel. The same panel shows the dataset ID pre-filled. A tool such as [webhook.site](https://webhook.site/) or [Postman](https://web.postman.co/) is enough to run it.

### What is a dataset ID and where do I find it?

A dataset ID identifies one scraper and goes in the `dataset_id` query parameter of every request. It looks like `gd_l1viktl72bvl7bjuj0`. Find it in four places:

* In [scrapers.json](/scrapers.json), which lists the dataset ID, name, domain and collection methods of every pre-built scraper. No API key is needed.
* Through the [Get all scrapers](/api-reference/scrapers/management-apis/get-scrapers) API, which returns each scraper's dataset ID, input schema and output fields. The API needs an API key.
* In the browser URL when you open a scraper in the Control Panel: `/cp/scrapers/gd_...`.
* In the Code examples panel on the scraper's Configuration tab, pre-filled in the cURL command.

An ID that starts with `sd_`, for example `sd_m7hm4et0141r2rhojq`, is a snapshot ID, not a dataset ID. A snapshot is the data collected by one request.

### Which sites have a scraper?

Thousands of pre-built scrapers cover LinkedIn, Instagram, TikTok, Amazon, Google Maps and many more sites. Browse the full list in the [Control Panel](https://brightdata.com/cp/scrapers/browse); the ten most used platforms have their own [documentation](/products/scrapers/overview). For a site without a scraper, build one with [Scraper Studio](/products/scraper-studio/overview) or ask about [managed services](https://brightdata.com/pricing/managed-services).

### What is the difference between collect and discover scrapers?

Each scraper takes different inputs. There are two kinds:

* **Collect** scrapers take URLs and extract the detail page behind each one: product specifications, prices, profile fields.
* **Discover** scrapers find new records from a search input such as a keyword, a category URL or a location, then collect each result. The same site can have several discover scrapers, one per search method.

Discover scrapers also run in **discovery-only mode**, which returns the URLs found during the discovery phase without visiting each page. With the mode off, the scraper continues to every page found and extracts its data.

<Frame>
  <img alt="Collect scrapers take URLs; discover scrapers find records from a search input" />
</Frame>

## Requests and results

### What is the difference between Synchronous and Asynchronous in the Control Panel?

The two labels map to the two API endpoints:

| Control Panel label | Endpoint | Use when |
| - | - | - |
| **Synchronous (Real-time)** | `POST /datasets/v3/scrape` | You need results in the same response for a handful of URLs |
| **Asynchronous** | `POST /datasets/v3/trigger` | You are processing bulk URLs, discovery tasks or large jobs |

A synchronous request waits up to 1 minute. If the job needs longer, the response is HTTP `202` with a `snapshot_id` and the job continues asynchronously. See [Understanding sync vs. async requests](/concepts/sync-vs-async).

### How fast is the Scraper API?

Response time depends on the target site and the scraper's workload, and Bright Data does not publish a fixed figure. Collect scrapers with a few URLs usually return within the 1-minute synchronous window. Discover scrapers take longer because they visit many pages, so run them asynchronously. Each scraper's page in the Control Panel shows an indication of its average run time.

### Which output formats are supported?

NDJSON (default), JSON, JSON lines, CSV and Parquet. Set the `format` query parameter on `/scrape` or `/trigger`, or `deliver.filename.extension` for delivered files. `/scrape` accepts `json`, `ndjson`, `jsonl` and `csv`; Parquet is a delivered file format. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

### What does an empty snapshot mean?

An empty snapshot holds no usable records. It usually still contains error records that explain why: invalid inputs, access restrictions, or dead pages such as a 404 or a removed product. Add `include_errors=true` to the request to see them.

### How long is a snapshot available?

30 days after the job completes. Download it through the [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot) endpoint with the snapshot ID, or deliver it to storage or a webhook.

## Managing snapshots

### Where do I get a snapshot ID?

The response to `POST /datasets/v3/trigger` returns one. A synchronous request that runs past 1 minute also returns one in its `202` response. List every snapshot on the account with [Get snapshots](/api-reference/scrapers/management-apis/get-snapshots).

### How do I cancel a running snapshot?

Send a `POST` to [`/datasets/v3/snapshot/{snapshot_id}/cancel`](/api-reference/scrapers/management-apis/cancel-snapshot):

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/snapshot/SNAPSHOT_ID/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

In the Control Panel, open the scraper's **Logs** tab, hover over the running snapshot and click **X**. A canceled snapshot delivers no data, and a snapshot that has finished collecting cannot be canceled.

### Can I rerun a failed snapshot?

Yes, with the [Rerun snapshot](/api-reference/scrapers/management-apis/rerun-snapshot) endpoint:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/snapshot/SNAPSHOT_ID/rerun" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### How do I retrieve the inputs I sent?

Call [Get snapshot input](/api-reference/scrapers/management-apis/get-snapshot-input):

```bash theme={null}
curl "https://api.brightdata.com/datasets/v3/snapshot/SNAPSHOT_ID/input" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### What is the difference between the notify URL and the webhook endpoint?

The `notify` URL receives a short status message when the job finishes: the snapshot ID and its status, not the data. The `endpoint` URL receives the data itself as soon as the snapshot is ready. Use `notify` to trigger your own download; use `endpoint` to have Bright Data push the records. See [How to deliver results to a webhook or S3](/products/scrapers/scrapers-library/data-delivery).

## Delivering a snapshot

These questions concern [Deliver snapshot](/api-reference/scrapers/delivery-apis/deliver-snapshot), `POST /datasets/v3/deliver/{snapshot_id}`, which pushes an existing snapshot to a storage destination.

### What do I do with the delivery job ID in the response?

The `id` in the response is a delivery job ID. Poll [`GET /datasets/v3/delivery/{delivery_id}`](/api-reference/scrapers/management-apis/monitor-delivery) until its status is `done`.

### Does the snapshot need to be in a specific status?

Yes, `ready`. Check with [`GET /datasets/v3/progress/{snapshot_id}`](/api-reference/scrapers/management-apis/monitor-progress) first. The possible statuses are `starting`, `running`, `ready`, `failed` and `canceled`. You can deliver the same snapshot to several destinations by calling the endpoint once per destination.

### How do I keep delivered files under the size limit?

Each delivered file has a hard limit of 5 GB. Set `batch_size` to the number of records per file: divide 5 GB by your average record size, start lower and adjust from the file sizes you receive. With records of about 5 KB, a `batch_size` of 1,000,000 lands at the limit, so start around 500,000. A `400` from this endpoint most often means the `batch_size` produced a file over 5 GB. Set `compress: true` to receive gzip-compressed files.

## Billing and plans

### Is there a free trial?

Every new Bright Data account gets **5,000 free credits every month**, with no credit card required. The Scraper API costs one credit per record, so the allowance covers up to 5,000 records. Credits renew on the first of each month. See the [free tier](/general/account/billing-and-pricing/free-tier).

### How is the Scraper API priced?

Per delivered record. Records that fail because the input was incorrect are still billed, because the request consumed resources. As of September 2026, pay as you go is \$1.50 per 1,000 records and the Scale plan is \$1.30 per 1,000 records beyond its included volume. Check the [pricing page](https://brightdata.com/pricing/web-scraper) or your account for current rates.

### How do I upgrade my plan?

Open the billing section of the Control Panel and select the plan. For anything else, contact [support](mailto:support@brightdata.com).

### What do I do if my API key expires?

Account admins create a new key in account settings.

<Frame>
  <img alt="Account settings showing no active API key, with the button to create a new one" />
</Frame>

Account users ask their account admin for a new key.

<Frame>
  <img alt="A user account with no API key, which only an admin can issue" />
</Frame>

## Platform limits and specific scrapers

### Are there limits on specific scrapers or sites?

Three platforms have limits worth knowing before you build on them:

* **Instagram**: media links in the response expire 24 hours after collection. Download the media you need within that window.
* **TikTok**: media is only accessible with a token generated in the same session, so store the record, not the media URL.
* **LinkedIn**: post collection is limited to the posts a profile shows publicly, typically about 10. Since November 13, 2025 the Position, Experience and Education profile fields are served from cache; see the [LinkedIn Scraper API introduction](/products/scrapers/linkedin/introduction).

### Is there a scraper for hotel data?

Yes. The [Google Scraper API](/products/scrapers/google/introduction) includes a Google Hotels scraper that collects hotel listings by URL. For a site the library does not cover, build a custom scraper with [Scraper Studio](/products/scraper-studio/overview).

### How do I scrape Google Maps reviews?

Open the Google Maps reviews scraper in the Control Panel or send the request from code, pass the place URL and the number of days of reviews to retrieve, then run it and collect the data. The [Google Scraper API endpoints](/products/scrapers/google/send-first-request) page shows the request.

### Does the ChatGPT scraper run with web search active?

Web search is on by default. Pass `web_search: false` in the input to disable it, and read `web_search_triggered` in the response to confirm whether a search ran. See [Query fan-out and web search control](/products/scrapers/concepts/query-fan-out).

### Can I view the code behind a scraper?

No. Pre-built scrapers are closed; their code cannot be viewed or modified. To see how scrapers work, create a new scraper in [Scraper Studio](/products/scraper-studio/overview), which offers example templates you can read and adapt.

## Choosing the right product

### Which Bright Data product gives me the data I need?

* **Ready-made data**: the [Dataset Marketplace](/products/marketplace/dataset-view) sells datasets Bright Data has already collected and refreshes on a schedule.
* **Fresh data from a supported site**: a [pre-built scraper](/products/scrapers/overview) in the Scraper API returns records on demand.
* **Fresh data from any other site**: build a scraper in [Scraper Studio](/products/scraper-studio/overview), or have Bright Data build and run one through [managed services](https://brightdata.com/pricing/managed-services).

### What are the Scraper API's typical use cases?

Competitive benchmarking, price monitoring, market research, sentiment analysis and training data for machine learning pipelines, across e-commerce, fintech and social media analytics. The [tutorials](/products/scrapers/tutorials/social-listener) walk through three of them end to end.


# How to stream results and deliver files
Source: https://docs.brightdata.com/products/scrapers/scrapers-library/stream-and-file-delivery

Configure streamed delivery to receive large snapshots in real-time batches across all scrapers, or file delivery to retrieve raw page files alongside data.

This guide shows you how to use two advanced delivery features for scrapers: **streamed delivery** for large snapshots and **file delivery** to retrieve raw page files with your data.

<Info>
  **Prerequisites:**

  * A Bright Data account with an active scraper
  * Delivery method set to **Storage** or **Webhook** (both features require this)
</Info>

***

## How to stream delivery in batches

When a snapshot is large, streamed delivery lets you receive results immediately as they're collected, in batches, rather than waiting for the full snapshot to complete.

### Enable streamed delivery

#### Control panel

1. Open your scraper's **Delivery settings** tab.
2. Toggle **Stream results** on.
3. Enter how many data lines each batch should contain.

<Frame>
  <img alt="Stream results toggle in Delivery settings" />
</Frame>

#### Scraper API parameter

Add `&stream_max_lines=1000` to your Scraper API request:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&stream_max_lines=1000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"url":"https://www.amazon.com/dp/B0FQFB8FMG"}]}'
```

### Limits

| Setting | Value |
| - | - |
| Minimum batch size | 10 lines |
| Maximum batch size | 100,000 lines |

<Warning>
  Streamed delivery requires a **Storage** or **Webhook** delivery method. It is not compatible with API download.
</Warning>

***

## How to deliver raw page files

File delivery lets you retrieve raw page files (HTML snapshots, WARC archives, or screenshots) alongside your scraped data.

### How to enable file delivery

Add `&download_fields=` to your Scraper API request with one or more of the available file types:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&download_fields=html" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"url":"https://www.amazon.com/dp/B0FQFB8FMG"}]}'
```

To request multiple file types, pass them as a comma-separated list:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&download_fields=html,screenshot" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":[{"url":"https://www.amazon.com/dp/B0FQFB8FMG"}]}'
```

### Available file types

| Type | Availability | Description |
| - | - | - |
| `html` | Always available | Raw HTML of the scraped page |
| `warc` | Not always available | Full WARC archive including request and response |
| `screenshot` | Not always available | Screenshot of the page at time of scraping |

<Warning>
  File delivery works only when the delivery method is set to **Storage** or **Webhook**.
</Warning>

***

## Related

<CardGroup>
  <Card title="Deliver results" icon="truck" href="/products/scrapers/scrapers-library/data-delivery">
    Configure your storage destination and output format
  </Card>

  <Card title="API reference" icon="code" href="/products/scrapers/scrapers-library/api-reference">
    Full API parameters for triggering and managing snapshots
  </Card>
</CardGroup>


# How to set up success rate alerts
Source: https://docs.brightdata.com/products/scrapers/scrapers-library/success-rate

Turn on per-scraper email alerts in the Bright Data Control Panel so your team hears when a Scraper API scraper's success rate drops below a threshold and when it recovers.

This guide shows you how to turn on email alerts for one Scraper API scraper in the Bright Data Control Panel, so your team is told when its success rate drops below a threshold you choose and again when it recovers.

## Prerequisites

* A Bright Data account with at least one scraper you run in production.
* Recipient email addresses added in the Control Panel settings. The alert form only offers addresses that already exist there.

## How to turn on alerts for a scraper

1. Open [Scrapers](https://brightdata.com/cp/scrapers) in the Control Panel.

2. Select the scraper you want to monitor.

3. On the scraper's page, open the notification settings and find **Success rate email alerts**.

   <Frame>
     <img alt="The notifications tab on a scraper's page in the Control Panel" />
   </Frame>

4. Enable the alerts for this scraper.

   <Frame>
     <img alt="The success rate alert toggle, threshold field and recipient list" />
   </Frame>

5. Set the threshold, for example 25 percent.

6. Select one or more recipients.

7. Save.

## What the alerts send

Once enabled, a scraper sends two kinds of email:

* **Drop alert**: the success rate fell below the threshold you set.
* **Recovery alert**: the success rate rose back above that same threshold. Use it to close an incident and resume paused jobs.

<Note>
  By default, alerts fire only when the scraper is in outage. Raise the threshold on the scraper's page to hear about partial degradation before a full outage.
</Note>

Alerts are configured per scraper and only in the Control Panel; there is no API for them. To monitor from code, poll `GET /datasets/v3/progress/{snapshot_id}` for each job and count failures yourself.

## Troubleshooting

| Issue | What it usually means | How to fix |
| :- | :- | :- |
| No recipients to choose from | No email addresses exist in the Control Panel settings | Add or verify addresses in the settings, then return to the scraper and select them |
| No alerts arrive | Alerts are off for this scraper, or the threshold never trips | Re-check the toggle and the threshold value on the scraper's page, then save |
| Only outage alerts arrive | The threshold is still at its default, outage only | Raise the threshold on the scraper's page |

## Related

<CardGroup>
  <Card title="Async requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Trigger, monitor and download a batch job, with a troubleshooting section.
  </Card>

  <Card title="Error codes" icon="triangle-exclamation" href="/api-reference/rest-api/scraper/asynchronous-requests">
    What each endpoint returns when a request or a job fails.
  </Card>
</CardGroup>


# Working with sources in AI scrapers
Source: https://docs.brightdata.com/products/scrapers/scrapers-library/working-with-sources

Work with citation sources in Bright Data AI scrapers across the AI answer engines: source generation, handling source errors and prompting for verifiable output.

## What are “Sources” in AI Scrapers?

Some AI scrapers can return citations / hyperlinks (“sources”) alongside the generated answer. Sources are useful when you need:

* Verifiable references for claims
* Links to original pages for auditing / compliance
* Research-style outputs (e.g., summaries with citations)

<Warning>
  Sources availability depends on whether the underlying AI product decides to use web search / browsing for that specific request.
</Warning>

<Tip>
  All our LLMs attempt to include sources in their responses. Some models provide an option to return an error if sources can’t be retrieved. For certain scrapers, sources are only returned if you explicitly enable the “source” option.
</Tip>

## How sources are generated

When you run an AI scraper with a prompt:

1. We send your prompt to the selected AI engine (e.g., ChatGPT).

2. The AI engine decides-based on its internal policies and runtime conditions-whether to:

   * answer from its existing knowledge, or
   * perform a web search and attach citations/sources.

3. If web search is used, sources/citations are returned in the response (when available).

4. If web search is not used, the answer may be returned without sources.

## What is a “Sources error”?

A Sources error typically means the run completed but the engine did not provide sources as expected (for example, the engine chose not to browse, browsing was unavailable, or citations weren’t returned for that request/country/version).

## Prompting best practices to increase the chance of getting sources

Because web-search and citations are influenced by the engine’s internal decisioning, prompt phrasing can materially impact whether sources appear.

Recommended tactics:

* Explicitly request sources/citations
  > **Example**: “Include sources with links for each key claim.”

* Ask for web-verified / up-to-date information
  > **Example**: “Use web search and cite sources from the last 12 months.”

* Request a citations section
  > **Example**: “At the end, add a ‘Sources’ section with URLs.”

* If you get missing sources, try a revised prompt rather than re-running the exact same prompt.
  * In our testing, changing the prompt can increase the likelihood of web search and returning sources.

## Related

<CardGroup>
  <Card title="ChatGPT Scraper API" icon="comments" href="/products/scrapers/chatgpt/introduction">
    The documented AI answer engine, with the other engines listed on its page.
  </Card>

  <Card title="Query fan-out" icon="magnifying-glass" href="/products/scrapers/concepts/query-fan-out">
    Control web search with `web_search` and confirm it with `web_search_triggered`.
  </Card>

  <Card title="ChatGPT Scraper API" icon="comments" href="/products/scrapers/chatgpt/introduction">
    Send a prompt, get structured search results and citations back.
  </Card>
</CardGroup>


# TikTok Scraper API
Source: https://docs.brightdata.com/products/scrapers/tiktok/introduction

Extract data from TikTok profiles, posts, comments and shop products with the Bright Data [TikTok Scraper API](https://brightdata.com/products/web-scraper/tiktok). Best for up to 20 URLs per sync request.

Send a TikTok URL, get structured JSON back. The Bright Data TikTok Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/tiktok?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 TikTok records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more TikTok URLs to the Bright Data TikTok Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles, posts, shop, or comments) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data TikTok Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/tiktok/quickstart).

```json theme={null}
{
  "nickname": "TikTok",
  "account_id": "tiktok",
  "biography": "One TikTok can make a big impact",
  "followers": 95600000,
  "following": 1,
  "likes": 463200000,
  "videos_count": 1502,
  "is_verified": true,
  "url": "https://www.tiktok.com/@tiktok",
  "profile_pic_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=..."
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url">
    Follower counts, bios, verification status, likes, and video counts. Discover profiles by search URL.
  </Card>

  <Card title="Posts" icon="video" href="/api-reference/scrapers/social-media-apis/tiktok-posts-collect-by-url">
    Captions, likes, comments, shares, views, hashtags, and video URLs. Discover posts by keyword or profile URL.
  </Card>

  <Card title="TikTok Shop" icon="store" href="/api-reference/scrapers/social-media-apis/tiktok-shop-collect-by-url">
    Product names, prices, ratings, reviews, and seller details. Discover products by category, keyword, or shop.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/tiktok-comments-collect-by-url">
    Comment text, likes, replies, and commenter details for any post.
  </Card>

  <Card title="Posts by Profile Fast API" icon="bolt" href="/api-reference/scrapers/social-media-apis/tiktok-posts-by-profile-fast-api-collect-by-url">
    Quickly collect all posts from a specific TikTok profile URL.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each TikTok data type uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| Profiles | `gd_l1villgoiiidt09ci` |
| Posts | `gd_lu702nij2f790tmv9h` |
| TikTok Shop | `gd_m45m1u911dsa4274pi` |
| Comments | `gd_lkf2st302ap89utw5k` |
| Posts by Profile Fast API | `gd_m7n5v2gq296pex2f5m` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data TikTok Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

TikTok changes how its pages are served, and the Bright Data TikTok Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between URL collection and discovery?

**URL collection** scrapes a specific TikTok page you provide (e.g., a profile URL). **Discovery** finds TikTok content matching search criteria (e.g., all posts containing a keyword) and scrapes the results. Discovery is accepted on both endpoints. On `/scrape` it usually runs past the 1-minute limit and returns HTTP `202` with a `snapshot_id`, so use the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint for discovery.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/tiktok/quickstart">
    Scrape your first TikTok profile in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/tiktok/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# TikTok scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/tiktok/quickstart

Set up the Bright Data TikTok Scraper API and collect your first profile, post or shop as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape a TikTok profile and get structured JSON data using the Bright Data TikTok Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/tiktok?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/tiktok?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint**. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.tiktok.profiles(url="https://www.tiktok.com/@tiktok")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1villgoiiidt09ci", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.tiktok.com/@tiktok"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.tiktok.com/@tiktok" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the returned records from `result.data`. It waits up to 240 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data TikTok Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of profile data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data TikTok Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "nickname": "TikTok",
        "account_id": "tiktok",
        "biography": "One TikTok can make a big impact",
        "followers": 95600000,
        "following": 1,
        "likes": 463200000,
        "videos_count": 1502,
        "is_verified": true,
        "url": "https://www.tiktok.com/@tiktok",
        "awg_engagement_rate": 0.00017893763075313809
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first TikTok profile using the Bright Data TikTok Scraper API.

## Common questions

### Can I scrape multiple profiles in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.tiktok.com/@tiktok"},
  {"url": "https://www.tiktok.com/@charlidamelio"},
  {"url": "https://www.tiktok.com/@khaby.lame"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the TikTok profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.tiktok.com/@username`.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | `client.scrape.tiktok.profiles(url="https://www.tiktok.com/@tiktok")`; see the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines tiktok_profiles "https://www.tiktok.com/@tiktok" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/tiktok/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# TikTok Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/tiktok/send-first-request

Send synchronous requests to all 5 Bright Data TikTok Scraper API endpoints with copy-paste examples for profiles, posts, comments and shop data.

This guide shows you how to send a synchronous request to each Bright Data TikTok Scraper API endpoint. It covers profiles, posts, TikTok Shop, comments, and posts by profile.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/tiktok?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/tiktok/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.tiktok.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape TikTok profiles

**Dataset ID:** `gd_l1villgoiiidt09ci`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "nickname": "TikTok",
      "account_id": "tiktok",
      "biography": "One TikTok can make a big impact",
      "followers": 95600000,
      "following": 1,
      "likes": 463200000,
      "videos_count": 1502,
      "is_verified": true,
      "url": "https://www.tiktok.com/@tiktok",
      "profile_pic_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=..."
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url)

### Which output fields does the TikTok profiles scraper return?

The TikTok profiles scraper (`gd_l1villgoiiidt09ci`, `collect_by_url`) returns 39 output fields.

<Accordion title="Output fields (39)">
  | Field | Type | Description |
  | - | - | - |
  | `account_id` | text | A unique identifier for the TikTok account |
  | `nickname` | text | The username or display name of the TikTok user |
  | `biography` | text | The bio or description provided by the TikTok user in their profile |
  | `awg_engagement_rate` | number | The average engagement rate for the user's content |
  | `comment_engagement_rate` | number | The engagement rate specifically related to comments on the user's content |
  | `like_engagement_rate` | number | The engagement rate specifically related to likes on the user's content |
  | `bio_link` | url | The link provided in the user's bio |
  | `predicted_lang` | text | The predicted language of the user's content |
  | `is_verified` | boolean | Indicates whether the TikTok account is verified (boolean: True/False) |
  | `followers` | number | The number of followers the TikTok user has |
  | `following` | number | The number of accounts that the TikTok user is following |
  | `likes` | number | The total number of likes received by the TikTok user |
  | `videos_count` | number | The total number of videos uploaded by the TikTok user |
  | `create_time` | date | The timestamp indicating when the TikTok account was created |
  | `id` | text | A unique identifier associated with the TikTok user |
  | `url` | url | The URL or link to the TikTok user's profile |
  | `profile_pic_url` | url | URL to the profile picture of the TikTok user |
  | `like_count` | number | The total number of likes received by the user's content |
  | `digg_count` | number | The total number of "Digg" interactions received by the user's content |
  | `is_private` | boolean | Indicates whether the TikTok account is private (boolean: True/False) |
  | `profile_pic_url_hd` | url | URL to the profile picture |
  | `secu_id` | text | A identifier associated with the TikTok user |
  | `short_id` | text | A shorter identifier associated with the TikTok user |
  | `ftc` | text | Federal Trade Commission |
  | `relation` | text | relation |
  | `open_favorite` | boolean | Information about open favoriting settings |
  | `comment_setting` | text | Comment settings chosen by the user |
  | `duet_setting` | text | Duet settings chosen by the user |
  | `stitch_setting` | text | Stitch settings chosen by the user |
  | `is_ad_virtual` | boolean | Indicates whether the user is associated with virtual advertising |
  | `room_id` | text | The ID associated with the user's TikTok room |
  | `is_under_age_18` | text | Indicates whether the user is under the age of 18 |
  | `top_videos` | array | Information about the user's top-performing videos |
  | `signature` | text | The signature or tagline provided by the TikTok user |
  | `discovery_input` | object | Automatic data point sending from the discovery, not needed in the case of manual execution |
  | `is_commerce_user` | boolean | is\_commerce\_user |
  | `top_posts_data` | array | Information about the user's top-performing posts |
  | `pinned_posts` | array | Pinned posts data |
  | `category` | text | Profile’s content or industry category |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_l1villgoiiidt09ci.json`](/scrapers/gd_l1villgoiiidt09ci.json)

## How to scrape TikTok posts

**Dataset ID:** `gd_lu702nij2f790tmv9h`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lu702nij2f790tmv9h&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok/video/7680721699171601694"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@tiktok/video/7680721699171601694",
      "description": "this summer was all about the classic hits. here's to the ones that never got away 💿 #SongsofTheSummer2026\nCelebrate the classic hits of Summer 2026 — a pla...",
      "hashtags": [
        "songsofthesummer2026"
      ],
      "video_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/ogxOEIAFdQFtcjgA0ZILu4Is1wzfDfpCqe0Vlu/?a=1988&bti=ODszNWYuMDE6&&bt=1029&ft...",
      "post_id": "7680721699171601694",
      "create_time": "2026-09-02T00:03:08.000Z",
      "digg_count": 5225,
      "share_count": "345",
      "collect_count": 560,
      "comment_count": 801
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/tiktok-posts-collect-by-url)

### Which output fields does the TikTok posts scraper return?

The TikTok posts scraper (`gd_lu702nij2f790tmv9h`, `collect_by_url`) returns 43 output fields.

<Accordion title="Output fields (43)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | Unique post link |
  | `post_id` | text | Identification for each post |
  | `description` | text | Text accompanying the post |
  | `create_time` | date | Post creation timestamp |
  | `digg_count` | number | Likes received |
  | `share_count` | text | Number of shares |
  | `collect_count` | number | Number of times saved |
  | `comment_count` | number | Number of comments |
  | `play_count` | number | Video play count |
  | `video_duration` | number | Duration of the video |
  | `hashtags` | array | Included hashtags |
  | `original_sound` | text | Sound used, if any |
  | `profile_id` | text | Unique user identifier |
  | `profile_username` | text | User's username |
  | `profile_url` | url | User's profile link |
  | `profile_avatar` | url | User's profile picture |
  | `profile_biography` | text | User's bio |
  | `preview_image` | url | Post preview image |
  | `post_type` | text | Type of post (video, image, text) |
  | `discovery_input` | object | Discovery input value |
  | `offical_item` | boolean | Indicates if the video is an official item |
  | `secu_id` | text | Security identifier for the profile |
  | `original_item` | boolean | Indicates if the video is original |
  | `shortcode` | text | Shortcode for the video |
  | `width` | number | Width of the video |
  | `ratio` | text | Aspect ratio of the video |
  | `video_url` | url | URL of the video, URLs that are generated are session-based only |
  | `music` | object | Information about the music used in the video |
  | `cdn_url` | url | URL link to media |
  | `is_verified` | boolean | Indicates whether the TikTok account is verified (boolean: True/False) |
  | `account_id` | text | Account ID |
  | `carousel_images` | array | List of images for 'carousel'-type TikTok posts |
  | `tagged_user` | array | Tagged user |
  | `profile_followers` | number | Number of followers of the post Author |
  | `tt_chain_token` | text | A session-related token used by TikTok to track and validate user requests |
  | `region` | text | The region column indicates the video's country of origin (e.g., US, UK) |
  | `commerce_info` | text | Information indicating if the post includes shopping, promotional, or affiliate content |
  | `subtitle_url` | url | URL for the subtitles |
  | `subtitle_format` | text | Format of the subtitles |
  | `subtitle_info` | array | Subtitle info |
  | `cdn_link` | text | URL link to media |
  | `num_share_count` | number | Number of shares |
  | `comments` | array | Comments of the post |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lu702nij2f790tmv9h.json`](/scrapers/gd_lu702nij2f790tmv9h.json)

## How to scrape TikTok Shop

**Dataset ID:** `gd_m45m1u911dsa4274pi`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m45m1u911dsa4274pi&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@shop/product/1234567890"}]'
```

<Accordion title="Example response (illustrative, not captured)">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@shop/product/1234567890",
      "product_name": "Wireless Bluetooth Earbuds",
      "price": 29.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 1850,
      "seller_name": "TechStore Official",
      "category": "Electronics"
    }
  ]
  ```
</Accordion>

[Full TikTok Shop response schema](/api-reference/scrapers/social-media-apis/tiktok-shop-collect-by-url)

### Which output fields does the TikTok Shop scraper return?

The TikTok Shop scraper (`gd_m45m1u911dsa4274pi`, `collect_by_url`) returns 59 output fields.

<Accordion title="Output fields (59)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | Product detail page URL on TikTok Shop |
  | `title` | text | Product title |
  | `available` | boolean | Indicates whether the product is currently available |
  | `description` | text | Full product description |
  | `currency` | text | Currency |
  | `initial_price` | number | Original price before any discounts |
  | `final_price` | number | Final price after discounts applied |
  | `discount_percent` | number | Discount percentage applied to the product |
  | `initial_price_low` | number | Lowest initial price across product variations |
  | `initial_price_high` | number | Highest initial price across product variations |
  | `final_price_low` | number | Lowest final price across product variations |
  | `final_price_high` | number | Highest final price across product variations |
  | `sold` | number | Total number of units sold |
  | `colors` | array | Available color options for the product |
  | `sizes` | array | Available size options for the product |
  | `shipping_fee` | number | Shipping fee for the product |
  | `specifications` | array | Product specifications as name-value pairs |
  | `reviews_count` | number | Total number of customer reviews |
  | `reviews` | array | Customer reviews for the product |
  | `store_details` | object | Store information including name, URL, and metrics |
  | `images` | array | Product image URLs |
  | `domain` | text | Domain of the website where the product is listed |
  | `videos` | array | Product video CDN URLs |
  | `category` | text | Product category classification |
  | `category_url` | url | URL of the product category page |
  | `id` | text | Product ID |
  | `seller_id` | text | Unique identifier of the seller |
  | `prodct_rating` | number | Average product rating score |
  | `position` | number | The product's position at the page |
  | `variations` | array | The product variations |
  | `In_stock` | boolean | In stock indicator |
  | `promotion_items` | array | Active promotional items or offers |
  | `desc_detail` | text | Description detail |
  | `related_videos` | array | TikTok videos related to the product |
  | `video_link` | text | Product Video link |
  | `Shop_performance_metrics` | array | Shop performance metrics |
  | `variant_id` | text | Unique variant ID |
  | `category_tree` | array | Hierarchical category breadcrumb with names and URLs |
  | `brand` | text | Product brand |
  | `image_url` | text | Main product image URL |
  | `nai_price` | price | Regular price |
  | `sale_price` | price | Discounted price |
  | `availability` | text | Product availability (in\_stock, out\_of\_stock, pre\_order, etc.) |
  | `availability_date` | text | Availability date |
  | `group_id` | text | Variant group ID (same for all variants) |
  | `listing_has_variations` | boolean | Indicates if the listing has variations |
  | `variant_attributes` | array | Currently selected variant attributes as name-value pairs |
  | `nai_variants` | array | All available variant options grouped by type |
  | `store_name` | text | Seller name |
  | `seller_url` | text | Seller page URL |
  | `seller_privacy_policy` | text | Seller-specific privacy policy URL |
  | `seller_tos` | text | Seller-specific terms of service URL |
  | `return_policy` | text | Policy URL |
  | `return_window` | number | Days allowed for return |
  | `target_countries` | array | Target countries of the item |
  | `store_country` | text | Store country of the item |
  | `category_urls` | array | List of category URLs for the product breadcrumb trail |
  | `nai_reviews` | array | Review entries |
  | `additional_image_urls` | array | Extra product images (comma-separated list) |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_m45m1u911dsa4274pi.json`](/scrapers/gd_m45m1u911dsa4274pi.json)

## How to scrape TikTok comments

**Dataset ID:** `gd_lkf2st302ap89utw5k`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkf2st302ap89utw5k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok/video/7680721699171601694"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@tiktok/video/7680721699171601694",
      "replies": [],
      "post_url": "https://www.tiktok.com/@tiktok/video/7680721699171601694",
      "post_id": "7680721699171601694",
      "post_date_created": "2026-09-02T00:03:08.000Z",
      "date_created": "2026-09-05T09:50:19.000Z",
      "comment_text": "@꒰ྀི ˶> ˕ <˶ྀི꒱:love tiktok",
      "num_likes": 5,
      "num_replies": 0,
      "commenter_user_name": "꒰ྀི ˶> ˕ <˶ྀི꒱"
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/tiktok-comments-collect-by-url)

### Which output fields does the TikTok comments scraper return?

The TikTok comments scraper (`gd_lkf2st302ap89utw5k`, `collect_by_url`) returns 14 output fields.

| Field | Type | Description |
| - | - | - |
| `url` | url | status |
| `post_url` | url | Post web address |
| `post_id` | text | Unique post identifier |
| `post_date_created` | date | Date of post creation |
| `date_created` | date | Comment creation date |
| `comment_text` | text | Comment content |
| `num_likes` | number | Number of likes on the comment |
| `num_replies` | number | Number of replies to the comment |
| `commenter_user_name` | text | Commenter's username |
| `commenter_id` | text | Commenter's unique identifier |
| `commenter_url` | url | Commenter's profile URL |
| `comment_id` | text | The unique ID for the comment |
| `comment_url` | url | The URL for the comment |
| `replies` | array | replies |

Machine-readable version with the input schema: [`/scrapers/gd_lkf2st302ap89utw5k.json`](/scrapers/gd_lkf2st302ap89utw5k.json)

## Posts by Profile Fast API

**Dataset ID:** `gd_m7n5v2gq296pex2f5m`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7n5v2gq296pex2f5m&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.tiktok.com/@tiktok/video/7680721699171601694",
      "description": "this summer was all about the classic hits. here's to the ones that never got away 💿 #SongsofTheSummer2026",
      "post_id": "7680721699171601694",
      "create_time": "2026-09-02T00:03:08.000Z",
      "digg_count": 5213,
      "share_count": "344",
      "collect_count": 556,
      "comment_count": 797,
      "play_count": 118100,
      "video_duration": 56
    }
  ]
  ```
</Accordion>

[Full Posts by Profile Fast API response schema](/api-reference/scrapers/social-media-apis/tiktok-posts-by-profile-fast-api-collect-by-url)

### Which output fields does the TikTok posts by profile Fast API scraper return?

The TikTok posts by profile Fast API scraper (`gd_m7n5v2gq296pex2f5m`, `collect_by_url`) returns 35 output fields.

<Accordion title="Output fields (35)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | Unique post link |
  | `post_id` | text | Identification for each post |
  | `description` | text | Text accompanying the post |
  | `create_time` | date | Post creation timestamp |
  | `digg_count` | number | Likes received |
  | `share_count` | text | Number of shares |
  | `collect_count` | number | Number of times saved |
  | `comment_count` | number | Number of comments |
  | `play_count` | number | Video play count |
  | `video_duration` | number | Duration of the video |
  | `hashtags` | array | Included hashtags |
  | `original_sound` | text | Sound used, if any |
  | `profile_id` | text | Unique user identifier |
  | `profile_username` | text | User's username |
  | `profile_url` | url | User's profile link |
  | `profile_avatar` | url | User's profile picture |
  | `profile_biography` | text | User's bio |
  | `preview_image` | url | Post preview image |
  | `post_type` | text | Type of post (video, image, text) |
  | `offical_item` | boolean | Indicates if the video is an official item |
  | `secu_id` | text | Security identifier for the profile |
  | `original_item` | boolean | Indicates if the video is original |
  | `shortcode` | text | Shortcode for the video |
  | `width` | number | Width of the video |
  | `ratio` | text | Aspect ratio of the video |
  | `video_url` | url | URL of the video, URLs that are generated are session-based only |
  | `music` | object | Information about the music used in the video |
  | `cdn_url` | url | URL link to media |
  | `is_verified` | boolean | Indicates whether the TikTok account is verified (boolean: True/False) |
  | `account_id` | text | |
  | `carousel_images` | array | List of images for 'carousel'-type TikTok posts |
  | `tagged_user` | array | |
  | `profile_followers` | number | Number of followers of the post Author |
  | `tt_chain_token` | text | |
  | `region` | text | |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_m7n5v2gq296pex2f5m.json`](/scrapers/gd_m7n5v2gq296pex2f5m.json)

## Quick reference: dataset IDs

| Endpoint | Dataset ID | URL pattern |
| :- | :- | :- |
| Profiles | `gd_l1villgoiiidt09ci` | `tiktok.com/@{username}` |
| Posts | `gd_lu702nij2f790tmv9h` | `tiktok.com/@{username}/video/{id}` |
| TikTok Shop | `gd_m45m1u911dsa4274pi` | `tiktok.com/@shop/product/{id}` |
| Comments | `gd_lkf2st302ap89utw5k` | `tiktok.com/@{username}/video/{id}` |
| Posts by Profile Fast API | `gd_m7n5v2gq296pex2f5m` | `tiktok.com/@{username}` |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Build a daily Amazon price monitor
Source: https://docs.brightdata.com/products/scrapers/tutorials/amazon-price-monitor

Schedule a daily Amazon SKU scrape with the Bright Data Amazon Scraper API, delivered to S3 and orchestrated by a GitHub Actions cron workflow.

You track prices and stock on a list of Amazon SKUs and you need fresh numbers every morning before your team starts work. You don't want to run a server just for this. You don't want to babysit a cron job on a laptop.

In this tutorial we'll build exactly that pipeline. You'll commit a SKU list to a GitHub repo, write a small Python script that triggers the Bright Data Amazon Scraper API against it, wrap the script in a GitHub Actions workflow that runs on a daily cron, and configure Bright Data to deliver the results directly to an S3 bucket. Each morning a fresh JSON file lands in S3, keyed by snapshot ID, ready for your BI pipeline to pick up.

No servers, no webhook handlers, no glue code. Just a workflow file, a script and a delivery config.

## What you'll build

A GitHub repository containing:

1. A `skus.json` file listing the Amazon product URLs to monitor
2. A Python script that POSTs the SKU list to the Bright Data Amazon Scraper API
3. A GitHub Actions workflow that runs the script on a daily schedule
4. Bright Data configured to deliver each snapshot to your S3 bucket

By the end, you'll see a new JSON file in S3 every day, each containing fresh price, rating and availability data for every SKU on the list.

**Estimated time:** 30 minutes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with an API key ([get your key](https://brightdata.com/cp/setting/users))
* An S3 bucket with Bright Data delivery already configured. Follow [Amazon to S3 delivery](/products/scrapers/scrapers-library/data-delivery) once, then come back. This tutorial assumes the delivery destination is already saved in your Amazon scraper's settings.
* A [GitHub account](https://github.com/signup) and a new (empty) repository
* Python 3.9+ installed locally
* Git installed locally

## Part 1: Create the SKU list

Clone your empty GitHub repo locally and create a `skus.json` file at the repo root:

```json skus.json theme={null}
[
  "https://www.amazon.com/dp/B0D1XD1ZV3",
  "https://www.amazon.com/dp/B0863TXGM3",
  "https://www.amazon.com/dp/B09V3KXJPB"
]
```

These are three real product URLs (AirPods Pro 2, Sony WH-1000XM4 headphones and iPad Air M1). Swap them for your own SKUs later.

<Tip>
  Keeping the SKU list in the repo means every edit is version-controlled and every change ships through normal pull-request review. Large SKU lists can live in a CSV loaded by the script instead, we'll mention that in "Next steps."
</Tip>

## Part 2: Write the trigger script

Create `trigger_scrape.py` at the repo root:

```python trigger_scrape.py theme={null}
import json
import os
import sys

import requests

DATASET_ID = "gd_l7q7dkf244hwjntr0"  # Amazon products by URL
TRIGGER_URL = "https://api.brightdata.com/datasets/v3/trigger"


def main() -> int:
    api_key = os.environ.get("BRIGHTDATA_API_KEY")
    if not api_key:
        print("BRIGHTDATA_API_KEY environment variable is not set.")
        return 1

    with open("skus.json") as f:
        urls = json.load(f)

    payload = [{"url": url} for url in urls]

    response = requests.post(
        TRIGGER_URL,
        params={"dataset_id": DATASET_ID, "format": "json"},
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json",
        },
        json=payload,
        timeout=30,
    )
    response.raise_for_status()

    snapshot_id = response.json().get("snapshot_id")
    print(f"Triggered scrape for {len(urls)} SKUs. Snapshot: {snapshot_id}")
    return 0


if __name__ == "__main__":
    sys.exit(main())
```

Then create `requirements.txt`:

```text theme={null}
requests==2.32.3
```

Two things worth noticing:

* **The script does not wait for results.** It fires the trigger and exits. Bright Data runs the scrape asynchronously and delivers the results directly to S3 via the delivery config you saved in your scraper settings. That's the whole point: the script is a cheap, stateless trigger.
* **The API key comes from an environment variable.** Never commit keys to a repo. We'll wire this to GitHub Actions Secrets in Part 4.

## Part 3: Run it locally

Install the dependency and run the script with your key:

```bash theme={null}
pip install -r requirements.txt
export BRIGHTDATA_API_KEY=your_actual_key_here
python trigger_scrape.py
```

You should see output like:

Example output. Your values will differ.

```text theme={null}
Triggered scrape for 3 SKUs. Snapshot: sd_mntfmunq1yy7gi201q
```

Wait 60 to 90 seconds, then check your S3 bucket:

```bash theme={null}
aws s3 ls s3://your-bucket-name/amazon/products/
```

You should see a new file named with the snapshot ID:

Example output. Your values will differ.

```text theme={null}
2026-04-10 09:14:22   14382 sd_mntfmunq1yy7gi201q.json
```

Download it and inspect one record:

```bash theme={null}
aws s3 cp s3://your-bucket-name/amazon/products/sd_mntfmunq1yy7gi201q.json ./latest.json
python -m json.tool latest.json | head -30
```

You should see structured product data for each SKU:

Example output. Your values will differ.

```json theme={null}
[
  {
    "title": "Sony WH-1000XM4 Wireless Premium Noise Canceling Overhead Headphones",
    "asin": "B0863TXGM3",
    "brand": "Sony",
    "final_price": 209.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 62492,
    "availability": "Only 1 left in stock - order soon.",
    "url": "https://www.amazon.com/dp/B0863TXGM3"
  }
]
```

<Note>
  The price field is `final_price`, and it can be `null` for products that are out of stock or currency-ambiguous listings. Your BI pipeline should handle that case explicitly rather than crashing on a missing key.
</Note>

Notice that the file is keyed by `snapshot_id`, not by date. That's deliberate: each snapshot is immutable, and you can walk the bucket chronologically by listing creation timestamps or by enabling versioning. We'll discuss naming conventions in "Next steps."

## Part 4: Schedule the workflow on GitHub Actions

Now let's move the trigger off your laptop and onto a daily schedule.

Create `.github/workflows/daily-scrape.yml`:

```yaml .github/workflows/daily-scrape.yml theme={null}
name: Daily Amazon price scrape

on:
  schedule:
    - cron: "0 6 * * *"   # 06:00 UTC every day
  workflow_dispatch:        # Allows manual runs from the Actions tab

jobs:
  trigger:
    runs-on: ubuntu-latest
    steps:
      - name: Check out the repo
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - name: Install dependencies
        run: pip install -r requirements.txt

      - name: Trigger Bright Data scrape
        env:
          BRIGHTDATA_API_KEY: ${{ secrets.BRIGHTDATA_API_KEY }}
        run: python trigger_scrape.py
```

Two key elements:

* **`schedule: cron: "0 6 * * *"`** runs the job at 06:00 UTC every day. Adjust the cron expression for your timezone. GitHub does not guarantee the start time of a scheduled workflow. GitHub's [events that trigger workflows](https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule) reference says a scheduled run "can be delayed during periods of high loads," and high load includes the start of every hour.
* **`workflow_dispatch`** adds a **Run workflow** button in the Actions tab so you can kick off the job on demand without waiting for the schedule.

Now add your Bright Data key as a repo secret:

1. In your GitHub repo, go to **Settings** > **Secrets and variables** > **Actions**
2. Click **New repository secret**
3. Name it `BRIGHTDATA_API_KEY` and paste your key
4. Click **Add secret**

<Warning>
  Treat your Bright Data API key like a password. Never commit it to the repo, never paste it into workflow logs, and rotate it if you suspect it's been exposed.
</Warning>

## Part 5: Push and verify

Commit everything and push:

```bash theme={null}
git add skus.json trigger_scrape.py requirements.txt .github/workflows/daily-scrape.yml
git commit -m "Add daily Amazon price monitor"
git push
```

Open your repo on GitHub and go to the **Actions** tab. You should see the **Daily Amazon price scrape** workflow listed.

Click **Run workflow** > **Run workflow** to kick it off manually. Within a few seconds a new run appears. Click into it and watch the steps execute. The final step should log:

Example output. Your values will differ.

```text theme={null}
Triggered scrape for 3 SKUs. Snapshot: sd_mntfn4abcdefghij
```

Wait a minute, then check S3 again:

```bash theme={null}
aws s3 ls s3://your-bucket-name/amazon/products/
```

You should now see two snapshot files, the one from Part 3 and the one from the workflow run.

From here, GitHub Actions will run the workflow every day at the scheduled time, and a fresh file will appear in S3 each morning. No server, no cron job, no babysitting.

## Troubleshooting

### Why is there no file in S3 after 2 minutes?

Check the job status before you check the bucket. Send the `snapshot_id` that `trigger_scrape.py` printed in Part 3 to [Monitor progress](/api-reference/scrapers/management-apis/monitor-progress) (`GET /datasets/v3/progress/{snapshot_id}`) and read the `status` field:

* `starting` or `running`: the Amazon Scraper API is still collecting. Wait and check again.
* `ready`: the scrape finished, so the problem is in delivery. Check the S3 destination saved in the Amazon scraper's delivery settings and the bucket permissions. The IAM role must allow `s3:PutObject` on the bucket. See [Files not appearing in S3?](/products/scrapers/scrapers-library/data-delivery#files-not-appearing-in-s3) in the delivery guide.

### Why does the trigger script fail with a 401?

The Bright Data API rejected the API key. A 401 with `Invalid credentials` means the key value is wrong. Locally, check the value you exported as `BRIGHTDATA_API_KEY`. In GitHub Actions, check the repository secret under **Settings** > **Secrets and variables** > **Actions**. The secret name must be exactly `BRIGHTDATA_API_KEY`. When the secret is missing, the script prints `BRIGHTDATA_API_KEY environment variable is not set.` instead of a 401.

### Why is `final_price` null?

The Amazon Scraper API returns `final_price` as `null` for products that are out of stock and for currency-ambiguous listings. Check the `availability` field in the same record. Handle `null` in your BI pipeline instead of treating it as an error.

### Why didn't the scheduled workflow run?

GitHub runs scheduled workflows in UTC by default, so `0 6 * * *` fires at 06:00 UTC, not 06:00 in your timezone. The [GitHub Actions `schedule` event reference](https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule) also lists these limits:

* A scheduled run can be delayed during high load, which includes the start of every hour. If the load is high enough, GitHub may drop queued jobs. GitHub suggests scheduling at a different minute of the hour, for example `17 6 * * *`
* Scheduled workflows run only from the workflow file on the default branch
* In a public repository, GitHub disables scheduled workflows after 60 days with no repository activity

To run the scrape without waiting for the schedule, open the **Actions** tab, select **Daily Amazon price scrape** and click **Run workflow**.

For every Scraper API error message, see [Scraper API error codes](/products/scrapers/error-codes). For job, payload and download limits, see [Scraper API limits](/products/scrapers/limits).

## Congratulations

You've built a fully automated daily price monitor:

* A **SKU list** version-controlled in GitHub
* A **Python trigger script** that fires the Bright Data scrape and exits
* A **GitHub Actions workflow** that runs on a daily cron and authenticates via a repo secret
* **Bright Data S3 delivery** that drops each snapshot into your bucket asynchronously

Every moving part is declarative and in the repo. Editing the SKU list, the cron schedule or the destination is a one-line pull request.

## Next steps

<CardGroup>
  <Card title="Stream large snapshots" icon="arrow-down-to-line" href="/products/scrapers/scrapers-library/stream-and-file-delivery">
    Use `stream_max_lines` to start receiving batches as soon as the first records are ready.
  </Card>

  <Card title="Amazon async reference" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Full parameter list for the async trigger endpoint, including `include_errors` and `limit_per_input`.
  </Card>

  <Card title="Monitor delivery status" icon="magnifying-glass-chart" href="/api-reference/scrapers/management-apis/monitor-delivery">
    Programmatically check snapshot status and delivery result from inside the workflow.
  </Card>

  <Card title="Deliver results" icon="truck" href="/products/scrapers/scrapers-library/data-delivery">
    Swap S3 for GCS, Azure, Snowflake or SFTP with the same trigger call.
  </Card>
</CardGroup>


# Build a LinkedIn-to-CRM webhook pipeline
Source: https://docs.brightdata.com/products/scrapers/tutorials/linkedin-to-crm

Build a pipeline that scrapes LinkedIn profiles with Bright Data and delivers CRM-ready contact records to a Next.js 14 webhook handler deployed on Vercel.

You want to enrich inbound leads automatically. A signup form gives you a LinkedIn URL, and a minute later a contact record with company, location and follower count, plus the job title when LinkedIn still exposes it, lands in your CRM. No manual copy-paste, no Zapier-style glue code.

In this tutorial we'll build that pipeline end-to-end. You'll deploy a tiny Next.js webhook handler to Vercel, trigger the Bright Data LinkedIn Scraper API against a handful of profile URLs and watch mapped contact records appear in your Vercel logs within a minute.

We stop at the mapped object. Sending it to a specific CRM is a one-line fetch call we'll sketch out at the end.

## What you'll build

A Next.js API route deployed on Vercel that:

1. Accepts a POST from Bright Data containing a JSON array of scraped LinkedIn profiles
2. Maps each profile into a normalized CRM-shaped contact record
3. Logs the mapped records so you can inspect them in the Vercel dashboard

You'll then trigger a scrape from your terminal pointed at your deployed Vercel URL, and see two profiles get mapped and logged end-to-end.

**Estimated time:** 25 minutes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with an API key ([get your key](https://brightdata.com/cp/setting/users))
* A free [Vercel account](https://vercel.com/signup)
* Node.js 18+ installed locally
* The [Vercel CLI](https://vercel.com/docs/cli) installed: `npm install -g vercel`

## Part 1: Scaffold the Next.js project

In a new terminal, create a minimal Next.js project:

```bash theme={null}
npx create-next-app@latest linkedin-to-crm
```

Accept all defaults. You'll get a working Next.js 14+ project with the App Router. Then move into it:

```bash theme={null}
cd linkedin-to-crm
```

## Part 2: Add the webhook route

Create the file `app/api/webhook/linkedin/route.ts`:

```typescript app/api/webhook/linkedin/route.ts theme={null}
export async function POST(request: Request) {
  const profiles = await request.json();
  console.log(`Received ${profiles.length} profiles from Bright Data`);

  for (const profile of profiles) {
    console.log(`- ${profile.name} (${profile.position ?? "no title returned"})`);
  }

  return Response.json({ received: profiles.length });
}
```

That's the whole receiver. LinkedIn has restricted the job title field since Nov. 13, 2025, so `position` is usually empty and the route prints `no title returned` instead. Next.js App Router treats any `route.ts` file as an API endpoint, so this file alone gives you a working `POST /api/webhook/linkedin` route once deployed.

## Part 3: Deploy to Vercel

From the project root:

```bash theme={null}
vercel
```

The first run walks you through login and project creation. Accept the defaults. After a minute you should see output ending with:

Example output. Your values will differ.

```text theme={null}
Production: https://linkedin-to-crm-<hash>.vercel.app
```

Copy that URL. Your webhook endpoint is:

```http theme={null}
https://linkedin-to-crm-<hash>.vercel.app/api/webhook/linkedin
```

<Tip>
  Open your project in the [Vercel dashboard](https://vercel.com/dashboard) and keep the **Logs** tab visible. That's where your `console.log` output will appear when Bright Data POSTs to the endpoint.
</Tip>

## Part 4: Trigger the scrape

Open a second terminal and trigger the Bright Data LinkedIn scraper, pointing it at your Vercel URL:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&uncompressed_webhook=true&endpoint=https://linkedin-to-crm-<hash>.vercel.app/api/webhook/linkedin" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"url": "https://www.linkedin.com/in/satyanadella"},
    {"url": "https://www.linkedin.com/in/jeffweiner08"}
  ]'
```

Replace `YOUR_API_KEY` with your Bright Data API key and `linkedin-to-crm-<hash>` with your actual Vercel URL.

You should see a response like this immediately:

Example output. Your values will differ.

```json theme={null}
{"snapshot_id":"sd_mntfn0zq7xj0zeay"}
```

The scrape runs asynchronously. You don't need to do anything with the `snapshot_id`. Bright Data POSTs the results to your Vercel endpoint when the job finishes. For two profiles, that usually takes 30 to 60 seconds.

Switch to the Vercel **Logs** tab. Within a minute you should see something like:

Example output. Your values will differ.

```text theme={null}
Received 2 profiles from Bright Data
- Satya Nadella (no title returned)
- Jeff Weiner (no title returned)
```

Notice that both profiles arrive in a single POST. Bright Data delivers the whole snapshot in one request, not one profile at a time.

## Part 5: Map profiles to a CRM shape

Right now the handler just logs names and positions. Real CRMs expect contact records with specific field names: `full_name`, `job_title`, `company`, and so on. Let's normalize the Bright Data payload into that shape.

Replace `app/api/webhook/linkedin/route.ts` with:

```typescript app/api/webhook/linkedin/route.ts theme={null}
type BrightDataProfile = {
  name?: string;
  position?: string;
  current_company?: { name?: string };
  country_code?: string;
  city?: string;
  followers?: number;
  url: string;
};

type CrmContact = {
  full_name: string | null;
  job_title: string | null;
  company: string | null;
  country: string | null;
  city: string | null;
  linkedin_url: string;
  follower_count: number;
};

function mapToCrmContact(profile: BrightDataProfile): CrmContact {
  return {
    full_name: profile.name ?? null,
    // LinkedIn restricted Position on November 13, 2025; it is often null and served from cache.
    job_title: profile.position ?? null,
    company: profile.current_company?.name ?? null,
    country: profile.country_code ?? null,
    city: profile.city ?? null,
    linkedin_url: profile.url,
    follower_count: profile.followers ?? 0,
  };
}

export async function POST(request: Request) {
  const profiles: BrightDataProfile[] = await request.json();
  console.log(`Received ${profiles.length} profiles from Bright Data`);

  const contacts = profiles.map(mapToCrmContact);

  for (const contact of contacts) {
    console.log(JSON.stringify(contact, null, 2));
  }

  // Next step: POST each contact to your CRM.
  // Example for HubSpot:
  //   await fetch("https://api.hubapi.com/crm/v3/objects/contacts", {
  //     method: "POST",
  //     headers: {
  //       Authorization: `Bearer ${process.env.HUBSPOT_TOKEN}`,
  //       "Content-Type": "application/json",
  //     },
  //     body: JSON.stringify({ properties: contact }),
  //   });

  return Response.json({ received: contacts.length });
}
```

Redeploy:

```bash theme={null}
vercel --prod
```

Re-run the same curl command from Part 4. This time your Vercel logs should show two mapped contacts. `job_title` is `null` because LinkedIn restricts the job title field:

Example output. Your values will differ.

```text theme={null}
Received 2 profiles from Bright Data
{
  "full_name": "Satya Nadella",
  "job_title": null,
  "company": "Microsoft",
  "country": "US",
  "city": "Redmond",
  "linkedin_url": "https://www.linkedin.com/in/satyanadella",
  "follower_count": 10842560
}
{
  "full_name": "Jeff Weiner",
  "job_title": null,
  "company": "Next Chapter",
  "country": "US",
  "city": "San Francisco Bay Area",
  "linkedin_url": "https://www.linkedin.com/in/jeffweiner08",
  "follower_count": 1200000
}
```

Each object in that log is a complete CRM-ready contact. Sending it to your CRM is a single fetch call. The commented-out block in the handler sketches the HubSpot version. Swap the URL and header for Salesforce, Pipedrive or whatever you use.

## Securing the webhook

Right now anyone who guesses your Vercel URL could POST fake profile data to it. Before you pipe live data into a real CRM, lock down the endpoint.

Bright Data's trigger call accepts an `auth_header` query parameter, which gets forwarded as the `Authorization` header on the webhook POST. The name `webhook_header_Authorization`, which this tutorial used before September 7, 2026, is ignored by the API:

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0&format=json&uncompressed_webhook=true&endpoint=https://linkedin-to-crm-<hash>.vercel.app/api/webhook/linkedin&auth_header=Bearer+YOUR_SHARED_SECRET" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
```

Then verify that header in the handler before processing:

```typescript theme={null}
export async function POST(request: Request) {
  const auth = request.headers.get("authorization");
  if (auth !== `Bearer ${process.env.WEBHOOK_SECRET}`) {
    return new Response("Unauthorized", { status: 401 });
  }

  const profiles = await request.json();
  // ...rest of the handler
}
```

Set `WEBHOOK_SECRET` as an environment variable in your Vercel project settings, then redeploy.

<Note>
  Bright Data also publishes a list of webhook source IPs you can allowlist. See [Which IPs do webhooks come from?](/products/scrapers/scrapers-library/data-delivery#which-ips-do-webhooks-come-from) in the delivery guide.
</Note>

## Troubleshooting

### Why does no webhook appear in the Vercel logs?

First confirm the scrape finished. Send the `snapshot_id` from Part 4 to [Monitor progress](/api-reference/scrapers/management-apis/monitor-progress) and wait for the `status` field to read `ready`. If the status is `ready` and the Vercel logs show no POST, check the delivery path:

* **The `endpoint` URL:** it must be your deployed Vercel URL followed by `/api/webhook/linkedin`, starting with `https://`
* **The `auth_header` value:** it must match the secret the route checks. A mismatch makes the route return 401 before it logs anything
* **The response time:** the route must return HTTP 200 within 30 seconds. Otherwise Bright Data treats the delivery as failed and retries it
* **Vercel Deployment Protection:** according to [Vercel's Deployment Protection docs](https://vercel.com/docs/deployment-protection), Standard Protection "protects all domains except production domains." On a protected URL, Vercel asks for a Vercel login and the Bright Data POST never reaches the route. Check **Settings** > **Deployment Protection** in your Vercel project

### Why are the job title and experience empty?

Empty job titles are expected. Since Nov. 13, 2025, LinkedIn has restricted public access to the **Position**, **Experience** and **Education** fields, and their fill rates dropped to roughly 2 percent. The route prints `no title returned` and the mapper sets `job_title` to `null` in that case. See [LinkedIn data policy change](/products/scrapers/linkedin/data-policy-change) for the full field status table.

### Why does my route return a 401?

The `Authorization` header Bright Data sent does not match `Bearer ${process.env.WEBHOOK_SECRET}`. Check these three things:

* The `auth_header` value in the trigger URL is `Bearer+` followed by the same secret you set as `WEBHOOK_SECRET` in Vercel. The `+` is a URL-encoded space
* The trigger URL uses `auth_header`. The API ignores the older `webhook_header_Authorization` name and sends no `Authorization` header
* You redeployed after you set `WEBHOOK_SECRET` in the Vercel project settings

For every Scraper API error message, see [Scraper API error codes](/products/scrapers/error-codes). For webhook payload size, response deadline and job limits, see [Scraper API limits](/products/scrapers/limits).

## Congratulations

You've built an end-to-end pipeline that scrapes LinkedIn profiles and delivers CRM-ready contact records to your own server:

* A **Next.js API route** deployed on Vercel that receives Bright Data webhooks
* A **mapper function** that normalizes Bright Data's profile schema into a CRM-shaped contact
* A **trigger call** that fires the scrape asynchronously and tells Bright Data exactly where to send the results

The final hop, POSTing each mapped contact to HubSpot, Salesforce or your own CRM, is a single fetch call that the commented-out block in `route.ts` sketches.

## Next steps

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Amazon S3 delivery" icon="bucket" href="/products/scrapers/scrapers-library/data-delivery">
    Swap the webhook for an S3 bucket when payloads exceed Vercel's 4.5 MB body limit.
  </Card>

  <Card title="Webhook reference" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Full parameter list, auth headers and IP allowlist.
  </Card>

  <Card title="HubSpot Contacts API" icon="hubspot" href="https://developers.hubspot.com/docs/api/crm/contacts">
    Drop-in replacement for the commented POST in the handler.
  </Card>
</CardGroup>


# Build a keyword social listener
Source: https://docs.brightdata.com/products/scrapers/tutorials/social-listener

Build a keyword social listener with Bright Data SERP API (31 languages) and social scrapers. Discover Instagram, TikTok and X posts, then collect full data.

You want to know when a keyword (a brand name, a product, a competitor) shows up in a post on Instagram, TikTok or X. You don't have the URLs in advance, so you can't just hand a list to a scraper. You need a discovery step first.

In this tutorial we'll build that discovery pipeline with one Python script. You'll use the Bright Data **SERP API** in `parsed_light` mode to run `site:instagram.com "your keyword"` style queries, take the top 10 organic links from each response, classify them by platform and fire the matching social scraper asynchronously. At the end you'll have one snapshot per platform, ready to be delivered to S3 or a webhook.

We stop at the trigger step. Routing the snapshots into storage is a delivery-config change that the other two tutorials in this series already cover.

## What you'll build

A single Python script that:

1. Runs three SERP API queries, one per platform, for your keyword
2. Reads the top 10 organic results from each `parsed_light` response
3. Classifies each link as an Instagram post, a TikTok video or an X post
4. Triggers the matching Bright Data social scraper for each platform's URL list
5. Prints one snapshot ID per platform

Run it once, get three snapshot IDs. Wire the same script into GitHub Actions later and you've got a daily mention monitor.

**Estimated time:** 25 minutes.

## Prerequisites

* A [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) with an API key ([get your key](https://brightdata.com/cp/setting/users))
* A **SERP API zone** created in the control panel. Follow the [SERP API introduction](/products/serp-api/introduction) once, then come back with the zone name
* Python 3.9+ installed locally

## Part 1: Set up the project

Create a new folder and drop in a `requirements.txt`:

```bash theme={null}
mkdir social-listener && cd social-listener
```

```text requirements.txt theme={null}
requests==2.32.3
```

Install the dependency:

```bash theme={null}
pip install -r requirements.txt
```

Export the credentials the script will read from the environment. The API key authenticates both the SERP API and the social scraper triggers; the zone name tells the SERP API which SERP zone to route the request through:

```bash theme={null}
export BRIGHTDATA_API_KEY=your_api_key
export BRIGHT_DATA_SERP_ZONE=your_serp_zone_name
```

## Part 2: Discover mentions with the SERP API

The SERP API is a single REST endpoint: `POST https://api.brightdata.com/request`. You hand it a zone name and a Google Search URL, and it returns the SERP for that query. Pass `data_format: "parsed_light"` and you get back a compact JSON payload with just the top 10 organic results, no ads, no knowledge panels, no parsing to do on your side.

Create `listen.py` and start with the discovery step:

```python listen.py theme={null}
from __future__ import annotations

import os
import sys
import urllib.parse

import requests

SERP_URL = "https://api.brightdata.com/request"
TRIGGER_URL = "https://api.brightdata.com/datasets/v3/trigger"

PLATFORMS = ["instagram.com", "tiktok.com", "x.com"]


def discover(keyword: str, api_key: str, zone: str) -> dict[str, list[dict]]:
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    }

    results_by_platform: dict[str, list[dict]] = {}

    for site in PLATFORMS:
        query = f'site:{site} "{keyword}"'
        google_url = (
            "https://www.google.com/search"
            f"?q={urllib.parse.quote_plus(query)}&hl=en&gl=us"
        )

        response = requests.post(
            SERP_URL,
            headers=headers,
            json={
                "zone": zone,
                "url": google_url,
                "format": "raw",
                "data_format": "parsed_light",
            },
            timeout=180,
        )
        response.raise_for_status()
        organic = response.json().get("organic", [])
        results_by_platform[site] = organic

    return results_by_platform
```

Three things worth noticing:

* **`data_format: "parsed_light"`** is the key. It tells the SERP API to return only the top 10 organic results in a compact `organic` array, skipping ads and knowledge panels. Faster response, less data to classify.
* **`format: "raw"`** is required alongside `data_format`. It refers to the outer HTTP response envelope, not the parsed payload. The SERP API docs [spell this out](/products/serp-api/introduction#get-only-top-10-results-faster-response).
* **`timeout=180`** is generous on purpose. Most SERP API calls return in well under a second, but a single query can occasionally take longer during Google rate-limiting. Three seconds of budget each keeps the script robust without being wasteful.

## Part 3: Classify the URLs by platform

Each SERP response gives you an `organic` array, and each entry has a `link` field pointing to a real post URL. You need to bucket those links so each scraper gets only the URLs it understands.

Add these helpers to `listen.py`:

```python listen.py theme={null}
import re

INSTAGRAM_POST_RE = re.compile(r"https://(?:www\.)?instagram\.com/(?:p|reel)/[^/?#]+")
TIKTOK_POST_RE    = re.compile(r"https://(?:www\.)?tiktok\.com/@[^/]+/video/\d+")
X_POST_RE         = re.compile(r"https://(?:www\.)?x\.com/[^/]+/status/\d+")


def classify(results_by_platform: dict[str, list[dict]]) -> dict[str, list[str]]:
    buckets: dict[str, list[str]] = {"instagram": [], "tiktok": [], "x": []}

    for organic in results_by_platform.values():
        for result in organic:
            link = result.get("link", "")
            if INSTAGRAM_POST_RE.match(link):
                buckets["instagram"].append(link)
            elif TIKTOK_POST_RE.match(link):
                buckets["tiktok"].append(link)
            elif X_POST_RE.match(link):
                buckets["x"].append(link)

    for platform in buckets:
        buckets[platform] = list(dict.fromkeys(buckets[platform]))

    return buckets
```

Notice the regexes match only **post-shaped `https://` URLs**, not profile pages or topic pages. A profile URL like `instagram.com/tiktok` is rejected because this tutorial's scrapers only take post URLs as input. The `https://` prefix is strict on purpose: the social scrapers reject plain `http://` URLs at validation time, so dropping them here avoids a `400 validation_error` from the trigger step later. The `dict.fromkeys` trick de-duplicates while preserving order.

## Part 4: Trigger the social scrapers

You now have three lists of post URLs. Fire them at the matching social scrapers with async triggers so each scraper can run on its own schedule without blocking the script:

```python listen.py theme={null}
SOCIAL_DATASETS = {
    "instagram": "gd_lk5ns7kz21pck8jpis",  # Instagram posts
    "tiktok":    "gd_lu702nij2f790tmv9h",  # TikTok posts
    "x":         "gd_lwxkxvnf1cynvib9co",  # X posts
}


def trigger(platform: str, urls: list[str], api_key: str) -> str | None:
    if not urls:
        print(f"  {platform}: no URLs to trigger")
        return None

    response = requests.post(
        TRIGGER_URL,
        params={"dataset_id": SOCIAL_DATASETS[platform], "format": "json"},
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json",
        },
        json=[{"url": url} for url in urls],
        timeout=30,
    )
    response.raise_for_status()
    snapshot_id = response.json().get("snapshot_id")
    print(f"  {platform}: {len(urls)} URLs -> snapshot {snapshot_id}")
    return snapshot_id
```

Two things worth noticing:

* **Discovery is synchronous, scraping is async.** The SERP API returns in under a second per query, so you loop over three queries inline. The social scrapers can take several minutes each, so you trigger and exit. Bright Data runs them in the background.
* **The script returns snapshot IDs, not data.** The actual posts land wherever your scraper's delivery config points (API download, webhook, or S3/GCS/Azure). See the two companion tutorials for [webhook delivery](/products/scrapers/tutorials/linkedin-to-crm) and [S3 delivery](/products/scrapers/tutorials/amazon-price-monitor).

## Part 5: Wire it together and run

Add a `main` block that glues the three steps:

```python listen.py theme={null}
def main() -> int:
    api_key = os.environ.get("BRIGHTDATA_API_KEY")
    zone = os.environ.get("BRIGHT_DATA_SERP_ZONE")

    if not (api_key and zone):
        print("Set BRIGHTDATA_API_KEY and BRIGHT_DATA_SERP_ZONE before running.")
        return 1

    if len(sys.argv) < 2:
        print("Usage: python listen.py \"your keyword\"")
        return 1

    keyword = sys.argv[1]
    print(f"Discovering mentions of: {keyword}")

    results_by_platform = discover(keyword, api_key, zone)
    buckets = classify(results_by_platform)

    print("Classified URLs:")
    for platform, urls in buckets.items():
        print(f"  {platform}: {len(urls)}")

    print("Triggering scrapers:")
    for platform, urls in buckets.items():
        trigger(platform, urls, api_key)

    return 0


if __name__ == "__main__":
    sys.exit(main())
```

Run it with a keyword that is likely to show up on all three platforms:

```bash theme={null}
python listen.py "bright data"
```

You should see output like:

Example output. Your values will differ. The URL counts depend on the search results on the day you run the script.

```text theme={null}
Discovering mentions of: bright data
Classified URLs:
  instagram: 9
  tiktok: 10
  x: 10
Triggering scrapers:
  instagram: 9 URLs -> snapshot sd_mnte2pbv16riike0ao
  tiktok: 10 URLs -> snapshot sd_mnte2q1nw3g36l4z1
  x: 10 URLs -> snapshot sd_mnte2qt91ga85uuq8r
```

Three snapshot IDs, one per platform. Each is now running asynchronously at Bright Data and will deliver results to wherever you've configured that scraper's delivery destination.

## Troubleshooting

### Why does a platform show 0 URLs?

The SERP API search returned no post URLs for that keyword on that platform. The Part 3 regexes keep only post-shaped links, so a search whose top 10 results are all profile or topic pages also counts as 0. The script then prints `no URLs to trigger` for that platform and starts no job. Try a broader keyword.

### How do I check that the results arrived?

Poll each `snapshot_id` that the script printed with [Monitor progress](/api-reference/scrapers/management-apis/monitor-progress) (`GET /datasets/v3/progress/{snapshot_id}`) until the `status` field reads `ready`. Then fetch the records with [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot) (`GET /datasets/v3/snapshot/{snapshot_id}`). Each platform runs as its own job, so check each of the three snapshot IDs separately.

### Why does a trigger call return a 429?

The social scraper has too many running jobs. The Scraper API allows 5,000 active jobs or snapshots, and a new trigger past that limit returns HTTP 429 with `You have too many running jobs for this dataset`. Wait the seconds in the `Retry-After` header before you run the script again. Bright Data blocks an IP that receives 25 or more 429 responses within 5 minutes.

For every Scraper API error message, see [Scraper API error codes](/products/scrapers/error-codes). For job, payload and download limits, see [Scraper API limits](/products/scrapers/limits).

## Congratulations

You've built a keyword social listener that:

* Uses the **SERP API** in `parsed_light` mode as a compact, sub-second discovery engine
* Takes the **top 10 organic results** per query and classifies them by platform with post-shape regexes
* **Triggers** the Instagram, TikTok and X scrapers in parallel on the discovered URLs
* Exits immediately after trigger, leaving the heavy work to Bright Data

The whole pipeline is one Python file. No proxy setup, no glue services and no batch jobs.

## Next steps

<CardGroup>
  <Card title="Deliver to a webhook" icon="webhook" href="/products/scrapers/tutorials/linkedin-to-crm">
    Point each social scraper at a webhook handler (like the Next.js one in the LinkedIn tutorial) to get mapped post records back in real time.
  </Card>

  <Card title="Deliver to S3" icon="bucket" href="/products/scrapers/tutorials/amazon-price-monitor">
    Configure S3 delivery on each scraper and schedule this script with GitHub Actions for a daily mention report.
  </Card>

  <Card title="Narrow the search" icon="filter" href="/products/serp-api/query-parameters/google">
    Full list of Google-specific query parameters you can add to the search URL, including `gl`, `hl`, `uule` and time filters.
  </Card>

  <Card title="SERP API reference" icon="bolt" href="/products/serp-api/introduction">
    All supported engines, parsed output schema and async request mode for large volumes.
  </Card>
</CardGroup>


# X (Twitter) Scraper API
Source: https://docs.brightdata.com/products/scrapers/twitter/introduction

Use the Bright Data [X (Twitter) Scraper API](https://brightdata.com/products/web-scraper/twitter) to extract structured data from profiles and posts. Best for up to 20 URLs per sync request.

Send an X.com URL, get structured JSON back. The Bright Data X Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/twitter?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 X (Twitter) records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more X (formerly Twitter) URLs to the Bright Data X Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (profiles or posts) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data X (Twitter) Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/twitter/quickstart).

```json theme={null}
{
  "followers": 241583960,
  "following": 1403,
  "is_verified": true,
  "profile_image_link": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_400x400.jpg",
  "x_id": "44196397",
  "url": "https://x.com/elonmusk",
  "id": "elonmusk",
  "profile_name": "Elon Musk",
  "biography": "https://t.co/ZdBx5WABYx",
  "date_joined": "2009-06-02T20:12:29.000Z"
}
```

## Supported data types

<CardGroup>
  <Card title="Profiles" icon="user" href="/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url">
    Follower counts, bios, verification status, profile images. Discover profiles by username.
  </Card>

  <Card title="Posts" icon="message" href="/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url">
    Post text, likes, reposts, replies, media, and hashtags.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each X (Twitter) data type uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| Profiles | `gd_lwxmeb2u1cniijd7t4` |
| Posts | `gd_lwxkxvnf1cynvib9co` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data X (Twitter) Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

X (Twitter) changes how its pages are served, and the Bright Data X (Twitter) Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between URL collection and discovery?

**URL collection** scrapes a specific X page you provide (e.g., a profile URL). **Discovery** finds X content matching search criteria (e.g., profiles matching a username) and scrapes the results. Discovery is accepted on both endpoints. On `/scrape` it usually runs past the 1-minute limit and returns HTTP `202` with a `snapshot_id`, so use the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint for discovery.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/twitter/quickstart">
    Scrape your first X profile in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/twitter/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# X (Twitter) scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/twitter/quickstart

Set up the Bright Data X (Twitter) Scraper API and collect your first profile or post as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape an X (formerly Twitter) profile and get structured JSON data using the Bright Data X Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/twitter?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/twitter?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Profiles endpoint**. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.x.profiles(url="https://x.com/elonmusk")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://x.com/elonmusk"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_lwxmeb2u1cniijd7t4", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://x.com/elonmusk"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://x.com/elonmusk" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the returned records from `result.data`. It waits up to 240 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data X (Twitter) Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of profile data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data X Scraper API returns a JSON array with structured profile data:

    ```json theme={null}
    [
      {
        "followers": 241583960,
        "following": 1403,
        "is_verified": true,
        "url": "https://x.com/elonmusk",
        "x_id": "44196397",
        "id": "elonmusk",
        "profile_name": "Elon Musk",
        "biography": "https://t.co/ZdBx5WABYx",
        "profile_image_link": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_400x400.jpg",
        "date_joined": "2009-06-02T20:12:29.000Z"
      }
    ]
    ```

    Each profile object includes fields covering follower counts, bio, verification status, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first X profile using the Bright Data X Scraper API.

## Common questions

### Can I scrape multiple profiles in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://x.com/elonmusk"},
  {"url": "https://x.com/BillGates"},
  {"url": "https://x.com/NASA"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the X profile URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://x.com/username`.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | Call `client.scrape.<platform>.<endpoint>(url="...")`; the method list is in the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines list` prints every pipeline name, then run `bdata pipelines <pipeline> "<url>" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/twitter/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# X (Twitter) Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/twitter/send-first-request

Send synchronous requests to all 2 Bright Data X (Twitter) Scraper API endpoints with copy-paste examples for profiles and posts collection.

This guide shows you how to send a synchronous request to each Bright Data X Scraper API endpoint. It covers profiles and posts.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/twitter?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/twitter/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://x.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape X (Twitter) profiles

**Dataset ID:** `gd_lwxmeb2u1cniijd7t4`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "followers": 241583960,
      "following": 1403,
      "is_verified": true,
      "profile_image_link": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_400x400.jpg",
      "x_id": "44196397",
      "url": "https://x.com/elonmusk",
      "id": "elonmusk",
      "profile_name": "Elon Musk",
      "biography": "https://t.co/ZdBx5WABYx",
      "date_joined": "2009-06-02T20:12:29.000Z"
    }
  ]
  ```
</Accordion>

[Full Profiles response schema](/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url)

### Which output fields does the X (Twitter) profiles scraper return?

The X (Twitter) profiles scraper (`gd_lwxmeb2u1cniijd7t4`, `collect_by_url`) returns 22 output fields.

<Accordion title="Output fields (22)">
  | Field | Type | Description |
  | - | - | - |
  | `x_id` | text | Unique X id of each profile |
  | `url` | url | Profile URL |
  | `id` | text | ID of the post |
  | `profile_name` | text | Profile username |
  | `biography` | text | Bio of the profile |
  | `is_verified` | boolean | Is the user verified |
  | `profile_image_link` | url | Profile Image link |
  | `external_link` | url | External link |
  | `date_joined` | date | Date where the profile joined twitter |
  | `following` | number | Number of profiles the user follows |
  | `followers` | number | Number of followers of the profile |
  | `subscriptions` | number | Number of subscriptions of the profile |
  | `location` | text | Profile location |
  | `birth_date` | date | Profile birth date |
  | `posts_count` | number | Number of profile's posts |
  | `posts` | array | |
  | `suggested_profiles` | array | Suggested profiles |
  | `is_business_account` | boolean | Is the profile a business account |
  | `is_government_account` | boolean | Is it a government account |
  | `category_name` | array | Category names |
  | `max_number_of_posts` | number | The number of posts input from discovery |
  | `banner_image` | url | The profile's banner image |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lwxmeb2u1cniijd7t4.json`](/scrapers/gd_lwxmeb2u1cniijd7t4.json)

## How to scrape X (Twitter) posts

**Dataset ID:** `gd_lwxkxvnf1cynvib9co`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxkxvnf1cynvib9co&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://x.com/elonmusk/status/1519480761749016577"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://x.com/elonmusk/status/1519480761749016577",
      "user_posted": "elonmusk",
      "description": "Next I’m buying Coca-Cola to put the cocaine back in",
      "date_posted": "2022-04-28T00:56:58.000Z",
      "likes": 4196406,
      "replies": 167707,
      "hashtags": null,
      "id": "1519480761749016577",
      "name": "Elon Musk",
      "reposts": 577446
    }
  ]
  ```
</Accordion>

[Full Posts response schema](/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url)

### Which output fields does the X (Twitter) posts scraper return?

The X (Twitter) posts scraper (`gd_lwxkxvnf1cynvib9co`, `collect_by_url`) returns 32 output fields.

<Accordion title="Output fields (32)">
  | Field | Type | Description |
  | - | - | - |
  | `id` | text | ID of the post |
  | `user_posted` | text | Username of the post owner |
  | `name` | text | Name of the post owner |
  | `description` | text | Post text description |
  | `date_posted` | date | Post publication date |
  | `photos` | array | URLs of attached photos |
  | `url` | url | URL of the post |
  | `quoted_post` | object | Quoted post details |
  | `tagged_users` | array | Tagged profiles from the post |
  | `replies` | number | Number of replies |
  | `reposts` | number | Number of reposts; There may be a difference between the value displayed on the web interface and the actual value collected from the server side, where the data is retrieved |
  | `likes` | number | Number of likes |
  | `views` | number | Number of views |
  | `external_url` | url | External URL from a post |
  | `hashtags` | array | Hashtags from the post |
  | `followers` | number | Number of followers of the profile |
  | `biography` | text | Bio of the profile |
  | `posts_count` | number | Number of profile's posts |
  | `profile_image_link` | url | Profile image link |
  | `following` | number | Number of profiles the user follows |
  | `is_verified` | boolean | Is the user verified |
  | `quotes` | number | Number of times the post was quoted |
  | `bookmarks` | number | The number of times the post was bookmarked |
  | `parent_post_details` | object | Details of the parent post this post is replying to |
  | `external_image_urls` | array | The URL for the images attached to the post |
  | `videos` | array | Videos attached to the post |
  | `external_video_urls` | array | URLs of externally hosted videos attached to the post |
  | `verification_type` | text | The type of verification badge assigned to the user's profile (e.g. blue check, organization) |
  | `user_id` | text | The user ID |
  | `context_added` | text | Context added by the readers |
  | `is_repost` | boolean | True when the post is a repost |
  | `ai_generated_images` | array | List of images attached to the post, each with its URL and AI generation label |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lwxkxvnf1cynvib9co.json`](/scrapers/gd_lwxkxvnf1cynvib9co.json)

## Quick reference: dataset IDs

| Endpoint | Dataset ID | URL pattern |
| :- | :- | :- |
| Profiles | `gd_lwxmeb2u1cniijd7t4` | `x.com/{username}` |
| Posts | `gd_lwxkxvnf1cynvib9co` | `x.com/{username}/status/{id}` |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# YouTube Scraper API
Source: https://docs.brightdata.com/products/scrapers/youtube/introduction

Use the Bright Data [YouTube Scraper API](https://brightdata.com/products/web-scraper/youtube) to extract structured data from channels, videos and comments. Best for up to 20 URLs per sync request.

Send a YouTube URL, get structured JSON back. The Bright Data YouTube Scraper API handles proxies, CAPTCHAs, and parsing so you can focus on your data pipeline.

<Tip>
  New to Bright Data? [Create a free account](https://brightdata.com/products/web-scraper/youtube?hs_signup=1\&utm_source=docs) and get **5,000 free credits every month**, no credit card required. That's up to **5,000 YouTube records** to start scraping. See the [free tier](/general/account/billing-and-pricing/free-tier).
</Tip>

## How it works

You send one or more YouTube URLs to the Bright Data YouTube Scraper API. Bright Data handles the scraping infrastructure and returns clean, structured JSON.

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

All requests use a `dataset_id` to specify the data type (videos, channels, or comments) and return results in NDJSON (default), JSON, JSON lines, CSV and Parquet. See [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## What the response looks like

A single record returned by the Bright Data YouTube Scraper API on September 6, 2026, trimmed to the fields shown. Run the request yourself in the [quickstart](/products/scrapers/youtube/quickstart).

```json theme={null}
{
  "subscribers": 516000000,
  "url": "https://www.youtube.com/@mrbeast",
  "handle": "@MrBeast",
  "handle_md5": "dd748d5dfc88b91ea388429c3c685874",
  "banner_img": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-...",
  "profile_image": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj",
  "name": "MrBeast",
  "Description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000...",
  "videos_count": 1000,
  "created_date": "2012-02-19T00:00:00.000Z"
}
```

## Supported data types

<CardGroup>
  <Card title="Videos" icon="video" href="/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url">
    Titles, views, likes, descriptions, durations, and thumbnails. Discover videos by keyword, hashtag, or explore.
  </Card>

  <Card title="Channels" icon="user" href="/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url">
    Subscriber counts, video counts, descriptions, and verification status. Discover channels by keyword.
  </Card>

  <Card title="Comments" icon="comments" href="/api-reference/scrapers/social-media-apis/youtube-comments-collect-by-url">
    Comment text, likes, replies, commenter details for any video.
  </Card>
</CardGroup>

## Which dataset IDs to use

Each YouTube data type uses its own `dataset_id`. Pass the ID as a query parameter on every request.

| Data type | Dataset ID |
| :- | :- |
| Videos | `gd_lk56epmy2i5g7lzu0k` |
| Channels | `gd_lk538t2k2p1k3oos71` |
| Comments | `gd_lk9q0ew71spt1mxywf` |

## Request methods

The Bright Data Scraper API supports two request methods. Choose based on your volume and latency needs.

| Method | Endpoint | Best for |
| :- | :- | :- |
| **Synchronous** | `/scrape` | Real-time lookups, up to 20 URLs |
| **Asynchronous** | [`/trigger`](/products/scrapers/scrapers-library/async-requests) | Batch jobs, 20 or more URLs, production pipelines |

Learn more in [Understanding sync vs. async requests](/concepts/sync-vs-async).

Both endpoints take an object with an `input` array, plus optional `limit_per_input` and `custom_output_fields`, or a `deliver` block on `/trigger`. A bare JSON array of inputs is also accepted, and the examples on this page use it. See [Request body](/api-reference/scrapers/synchronous-requests#request-body).

## Capabilities and limits

| Capability | Detail |
| :- | :- |
| **Output formats** | NDJSON (default), JSON, JSON lines, CSV and Parquet ([where each applies](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use)) |
| **Max URLs per sync request** | 20 |
| **Max URLs per async request** | Unlimited, up to 1 GB of input per job |
| **Data freshness** | Real-time (scraped on demand) |
| **Delivery options** | API download, [webhook](/products/scrapers/scrapers-library/data-delivery), [Amazon S3](/products/scrapers/scrapers-library/data-delivery), Snowflake, Azure, GCS ([all destinations](/products/scrapers/scrapers-library/data-delivery)) |
| **Pricing** | Pay per successful record ([see pricing](https://brightdata.com/pricing/web-scraper)) |

## Common questions

### Is the data scraped in real time?

Yes. Each request triggers a live scrape. There is no cached or stale data. Processing time varies with target-site conditions and scraper workload. The Bright Data YouTube Scraper API does not publish a fixed response time. A synchronous request waits up to 1 minute, then returns HTTP `202` with a `snapshot_id` and continues asynchronously. Discovery requests always run asynchronously and take longer depending on result volume.

### Why do response times change over time?

YouTube changes how its pages are served, and the Bright Data YouTube Scraper API collectors are updated to match. A collector update can change how long a scrape takes even when the success rate stays the same. For production workloads, build against the [async workflow](/products/scrapers/scrapers-library/async-requests) or [webhook delivery](/products/scrapers/scrapers-library/data-delivery) so a longer run does not break the integration.

### What is the difference between URL collection and discovery?

**URL collection** scrapes a specific YouTube page you provide (e.g., a channel URL). **Discovery** finds YouTube content matching search criteria (e.g., videos by keyword or hashtag) and scrapes the results. Discovery is accepted on both endpoints. On `/scrape` it usually runs past the 1-minute limit and returns HTTP `202` with a `snapshot_id`, so use the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint for discovery.

### How is this different from scraping using proxies or Web Unlocker API?

When scraping using proxies or Web Unlocker API, you still need to write and maintain your own parsing logic and update it whenever the target site changes its page structure. The Bright Data Scraper API handles the entire stack: proxy rotation, anti-bot bypassing and parsing. You send a URL or keyword and get clean, structured JSON back, with no scraping infrastructure or parser maintenance on your end.

## Next steps

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/scrapers/youtube/quickstart">
    Scrape your first YouTube channel in 5 minutes.
  </Card>

  <Card title="Endpoints" icon="bolt" href="/products/scrapers/youtube/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url">
    Endpoint specs, parameters, and response schemas.
  </Card>
</CardGroup>


# YouTube scraper quickstart
Source: https://docs.brightdata.com/products/scrapers/youtube/quickstart

Set up the Bright Data YouTube Scraper API and collect your first channel, video or comment as structured JSON in under 5 minutes with cURL, Python or Node.js.

This tutorial shows you how to scrape a YouTube channel and get structured JSON data using the Bright Data YouTube Scraper API.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/youtube?hs_signup=1\&utm_source=docs)
* cURL, Python 3.9+, or Node.js 18+ installed

<Steps>
  <Step title="Get your API key">
    Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have.

    If you don't have an account yet, [sign up at brightdata.com](https://brightdata.com/products/web-scraper/youtube?hs_signup=1\&utm_source=docs). New accounts get 5,000 free credits every month, no credit card required. See the [free tier](/general/account/billing-and-pricing/free-tier).

    <Warning>
      Your API key is shown only once when created. Copy and store it securely.
    </Warning>
  </Step>

  <Step title="Send a request">
    We'll use the **Channels endpoint**. The quickest route is the Bright Data Python SDK (`pip install brightdata-sdk`), which waits for the result for you. The other tabs call the API directly with a synchronous request. Replace `YOUR_API_KEY` with your API key:

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.youtube.channels(url="https://www.youtube.com/@MrBeast")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.youtube.com/@MrBeast"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_lk538t2k2p1k3oos71", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.youtube.com/@MrBeast"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.youtube.com/@MrBeast" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    The SDK prints the returned records from `result.data`. It waits up to 240 seconds for the result, so you don't handle a `202` yourself. With cURL, Python or Node.js you should see a `200` status code and a JSON array. A `202` means the scrape needs longer than 1 minute; see the note below. Processing time varies with target-site conditions and scraper workload.

    <Note>
      A synchronous request waits up to 1 minute. If the Bright Data YouTube Scraper API needs longer, the response is HTTP `202` with a `snapshot_id` instead of channel data, and collection continues asynchronously. Fetch the result with the [async workflow](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
    </Note>
  </Step>

  <Step title="Review the response">
    The Bright Data YouTube Scraper API returns a JSON array with structured channel data:

    ```json theme={null}
    [
      {
        "subscribers": 516000000,
        "url": "https://www.youtube.com/@mrbeast",
        "handle": "@MrBeast",
        "handle_md5": "dd748d5dfc88b91ea388429c3c685874",
        "banner_img": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-...",
        "profile_image": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj",
        "name": "MrBeast",
        "Description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000...",
        "videos_count": 1000,
        "created_date": "2012-02-19T00:00:00.000Z"
      }
    ]
    ```

    Each channel object includes fields covering subscriber counts, video counts, description, and more. See the [full response schema](/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url).
  </Step>
</Steps>

You've successfully scraped your first YouTube channel using the Bright Data YouTube Scraper API.

## Common questions

### Can I scrape multiple channels in one request?

Yes. Add more objects to the input array. Bright Data recommends 20 URLs or fewer per synchronous request, a best practice rather than a hard limit. For larger batches, use the [async `/trigger` endpoint](/products/scrapers/scrapers-library/async-requests).

```json theme={null}
[
  {"url": "https://www.youtube.com/@MrBeast"},
  {"url": "https://www.youtube.com/@PewDiePie"},
  {"url": "https://www.youtube.com/@mkbhd"}
]
```

### Getting a 401 or 403 error?

Verify your API key is correct and hasn't expired. Create a new API key in [Account settings](https://brightdata.com/cp/setting/users). See the [authentication guide](/api-reference/authentication) for details.

### Request is timing out?

Synchronous requests have a 1-minute timeout. If the request exceeds this limit, the API returns HTTP `202` with a `snapshot_id` and finishes the job asynchronously. Use the [async workflow](/products/scrapers/scrapers-library/async-requests) for large batches.

### Empty or partial response data?

Verify the YouTube channel URL is publicly accessible and correctly formatted. The URL should follow the pattern `https://www.youtube.com/@handle`.

## Do I have to call the API directly?

No. The Bright Data SDKs, the CLI and coding-agent tools call the same Scraper API, so you can start from whichever fits your stack.

| Client | Install | First call |
| :- | :- | :- |
| **Python and Node.js SDK** | `pip install brightdata-sdk` or `npm install @brightdata/sdk` | `client.scrape.youtube.channels(url="https://www.youtube.com/@MrBeast")`; see the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`, then `bdata login` | `bdata pipelines youtube_profiles "https://www.youtube.com/@MrBeast" --pretty`; see the [CLI commands](/products/cli/commands) |
| **Coding agents** | `npx skills add brightdata/skills` installs the skills; the [Bright Data MCP](/products/mcp-server/overview) server exposes the scrapers as tools | See the [coding agent quickstart](/quickstart-coding-agent) |

## Next steps

<CardGroup>
  <Card title="Endpoints" icon="bolt" href="/products/scrapers/youtube/send-first-request">
    One request per endpoint, each with a captured response.
  </Card>

  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="Set up webhooks" icon="webhook" href="/products/scrapers/scrapers-library/data-delivery">
    Receive results automatically when scraping completes.
  </Card>
</CardGroup>


# YouTube Scraper API endpoints
Source: https://docs.brightdata.com/products/scrapers/youtube/send-first-request

Send synchronous requests to all 3 Bright Data YouTube Scraper API endpoints with copy-paste examples for channels, videos and comments collection.

This guide shows you how to send a synchronous request to each Bright Data YouTube Scraper API endpoint. It covers channels, videos, and comments.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper/youtube?hs_signup=1\&utm_source=docs) with an active API key
* Completed the [Quickstart](/products/scrapers/youtube/quickstart)

## Request structure

Every synchronous request follows the same pattern:

```http theme={null}
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.youtube.com/..."}]
```

The only thing that changes between endpoints is the `dataset_id` and the input URL format.

<Note>
  The `/scrape` endpoint is built for real-time, single-URL requests. Bright Data recommends 20 URLs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP `202` with a `snapshot_id` instead of data, and collection continues asynchronously. Fetch the result with [async requests](/products/scrapers/scrapers-library/async-requests) or have it pushed to you with [webhook delivery](/products/scrapers/scrapers-library/data-delivery).
</Note>

## How to scrape YouTube channels

**Dataset ID:** `gd_lk538t2k2p1k3oos71`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/@MrBeast"}]'
```

You should see a `200` response. Processing time varies with target-site conditions and scraper workload.

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "subscribers": 516000000,
      "url": "https://www.youtube.com/@mrbeast",
      "handle": "@MrBeast",
      "handle_md5": "dd748d5dfc88b91ea388429c3c685874",
      "banner_img": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-...",
      "profile_image": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj",
      "name": "MrBeast",
      "Description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000...",
      "videos_count": 1000,
      "created_date": "2012-02-19T00:00:00.000Z"
    }
  ]
  ```
</Accordion>

[Full Channels response schema](/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url)

### Which output fields does the YouTube channels scraper return?

The YouTube channels scraper (`gd_lk538t2k2p1k3oos71`, `collect_by_url`) returns 21 output fields.

<Accordion title="Output fields (21)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | URL that link directly to the YouTube profile |
  | `handle` | text | Unique to each user (e.g., @name) |
  | `handle_md5` | text | This field stores the MD5 hash of the handle field. |
  | `banner_img` | url | URL that links to the banner photo |
  | `profile_image` | url | URL that link to the profile picture |
  | `name` | text | Profile name |
  | `subscribers` | number | How many subscribers the profile have |
  | `Description` | text | Brief descriptions or statements that users write to introduce themselves or share their interests and passions on YouTube |
  | `videos_count` | number | How many videos the profile have |
  | `created_date` | date | The date the profile was created |
  | `views` | number | How many views the profile have |
  | `Details` | object | channel Details |
  | `Links` | array | External websites that users may link to from their YouTube profiles |
  | `identifier` | text | identifier |
  | `discovery_input` | object | Discovery input value |
  | `id` | text | channel id |
  | `has_podcast` | boolean | has podcast indicator |
  | `top_videos` | array | top videos |
  | `featured_video` | url | Featured Video |
  | `featured_channels` | array | featured channels |
  | `collaborations` | array | Collaborations videos |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lk538t2k2p1k3oos71.json`](/scrapers/gd_lk538t2k2p1k3oos71.json)

## How to scrape YouTube videos

**Dataset ID:** `gd_lk56epmy2i5g7lzu0k`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
      "views": 1812511291,
      "likes": 19374379,
      "date_posted": "2009-10-25T06:57:33.000Z",
      "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick...",
      "num_comments": 2457228,
      "youtuber": "@RickAstleyYT",
      "youtuber_md5": "4fc65cd6213b5c0f1d04c2aa3006f46a",
      "video_url": "https://rr2---sn-n4v7snse.googlevideo.com/videoplayback?expire=1788712345&ei=OUGdaoSULZ-RsfIP8OmfsAo&ip=208.41.164.3&id=o-ALklNMQDHiVh32KdRiuWf9qyPo-8mNxywN-..."
    }
  ]
  ```
</Accordion>

[Full Videos response schema](/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url)

### Which output fields does the YouTube videos scraper return?

The YouTube videos scraper (`gd_lk56epmy2i5g7lzu0k`, `collect_by_url`) returns 49 output fields.

<Accordion title="Output fields (49)">
  | Field | Type | Description |
  | - | - | - |
  | `url` | url | The full YouTube watch URL of the collected video |
  | `title` | text | Title of the YouTube video |
  | `youtuber` | text | The channel handle extracted from the channel's browse endpoint |
  | `youtuber_md5` | text | MD5 hash of the youtuber field |
  | `video_url` | url | Direct streaming URL of the video file, extracted from YouTube's adaptive formats or decoded from signatureCipher |
  | `video_length` | number | Duration of the video in seconds |
  | `likes` | number | Number of likes received by the video |
  | `views` | number | Number of views the video has received |
  | `date_posted` | date | Date when the video was published |
  | `description` | text | Text description accompanying the video |
  | `num_comments` | number | Number of comments on the video, as displayed by YouTube (includes both top-level comments and replies in YouTube's count) |
  | `subscribers` | number | Number of subscribers to the YouTube channel |
  | `music` | object | Information about the music used in the video. Only present when YouTube's Content ID system has identified music in the video |
  | `video_id` | text | Unique identifier for the YouTube video |
  | `channel_url` | url | URL-encoded URL of the YouTube channel, derived from the channel's canonical browse endpoint |
  | `preview_image` | image | URL of the preview image for the video |
  | `shortcode` | text | The unique short identifier of the video, identical to video\_id, used across all YouTube video types including regular videos and Shorts |
  | `verified` | boolean | Indicates whether the channel is verified |
  | `handle_name` | text | The display name of the YouTube channel as shown on the video page |
  | `avatar_img_channel` | url | The URL of the avatar image of the YouTube channel |
  | `is_sponsored` | boolean | Indicates whether the video contains a paid content overlay as declared by YouTube |
  | `related_videos` | array | List of URLs of videos shown in the sidebar alongside the current video |
  | `license` | url | URL of the video's license as declared in YouTube's video metadata |
  | `viewport_frames` | text | Resolution of the primary video stream format, derived from YouTube's streaming data |
  | `current_optimal_res` | text | Current and optimal video resolution with frame rate, from YouTube's streaming format metadata |
  | `codecs` | text | Video and audio codec strings formatted as video codec and audio codec, extracted from YouTube's adaptive streaming formats |
  | `color` | text | Color primaries of the video stream, extracted from YouTube's adaptive format color info |
  | `quality` | text | Quality identifier of the first adaptive streaming format as reported by YouTube |
  | `quality_label` | text | Human-readable video quality label as reported by YouTube |
  | `post_type` | text | Type of YouTube content inferred from the URL structure. Possible values: post for standard video, short for YouTube Short, or N/A |
  | `youtuber_id` | text | YouTube's internal channel ID, distinct from the channel handle |
  | `transcript` | text | Full plain-text transcript of the video, compiled from YouTube's caption tracks. English captions are preferred, falls back to the first available language if English is unavailable |
  | `formatted_transcript` | array | Timestamped transcript segments from YouTube's caption tracks, each containing start time, end time, and duration in milliseconds, and the caption text |
  | `hashtags` | array | List of hashtags found in the video title or description, each with the hashtag text and its YouTube search link |
  | `tags` | array | Tags of the video |
  | `next_recommended_videos` | array | Videos shown as end-screen cards during the final seconds of the video, including timing in milliseconds and display style |
  | `recommended_videos` | array | Videos recommended by YouTube in the sidebar alongside the current video |
  | `transcript_language` | array | List of caption and transcript languages available for this video on YouTube, including whether each track was auto-generated |
  | `chapters` | array | List of chapter markers defined by the creator, each with a title, start time in milliseconds, and preview image |
  | `transcription_language` | text | The language code requested by the caller for transcript retrieval, passed as an input parameter at collection time |
  | `is_age_restricted` | boolean | Whether the video is age-restricted, inferred from a non-OK playability status combined with an age-related reason from YouTube |
  | `channel_url_decoded` | text | Plain-text percent-decoded version of the channel URL |
  | `category` | text | YouTube's content category assigned to the video, from YouTube's predefined category taxonomy |
  | `audio_tracks` | array | audio Tracks |
  | `made_for_kids` | boolean | Indicates whether the video is designated as made for kids, inferred from the YouTube miniplayer playback mode |
  | `player_notification_text` | text | User-facing notification text shown inside the video player |
  | `ai_content_label` | boolean | Indicates whether the video has been labeled as AI-generated or significantly AI-altered, either by the creator or auto-detected by YouTube. |
  | `live_status` | text | Livestream status of the video, equivalent to yt-dlp's live\_status. One of "is\_live", "was\_live", or "not\_live", parsed from YouTube's info string (e.g. "Streamed live 29 minutes ago") or defaulted to "not\_live" for regular videos |
  | `comments` | array | 10 Most relevant comments of the video |
</Accordion>

Machine-readable version with the input schema: [`/scrapers/gd_lk56epmy2i5g7lzu0k.json`](/scrapers/gd_lk56epmy2i5g7lzu0k.json)

## How to scrape YouTube comments

**Dataset ID:** `gd_lk9q0ew71spt1mxywf`

```bash theme={null}
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk9q0ew71spt1mxywf&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}]'
```

<Accordion title="Example response">
  ```json theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "likes": 311000,
      "replies": 0,
      "comment_id": "Ugzge340dBgB75hWBm54AaABAg",
      "comment_text": "can confirm: he never gave us up",
      "username": "@Yo***e",
      "username_md5": "0e4d7a0778633b4acf6631dd251f0797",
      "user_channel": "https://www.youtube.com/@YouTube",
      "date": "1 year ago",
      "video_id": "dQw4w9WgXcQ"
    }
  ]
  ```
</Accordion>

[Full Comments response schema](/api-reference/scrapers/social-media-apis/youtube-comments-collect-by-url)

### Which output fields does the YouTube comments scraper return?

The YouTube comments scraper (`gd_lk9q0ew71spt1mxywf`, `collect_by_url`) returns 16 output fields.

| Field | Type | Description |
| - | - | - |
| `comment_id` | text | Unique identifier for each comment |
| `comment_text` | text | The text content of the comment |
| `likes` | number | Number of likes received by the comment |
| `replies` | number | Number of replies to the comment |
| `username` | text | Username of the commenter |
| `username_md5` | text | This field stores the MD5 hash of the username field. |
| `user_channel` | text | URL of the commenter's YouTube channel |
| `date` | text | Date when the comment was posted |
| `url` | url | Web address of the YouTube video where the comment was posted |
| `video_id` | text | Unique identifier for the YouTube video |
| `replies_value` | array | Array of reply objects associated with this comment |
| `replies_without_names` | array | Array of reply objects with personally identifiable information (usernames) removed, containing only MD5 hashed user identifiers |
| `user_id` | text | Unique identifier for the commenter's YouTube channel |
| `mentioned_timestamps_minutes` | array | Array of timestamps mentioned in the comment, formatted in minutes (e.g., '2:35') |
| `mentioned_timestamps_seconds` | array | Array of timestamps mentioned in the comment, converted to total seconds |
| `date_iso` | date | Date in ISO format |

Machine-readable version with the input schema: [`/scrapers/gd_lk9q0ew71spt1mxywf.json`](/scrapers/gd_lk9q0ew71spt1mxywf.json)

## Quick reference: dataset IDs

| Endpoint | Dataset ID | URL pattern |
| :- | :- | :- |
| Videos | `gd_lk56epmy2i5g7lzu0k` | `youtube.com/watch?v={video_id}` |
| Channels | `gd_lk538t2k2p1k3oos71` | `youtube.com/@{handle}` |
| Comments | `gd_lk9q0ew71spt1mxywf` | `youtube.com/watch?v={video_id}` |

## Output formats

Control the response format with the `format` query parameter:

| Value | Description |
| :- | :- |
| `json` | JSON array |
| `ndjson` | Newline-delimited JSON, one record per line (default) |
| `csv` | Comma-separated values |

These are the `format` values for `/scrape`. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in [output formats](/products/scrapers/scrapers-library/data-delivery#which-output-formats-can-i-use).

## Related

<CardGroup>
  <Card title="Async batch requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Scrape hundreds of URLs in a single batch job.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url">
    Full parameter and response field reference.
  </Card>
</CardGroup>


# Bright Data quickstart
Source: https://docs.brightdata.com/quickstart

Scrape your first page with the Bright Data Scraper API in three steps, then build a custom scraper with Scraper Studio for sites it does not cover.

Send one request to the Bright Data Scraper API and get structured JSON back.

This guide scrapes an Amazon product page. The same call works for every one of Bright Data's thousands of pre-built scrapers: change the `dataset_id` over HTTP, or call a different method in the SDK.

## Prerequisites

* A [Bright Data account](https://brightdata.com/products/web-scraper?hs_signup=1\&utm_source=docs). New accounts get **5,000 free credits every month**, no credit card required
* One of:
  * cURL
  * Python 3.9+ with the Bright Data Python SDK: `pip install brightdata-sdk`
  * Node.js 20+ with the Bright Data JavaScript SDK: `npm install @brightdata/sdk`

## Scrape your first page

<Steps>
  <Step title="Get your API key">
    New accounts receive an API key in the Bright Data welcome email. Use that key for this guide.

    If you no longer have that email, open [Account settings](https://brightdata.com/cp/setting/users) and click **Add API key** to create a new one. Only admins can create API keys.

    <Warning>
      A Bright Data API key is shown once, at the moment it is created. Existing keys cannot be viewed in plain text afterwards, so copy the key and store it securely as soon as it appears. If you lost a key, create a new one rather than looking for the old one.
    </Warning>

    The same key works across every Bright Data product, so this is the only credential step in this guide.
  </Step>

  <Step title="Send a request">
    This request scrapes an Amazon product page. Replace `YOUR_API_KEY` with your API key and run it as-is.

    <ScraperQuickstartCode />

    You should see the product JSON printed. Processing time varies with target-site conditions and scraper workload. A synchronous request waits up to 1 minute, then returns a `snapshot_id` and collection continues asynchronously.
  </Step>

  <Step title="Read the response">
    The Bright Data Scraper API returns a JSON array with structured product data. The Python SDK exposes it as `result.data`; the JavaScript SDK returns the array directly:

    ```json theme={null}
    [
      {
        "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
        "asin": "B0FQFB8FMG",
        "brand": "Apple",
        "initial_price": 249,
        "final_price": 199.99,
        "currency": "USD",
        "rating": 4.4,
        "reviews_count": 14302,
        "seller_name": "Amazon.com",
        "availability": "In Stock",
        "image_url": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_SL1500_.jpg",
        "url": "https://www.amazon.com/dp/B0FQFB8FMG"
      }
    ]
    ```

    The full record carries 64 fields, including variants, delivery, buybox prices and customer review topics. See the [full response schema](/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url).
  </Step>
</Steps>

You now have a working Bright Data integration.

## How do I scrape a different site?

Over HTTP, every scraper has its own `dataset_id`: change that value and the input URL, and keep the rest of the request identical. In the SDKs, call the matching method instead.

| Site | `dataset_id` for cURL | Python SDK method | Quickstart |
| :- | :- | :- | :- |
| Amazon | `gd_l7q7dkf244hwjntr0` | `scrape.amazon.products` | [Amazon](/products/scrapers/amazon/quickstart) |
| LinkedIn | `gd_l1viktl72bvl7bjuj0` | `scrape.linkedin.profiles` | [LinkedIn](/products/scrapers/linkedin/quickstart) |
| Instagram | `gd_l1vikfch901nx3by4` | `scrape.instagram.profiles` | [Instagram](/products/scrapers/instagram/quickstart) |
| TikTok | `gd_l1villgoiiidt09ci` | `scrape.tiktok.profiles` | [TikTok](/products/scrapers/tiktok/quickstart) |
| YouTube | `gd_lk538t2k2p1k3oos71` | `scrape.youtube.videos` | [YouTube](/products/scrapers/youtube/quickstart) |
| Google | `gd_m8ebnr0q2qlklc02fz` | `search.google` | [Google](/products/scrapers/google/quickstart) |

The JavaScript SDK uses the same tree with `collect`-prefixed names, for example `scrape.amazon.collectProducts`. Full method lists: [Python SDK](/api-reference/SDK), [JavaScript SDK](/api-reference/SDK-JS).

Bright Data maintains thousands of pre-built scrapers covering popular sites. Browse the full library in the [Scrapers overview](/products/scrapers/overview), and see [async requests](/products/scrapers/scrapers-library/async-requests) for the complete dataset ID table.

## What if no pre-built scraper covers my site?

Build one with Bright Data Scraper Studio. Pass a target URL and one sentence describing the data you want, and the AI Agent generates the output schema and writes the scraper code. Generation typically takes 5 to 15 minutes, and up to 25 minutes for complex targets.

The [Scraper Studio quickstart](/products/scraper-studio/quickstart) walks through the whole path, from `bdata scraper create` to triggering the published scraper from your own code. Prefer no code? Build the same scraper from your dashboard with the [AI Agent](/products/scraper-studio/ai-agent).

## How do I scale past one URL?

The request above is synchronous: one call, one response, up to 20 URLs. For production volumes, switch to the asynchronous `/trigger` endpoint, which has no URL ceiling other than 1 GB of input per job and returns a `snapshot_id` instead of records.

Rather than polling for that `snapshot_id`, have Bright Data push results to a webhook, Amazon S3, Google Cloud Storage, Azure or Snowflake when the job completes. See [async requests](/products/scrapers/scrapers-library/async-requests) for the full trigger, poll and download workflow, and [delivery options](/products/scrapers/scrapers-library/data-delivery) for the destinations.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Which should I use, Scraper API or Scraper Studio?">
    Use the Scraper API when a pre-built scraper already covers your target site, which is the case for most popular sites. Use Scraper Studio when none does, or when you want to own the scraper logic. Both return the same structured output and run on the same infrastructure. For the full comparison, see [Choose a product](/product-selector).
  </Accordion>

  <Accordion title="Why did I get a 401 or 403?">
    A `401` means the API key was rejected: the response body names which case. A `403` is different, the key is valid but lacks permission for that product or zone. See the [authentication guide](/api-reference/authentication).
  </Accordion>

  <Accordion title="My request timed out. What happened?">
    Synchronous requests have a 1-minute timeout. If a request exceeds it, the Bright Data Scraper API automatically switches to async and returns a `snapshot_id` instead of records. Use that ID with the [async workflow](/products/scrapers/scrapers-library/async-requests).
  </Accordion>

  <Accordion title="Can I get CSV instead of JSON?">
    Yes. Set the `format` query parameter to `csv`. With no `format`, the response is NDJSON, one record per line; set `format=json` for a JSON array.
  </Accordion>

  <Accordion title="Does this cost credits?">
    Yes, and new accounts get 5,000 free credits every month with no credit card, drawn from a single shared pool across eligible products. See the [free tier](/general/account/billing-and-pricing/free-tier).
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup>
  <Card title="For your coding agent" icon="robot" href="/quickstart-coding-agent">
    Set up Claude Code, Cursor or Codex with skills, the MCP server and llms.txt.
  </Card>

  <Card title="Choose a product" icon="compass" href="/product-selector">
    Scraping search engines, unlocking pages or running a browser? Match your goal to the right product.
  </Card>

  <Card title="Scale to production" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    Batch unlimited URLs, monitor snapshots and deliver results to your warehouse.
  </Card>
</CardGroup>


# Bright Data for your coding agent
Source: https://docs.brightdata.com/quickstart-coding-agent

Get structured data from the Bright Data Scraper API inside Claude Code, Cursor or Codex, in three commands. Then llms.txt, agent skills, the CLI and MCP.

Get structured data out of the Bright Data Scraper API from inside Claude Code, Cursor or Codex. Paste this in:

<Prompt description="Read https://docs.brightdata.com/llms.txt, then use the Bright Data Scraper API to scrape https://www.amazon.com/dp/B0FQFB8FMG and show me the title, price and rating." icon="sparkles">
  Read [https://docs.brightdata.com/llms.txt](https://docs.brightdata.com/llms.txt), then use the Bright Data Scraper API to scrape [https://www.amazon.com/dp/B0FQFB8FMG](https://www.amazon.com/dp/B0FQFB8FMG) and show me the title, price and rating.
</Prompt>

The agent reads the documentation index, installs what it needs and returns the record. To run the same thing yourself, or to see what it installed, start below.

## Get your first Scraper API result

Two commands to structured JSON from the Bright Data Scraper API. Same result as the [human quickstart](/quickstart), driven from the terminal.

<Steps>
  <Step title="Install and authenticate">
    ```bash theme={null}
    npm i -g @brightdata/cli
    bdata login
    ```

    `bdata login` opens a browser to authorize, so you never paste a key. Use `bdata login --device` over SSH or in any headless environment.

    If a global install is blocked on your machine, run each command through `npx` instead:

    ```bash theme={null}
    npx -p @brightdata/cli bdata login
    ```

    Keep the `-p @brightdata/cli` part. `npx` does not put `bdata` on your PATH, so every command needs the prefix, and the short `npx bdata` resolves to an unrelated package on npm rather than the Bright Data CLI.
  </Step>

  <Step title="Scrape a page">
    ```bash theme={null}
    bdata pipelines amazon_product "https://www.amazon.com/dp/B0FQFB8FMG" --pretty
    ```

    You should see the product JSON printed. Processing time varies with target-site conditions and scraper workload. A synchronous request waits up to 1 minute, then returns a `snapshot_id` and collection continues asynchronously.

    ```json theme={null}
    [
      {
        "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
        "asin": "B0FQFB8FMG",
        "brand": "Apple",
        "final_price": 199.99,
        "currency": "USD",
        "rating": 4.4,
        "reviews_count": 14411
      }
    ]
    ```

    The full record carries 67 fields. Run `bdata pipelines list` to see every available pipeline type.
  </Step>
</Steps>

Install the [agent skills](#how-do-i-install-bright-data-skills) and the agent reaches for these commands itself:

```bash theme={null}
npx skills add brightdata/skills
```

Then ask in plain language instead of typing the CLI:

```text Prompt theme={null}
Scrape https://www.amazon.com/dp/B0FQFB8FMG and tell me the price and rating.
```

## How do I scrape a different site?

Change the pipeline type. The CLI names each one after what it collects, so there is no `dataset_id` to look up.

```bash theme={null}
bdata pipelines linkedin_person_profile "https://www.linkedin.com/in/satyanadella" --pretty
```

| Site | Pipeline type |
| :- | :- |
| Amazon | `amazon_product`, `amazon_product_reviews`, `amazon_product_search` |
| LinkedIn | `linkedin_person_profile`, `linkedin_company_profile`, `linkedin_job_listings` |
| Instagram | `instagram_profiles`, `instagram_posts`, `instagram_reels` |
| TikTok | `tiktok_profiles`, `tiktok_posts`, `tiktok_shop` |
| YouTube | `youtube_videos`, `youtube_profiles`, `youtube_comments` |
| Walmart, eBay, Etsy, Best Buy | `walmart_product`, `ebay_product`, `etsy_products`, `bestbuy_products` |

For the current set:

```bash theme={null}
bdata pipelines list
```

Search engines are not pipelines. Use `bdata search` for Google, Bing and Yandex results, and `bdata scrape` for any page that has no pre-built scraper.

With the skills installed you do not pick the type yourself. Ask for the data and the agent matches the site to a pipeline:

```text Prompt theme={null}
Get me the follower count and recent posts for the Bright Data LinkedIn company page.
```

## What the agent sets up

| What it gives the agent | How | Setup |
| :- | :- | :- |
| Knows which Bright Data product to use, and how the APIs work | [llms.txt](#how-do-i-give-my-agent-the-full-documentation) | One line in a prompt |
| Runs search, scraping and structured extraction through the Bright Data CLI | [Agent skills](#how-do-i-install-bright-data-skills) | One command |
| Calls 60+ web tools live from inside the agent's tool loop | [Bright Data MCP](#how-do-i-connect-the-bright-data-mcp-server) | One command |
| Drives scrapers, zones and a remote browser from the terminal | [Bright Data CLI](/products/cli/overview) | One command |

These are not alternatives. See [how they fit together](#should-i-use-skills-mcp-or-both).

## Prerequisites

* A Bright Data account. A human can [sign up in a browser](https://brightdata.com/?hs_signup=1\&utm_source=docs), or the agent can create the account itself with the [agent registration protocol](https://brightdata.com/auth.md). New accounts get **5,000 free credits every month**, no credit card required
* A coding agent with terminal access: Claude Code, Cursor, Codex or any of the 40+ agents the skills ecosystem supports

## How do I give my agent the full documentation?

Point the agent at `llms.txt`, a structured index of every Bright Data documentation page following the [llms.txt standard](https://llmstxt.org). Every entry links to the `.md` version of the page, so the agent reads clean markdown with no HTML to parse.

```text Prompt theme={null}
Read https://docs.brightdata.com/llms.txt to understand the available Bright Data
products, then help me choose the right API for scraping Amazon product pages.
```

To make it permanent instead of per-prompt, save the index into your project so every session has it:

<CodeGroup>
  ```bash Claude Code theme={null}
  mkdir -p .claude && curl -o .claude/brightdata-docs.txt https://docs.brightdata.com/llms.txt
  ```

  ```bash Cursor theme={null}
  mkdir -p .cursor/rules && curl -o .cursor/rules/brightdata.md https://docs.brightdata.com/llms.txt
  ```

  ```bash Codex theme={null}
  curl -s https://docs.brightdata.com/llms.txt >> AGENTS.md
  ```
</CodeGroup>

Two files are published. `llms.txt` is the index and is the right default for a live agent session. `llms-full.txt` is the entire documentation in one file, meant for RAG pipelines and long-context injection rather than interactive use.

<Tip>
  The token-efficient pattern for agents: load `llms.txt` to see what exists, identify the relevant page, then fetch that page's `.md` URL for the detail. Append `.md` to any documentation URL to get the markdown, for example [`/products/mcp-server/overview.md`](/products/mcp-server/overview.md).
</Tip>

Prefer to have the agent query the docs live instead of loading a file? The [Docs MCP](/general/docs-mcp) exposes this documentation as searchable MCP resources, so the agent retrieves pages inside its own reasoning loop. It is a separate server from the Bright Data MCP below: the Docs MCP reads documentation, the Bright Data MCP reaches the live web.

Building a retrieval pipeline rather than a live agent session? Use `llms-full.txt`, which is the complete documentation as one markdown file:

```python theme={null}
import httpx
from langchain.text_splitter import MarkdownTextSplitter

docs = httpx.get("https://docs.brightdata.com/llms-full.txt").text
chunks = MarkdownTextSplitter(chunk_size=1000, chunk_overlap=100).create_documents([docs])
vectorstore.add_documents(chunks)
```

<Warning>
  `llms-full.txt` is large. For a live agent session, load `llms.txt` first and fetch individual `.md` pages on demand instead. It uses far fewer tokens.
</Warning>

## How do I install Bright Data skills?

Skills are reusable instruction sets defined in `SKILL.md` files that give your agent embedded Bright Data API knowledge and the commands to act on it through the Bright Data CLI. One command installs them and auto-detects which agents you have:

```bash theme={null}
npx skills add brightdata/skills
```

The skills call `bdata` directly, so the global install from [step 1](#get-your-first-scraper-api-result) is what makes them work. Without `bdata` on your PATH the skills' `command -v bdata` check fails.

Confirm the install landed:

```bash theme={null}
npx skills list
```

Each installed skill prints on its own line with its path and the agents it was linked into:

```text theme={null}
Project Skills

search ./.agents/skills/search Agents: Codex, Cursor
```

An empty list means the install did not take. Re-run `npx skills add brightdata/skills` and answer the scope prompt.

The bundle covers search, scraping, structured extraction, the SDKs, proxies, Scraper Studio and MCP orchestration. The ones you will reach for first:

| Skill | What it gives the agent |
| :- | :- |
| Search | Google, Bing and Yandex results as structured JSON. Runs on the SERP API |
| Scrape | Any webpage as clean markdown, with CAPTCHA solving and JavaScript rendering. Runs on the Web Unlocker API |
| Data Feeds | Structured extraction from Amazon, LinkedIn, Instagram, TikTok, YouTube and more |
| Scraper Studio | Builds a custom scraper for a site with no pre-built one |
| Bright Data MCP | Orchestrates the MCP tools in one integration |
| Best Practices | API selection guide, auth patterns and code examples in Python and JavaScript |

Run `npx skills add brightdata/skills --list` for the current set.

Once installed, the agent invokes them directly:

```bash theme={null}
bdata search "your query" --engine google --json --pretty
bdata scrape "https://example.com"
bdata pipelines amazon_product "https://www.amazon.com/dp/B0FQFB8FMG" --pretty
```

### Install into a specific agent

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    npx skills add brightdata/skills -a claude-code
    ```

    Skills land in `.claude/skills/` in your project, or `~/.claude/skills/` with `-g`. Claude Code discovers them on the next session. Verify with `npx skills list -a claude-code`.
  </Tab>

  <Tab title="Cursor">
    ```bash theme={null}
    npx skills add brightdata/skills -a cursor
    ```

    Skills land in `.cursor/skills/`. Cursor Composer picks them up automatically. Reference one in chat: `Use the scrape skill to extract content from https://example.com`.
  </Tab>

  <Tab title="Codex">
    ```bash theme={null}
    npx skills add brightdata/skills -a codex
    ```

    Skills land in `.agents/skills/`, the shared location Codex reads alongside `AGENTS.md`.
  </Tab>

  <Tab title="Every agent at once">
    ```bash theme={null}
    npx skills add brightdata/skills --all

    # Non-interactive, for CI
    npx skills add brightdata/skills --all -y
    ```

    The CLI auto-detects every agent you have installed and distributes the files to each.
  </Tab>

  <Tab title="Any other agent">
    Each skill is plain markdown, so you can inject it into any system prompt or RAG index:

    ```bash theme={null}
    git clone https://github.com/brightdata/skills.git
    cat skills/bright-data-best-practices/SKILL.md
    ```
  </Tab>
</Tabs>

Add `-g` to any command to install globally across projects.

### Manage installed skills

```bash theme={null}
npx skills list      # what is installed
npx skills check     # are there updates
npx skills update    # update to latest
npx skills remove brightdata/skills
```

Skills are part of the [open agent skills ecosystem](https://github.com/vercel-labs/skills) and work across 40+ coding agents. The source, including each `SKILL.md` and its runnable scripts, lives at [github.com/brightdata/skills](https://github.com/brightdata/skills). New skills are added regularly, so star the repository to follow along.

## How do I connect the Bright Data MCP server?

The Bright Data MCP server gives your agent live web access through 60+ tools for search, scraping, structured extraction and browser automation. It runs on the Web Unlocker API, so every request handles proxy rotation, anti-bot challenges and CAPTCHA solving.

Each snippet below puts an API key in an agent config file. Those files are commonly committed to version control, so treat the key as you would any other secret. To avoid a long-lived key in a file entirely, the server also accepts [OAuth 2.1](/products/mcp-server/remote/oauth), where the user signs in through a browser.

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --transport sse brightdata "https://mcp.brightdata.com/sse?token=YOUR_API_KEY"
  ```

  ```json Cursor theme={null}
  {
    "mcpServers": {
      "brightdata-mcp": {
        "command": "npx",
        "args": ["-y", "@brightdata/mcp"],
        "env": {
          "API_TOKEN": "YOUR_API_KEY"
        }
      }
    }
  }
  ```

  ```bash Codex CLI theme={null}
  codex mcp add brightdata --env API_TOKEN=YOUR_API_KEY -- npx -y @brightdata/mcp
  ```
</CodeGroup>

Then try it with a prompt like `Extract the Bright Data overview section from LinkedIn`.

<Tip>
  **Control token usage.** Load only the tools you need with [tool groups](/products/mcp-server/tools), for example `groups=ecommerce,social`, or name individual tools such as `tools=web_data_amazon_product`. A smaller tool list means a smaller context and more usable requests.
</Tip>

Two versions exist. The [remote server](/products/mcp-server/remote/quickstart) is fully managed and needs no setup. The [local server](/products/mcp-server/local/quickstart) is self-hosted for on-premise or private cloud. See the [MCP server overview](/products/mcp-server/overview) for both, and the [integration guides](/products/mcp-server/integrations/overview) for other clients.

## Should I use skills, MCP or both?

Skills and the CLI are the default pair. Skills carry the knowledge: which Bright Data product fits a task, how to authenticate, how to handle pagination and errors. The CLI executes. Neither costs a live request until the agent runs a command.

The MCP server matters when an agent has no terminal. It exposes the same capabilities as tools inside the agent's own loop, which is the only route for a hosted assistant or a client that cannot shell out.

This page lists terminal access as a prerequisite, so MCP is optional here. Add it when you want live web access inside the tool loop rather than through a shell.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can an AI agent create a Bright Data account for a user?">
    Yes. An agent creates the account itself through the [agent registration protocol](https://brightdata.com/auth.md), with no password and no signup form. The agent posts the user's email address to the registration endpoint, the user reads back the 6-character code Bright Data emails them, and the claim endpoint returns an API key. Disposable addresses and plus-aliased addresses such as `user+tag@example.com` are rejected, so use the user's real mailbox.
  </Accordion>

  <Accordion title="What products does an agent-created account include?">
    An agent-created account gets the standard **5,000 free credits every month**, shared across the Web Unlocker API, SERP API, Scraper API, Scraper Studio and, since September 1, 2026, the Browser API. See the [free tier](/general/account/billing-and-pricing/free-tier) for what each product costs against that pool. Registration also grants a one-time **\$2 trial credit valid seven days** and pre-creates three zones, `agent_serp`, `agent_unlocker` and `agent_browser_api`, so the first SERP API, Web Unlocker API or Browser API call runs with no setup. The API key it issues is read-only for billing and cannot create or edit zones.
  </Accordion>

  <Accordion title="Can an agent-created account use Residential proxies?">
    No. Residential proxies require a KYC-verified business account, and the agent registration protocol provisions non-KYC products only. The Bright Data agent registration protocol states it directly: "Residential proxies always require a KYC-verified business account (via the Control Panel)." A human has to verify the account in the [Control Panel](https://brightdata.com/cp) before Residential proxies work. Datacenter and ISP proxies sit outside the protocol too, which provisions no proxy networks at all.
  </Accordion>

  <Accordion title="Do I need to install anything globally?">
    No. `npx skills add brightdata/skills` and `npx -y @brightdata/mcp` both fetch on demand, so there is no global dependency to maintain. The Bright Data CLI can also run through npx: `npx -p @brightdata/cli brightdata --version`.
  </Accordion>

  <Accordion title="Does the MCP server use the same free tier?">
    Yes. The MCP server draws from the same account-level [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month, from a single shared pool, because it runs on the Web Unlocker API. On team accounts that pool is shared across all users in the account.
  </Accordion>

  <Accordion title="Does the MCP server need a username?">
    No. Both the remote and local MCP servers authenticate with your API key only. Usernames in the format `brd-customer-{customer_id}-zone-{zone_name}` are for native proxy access, not MCP. If a third-party tool asks for a username, leave it empty.
  </Accordion>

  <Accordion title="Which agents are supported?">
    Skills work across the 40+ agents in the [open agent skills ecosystem](https://github.com/vercel-labs/skills), including Claude Code, Cursor and Codex. The MCP server works with any MCP-compatible client. `llms.txt` works with anything that can fetch a URL.
  </Accordion>

  <Accordion title="Can my agent build a scraper for a site with no pre-built scraper?">
    Yes. Give it a target URL and a sentence describing the fields you want, and the Bright Data CLI generates the scraper through Scraper Studio. Copy-pasteable prompts for the full build, run and self-heal loop are in [Scraper Studio coding agent prompts](/products/scraper-studio/coding-agent-prompts).
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup>
  <Card title="Choose a product" icon="compass" href="/product-selector">
    Match your target site to the right Bright Data product, then go straight to its first request.
  </Card>

  <Card title="Build a scraper with prompts" icon="messages" href="/products/scraper-studio/coding-agent-prompts">
    Copy-pasteable Claude Code, Cursor and Codex prompts that build, run and self-heal a scraper.
  </Card>

  <Card title="Bright Data CLI" icon="terminal" href="/products/cli/overview">
    Scrape, search, manage zones and control a remote browser from the terminal.
  </Card>
</CardGroup>


# Dataset API filter syntax
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-syntax

Reference for the Bright Data Dataset API filter object: operators, filter groups, up to 3 levels of nesting and CSV/JSON file references.

The `filter` object is shared by both the Search and Filter endpoints of the Bright Data Marketplace Dataset API: the same schema, the same operators and the same nesting rules.

<Tip>
  Use [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata) to confirm field names and types before building a filter.
</Tip>

## What are the three filter shapes?

A filter is one of three shapes: a single field filter, a filter group that combines several filters, or a null check.

### Single field filter

Match one field against one value with an operator:

```json theme={null}
{ "name": "name", "operator": "=", "value": "John" }
```

### Filter group

Combine multiple filters with `and` or `or`. Filter groups support a maximum nesting depth of 3 levels:

```json theme={null}
{
  "operator": "and",
  "filters": [
    { "name": "reviews_count", "operator": ">", "value": 200 },
    { "name": "rating", "operator": ">", "value": 4.5 }
  ]
}
```

### Null check

Use `is_null` or `is_not_null` to match on the presence of a value. These operators take no `value`:

```json theme={null}
{ "name": "reviews_count", "operator": "is_not_null" }
```

## Which operators are available?

The following operators can be used in a field filter.

| Operator | Field types | What it does |
| - | - | - |
| `=` | Any | Equal to. |
| `!=` | Any | Not equal to. |
| `\<` | Number, Date | Lower than. |
| `\<=` | Number, Date | Lower than or equal. |
| `>` | Number, Date | Greater than. |
| `>=` | Number, Date | Greater than or equal. |
| `in` | Any | Field value equals any value in the provided list. |
| `not_in` | Any | Field value does not equal any value in the list. |
| `includes` | Array, Text | Field value contains the filter value. If the filter value is an array, it matches records where the field contains at least one value from the array. |
| `not_includes` | Array, Text | Field value does not contain the filter value(s). |
| `array_includes` | Array | Exact match exists in the array. |
| `not_array_includes` | Array | Exact match does not exist in the array. |
| `is_null` | Any | Field value is null. No value needed. |
| `is_not_null` | Any | Field value is not null. No value needed. |

## Which operators read CSV or JSON files?

These file-reference operators work only on the [Filter endpoint](/api-reference/marketplace-dataset-api/filter-dataset) in multipart mode. Pass a filename as the value to filter against thousands of values stored in a CSV or JSON file.

| Operator | Field types | Description |
| - | - | - |
| `in` | Any | Field value equals any value in the file. |
| `not_in` | Any | Field value does not equal any value in the file. |
| `includes` | Array, Text | Field value contains any value in the file. |
| `not_includes` | Array, Text | Field value does not contain any value in the file. |
| `array_includes` | Array | Any value in the file exists in the field value. |
| `not_array_includes` | Array | No values in the file exist in the field value. |

File references are not supported by the Search endpoint. Elasticsearch cannot read external files at query time.

## How do I match within a single nested object?

For datasets where a field is an array of objects, set `combine_nested_fields: true` on a filter group so that all filters in the group must match within a single object, not across different objects in the array:

```json theme={null}
{
  "operator": "and",
  "combine_nested_fields": true,
  "filters": [
    { "name": "experience.title", "operator": "includes", "value": "engineer" },
    { "name": "experience.company", "operator": "=", "value": "Bright Data" }
  ]
}
```

Without `combine_nested_fields`, the two conditions could match in different objects inside the `experience` array.

## Tips

* Use [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata) to confirm field names and types before building a filter.
* Keep nesting shallow when possible. The maximum depth is 3 levels.
* On the Search endpoint, prefer `includes` over `=` on free-text fields, because Elasticsearch tokenizes them.
* On the Filter endpoint, file references work only with the operators listed above.

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Search dataset (sync)](/api-reference/marketplace-dataset-api/search-dataset)
* [Filter dataset (async, file uploads)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Dataset API: search and filter
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/overview

Query Bright Data Marketplace datasets with two endpoints: Search for sub-second lookups and Filter for bulk async jobs. Shared filter syntax, $2.5 CPM.

The Bright Data Marketplace Dataset API gives you two endpoints to pull records from 250+ Marketplace datasets: **Search** for real-time lookups and **Filter** for bulk asynchronous jobs. Both endpoints share one filter schema, one authentication method and the same \$2.5 CPM pricing.

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## What are the two Dataset API endpoints?

The Marketplace Dataset API exposes two ways to pull records, depending on the job:

* **Search (sync)** is Elasticsearch-powered and returns records inline in sub-second responses. Use Search for real-time lookups, lead enrichment and sampling.
* **Filter (async)** is snapshot-based and supports CSV/JSON file uploads and large payloads. Use Filter for bulk exports and value-list filtering.

<CardGroup>
  <Card title="Search dataset (sync)" href="/api-reference/marketplace-dataset-api/search-dataset" icon="bolt">
    Elasticsearch query, results inline, sub-second latency. Up to 1,000 records per call.
  </Card>

  <Card title="Filter dataset (async)" href="/api-reference/marketplace-dataset-api/filter-dataset" icon="layer-group">
    Snapshot-based job, CSV/JSON uploads, payloads up to 200 MiB. All 250+ datasets.
  </Card>
</CardGroup>

## Which endpoint should I use?

Use Search for low-latency, single-call lookups and Filter for bulk or file-driven jobs.

| Need | Use |
| - | - |
| Real-time lookup, up to 1,000 records, sub-second latency | Search |
| Lead enrichment on a single record | Search |
| Quick sample of a dataset before buying | Search with `"sort": "random"` |
| Bulk export or large pulls | Filter |
| Filter by a list of 100k+ values from CSV/JSON | Filter |
| Dataset not yet supported by Search | Filter |

## How do the two endpoints compare?

The Search and Filter endpoints accept the same filter object but differ in engine, latency and dataset coverage.

| | Search | Filter |
| - | - | - |
| Path | `POST /datasets/search/:dataset_id` | `POST /datasets/filter` |
| Engine | Elasticsearch | Snapshot-based |
| Mode | Sync (results inline) | Async (returns `snapshot_id`) |
| Latency | Sub-second | Up to 5 minutes per job |
| Datasets | 3 LinkedIn datasets (alpha) | All 250+ Marketplace datasets |
| Max payload | Single request body | Up to 200 MiB (multipart) |
| File uploads (CSV/JSON) | Not supported | Supported |
| Pagination | `search_after` cursor | `records_limit` on snapshot |
| Returns | `hits`, `total_hits`, `took` | `snapshot_id` (download separately) |
| Pricing | \$2.5 CPM | \$2.5 CPM |

Results between the two engines can differ. Elasticsearch tokenizes text differently from the snapshot engine.

## How do I authenticate?

Both endpoints use Bearer token authentication. Pass your API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Get your key from [account settings](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).

## How much does the Dataset API cost?

Both endpoints cost \$2.5 CPM (per 1,000 records returned), the same rate as the Marketplace. There is no premium for real-time Search, and there is no charge when a filter returns 0 records.

| Item | Price |
| - | - |
| Search and Filter | \$2.5 CPM (per 1,000 records returned) |
| Zero-match queries | Free (no charge when the filter returns 0 records) |
| Subscriptions | Monthly commit, lower effective CPM on overage |
| Enterprise | Custom SLAs, dedicated capacity |

## Where is the filter syntax documented?

Both endpoints accept the same `filter` object, with the same operators and nesting rules. The [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax) documents the operator list, filter groups, up to three levels of nesting and CSV/JSON file references.

## Related

* [Search dataset (sync)](/api-reference/marketplace-dataset-api/search-dataset)
* [Filter dataset (async, file uploads)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)
* [Get dataset list](/api-reference/marketplace-dataset-api/get-dataset-list)
* To build or refresh a dataset before querying, see [Request a collection](/api-reference/marketplace-api/request-a-collection).


# Search dataset (sync, Elasticsearch)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/search-dataset

Run a real-time, Elasticsearch-powered query against a Bright Data Marketplace dataset. Sub-second responses, up to 1,000 records per call.

The Search endpoint of the Bright Data Marketplace Dataset API runs a real-time, Elasticsearch-powered query against a Marketplace dataset: send a filter, get records back in the response with sub-second latency.

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## When should I use Search?

Use Search when you need a small number of records back in a single, low-latency call:

* Real-time lookups, such as enriching a lead the moment it hits the CRM.
* Feeding live records into AI agents or LLM apps.
* Sales prospecting by name, title, company or location.
* Sampling a dataset before buying, with `"sort": "random"`.
* Any workload that needs up to 1,000 records back in one call.

If you need file uploads, bulk exports or a dataset that is not in the supported list, use [Filter](/api-reference/marketplace-dataset-api/filter-dataset) instead.

## Run your first Search query

Send a `POST` request to `/datasets/search/:dataset_id` with a `filter` object. The example below searches the LinkedIn people profiles dataset for records whose `name` includes `Egor`:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/search/gd_l1viktl72bvl7bjuj0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "filter": {
      "name": "name",
      "operator": "includes",
      "value": "Egor"
    }
  }'
```

Search returns the records inline. There is no polling and no snapshot IDs:

```json theme={null}
{
  "hits": [ /* records */ ],
  "total_hits": 579859,
  "took": 142
}
```

## Which datasets does Search support?

Search is in alpha and currently supports three LinkedIn datasets. For any other dataset, use [Filter](/api-reference/marketplace-dataset-api/filter-dataset).

| Dataset | `dataset_id` |
| - | - |
| LinkedIn people profiles | `gd_l1viktl72bvl7bjuj0` |
| LinkedIn people profiles, contact-enriched | `gd_me5ppxjr2ge6icjuh0` |
| LinkedIn company information | `gd_l1vikfnt1wgvvqz95w` |

<Note>
  Amazon datasets are next. More datasets are rolling out toward general availability in Q3 2026. Passing an unsupported `dataset_id` to Search returns a `404`.
</Note>

## How do I authenticate?

Search uses Bearer token authentication. Pass your API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Get your key from [account settings](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).

## What parameters does Search accept?

| Name | Type | Default | Required | Description |
| - | - | - | - | - |
| `filter` | object | - | yes | Filter expression. Cannot be empty. See the [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax). |
| `size` | number | 100 | no | Number of records to return. Search is best for up to 1,000 records per call. |
| `sort` | string or array | - | no | `default`, `random`, or a custom sort such as `[{"timestamp":"asc"}]`. |
| `search_after` | array | - | no | Pagination cursor. Pass the `search_after` value from the previous response. |

## What does Search return?

| Name | Type | Description |
| - | - | - |
| `hits` | array | The matched records. |
| `total_hits` | number | Total records matching your filter. |
| `took` | number | Server time in milliseconds. |
| `search_after` | array | Cursor for the next page. Returned only when `sort` is set. |

## How do I sort and paginate?

Set `sort` to control ordering, and use the returned `search_after` cursor to page through results.

### Sample a dataset with random sort

Use `"sort": "random"` to pull a representative sample, for example before buying a dataset:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/search/gd_l1viktl72bvl7bjuj0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "size": 10,
    "sort": "random",
    "filter": { "name": "name", "operator": "includes", "value": "Egor" }
  }'
```

### Page through results with search\_after

Set `"sort": "default"` to get a `search_after` cursor in the response. Request the first page:

```json theme={null}
{
  "size": 10,
  "sort": "default",
  "filter": { "name": "name", "operator": "includes", "value": "Egor" }
}
```

Pass the returned `search_after` array back to fetch the next page:

```json theme={null}
{
  "size": 10,
  "sort": "default",
  "search_after": [ /* value from previous response */ ],
  "filter": { "name": "name", "operator": "includes", "value": "Egor" }
}
```

### Sort by a custom field

Pass an array of field-to-direction objects to sort by a specific field:

```json theme={null}
{ "sort": [{ "timestamp": "asc" }] }
```

## How much does Search cost?

Search costs \$2.5 CPM (per 1,000 records returned), the same rate as the Marketplace. There is no charge when the filter returns 0 records.

## What errors can Search return?

| Status | Meaning | What to do |
| - | - | - |
| `400` | Bad filter or params | Check field names with [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata). |
| `401` | Bad or missing API key | Check your Bearer token. |
| `402` | Not enough funds | Top up your balance or reduce `size`. |
| `404` | Unknown `dataset_id` | Confirm the dataset is in the supported list above. |
| `422` | Filter matched 0 records | Loosen your filter or check field values. |
| `429` | Rate limit hit | Back off and retry. |

## FAQ

### Does Search support CSV or JSON file uploads?

No. Elasticsearch cannot read external files at query time. To filter against thousands of values in a CSV or JSON file, use the [Filter endpoint](/api-reference/marketplace-dataset-api/filter-dataset).

### How many records can Search return in one call?

Search is best for up to 1,000 records per call. For larger pulls, use [Filter](/api-reference/marketplace-dataset-api/filter-dataset), which is snapshot-based and supports bulk exports.

### Why do Search and Filter return slightly different results?

The two endpoints use different engines. Elasticsearch tokenizes text differently from the snapshot engine, so free-text matches can differ. On free-text fields, prefer the `includes` operator over `=`.

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Filter dataset (async, file uploads)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Troubleshooting
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/troubleshooting

Troubleshoot 4xx and 5xx errors from the Bright Data Web Unlocker API, SERP API, Web Scraper API, Marketplace Dataset API and Web Scraper IDE with fixes.

## Proxy networks troubleshooting

Error codes and description for proxy networks can be found [here](/proxy-networks/errorCatalog)

## Datasets API errors

### 200 ok (with error/status messages)

While technically a successful HTTP status, these responses carry messages indicating an ongoing process or a specific failure within the operation, requiring developer attention.

| Message | Associated endpoints | Cause | Suggested action |
| :- | :- | :- | :- |
| `{status: "STATUS", message: "Snapshot is not ready yet, try again in 10s"}` | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is still being built or processed. | This is an interim status. Poll the endpoint again after the suggested delay (e.g., `10s`). |
| `{status: "building", message: "Snapshot is building, try again in 10s"}` | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is actively being built. | Poll the endpoint again after the suggested delay. |
| `{status: "failed", error_message: "ERROR_MESSAGE"}` | `GET /datasets/v3/progress/:snapshot_id` | A collection or snapshot operation has failed. | Check the specific `ERROR_MESSAGE` for details. Review your collection setup and inputs. |
| `Something went wrong. Bright Data is looking into it.` | `GET /datasets/v3/progress/:snapshot_id` | An internal system error occurred during monitoring. | This indicates a problem on Bright Data's end. No immediate action is required from your side, but you can contact support if it persists. |
| `Account is suspended` | `GET /datasets/v3/progress/:snapshot_id` | Your Bright Data account has been suspended, often due to a negative balance. | Top up your account balance. If suspension extends beyond 24 hours, previously allocated static IPs may be released. Go to your Bright Data Zones page for updated IPs. |
| `Account is new, please activate it in account settings. URL` | `GET /datasets/v3/progress/:snapshot_id` | Your newly created account requires activation. | Log in to your Bright Data account settings and complete the activation process. |
| `No data found in discovery` | `GET /datasets/v3/progress/:snapshot_id` | The discovery phase of your collection did not yield any data. | Review your discovery configuration and target settings. |
| `Snapshot is empty` | `GET /datasets/v3/progress/:snapshot_id` | The completed snapshot contains no data. | Check your collection process and dataset configuration to ensure data is being collected. |
| `Failed to deliver snapshot` | `GET /datasets/v3/progress/:snapshot_id` | An error occurred during the process of delivering the collected data to storage. | Review your delivery options and try again. If the issue persists, contact support. |
| `Failed to download response` | `GET /datasets/v3/progress/:snapshot_id` | An error occurred while attempting to download the response. | This could be a transient network issue or a problem on Bright Data's side. Retry the request. |
| `Failed to trigger collector` | `GET /datasets/v3/progress/:snapshot_id` | An internal error prevented the collection from being triggered. | Retry the request. If the issue persists, contact support. |
| `Internal server error` | `GET /datasets/v3/progress/:snapshot_id` | A general internal server error. | Retry the request. If the issue persists, contact support. |
| `Input validation failed: DETAILS` | `GET /datasets/v3/progress/:snapshot_id` | There was an internal validation error with the input. | Review your input against the API documentation. If it appears correct, contact support. |

### 202 accepted

**Cause:** The request has been accepted for processing, but the operation is not yet complete. This is typically an interim status indicating that a resource is being prepared or built.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `{status: "STATUS", message: "Snapshot is not ready yet, try again in 10s"}` | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is still being built or processed. | This is an interim status. Poll the endpoint again after the suggested delay (e.g., `10s`). |
| `{status: "building", message: "Snapshot is building, try again in 10s"}` | `GET /datasets/v3/snapshot/:snapshot_id` | The snapshot is actively being built. | Poll the endpoint again after the suggested delay. |

### 400 bad request

**Cause:** Your request was invalid, malformed, or contained incorrect parameters. This is a common client-side error, indicating an issue with how the request was constructed.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `{validation_errors: [ERRORS]}` | Many Scrapers Library endpoints, `GET /datasets/v3/snapshots`, Marketplace Dataset API | General validation failure for request inputs; the ERRORS array will provide specific details. | Check the ERRORS array for specific validation issues and correct your request payload. |
| `dataset missing` | `POST /datasets/v3/trigger` | The required dataset ID or name is missing from the request. | Ensure the dataset identifier is included in your request. |
| `Invalid attachments` | `POST /datasets/v3/trigger` | The attachments provided are not valid. | Verify the format and content of your attachments. |
| `This dataset is not allowed for API` | `POST /datasets/v3/trigger` | The specified dataset cannot be triggered via API. | Confirm that the dataset is configured for API access. |
| `This dataset is not ready yet` | `POST /datasets/v3/trigger` | The dataset is still being prepared or is not in an active state. | Wait for the dataset to become ready before attempting to trigger a collection. |
| `No data to trigger` | `POST /datasets/v3/trigger` | The dataset has no inputs or configuration to initiate a collection. | Ensure your dataset has valid inputs defined. |
| `Should be at least LIMIT inputs` | `POST /datasets/v3/trigger` | The request does not meet the minimum number of required inputs. | Provide at least the specified `LIMIT` number of inputs. |
| `Snapshot is expired` | `GET /datasets/v3/snapshot/:snapshot_id`, `POST /datasets/v3/deliver/:snapshot_id` | The snapshot you are trying to access has passed its validity period. | Trigger a new collection to generate a fresh snapshot. |
| `Snapshot is empty` | `GET /datasets/v3/snapshot/:snapshot_id`, `POST /datasets/v3/deliver/:snapshot_id` | The collected snapshot contains no data. | Check your collection process and dataset configuration to ensure data is being collected. |
| `Snapshot is not ready` | `GET /datasets/v3/snapshot/:snapshot_id/parts`, `POST /datasets/v3/deliver/:snapshot_id` | The snapshot is still being processed or is not in a state to be downloaded or delivered. | Wait for the snapshot to complete processing. You can monitor its status via the "Monitor progress" endpoint. |
| `Snapshot input does not exist` | `GET /datasets/v3/snapshot/:snapshot_id/input` | The input file associated with the snapshot could not be found. | Verify the `snapshot_id` and ensure the input file was successfully generated. |
| `Snapshot is not running` | `POST /datasets/v3/snapshot/:snapshot_id/cancel` | You attempted to cancel a collection that is not currently active. | Check the status of the collection before attempting to cancel it. |
| `Deliver options are missing` | `POST /datasets/v3/deliver/:snapshot_id` | Required delivery configuration (e.g., destination details) was not provided. | Ensure all necessary delivery options are included in your request. |
| `Snapshot is too big for single file delivery` | `POST /datasets/v3/deliver/:snapshot_id` | The collected data exceeds the limit for a single file delivery. | Consider delivering the snapshot in multiple parts or adjusting your collection scope. |
| `Batch size should be at least MIN_BATCH_SIZE` | `POST /datasets/v3/deliver/:snapshot_id` | The specified batch size for delivery is below the minimum allowed. | Increase the `batch_size` to at least `MIN_BATCH_SIZE`. |
| `Type <span class="math-inline">\{init\_types\.compr\_update is no longer supported\. Use '</span>{init_types.discover_all}' instead.` | Marketplace Dataset API | The requested operation type is deprecated. | Update your request to use the recommended operation type, `${init_types.discover_all}`. |
| `Type ${init_types.update_existing} is no longer supported.` | Marketplace Dataset API | The requested operation type is no longer supported. | Use a supported operation type. |
| `Type ${init_types.discover_new} is no longer supported.` | Marketplace Dataset API | The requested operation type is no longer supported. | Use a supported operation type. |
| `Initiation reason is required.` | Marketplace Dataset API | The request is missing the required initiation reason. | Include the `initiation reason` in your request. |
| `This feature is not available.` | Marketplace Dataset API | The requested feature is not supported for the dataset. | Check the dataset's capabilities and adjust your request accordingly. |
| `This dataset was rejected.` | Marketplace Dataset API | The dataset was rejected and cannot be processed. | This dataset cannot be used. Contact Bright Data support for more information. |
| `This dataset is not ready.` | Marketplace Dataset API | The dataset is not in a state where it can be processed. | Wait for the dataset to become ready. |
| `This dataset does not support discovery. Supported types: ['${init_types.url_collection}']` | Marketplace Dataset API | The dataset does not support the requested discovery type. | Use a supported discovery type, such as `url_collection`. |
| `Incorrect discovery collector id.` | Marketplace Dataset API | The discovery collector ID provided in the request is invalid. | Verify the discovery collector ID. |
| `View not found.` | Marketplace Dataset API | The requested view is not available. | Check for correct view names and available views for the dataset. |
| `This dataset does not support collection.` | Marketplace Dataset API | The dataset does not support the requested collection operation. | Use an operation supported by the dataset. |
| `Batch size must be at least 1000.` | Marketplace Dataset API | The batch size specified in the request is below the minimum allowed value. | Increase the `batch_size` to at least 1000. |
| `{error: 'Snapshot failed'}` | Marketplace Dataset API | The snapshot operation failed. | Review the collection process for underlying issues. |
| `{error: 'Invalid snapshot type'}` | Marketplace Dataset API | The snapshot type provided in the request is invalid. | Use a valid snapshot type. |

### 401 unauthorized

**Cause:** Your request lacks valid authentication credentials for the API.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `Unauthorized` | Marketplace Dataset API | The API key or authentication credentials provided are invalid or missing. | Ensure your API key and authentication credentials are correct and properly included in the request. |

### 402 payment required

**Cause:** Your account balance is insufficient to process the requested API operation.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}` | Marketplace Dataset API | The user's account balance is insufficient to process the request. | Add funds to your Bright Data account or adjust your request parameters to reduce its cost. |

### 403 forbidden

**Cause:** You do not have permission to access the requested API resource, or your request is being blocked by a Bright Data policy.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `Access denied.` | Marketplace Dataset API | The user does not have the necessary permissions to access the resource. | Check your account permissions and ensure you have access to the requested resource. |
| `Cannot skip billing.` | Marketplace Dataset API | The user attempted to skip billing, which is not allowed. | Billing |

### 404 not found

**Cause:** The specific API resource you're trying to access does not exist in the system. You may encounter this error when trying to access a dataset, snapshot, delivery, or a general request that isn't found.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `dataset does not exist` | POST /datasets/v3/trigger, Marketplace Dataset API | The specified dataset ID or name could not be found. | Double-check the dataset identifier in your request. |
| `Snapshot does not exist` | Many scrapers endpoints, Marketplace Dataset API | The snapshot\_id provided does not correspond to an existing snapshot. | Verify the snapshot\_id. It might be incorrect, expired, or never existed. |
| `Delivery does not exist` | GET /datasets/v3/delivery/:delivery\_id | The delivery\_id provided could not be found. | Confirm the delivery\_id is correct. |
| `Request not found` | Scraper Studio API, Marketplace Dataset API | The specified request ID or other request details were not found in the Bright Data Marketplace Dataset API. | Verify your request details and ensure they are valid. |
| `Page not found` | Invalid URL, which suggests the URL might be broken or dead (specific to Web Unlocker API). | Verify the URL is correct and active. | |

### 422 unprocessable entity

**Cause:** The API request was well-formed but could not be processed due to semantic errors in the data provided.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `{error: 'Provided filter did not match any records'}` | Marketplace Dataset API | The filter provided in the request did not match any records in the dataset. | Adjust your filter criteria to match existing records in the dataset. |

### 429 too many requests

**Cause:** You have exceeded a rate limit or the maximum number of parallel jobs allowed for your account or dataset when using the API.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `You have too many running jobs for this dataset.` | `POST /datasets/v3/trigger` | You’ve hit the concurrency limit for collection jobs on this dataset. | Wait for some active jobs to complete. For large workloads, consider combining multiple inputs into a single collection request to reduce concurrency. |
| `{error: 'Maximum limit of ${max_parallel_jobs} jobs per dataset has been exceeded'}` | Marketplace Dataset API | You have exceeded the maximum allowed number of parallel jobs for the dataset. | Reduce the number of concurrent jobs, or wait for existing jobs to complete before initiating new ones. |
| | This error code implies a rate limit (rare) and auto-throttling by Bright Data (specific to Web Unlocker API). | Open a ticket or email [support@brightdata.com](mailto:support@brightdata.com) for assistance. | Confirm the delivery\_id is correct. |

### 500 internal server error

**Cause:** An unexpected error occurred on the Bright Data API server. These are server-side issues that are typically outside of your direct control.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `Internal server error` | Many Scrapers Library endpoints, `GET /datasets/v3/snapshots`, Marketplace Dataset API | A general, unhandled server-side error occurred. | This is typically a temporary issue. Retry your request after a short delay. If the problem persists, contact Bright Data support with the request details and any error messages. |
| `Internal error.` | Marketplace Dataset API | An unexpected error occurred on the server. | This is a server-side issue. Retry the request. If the problem persists, contact Bright Data support. |

### 502 bad gateway

**Cause:** The Bright Data API server received an invalid response from an upstream server.

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `Unexpected error. The server encountered an unexpected error while processing the request.` | Marketplace Dataset API | The server encountered an unexpected error while processing the request. | This is typically a temporary server-side issue. Retry the request. If it persists, contact support. |

### 503 service unavailable

| Message | Associated Endpoint(s) | Cause | Suggested Action |
| :- | :- | :- | :- |
| `Service Unavailable` | Specific to Web Unlocker API | Browser check failed or browser check wasn't completed. | This indicates a temporary service unavailability or a browser rendering issue. Retry the request. If it persists, contact support. |

## Dataset API errors

### 400 - Bad Request

Indicates that the request was invalid or cannot be processed.

| Error Message | Cause |
| :- | :- |
| `{validation_errors: ["filter.name is required"]}` | The request is missing a required filter parameter (e.g., `filter.name`). |
| `{validation_errors: ["Invalid input provided"]}` | The input provided in the request is not valid. |
| `Type ${init_types.compr_update} is no longer supported. Use '${init_types.discover_all}' instead.` | The requested operation type is deprecated. |
| `Type ${init_types.update_existing} is no longer supported.` | The requested operation type is no longer supported. |
| `Type ${init_types.discover_new} is no longer supported.` | The requested operation type is no longer supported. |
| `Initiation reason is required.` | The request is missing the required initiation reason. |
| `This feature is not available.` | The requested feature is not supported for the dataset. |
| `This dataset was rejected.` | The dataset was rejected and cannot be processed. |
| `This dataset is not ready.` | The dataset is not in a state where it can be processed. |
| `This dataset does not support discovery. Supported types: ['${init_types.url_collection}']` | The dataset does not support the requested discovery type. |
| `Incorrect discovery collector id.` | The discovery collector ID provided in the request is invalid. |
| `View not found.` | The requested view is not available. |
| `This dataset does not support collection.` | The dataset does not support the requested collection operation. |
| `Batch size must be at least 1000.` | The batch size specified in the request is below the minimum allowed value. |
| `{error: 'Snapshot failed'}` | The snapshot operation failed. |
| `{error: 'Snapshot not ready'}` | The snapshot is not ready for processing. |
| `{error: 'Invalid snapshot type'}` | The snapshot type provided in the request is invalid. |
| `{validation_errors: [e.message]}` | A validation error occurred, and the specific message is included in the response. |

***

### 401 - Unauthorized

Indicates that the user is not authorized to access the requested resource.

| Error Message | Cause |
| :- | :- |
| `Unauthorized` | The API key or authentication credentials provided are invalid or missing. |

***

### 402 - Payment Required

Indicates that the user does not have sufficient funds to process the request.

| Error Message | Cause |
| :- | :- |
| `{error: 'Your current balance is insufficient to process this data collection request. Please add funds to your account or adjust your request to continue. ($220 is missing)'}` | The user's account balance is insufficient to process the request. |

***

### 403 - Forbidden

Indicates that the user does not have permission to access the requested resource.

| Error Message | Cause |
| :- | :- |
| `Access denied.` | The user does not have the necessary permissions to access the resource. |
| `Cannot skip billing.` | The user attempted to skip billing, which is not allowed. |

***

### 404 - Not Found

Indicates that the requested resource could not be found.

| Error Message | Cause |
| :- | :- |
| `{error: 'Dataset not found'}` | The specified dataset ID does not exist. |
| `{error: 'Snapshot not found'}` | The specified snapshot ID does not exist. |
| `Dataset does not exist.` | The dataset referenced in the request does not exist. |
| `Request not found.` | The specified request ID does not exist. |

***

### 422 - Unprocessable Entity

Indicates that the request was well-formed but could not be processed due to semantic errors.

| Error Message | Cause |
| :- | :- |
| `{error: 'Provided filter did not match any records'}` | The filter provided in the request did not match any records in the dataset. |

***

### 429 - Too Many Requests

Indicates that the user has exceeded the rate limit or the maximum number of parallel jobs.

| Error Message | Cause |
| :- | :- |
| `{error: 'Maximum limit of ${max_parallel_jobs} jobs per dataset has been exceeded'}` | The user has exceeded the maximum allowed number of parallel jobs for the dataset. |

***

### 500 - Internal Server Error

Indicates that an unexpected error occurred on the server.

| Error Message | Cause |
| :- | :- |
| `Internal error.` | An unexpected error occurred on the server. |

***

### 502 - Bad Gateway

Indicates that the server received an invalid response from an upstream server.

| Error Message | Cause |
| :- | :- |
| Unexpected error. | The server encountered an unexpected error while processing the request. |


# Media Data API
Source: https://docs.brightdata.com/datasets/media-data-api





# Snowflake delivery configuration guide
Source: https://docs.brightdata.com/general/cloud-providers/snowflake

Configure Snowflake as a delivery destination for Bright Data datasets (250+ domains), including connection setup and supported delivery options.

<Note>
  Snowflake configuration is available for 'Datasets' delivery and not available for data collectors (Web Scraper).
</Note>

## How to get started

In order to allow efficient delivery of Datasets to your Snowflake environment, we provide a step-by-step guide to set it up. Just follow these steps:

<Steps>
  <Step title="Select or Create a Database">
    Firstly, decide if you will use an existing database or create a new one. If you opt for a new database, here's the command you need:

    ```sql theme={null}
    CREATE DATABASE <database>;
    ```

    <Tip>
      Remember to replace `<database>` with the name you want for your database.
    </Tip>
  </Step>

  <Step title="Select or Create a Schema">
    Decide if you will use an existing schema or create a new one. By default every database has a PUBLIC schema. If you wish to use a different schema, here's the command you need:

    ```sql theme={null}
    CREATE SCHEMA <schema>;
    ```

    <Tip>
      Replace `<schema>` with your own schema name.
    </Tip>
  </Step>

  <Step title="Select or Create a Warehouse">
    Choose an existing warehouse or create a new one. When creating a new warehouse, consider Snowflake's recommendations for configuring a warehouse specifically for data loading. Use the following command to create a warehouse:

    ```sql theme={null}
    CREATE WAREHOUSE <warehouse>;
    ```

    <Tip>
      Replace `<warehouse>` with your desired warehouse name.
    </Tip>
  </Step>

  <Step title="Select or Create an Internal Named Stage">
    Next, choose an existing internal named stage or create a new one. To create a new stage, use this command:

    ```sql theme={null}
    CREATE STAGE <stage>;
    ```

    <Tip>
      Don't forget to replace `<stage>` with your preferred stage name.
    </Tip>
  </Step>

  <Step title="Create a Role">
    You'll need a role that can write to your chosen stage. To create one, use:

    ```sql theme={null}
    CREATE ROLE <role_name>;
    ```

    <Tip>Change `<role_name>` to your chosen role name.</Tip>
  </Step>

  <Step title="Grant Warehouse Rights to the Role">
    Now, grant your new role the necessary rights to operate on your chosen warehouse using:

    ```sql theme={null}
    GRANT OPERATE ON WAREHOUSE <warehouse> TO ROLE <role_name>;
    ```

    <Tip>
      Remember to replace `<warehouse>` and `<role_name>` with your specific warehouse and role name respectively.
    </Tip>
  </Step>

  <Step title="Enable Write Operations on the Stage for the Role">
    To enable your role to write on the stage, use the command:

    ```sql theme={null}
    GRANT WRITE ON STAGE <stage> TO ROLE <role_name>;
    ```

    <Tip>
      Again, replace `<stage>` and `<role_name>` with your chosen stage and role names.
    </Tip>
  </Step>

  <Step title="Create a BrightData User">
    Next, create a new user for BrightData that will be used to upload data directly into Snowflake. The command is as follows:

    ```sql theme={null}
    create user <user_name>
    PASSWORD = '<password>'
    LOGIN_NAME = <login>
    MUST_CHANGE_PASSWORD = FALSE
    DISABLED = FALSE
    COMMENT = 'user for BrightData to upload data directly into Snowflake'
    ```

    <Tip>
      Replace `<user_name>`, `<password>`, and `<login>` with your chosen username, password, and login name.
    </Tip>
  </Step>

  <Step title="Grant Role Privileges to the New User">
    Finally, grant your new user the privileges of the role you created:

    ```sql theme={null}
    GRANT ROLE <role_name> TO USER <user_name>;
    ```

    <Tip>
      Replace `<role_name>` and `<user_name>` with your role and user names.
    </Tip>
  </Step>

  <Step title="Allowlist IPs">
    If you have an active Network Policy applied in your Snowflake account you need to whiltelist following IPs:

    ```sql theme={null}
    ALTER NETWORK POLICY <policy_name>

    SET ALLOWED_IP_LIST=(
        <existing_allowlisted_ips>,
        '35.169.71.210',
        '34.233.211.38',
        '44.194.183.74',
        '54.243.177.151'
    );
    ```

    <Tip>
      Replace `<policy_name>` with your network policy name. \
      Replace `<existing_whiltelisted_ips>` with the list of existing allowlisted IPs.
    </Tip>

    And that's it! You have now configured your Snowflake environment to receive data from Bright Data.

    If you have any issues or need further assistance, please contact our support team.

    If you want to learn more about Data Loading Performance and Warehouse Size Considerations [click here](https://docs.snowflake.com/en/user-guide/warehouses-overview#impact-on-data-loading).
  </Step>
</Steps>


# How consumers join the peers network
Source: https://docs.brightdata.com/general/policy/How_do_consumers_join_the_Bright_Data_network_of_peers_

How consumers join the Bright Data peer network of 400M+ residential IPs through partner apps, with full opt-in consent and resource usage protections.

Many applications (such as game applications), require their users to view a video advertisement at certain intervals, so that the game developer can generate revenues. This creates a particularly bad user experience, as it interferes with the experience of the application, wastes around 20MB of cellular data for the ad, and depletes the user's battery.

Bright Data offers an attractive alternative.

When these application vendors integrate the Bright SDK, their users are offered the alternative to not watch these video ads in return for opting in to the Bright Data network. Bright Data only uses their device as a node on the network when it is not in use (so never interferes with the user's experience), when the device is plugged in to power or charged, and always prefers WiFi over cellular data.

For every user that opts in to the Bright Data network, Bright Data pays a monthly fee to the application vendor, who passes that value on to the user by not displaying ads (or by not charging a premium for extra features in some cases).

That provides a much better user experience to the users, and thus the application vendor also enjoys a higher adoption rate of his/her product.

Users choose (opt in) to be a part of the Bright Data network, and may opt out at any time. Bright Data ensures that its application partners are fully compliant with this 'opt in' user flow.

View more on our [Bright SDK](https://bright-sdk.com/) page.


# Web Archive API
Source: https://docs.brightdata.com/products/archive/api-reference

API reference for Bright Data's Web Archive search, including endpoints for running queries and retrieving archived web data.



# How data range affects delivery time
Source: https://docs.brightdata.com/products/archive/data-range-vs-delivery-time

Understand how your selected data range affects delivery time in Bright Data's Web Archive, including S3 Glacier retrieval delays for older data.

If your query is matching data within **last 24 hours** - your snapshot will start processing/delivering immediately.

If some of your matched data is **older than 24 hours** - it needs to be retrieved from **S3 Glacier Deep Archive** storage tier before delivery, which may take **up to 72 hours**.

<Warning>
  Avoid queries that span the retention boundary (approximately 24 hours from now).

  Requests with `max_age` or time ranges that fall within \~24h ± 2h of the current time may include files that have already been migrated to archive storage tier. Attempting a dump for such queries can cause the dump to stall or remain incomplete because of files storage class transition.
</Warning>

<Tip>
  **Recommendations:**

  * We recommend using `max_age` = `24h` for initial testing to ensure fast delivery.
  * For real-time data needs: use `max_age: "24h"` or a narrower window to avoid the retention edge.
  * For historical data (older than 24h): use explicit `min_date`/`max_date` filters rather than `max_age`.
  * If a dump appears stalled: we usually retry automatically, please open a ticket if it didn't happen.
</Tip>


# FAQ: Archive API
Source: https://docs.brightdata.com/products/archive/faqs

FAQs about the Bright Data Archive API: Over ~115 PB of archived data, 4 delivery destinations and CPM pricing of $0.2 to $1 per thousand pages.

<AccordionGroup>
  <Accordion title="What is Archive API?">
    Archive API is a massive, continuously expanding, cached repository by Bright Data, designed to capture and deliver public web data at scale.

    It provides full web pages and metadata, making it ideal for AI training, machine learning, and large-scale data analysis.

    Unlike traditional web crawls, Archive API prioritizes **relevance**, **freshness**, and **usability**, giving you access to the most important parts of the internet as they are scraped daily.
  </Accordion>

  <Accordion title="How much data is available?">
    As of August 2026, the Bright Data Archive holds over\~**115 PB** across **\~800 billion pages** from **\~380 million domains**, and keeps growing.

    Collection runs continuously, so the totals grow every day:

    | Window | Pages added |
    | - | - |
    | Last 24 hours | \~1.6 billion |
    | Last 7 days | \~11.9 billion |
    | Last 30 days | \~48.2 billion |

    That growth rate makes Archive the largest up-to-date web data repository available for AI and data-driven applications.
  </Accordion>

  <Accordion title="How quickly can I access the data?">
    You can start accessing data immediately through our [Archive API](/products/archive/overview). The API allows you to search, retrieve and filter data snapshots from Archive seamlessly and efficiently.

    * Data from the last 24 hours: Will take from within minutes and up to a few hours to deliver (depending on snapshot size)
    * Data older than 24 hours: Will take up to 48 hours to process and start delivery (depending on snapshot size)
  </Accordion>

  <Accordion title="How much does Archive API cost?">
    Archive API is priced by data age and billed per CPM, meaning cost per thousand pages.

    | Data age | Price |
    | - | - |
    | Last 24 hours | \$0.2 / CPM |
    | Older than 24 hours | \$1 / CPM |

    Before you run a dump, `GET /webarchive/search/{search_id}` returns `dump_cost_usd` for that search, plus a `cost_breakdown` object splitting the estimate between cache pages and archive pages.
  </Accordion>

  <Accordion title="How can my data be delivered?">
    Archive API offers four delivery destinations:

    * **Amazon S3 bucket:** Have your Data Snapshot delivered directly to your S3 bucket.
    * **Azure Blob Storage:** Deliver the data snapshot directly to your Azure Blob container.
    * **Google Cloud Storage:** Deliver the data snapshot directly to your GCS bucket.
    * **Webhook:** Retrieved via webhook for real-time integration into your systems.

    Webhook delivery is not suitable for large dumps, which can reach 1 GB. See [Deliver to cloud](/api-reference/archive-api/deliver-to-cloud) for the settings each destination requires.
  </Accordion>

  <Accordion title="Can I filter Archive's data to get only what I need?">
    Absolutely! Archive API allows filtering by category, domains, date, languages, and country before retrieving data, ensuring you only get what you need.
  </Accordion>

  <Accordion title="How does Bright Data's Archive compare to Common Crawl?">
    When working with large-scale web data, **freshness**, **relevance**, and **accessibility** are key. While Common Crawl provides a broad historical snapshot of the web, Bright Data’s Archive API offers real-time, continuously updated data with advanced filtering and delivery options. Here’s how they compare:

    | **Feature** | **Bright Data’s Archive** | **Common Crawl** |
    | - | - | - |
    | **Data Collection** | Continuously captures public web data in real time, providing results as recent as “now.” | Periodic web crawling (not real-time), updated monthly or bimonthly. Data can be outdated |
    | **Data Volume** | 115 PB collected in a few years, covering \~800 billion pages across \~380M domains. Adds \~11.9 billion pages a week. | 250b pages collected over 18 years. |
    | **Website Coverage & Relevance** | Focuses on high-value, relevant website data based on real scraping business needs. | Crawls indiscriminately, including outdated or low-quality pages. |
    | **Data Types** | Full web pages (JS-rendered) | 98.6% HTML and text |
    | **Filtering & Delivery** | Full discovery and delivery platform- filtering by category, domain, language, date etc. Delivered via Amazon S3, Azure Blob Storage, Google Cloud Storage or webhook. | No built-in filtering or delivery. Need to manually process huge raw WARC files. |
  </Accordion>
</AccordionGroup>


# Web Archive overview
Source: https://docs.brightdata.com/products/archive/overview

The Web Archive gives access to Bright Data's stored web traffic (380M+ domains), a growing repository of pages collected through Unlocker and SERP APIs.

## What it does

Instead of running your own crawlers, you search the archive, filter what you need (by time range, domain, URL patterns, language, blocking signals), and export ready-to-use datasets as HTML files + metadata.

## Common use cases

* **LLM training and RAG pipelines**: Build or refresh training corpora from targeted web segments
* **Search and indexing**: Backfill indexes with historical content across large domain sets
* **Search product augmentation**: Improve coverage for sites with advanced blocking, supporting reliable page retrieval at scale

## How it works

<Card title="Run a search" icon="search" href="/api-reference/archive-api/run-a-search">
  Filter by time range, domains, URL patterns, language, or signals (CAPTCHA, robots blocks, etc.)
</Card>

<Card title="Review the estimate" icon="clipboard-list" href="/api-reference/archive-api/get-search-status">
  See matched file count, snapshot size, expected duration, and cost
</Card>

<Card title="Create and deliver a dump" icon="file-export" href="/api-reference/archive-api/deliver-to-cloud">
  Export the snapshot as HTML files + metadata (URL, timestamp, collection attributes) to Amazon S3, Azure Blob Storage, or via webhook
</Card>


# Company search
Source: https://docs.brightdata.com/products/business-search/company-search

Find companies with Business Search. [POST /search/company](/api-reference/business-search/search-company) searches by name, industry, headquarters location and size, in JSON or plain language.

This page shows the shape `query` takes in each mode, the fields a company search can filter on with the operator each accepts and what a request looks like.

Company requests go to [`POST /search/company`](/api-reference/business-search/search-company). For professional profiles, see [People search](/products/business-search/people-search). To find people at the companies a company search returns, see [How to run a multi-step search](/products/business-search/examples#how-to-run-a-multi-step-search).

## Writing queries

The shape of `query` follows the [search mode](/products/business-search/introduction#search-modes):

* **Ludicrous** takes a JSON object of conditions on the [searchable fields](#searchable-fields), combined with `and`, `or` and `not`. Operators and value shapes are in [Business Search query syntax](/products/business-search/query-syntax).
* **Instant** and **Smart** take a plain-language sentence of up to 200 characters. Business Search turns the sentence into one structured query on the same fields. A sentence that names or describes one company is ranked by company name and slogan. A sentence that asks for a set of companies by sector or attributes is ranked by what each company does, from its `about`, `specialties`, `industry` and `slogan`.

## Searchable fields

The operator a field accepts depends on the field's type. Text fields accept only the `text` operator. Typed fields, such as strings and integers, accept `equals`, `in` and `range`. Sending `equals` to a text field returns HTTP 400.

| Field | Type | Operators | Notes |
| - | - | - | - |
| `industry` | text | `text` | Word match, for example `software` |
| `name` | text | `text` | Company name |
| `about`, `slogan`, `specialties` | text | `text` | Descriptive text. See [example](/products/business-search/examples#how-to-match-a-phrase-in-company-descriptions-or-specialties) |
| `headquarters_location` | text | `text` | Descriptive location string |
| `headquarters_country_code` | string | `equals`, `in` | ISO 3166 alpha-2 code such as `US` or `GB` |
| `headquarters_city` | string | `equals` | Exact city name |
| `offices_country_codes` | array of strings | `in` | Countries where the company has an office. See [example](/products/business-search/examples#how-to-find-companies-by-office-location-instead-of-headquarters) |
| `offices_cities` | array of strings | `in` | Cities where the company has an office |
| `organization_type` | string | `equals` | One of `Privately Held`, `Public Company`, `Nonprofit`, `Educational`, `Self-Employed` or `Government Agency` |
| `founded_year` | integer | `range`, `equals` | |
| `employees_in_linkedin` | integer | `range` | Headcount recorded at the source |
| `company_size_from`, `company_size_to` | integer | `range` | Self-reported size band |
| `funding_stage` | string | `equals`, `in` | Latest round type |
| `funding_raised` | integer | `range` | Amount of the last round, in USD |
| `linkedin_followers` | integer | `range` | Follower count |

`funding_stage` accepts `pre-seed`, `seed`, `angel`, `series-a`, `series-b`, `series-c`, `series-d`, `series-e`, `series-unknown`, `grant`, `debt`, `convertible-note`, `crowdfunding`, `non-equity-assistance`, `corporate-round`, `private-equity` and `undisclosed`.

<Note>
  `employees_in_linkedin` is the headcount recorded in the source profile, not a guaranteed total, and roughly 40 percent of company records store it as 0. For a reliable size filter, combine it with the `company_size_from` and `company_size_to` band and keep its lower bound at 1 or higher:

  ```json theme={null}
  {
    "and": [
      { "range": { "employees_in_linkedin": { ">=": 50, "<=": 200 } } },
      { "range": { "company_size_from": { "<=": 200 } } },
      { "range": { "company_size_to": { ">=": 50 } } }
    ]
  }
  ```

  A record qualifies when its headcount is in the range and its self-reported band overlaps it.
</Note>

## Example request

<Tabs>
  <Tab title="Ludicrous">
    A Ludicrous request finds US companies with `software` in their industry and 50 to 500 employees on record, and names seven output fields:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "industry": "software" } },
              { "equals": { "headquarters_country_code": "US" } },
              { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
            ]
          },
          "offset": 0,
          "limit": 3,
          "view": {
            "fields": [
              "name", "website", "industry", "headquarters_country_code",
              "employees_in_linkedin", "founded_year", "linkedin_followers"
            ]
          }
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "ludicrous",
            "query": {
              "and": [
                { "text": { "industry": "software" } },
                { "equals": { "headquarters_country_code": "US" } },
                { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
              ]
            },
            "offset": 0,
            "limit": 3,
            "view": {
              "fields": [
                "name", "website", "industry", "headquarters_country_code",
                "employees_in_linkedin", "founded_year", "linkedin_followers"
              ]
            }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "industry": "software" } },
              { "equals": { "headquarters_country_code": "US" } },
              { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
            ]
          },
          "offset": 0,
          "limit": 3,
          "view": {
            "fields": [
              "name", "website", "industry", "headquarters_country_code",
              "employees_in_linkedin", "founded_year", "linkedin_followers"
            ]
          }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "ra2cfffad23ad45afb987cd62e821e33b",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 8,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "70e11d46b2a9e65ff0a55a0541c5b0592f2e98360b67eae27c5f605a51afb3d4",
          "data": {
            "name": "Splashtop Inc.",
            "website": "https://www.splashtop.com/",
            "industry": "Software Development",
            "headquarters_country_code": "US",
            "employees_in_linkedin": 350,
            "founded_year": 2006,
            "linkedin_followers": 29668
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Instant">
    An Instant request asks for the same companies in one sentence:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "instant",
          "query": "US software companies with 50 to 500 employees",
          "limit": 3,
          "view": "summary"
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "instant",
            "query": "US software companies with 50 to 500 employees",
            "limit": 3,
            "view": "summary"
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "instant",
          "query": "US software companies with 50 to 500 employees",
          "limit": 3,
          "view": "summary"
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records, with `url` and `logo` omitted:

    ```json theme={null}
    {
      "req_id": "r6581e80b2c034f49b7155d5d192c28f5",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 595,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "7b8d489b82344beae097e05cddfcf1da56ed51e37fab6fc64b2ca58e7b0713bd",
          "data": {
            "name": "SourceForge",
            "slogan": "The complete software platform. SourceForge is the largest B2B software review and comparison directory in the world.",
            "industry": "Software Development",
            "headquarters_location": "San Diego, California",
            "headquarters_country_code": "US",
            "offices_cities": [
              "San Diego"
            ],
            "company_size_from": 51,
            "company_size_to": 200,
            "employees_in_linkedin": 59,
            "linkedin_followers": 39185,
            "website": "https://sourceforge.net/",
            "domain": "sourceforge.net"
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Smart">
    A Smart request sends the same sentence and ranks the candidates by how well each record answers it:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "smart",
          "query": "US software companies with 50 to 500 employees",
          "limit": 3,
          "view": "summary"
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "smart",
            "query": "US software companies with 50 to 500 employees",
            "limit": 3,
            "view": "summary"
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "smart",
          "query": "US software companies with 50 to 500 employees",
          "limit": 3,
          "view": "summary"
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records, with `url` and `logo` omitted:

    ```json theme={null}
    {
      "req_id": "ra093a71684884dee9aaeb13d15b4f300",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 593,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "89d3d02c7227eb19214e0912d980e84e56ad89e19a49f81a4924d13b844d2762",
          "data": {
            "name": "BQE Software",
            "slogan": "All-in-one Firm Management Software for Engineers, Architects, Consultants, & Professional Services Firms.",
            "industry": "Software Development",
            "headquarters_location": "West Hollywood, CA",
            "headquarters_country_code": "US",
            "offices_cities": [
              "West Hollywood"
            ],
            "company_size_from": 201,
            "company_size_to": 500,
            "employees_in_linkedin": 409,
            "linkedin_followers": 28157,
            "website": "https://www.bqe.com/",
            "domain": "bqe.com"
          }
        }
      ]
    }
    ```
  </Tab>
</Tabs>

For the fields each view returns and how `view` relates to `query`, see [Business Search field views](/products/business-search/select-fields).

For more tested requests, see [Business Search query examples](/products/business-search/examples).


# Business Search error codes
Source: https://docs.brightdata.com/products/business-search/error-codes

Look up every HTTP status Business Search returns, 200 to 504, with its cause, whether to retry and what to fix, plus two sample 400 rejection bodies.

This page is the status code table for Business Search. A Business Search error is a JSON body with an `error` message, never a successful search with zero matches. HTTP 200 with an empty `documents` array means the search ran and found nothing.

## Which status codes does Business Search return?

| Status | Meaning | Retry | What to do |
| - | - | - | - |
| `200` | The search ran. `documents` can still be empty | Not needed | Treat an empty `documents` array as no matches, not as an error and not as proof the entity does not exist |
| `400` | The request body is invalid | Never | Fix the field, operator, mode or pagination value named in `error` |
| `401` | The API key is missing, invalid or expired. A wrong key returns `{"error":"Invalid token"}` and an expired one returns `Token expired` | Never | Check the key in the [Control Panel](https://brightdata.com/cp/setting/users) |
| `403` | The account cannot use Business Search: no customer account exists for the key, the account is inactive or the account is not on the API allowlist | Never | Confirm the account is active and has Business Search access |
| `404` | Unknown API version | Never | Correct the version segment in the request path |
| `429` | The rate limit was exceeded. The request was not searched and was not billed | After the delay in `Retry-After` | Wait the seconds given in the `Retry-After` header, then send the request again |
| `500` | Server-side configuration or backend error | Bounded backoff | Retry. If `error_code` is `backend_search_failed` and the same request fails again, the request itself is the cause: in Instant and Smart mode a request whose `offset` plus `limit` exceeds 100 returns this error, so change the request instead of retrying it |
| `501` | The request is valid but unsupported: the source is disabled or unavailable, or natural-language planning or ranking is not available for that source | Never | Change the mode or the source |
| `502` | The natural-language planner or the ranking step returned an invalid or empty response. Applies to `instant` and `smart` | Bounded backoff | Retry, or send the same search as structured conditions in `ludicrous` |
| `504` | The search timed out | Bounded backoff | Retry with a narrower query |

Bounded backoff means a fixed number of attempts with growing delays, never an unlimited loop. Only HTTP 200 responses are billed, because billing requires a completed search. See [Business Search pricing](/products/business-search/pricing) for the billable and non-billable request list.

Some responses also carry an `error_code`, a machine-readable class such as `invalid_query` or `backend_search_failed`. Branch on `error_code` when it is present and fall back to the HTTP status when it is not, because generic errors omit it.

Keep HTTP 400, HTTP 401 or 403, HTTP 429, HTTP 500 to 504 and HTTP 200 with an empty `documents` array apart in your own logging. Collapsing them into one "search failed" branch hides the difference between a bug in your query and an outage. Log `req_id` when the response returns one and include it, with the status and the `error` message, in any support ticket.

## Why was a request rejected?

Business Search rejects an invalid request body with HTTP 400 and names what it rejected in `error`. The causes are:

* An unknown category
* An invalid `mode`, `query`, `view`, `offset` or `limit`
* An unknown view profile name, or unknown field names in `view`
* A natural-language query longer than 200 characters
* An operator the field type does not support, such as `equals` on a text field
* A debug property such as `explain` that the account cannot send

Selecting an unknown output field returns:

```json theme={null}
{
  "error": "view: unknown field(s): not_a_released_field"
}
```

An operator the field type does not support is rejected the same way. The message names the field, the operator and the types that operator accepts:

```json theme={null}
{
  "error": "Invalid query: In operator 'equals', field 'industry': Operator does not support field type 'text'. Supported types: bool, byte, double, float, int, language, long, string."
}
```

Text fields such as `industry` and `current_title` accept only the `text` operator. See [Business Search query syntax](/products/business-search/query-syntax) for the operator each field type accepts.

Correct the request when validation fails. Rate-limit checks run after validation, so a rejected request does not consume rate-limit budget and is not billed, but repeating an invalid body still cannot succeed.

## What is the rate limit?

Business Search allows 60 requests per minute by default, counted per account, per category and per mode. Company and people searches therefore have separate budgets, as do Ludicrous, Instant and Smart within each category, so a company search that is rate limited does not block a people search. To raise the limit for your account, a category or a single mode, contact Bright Data.

The budget refills continuously rather than resetting at the top of each minute, so a short burst above the rate is smoothed out instead of blocking the rest of the minute.

A request over the limit returns HTTP 429 with a `Retry-After` header giving the seconds to wait. The request is not searched, not queued and not billed. Wait that long, then send the request again.

## Frequently asked questions

### Does a 200 response mean the query was understood?

No. A 200 means the search ran. In Instant and Smart modes, natural-language intent and result relevance are not guaranteed by a successful HTTP response, so review the records before acting on them.

### How do I tell a missing field from an empty result?

A missing field inside a returned record means the source has no stored value for that record. An empty `documents` array means no record matched the conditions. Handle absent values per record and empty pages per request.


# Business Search query examples
Source: https://docs.brightdata.com/products/business-search/examples

Tested Business Search examples: companies by office location or description phrase, people by past employer, and a multi-step company-then-people search.

This page shows tested Business Search requests for prospecting and hiring questions:

* [Find companies by office location instead of headquarters](#how-to-find-companies-by-office-location-instead-of-headquarters), with `in` on `offices_country_codes`
* [Match a phrase in company descriptions or specialties](#how-to-match-a-phrase-in-company-descriptions-or-specialties), with `or` and `mode: "all"`
* [Find people by a past employer](#how-to-find-people-by-a-past-employer), with `past_company_names` and `not`
* [Run a multi-step search](#how-to-run-a-multi-step-search), a company search followed by a people search

Every request reads the API key from the `BRIGHTDATA_API_KEY` environment variable, as set in [Step 1 of the quickstart](/products/business-search/quickstart#step-1-get-and-set-your-api-key). Your records and `matched` counts will differ from the sample responses, because results move between runs.

## How to find companies by office location instead of headquarters

To find software companies with an office in Germany, wherever they are headquartered, filter on `offices_country_codes` rather than `headquarters_country_code`. The field is an array of country codes and takes `in`, so one condition matches every company with an office in any listed country. Instant and Smart take the same intent as a sentence.

<Tabs>
  <Tab title="Ludicrous">
    A Ludicrous request combines `software` in the industry with `DE` in the office country codes. The `text` condition sets `mode: "all"`: in testing, the default mode reached only a small share of the matching companies, and a different share on each run:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={9} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "industry": { "value": "software", "mode": "all" } } },
              { "in": { "offices_country_codes": ["DE"] } }
            ]
          },
          "limit": 3,
          "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
        }'
      ```

      ```python Python highlight={15} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "ludicrous",
            "query": {
              "and": [
                { "text": { "industry": { "value": "software", "mode": "all" } } },
                { "in": { "offices_country_codes": ["DE"] } }
              ]
            },
            "limit": 3,
            "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={12} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "industry": { "value": "software", "mode": "all" } } },
              { "in": { "offices_country_codes": ["DE"] } }
            ]
          },
          "limit": 3,
          "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "rb8545422f0a1478690c2b51666b48de2",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 23123,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "497e671df1de83a45eec09ac98062e8149b2f4cc8ca4e9cfbf89dc86a45404dd",
          "data": {
            "name": "Google",
            "industry": "Software Development",
            "headquarters_location": "Mountain View, CA",
            "offices_country_codes": [
              "PL",
              "CA",
              "CL",
              "SE",
              "AU",
              "US",
              "SG",
              "DE",
              "ES",
              "FR",
              "MX",
              "CH",
              "IT",
              "IN",
              "NL",
              "CO",
              "BR",
              "HK",
              "AR",
              "PH",
              "IL",
              "IE",
              "GB"
            ],
            "website": "https://goo.gle/3DLEokh"
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Instant">
    An Instant request sends the intent as one sentence:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={6} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "instant",
          "query": "Software companies with an office in Germany",
          "limit": 3,
          "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
        }'
      ```

      ```python Python highlight={12} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "instant",
            "query": "Software companies with an office in Germany",
            "limit": 3,
            "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={9} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "instant",
          "query": "Software companies with an office in Germany",
          "limit": 3,
          "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "rd24753db731c4a6b806c638fad544cc5",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 749,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "12d1ece1155dded506f3473ba5574f2e0e6c067f420dcaf0bda9e9cec58488dd",
          "data": {
            "name": "Maxon",
            "industry": "Software Development",
            "headquarters_location": "Bad Homburg",
            "offices_country_codes": [
              "DE",
              "US",
              "CA",
              "JP"
            ],
            "website": "https://www.maxon.net/"
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Smart">
    A Smart request sends the same sentence and ranks the candidates by how well each record answers it:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={6} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "smart",
          "query": "Software companies with an office in Germany",
          "limit": 3,
          "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
        }'
      ```

      ```python Python highlight={12} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "smart",
            "query": "Software companies with an office in Germany",
            "limit": 3,
            "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={9} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "smart",
          "query": "Software companies with an office in Germany",
          "limit": 3,
          "view": { "fields": ["name", "industry", "headquarters_location", "offices_country_codes", "website"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "raf8ab94a0ef649cd8d0eb2a58c800310",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 746,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "12d1ece1155dded506f3473ba5574f2e0e6c067f420dcaf0bda9e9cec58488dd",
          "data": {
            "name": "Maxon",
            "industry": "Software Development",
            "headquarters_location": "Bad Homburg",
            "offices_country_codes": [
              "DE",
              "US",
              "CA",
              "JP"
            ],
            "website": "https://www.maxon.net/"
          }
        }
      ]
    }
    ```
  </Tab>
</Tabs>

## How to match a phrase in company descriptions or specialties

To find fraud-detection software providers with an office in the United Kingdom, match the words in the text a company writes about itself. `fraud detection software` can appear in `about` or in `specialties`, so the structured query checks both with `or`, and `mode: "all"` requires all three words in the same field. This is a word match, not proof that the company sells fraud detection: a company can describe fraud detection work without offering it as a product.

<Tabs>
  <Tab title="Ludicrous">
    A Ludicrous request accepts either field and requires a GB office:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={10,11} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "ludicrous",
          "query": {
            "and": [
              {
                "or": [
                  { "text": { "about": { "value": "fraud detection software", "mode": "all" } } },
                  { "text": { "specialties": { "value": "fraud detection software", "mode": "all" } } }
                ]
              },
              { "in": { "offices_country_codes": ["GB"] } }
            ]
          },
          "limit": 3,
          "view": { "fields": ["name", "industry", "specialties", "offices_country_codes", "website"] }
        }'
      ```

      ```python Python highlight={16,17} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "ludicrous",
            "query": {
              "and": [
                {
                  "or": [
                    { "text": { "about": { "value": "fraud detection software", "mode": "all" } } },
                    { "text": { "specialties": { "value": "fraud detection software", "mode": "all" } } }
                  ]
                },
                { "in": { "offices_country_codes": ["GB"] } }
              ]
            },
            "limit": 3,
            "view": { "fields": ["name", "industry", "specialties", "offices_country_codes", "website"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={13,14} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "ludicrous",
          "query": {
            "and": [
              {
                "or": [
                  { "text": { "about": { "value": "fraud detection software", "mode": "all" } } },
                  { "text": { "specialties": { "value": "fraud detection software", "mode": "all" } } }
                ]
              },
              { "in": { "offices_country_codes": ["GB"] } }
            ]
          },
          "limit": 3,
          "view": { "fields": ["name", "industry", "specialties", "offices_country_codes", "website"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "r9a82f304d62748ddabd98aa954291bcd",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 78,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "b8b445ba5ddcf7dab8342ce3e26609e07f5d864b5dfcef813e7ce2d78bc5f1a5",
          "data": {
            "name": "FICO",
            "industry": "Software Development",
            "specialties": "Predictive Analytics, Decision Management Tools and Applications, Scores, Consultancy, B2B Enterprise Software, Enterprise Software, Decision Technology, Enterprise Fraud, Cyber security, Fraud Detection, Loan origination software, Applied Intelligence, and AI",
            "offices_country_codes": [
              "GB",
              "IN",
              "SG",
              "US"
            ],
            "website": "https://www.fico.com/"
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Smart">
    A Smart request sends the intent as one sentence and ranks the candidates by how well each record answers it:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={6} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "smart",
          "query": "Fraud-detection software providers with an office in the United Kingdom",
          "limit": 3,
          "view": { "fields": ["name", "industry", "specialties", "offices_country_codes", "website"] }
        }'
      ```

      ```python Python highlight={12} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "smart",
            "query": "Fraud-detection software providers with an office in the United Kingdom",
            "limit": 3,
            "view": { "fields": ["name", "industry", "specialties", "offices_country_codes", "website"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={9} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "smart",
          "query": "Fraud-detection software providers with an office in the United Kingdom",
          "limit": 3,
          "view": { "fields": ["name", "industry", "specialties", "offices_country_codes", "website"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "rb4c207d88e7e43a7a0dce6da7a06292a",
      "source": "linkedin_company",
      "meta": {
        "coverage_percent": 100,
        "matched": 828,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "ea4950408cd68b5abd76383b8a7c8a23c0600616559ad51253b897164bda60f3",
          "data": {
            "name": "Resistant AI - Fraud Detection",
            "industry": "Financial Services",
            "specialties": "Document Verification, Anti Fraud Software, Spot Fake Bank Statements, ID Verification, Fake Document Detection, Document Fraud Detection, Fraud Prevention, Machine Learning, Artificial Intelligence, Financial Fraud, Document Forgery, KYC, KYB, Onboarding, Loan Fraud, AI Detector, Tenant Screening, Loan Underwriting, Employment Verification, Fraud Detection in Insurance Claims, AML, and Transaction Monitoring",
            "offices_country_codes": [
              "CZ",
              "GB",
              "US"
            ],
            "website": "https://resistant.ai/"
          }
        }
      ]
    }
    ```
  </Tab>
</Tabs>

## How to find people by a past employer

To find US engineering managers who used to work at Microsoft and have since moved on, combine a `text` condition on `past_company_names` with a `not` condition on `current_company_name`. Send this one as a structured query: in testing, the sentence form found former Microsoft employees but did not exclude people who still work there. `past_company_names` lists employers without dates, so the result shows that the person worked at Microsoft, not when.

Both employer conditions set `mode: "all"`, as the office location recipe does. The `not` condition excludes profiles whose current employer is still Microsoft:

**Sample request**

<CodeGroup>
  ```bash cURL highlight={9,10} theme={null}
  curl --request POST "https://api.brightdata.com/search/people" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "mode": "ludicrous",
      "query": {
        "and": [
          { "text": { "current_title": { "value": "engineering manager", "mode": "all" } } },
          { "text": { "past_company_names": { "value": "Microsoft", "mode": "all" } } },
          { "not": { "text": { "current_company_name": { "value": "Microsoft", "mode": "all" } } } },
          { "equals": { "country_code": "US" } }
        ]
      },
      "limit": 3,
      "view": { "fields": ["current_title", "current_company_name", "past_company_names", "country_code"] }
    }'
  ```

  ```python Python highlight={15,16} theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/people",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
        "mode": "ludicrous",
        "query": {
          "and": [
            { "text": { "current_title": { "value": "engineering manager", "mode": "all" } } },
            { "text": { "past_company_names": { "value": "Microsoft", "mode": "all" } } },
            { "not": { "text": { "current_company_name": { "value": "Microsoft", "mode": "all" } } } },
            { "equals": { "country_code": "US" } }
          ]
        },
        "limit": 3,
        "view": { "fields": ["current_title", "current_company_name", "past_company_names", "country_code"] }
      },
  )
  print(response.text)
  ```

  ```javascript Node.js highlight={12,13} theme={null}
  const response = await fetch("https://api.brightdata.com/search/people", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "mode": "ludicrous",
      "query": {
        "and": [
          { "text": { "current_title": { "value": "engineering manager", "mode": "all" } } },
          { "text": { "past_company_names": { "value": "Microsoft", "mode": "all" } } },
          { "not": { "text": { "current_company_name": { "value": "Microsoft", "mode": "all" } } } },
          { "equals": { "country_code": "US" } }
        ]
      },
      "limit": 3,
      "view": { "fields": ["current_title", "current_company_name", "past_company_names", "country_code"] }
    }),
  });
  console.log(await response.text());
  ```
</CodeGroup>

**Sample response**

The first of the three returned records:

```json theme={null}
{
  "req_id": "r8aa70e91316e44e69ffd193c74070a8c",
  "source": "linkedin_people",
  "meta": {
    "coverage_percent": 100,
    "matched": 887,
    "offset": 0,
    "limit": 3
  },
  "documents": [
    {
      "bright_id": "2c592bb9eb4910423f189ed3e6212195ffc987386b5d047ce3184ecdc79a0670",
      "data": {
        "current_title": "Engineering Manager",
        "current_company_name": "Google",
        "past_company_names": "Microsoft; Microsoft Corporation",
        "country_code": "US"
      }
    }
  ]
}
```

## How to run a multi-step search

A question that mixes company and people conditions needs more than one Business Search request. A people search filters only on the [people searchable fields](/products/business-search/people-search#searchable-fields), such as `current_title` and `current_company_name`. A company search filters on the [company searchable fields](/products/business-search/company-search#searchable-fields), such as funding and headquarters. A people record can return `current_company_funding_raised` in its view, but a people search cannot filter on it.

Run the search in three steps:

1. Run a company search for the company conditions and collect the company names.
2. Run a people search for the people conditions, limited to those company names.
3. Keep only the profiles whose current employer is one of the companies from step 1.

The example below finds the CEOs of technology companies headquartered in San Francisco whose latest funding round was 1 USD to 2 million USD.

### Prerequisites

* A Bright Data API key with Business Search access, stored in the `BRIGHTDATA_API_KEY` environment variable. See [Business Search quickstart](/products/business-search/quickstart)
* For the Python tab, Python 3 with the `requests` package. For the Node.js tab, Node.js 18 or later

### Step 1: Find the companies

Send the company half of the question as a sentence in [Instant mode](/products/business-search/introduction#search-modes). The view asks for `name`, which steps 2 and 3 use to match people to companies, and for `headquarters_city` and `funding_raised`, so you can check each company against the question:

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST "https://api.brightdata.com/search/company" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "mode": "instant",
      "query": "Technology companies headquartered in San Francisco whose latest funding round was between $1 and $2 million",
      "limit": 100,
      "view": { "fields": ["name", "headquarters_city", "funding_raised"] }
    }'
  ```

  ```python Python theme={null}
  import os
  import requests

  API = "https://api.brightdata.com/search"
  HEADERS = {
      "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
      "Content-Type": "application/json",
  }

  response = requests.post(
      f"{API}/company",
      headers=HEADERS,
      json={
          "mode": "instant",
          "query": "Technology companies headquartered in San Francisco whose latest funding round was between $1 and $2 million",
          "limit": 100,
          "view": {"fields": ["name", "headquarters_city", "funding_raised"]},
      },
  )
  response.raise_for_status()
  companies = {
      doc["data"]["name"]
      for doc in response.json()["documents"]
      if "name" in doc["data"]
      and "san francisco" in doc["data"].get("headquarters_city", "").lower()
  }
  print(f"{len(companies)} companies found")
  ```

  ```javascript Node.js theme={null}
  const API = "https://api.brightdata.com/search";
  const HEADERS = {
    Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
    "Content-Type": "application/json",
  };

  const companyResponse = await fetch(`${API}/company`, {
    method: "POST",
    headers: HEADERS,
    body: JSON.stringify({
      mode: "instant",
      query: "Technology companies headquartered in San Francisco whose latest funding round was between $1 and $2 million",
      limit: 100,
      view: { fields: ["name", "headquarters_city", "funding_raised"] },
    }),
  });
  if (!companyResponse.ok) throw new Error(await companyResponse.text());

  const companies = new Set();
  for (const doc of (await companyResponse.json()).documents) {
    const city = (doc.data.headquarters_city ?? "").toLowerCase();
    if (doc.data.name && city.includes("san francisco")) companies.add(doc.data.name);
  }
  console.log(`${companies.size} companies found`);
  ```
</CodeGroup>

Instant can return companies headquartered outside San Francisco, so the Python and Node.js code keep only companies whose `headquarters_city` contains San Francisco. Instant returns up to the first 100 matches. For a shorter list ranked by how well each company answers the sentence, send the same body with `"mode": "smart"` and `"limit": 10`. Smart costs more per search. See [Business Search pricing](/products/business-search/pricing).

### Step 2: Search for people at those companies

Send people searches in [Ludicrous mode](/products/business-search/introduction#search-modes), because the input is now a list of company names from step 1 rather than a sentence. Each request combines the people condition, a CEO title in this example, with up to 10 company names, as `or` conditions on `current_company_name`:

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST "https://api.brightdata.com/search/people" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "mode": "ludicrous",
      "query": {
        "and": [
          {
            "or": [
              { "text": { "current_title": "CEO" } },
              { "text": { "current_title": { "value": "chief executive officer", "mode": "all" } } }
            ]
          },
          {
            "or": [
              { "text": { "current_company_name": { "value": "COMPANY_NAME_1", "mode": "all" } } },
              { "text": { "current_company_name": { "value": "COMPANY_NAME_2", "mode": "all" } } }
            ]
          }
        ]
      },
      "limit": 100,
      "view": { "fields": ["current_title", "current_company_name"] }
    }'
  ```

  ```python Python theme={null}
  ceo_title = {
      "or": [
          {"text": {"current_title": "CEO"}},
          {"text": {"current_title": {"value": "chief executive officer", "mode": "all"}}},
      ]
  }

  names = sorted(companies)
  people = {}
  for start in range(0, len(names), 10):
      batch = names[start:start + 10]
      response = requests.post(
          f"{API}/people",
          headers=HEADERS,
          json={
              "mode": "ludicrous",
              "query": {
                  "and": [
                      ceo_title,
                      {
                          "or": [
                              {"text": {"current_company_name": {"value": name, "mode": "all"}}}
                              for name in batch
                          ]
                      },
                  ]
              },
              "limit": 100,
              "view": {"fields": ["current_title", "current_company_name"]},
          },
      )
      response.raise_for_status()
      for doc in response.json()["documents"]:
          people[doc["bright_id"]] = doc["data"]

  print(f"{len(people)} candidate profiles found")
  ```

  ```javascript Node.js theme={null}
  const ceoTitle = {
    or: [
      { text: { current_title: "CEO" } },
      { text: { current_title: { value: "chief executive officer", mode: "all" } } },
    ],
  };

  const names = [...companies];
  const people = new Map();
  for (let start = 0; start < names.length; start += 10) {
    const batch = names.slice(start, start + 10);
    const peopleResponse = await fetch(`${API}/people`, {
      method: "POST",
      headers: HEADERS,
      body: JSON.stringify({
        mode: "ludicrous",
        query: {
          and: [
            ceoTitle,
            { or: batch.map((name) => ({ text: { current_company_name: { value: name, mode: "all" } } })) },
          ],
        },
        limit: 100,
        view: { fields: ["current_title", "current_company_name"] },
      }),
    });
    if (!peopleResponse.ok) throw new Error(await peopleResponse.text());
    for (const doc of (await peopleResponse.json()).documents) {
      people.set(doc.bright_id, doc.data);
    }
  }
  console.log(`${people.size} candidate profiles found`);
  ```
</CodeGroup>

The Python and Node.js code send one request per batch of 10 names and key the results on `bright_id`, so a profile returned by two batches is kept once. In the cURL tab, replace `COMPANY_NAME_1` and `COMPANY_NAME_2` with company names from step 1, and add one condition per name. Each request is a separate billed search, so 100 companies cost 11 searches in total.

### Step 3: Keep the profiles whose company matches

Keep only the profiles whose `current_company_name` is exactly one of the names from step 1. With cURL, compare the two values in the step 1 and step 2 responses:

<CodeGroup>
  ```python Python theme={null}
  ceos = [p for p in people.values() if p.get("current_company_name") in companies]

  for person in ceos:
      print(f"{person['current_title']} at {person['current_company_name']}")
  ```

  ```javascript Node.js theme={null}
  const ceos = [...people.values()].filter((p) => companies.has(p.current_company_name));

  for (const person of ceos) {
    console.log(`${person.current_title} at ${person.current_company_name}`);
  }
  ```
</CodeGroup>

The step 2 search is not enough on its own. `current_company_name` is a text field, so a condition matches every profile whose company name contains the words: `Acme` also matches `Acme Robotics`. Comparing the full name drops those profiles, and drops profiles with no `current_company_name`. The two searches share no identifier: a company record's `company_id` and a people record's `current_company_id` are different values, so the name is the only field both sides return.

Review the list before you use it. The `text` condition on `current_title` also matches titles that only contain CEO, such as Assistant to CEO. A company name can also belong to more than one company, and matching on the name cannot tell them apart.


# What is Business Search?
Source: https://docs.brightdata.com/products/business-search/introduction

Business Search is an entity search API that returns ranked people and company records as JSON. Compare its 3 modes by speed, depth, cost and precision.

<Note>
  Business Search is in early access. Email [sales@brightdata.com](mailto:sales@brightdata.com) to request access.
</Note>

An entity search returns the thing you searched for, not documents about it. Describe a person or a company and Business Search returns the matching records as structured JSON, rather than a list of pages that mention them.

One request searches an index of more than 700 million people and companies, refreshed daily. Two entity types are available:

<CardGroup>
  <Card title="Company" icon="building" href="/products/business-search/company-search">
    Find companies by industry, headquarters country, size band, founding year and funding stage, with structured conditions or a plain-language sentence.
  </Card>

  <Card title="People" icon="user" href="/products/business-search/people-search">
    Find people by title, current company, location and follower count, with structured conditions or a plain-language sentence.
  </Card>
</CardGroup>

## Search modes

Business Search supports a range of workflows, from looking up one company to discovering every candidate in a market, so it offers three modes that trade speed, depth, cost and precision against each other. The `mode` property selects one:

* **Ludicrous** runs structured conditions you write with [Business Search query syntax](/products/business-search/query-syntax), exactly as written. It is the fastest mode and returns up to 100 records per page.
* **Instant** takes a plain-language sentence, turns it into one structured query and returns its matches. It also returns up to 100 records per page, at the same rate as Ludicrous.
* **Smart** takes the same kind of sentence, then ranks the candidates by how well each record answers the request. It is the most precise mode, the slowest and the most expensive, and returns 10 records per page.

In every mode, `documents` come back in ranked order.

<Tabs>
  <Tab title="Ludicrous">
    Ludicrous is a lexical, structured search: you name the fields and conditions yourself, text conditions match words with BM25, and no model interprets the request or reorders the results.

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "industry": "software" } },
              { "equals": { "headquarters_country_code": "US" } },
              { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
            ]
          },
          "limit": 3,
          "view": "summary"
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "ludicrous",
            "query": {
              "and": [
                { "text": { "industry": "software" } },
                { "equals": { "headquarters_country_code": "US" } },
                { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
              ]
            },
            "limit": 3,
            "view": "summary"
          },
      )
      print(response.status_code, response.json())
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "industry": "software" } },
              { "equals": { "headquarters_country_code": "US" } },
              { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
            ]
          },
          "limit": 3,
          "view": "summary"
        }),
      });
      console.log(response.status, await response.json());
      ```
    </CodeGroup>

    **Sample response**

    ```json theme={null}
    {
      "req_id": "r3417705745d9445bab3114d77d75f16d",
      "meta": { "coverage_percent": 100, "matched": 8, "offset": 0, "limit": 3 },
      "documents": [
        {
          "bright_id": "abc7d8b3719192a4f04197ab57cf352bdbda5abac31dfe1467cc61521d61741c",
          "data": {
            "name": "Braintrust",
            "slogan": "Active observability for agents in production.",
            "industry": "Software Development",
            "headquarters_location": "San Francisco",
            "headquarters_country_code": "US",
            "company_size_from": 51,
            "company_size_to": 200,
            "employees_in_linkedin": 169,
            "linkedin_followers": 15953,
            "website": "https://braintrust.dev/",
            "domain": "braintrust.dev"
          }
        }
      ]
    }
    ```

    `meta.matched` counts the records the search reached, not every company that satisfies the conditions. See [How to paginate Business Search results](/products/business-search/pagination).
  </Tab>

  <Tab title="Instant">
    Instant turns the sentence into one structured query and returns its matches in text-match order.

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "instant",
          "query": "Developer infrastructure companies building tools for AI engineering teams",
          "limit": 3,
          "view": "summary"
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "instant",
            "query": "Developer infrastructure companies building tools for AI engineering teams",
            "limit": 3,
            "view": "summary"
          },
      )
      print(response.status_code, response.json())
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "instant",
          "query": "Developer infrastructure companies building tools for AI engineering teams",
          "limit": 3,
          "view": "summary"
        }),
      });
      console.log(response.status, await response.json());
      ```
    </CodeGroup>

    **Sample response**

    ```json theme={null}
    {
      "req_id": "re5aefd1a0b9c4b9d813af52ce935c26d",
      "meta": { "coverage_percent": 100, "matched": 1314, "offset": 0, "limit": 3 },
      "documents": [
        {
          "bright_id": "cff2fcd9da9a150b16cbc855777265c8de34f3a360986903f23f7f4e73fcf497",
          "data": {
            "name": "Flamerix AI",
            "slogan": "Infrastructure for controlled AI-driven software development.",
            "industry": "IT Services and IT Consulting",
            "headquarters_location": "Tbilisi",
            "headquarters_country_code": "GE",
            "company_size_from": 2,
            "company_size_to": 10,
            "employees_in_linkedin": 1,
            "linkedin_followers": 3,
            "website": "https://flamerix.ai/",
            "domain": "flamerix.ai"
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Smart">
    Smart runs the same interpretation as Instant, then reads each candidate and reorders them by how well the record answers the request, so the first result changes.

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/company" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "smart",
          "query": "Developer infrastructure companies building tools for AI engineering teams",
          "limit": 3,
          "view": "summary"
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/company",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "smart",
            "query": "Developer infrastructure companies building tools for AI engineering teams",
            "limit": 3,
            "view": "summary"
          },
      )
      print(response.status_code, response.json())
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/company", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "smart",
          "query": "Developer infrastructure companies building tools for AI engineering teams",
          "limit": 3,
          "view": "summary"
        }),
      });
      console.log(response.status, await response.json());
      ```
    </CodeGroup>

    **Sample response**

    ```json theme={null}
    {
      "req_id": "r8f4b4e27936b40aaaa342a894f4ac460",
      "meta": { "coverage_percent": 100, "matched": 1294, "offset": 0, "limit": 3 },
      "documents": [
        {
          "bright_id": "c455ef8769b2656cfe67d4a534edb30ff0f55d0241ea95d04e32835684cf3bf8",
          "data": {
            "name": "Skyflo",
            "slogan": "AI engineering harness for coding agents, tools, context, and long-running work.",
            "industry": "Software Development",
            "headquarters_location": "Pune, Maharashtra",
            "headquarters_country_code": "IN",
            "company_size_from": 2,
            "company_size_to": 10,
            "employees_in_linkedin": 2,
            "linkedin_followers": 214,
            "website": "https://skyflo.ai/",
            "domain": "skyflo.ai"
          }
        }
      ]
    }
    ```

    <Note>
      If Smart's ranking step fails, the request returns the results Instant would have returned rather than an error, and it is still billed as Smart.
    </Note>
  </Tab>
</Tabs>

## Compare the modes

| Mode | Query input | Results per search (included / maximum) | Typical response time | When to use |
| - | - | - | - | - |
| `ludicrous` | Structured conditions | 100 / 1,000 | \~50ms | Your application already knows which fields to filter on |
| `instant` | Plain-language sentence | 100 / 1,000 | \~1 second | Natural language at interactive speed; the default for interactive use |
| `smart` | Plain-language sentence | 10 / 100 | \~2 to 3 seconds | Result quality matters more than latency, or a wrong first result is costly |

## Where do you go next?

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/business-search/quickstart">
    Send your first company search and read the response.
  </Card>

  <Card title="Pricing" icon="tag" href="/products/business-search/pricing">
    Per-1,000-search rates by mode and what counts as billable.
  </Card>
</CardGroup>

## Frequently asked questions

### Is Business Search an enrichment product?

No. Business Search discovers and retrieves records. To add detail to records you already have, use [Scraper API](/products/scrapers/overview) or your own stack.

### How fresh is the Business Search index?

The index refreshes daily. A record added or changed at the source appears in Business Search results after the next daily refresh.

### Can one search combine people and company filters?

No. A people search filters on people fields and a company search on company fields, so a question such as "CEOs of funded companies in San Francisco" takes a company search followed by a people search. See [How to run a multi-step search](/products/business-search/examples#how-to-run-a-multi-step-search).


# How to paginate Business Search results
Source: https://docs.brightdata.com/products/business-search/pagination

Paginate Business Search results with offset and limit: keep the query fixed, add limit to offset, stop on a short page and deduplicate on bright_id.

This guide collects every record that matches one Business Search query by repeating the same search with a growing `offset` until a page comes back short or empty.

## Prerequisites

* A Bright Data API key with Business Search access, stored in the `BRIGHTDATA_API_KEY` environment variable as in [Step 1 of the quickstart](/products/business-search/quickstart#step-1-get-and-set-your-api-key)
* A query whose first page already returns the records you want. Tune the conditions with [Business Search query syntax](/products/business-search/query-syntax) before you paginate

## Step 1: Send the first page

Send the search with `offset` set to 0 and `limit` set to the page size. `limit` defaults to 10 and its maximum depends on the mode:

| Mode | Maximum `limit` per page |
| - | - |
| `ludicrous` | 100 |
| `instant` | 100 |
| `smart` | 10 |

How far a search can page also depends on the mode:

* Ludicrous accepts `offset` values up to 1,000, so one search can page through up to 1,100 records.
* Instant and Smart expose only the first 100 matches of a search. `offset` plus `limit` cannot exceed 100, so paginate inside that window or run the same conditions as a structured query in Ludicrous mode.

This request asks for the first 100 matches of a Ludicrous company search. The highlighted lines set the page:

<CodeGroup>
  ```bash cURL highlight={14-15} theme={null}
  curl --request POST "https://api.brightdata.com/search/company" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "source": "linkedin_company",
      "mode": "ludicrous",
      "query": {
        "and": [
          { "text": { "industry": "software" } },
          { "equals": { "headquarters_country_code": "US" } },
          { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
        ]
      },
      "offset": 0,
      "limit": 100,
      "view": "summary"
    }'
  ```

  ```python Python highlight={20-21} theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/company",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
          "source": "linkedin_company",
          "mode": "ludicrous",
          "query": {
              "and": [
                  {"text": {"industry": "software"}},
                  {"equals": {"headquarters_country_code": "US"}},
                  {"range": {"employees_in_linkedin": {">=": 50, "<=": 500}}},
              ]
          },
          "offset": 0,
          "limit": 100,
          "view": "summary",
      },
  )

  print(response.text)
  ```

  ```javascript Node.js highlight={17-18} theme={null}
  const response = await fetch("https://api.brightdata.com/search/company", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      source: "linkedin_company",
      mode: "ludicrous",
      query: {
        and: [
          { text: { industry: "software" } },
          { equals: { headquarters_country_code: "US" } },
          { range: { employees_in_linkedin: { ">=": 50, "<=": 500 } } },
        ],
      },
      offset: 0,
      limit: 100,
      view: "summary",
    }),
  });

  console.log(await response.text());
  ```
</CodeGroup>

The response echoes the pagination in `meta.offset` and `meta.limit` and returns the page in `documents`. The full `meta` schema is on the [search companies API reference](/api-reference/business-search/search-company).

## Step 2: Request the next page

Add `limit` to `offset` and send the body again with every other property unchanged. The category, source, mode, query and view must stay the same, because changing any of them starts a different search.

After a full first page, this request asks for records 101 to 200 of the same search. Only the highlighted `offset` changes:

<CodeGroup>
  ```bash cURL highlight={14-15} theme={null}
  curl --request POST "https://api.brightdata.com/search/company" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "source": "linkedin_company",
      "mode": "ludicrous",
      "query": {
        "and": [
          { "text": { "industry": "software" } },
          { "equals": { "headquarters_country_code": "US" } },
          { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
        ]
      },
      "offset": 100,
      "limit": 100,
      "view": "summary"
    }'
  ```

  ```python Python highlight={20-21} theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/company",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
          "source": "linkedin_company",
          "mode": "ludicrous",
          "query": {
              "and": [
                  {"text": {"industry": "software"}},
                  {"equals": {"headquarters_country_code": "US"}},
                  {"range": {"employees_in_linkedin": {">=": 50, "<=": 500}}},
              ]
          },
          "offset": 100,
          "limit": 100,
          "view": "summary",
      },
  )

  print(response.text)
  ```

  ```javascript Node.js highlight={17-18} theme={null}
  const response = await fetch("https://api.brightdata.com/search/company", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      source: "linkedin_company",
      mode: "ludicrous",
      query: {
        and: [
          { text: { industry: "software" } },
          { equals: { headquarters_country_code: "US" } },
          { range: { employees_in_linkedin: { ">=": 50, "<=": 500 } } },
        ],
      },
      offset: 100,
      limit: 100,
      view: "summary",
    }),
  });

  console.log(await response.text());
  ```
</CodeGroup>

Repeat this step until the stop condition in step 3 is met.

<Warning>
  Do not drive the loop with `meta.matched`. `meta.matched` is a lower bound on the matches the search reached, not a total, and it changes between requests. Stepping outside the mode's window does not return an empty page either: in Instant and Smart, a request with `offset` plus `limit` above 100 returns HTTP 500 with `error_code` `backend_search_failed`, and in Ludicrous an `offset` beyond the supported maximum returns HTTP 400 with `error_code` `invalid_query`.
</Warning>

## Step 3: Stop on a short or empty page

Stop when `documents` comes back empty or shorter than `limit`. That page is the last page of the result set.

A Ludicrous request past the last match returns HTTP 200 with an empty `documents` array, so an empty page is the normal end of a search, not an error. If an Instant or Smart request returns HTTP 500 with `error_code` `backend_search_failed` after earlier pages succeeded, the loop has stepped past the 100-record window of those modes. Other causes of each status are listed in [Business Search error codes](/products/business-search/error-codes).

An empty `documents` array on the first page means the search matched nothing. It is not proof that no such company or person exists.

## Step 4: Deduplicate the collected records

Each page is a new search against the current index, not a slice of a fixed snapshot, so a record can move between pages while you paginate. Collect every page in one pass and deduplicate on `bright_id` plus `source`. Do not re-fetch a single page later and expect the same records.

## Frequently asked questions

### Can I use meta.matched as the number of results?

No. `meta.matched` reports how many matches the search reached. Treat it as a lower bound rather than an exhaustive count, particularly for text and natural-language searches, and expect it to grow as `offset` grows. Do not use it to size a dataset or to tell users that exactly that many companies or people satisfy their intent.

### How do I collect more than 100 records from an Instant or Smart search?

Run the same conditions as a structured query in Ludicrous mode. Instant and Smart expose only the first 100 matches of a search, while Ludicrous pages up to `offset` 1,000. [Business Search query syntax](/products/business-search/query-syntax) lists the operators and searchable fields for the structured form.

### What does meta.coverage\_percent mean for a paginated set?

`meta.coverage_percent` reports the share of the index that answered the request. A value below 100 means the result set is partial, and a results page built on that response should say so. A value of 100 does not mean every relevant record was returned or every field was populated.

### Why did the same offset return different records?

Each page is a fresh search, and the index refreshes daily, so results and their order can change between requests. A record on page 1 of one run can appear on page 2 of the next. If your job needs a stable set, collect all pages in one pass and deduplicate as in step 4.


# People search
Source: https://docs.brightdata.com/products/business-search/people-search

Find people with Business Search. [POST /search/people](/api-reference/business-search/search-people) searches by title, current company, location and followers, in JSON or plain language.

This page shows the shape `query` takes in each mode, the fields a people search can filter on with the operator each accepts and what a request looks like.

People requests go to [`POST /search/people`](/api-reference/business-search/search-people). For companies, see [Company search](/products/business-search/company-search).

## Writing queries

The shape of `query` follows the [search mode](/products/business-search/introduction#search-modes):

* **Ludicrous** takes a JSON object of conditions on the [searchable fields](#searchable-fields), combined with `and`, `or` and `not`. Operators and value shapes are in [Business Search query syntax](/products/business-search/query-syntax).
* **Instant** and **Smart** take a plain-language sentence of up to 200 characters. Business Search turns the sentence into one structured query on the same fields. A sentence that asks for a job title is ranked on the title, role and about text together. A sentence that reads like a recruiting brief, with a role, an industry and a skill, is scored on the `role`, `company` and `skill` field groups independently.

## Searchable fields

The operator a field accepts depends on the field's type. Text fields accept only the `text` operator. Typed fields, such as strings and integers, accept `equals`, `in` and `range`. Sending `equals` to a text field returns HTTP 400.

| Field | Type | Operators | Notes |
| - | - | - | - |
| `current_title` | text | `text` | Use `mode: "all"` to require every word |
| `all_text` | text | `text` | Title, role and about together |
| `name` | text | `text` | |
| `about` | text | `text` | |
| `location` | text | `text` | Descriptive location string |
| `current_company_name` | text | `text` | |
| `current_company_industry` | text | `text` | |
| `past_job_titles` | text | `text` | |
| `past_company_names` | text | `text` | Employer names from past positions on the profile. See [example](/products/business-search/examples#how-to-find-people-by-a-past-employer) |
| `certification_names` | text | `text` | Certifications listed on the profile, for example `AWS` |
| `role`, `company`, `skill` | text | `text` | Each searches a group of fields: `role` covers `current_title`, `past_job_titles` and `about`; `company` covers `current_company_industry`, `specialties`, `description`, `slogan` and `name`; `skill` covers `about` and `certification_names` |
| `city` | string | `equals`, `in` | Exact city name |
| `country_code` | string | `equals`, `in` | ISO 3166 alpha-2 code such as `US` or `GB` |
| `followers` | integer | `range` | |

<Note>
  Location and employer fields can be missing from individual profiles, and a missing value is not evidence that the fact is false: a profile with no `current_company_name` publishes no employer. Handle absent or null values without failing the whole record, and avoid filters that silently drop every profile where an optional field is blank.
</Note>

<Note>
  A people search filters only on the fields in this table. Company attributes such as funding and headquarters are filters of [company search](/products/business-search/company-search#searchable-fields), so one request cannot find people by them. To find people at companies that match company filters, run a company search first, then a people search. See [How to run a multi-step search](/products/business-search/examples#how-to-run-a-multi-step-search).
</Note>

## Example request

<Tabs>
  <Tab title="Ludicrous">
    A Ludicrous request finds US profiles whose current title includes both `cloud` and `engineer` and whose certifications mention `AWS`, and names five output fields:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/people" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "current_title": { "value": "cloud engineer", "mode": "all" } } },
              { "equals": { "country_code": "US" } },
              { "text": { "certification_names": "AWS" } }
            ]
          },
          "offset": 0,
          "limit": 3,
          "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/people",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "ludicrous",
            "query": {
              "and": [
                { "text": { "current_title": { "value": "cloud engineer", "mode": "all" } } },
                { "equals": { "country_code": "US" } },
                { "text": { "certification_names": "AWS" } }
              ]
            },
            "offset": 0,
            "limit": 3,
            "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/people", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "ludicrous",
          "query": {
            "and": [
              { "text": { "current_title": { "value": "cloud engineer", "mode": "all" } } },
              { "equals": { "country_code": "US" } },
              { "text": { "certification_names": "AWS" } }
            ]
          },
          "offset": 0,
          "limit": 3,
          "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "r018d477cc83c4b159a0e025356c643c1",
      "source": "linkedin_people",
      "meta": {
        "coverage_percent": 100,
        "matched": 21,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "ab4836dd873d818b83aaf202941b81facbb622fa1525f7dc975c13fad913a0b7",
          "data": {
            "current_title": "Cloud Engineer",
            "country_code": "US",
            "experience_years": 3,
            "certification_names": "AWS Academy Graduate - AWS Academy Cloud Developing; AWS Academy Graduate - AWS Academy Data Analytics; AWS Certified Cloud Practitioner; AWS Certified Security – Specialty; AWS Certified Solutions Architect – Associate; AWS Certified Solutions Architect – Professional",
            "current_company_industry": "IT Services and IT Consulting"
          }
        }
      ]
    }
    ```

    `mode: "all"` inside the `text` condition requires every search word to match. The words do not need to form an exact phrase, so a title of "Cloud DevOps Engineer" still matches. Punctuation between the words does not prevent a match, word order does not matter and extra words in the title are allowed.
  </Tab>

  <Tab title="Instant">
    An Instant request asks for the same profiles in one sentence:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/people" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "instant",
          "query": "Cloud engineers in the United States with an AWS certification",
          "limit": 3,
          "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/people",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "instant",
            "query": "Cloud engineers in the United States with an AWS certification",
            "limit": 3,
            "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/people", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "instant",
          "query": "Cloud engineers in the United States with an AWS certification",
          "limit": 3,
          "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "r2290386e6db84503af080ba7c70b4cd7",
      "source": "linkedin_people",
      "meta": {
        "coverage_percent": 100,
        "matched": 24300,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "ab4836dd873d818b83aaf202941b81facbb622fa1525f7dc975c13fad913a0b7",
          "data": {
            "current_title": "Cloud Engineer",
            "country_code": "US",
            "experience_years": 3,
            "certification_names": "AWS Academy Graduate - AWS Academy Cloud Developing; AWS Academy Graduate - AWS Academy Data Analytics; AWS Certified Cloud Practitioner; AWS Certified Security – Specialty; AWS Certified Solutions Architect – Associate; AWS Certified Solutions Architect – Professional",
            "current_company_industry": "IT Services and IT Consulting"
          }
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Smart">
    A Smart request sends the same sentence and ranks the candidates by how well each record answers it:

    **Sample request**

    <CodeGroup>
      ```bash cURL highlight={5} theme={null}
      curl --request POST "https://api.brightdata.com/search/people" \
        --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
        --header "Content-Type: application/json" \
        --data '{
          "mode": "smart",
          "query": "Cloud engineers in the United States with an AWS certification",
          "limit": 3,
          "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
        }'
      ```

      ```python Python highlight={11} theme={null}
      import os
      import requests

      response = requests.post(
          "https://api.brightdata.com/search/people",
          headers={
              "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
              "Content-Type": "application/json",
          },
          json={
            "mode": "smart",
            "query": "Cloud engineers in the United States with an AWS certification",
            "limit": 3,
            "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
          },
      )
      print(response.text)
      ```

      ```javascript Node.js highlight={8} theme={null}
      const response = await fetch("https://api.brightdata.com/search/people", {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          "mode": "smart",
          "query": "Cloud engineers in the United States with an AWS certification",
          "limit": 3,
          "view": { "fields": ["current_title", "country_code", "experience_years", "certification_names", "current_company_industry"] }
        }),
      });
      console.log(await response.text());
      ```
    </CodeGroup>

    **Sample response**

    The first of the three returned records:

    ```json theme={null}
    {
      "req_id": "r98d1b462a2dd474e983cfd86fffbde99",
      "source": "linkedin_people",
      "meta": {
        "coverage_percent": 100,
        "matched": 24300,
        "offset": 0,
        "limit": 3
      },
      "documents": [
        {
          "bright_id": "4a2bd7ef9d05b88d53fb611c363808e740501a76ae8a654b5c3519791ff9ad0d",
          "data": {
            "current_title": "Senior Cloud Engineer",
            "country_code": "US",
            "experience_years": 5,
            "certification_names": "AWS Certified Data Analytics – Specialty; AWS Certified Database – Specialty; AWS Certified DevOps Engineer – Professional; AWS Certified Developer – Associate; AWS Certified Machine Learning - Specialty; AWS Certified Solutions Architect – Associate; AWS Certified Solutions Architect – Professional; Amazon Web Services Cloud Practitioner"
          }
        }
      ]
    }
    ```
  </Tab>
</Tabs>

For the fields each view returns and how `view` relates to `query`, see [Business Search field views](/products/business-search/select-fields).

For more tested requests, see [Business Search query examples](/products/business-search/examples).


# Business Search pricing
Source: https://docs.brightdata.com/products/business-search/pricing

Business Search costs 2 USD per 1,000 searches in Ludicrous or Instant mode, up to 100 results, 3 USD in Smart mode with 10. Rejected requests are not billed.

This page lists Business Search prices per mode, how results are counted and which requests are billable.

## What does each mode cost?

| Mode | Price per 1,000 searches | Results included per search |
| - | - | - |
| `ludicrous` | \$2 | 100 |
| `instant` | \$2 | 100 |
| `smart` | \$3 | 10 |

There is no separate per-record charge. Ludicrous and Instant carry the same rate today, but they are billed as separate modes.

`limit` is capped at 100 in Ludicrous and Instant and at 10 in Smart, which is the block size, so one request is one block.

## How is a search priced?

Business Search charges on the number of results you request, after defaults and validation are applied, not on the number of results that come back. Requesting 100 results and receiving 40 is billed as one block.

Results are billed in blocks. A block is 100 results in Ludicrous and Instant, and 10 results in Smart. Any part of a block counts as a whole block, so asking for fewer results than the block size does not cost less. Ten requests of `limit: 10` in Instant cost ten blocks; one request of `limit: 100` covering the same ground costs one.

Each page of a paginated search is a separate search, billed on the `limit` it requests. The `view` property does not change the price.

For paging with the largest `limit` the mode allows, see [How to paginate Business Search results](/products/business-search/pagination). For choosing between Smart, Instant and Ludicrous, see [Compare the modes](/products/business-search/introduction#compare-the-modes). For controlling which fields come back, see [Business Search field views](/products/business-search/select-fields).

## Which requests are billable?

Billable:

* A valid, completed search that returns a successful response
* A successful search that returns zero matches
* A successful search that returns fewer results than requested
* A Smart search whose ranking step fell back to Instant's ordering

Not billable:

* An invalid request rejected before the search runs
* An authentication or authorization failure
* A request rejected by the rate limit with HTTP 429
* A platform failure or an unsuccessful timeout
* An internal retry
* Duplicate delivery of the same usage event
* A cancellation made before the search begins

A zero-match search is billable because the search ran. A rejected request is not, because it never did. See [Business Search error codes](/products/business-search/error-codes) for how to tell the two apart in your own logging.

## Frequently asked questions

### Does Smart cost more than Instant?

Yes. Smart is \$3 per 1,000 searches against \$2 for Instant, and a Smart request returns up to 10 results where an Instant request returns up to 100.

### Does paging through results cost more?

Yes. Each page is a separate search and is billed on the `limit` it requests. Ten pages of 100 Ludicrous results bill 10 searches of one block each.

### Am I charged for a search that returns nothing?

Yes, when the search ran and returned HTTP 200 with an empty `documents` array. You are not charged when the request was rejected before execution.


# Business Search query syntax
Source: https://docs.brightdata.com/products/business-search/query-syntax

Business Search structured query reference: seven operators, and, or, not, equals, in, range and text, plus nesting and text matching rules.

A Bright Data Business Search structured query is the JSON object passed as `query` when `mode` is `ludicrous`. The query uses seven operators. `equals`, `in`, `range` and `text` each take a field name and a value and produce one condition. `and`, `or` and `not` take conditions and combine them.

This page describes each operator's value shape, how operators nest, which operators each field type accepts and the validation errors a malformed query returns. Field names are listed on [Company search](/products/business-search/company-search#searchable-fields) and [People search](/products/business-search/people-search#searchable-fields).

## Which operators does a structured query accept?

| Operator | Value shape | Meaning | Example |
| - | - | - | - |
| `and` | Array of conditions | All child conditions must match | `{ "and": [ ... ] }` |
| `or` | Array of conditions | At least one child condition must match | `{ "or": [ ... ] }` |
| `not` | One condition | Exclude records that match the child condition | `{ "not": { "equals": { "organization_type": "Educational" } } }` |
| `equals` | Field name and one scalar | Match an exact value on a typed field | `{ "equals": { "headquarters_country_code": "US" } }` |
| `in` | Field name and an array | Match any value in the list on a typed field | `{ "in": { "headquarters_country_code": ["US", "GB"] } }` |
| `range` | Field name and an object with `>`, `>=`, `<` or `<=` | Match numeric bounds on a typed field | `{ "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }` |
| `text` | Field name and a string, or an object with `value`, `mode` and `top-k` | Match words in a text field | `{ "text": { "current_title": { "value": "product manager", "mode": "all" } } }` |

`and`, `or` and `not` take conditions as children. `equals`, `in`, `range` and `text` take a field name and a value. The `text` example uses `current_title`, a people field. The other examples use company fields.

## How do you combine conditions?

Logical operators nest. In the request below, an `or` condition is a child of `and`. This company request matches software or technology companies in the US or GB, excluding records whose organization type is `Educational`. The highlighted lines are the `query` object:

<CodeGroup>
  ```bash cURL highlight={6-17} theme={null}
  curl --request POST "https://api.brightdata.com/search/company" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "mode": "ludicrous",
      "query": {
        "and": [
          {
            "or": [
              { "text": { "industry": "software" } },
              { "text": { "industry": "technology" } }
            ]
          },
          { "in": { "headquarters_country_code": ["US", "GB"] } },
          { "not": { "equals": { "organization_type": "Educational" } } }
        ]
      },
      "limit": 3,
      "view": "summary"
    }'
  ```

  ```python Python highlight={12-23} theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/company",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
        "mode": "ludicrous",
        "query": {
          "and": [
            {
              "or": [
                { "text": { "industry": "software" } },
                { "text": { "industry": "technology" } }
              ]
            },
            { "in": { "headquarters_country_code": ["US", "GB"] } },
            { "not": { "equals": { "organization_type": "Educational" } } }
          ]
        },
        "limit": 3,
        "view": "summary"
      },
  )
  print(response.text)
  ```

  ```javascript Node.js highlight={9-20} theme={null}
  const response = await fetch("https://api.brightdata.com/search/company", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "mode": "ludicrous",
      "query": {
        "and": [
          {
            "or": [
              { "text": { "industry": "software" } },
              { "text": { "industry": "technology" } }
            ]
          },
          { "in": { "headquarters_country_code": ["US", "GB"] } },
          { "not": { "equals": { "organization_type": "Educational" } } }
        ]
      },
      "limit": 3,
      "view": "summary"
    }),
  });
  console.log(await response.text());
  ```
</CodeGroup>

`in` on one field matches the same records as an `or` of `equals` conditions on that field.

## How does text matching work?

A `text` condition contains a string, as in the company request above, or an object with `value` and `mode`. `mode: "all"` requires every word in `value` to appear in the field, in any order and position. This people request matches titles containing all of `machine`, `learning` and `engineer`:

<CodeGroup>
  ```bash cURL highlight={6-13} theme={null}
  curl --request POST "https://api.brightdata.com/search/people" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "mode": "ludicrous",
      "query": {
        "text": {
          "current_title": {
            "value": "machine learning engineer",
            "mode": "all"
          }
        }
      },
      "limit": 3,
      "view": "summary"
    }'
  ```

  ```python Python highlight={12-19} theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/people",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
        "mode": "ludicrous",
        "query": {
          "text": {
            "current_title": {
              "value": "machine learning engineer",
              "mode": "all"
            }
          }
        },
        "limit": 3,
        "view": "summary"
      },
  )
  print(response.text)
  ```

  ```javascript Node.js highlight={9-16} theme={null}
  const response = await fetch("https://api.brightdata.com/search/people", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "mode": "ludicrous",
      "query": {
        "text": {
          "current_title": {
            "value": "machine learning engineer",
            "mode": "all"
          }
        }
      },
      "limit": 3,
      "view": "summary"
    }),
  });
  console.log(await response.text());
  ```
</CodeGroup>

`mode` takes one of these values. No mode matches an exact phrase:

| Mode | Behavior |
| - | - |
| `top-bm25` | Default. BM25-ranked partial matches |
| `all` | Every search word must match |
| `any` | Any search word may match |

`top-k` caps how many candidate records the text condition retrieves, 100 by default.

## How do you express a numeric bound?

`range` takes a field name and one or two comparison keys. Two keys give a closed interval. This company request matches 50 to 500 employees on record:

<CodeGroup>
  ```bash cURL highlight={6-10} theme={null}
  curl --request POST "https://api.brightdata.com/search/company" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "mode": "ludicrous",
      "query": {
        "range": {
          "employees_in_linkedin": { ">=": 50, "<=": 500 }
        }
      },
      "limit": 3,
      "view": "summary"
    }'
  ```

  ```python Python highlight={12-16} theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/company",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
        "mode": "ludicrous",
        "query": {
          "range": {
            "employees_in_linkedin": { ">=": 50, "<=": 500 }
          }
        },
        "limit": 3,
        "view": "summary"
      },
  )
  print(response.text)
  ```

  ```javascript Node.js highlight={9-13} theme={null}
  const response = await fetch("https://api.brightdata.com/search/company", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      "mode": "ludicrous",
      "query": {
        "range": {
          "employees_in_linkedin": { ">=": 50, "<=": 500 }
        }
      },
      "limit": 3,
      "view": "summary"
    }),
  });
  console.log(await response.text());
  ```
</CodeGroup>

One key gives an open bound, such as `{ "followers": { ">=": 1000 } }`.

## Which operators does each field type accept?

The operator a field accepts depends on the field type. Sending an operator the type does not support returns HTTP 400 with a message naming the field, the operator and the types the operator supports.

| Field type | Example fields | Operators accepted | Example rejection |
| - | - | - | - |
| Text | `industry`, `current_title` | `text` | `equals` on `industry` returns `Operator does not support field type 'text'` |
| Typed (string, number) | `headquarters_country_code`, `city`, `employees_in_linkedin`, `followers` | `equals`, `in`, `range` | `text` on `headquarters_country_code` returns `Operator does not support field type 'string'. Supported types: text` |

Field names differ by category. The full lists are on [Company search](/products/business-search/company-search#searchable-fields) and [People search](/products/business-search/people-search#searchable-fields). A field that appears in `view` output is not necessarily searchable: people `connections` is returned in `summary` but cannot be used in a `range` condition.

## Which queries are rejected?

Business Search validates the request before running a search. A rejected request returns HTTP 400 with a message naming the property at fault. The request is not searched and not billed.

| Rule | What happens |
| - | - |
| `query` must be an object in Ludicrous and a string in Instant and Smart | HTTP 400: `request: "query" must be of type object` or `request: "query" must be a string` |
| `equals`, `in` and `range` work only on typed fields | HTTP 400: `Operator does not support field type 'text'` |
| `text` works only on text fields | HTTP 400: `Operator does not support field type 'string'. Supported types: text` |
| `mode` inside `text` must be an accepted value | HTTP 400 listing the accepted values |

Rejections outside the `query` object, such as an invalid `limit`, an unknown `view` field or a natural-language query longer than 200 characters, are listed under [Why was a request rejected?](/products/business-search/error-codes#why-was-a-request-rejected) on the Business Search error codes page.

## Frequently asked questions

### Does the query object change between company and people searches?

The operators are identical. The field names are not. The company category uses `industry`, `headquarters_country_code` and `linkedin_followers`. The people category uses `current_title`, `country_code` and `followers`. See [Company search](/products/business-search/company-search) and [People search](/products/business-search/people-search).

### Can I use a structured query with Instant or Smart mode?

No. `ludicrous` takes a structured object, and `instant` and `smart` take a natural-language string. A mismatch is rejected with HTTP 400: an object in Instant returns `request: "query" must be a string`, and a string in Ludicrous returns `request: "query" must be of type object`. See [What is Business Search?](/products/business-search/introduction#search-modes).

## Related

* [Company search](/products/business-search/company-search)
* [People search](/products/business-search/people-search)
* [Business Search field views](/products/business-search/select-fields)
* [Business Search error codes](/products/business-search/error-codes)
* [What is Business Search?](/products/business-search/introduction)


# Business Search quickstart
Source: https://docs.brightdata.com/products/business-search/quickstart

Send your first Business Search request. One [POST /search/company](/api-reference/business-search/search-company) call in Instant mode returns up to 10 records with req_id and meta.

In this quickstart we run one company search with cURL, Python or Node.js and read the three parts of the response: `req_id`, `meta` and `documents`.

## Prerequisites

* A Bright Data account with Business Search access. Business Search is in early access; if you don't have access, email [sales@brightdata.com](mailto:sales@brightdata.com)

## Step 1: Get and set your API key

Go to the [user settings page](https://brightdata.com/cp/setting/users) in your Bright Data account and create an API key, or use one you already have. Your API key is shown only once when created, so copy and store it securely. See [Authentication](/api-reference/authentication).

We store the key in an environment variable so it never appears in a command history or a committed file. The request in the next step reads it from there:

```bash theme={null}
export BRIGHTDATA_API_KEY="YOUR_API_KEY"
```

## Step 2: Send a company search

We use [Instant mode](/products/business-search/introduction#search-modes) to find US software companies with 50 to 500 employees. `view: "summary"` asks for a compact record instead of the default `id_only`:

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST "https://api.brightdata.com/search/company" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "source": "linkedin_company",
      "mode": "instant",
      "query": "US software companies with 50 to 500 employees",
      "offset": 0,
      "limit": 10,
      "view": "summary"
    }'
  ```

  ```python Python theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/company",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
          "source": "linkedin_company",
          "mode": "instant",
          "query": "US software companies with 50 to 500 employees",
          "offset": 0,
          "limit": 10,
          "view": "summary",
      },
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.brightdata.com/search/company", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      source: "linkedin_company",
      mode: "instant",
      query: "US software companies with 50 to 500 employees",
      offset: 0,
      limit: 10,
      view: "summary",
    }),
  });

  console.log(await response.text());
  ```
</CodeGroup>

The request returns HTTP 200 and a JSON body that starts with `req_id`. Every tab prints that body.

If the body is `{"error":"Invalid token"}` with HTTP 401, the key is missing, invalid or expired. Check the value you exported in Step 1. HTTP 403 means the account behind the key is inactive or not on the Business Search allowlist yet. Email [sales@brightdata.com](mailto:sales@brightdata.com) to request access.

## Step 3: Read the response

A successful response contains request metadata and a `documents` array. This is the first of the 10 records from a real run, with `url` and `logo` omitted:

```json theme={null}
{
  "req_id": "ra7672a1925f744ebb592ec88b9f6bbf1",
  "source": "linkedin_company",
  "meta": {
    "coverage_percent": 100,
    "matched": 605,
    "offset": 0,
    "limit": 10
  },
  "documents": [
    {
      "bright_id": "7b8d489b82344beae097e05cddfcf1da56ed51e37fab6fc64b2ca58e7b0713bd",
      "data": {
        "name": "SourceForge",
        "slogan": "The complete software platform. SourceForge is the largest B2B software review and comparison directory in the world.",
        "industry": "Software Development",
        "headquarters_location": "San Diego, California",
        "headquarters_country_code": "US",
        "offices_cities": ["San Diego"],
        "company_size_from": 51,
        "company_size_to": 200,
        "employees_in_linkedin": 59,
        "linkedin_followers": 39183,
        "website": "https://sourceforge.net/",
        "domain": "sourceforge.net"
      }
    }
  ]
}
```

Your `req_id`, `matched` count and records will differ from this sample. The index refreshes daily, so results move between runs.

`req_id` identifies the request. Keep it for troubleshooting and include it in support tickets.

How to read what came back:

* An empty `documents` array means the search ran and matched nothing. It is not proof that no such company exists.
* `meta.matched` is a lower bound on the matches the search reached, not a total, and it moves between runs.
* `meta.coverage_percent` below 100 means part of the index did not answer in time, so the result set is partial.

## What you built and where to go next

We sent a natural-language company search and read the records it returned. Next, decide whether you need a broad candidate set or a ranked shortlist in [What is Business Search?](/products/business-search/introduction#search-modes). Then write your first structured query with [Business Search query syntax](/products/business-search/query-syntax).


# Business Search field views
Source: https://docs.brightdata.com/products/business-search/select-fields

Choose what each Business Search record returns: id_only, summary, full or a custom list, the stored fields per entity type and the values rejected.

The `view` property of a Business Search request controls which stored fields appear in each result's `data` object. The property is part of the request body for each entity type.

## Which values does view accept?

| View | Returned data |
| - | - |
| `id_only` | Identifiers only: `company_id` and `linkedin_id` for companies, `linkedin_num_id` and `linkedin_person_id` for people |
| `summary` | A compact category-specific record: 14 fields for companies, 11 for people |
| `full` | Every released field: 30 for companies, 36 for people |
| `{ "fields": [...] }` | Only the named released fields |

`id_only` is the default and returns identifiers rather than descriptive fields.

The `fields` object has one required property, `fields`, an array of released field names. Any field in the company or people table on this page is a released field. This request returns eight company fields per record:

<CodeGroup>
  ```bash cURL highlight={17} theme={null}
  curl --request POST "https://api.brightdata.com/search/company" \
    --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "source": "linkedin_company",
      "mode": "ludicrous",
      "query": {
        "and": [
          { "text": { "industry": "software" } },
          { "equals": { "headquarters_country_code": "US" } },
          { "range": { "employees_in_linkedin": { ">=": 50, "<=": 500 } } }
        ]
      },
      "offset": 0,
      "limit": 10,
      "view": {
        "fields": ["name", "website", "industry", "headquarters_country_code", "employees_in_linkedin", "founded_year", "linkedin_followers", "url"]
      }
    }'
  ```

  ```python Python highlight={23} theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.brightdata.com/search/company",
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json={
          "source": "linkedin_company",
          "mode": "ludicrous",
          "query": {
              "and": [
                  {"text": {"industry": "software"}},
                  {"equals": {"headquarters_country_code": "US"}},
                  {"range": {"employees_in_linkedin": {">=": 50, "<=": 500}}},
              ]
          },
          "offset": 0,
          "limit": 10,
          "view": {
              "fields": ["name", "website", "industry", "headquarters_country_code", "employees_in_linkedin", "founded_year", "linkedin_followers", "url"]
          },
      },
  )

  print(response.text)
  ```

  ```javascript Node.js highlight={20} theme={null}
  const response = await fetch("https://api.brightdata.com/search/company", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      source: "linkedin_company",
      mode: "ludicrous",
      query: {
        and: [
          { text: { industry: "software" } },
          { equals: { headquarters_country_code: "US" } },
          { range: { employees_in_linkedin: { ">=": 50, "<=": 500 } } },
        ],
      },
      offset: 0,
      limit: 10,
      view: {
        fields: ["name", "website", "industry", "headquarters_country_code", "employees_in_linkedin", "founded_year", "linkedin_followers", "url"],
      },
    }),
  });

  console.log(await response.text());
  ```
</CodeGroup>

The array can name fields from any view, so `founded_year`, which `summary` leaves out, can be returned without requesting `full`.

## Which fields does each view return for companies?

| Field | `id_only` | `summary` | `full` |
| - | - | - | - |
| `company_id` | Yes | - | - |
| `linkedin_id` | Yes | - | Yes |
| `name` | - | Yes | Yes |
| `slogan` | - | Yes | Yes |
| `industry` | - | Yes | Yes |
| `headquarters_location` | - | Yes | Yes |
| `headquarters_country_code` | - | Yes | Yes |
| `offices_cities` | - | Yes | Yes |
| `company_size_from` | - | Yes | Yes |
| `company_size_to` | - | Yes | Yes |
| `employees_in_linkedin` | - | Yes | Yes |
| `linkedin_followers` | - | Yes | Yes |
| `website` | - | Yes | Yes |
| `domain` | - | Yes | Yes |
| `url` | - | Yes | Yes |
| `logo` | - | Yes | Yes |
| `about` | - | - | Yes |
| `specialties` | - | - | Yes |
| `organization_type` | - | - | Yes |
| `founded_year` | - | - | Yes |
| `headquarters_city` | - | - | Yes |
| `offices_country_codes` | - | - | Yes |
| `alumni_count` | - | - | Yes |
| `linkedin_follower_to_employee_ratio` | - | - | Yes |
| `funding_stage` | - | - | Yes |
| `funding_raised` | - | - | Yes |
| `investor_names` | - | - | Yes |
| `similar_company_ids` | - | - | Yes |
| `affiliated_company_ids` | - | - | Yes |
| `crunchbase_id` | - | - | Yes |
| `image` | - | - | Yes |

## Which fields does each view return for people?

| Field | `id_only` | `summary` | `full` |
| - | - | - | - |
| `linkedin_num_id` | Yes | - | Yes |
| `linkedin_person_id` | Yes | - | Yes |
| `name` | - | Yes | Yes |
| `current_title` | - | Yes | Yes |
| `current_company_name` | - | Yes | Yes |
| `current_company_industry` | - | Yes | Yes |
| `location` | - | Yes | Yes |
| `city` | - | Yes | Yes |
| `country_code` | - | Yes | Yes |
| `followers` | - | Yes | Yes |
| `connections` | - | Yes | Yes |
| `url` | - | Yes | Yes |
| `avatar` | - | Yes | Yes |
| `first_name` | - | - | Yes |
| `about` | - | - | Yes |
| `recommendations_count` | - | - | Yes |
| `influencer` | - | - | Yes |
| `patent_count` | - | - | Yes |
| `current_tenure_months` | - | - | Yes |
| `experience_years` | - | - | Yes |
| `past_job_titles` | - | - | Yes |
| `past_company_names` | - | - | Yes |
| `past_company_ids` | - | - | Yes |
| `education_schools` | - | - | Yes |
| `education_details` | - | - | Yes |
| `certification_names` | - | - | Yes |
| `languages` | - | - | Yes |
| `current_company_id` | - | - | Yes |
| `current_company_specialties` | - | - | Yes |
| `current_company_country_code` | - | - | Yes |
| `current_company_size_from` | - | - | Yes |
| `current_company_size_to` | - | - | Yes |
| `current_company_funding_stage` | - | - | Yes |
| `current_company_funding_raised` | - | - | Yes |
| `similar_profile_ids` | - | - | Yes |
| `also_viewed_ids` | - | - | Yes |

A field the record has no value for is left out of `data` rather than returned as null. Two records from the same request can carry different keys, and a `full` record usually carries fewer keys than the table lists. `bright_id` is an envelope field beside `data` on every record and is not selected through `view`.

## Which view values are rejected?

Business Search rejects an unknown view name or an unreleased field name with HTTP 400. The `error` property names the rejected value:

| Sent value | Error |
| - | - |
| `"view": "bogus_view"` | `view: unknown view profile "bogus_view"` |
| `"view": { "fields": ["not_a_released_field"] }` | `view: unknown field(s): not_a_released_field` |

The other request body rejections are listed in [Business Search error codes](/products/business-search/error-codes#why-was-a-request-rejected).

<Warning>
  A field you select for output does not become a search condition. Requesting `founded_year` in `view` does not exclude companies that have no founding year on record.
</Warning>


# How to configure your Datacenter proxy
Source: https://docs.brightdata.com/products/data-center/configure-your-proxy

Configure your datacenter proxy settings across 195 countries, select IP types, set geolocation targeting and enable advanced features in this guide.

To access your proxy configuration, open your zone in the "Configuration" tab.

## Which IP type to choose

Bright Data offers 3 types of datacenter proxies:

<Card title="Shared" icon="square-1">
  A rotating proxy over a pool of \~40,000 proxies, paid by usage GBs.
</Card>

<Card title="Shared unlimited" icon="square-2">
  A set of specific proxies, shared with others, with unlimited bandwidth, paid by proxy.
</Card>

<Card title="Dedicated unlimited" icon="square-3">
  A set of specific proxies, exlcusive for you, with unlimited bandwidth, paid by proxy.
</Card>

## Shared (rotating) proxy configuration

### Default countries selection

When selecting countries in shared pool configuration, we will assign proxies only from the countries you select. You can select none (which meand we will assign the next random proxy from the pool), one or more countries. [Read more...](/api-reference/proxy/geolocation-targeting#default-countries-selection)

To select a specific country for your peer during rotation, use the flag -country in the proxy user name parameter with an ISO-3166 country code.

[FAQ: Where can I see the list of country codes?](/general/faqs#where-can-i-see-the-list-of-country-codes)

## Shared & Dedicated unlimited proxy configuration

### Number of IPs

<Tip>
  For unlimited proxies we offer a discount based on amount of proxies you purchase per zone. The more you buy, less your pay per proxy. Click on the "Show rates" link in your zone setup to see rates.
</Tip>

Number of IPs to be allocated as your pool of available IPs.

### How to select a country

Geolocation targeting allows you to target specific `Country`.
Select the preferred countries from the drop-down menu.

Once selected, we will assign proxies from those countries. If we do not have enough proxies to cover your requirement, we will assign the amount we have and you can submit an order for the full amount of proxies (we do not allow single proxy orders - we will take in large orders only).
Changing this selection means re-allocating proxies, which will incur a **Refresh charge** .

### How does multiple countries selection work?

If you select multiple countries, we assign proxies in **available countries** at the moment of assignment. For example: if you choose proxies from Germany, France & Italy, we will provide proxies from **either** of these countries. We will try to distribute the assignment evenly across the countries you selected, yet if there are not enough proxies in one of the countries, some countries will have more proxies than other.

So referring to that example, if you request 30 proxies from Germany, France & Italy and we have only 6 available proxies in Italy you will get: 12 proxies from Germany, 12 from France and 6 from Italy.

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

### How to change your country selection

It is possible to change the country you selected for your proxies. Once you change the country, Bright Data will assign new proxies from the selected countries. Since this is a replacement of proxy you will recieve a new IP.

Changing country is similar to IP refresh action and is charged the same.

## Access your allocated Proxies' IP addresses

In all proxy types, you can download, view and copy to clipboard the IPs allocated to you by following these steps:

1. Navigate to the [Zones page](https://brightdata.com/cp/zones).
2. Select a zone with allocated IPs.
3. In the overview tab click 'Download', 'View' or 'Copy'.

<img alt="your-proxy-list" />

***

## How to configure advanced options

### How to enable automatic failover

In case we cannot reach the proxy peer for your request, we will route the request to another available peer. Automatic failover does not apply when you choose default countries: if we cannot find a peer in the country you selected, we will fail the request with error.

Enabling automatic failover assures execution of the request, regardless of the availability of a specific peer.

***

### Special Ports & Protocols

Ports `80` and `443` are available by default, supporting HTTP and HTTPS & SOCKS5 protocols. We also support all ports over `1024` in our Datacenter proxy network. [Read more on ports and protocols...](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)

<Accordion title="Request Additional ports">
  Bright Data can support additional ports by request. A dedicated and additional compliance process with the Bright Data compliance team will follow every request to support a new port.
  If you would like additional port permissions, you can contact Bright Data Support.
  Examples of ports that require Bright Data compliance review before activation:

  | Port | Protocol |
  | - | - |
  | `70` | HTTP |
  | `98` | HTTPS |
</Accordion>

### Zone usage limit

Set usage limit to your zone: you can limit spending or traffic. This provides additional layer of control to your budget and bandwidth consumption, mostly over our rotating shared pool proxies.


# Datacenter proxy FAQ
Source: https://docs.brightdata.com/products/data-center/faqs

FAQs about Bright Data Datacenter proxies (195 countries): IP types, shared and dedicated pools, geotargeting, error codes and pricing across plans.

<AccordionGroup>
  <Accordion title="What are IP Types for Datacenter?">
    There are three types of IPs that we offer within our [Datacenter Proxy Network](https://brightdata.com/proxy-types/datacenter-proxies):

    1. Shared pool (paid per usage) - Pool of 40,000 rotating proxies
    2. Shared unlimited proxies (paid per proxy) - Set of proxies you share with others.
    3. Dedicated unlimited proxies (paid per proxy) - Set of proxies exclusive for you.
  </Accordion>

  <Accordion title="What are IP Types for ISP?">
    There are three types of IPs that we offer within our [ISP Proxy Network](https://brightdata.com/proxy-types/isp-proxies):

    1. Shared pool (paid per usage) - Pool of 10,000 rotating proxies
    2. Shared unlimited proxies (paid per proxy) - Set of proxies you share with others.
    3. Dedicated unlimited proxies (paid per proxy) - Set of proxies exclusive for you.
  </Accordion>

  <Accordion title="How to integrate a new proxy into your code?">
    To integrate the proxies into your code, please visit the [API examples page](https://brightdata.com/cp/zones/proxy_examples), which can be accessed via your proxy's settings:

    <img alt="integrate-new-proxy.gif" />

    On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
  </Accordion>

  <Accordion title="How to integrate a proxy into 3rd party software?">
    Check out a few examples in the [API examples](https://brightdata.com/cp/zones/proxy_examples) page mentioned above (just choose "other software" in the "language" drop-down menu), or check our [Integrations page](/integrations/introduction), where we have specific guides to integrate our proxies within the most popular tools across the industry today.

    **Important note**: If you are using Bright Data's Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See [instructions here](/general/account/ssl-certificate).
  </Accordion>

  <Accordion title="How to target a Specific Country?">
    When sending your request, add the `-country` flag, **after** your zone’s name in the request, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    In the example below: We added `-country-us` to our request, so we will send a request originating from the United States ("us").

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>
    ```
  </Accordion>

  <Accordion title="How to target a Specific City in datacenter and ISP proxy networks?">
    For datacenter and ISP networks city targeting has been deprecated and is no longer available.
  </Accordion>

  <Accordion title="Where does Bright Data have proxies?">
    Bright Data offers proxies in every country in the world, except in the following countries:

    * Iran
    * Iraq
    * Syria
    * Lebanon
    * Palestine
    * North Korea
    * Cuba
    * Sudan
    * Belarus
    * Russia

    If you need proxies from these countries, unfortunately Bright Data will not be able to help you.
  </Accordion>

  <Accordion title="How to view the proxy event log?">
    The event log will show you (at most) the last 200 requests you made with any zone in your account.

    In your Bright Data control panel's proxies page: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    Go to the "Event Log" tab:

    <img alt="event-log.png" />

    The presented data is:

    * **Date:** Time and date of the request
    * **Name:** What Zone was used for the request
    * **Source IP:** What IP the request was made from
    * **URL:** The target site of the request
    * **Authentication:** Success or Fail of the request

      <img alt="event-log-headers.png" />
  </Accordion>

  <Accordion title="How to enable automatic IP fallbacks? (formerly 100% uptime)">
    <Info>
      Applicable for Datacenter & ISP
    </Info>

    The **Automatic Failover** was built to prevent any ‘external’ events from affecting the user. The idea is simple and works the same way for both problems described above – if Bright Data detects a problem, like a connectivity issue or an IP where the GEO isn’t exactly what you asked for when buying that IP, we will automatically route your requests through other IPs which are exactly the same as the original IPs.

    At the same time, we wanted to make sure that customers that must use specific IPs will not be affected – so we made some exceptions:

    * If a specific IP is targeted in your request we will not assign a fallback IP to it
    * Automatic Failover will not interrupt a live connection. If the fallback is needed, it will play in once the next connection is established

    The **Automatic Failover** brings immediate value by providing 100% connectivity and continuous high-performance level, **free of charge and without having to make any changes in your code or how you work.**

    <Note>
      Automatic Failover feature can be turned on or off, [via API](/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone).
    </Note>
  </Accordion>

  <Accordion title="How to enable Automatic Failover for proxies?">
    Navigate to your proxy configuration settings, and under **Advanced settings** enable **‘Automatic failover’**
  </Accordion>

  <Accordion title="How to keep using the same IP in multiple requests?">
    * This can be done by adding the session flag to the proxy username:

    ```sh theme={null}
    brd.superproxy.io:44445 brd-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.

    * Session ID can be any random string/counter: requests with the same session string will use the same Proxy Peer (as long as possible); requests with different session strings will be assigned different Proxy Peers.
    * To force an IP change, just modify the session ID
    * If an assigned Proxy Peer(exit node IP) becomes unavailable, the Super Proxy will return an error "502 - No peers available" for the first request and then on the second request the super proxy will assign a new peer even if you do not change the session ID.
    * The Session IP is kept persistent for up to 1 minute of idle time. After a minute with no requests, the IP is released back to the pool.\
      To keep this Session/IP for longer, send a tiny keep-alive request every 30 seconds, to prevent this session from becoming idle for over a minute.\
      This request may be anything small, such as /favicon.ico, or even a request that returns 404 (as long as the web server does not disconnect the socket due to this request).
    * If you have multiple Clients and would like to ignore your Clients source IP (which is used together with your session ID to create a session), then you want to use a global session then add `glob\_` as a prefix to your session:

    ```sh theme={null}
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    Full request example:

    ```sh theme={null}
    brd-customer-CXXXXX-zone-ZONE_X-session-glob_rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.
  </Accordion>

  <Accordion title="How to see supported Ports & Protocols?">
    Ports 80 and 443 are available by default in all zones, supporting HTTP and HTTPS protocols.

    In zones of proxies of type Datacenter or ISP, all ports higher than 1024 are supported by default.

    In zones of proxies of type Residential or Mobile, the following ports will be available by default: 8080, 8443, 5678, 1962, 2000, 4443, 4433, 4430, 4444 and 1969.

    Bright Data can support additional ports by request. Every request to support a new port will be followed by a dedicated and additional compliance process with the Bright Data compliance team.\
    Examples of ports that require Bright Data compliance review before activation:

    | Port | Protocol |
    | - | - |
    | 8443 | HTTP |
    | 8243 | HTTPS |

    To make a request to add a port permission to your zone:

    * Go to your zone's settings (it will open on the "configuration" tab by default, if not, please click it)
    * Scroll down to "Advanced settings" and click it
    * Enable "Special ports"
    * Input the port numbers you would like to get approved
    * Fill out the form and wait for our compliance team to contact you and approve the request

      <img alt="add-ports.gif" />
  </Accordion>

  <Accordion title="How to target specific OS?">
    Bright Data allows targeting the following **Operating Systems**:

    <CodeGroup>
      ```sh Windows theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh macOS theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh Android theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to refresh IPs Allocated to Your Zone?">
    If you've selected 'Pay per IP' shared, or a dedicated IP type in your zone configuration, you'll be allocated a fixed IP address. From time to time, depending on your use case, you may need to refresh these IP addresses.

    In order to refresh IPs allocated to your zone, navigate to your selected zone, under **'Allocated IPs'** click on **'Show allocated IPs'**, **check the box** of the IP or gIP you wish to refresh and click **'Refresh'**

    <img alt="refresh-ips.gif" />

    <Note>
      Refreshing an IP or gIP will result in an extra charge.
    </Note>

    Alternatively, you can use API to refresh your [dedicated Residential IPs](/api-reference/account-management-api/Refresh_dedicated_residential_IPs) or your [Datacenter/ISP IPs](/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs)
  </Accordion>

  <Accordion title="How to use a specific IP?">
    When using Bright Data's Residential Proxy network, you may find the need to use a specific IP allocated to your zone.

    1. **Send a test request** with a '--verbose' or '-v' option added (this will turn on verbose logging)

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --verbose --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    1. **Locate** the x-brd-ip response header and copy its value

       <img alt="x-brd-ip.png" />

    2. **Add** the -ip- flag to your request, after your zone’s name and use the **hashed IP value** copied in the previous step

    3. Send a test request, and **review the response**

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://brdtest.com/myip.json](https://brdtest.com/myip.json) as the target domain for testing, and to review your IP credentials.
  </Accordion>

  <Accordion title="How to target an ASN specific IP?">
    ASN targeting is available for Residential zones only; it is not supported on Datacenter or ISP zones. For Residential zones, it can be enabled by adding the ASN parameter to your Zone configuration, under **Geolocation Targeting**.

    <img alt="asn-targeting.png" />

    Once the configuration is saved, the ASN flag can be added to the Zone's credentials\
    and be integrated when using the Residential proxies. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **Note:** Values for ASN number can be found [here](https://bgp.potaroo.net/cidr/autnums.html).
  </Accordion>

  <Accordion title="How to Target Residential IP groups (gIPs)?">
    Dedicated Residential IPs can be selected in the form of [gIPs](/products/residential/configure-your-proxy#ip-groups-gips). They can be allocated under the zone’s “Configure Proxy” page by selecting a “Dedicated” IP type and choosing a number of gIPs. Also, targeting a specific domain is required.

    <img alt="number-of-dedicated-gIPs.png" />

    Once the configuration is saved, selecting "Show allocated Dedicated residential IPs" will provide a list of hash values that represent group IPs.

    <img alt="show-allocated-dedicated-ips.png" />

    These values can be used to target a specific gip. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese Residentials IPs">
    **When outside of China**\
    Targeting Chinese Residential IP peers is enough:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="Carrier-specific Proxy peer IP">
    * You can choose to use a specific carrier from this list:

    ```text theme={null}
    a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, 
    dt, docomo, dtac, etisalat, idea,  meo, mtn, mtnza, 
    optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, 
    tmobile, tigo, tim, verizon,  vodacomza, vodafone, vivo, zain,
    vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, 
    cellc, ooredoo, drei, umobile, cableone, proximus, mobitel, o2, 
    bouygues, free, sfr, digicel
    ```

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="About geolocation databases, and how to check the proxy IP information?">
    Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records of the 4 main GeoDBs used today: Maxmind, ip2location, db-ip and Google.

    There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them. Therefore, we highly recommend using the GeoDBs mentioned above when testing your IPs.

    In order to see our information about the proxy IP that you are using, browse one of the following:

    * [https://brdtest.com/echo.json](https://brdtest.com/echo.json)
    * [https://www.iplocation.net](https://www.iplocation.net)
    * [https://www.maxmind.com/en/geoip-demo](https://www.maxmind.com/en/geoip-demo)
  </Accordion>

  <Accordion title="Which Bright Data products are best for scraping search engines (SERPs)?">
    #### For single-step scraping:

    [SERP API](/products/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.

    #### For multi-step scraping (playwright/puppeteer/selenium):

    [Browser API](/products/scraping-browser/introduction) is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
  </Accordion>

  <Accordion title="Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?">
    **Residential Proxy** - No, [SERP API](/products/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will cause the request to be sent from our servers instead of the peer.

    **Datacenter & ISP Proxies** - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:

    ```text theme={null}
    HTTP/1.1 403 Search engine host is not allowed
    X-Luminati-Error: Forbidden: This target URL isn't supported on proxy networks, use the SERP API product for targeting this URL. You may contact your account manager or open a support ticket for assistance
    ```
  </Accordion>

  <Accordion title="Can I Send requests to IPs and not domain name?">
    No - requests directly to the host server, and not to the domain name are forbidden while using Bright data.\
    Requests using URL format such as 1.1.1.1:443 will be executed using the super proxy server, not the proxy peer IP.

    Example of a request using the super proxy:

    <img alt="x-luminati-ip.png" />
  </Accordion>

  <Accordion title="Can I use port 25 or any other SMTP port, or send an email by using the proxy IP?">
    Since BrightData cares about our community and peers quality, SMTP requests which can be used for spamming are blocked. Please note that mail domains are also blocked from access, and requests to mail domains will be sent from the super proxy server, and not the peer IP.
  </Accordion>

  <Accordion title="What is the cost for refreshing Datacenter IPs?">
    Refreshing data-center IPs will have a different cost depending on the type of IP.

    * Refreshing dedicated data-center IPs: \$0.5/refresh/IP
    * Refreshing dedicated domain data-center IPs: \$0.04/refresh/IP
    * Refreshing shared data-center IPs: \$0.02/refresh/IP
  </Accordion>

  <Accordion title="Does Bright Data support the Socks5 protocol?">
    Yes. Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    See here for [full SOCKS5 configuration instructions](/proxy-networks/socks5)
  </Accordion>

  <Accordion title="Does Bright Data support UDP / HTTP/3 proxies?">
    Yes. Bright Data supports the UDP MASQUE protocol for QUIC/HTTP/3 on port 10001.
    More information and usage examples can be found here: [https://github.com/luminati-io/h3-cli](https://github.com/luminati-io/h3-cli)
  </Accordion>

  <Accordion title="How do I control from where the request is performed?">
    * You can choose to perform the request from the super proxy directly instead of the IP of the peer. In that case the IP of the request will be the one of the Super proxy. You will need to add **'-direct'** to your request authorization string. `brd-customer-<customer_id>-zone-<zone_name>-direct`
  </Accordion>

  <Accordion title="How do I refresh session (IP)?">
    Using the same IP for a long period of time makes it easier for the target website to mark the IP as proxy and can make your request get detectable by the target website. Refreshing your IPs will result in allocation of new IPs from Bright Data instead of your existing ones in your pool allowing you to gain control over your pool and reach higher success rates.
  </Accordion>

  <Accordion title="Can I request from Bright Data missing proxies for dedicated, unlimited datacenter and ISP?">
    Requesting missing proxies (IPs), or scheduling delivery of IPs for future projects or is a feature in BETA mode, available to small number of selected enterprise customers.

    Bright Data allows placing IPs requests ("proxy future orders")  for proxies subject to the following conditions:

    1. Customer has qualified to place IP requests/orders . This permission is granted to existing, enterprise level customers only.
    2. IPs are dedicated to the customer (we do not allow ordering shared IPs).
    3. IPs are for datacenter or ISP only.
    4. A single specific country must be provided.
    5. Minimum order size is 100 proxies

    To see if your account is qualifies to place IP requests (orders) browse here:  [https://brightdata.com/cp/zones/order\_ips](https://brightdata.com/cp/zones/order_ips)

    Most customers will find Bright Data inventory sufficient for their needs, and will not need to place any orders.

    #### When should I request for proxies in the future?

    You can request for future delivery of proxy IPs if your account is qualified for placing requests.

    #### I tried to define a zone but Bright Data could not assign me all the proxies I wanted, what to do?

    If during zone save you get a message that proxies are not available in a specific country, or only part of the amount you requested is available, try to select more countries or change your country setting to allow us to find proxies for you.

    Once your request for missing proxies is placed, the Bright Data team will attempt to provision the proxies. The acquiring and provisioning process usually takes up to 14 days. Once the proxies are ready, we will notify you. We encourage you to check again once every 2-3 days to see if inventory has refreshed and more proxies are available.
  </Accordion>

  <Accordion title="How can I move proxies (IPs) from zone to zone?">
    Moving prepaid datacenter or ISP unlimited proxies (shared and dedicated) from zone to zone is not yet supported via our control panel. It is in our plans to support moving proxies from zone to zone via self service. If you need proxies to be moved please contact our support team.
  </Accordion>

  <Accordion title="Some of my IPs were replaced, why does this happen?">
    Bright Data may identify issues with the certain which prevents us from providing quality service with them. They either become unavailable, or suffer from latency so in order to keep our level of service we are forced to replace them. We do our efforts to minimize those replacements, and we do provide a preliminary notification when possible. 

    You can use this API in order to monitor your zones for IPs pending replacement and adjust your operations accordingly (refresh those ips for example): [https://docs.brightdata.com/api-reference/account-management-api/get-proxies-pending-replacement](https://docs.brightdata.com/api-reference/account-management-api/get-proxies-pending-replacement)
  </Accordion>
</AccordionGroup>


# Introduction to Datacenter proxies
Source: https://docs.brightdata.com/products/data-center/introduction

Discover Bright Data's Datacenter proxy network, offering over 1.6 million IPs from 98+ countries, providing the fastest and most cost-effective proxy solution.

Bright Data's [Datacenter proxy network](https://brightdata.com/proxy-types/datacenter-proxies) is one of our proxy network solutions and is a network with over 1.6 million IP addresses from 98+ countries.

Datacenter proxies are IPs assigned from a datacenter server, and your traffic is routed through them to help you access IPs and locations around the world. With a shorter journey & simplified architecture, Datacenter Proxies are both the **fastest** proxy type and the most **cost-effective** option.

## When to use Datacenter proxies

* Accessing websites that are not using sophisticated blocking methods
* When you need the most cost-efficient proxy network
* When you need the fastest proxy network available

<Tip>
  If you need a more sophisticated proxy network, with better success rate capabilities, you may want to consider using our [ISP](/products/isp/introduction) or  [Residential proxy network.](/products/residential/introduction) For a more advanced, fully managed, proxy unblocking solution, we would suggest trying out our [Web Unlocker API](https://brightdata.com/products/web-unlocker) or browsing our other [proxy solutions](https://brightdata.com/proxy-types).
</Tip>


# Create your first Datacenter proxy
Source: https://docs.brightdata.com/products/data-center/quickstart

Set up your first Bright Data Datacenter proxy: sign in, create a proxy in the Control Panel, verify your account and earn $5 credit for first-time setup.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title={<>Open the <a href="https://brightdata.com/cp/zones/new">Create Proxy</a> page</>}>
    Navigate to **Create Proxy** under the **Proxy** section in the left menu.

    <Frame>
      <img alt="Create Proxy" />
    </Frame>
  </Step>

  <Step title="Choose Data Center Proxy">
    Select **Datacenter** and click **Continue**.

    <Frame>
      <img alt="Data Center Proxy" />
    </Frame>
  </Step>

  <Step title="Assign a name to your proxy">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The proxy name cannot be changed once created.**

      All other settings can be modified later, but note that changing the country selection re-allocates proxies and incurs a [Refresh charge](/products/data-center/faqs#how-to-refresh-ips-allocated-to-your-zone). For details, see [Configure your Proxy](/products/data-center/configure-your-proxy).
    </Warning>

    <Frame>
      <img alt="Proxy Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Create Proxy**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize proxy creation">
    Click **Create Proxy**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your proxy is now ready to use.
  </Step>
</Steps>


# Send your first Datacenter proxy request
Source: https://docs.brightdata.com/products/data-center/send-your-first-request

Send your first request through Bright Data Datacenter proxies with copy-paste code examples in cURL, Python, Node.js, Java, and Go.

<Accordion title="This guide works for all the proxy products" icon="check">
  1. Residential Proxy

  2. Mobile Proxy

  3. ISP Proxy

  4. Datacenter Proxy

  5. SERP API

  6. Browser API

  7. Web Unlocker API
</Accordion>

To get started, you need your proxy credentials, your `Username` and `Password` along with the `Host` name. You can find these credentials in the **Overview** tab of the proxy product.

## Code Examples

Once you have your proxy credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "http://brdtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>

  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
    }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

The code above uses your proxy zone to send a request to [http://brdtest.com/myip.json.](http://brdtest.com/myip.json.) It returns your IP information in a JSON format:

```json Output theme={null}
{
  "ip": "ALLOCATED_IP",
  "country": "PK",
  "asn": {
    "asnum": 203020,
    "org_name": "HostRoyale Technologies Pvt Ltd"
  },
  "geo": {
    "city": "Islamabad",
    "region": "IS",
    "region_name": "Islamabad",
    "postal_code": "44040",
    "latitude": 33.7233,
    "longitude": 73.0435,
    "tz": "Asia/Karachi",
    "lum_city": "islamabad",
    "lum_region": "is"
  }
}
```

Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice and ...

**That's it!**


# How to configure your ISP proxy
Source: https://docs.brightdata.com/products/isp/configure-your-proxy

Learn how to configure your ISP proxy settings effectively, choose IP types, and ensure 100% uptime for optimal performance.

To access your proxy configuration, open your zone in the "Configuration" tab.

## Which IP type to choose

Bright Data offers 3 types of ISP proxies:

<Card title="Shared" icon="square-1">
  A rotating proxy over a pool of \~10,000 proxies, paid by usage GBs.
</Card>

<Card title="Shared unlimited" icon="square-2">
  A set of specific proxies, shared with others, with unlimited bandwidth, paid by proxy.
</Card>

<Card title="Dedicated unlimited" icon="square-3">
  A set of specific proxies, exlcusive for you, with unlimited bandwidth, paid by proxy.
</Card>

## Shared (rotating) proxy configuration

### Default countries selection

When selecting countries in shared pool configuration, we will assign proxies only from the countries you select. You can select none (which meand we will assign the next random proxy from the pool), one or more countries. [Read more...](/api-reference/proxy/geolocation-targeting#default-countries-selection)

To select a specific country for your peer during rotation, use the flag -country in the proxy user name parameter with an ISO-3166 country code.

[FAQ: Where can I see the list of country codes?](/general/faqs#where-can-i-see-the-list-of-country-codes)

## Shared & Dedicated unlimited proxy configuration

### Number of IPs

<Tip>
  For unlimited proxies we offer a discount based on amount of proxies you purchase per zone. The more you buy, less your pay per proxy. Click on the "Rates" link in your zone setup to see rates.
</Tip>

Number of IPs to be allocated as your pool of available IPs.

### How to select a country

Geolocation targeting allows you to target specific `Country`.
Select the prefered countries from the drop-down menu.

Once selected, we will assign proxies from those countries. If we do not have enough proxies to cover your requirement, we will assign the amount we have and you can submit an order for the full amount of proxies (we do not allow single proxy orders - we will take in large orders only).
Changing this selection means re-allocating proxies, which will incur a **Refresh charge**.

### How does multiple countries selection work?

If you select multiple countries, we assign proxies in **available countries** at the moment of assignment. For example: if you choose proxies from Germany, France & Italy, we will provide proxies from **either** of these countries. We will try to distribute the assignment evenly across the countries you selected, yet if there are not enough proxies in one of the countries, some countries will have more proxies than other.

So referring to that example, if you request 30 proxies from Germany, France & Italy and we have only 6 available proxies in Italy you will get: 12 proxies from Germany, 12 from France and 6 from Italy.

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

## Access your allocated Proxies' IP addresses

In all proxy types, you can download, view and copy to clipboard the IPs allocated to you by following these steps:

1. Navigate to the [Zones page](https://brightdata.com/cp/zones).
2. Select a zone with allocated IPs.
3. In the overview tab click 'Download', 'View' or 'Copy'.

<Frame>
  <img alt="your-proxy-list" />
</Frame>

***

## How to configure advanced options

***

### How to enable automatic failover

In case we cannot reach the proxy peer for your request, we will route the request to another available peer. Automatic failover does not apply when you choose default countries: if we cannot find a peer in the country you selected, we will fail the request with error.

Enabling automatic failover assures execution of the request, regardless of the availability of a specific peer.

***

### Special Ports & Protocols

Ports `80` and `443` are available by default, supporting HTTP and HTTPS protocols. SOCKS5 is served on port `22228`. We also support all ports over `1024` in our ISP proxy network. [Read more on ports and protocols...](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)

<Accordion title="Request Additional ports">
  Bright Data can support additional ports by request. A dedicated and additional compliance process with the Bright Data compliance team will follow every request to support a new port.
  If you would like additional port permissions, you can contact Bright Data Support.
  Examples of ports that require Bright Data compliance review before activation:

  | Port | Protocol |
  | - | - |
  | `70` | HTTP |
  | `98` | HTTPS |
</Accordion>

### Zone usage limit

Set usage limit to your zone: you can limit spending or traffic. This provides additional layer of control to your budget and bandwidth consumption, mostly over our rotating shared pool proxies.


# ISP proxies FAQs
Source: https://docs.brightdata.com/products/isp/faqs

Answers to common questions about Bright Data virtual ISP proxies: how the network is built.

<AccordionGroup>
  <Accordion title="How does virtual ISP works?">
    A virtual ISP gathers millions of physical IPs from thousands of ISP providers worldwide and forms them into a single virtual ISP network.

    As a customer of Bright Data, you can access this network via a single IP for private use, a full network of shared access for scaled public web data collection. Alternatively, you can use Bright's Data Collection platform that does all the work for you and delivers the public web data you need in the required format you requested.
  </Accordion>
</AccordionGroup>


# Introduction to ISP proxies
Source: https://docs.brightdata.com/products/isp/introduction

Bright Data ISP Proxies combine residential trust with datacenter speed across 195 countries. Best for ad verification, QA and bypassing datacenter blocks.

Bright Data’s [ISP Proxies Network](https://brightdata.com/proxy-types/isp-proxies) is one of our proxy network solutions and is built of residential IPs bought or leased from Internet Service Providers (ISPs) for commercial use, rather than for use from private homes.

This has an advantage over our [Datacenter](/products/data-center/introduction) network, as target sites classify ISP IPs similar to residential IPs, even though in reality they are actually hosted on servers. This allows you to access websites and collect data as a real person would, while at the same time benefiting from the high speeds and reliability that are characteristic of high-speed server IPs. 

## When to use ISP proxies

* Accessing hard-to-reach websites very similar to a real user
* Viewing content, performing ad verification, quality assurance, marketing, and more
* If you are getting low success rates or blocked altogether when using our [Datacenter](/products/data-center/introduction) proxy network and want to keep your fast server speeds and lower cost

<Note>
  If you need a more sophisticated proxy network, that’s even less likely to to get detected by websites, you may want to consider using our [Residential proxies.](/products/residential/introduction)
</Note>

<Tip>
  For an even more advanced proxy unblocking solution, that also tackles additional blocking challenges, such as site-specific headers, cookies, CAPTCHAs, etc, try out our [Web Unlocker API](/products/web-unlocker/introduction) or check out our [other proxy products.](https://brightdata.com/proxy-types)
</Tip>


# Create your first ISP proxy
Source: https://docs.brightdata.com/products/isp/quickstart

Set up your first Bright Data ISP proxy: sign in, create a proxy in the Control Panel, verify your account and earn $5 credit for first-time setup.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title={<>Open the <a href="https://brightdata.com/cp/zones/new">Create Proxy</a> page</>}>
    Navigate to **Create Proxy** under the **Proxies** section in the left menu.

    <Frame>
      <img alt="Create Proxy" />
    </Frame>
  </Step>

  <Step title="Choose ISP Proxy">
    Select **ISP** and click **Continue**.

    <Frame>
      <img alt="ISP Proxy" />
    </Frame>
  </Step>

  <Step title="Assign a name to your proxy">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The proxy name cannot be changed once created.**

      All other settings can be modified later. For details, see [Configure your Proxy](/products/isp/configure-your-proxy).
    </Warning>

    <Frame>
      <img alt="Proxy Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Create Proxy**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize proxy creation">
    Click **Create Proxy**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your proxy is now ready to use.
  </Step>
</Steps>


# Send your first ISP proxy request
Source: https://docs.brightdata.com/products/isp/send-your-first-request

Send your first request through Bright Data ISP proxies with copy-paste code examples in cURL, Node.js, Python, PHP, Ruby, C#, Java, Perl and VBA.

<Accordion title="This guide works for all the proxy products" icon="check">
  1. Residential Proxy

  2. Mobile Proxy

  3. ISP Proxy

  4. Datacenter Proxy

  5. SERP API

  6. Browser API

  7. Web Unlocker API
</Accordion>

To get started, you need your proxy credentials, your `Username` and `Password` along with the `Host` name. You can find these credentials in the **Overview** tab of the proxy product.

## Code Examples

Once you have your proxy credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "http://brdtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>

  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
    }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

The code above uses the ISP proxy to send a request to [http://brdtest.com/myip.json](http://brdtest.com/myip.json). It returns your IP information in a JSON format:

```json Output theme={null}
{
  "ip": "ALLOCATED_IP",
  "country": "PK",
  "asn": {
    "asnum": 203020,
    "org_name": "HostRoyale Technologies Pvt Ltd"
  },
  "geo": {
    "city": "Islamabad",
    "region": "IS",
    "region_name": "Islamabad",
    "postal_code": "44040",
    "latitude": 33.7233,
    "longitude": 73.0435,
    "tz": "Asia/Karachi",
    "lum_city": "islamabad",
    "lum_region": "is"
  }
}
```

Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice and ...

**That's it!**


# Marketplace data delivery
Source: https://docs.brightdata.com/products/marketplace/data-delivery-and-export

Receive Bright Data Marketplace datasets in JSON, NDJSON, CSV, XLSX or Parquet via email, API, webhooks or cloud destinations like S3 and Snowflake.

Once you purchase or subscribe to a dataset, Bright Data delivers it directly to your preferred destination. Choose from 11 delivery methods and 5 output formats to fit your existing infrastructure and workflow.

## Output formats

Datasets are available in the following formats:

| Format | Description |
| - | - |
| JSON | Standard structured format |
| NDJSON | Newline-delimited JSON, ideal for streaming |
| CSV | Spreadsheet-compatible format |
| XLSX | Microsoft Excel format |
| Parquet | Columnar format optimized for analytics |

<Tip>
  You can also receive data in compressed (gzip) format to reduce file size.
</Tip>

## Which delivery methods are supported

Choose how and where your data is delivered:

| Method | Description |
| - | - |
| Email | Receive datasets directly in your inbox |
| API download | Download via the Bright Data API using a snapshot ID |
| Webhook | Get data pushed to your endpoint automatically |
| Amazon S3 | Deliver directly to your S3 bucket |
| Google Cloud Storage | Deliver to your GCS bucket |
| Google Cloud Pub/Sub | Stream data via GCP Pub/Sub |
| Microsoft Azure | Deliver to your Azure Blob Storage container |
| Snowflake | Load directly into your Snowflake data warehouse |
| SFTP | Deliver via secure file transfer protocol |
| Alibaba Cloud OSS | Deliver to your Alibaba Cloud OSS bucket |
| Oracle Cloud Infrastructure | Deliver to an OCI pre-authenticated request (PAR) URL |

## How to set up delivery

<Steps>
  <Step title="Open My Datasets">
    After purchasing a dataset, go to **Control Panel → My Datasets**.
  </Step>

  <Step title="Open Delivery Settings">
    Select your dataset and click **Delivery Settings**.
  </Step>

  <Step title="Choose method and format">
    Pick your preferred delivery method and output format.
  </Step>

  <Step title="Configure credentials">
    Enter the destination credentials (bucket name, webhook URL, SFTP host, and so on).
  </Step>

  <Step title="Save">
    Click **Save**. Your data is delivered automatically on each refresh.
  </Step>
</Steps>

## Related

* [Purchase options](/products/marketplace/purchase-options)
* [Pricing](/products/marketplace/pricing)
* [Filter dataset by API](/products/marketplace/filter-dataset-by-api)


# Dataset marketplace FAQs
Source: https://docs.brightdata.com/products/marketplace/faqs

FAQs about Bright Data's Dataset Marketplace (250+ domains), including available datasets, delivery options and purchase choices for ready-to-use data.

<AccordionGroup>
  <Accordion title="What are some of the datasets available on the Dataset Marketplace?">
    The following is a partial list of datasets available for immediate download from the Datasets Marketplace:

    **Popular Datasets**

    * Amazon products
    * Crunchbase companies information
    * Facebook - Posts by group URL
    * Github repository
    * Glassdoor companies overview information
    * LinkedIn company information
    * LinkedIn people profiles
    * LinkedIn posts
    * Zillow properties listing information

    The datasets are broken up by category. Here are the main categories and some of the datasets:

    **eCommerce Data**

    * amazon.com, amazon.co.uk, amazon.de, amazon.es, amazon.fr, amazon.in, amazon.it,
    * homedepot.com, homedepot.ca
    * lazada.com.my, lazada.sg, lazada.vn

    **Real Estate Data**

    These datasets include information regarding housing data, real estate prices, rent prices etc.

    * Bayut UAE Property Listings
    * Booking.com Property Listings
    * Dubizzle UAE Property Listings
    * PropertyFinder Property Listings
    * US Consumer Property
    * ZoomProperty UAE Property Listings
    * infocasas.com.uy
    * inmuebles24.com
    * metrocuadrado.com
    * otodom.pl
    * properati.com.co
    * realestate.com.au
    * toctoc.com
    * zillow\.com
    * zonaprop.com.ar
    * zoopla.co.uk

    **Social Media Data**

    * facebook.com
    * instagram.com
    * linkedin.com
    * pinterest.com
    * reddit.com
    * tiktok.com
    * unashamedcataddicts.quora.com
    * vimeo.com
    * x.com
    * youtube.com

    **Travel Data**

    * Booking.com Hotel Room Pricing and Availability
    * Deliveroo Restaurant Listings
    * OpenTable Restaurant Listings
    * Short-Term Rental Occupancy & Pricing Dataset
    * Talabat Restaurant Listings
    * Tripadvisor Restaurant Listings
    * Zomato UAE Restaurant Listings
    * airbnb.com

    **B2B Data**

    * Business Contacts Dataset
    * Business Firmographic Data
    * Business Intelligence Dataset
    * Business Location (POI) Dataset
    * Companies Hierarchy Dataset
    * Online Intent Data
    * Politically Exposed Persons List
    * Tech Install base Data Feed
    * US B2B Employees
    * US Consumer Demographics
    * crunchbase.com
    * g2.com
    * glassdoor.com
    * google.com
    * indeed.com
    * linkedin.com
    * manta.com
    * owler.com
    * slintel.com
    * stackoverflow\.com
    * trustpilot.com
    * ventureradar.com
    * xing.com
    * yelp.com

    The datasets marketplace is continously updated with fresh datasets. For the complete list, click on "Datasets" on the sidebar, and then on "Dataset marketplace" on the top bar.

    If the domains you need aren't exist in the Marketplace, you can request them through the Custom Dataset (CDS).
  </Accordion>

  <Accordion title="Do you offer any free datasets?">
    Yes! you can download a few free datasets:

    * espn.com - NBA data
    * goodreads.com
    * imdb.com
    * worldpopulationreview\.com

    The datasets marketplace is continously updated with fresh datasets. For the complete list, click on “Datasets” on the sidebar, and then on “Dataset marketplace” on the top bar.
  </Accordion>

  <Accordion title="Why does the timestamp differ from the delivery date in the marketplace dataset?">
    The schedule run is designed to ensure timely delivery.

    The delivery deadline is calculated based on previous collection cycles and the estimated refresh duration.

    Therefore, the collection may start earlier than the delivery date to guarantee that the data is delivered on time.
  </Accordion>

  <Accordion title="How do I see data snapshots that are ready?">
    You can find your data snapshots under the "My datasets" tab. There, you'll see a table with information about each snapshot, including its status: ready, failed, or in building.
  </Accordion>

  <Accordion title="What do I do with the Snapshot ID?">
    A Snapshot ID is a unique identifier assigned to a specific data snapshot, formatted as "snap\_XXXXXX".

    You should use the Snapshot ID whenever there is an issue with a particular data snapshot. Including this ID in your support ticket helps the support team quickly identify the exact snapshot in question, leading to faster issue resolution. You can open a support ticket from the **Tickets** tab in the **Datasets** section of the Control Panel.

    The Snapshot ID ensures that both you and the support team are referring to the same data set, reducing confusion and delays in addressing your problem.
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="How do you set the record limit?">
    You can set a record limit in two ways:

    **Using the control panel:** Before purchasing a dataset, click “Proceed to purchase.” On the “Choose delivery frequency” page, select the “Too pricey? Limit dataset records” option to specify your desired record limit.

    **Through the Filter API:** Add a parameter to limit the number of records returned by the API. For reference, see: [Dataset Filter API - records\_limit](/api-reference/marketplace-dataset-api/filter-dataset#body-records-limit).
  </Accordion>

  <Accordion title="What is a commitment cost for the Dataset (Filter) API?">
    Currently, there is no monthly commitment or minimum order of \$250 required when using the Dataset Filter API. You only pay based on your actual record consumption.
  </Accordion>

  <Accordion title="I ran a filter request and was charged before buying the data. What's going on?">
    When you submit a dataset filter API request, compute resources are used to identify records matching your filter criteria. If matching records are found, you will be charged based on the amount of these matched records. However, if no matching records are found, you will not be charged. To avoid charges while exploring your filter criteria, you can test filters through the dataset preview table in the control panel, which offers up to 10 free filters per day.
  </Accordion>

  <Accordion title="Why are some fields not fully fillable?">
    Some fields may have lower fill rates due to limitations or gaps in the publicly available source data. Fill rates vary depending on dataset type and source quality - which can result in partial coverage for specific attributes. We provide detailed fill rates and statistics for each dataset to help you evaluate completeness before purchasing.
  </Accordion>

  <Accordion title="I need datasets">
    Bright Data offers several services for accessing and managing datasets:

    1. **Dataset Marketplace**: This is a centralized platform where you can discover, customize, and purchase high-quality datasets from over 250 domains. You can browse pre-built datasets across multiple domains, examine data samples, and apply advanced filters. [Explore the Dataset Marketplace here](https://brightdata.com/cp/datasets/browse).
    2. **Dataset APIs**: These APIs allow you to request, initiate, and manage data collections. You can define parameters for new dataset collections, check the status of your requests, and download datasets using snapshot IDs. [Learn more about Dataset APIs here](https://brightdata.com/api-reference/marketplace-dataset-api/request-a-collection).

    Would you like more information on how to use any of these services?
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="Does the &#x22;LinkedIn People Profiles&#x22; dataset include email addresses or phone numbers?">
    * By default, standard LinkedIn profile records **do not** include email addresses or phone numbers. This information is not publicly available on LinkedIn.
    * However, Bright Data offers an **enriched business contact** solution (in partnership with RevenueBase) that adds business emails and phone numbers for many LinkedIn people profiles, fully GDPR-compliant and sourced via third-party validation.
    * Contact data coverage may vary by profile and use case.
  </Accordion>

  <Accordion title="How can I request enriched records with email and phone?">
    * In the Dataset Marketplace, after selecting "LinkedIn People Profiles", use the **Contact filters** button (on the right side of the Data sample view) to choose your contact data options:
      * **Standard LinkedIn profile data:** No contact info.
      * **Enriched business contact info:** Select “Standard Profiles + Enriched with Business Contact Info” or “Only Profiles with Business Contact Info” to receive available business emails and phone numbers (where provided via RevenueBase partnership and in accordance with GDPR/compliance).
    * Click “Apply filter” to preview and purchase the dataset with your chosen contact enrichment.
  </Accordion>

  <Accordion title="Is the enrichment GDPR-compliant?">
    Yes. All provided business contact data is sourced and processed according to GDPR and other compliance requirements, using approved partners such as RevenueBase.
  </Accordion>

  <Accordion title="Can I get contact info using Deep Lookup?">
    Yes. Bright Data’s [Deep Lookup](https://brightdata.com/cp/deep_lookup) can search for people and return available business contact details (email/phone), where legally sourced and compliant. Specify your entity and required columns in the query (e.g., email, phone).
  </Accordion>

  <Accordion title="How do I check what fields are included before purchase?">
    * Go to Control Panel → Dataset Marketplace → LinkedIn People Profiles.
    * Open the “Data sample” tab to review all available fields, and use “Download sample” to take a copy.
    * For enriched datasets, use the **Contact filters** panel as described above, and preview sample rows before placing your order.
  </Accordion>

  <Accordion title="What if I have a compliance or usage question?">
    For full details on compliance, permissible usage, and supported geographies, speak directly with your Bright Data account manager or reach out via [Support](https://brightdata.com/cp/support).

    **Summary:**

    * **Standard LinkedIn profiles** don’t include emails/phones.
    * **Enriched business contact info** (email/phone) is available: just use the Contact filters button in the Dataset Marketplace view.
    * **Always review** the filtered sample before purchasing, and contact support for custom requirements.

    Let me know if you want a live demo, pricing, or coverage estimate!
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="What is the API rate limit?">
    The Filter API rate limit is 120 requests per hour. This applies to all API calls and snapshot triggers within the specified time frame. Note: Plan your API calls accordingly to stay within the hourly limit. Consider implementing retry logic with exponential backoff for optimal performance.
  </Accordion>

  <Accordion title="What is the maximum number of values I can send to the API filters?">
    You can send up to 10,000 input lines per uploaded CSV or JSON file when using list filters or include filters. There is no limit on the number of files per request, and a request can total up to 200 MiB. See the [Filter dataset limits](/api-reference/marketplace-dataset-api/filter-dataset) for details.
  </Accordion>

  <Accordion title="What is the maximum input file size for the API?">
    The maximum input file size is 200 MiB for any single API request. Warning: Files exceeding 200 MiB will be rejected. Compress your data or split large files into smaller chunks before submission.
  </Accordion>

  <Accordion title="What is the maximum snapshot size for single-file downloads?">
    You can download snapshots up to 5 GB as a single file.

    <Tip>
      For snapshots larger than 5 GB, the API will automatically provide chunked download options or streaming capabilities to handle the data efficiently.
    </Tip>

    ### Quick Reference

    | Limit Type | Value | Description |
    | :- | :- | :- |
    | Rate Limit | 120/hour | Maximum API calls per hour |
    | Input Lines | 10,000 | Maximum values in list/include filters |
    | Input File Size | 200 MiB | Maximum size for uploaded files |
    | Snapshot Download | 5 GB | Maximum size for single-file download |

    <Note>
      **Need Higher Limits?**<br />Contact our Enterprise team for custom rate limits and increased capacity options tailored to your business needs.
    </Note>
  </Accordion>
</AccordionGroup>

<AccordionGroup>
  <Accordion title="Where do I get a Snapshot ID?">
    Snapshot IDs are returned when you [Trigger Collection](/api-reference/rest-api/scraper/asynchronous-requests) (POST `/datasets/v3/trigger`), [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files) (POST `/datasets/filter`), or via a dataset subscription. You can also [list all your snapshots](/api-reference/scrapers/management-apis/get-snapshots) with GET `/datasets/v3/snapshots`.

    > See "[Before you begin](/api-reference/marketplace-dataset-api/deliver-snapshot#before-you-begin)" for more details.
  </Accordion>

  <Accordion title="What do I do with the delivery job ID in the response?">
    The `id` in the response is a delivery job ID. Use it to track delivery progress by calling GET `/datasets/v3/delivery/{delivery_id}`. Poll until status is "done".

    > See [Tracking delivery status](/api-reference/marketplace-dataset-api/deliver-snapshot#tracking-delivery-status) for more details.
  </Accordion>

  <Accordion title="Does the snapshot need to be in a specific status?">
    Yes. The snapshot must be in `ready` status. Check with GET `/datasets/snapshots/{id}` before calling deliver.

    > Possible statuses: `scheduled`, `building`, `ready`, `failed`.
  </Accordion>

  <Accordion title="Can I deliver the same snapshot to multiple destinations?">
    Yes. Call this endpoint multiple times with different delivery configurations for the same snapshot ID.
  </Accordion>

  <Accordion title="What file formats are supported?">
    json, jsonl, ndjson, csv, xlsx, and parquet. See [Data delivery and export](/products/marketplace/data-delivery-and-export) for per-destination details.
  </Accordion>

  <Accordion title="How do I split large snapshots into smaller files?">
    Use the `batch_size` parameter to set the number of records per file. Each file (batch) must stay under the 5GB hard limit. Estimate `batch_size` by dividing 5GB by your average record size, then start lower and adjust based on the actual file size you get.

    For example, if your average record is \~5KB, a `batch_size` of 1,000,000 records lands right at the \~5GB limit. Start at 500,000 records (\~2.5GB) to stay safely under, then raise or lower `batch_size` based on the file size you receive.
  </Accordion>

  <Accordion title="Why did my request return a 400 error?">
    The most common cause is that your `batch_size` produces a file larger than 5GB. For example, if your average record size is \~5KB, a `batch_size` of 1,000,000 produces a \~5GB file that may exceed the limit. Lower your `batch_size` (e.g., to 100,000) and retry.
  </Accordion>

  <Accordion title="Can I compress the output?">
    Yes. Set `compress: true` to receive gzip-compressed files.
  </Accordion>

  <Accordion title="What is the maximum file size per batch?">
    5GB. This is a hard limit per delivered file. Use `batch_size` to control how many records go into each file and ensure each stays under this threshold.
  </Accordion>
</AccordionGroup>


# Filter dataset by API
Source: https://docs.brightdata.com/products/marketplace/filter-dataset-by-api

Filter Bright Data Marketplace datasets programmatically using the Filter Dataset API. See the full API reference for parameters and examples.

See [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset) API Reference page


# Proxy Manager SSL analysis CA migration
Source: https://docs.brightdata.com/products/proxy-manager/certificate-migration

Switch Proxy Manager SSL analysis to the new built-in CA certificate before the current one expires on September 25, 2026, or load a custom CA.

This guide explains how to move Proxy Manager SSL analysis to the new built-in CA certificate before the current built-in CA certificate expires on **September 25, 2026**.

<Note>
  This page covers the CA certificate that Proxy Manager uses to sign traffic on its own ports. To migrate Bright Data proxy endpoints such as `brd.superproxy.io` to the new root certificate on port `44445`, see [Root certificate migration](/general/account/ssl-certificate-migration).
</Note>

## Do I need to take action?

Proxy Manager users need to act only when SSL analysis is enabled on at least one proxy port and Proxy Manager uses the built-in CA certificate.

| Your setup | Action required |
| - | - |
| SSL analysis is disabled on all proxy ports | None |
| On-premise Proxy Manager with a custom `lpm.crt` and `lpm.key` | None. The custom certificate takes priority over the built-in certificate setting |
| SSL analysis is enabled and Proxy Manager uses the built-in CA certificate | Switch to the new certificate and install it on every client before September 25, 2026 |

## How does the built-in certificate setting work?

The built-in certificate setting in Proxy Manager selects which built-in CA certificate signs SSL analysis traffic:

* **Old certificate:** available temporarily during the transition period. The old certificate expires on September 25, 2026.
* **New certificate:** recommended for continued use after September 25, 2026.

The setting affects only proxy ports with SSL analysis enabled.

## How to switch to the new built-in certificate

Switch the Proxy Manager certificate setting and the client trust stores together, so HTTPS requests keep working.

1. In Proxy Manager, set the built-in certificate setting to the new certificate.
2. Install and trust the new Proxy Manager CA certificate on every device and application that sends traffic through Proxy Manager.
3. Send a test HTTPS request through a Proxy Manager port with SSL analysis enabled and confirm the request succeeds without a certificate error.

<Warning>
  If you switch to the new certificate without installing the new Proxy Manager CA certificate on a client, HTTPS requests from that client can fail with certificate validation errors.
</Warning>

## How to use a custom CA certificate with on-premise Proxy Manager

On-premise Proxy Manager users can replace the built-in CA certificate with their own CA certificate and private key. If you already use a custom CA certificate, no action is required for this migration.

1. Prepare a CA certificate and its matching private key. The certificate and the private key must form a valid matching pair.
2. Name the files exactly:
   * `lpm.crt`: the CA certificate
   * `lpm.key`: the private key for `lpm.crt`
3. Place both files in the [Proxy Manager working directory](#where-is-the-proxy-manager-working-directory).
4. Restart Proxy Manager.
5. Install and trust `lpm.crt` on every client that uses the proxy.

When valid `lpm.crt` and `lpm.key` files are present in the working directory, Proxy Manager uses the custom CA certificate regardless of the built-in certificate setting.

<Warning>
  Keep `lpm.key` private. Only the Proxy Manager process should be able to read the `lpm.key` file.
</Warning>

## Where is the Proxy Manager working directory?

The default Proxy Manager working directory depends on the operating system and on the user account that runs Proxy Manager.

| Operating system | Account | Default working directory |
| - | - | - |
| Linux | Standard user | `/home/<username>/proxy_manager` |
| Linux | Root user | `/root/proxy_manager` |
| Windows | Any user | `C:\Users\<username>\proxy_manager` (equivalent to `%USERPROFILE%\proxy_manager`) |

Two cases change the location:

* **Service account:** when Proxy Manager runs under a service account, use that service account's home directory in place of `/home/<username>` or `C:\Users\<username>`.
* **`--dir` option:** when Proxy Manager starts with the `--dir` option, place `lpm.crt` and `lpm.key` in the directory that `--dir` specifies.

## Why does the Proxy Manager CA certificate matter?

When SSL analysis is enabled, Proxy Manager decrypts HTTPS traffic so it can inspect and process each request. To do this, Proxy Manager generates a certificate for each requested website and signs that certificate with its own Certificate Authority (CA) certificate.

Every client that sends HTTPS requests through a Proxy Manager port with SSL analysis enabled must trust the Proxy Manager CA certificate. When the CA certificate changes, clients that still trust only the old CA certificate reject the connection with a certificate validation error.

## FAQ

### What happens if I do nothing before September 25, 2026?

The current built-in Proxy Manager CA certificate expires on September 25, 2026, and the old certificate is available only during the transition period. Switch to the new built-in certificate, or to a custom CA certificate, before that date if SSL analysis is enabled on any Proxy Manager port.

### Does this migration affect Proxy Manager ports without SSL analysis?

No. The built-in certificate setting affects only proxy ports with SSL analysis enabled. Ports with SSL analysis disabled need no action.

### I already use a custom lpm.crt certificate. Do I need to do anything?

No. When valid `lpm.crt` and `lpm.key` files are present in the Proxy Manager working directory, Proxy Manager uses the custom certificate and ignores the built-in certificate setting.

### Is this the same as the port 44445 root certificate migration?

No. The port `44445` migration replaces the root certificate on Bright Data proxy endpoints. This page covers the CA certificate that Proxy Manager uses for SSL analysis on its own ports. See [Root certificate migration](/general/account/ssl-certificate-migration) for the proxy endpoint change.


# How to configure the Proxy Manager
Source: https://docs.brightdata.com/products/proxy-manager/configuration

Learn more about what Proxy Manager can do, how to tailor it to your needs, and how to implement popular optimized workflows. Connects via port 44445.

## Download and install Proxy Manager

***

Our Proxy Manager is easy to setup and maintain on your local machine or on our hosted cloud server. We recommend the Cloud server setup to get full access to all that Proxy Manager has to offer.

### Bright Data Cloud Hosting

Avoid the hassle of server resources as well as networking setup of an on-premise Proxy Manager - a cloud instance will let your focus on your operations.

We provide a multi-instance cloud with a single UI to control your Proxy Manager's operations.

* To enable this option, select Activate on [the Proxy Manager page](https://brightdata.com/cp/lpm) in your account, and the instance will be provided automatically.

<Note>
  **Allow third party cookies** in your browser must be enabled for proxy manager dashboard to run in your browser.
</Note>

### Download and install Proxy Manager on your hosted environment (cloud/on premise)

Bright Data provides installers for each platform. The minimum host requirements are at least:

* 4GB RAM
* 2 CPU
* 3GB HDD

Download and installation methods for the respective OS:

<Tabs>
  <Tab title="Windows">
    Download the [Installer](https://github.com/luminati-io/luminati-proxy/tags) file from our [GitHub](https://github.com/luminati-io/luminati-proxy) releases.

    <Tip>
      Make sure to download the latest version.
    </Tip>
  </Tab>

  <Tab title="Linux/MacOS">
    <Warning>
      Linux CentOS 8.x is not supported (use CentOS 7.x instead!)
    </Warning>

    <Accordion title="Linux/macOS requirements">
      * Confirm the recommended hardware requirements:
        1. 4GB RAM
        2. 2 CPUs
        3. 3GB SSD
      * Confirm the recommended software requirements:
        * [Node.js](https://nodejs.org/en/about/) supported versions: `12.18.3 - 14.18.1`
        * [NPM](https://docs.npmjs.com/about-npm) supported versions: `6.14.6  - 8.1.3`

          <Note>
            You can manually install NPM v6.14.6:

            ```sh theme={null}
            sudo npm install -g npm@6.14.6
            ```
          </Note>
      * Confirm that network traffic is not limited:
        * The server/computer does not use any VPN or proxy IP!
        * The OS firewall is turned off
        * in and out traffic is permitted for TCP ports 20000-30000
    </Accordion>

    * Install Proxy Manager by running from a terminal one of the following commands:

      ```sh theme={null}
      curl -L https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash
      wget -qO- https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash
      sudo npm install -g @luminati-io/luminati-proxy
      ```

    You can find more information on [Manual Installation instructions](https://github.com/luminati-io/luminati-proxy#linuxmacos---manual-install).
  </Tab>

  <Tab title="Docker">
    A docker image can be found [here](https://hub.docker.com/r/luminati/luminati-proxy/)

    ```sh theme={null}
    docker pull luminati/luminati-proxy  
    docker run luminati/luminati-proxy proxy-manager  
    docker run luminati/luminati-proxy proxy-manager --version
    ```

    * Make sure to forward appropriate ports. Proxy manager uses by default 22999 for the web console and the API, [<Tooltip>44445 </Tooltip>](/general/faqs#which-port-shall-i-use-22225-or-33335) for dropin and 24000-24... for all the ports that you'll create.
    * To run docker with cli option see the below example:

      ```sh theme={null}
      sudo docker run -v ~/proxy_manager:/lpm -p 127.0.0.1:22999:22999  -p 127.0.0.1:22998:22998  -p 127.0.0.1:24000:24000  luminati/luminati-proxy pmgr  --www_whitelist_ips 172.17.0.1  --config /lpm/config.json
      ```
  </Tab>
</Tabs>

***

## Which preset to choose

***

<Tabs>
  <Tab title="Long single session (IP)">
    Use this preset if you need full page loads. Connect from the browser manually (for example Chrome/Firefox) or programatically (for example Puppeteer/Selenium). All requests share the same IP. You can control when you refresh the IP from the UI or API.
  </Tab>

  <Tab title="Rotating">
    Use this preset if you want to get a fresh new IP on each single request. This preset also rotates the User-Agent header automatically. It's the best for scraping API when you don't load the full pages.
  </Tab>

  <Tab title="Custom">
    Build your own preset fit your needs

    <Note>
      Using a custom preset requires testing in the internal environment before going to production to verify the process is working as expected
    </Note>
  </Tab>
</Tabs>

## Rules and Headers

***

Navigate to Rules and start building your own rules based on triggers such as:

* URL suffixes
* Status codes
* String values found in the Response body
* Requests latency

You can choose an action to be taken to each trigger respectively.

For example, an implementation of a rule to save bandwidth by nullifying media URLs' outputs.

In addition, you can implement the desired headers in advance under the Rules section.

For example, adding the user-agent header of a Linux desktop on i686 CPU (More about user-agents can be found [here](https://developers.whatismybrowser.com/useragents/explore/))

## How to target a port

***

Bright Data proxy manager enables targeting the Proxy using IP:PORT format. For example, targeting a [port](/api-reference/proxy-manager/create_a_new_proxy_port) indexed as 24000 when the proxy manager is installed locally:

```sh theme={null}
curl --proxy 127.0.0.1:24000 "https://target.site"
```

<Note>
  If installed remotely simply switch 127.0.0.1 with the remote server IP address. (Instead of the IP:PORT USERNAME:PASSWORD)
</Note>

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://target.site"
```

This allows:

* Removing the username:password section from the request.
* Integration with 3rd party softwares that accept only IP:Port format
* Clean code. Ports can be configured with all necessary headers and rules in advance no need to adjust the command/request itself. More information is available [here](/api-reference/proxy-manager/update_a_proxy_port)

## Add External Proxies

***

Bright Data Proxy Manager supports external proxies from other vendors. Connecting external proxies will allow you to optimize and manage all of your proxies in one place.

* Login to your Proxy Manager
* Set a new Port.
* Select 'External'
* Add your proxies in the next format

```js theme={null}
[
    '<proxy_peer_IP>', '<username>:<password>@<proxyprovider_server>:<port>'
]
```

* Click 'Save' and you will have the external proxies available as one of the Proxy Manager's port

<Frame>
  <img alt="Add External Proxies" />
</Frame>

## Traffic Calculation Difference

***

Proxy Manager is a middleman between the request initiator and our Super Proxy servers. Proxy Manager statistics can be seen [here](https://brightdata.com/cp/lpm), and Super Proxy statistics can be seen [here](https://brightdata.com/cp/zones). So each request that you send to Proxy Manager eventually reaches Super Proxy. But there could be a difference in traffic calculations, here's why:

* Proxy Manager calculates incoming requests as they are being sent, but after they reach the Proxy Manager, it attaches additional headers, so that request's response will have more information about the request's flow (timeline, proxy IP, etc)
* Requests that reach the Super Proxy server from Proxy Manager are incoming with those additional parameters; that's why Super Proxy calculates slightly bigger requests than it initially was when reached Proxy Manager
* Proxy Manager sometimes adds headers to present a better view of logs, but this data is not being calculated in the billing

In conclusion, the main source of traffic statistics should be [Zones](https://brightdata.com/cp/zones)' page since it represents statistics formulated by Super Proxy.

As a rule - Bright Data uses the [Zones](https://brightdata.com/cp/zones)' page for calculation and one source of truth

Invoices and billing events will be triggered based on the zones calculations


# Proxy Manager FAQs
Source: https://docs.brightdata.com/products/proxy-manager/faqs

Find detailed answers to common Proxy Manager questions, including access restriction, port multiplication, IP targeting, and more. Connects via port 44445.

<AccordionGroup>
  <Accordion title="Can I restrict access to Remote Proxy Manager on-premise?">
    To secure your account and prevent unauthorized access to the Proxy Manager, there are 3 main available workflows:

    1. Allowlist IPs
    2. Token based Authentication using API key
    3. Permission by Email using the Bright data extension
  </Accordion>

  <Accordion title="How to connect to superproxy via HTTPS?">
    Proxy Manager can connect with the main Bright Data infrastructure using either HTTP or HTTPS connection.

    <Note>
      **To avoid confusion:** This is **NOT** the connection type to the target URL. To make sure the connection is secure it's enough to keep **Connection to Super Proxy** with a default value (HTTP) because the HTTPS requests create an end-to-end encrypted connection with the target site anyway.
    </Note>

    In most cases, you don't even need to touch this config. It may come out useful though when connecting from some territories where traffic to some domains is blocked. In these cases, you need to set it to **HTTPS** not to allow the global firewall to see the content of your proxies traffic and filter it out based on the target domain
  </Accordion>

  <Accordion title="How to multiply ports?">
    Go to "General" tab and choose the number of ports you want to multiply in the Multiply proxy port drop down

    Once you set the number of multiplied ports you need the Proxy Manager will generate the sequential ports identical to the port you configured.

    This is a very powerful feature when you need to create many ports with the same settings but only set it once.
  </Accordion>

  <Accordion title="How to get IPs from specific locations?">
    With Bright Data you can specify the geolocation and other parameters of the IPs you use for sending traffic. In Proxy Manager it's especially easy because it take only a few clicks.

    Depending on the zone you use you can request IPs only from a specific country (if you use Residential or Datacenter network) or additionally specific carrier (if you use Mobile network).

    **How to set targeting in Proxy Manager?**

    To get IPs from a specific location, follow these steps:

    * Click on the proxy port that you want to use location-specific IPs
    * Go to **Targeting** tab
    * Select country, state, city for choosing a peer in a specific geolocation
    * Select ASN or carrier name (only for mobile peers)

    <Note>
      Each targeting option requires the proper permissions in your Zone.
    </Note>

    <Accordion title="How to use IPs from multiple countries without creating many ports?">
      If you want to use multiple countries and you don't want to create a separate proxy port for each country it's also possible to control the targeting dynamically.
    </Accordion>
  </Accordion>

  <Accordion title="How to control targeting dynamically?">
    You don't have to specify the country, state or city targeting in advance using the Targeting tab in the UI. It is possible to pass extra targeting options dynamically ('on the fly') along with the request.

    ```sh theme={null}
    curl -x lum-country-br@127.0.0.1:24001 http://brdtest.com/myip.json
    ```

    The request's structure is:

    ```sh theme={null}
    curl -x lum-country-<country_iso_code>@<ip>:<port> <destination_url>
    ```

    The other option for controlling targeting dynamically is by including a special header.

    ```sh theme={null}
    "x-lpm-country: <country_code>"
    ```

    Example request could look like this:

    ```sh theme={null}
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-country: us" http://brdtest.com/myip.json
    ```

    You may also use headers for controlling state and city:

    * State: `x-lpm-state: <state>`
    * City: `x-lpm-city: <city_name>`
  </Accordion>

  <Accordion title="How to override the port's country?">
    To override the country selected in the port, you can send the 'x-lpm-country' header with the chosen country code.

    ```sh theme={null}
    curl --proxy [LPM_DOMAIN]:[PORT] -H "x-lpm-country: il" "http://brdtest.com/myip.json"
    ```
  </Accordion>

  <Accordion title="How to set an automatically follow redirect?">
    Follow Redirect is a valuable feature within the Proxy Manager that enhances your control over the handling of 30X (Redirection) errors. This feature is located within the Port Settings, under the General tab. It provides you with the option to automatically send a new request when encountering a 30X error, where the destination URL is derived from the Location response header. This documentation will guide you through enabling and using this feature.

    **Accessing Follow Redirect:**

    1. Open the desired port for Follow redirect activation
    2. Go to General Tab: Within the Port Settings, click on the "General" tab. This is where you'll find various settings related to how your proxy handles requests and responses.
    3. Toggle the Follow Redirect Feature: In the General tab, you will see the "Follow Redirect" feature. It's presented as a toggle button, allowing you to enable or disable it as needed.

    **How Follow Redirect Works:**

    * When the Follow Redirect feature is enabled, it instructs the proxy manager to automatically send a new request in response to a 30X error.
    * The URL for the new request is determined based on the Location response header received in the 30X error response.
    * This allows your proxy to seamlessly follow the redirection and ensure that the request is sent to the correct destination, as specified by the Location header.

    **Benefits of Follow Redirect:**

    In environments where automatic redirection is not supported or desired, the Follow Redirect feature gives you full control.
  </Accordion>

  <Accordion title="How to control sessions consistency with session header?">
    You can control your sessions using the Proxy Manager by sending x-lpm-session header.

    * Add the header with any random session ID"x-lpm-session: random\_session"
    * When using the same session the Proxy Manager will try to connect with the same exit node (peer/IP)
    * When you change the session value the Proxy Manager will connect with a different exit node (new peer/IP)
    * To keep a given session alive you must send a request no less than every 7 minutes
    * Note that in order to use it with HTTPS requests you will need to enable SSL Analyzing and install the certificate

    Here is an example:

    ```sh theme={null}
    curl --proxy http://127.0.0.1:24000 -H "x-lpm-session: rand123" http://brdtest.com/myip
    ```
  </Accordion>

  <Accordion title="How can I Refresh Session on Cloud Proxy Manager?">
    You can refresh session on your cloud Proxy Manager with the following curl request:

    ```sh theme={null}
    curl -X POST "https://pmgr-customer-<customer_id>.brd.superproxy.io:22999/api/refresh_sessions/<port>"
    ```
  </Accordion>

  <Accordion title="How to export logs from Proxy Manager?">
    In Proxy Manager, we provide users with a range of options to export logs to external storage and log monitoring systems. These export options allow you to centralize and analyze your logs efficiently. In this documentation article, we will outline the available log export options and guide you on how to configure them through Proxy Manager settings.

    **Log Export Options:**

    Proxy Manager offers the following log export options:

    **Logz.io**

    Configure the Logz.io integration in Proxy Manager settings by specifying your Logz.io token, Host and other required parameters.

    **AWS S3:**

    To export logs to AWS S3, set up the S3 integration in Proxy Manager settings. You will need to specify your AWS access key, secret key, S3 bucket name, and other relevant details.

    **Webhook:**

    Configure the webhook endpoint and any required authentication details and URL in Proxy Manager settings to start exporting logs via webhook.

    **Datadog:**

    To export logs to Datadog, set up the Datadog integration in Proxy Manager settings by providing your Datadog API key and other relevant information.

    **Configuring Log Exports:**

    To configure log exports in Proxy Manager, follow these general steps:

    1. Access Proxy Manager Settings:
    2. Navigate to the settings or configuration section.
    3. Select Log settings option in Enable request logs
    4. Toggle on Use remote logs aggregator
    5. Choose the desired log export option (Webhook, Datadog, Logz.io, or AWS S3).
    6. Provide Configuration Details: For the selected export option, you will typically need to provide specific configuration details. This may include endpoint URLs, API keys, authentication credentials, and storage settings.
    7. Click on Test to check the configuration
    8. Click OK and Save changes

       <img alt="logs-settings.png" />

    By following these steps, you can effectively configure Proxy Manager to export logs to your chosen external storage or monitoring systems, enhancing your ability to monitor and manage your network and applications effectively.
  </Accordion>

  <Accordion title="How to unblock error codes?">
    Error code responds can trigger an IP refresh or try with new IP using the Proxy Manager Rules with the following steps:

    * Add a new rule at Proxy Manager, rules tab
    * Select 'Status code' as the rule type
    * Trigger the rule by selecting the relevant status code to scan (i.e 501, 402, 301, etc)
    * Select the desired outcome such as 'Refresh IP' or 'Try with new IP'

    Watch video:[unblock error codes](https://brightdata.com/video/unblock_error_codes)
  </Accordion>

  <Accordion title="How to run UI (dashboard) on HTTPS">
    **What is needed?**

    To be able to access the UI (dashboard) using HTTPS protocol you need to provide the Proxy Manager with an SSL certificate and private key for your domain.

    The certificate and private key should be generated specifically for your domain and installed on the server. Usually it's done through the server and domain provider

    **How to do it?**

    Run Proxy Manager along with environment variables `SSL_CERT` and `SSL_KEY` pointing to the according certificate files. Example command to run in the terminal:

    ```sh theme={null}
    SSL_CERT=/path/to/ca.crt SSL_KEY=/path/to/ca.key pmgr
    ```

    Once it is started you can access the UI using [https://your-domain.com:22999/](https://your-domain.com:22999/)
  </Accordion>

  <Accordion title="How to save request/response history?">
    By enabling the `--history` flag. When history mode is enabled, both request and response headers will be saved to a local database. They can be accessed under the "Proxies" section. The history option can also track HTTPS, by enabling the '--ssl' flag. For additional details, see the Bright Data Proxy Manager [GitHub page](https://github.com/luminati-io/luminati-proxy#installation).

    This can also be done through the Proxy Manager dashboard by abling Log request history and Enable SSL sniffing under the General settings section.
  </Accordion>

  <Accordion title="How to use SOCKS5 with Bright Data's Proxy Manager">
    To use SOCKS5 with Bright Data's Proxy Manager, simply use `socks5h://` as the protocol when connecting to your local Proxy Manager port. No UI changes are needed.

    Example:

    ```sh theme={null}
    curl -x socks5h://127.0.0.1:24000 "https://geo.brdtest.com/welcome.txt"
    ```

    <Note>
      Always use `socks5h://` (not `socks5://`) to ensure DNS is resolved on the proxy side, as required by Bright Data.
    </Note>
  </Accordion>

  <Accordion title="How to define a proxy IP country when using SOCKS5 protocol with Proxy Manager?">
    <Warning>
      This option is only available for customers who have dropin port enabled
    </Warning>

    `SOCKS5` protocol uses an encrypted base64 string for authentication.

    Therefore, when using `SOCKS5`, if you need to define a proxy IP country (`-country-<COUNTRY_CODE>`), you will have to convert your basic authentication information into base64 token:

    * Browse [https://www.base64encode.org](https://www.base64encode.org/)
    * Encode `brd-customer-<customer_id>-zone-<zone_name>-country-<COUNTRY>:<zone_password>` to Base64 format token
    * Use the "Basic authorization token" header you generated on the `SOCKS5` request that you send the Proxy Manager port:

    ```sh theme={null}
    curl -v "http://brdtest.com/myip.json" --socks5 127.0.0.1:24000 -H "Proxy-Authorization: Basic <Basic authorization token>"
    ```
  </Accordion>

  <Accordion title="How to switch from API to Proxy Manager">
    Using the Proxy Manager offers advanced features that are not readily available in the API. Instead of having to manually code mechanisms for tasks like keeping an IP as long as possible or rotating your IP after each request, you can simply click a button in the Proxy Manager.

    Guidelines to to switch from API to Proxy Manager:

    1. Install the Proxy Manager [here](https://github.com/luminati-io/luminati-proxy#installation/)
    2. Change the code to send HTTP requests directly to the specified port (for example, 127.0.0.1:24000) instead of to brd.superproxy.io:
    3. Configure the settings for your custom proxies and Zones through the Proxy Manager dashboard. You do not need to send the user parameter (brd-customer-customer\_name-zone-zone\_name…) alongside your requests, as all the needed data is wrapped within the manual proxy configuration.
  </Accordion>

  <Accordion title="How to mimic a human user?">
    Including all headers and cookie behavior. See bash example, using Bright Data **Proxy Manager**:

    ```sh theme={null}
    curl -v "http://brdtest.com/myip.json" -H 'pragma: no-cache' -H 'accept-encoding: gzip, deflate, br' -H 'accept-language: en-US,en;q=0.8' -H 'upgrade-insecure-requests: 1' -H 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.100 Safari/537.36' -H 'accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp, image/apng,\*/\*;q=0.8' -H 'cache-control: no-cache' -H 'cookie: bcookie="v=somekindofcookiexxx";' --proxy http://127.0.0.1:PORT_NUM
    ```

    <Note>
      When using Web Unlocker API attaching headers is disabled by default, please contact support in order to approve headers attachment.
    </Note>
  </Accordion>

  <Accordion title="How to set up the Proxy Manager as a system service?">
    <Steps>
      <Step title="Sign in as 'root' to the remote server (running Ubuntu)" />

      <Step title="Create a service">
        Create a new service file in:

        ```sh theme={null}
        /etc/systemd/system/pmgr.service
        ```

        ```sh theme={null}
        [Unit]
        Description=Proxy Manager
        Wants=network-online.target
        After=network-online.target

        [Service]
        Type=simple
        Restart=always
        RestartSec=5
        Environment=NODE_ENV=production
        ExecStart=/usr/bin/pmgr
        User=root
        StandardOutput=null
        StandardError=null

        [Install]
        WantedBy=multi-user.target
        ```
      </Step>

      <Step title="Reload service files">
        ```sh theme={null}
        systemctl daemon-reload
        ```
      </Step>

      <Step title="Start Proxy Manager service">
        ```sh theme={null}
        systemctl start pmgr
        ```
      </Step>

      <Step title="Check status:">
        ```sh theme={null}
        systemctl status pmgr.service
        ```
      </Step>

      <Step title="Done!">
        You have completed setting up Proxy Manager as a service. You can now control your new service:

        ```sh theme={null}
        service pmgr [stop|start|restart]
        ```
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="How can I view my request details?">
    Enabling 'Request details' under 'General settings' will add the response headers below, and will allow you to get a wider, more specified view of your request. This feature has the same functionality as using the `-debug` flag.

    * `x-brd-ip-destination` - IP of the targeted host
    * `x-brd-ip` - IP allocated to the request.
    * `x-brd-timeline` - Time it took to complete

    <Note>
      - This feature is turned off by default on the cloud proxy manager, if needed, make sure you enable it.
      - Enabling 'Request details' is necessary in order to implement the action 'Ban IP' within a rule.
    </Note>

    Viewing these headers can be done with one (or more) of the following ways

    <Tabs>
      <Tab title="via the verbose flag (-v)">
        Sending your request in verbose mode by using the `-v` flag
      </Tab>

      <Tab title="Viewing your proxy manager logs">
        1. Click on the specific request you want to examine
        2. Click on 'Headers'
      </Tab>

      <Tab title="Viewing it on your browser's 'Network' tab">
        1. Open 'devtools' by clicking F12
        2. Go to the 'Network' tab
        3. Navigate to the target URL
        4. Click on the relevant request
        5. The relevant headers would be under 'Response Headers'
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to reduce the amount of data in a response?">
    * Go to "General" tab
    * Select "On" from "SSL analyzing"
    * Go to "Rules" tab
    * Select "URL" from "Rule type" drop-down list
    * Choose any file type to apply regex expression
    * Select "Null response" from "Action type" drop-down list

    In the following example below the Proxy Manager will return a null response (0kb and still status code 200) for all requests that end with any of the file type endings .jpg|.png|.gif etc.

    Use this option when you want to reduce the amount of data you wish to get in your response.
  </Accordion>

  <Accordion title="How can I improve the speed of my web scraping?">
    If the number of requests you rotate through a single IP is higher than what target websites allow, the website you target will identify your IP and block or mislead you with false information. It means that your information collecting can be much slower than what you're used to.

    **What can I do about it?**

    Assuming you're running 10 million requests, 1 request per second per IP with 1000 data center IPs, your routine can take about 3 hours. With 10,000,000 residential IPs, your routine can potentially take 1 second.

    Guidelines to rotate multiple parallel sessions through Bright Data's residential network:

    1. Open Proxy Manager
    2. Go to the 'Overview' tab
    3. Click the port of your residential zone
    4. Edit in the port settings 'preset' to 'Rotating (IPs)'
    5. Route your requests to `127.0.0.1:<portnum>` where the `portnum` is the port of the residential zone
  </Accordion>

  <Accordion title="How do I know if I'm getting cloaked?">
    Getting cloaked means that you're getting misleading information from the website you are scraping.

    Example: If you are collecting comparative competitive information to feed your automatic pricing algorithms, the target website can return artificially lower prices to your requests, to skew your pricing and profits.

    **What can I do about it?**

    When using traditional proxy networks (data center based IPs), your target websites may identify your activity quite easily and may cloak your requests. Therefore, the only way to ensure you're not getting cloaked is to rotate your requests through residential IPs.

    Guidelines for rotating requests through millions of residential IPs:

    1. Open Proxy Manager
    2. Go to the 'Overview' tab
    3. Click the port of your residential zone
    4. Edit in the port settings 'preset' to 'Rotating (IPs)'
    5. Route your requests to `127.0.0.1:<portnum>` where the `portnum` is the port of the residential zone
  </Accordion>

  <Accordion title="How to set Long Single Session when using Proxy Manager">
    Choose "Long Single Session" on the port settings drop-down, and it will automatically ping the IP to keep the session alive:

    <img alt="long-single-session.png" />
  </Accordion>

  <Accordion title="How do I use Remote DNS?">
    Using Remote DNS gives you a DNS resolve server similar to that of the Proxy peer (the origin of the Proxy's IP). This makes your request look more credible as the resolve server is usually located geographically close to the IP, whereas without using Remote DNS the resolve server is one of Bright Data's Super-Proxies which may be located in another country. To use Remote DNS:

    <Tabs>
      <Tab title="via Proxy Manager">
        Go to Edit Port > IP control > set "DNS Lookup" to "Remote - resolved by peer"
      </Tab>

      <Tab title="via The API">
        Simply add it to your username string.

        For example:

        ```sh Shell theme={null}
        brd-customer-<customer_id>-zone-<zone_name>-dns-remote
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to use parallel Proxy Manager instances for high performance?">
    When you don't want to overload one Proxy Manager with too many requests you can create several instances of the Proxy manager on different servers.

    The best way to do so is by following the next steps:

    * Install the Proxy Manager locally and set all of the ports as needed
    * Save the config file
    * Turn on Sync configuration so all the changes will be kept in sync on all the machines automatically
    * Install the Proxy Manager on the servers you want to use
    * *Import* the config file to the proxy\_manager directory in the servers

    Split your traffic between the servers

    ```js theme={null}
    request 1 -> {FIRST SERVER IP}:24000
    request 2 -> {SECOND SERVER IP}:24000
    ```

    Using the Proxy Manager with this method will make sure you are not overloading one Proxy Manager instance and it will help you keep the same configuration across all instances.

    This means you can send requests from same port with the same country at the same time on each instance.

    If you're having troubles setting up this load-balancing yourself - you could use our [Clouds](https://brightdata.com/cp/lpm) that have load-balancing feature implemented. You'll only need to use 1 UI and control all instances with shared configuration, and then target same URL, we will take the whole load-balancing process ourselves.
  </Accordion>

  <Accordion title="I cannot Login to on-Premise Proxy Manager">
    If you fail to login to your [Proxy Manager](/products/proxy-manager/introduction)(PM), please do the following:

    * Make sure that the computer that runs PM is not using a VPN.\\
      <Note>
        Mind that using a VPN while running PM might cause login problems, and also slow down the connection to the proxies
      </Note>
    * Close PM (the terminal's black screen where PM is running)
    * Delete cookies on your browser
    * Open PM again (it takes about 1-2 minutes for PM to load)
    * Try to log in on the same method you did before (by using Google, or by using your registered mailbox and password)

    Alternatively, you may switch the hosting of Proxy Manager to our [Cloud](https://brightdata.com/cp/lpm). We will take care of hosting and even load-balancing between several instances of Proxy Managers.

    P.S. After PM loads, the default browser should open automatically on PM's login page. If it does not, open your browser, browse 127.0.0.1:22999, and then try to log in.
  </Accordion>

  <Accordion title="Proxy Manager connection error (port status is not &#x22;ok&#x22;)">
    If you cannot log in to Proxy Manager, or If Proxy Manager cannot connect to Super Proxy (i.e. port status is not OK), check the following:

    * Make sure that VPN is not turned on
    * Make sure that there is no anti-virus or any other security software (such as 360, Norton, etc.) blocking traffic sent from Proxy Manager
    * Make sure that the firewall (OS / server / any other security software's firewall) allows TCP traffic through ports 22000-25000
    * If the proxy manager software is installed on macOS/ Linux server - Verify that:
      * Node.js version is between 12.18.3 and 14.18.1
      * NPM version is between 6.14.6 and 8.1.3
      * If versions of NPM and Nodejs are not the one we're supporting - please remove them and install the versions that we specified. More information regarding Linux/Mac installation can be found at our [GitHub page](https://github.com/luminati-io/luminati-proxy/#linuxmacos---manual-install)
  </Accordion>

  <Accordion title="Why Am I getting '400 Proxy Error: ip_requested_not_allocated_by_customer'?">
    When Using the Data center/ISP or gIPs products, the error code `400` can appear in case the IPs under your zone has been refreshed, removed, or simply changed due to system updates

    <Note>
      This error typically arises after your BrightData account has been recently suspended. An automatic suspension occurs if your account balance becomes negative. If the suspension extends beyond 24 hours, the static allocated IPs will be released from your account. Upon reactivation, the reallocated IPs may differ from the original ones, thus if the previously allocated IPs are still being targeted - this error is thrown.
    </Note>

    Whenever this error appear, you should go to your Bright Data Zones page, download the new list of IPs relevant to this zone.

    Make sure you also update the list of IPs in case you are using the proxy manager tool with prefix of IP port setup

    Example:

    ```sh Shell theme={null}
    curl --v "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.1.1.1:<zone_password>
    ```

    <img alt="shell-example.png" />
  </Accordion>

  <Accordion title="How to get IPs from specific locations?">
    With Bright Data you can specify the geolocation and other parameters of the IPs you use for sending traffic. In Proxy Manager it's especially easy because it take only a few clicks.

    Depending on the zone you use you can request IPs only from a specific country (if you use Residential or Datacenter network) or additionally specific carrier (if you use Mobile network).

    **How to set targeting in Proxy Manager?**

    To get IPs from a specific location, follow these steps:

    * Click on the proxy port that you want to use location-specific IPs
    * Go to **Targeting** tab
    * Select country, state, city for choosing a peer in a specific geolocation
    * Select ASN or carrier name (only for mobile peers)
  </Accordion>

  <Accordion title="What Bright Data products does Proxy Manager work with?">
    Proxy Manager supports the following Bright Data products: Data Center Proxies, ISP Proxies, Residential Proxies, Mobile Proxies, Web Unlocker API, SERP API \
    Proxy Manager does not support Browser API.
  </Accordion>

  <Accordion title="How can I download proxy manager? ">
    We recommend that you run proxy manager on our cloud servers as a service for better experience. If you need to install it on your local machines use the following links.

    ### Windows

    [Download proxy manager installer for windows](https://github.com/luminati-io/luminati-proxy/tags)

    ### Linux & MacOS

    `bash `Installer:

    ```sh theme={null}
    curl -L https://brightdata.com/static/lpm/luminati-proxy-latest-setup.sh | bash
    ```

    `NPM `package installer:

    ```sh theme={null}
    sudo npm install -g @luminati-io/luminati-proxy
    ```

    `Docker`image:

    ```sh theme={null}
    docker pull luminati/luminati-proxy
    ```

    ### Source code

    [https://github.com/luminati-io/luminati-proxy](https://github.com/luminati-io/luminati-proxy)
  </Accordion>
</AccordionGroup>


# Proxy Manager integration
Source: https://docs.brightdata.com/products/proxy-manager/integration

Integrate the open-source Bright Data Proxy Manager (default port 22999) with third-party apps. Run it as a local proxy server in any environment.

## Integrate with third party apps

The Proxy Manager is an Open-Source project that can be installed in various environments and used as a proxy server in any application.

Below are a few examples for which Proxy Manager can be used as the proxy server inside third party applications.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

Integrate with any third party app there is no need for username and password and it is ok to leave `username:password` empty aseach port in the Proxy Manager keeps the credentials of the used zone in it.

```js Example for port 24000 theme={null}
IP:PORT:USERNAME:PASSWORD → 127.0.0.1:24000:[empty]:[empty]
```

## Integrate to your phone

<Tabs>
  <Tab title="Android settings">
    1. An Android and the machine using the Proxy Manager need to share the same WiFi connection
    2. Proxy Manager port must allowlist the IP of the Android device
    3. Go to the WiFi network configuration -> advanced -> manual proxy:

       * Proxy host: The IPv4 address of the machine with the Proxy Manager

       <CodeGroup>
         ```sh CMD theme={null}
         ipconfig
         ```

         ```sh Shell theme={null}
         ifconfig
         ```
       </CodeGroup>

       * Port: `24000` (or other port you created)
  </Tab>

  <Tab title="iPhone (iOS) proxy settings">
    1. iPhone and the machine using the Proxy Manager need to share the same WiFi connection
    2. Allowlist the iPhone IPv4 in the Proxy Manager under 'General'\
       To find IPv4 follow these instructions:
       * Go to wifi settings
       * tap on the blue `i` icon next to your network's name
       * See your IP address
    3. Open the Settings app and go to WiFi
    4. Tap the name of the WiFi network you're connected to
    5. Scroll to the bottom and you will find a section for HTTP Proxy. This is set to 'off' by default. Set it 'Manual' for manually configuring the proxy settings
    6. In the server slot enter the IPv4 address of the server where the Proxy Manager is installed
    7. In the port slot enter `24000` (or other port you create)
  </Tab>
</Tabs>

## Integrate with Puppeteer

* Create a Zone with the network, IP type, and number of IPs you wish to use.
* Install the Proxy Manager.
* Click 'add new proxy' and choose the Zone and settings you require, click 'save'.
* In Puppeteer, under the 'proxy-server', input your local IP and Proxy Manager port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`, for example, `24000`
* Leave the `username` and `password` values empty, as the Bright Data Proxy Manager has already been authenticated with the Super Proxy.

```js Sample Code theme={null}
const puppeteer = require('puppeteer');

(async () => {
	const browser = await puppeteer.launch({
		headless: false,
		args: ['--proxy-server=127.0.0.1:24000']
	});
	const page = await browser.newPage();
	await page.authenticate();
	await page.goto('https://brdtest.com/myip.json');
	await page.screenshot({path: 'example.png'});
	await browser.close();
})();
```

## Integrate with Selenium

* Create a Zone with the network, IP type, and number of IPs you wish to use.
* Install the Bright Data Proxy Manager.
* Click 'add new proxy' and choose the Zone and settings you require, click 'save'.
* In Selenium, under the setProxy, input your local IP and proxy manager port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`, for example, `24000`
* Leave the username and password fields empty, as the Bright Data Proxy Manager has already been authenticated with the Super Proxy.

```js theme={null}
const {Builder, By, Key, until} = require('selenium-webdriver');
const proxy = require('selenium-webdriver/proxy');

(async function example() {
	let driver = await new Builder().forBrowser('firefox').setProxy(proxy.manual({
		http: '127.0.0.1:24000',
		https: '127.0.0.1:24000'
	})).build()

	try {
		await driver.get('https://brdtest.com/myip.json');
		driver.switchTo().alert().accept();
	} finally  {
		await driver.quit();
	}
})();
```

## Integrate with Insomniac browser

* Go to the **General** tab in the port settings

* In the **Multiply proxy port** field select the number of proxy ports to create. This will create multiple proxy ports with the same settings

* Your Spreadsheet Contains the following columns:
  * Custom Name: Add a name for each proxy
  * Host: `127.0.0.1`
  * Port: `24XXX`
  * `username`, `password`, and Tags: leave EMPTY
    <Note>Proxy Manager has already been authenticated with the Super Proxy</Note>
  * Save the file as a CSV and not as an XLS or XLSX
  * In Insomniac Proxy per tab extension select Manage Proxy list, and select Add bulk proxies
  <Frame>
    <img alt="Proxy Manager Integration" />
  </Frame>

* Select Import proxy list and upload the CSV file

<Frame>
  <img alt="Proxy Manager Integration" />
</Frame>

## Integrate with Multilogin (MLA)

* Within Multilogin click New browser profile
* Click on Edit proxy settings
* Under Connection Type choose Bright Data
* Choose your protocol under Proxy Type
* IP or Host: `127.0.0.1` if the Proxy Manager is installed locally or on the IP of the [remote server](https://brightdata.com/faq#pmgr-install-remote) the Proxy manager is installed on `1.1.1.1` or example.com
* Port: the port you created in the Bright Data Proxy Manager `24XXX`
* Leave the username and password field empty, as the Bright Data Proxy Manager has already been authenticated
* Click on **Check proxy**

<Frame>
  <img alt="Proxy Manager Integration" />
</Frame>

## Integrate with Playwright Proxy

* Click 'add new proxy' and choose the Zone and settings you require, click 'save'.
* In Playwright, under the 'server', input your local IP and Proxy Manager port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`. For example, `24000`
* Leave the username and password values empty, as the Bright Data Proxy Manager has already been authenticated with the Super Proxy.
* For example:

```js Sample Code theme={null}
const playwright = require('playwright');

(async () => {
	for (const browserType of ['chromium', 'firefox', 'webkit']) {
		const browser = await playwright[browserType].launch({
			headless: false;
			proxy: {
				server: '127.0.0.1:24000',
				username: '',
				password: ''
			},
		});
		const context = await browser.newContext();
		const page = await context.newPage();
		await page.goto('https://brdtest.com/myip.json');
		await page.screenshot({ path: 'example.png' });
		await browser.close();
	}
})();
```

## Integrate with Jarvee Proxy

* In Jarvee, on the left-hand side, choose the 'Proxy Manager' Tab.
* Click 'Add proxy' and under the 'Select Proxy IP: Port' column input the IP:Port (i.e. `127.0.0.1:24000`)
  * The local host IP is `127.0.0.1`
  * The port created in the Proxy Manager is `24XXX`, for example, `24000`
* Leave the username and password field empty, as the Bright Data Proxy Manager has already been authenticated
* Click 'Verify Proxy Link'.
* Under 'Social Profiles', select the Jarvee profile you created and click the 'Add' button.

<Frame>
  <img alt="Proxy Manager Integration" />
</Frame>

## Integrate with VMLogin Proxy

Register and manage multiple online accounts using physical devices with VMLogin's virtual browsing profiles which helps enable anti-association capabilities as well as fingerprint protection.

Manage multiple online accounts using physical devices with VMLogin's virtual browsing profiles which helps enable anti-association capabilities as well as fingerprint protection.

Here is a step by step guide to integrate Bright Data with VMlogin:

* Download and install VMLogin [here](https://vmlogin.us/?ref=luminati) (3 Days Free Trial)
* Start by launching VMLogin and creating a new browser profile:
  * Click "Get random profile"
  * Select the settings that best suit you, such as operating system, screen resolution, language, WebGL vendor, time zone, media device fingerprint etc.


# Introduction to Proxy Manager
Source: https://docs.brightdata.com/products/proxy-manager/introduction

Control, monitor, and customize Bright Data proxies with the open-source Proxy Manager. Apply routing rules, integrate via API, or manage from the UI.

Bright Data Proxy Manager is an application where you can control, manage, and monitor all of your proxies either from our app interface or via API.

It is an advanced open-source application tool ([GitHub](https://github.com/luminati-io/luminati-proxy)) built by developers, for developers and allows unique proxy customization, rules implementation, and integration of external proxies.

## Best For:

* Automating waterfalls between different [proxy products](https://brightdata.com/pricing/proxy-network?plan=yearly\&type=res_rotating) and IPs
* Reducing Bandwith with rules that block certain types of data
* Monitoring HAR logs with live preview of the whole traffic
* User access management by allowlisting or generating API keys
* Teams that are looking to customize and manage their proxy flows and infrastructure


# Create your first Proxy Manager
Source: https://docs.brightdata.com/products/proxy-manager/quickstart

Get started with Bright Data Proxy Manager (default port 22999). Choose Cloud Server or On-Premise install, then configure your first managed proxy port.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title="Select your preferred method">
    <CardGroup>
      <Card title="Cloud Server (Recommended)" href="/products/proxy-manager/configuration#bright-data-cloud-hosting" icon="cloud" />

      <Card title="On-Premise" href="/products/proxy-manager/configuration#local-remote-installation" icon="house">
        You take care of the installation, management, and monitoring
      </Card>
    </CardGroup>

    <Accordion title="Cloud Server Benefits">
      * No installation or server setup necessary - Log-in straight to our [web app](https://brightdata.com/cp/zones/lpm) from anywhere

      * Managed end-to-end solution

      * Live server status monitoring by Bright Data's 24/7 team. To see further info on installation and setup see the [Introduction video](https://brightdata.com/webinar/how-to-start-using-the-bright-data-proxy-manager).

      * SSL analyzing support with OpenSSL and BoringSSL. BoringSSL is Bright Data's own implementation and provides additional unblocking value.
    </Accordion>
  </Step>

  <Step title="Start managing your proxies">
    Once Proxy Manager is installed, you can [log-in](https://brightdata.com/cp/zones/lpm) and start managing your proxies by [setting up ports](/products/proxy-manager/configuration#port-targeting-configuration) configured with your zone settings.
  </Step>

  <Step title="Implement rules and headers">
    Now you can [implement rules and headers](/products/proxy-manager/configuration#rules-and-headers-configuration) to customize your proxies to your needs. This will ensure a more cost-optimized usage of bandwidth and more accurate results.
  </Step>
</Steps>


# Secure your Proxy Manager setup
Source: https://docs.brightdata.com/products/proxy-manager/security

Best practices for securing your Bright Data Proxy Manager (default port 22999), including IP allowlisting, admin access control and API key-based auth.

Ensuring the security of our products is crucial and remains a top priority for us. Our state-of-the-art architecture allows us to deliver you our Cloud hosted Proxy Manager with complete reliability and security and recommend this option for all of our customers.

For those that need an **on-premise** option for proxy manager (which is not hosted by Bright Data), we have outlined below the security measures that we recommend and best practices for putting them to use.

## Block unwanted sources from using the Proxy Manager's ports

Allowlist IPs on all your ports inside the Proxy Manager to ensure usage on those ports is only from allowed and wanted sources. While this feature is enabled, only the listed IPs will be allowed to send requests through the port with this configuration. Using this feature will ensure the bandwidth you pay for is consumed only by trusted sources.

## Block unwanted users from editing the Proxy Manager settings

Allowlist admin access to ensure only authorized IPs can perform changes to your Proxy Manager settings. This will block the admin page and the [Proxy Manager's API](/api-reference/proxy-manager/get_the_latest_proxy_manager_versions) when it is accessed from outside the server (where the Proxy Manager is hosted) from IPs which are not allowlisted.

## Authentication using API key

If you are using multiple crawlers with changing IPs to send requests to remote Proxy Manager server you will need to generate an API key to use for authentication on the Proxy Manager:

* Run Bright Data process from inside the server
* From the Proxy Manager's server run in terminal/command line:

```sh theme={null}
curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
```

* You should be seeing the token response:

```js theme={null}
"token": "API key"
```

After generating an API key you have two options: either use the API key to allowlist the new IP once when the crawler server is set up or include the API key in the proxy auth of each request:

To make requests use the API key in the proxy auth use username "token" and the API key as the password, for example:

```sh theme={null}
curl -x token:API_KEY@127.0.0.1:24000 "http://brdtest.com/myip.json"
```

To allowlist your new server IP so you don't need to send it in proxy auth:

* Copy the API\_KEY from Proxy Manager server to new crawler server
* Make this request from your new server:

```sh theme={null}
curl [REMOTE_SERVER_IP]:22999/api/add_wip -X POST -H "Content-Type: application/json" -H "Authorization:[API_KEY]" -d '{"ip":"[CRAWLER_IP]"}'
```

* Your crawler ip is now allowlisted on the Proxy Manager

<Info>
  This will not give access to the Proxy Manager's admin panel but only to send requests through the ports
</Info>

## Local Network

If you want to access Proxy Manager from a network where many people share the same IP then allowlisting IP is not strong enough for you. By allowlisting your IP you are giving an access to all the people from the same local network (corporate environments often look like that).

Use `local_login` flag and Proxy Manager will require authentication from each browser separately and a newly generated API key will be stored in the cookies.

```sh Example theme={null}
pmgr --local_login
```


# How to configure your Residential proxy
Source: https://docs.brightdata.com/products/residential/configure-your-proxy

Configure Bright Data Residential proxies (400M+ residential IPs): IP types, geolocation targeting, long-session peers, sticky IP duration and rotation.

Start by going to the configuration tab of the proxy you want to configure.

## Which proxy type to choose

**Choose one of four Proxy types (IPs types) for your proxy zone:**

<CardGroup>
  <Card title="Shared IPv4 proxies" icon="square-1">
    Rotating **IPv4** proxies worldwide, of real devices, worldwide.
  </Card>

  <Card title="Shared IPv4 & IPv6 Proxies" icon="square-2">
    A combined pool or rotating **IPv4 & IPv6** proxies of real devices, worldwide.
    Our "Mega Pool".
  </Card>

  <Card title="Shared IPv6 Proxies" icon="square-3">
    Rotating **IPv6** proxies worldwide, of real devices, worldwide.
  </Card>

  <Card title="Dedicated proxies" icon="square-4">
    Sets of proxies with exclusive access to a set of specific domains, with minimal to no rotation at all.
  </Card>
</CardGroup>

***

## Selecting the right Residential proxies

We offer 4 types of proxies on our Residential proxy network:

Shared proxies:

1. Shared IPv4
2. Shared IPv4+IPv6 ("Mega pool")
3. Shared IPv6

Dedicated proxies:

4. Dedicated residential proxies

## Residential network access

Access to the Residential network requires KYC approval by the Bright Data compliance team and is available to verified companies only. This applies to every Residential proxy type, including shared, IPv6 and dedicated. For more information, see the [Residential network access policy](/products/residential/network-access).

## Configuring Residential shared proxies (Rotating proxies)

Bright data will automatically assign a new proxy for each of your requests. You can control the behavior of the shared proxies as well as rotation using control panel settings and proxy options which are relayed in the proxy username parameter.

Most common setup is the Geolocation targeting allowing you to route your requests via proxies in specified location. You can select a default location - which will route all requests thru specific locations via our control panel.

<Tip>
  Best practice: set up a separate residential proxy zone, for each geolocation you wish to target.
</Tip>

### Geolocation resolution options

Geolocation targeting allows you to target specific locations based on `country`,`city`, `state`, `zip code`, or `ASN`. Select the resolution from the drop-down menu in your geolocation settings:

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

### Shared pool default countries' selection

When selecting countries in shared pool configuration, we will assign proxies only from the locations you select. You can select none (which means we will assign the next random proxy from the pool), one or more countries. [Read more...](/api-reference/proxy/geolocation-targeting#default-countries-selection)

You can override the default selection or explicitly assign a specific country for your peer during rotation, use the flag `-country` in the proxy user name parameter with an ISO-3166 country code.

[FAQ: Where can I see the list of country codes?](/general/faqs#where-can-i-see-the-list-of-country-codes)

***

## How to configure IPv4+IPv6 Shared residential proxies: "Mega Pool"

### Introduction: IPv6

Bright Data now supports IPv6 on its residential network. Setup and use of IPv6 proxies is very similar to IPv4 proxies. 

IPv6 (Internet Protocol version 6) is the most recent version of the Internet Protocol, designed to replace IPv4. It was developed to address the limitations of IPv4, particularly the exhaustion of available IP addresses. While IPv4 uses 32-bit addresses (allowing for about 4.3 billion unique IPs), IPv6 uses 128-bit addresses, enabling a virtually unlimited number of unique IP addresses, over 340 undecillion (3.4×10³⁸).

What types of IPv6 Residential pools do we offer?

Bright data offers two types of residential pools with IPv6 proxies:

1. Combined IPv4+IPv6: also called "Mega Pool", of shared rotating proxies
2. IPv6 only shared rotating proxies

Bright Data currently does not offer IPv6 proxies in Datacenter or ISP networks.

### How big is IPv6 residential network?

We now support IPv6 on our worldwide reliable residential proxy network. Approximately 150,000 peers are available, with new ones joining every week. The proxies are collated in our “rotating shared pool” of residential proxies. 

### What is IPv6 Access Policy?

IPv6 proxies follow the [Residential network access policy](/products/residential/network-access). They are available only to KYC-verified companies that are eligible to use this protocol over the Residential network. 

### Which options of Bright Data residential IPv6 proxies can I use?

All our IPv4 options are supported, except the list below:

| Targeting Option | Description |
| :- | :- |
| `gip` | No selected gIP targeting (group of residential IPs) |
| `asn` | No ASN targeting |
| `zip` | No ZIP code targeting |
| `ip` | No explicit IP targeting |
| `carrier` | No mobile carrier targeting |
| `os` | No explicit operating system targeting |

If you chose to relay those in your proxy username and your zone was set to IPv6, we will ignore them and process the request. 

Full list of options can be found here: <u>[https://docs.brightdata.com/proxy-networks/config-options](https://docs.brightdata.com/proxy-networks/config-options)</u>

### What happens if I target IPv4 only host with IPv6 proxy?

If you choose to target with IPv6 proxy an IPv4 only domain, which do not have an IPv6 address, your request will result in HTTP error 502, with Bright Data error header (x-brd-err-code): `target_40011`. You should retry the request with IPv4 proxy. 

Full list of errors can be seen in our catalog, together with target\_40011 here: <u>[https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011](https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011)</u>

### Can I switch a zone from IPv4 to IPv6 and vice versa?

Yes. You can switch the zone from IPv4 to IPv6 and vice versa without any limitation. Once protocol version is chosen, it will impact all the proxies assigned to this zone and the selected protocol proxies will be assigned to relay your requests.

### Does the price of IPv6 traffic changes?

IPv6 traffic is currently charged at the same rate as IPv4. In your bill we will calculate how much traffic was relayed by which protocol version and charge accordingly. You can switch your zone between IPv6 and IPv4 - Bright Data will calculate the traffic and bill accordingly. 

### Is there any change in access details or proxy credentials for IPv6?

No. All access details and credentials are identical to IPv4: Host, port, username and password remain the same. If you provide a username with parameters which are not supported in IPv6 (listed above) they will be ignored.

### Can I use IPv6 to access Bright Data proxy services?

No. We do not allow IPv6 to access our own proxy gateway: your accessing scraper or utility must connect to Bright Data using IPv4. Attempting to access with IPv6 will result in error. The error will be DNS related error stating that domain [brd.superproxy.io](http://brd.superproxy.io) could not be resolved.

Example with curl call:

```sh theme={null}
curl -i --proxy brd.superproxy.io:44445 --proxy-user brd-customer-*******-zone-residential_proxy21:********** "https://geo.brdtest.com/welcome.txt?product=resi&method=native" -g -6
```

Response error:

```sh theme={null}
curl: (5) Could not resolve proxy: [brd.superproxy.io](http://brd.superproxy.io)
```

#### Do I need to define allowlist and denylist in IPv6?

No. Allowlist (whitelist) and denylist (blacklist) refer to the IP addresses you use to connect to Bright Data proxy services. Since we allow only IPv4 to connect to our proxy service from your side, settings remain in IPv4 even if the zone is IPv6. Those lists determine which IPs can/cannot send requests to the zone and remain as IPv4 IPs and ranges. 

## Configuring dedicated residential proxies access

Dedicated Residential proxies are available **only** after KYC approval by the Bright Data compliance team. Until your account is KYC-verified, the **Dedicated** option stays **disabled** in the control panel. For details, see the [Residential network access policy](/products/residential/network-access).

<Note>
  To create a dedicated Residential zone via API, see the [Dedicated Residential (gIP) zone example in Add a zone](/api-reference/account-management-api/Add_a_Zone#dedicated-residential-gip-zone).
</Note>

### IP Groups `gIPs`

<Note>
  Only works with the **Dedicated** option
</Note>

`gIP` contains between 6-90 IPs at any given moment while sharing the same attributes, targeting the selected dedicated domains within the zone "Configuration" section. `gIPs` are used by Bright Data to create a single identifier for this group of proxies (with distinct IP addresses). Those proxies will be used explicitly by you towards the domains you target.

<Frame>
  <img alt="Geolocation Targeting" />
</Frame>

***

### How to set dedicated domains

<Warning>
  Only works with the **Dedicated** option
</Warning>

Define the domains you'd like your proxies to be exclusive to. Every request to a domain in this list is served thru your dedicated proxies exclusively. No one else is allowed to target those domains via your dedicated proxies. You can use this zone for requests to other target domains, yet those requests will be served thru our datacenter hosted Bright Data proxies.

For example: if in the list you have two domains: a.com and b.com, every request to a.com and b.com are routed thru your dedicated proxies, request to c.com is routed thru our datacenter hosted proxy. Requests to a.com and b.com from others will **never** go thru your dedicated proxies.

<Frame>
  <img alt="Domains" />
</Frame>

***

## How to configure advanced options

### Automatic failover for unavailable peers

In case we cannot reach the proxy peer for your request, we will route the request to another available peer. Automatic failover does not apply when you choose default countries: if we cannot find a peer in the country you selected, we will fail the request with error.

Enabling automatic failover assures execution of the request, regardless of the availability of a specific peer.

#### Automatic failover when accessing target website which does not publish IPv6 address with IPv6 proxy

To ensure continuity, we enable IPv6 to IPv4 automatic failover, which you can configure in the zone's advanced settings to either on or off (default: `ON`).

When toggled "On" (default), in case your target website does not publish an IPv6 address, we will route the request via an available IPv4 proxy in the same location. If this toggle is not enabled, trying to access a target host without IPv6 address will result in an error: [https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011](https://docs.brightdata.com/proxy-networks/errorCatalog#target-40011)

***

### Special Ports & Protocols

Ports `80` and `443` are available by default, supporting HTTP and HTTPS & SOCKS5 protocols. We also support all ports over `1024` in our Datacenter proxy network. [Read more on ports and protocols...](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols)

<Accordion title="Request Additional ports">
  Bright Data can support additional ports by request. A dedicated and additional compliance process with the Bright Data compliance team will follow every request to support a new port.
  If you would like additional port permissions, you can contact Bright Data Support.
  Examples of ports that require Bright Data compliance review before activation:

  | Port | Protocol |
  | - | - |
  | `70` | HTTP |
  | `98` | HTTPS |
</Accordion>

### Zone usage limit

A zone usage limit is an optional cap you set on a Residential proxy zone so it cannot consume more than a fixed amount of spending or traffic. Use it to keep a single zone inside a known budget and bandwidth envelope, which matters most on rotating shared pool proxies where consumption scales with request volume.

You can cap a zone in one of two ways:

* **Spending limit:** cap the amount the zone is allowed to spend.
* **Traffic limit:** cap the amount of bandwidth the zone is allowed to use.

#### When to use a spending limit vs a traffic limit

* Choose a **spending limit** when your priority is cost control and you want a hard ceiling on what a zone can bill.
* Choose a **traffic limit** when your priority is bandwidth control, for example to stop one project or zone from exhausting a shared bandwidth allocation.

#### How to set a zone usage limit

Set a usage limit from the proxy page:

1. Open the [My proxies](https://brightdata.com/cp/zones) page.
2. Click the proxy you want to limit.
3. Open the **Configuration** tab.
4. Scroll to **Advanced settings** and find **Usage limit**.
5. Switch on **Usage limit**.
6. Enable the spend or traffic limit.
7. Set the limit you want by choosing one of: `$/day`, `$/month`, `bytes/day` or `bytes/month`.
   Click **update**.

<Note>
  When the limit is reached, the zone can be suspended, alerted or both, depending on your configuration. The limit is checked every 15 minutes, so it may not take effect immediately. If traffic is high, usage stats can lag. You can recalculate them from the zone's **Statistics** table using the **recalc** button.
</Note>

To see how much a zone is consuming against its limit, review your zone usage in the dashboard. For more detail, see [Usage monitoring](/general/usage-monitoring/Usage) and the [bandwidth usage limits FAQ](/general/faqs). For background on bandwidth fairness on shared pools, see [Fair use allowance](/general/usage-monitoring/fair_use_allowance).


# Residential products FAQ
Source: https://docs.brightdata.com/products/residential/faqs

FAQs about Bright Data Residential proxies (400M+ residential IPs): IP types, country coverage, geotargeting, session control and common error codes.

<AccordionGroup>
  <Accordion title="Why do I need KYC for Residential proxies?">
    Bright Data Residential proxies are available only to verified companies that pass a human-reviewed KYC (Know Your Customer) check by the Bright Data compliance team. Residential IPs come from 100% real people who opted in to the network, so the compliance team verifies your business and use case before you route traffic through them. Approval is never automatic or instant. See the [Residential network access policy](/products/residential/network-access) for the full process.
  </Accordion>

  <Accordion title="I signed up with a personal email. Can I use Residential?">
    No. Residential access is granted to verified companies only. KYC applications are accepted only from registered businesses with a corporate email domain, so a personal-email account (for example Gmail or Outlook) cannot be approved. Add a user with your company email domain, then submit [KYC](https://brightdata.com/cp/kyc). Without KYC you can use [ISP proxies](/products/isp/introduction), [Datacenter proxies](/products/data-center/introduction) and the [Web Unlocker API](/products/web-unlocker/introduction).
  </Accordion>

  <Accordion title="Can I switch my existing ISP or Datacenter zone to Residential?">
    Only after KYC approval. Creating or converting a zone to Residential is blocked until the Bright Data compliance team approves your KYC submission. Your existing ISP and Datacenter zones keep working while your KYC is under review. Start at [KYC verification](https://brightdata.com/cp/kyc).
  </Accordion>

  <Accordion title="What can I use without KYC?">
    Use these alternatives to Residential proxies, none of which require KYC:

    * **[ISP proxies](/products/isp/introduction):** static, residential-registered IPs with datacenter speed, for ad verification, QA and long, stable sessions.
    * **[Datacenter proxies](/products/data-center/introduction):** fast, low-cost shared or dedicated IPs for high-volume requests.
    * **[Web Unlocker API](/products/web-unlocker/introduction):** managed unblocking that handles headers, cookies, CAPTCHAs and retries, billed per successful request.

    These are alternatives, not a limited or trial Residential mode.
  </Accordion>

  <Accordion title="How to integrate a new proxy into your code?">
    To integrate the proxies into your code, please visit the [API examples page](https://brightdata.com/cp/zones/proxy_examples), which can be accessed via your proxy's **Overview** tab, under "Access details":

    <img alt="integrate-new-proxy.gif" />

    On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
  </Accordion>

  <Accordion title="How to integrate a proxy into 3rd party software?">
    Check out a few examples in the [API examples](https://brightdata.com/cp/zones/proxy_examples) page mentioned above (just choose "other software" in the "language" drop-down menu), or check our [Integrations page](/integrations/introduction), where we have specific guides to integrate our proxies within the most popular tools across the industry today.

    **Important note**: If you are using Bright Data's Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See [instructions here](/general/account/ssl-certificate).

    We have prepared detailed guides for the most commonly used tools. You can find links to the guides in the list below:

    BrowserScan 	[https://docs.brightdata.com/integrations/browserscan](/integrations/browserscan)

    XLogin 		[https://docs.brightdata.com/integrations/xlogin](/integrations/xlogin)

    GeeLark 	[https://docs.brightdata.com/integrations/geelark](/integrations/geelark)

    Puppeteer 	[https://docs.brightdata.com/integrations/puppeteer](/integrations/puppeteer)

    Playwright 	[https://docs.brightdata.com/integrations/playwright](/integrations/playwright)

    Selenium 	[https://docs.brightdata.com/integrations/selenium](/integrations/selenium)

    AdsPower 	[https://docs.brightdata.com/integrations/adspower](/integrations/adspower)

    Dolphin Anty 	[https://docs.brightdata.com/integrations/dolphin-anty](/integrations/dolphin-anty)

    Incogniton 	[https://docs.brightdata.com/integrations/incogniton](/integrations/incogniton)

    Marketerbrowser [https://docs.brightdata.com/integrations/marketerbrowser](/integrations/marketerbrowser)

    SMLOGIN 	[https://docs.brightdata.com/integrations/smlogin](/integrations/smlogin)

    Hidemyacc 	[https://docs.brightdata.com/integrations/hidemyacc](/integrations/hidemyacc)

    OpenBullet	[https://docs.brightdata.com/integrations/openbullet](/integrations/openbullet)

    Switchyomega 	[https://docs.brightdata.com/integrations/switchyomega](/integrations/switchyomega)

    PhantomBuster 	[https://docs.brightdata.com/integrations/phantombuster](/integrations/phantombuster)

    BitBrowser 	[https://docs.brightdata.com/integrations/bitbrowser](/integrations/bitbrowser)

    Maskfog 	[https://docs.brightdata.com/integrations/maskfog](/integrations/maskfog)

    Ghost Browser 	[https://docs.brightdata.com/integrations/ghost-browser](/integrations/ghost-browser)

    Postman 	[https://docs.brightdata.com/integrations/postman](/integrations/postman)

    NGINX 		[https://docs.brightdata.com/integrations/nginx](/integrations/nginx)

    StablerSOLO 	[https://docs.brightdata.com/integrations/stablersolo](/integrations/stablersolo)

    VMLogin 	[https://docs.brightdata.com/integrations/vmlogin](/integrations/vmlogin)

    GoLogin 	[https://docs.brightdata.com/integrations/gologin](/integrations/gologin)

    Windows 	[https://docs.brightdata.com/integrations/windows](/integrations/windows)

    Scrapy 		[https://docs.brightdata.com/integrations/scrapy](/integrations/scrapy)

    AEZAKMI 	[https://docs.brightdata.com/integrations/aezakmi](/integrations/aezakmi)

    Beautifulsoup 	[https://docs.brightdata.com/integrations/beautifulsoup](/integrations/beautifulsoup)

    WebHarvy 	[https://docs.brightdata.com/integrations/webharvy](/integrations/webharvy)

    Ubuntu 		[https://docs.brightdata.com/integrations/ubuntu](/integrations/ubuntu)

    Lalicat 	[https://docs.brightdata.com/integrations/lalicat](/integrations/lalicat)

    Multilogin 	[https://docs.brightdata.com/integrations/multilogin](/integrations/multilogin)

    Undetectable 	[https://docs.brightdata.com/integrations/undetectable](/integrations/undetectable)

    Apify 		[https://docs.brightdata.com/integrations/apify](/integrations/apify)

    iPhone 		[https://docs.brightdata.com/integrations/ios](/integrations/ios)

    MuLogin 	[https://docs.brightdata.com/integrations/mulogin](/integrations/mulogin)

    Changedetection [https://docs.brightdata.com/integrations/changedetection](/integrations/changedetection)

    Morelogin 	[https://docs.brightdata.com/integrations/morelogin](/integrations/morelogin)

    Proxifier 	[https://docs.brightdata.com/integrations/proxifier](/integrations/proxifier)

    Texau 		[https://docs.brightdata.com/integrations/texau](/integrations/texau)

    Android 	[https://docs.brightdata.com/integrations/android](/integrations/android)

    Kameleo 	[https://docs.brightdata.com/integrations/kameleo](/integrations/kameleo)

    Screaming Frog 	[https://docs.brightdata.com/integrations/screaming-frog](/integrations/screaming-frog)

    Foxy		[https://docs.brightdata.com/integrations/foxyproxy](/integrations/foxyproxy)

    SessionBox 	[https://docs.brightdata.com/integrations/sessionbox](/integrations/sessionbox)

    Insomniac 	[https://docs.brightdata.com/integrations/insomniac](/integrations/insomniac)

    Helium Scraper 	[https://docs.brightdata.com/integrations/helium-scraper](/integrations/helium-scraper)

    SaleFreaks 	[https://docs.brightdata.com/integrations/salefreaks](/integrations/salefreaks)

    Postern 	[https://docs.brightdata.com/integrations/postern](/integrations/postern)

    Antik 		[https://docs.brightdata.com/integrations/antik](/integrations/antik)

    Easync 		[https://docs.brightdata.com/integrations/easync](/integrations/easync)

    ParseHub 	[https://docs.brightdata.com/integrations/parsehub](/integrations/parsehub)

    Sphere Browser 	[https://docs.brightdata.com/integrations/sphere-browser](/integrations/sphere-browser)

    Octoparse 	[https://docs.brightdata.com/integrations/octoparse](/integrations/octoparse)

    ixBrowser 	[https://docs.brightdata.com/integrations/ixbrowser](/integrations/ixbrowser)

    Shadowrocket 	[https://docs.brightdata.com/integrations/shadowrocket](/integrations/shadowrocket)

    Firefox 	[https://docs.brightdata.com/integrations/firefox](/integrations/firefox)

    Chrome 		[https://docs.brightdata.com/integrations/chrome](/integrations/chrome)

    MacOS 		[https://docs.brightdata.com/integrations/macos](/integrations/macos)

    ClonBrowser 	[https://docs.brightdata.com/integrations/clonbrowser](/integrations/clonbrowser)

    Octo Browser 	[https://docs.brightdata.com/integrations/octobrowser](/integrations/octobrowser)

    Genlogin 	[https://docs.brightdata.com/integrations/genlogin](/integrations/genlogin)

    Web Scraper 	[https://docs.brightdata.com/integrations/webscraper](/integrations/webscraper)

    If the integration you're using does not appear on the list and you would like to get a guide for it, contact us!
  </Accordion>

  <Accordion title="How to target a Specific Country?">
    When sending your request, add the `-country` flag, **after** your zone’s name in the request, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    In the example below: We added `-country-us` to our request, so we will send a request originating from the United States ("us").

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password>
    ```
  </Accordion>

  <Accordion title="How to target the EU region">
    <Note>
      The allocation of a country within the EU is random.
    </Note>

    <Info>
      Relevant for DC, ISP, and Unlocker/SERP API
    </Info>

    You can target the entire European Union region in the same manner as "Country" above by adding "eu" after "country" in your request: -country-eu

    Requests sent using -country-eu, will use IPs from **one** of the countries below which are included automatically within "eu":

    ```text theme={null}
    AL, AZ, KG, BA, UZ, BI, XK, SM, DE, AT, CH, UK, GB, IE, IM, FR, ES, NL, IT, PT, BE, AD, MT, MC, MA, LU, TN, DZ, GI, LI, SE, DK, FI, NO, AX, IS, GG, JE, EU, GL, VA, FX, FO
    ```
  </Accordion>

  <Accordion title="How to target a Specific City?">
    City targeting works with residential proxies. City targeting for Datacenter and ISP proxies has been deprecated and is no longer available.

    When configuring your proxy zone, after selecting your preferred country, you can add a city, to further specify your geotargeting

    <img alt="add-city.png" />

    Once you click on **'Add city'** you will be displayed the available cities to target, for the selected country. In order to check the [number of available IPs](https://brightdata.com/cp/ips_availability) for a specific geolocation.

    Once configured, you'll be able to send requests from the selected city, using the following syntax

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-<country>-city-<city>:<zone_password>
    ```

    <Note>
      When selecting a two-word city it'll be written as one word.

      For example, when targeting Buenos Aires the syntax of the request will be:

      `-country-ar-city-buenosaires`
    </Note>

    To view more geotargeting examples, you may want to review our [proxy integration examples page.](https://brightdata.com/cp/zones/proxy_examples)
  </Accordion>

  <Accordion title="Where does Bright Data have proxies?">
    Bright Data offers proxies in every country in the world, except in the following countries:

    * Iran
    * Iraq
    * Syria
    * Lebanon
    * Palestine
    * North Korea
    * Cuba
    * Sudan
    * Belarus
    * Russia

    If you need proxies from these countries, unfortunately Bright Data will not be able to help you.
  </Accordion>

  <Accordion title="How to view the proxy event log?">
    The event log will show you (at most) the last 200 requests you made with any zone in your account.

    In your Bright Data control panel's proxies page: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    Go to the "Event Log" tab:

    <img alt="event-log.png" />

    The presented data is:

    * **Date:** Time and date of the request
    * **Zone:** What Zone was used for the request
    * **Source IP:** What IP the request was made from
    * **URL:** The target site of the request
    * **Result:** Success or Fail of the request

      <img alt="event-log-headers.png" />
  </Accordion>

  <Accordion title="How to keep using the same IP in multiple requests?">
    * This can be done by adding the `session` parameter to the proxy username:

    ```sh theme={null}
    brd.superproxy.io:44445 br-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.

    * Session ID can be any random string/counter: requests with the same session string will use the same Proxy Peer (as long as possible); requests with different session strings will be assigned different Proxy Peers.

    <Warning>
      - Using the following characters in the session ID will throw an error: `-` `"` \`\`\`
      - This feature is only available for our proxy products, it will **not** work for Scraping Automation products such as the Web Unlocker API
    </Warning>

    * To force an IP change, just modify the session ID
    * If an assigned Proxy Peer (exit node IP) becomes unavailable, the Super Proxy will return an error "502 - No peers available" for the first request and then on the second request the super proxy will assign a new peer even if you do not change the session ID.
    * The Session IP is kept persistent for up to 5 minute of idle time. After 5 minutes with no requests, the IP is released back to the pool. To keep this Session/IP for longer, send a tiny keep-alive request every 30 seconds, to prevent this session from becoming idle for over a minute. This request may be anything small, such as /favicon.ico, or even a request that returns 404 (as long as the web server does not disconnect the socket due to this request).
  </Accordion>

  <Accordion title="How to target specific OS?">
    Bright Data allows targeting the following **Operating Systems**:

    <CodeGroup>
      ```sh Windows theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh macOS theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh Android theme={null}
      curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to use a specific IP?">
    When using Bright Data's Residential Proxy network, you may find the need to use a specific IP allocated to your zone.

    1. **Send a test request** with a '--verbose' or '-v' option added (this will turn on verbose logging)

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --verbose --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    2. **Locate** the x-brd-ip response header and copy its value

       <img alt="x-brd-ip.png" />

    3. **Add** the -ip- flag to your request, after your zone’s name and use the **hashed IP value** copied in the previous step

    4. Send a test request, and **review the response**

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://brdtest.com/myip.json](https://brdtest.com/myip.json) as the target domain for testing, and to review your IP credentials.
  </Accordion>

  <Accordion title="How to targeting an ASN specific IP?">
    This feature can be enabled by adding the ASN parameter to your Zone configuration, under **Geolocation Targeting**.

    <img alt="asn-targeting.png" />

    Once the configuration is saved, the ASN flag can be added to the Zone's credentials\
    and be integrated when using the Residential proxies. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **Note:** Values for ASN number can be found [here](https://bgp.potaroo.net/cidr/autnums.html).
  </Accordion>

  <Accordion title="How to target residential proxy using group IP (gIPs)?">
    Dedicated residential IPs can be targeted in the form of [gIPs](/products/residential/configure-your-proxy#ip-groups-gips). They can be allocated under the zone's configuration page by selecting a "Dedicated" IP type and choosing a number of gips. Also targeting a specific domain is required.

    <img alt="number-of-dedicated-gIPs.png" />

    Once the configuration is saved, selecting "Show allocated Dedicated residential IPs" will provide a list of hash values that represent group IPs.

    <img alt="show-allocated-dedicated-ips.png" />

    These values can be used to target a specific gip. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese Residentials IPs">
    **When outside of China**\
    Targeting Chinese Residential IP peers is enough:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="Carrier-specific Proxy peer IP">
    * You can choose to use a specific carrier from this list:

    ```text theme={null}
    a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, 
    dt, docomo, dtac, etisalat, idea,  meo, mtn, mtnza, 
    optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, 
    tmobile, tigo, tim, verizon,  vodacomza, vodafone, vivo, zain,
    vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, 
    cellc, ooredoo, drei, umobile, cableone, proximus, mobitel, o2, 
    bouygues, free, sfr, digicel
    ```

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Which Bright Data products are best for scraping search engines (SERPs)?">
    #### For single-step scraping:

    [SERP API](/products/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.

    #### For multi-step scraping (playwright/puppeteer/selenium):

    [Browser API](/products/scraping-browser/introduction) is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
  </Accordion>

  <Accordion title="Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?">
    **Residential Proxy** - No, [SERP API](/products/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.

    **Datacenter & ISP Proxies** - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:

    ```text theme={null}
    HTTP/1.1 403 Search engine host is not allowed
    X-Luminati-Error: Forbidden: This target URL isn't supported on proxy networks, use the SERP API product for targeting this URL. You may contact your account manager or open a support ticket for assistance
    ```
  </Accordion>

  <Accordion title="Targeting search engines via bright data Residential & Mobile networks">
    When targeting search engines through the Residential or Mobile networks, the request will not go through the Residential or Mobile peer but instead will be sent directly through one of our super proxies. The reason for this behavior is to support the integration of the Residential and Mobile networks with a browser, which might need to load search engine resource endpoints from the target website.

    **In case you target a search engine domain using Residential or Mobile networks, the request will be passed directly through the super proxy, and the following response header will serve as an indication:**

    ```sh theme={null}
    x-brd-ip: superproxy bypass
    ```
  </Accordion>

  <Accordion title="How can I see the IP address of my Residential proxy? ">
    Bright Data does not allow to see an open text version of your Residential and Mobile IP addresses. Datacenter and ISP Proxy IPs are open in clear text format. 

    When you send a request, in the reply header, you will see a reply header of `x-brd-ip` . This reply header includes a unique hash which represents the IP address you used for this request. 
  </Accordion>
</AccordionGroup>


# Introduction to Residential proxies
Source: https://docs.brightdata.com/products/residential/introduction

Bright Data Residential proxy network: 400M+ monthly residential IPs from 195+ countries for browsing and data collection as a real user.

Bright Data's [Residential proxy network](https://brightdata.com/proxy-types/residential-proxies) routes your traffic through 400M+ real residential IPs across 195+ countries, so target sites see your requests as genuine local users. It is built for accessing sophisticated, highly protected sites that block datacenter and automated traffic.

Unlike Datacenter proxies, Residential proxies route requests through real devices owned by real users who have opted in to the network and are compensated for participating. This makes your traffic appear to originate from authentic residential connections in the location you target.

```sh Native proxy access theme={null}
curl "http://brdtest.com/myip.json" \
  --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
```

The response reports the exit IP and its location. See [Send your first request](/products/residential/send-your-first-request) for Python, Node.js and cURL examples.

## How do Residential proxies work?

When you send a request through the Residential proxy network, Bright Data routes it through a real residential device in your chosen target region. For each request, the network automatically:

* Selects an appropriate residential IP from the target location
* Manages IP availability and rotation
* Maintains session stability when a sticky session is required
* Handles network-level reliability and scaling

Because the request originates from a real household or mobile connection, sites perceive the traffic as a genuine end user rather than a server-based proxy.

## Why use Residential proxies?

Residential proxies give you the widest pool and the most authentic footprint of any Bright Data proxy type:

* Higher success rates on sites with strict anti-bot or anti-scraping defenses than Datacenter proxies
* Access to localized content such as regional pricing, language variations and geo-restricted pages
* A 400M+ IP pool that lowers the chance of hitting a blocked or reused address
* Infrastructure that scales from a single request to production workloads

## When should you use Residential proxies?

Residential proxies are well suited for:

* Browsing and interacting with sophisticated websites as a real user
* Business intelligence, market research and competitor monitoring
* Ad verification and brand protection across different regions
* Price comparison and product availability tracking
* Cases where [Datacenter proxies](/products/data-center/introduction) or [ISP proxies](/products/isp/introduction) return low success rates or frequent blocks

If you currently hit access issues with Datacenter or ISP proxies, switching to Residential proxies can significantly improve reliability.

## What geographic targeting is available?

The Residential proxy network supports fine-grained targeting. You can route traffic through IPs by:

* Country
* State or region (where supported)
* City
* ZIP code (United States only)
* ASN and carrier (depending on proxy configuration)

## How is the Residential proxy network sourced?

Bright Data's Residential proxy network is built on an explicit opt-in model. Every participant:

* Is informed about how their IP is used
* Provides consent through an approved application
* Is compensated for participating

This model keeps the network compliant with data protection regulations and supports responsible, transparent use of residential IPs.

## FAQ

### How many Residential IPs does Bright Data have?

The Residential proxy network provides 400M+ residential IPs across 195+ countries, refreshed monthly.

### How are Residential proxies different from ISP and Datacenter proxies?

Residential IPs come from real end-user devices, so they are far less likely to be blocked by strict anti-bot systems than Datacenter proxies. ISP proxies offer datacenter speed with residential-registered IPs, while Residential proxies offer the widest pool and the most authentic footprint.

### Can you target a specific city or ZIP code?

Yes. You can target by country, state or region, city, ZIP code (United States only), and ASN or carrier depending on your configuration.

### Is Bright Data's Residential network ethically sourced?

Yes. Every IP comes from a participant who opted in through an approved application, is told how their IP is used, and is compensated for participating.

<Tip>
  If you need a fully managed unblocking solution that goes beyond IP-based access, handling site-specific headers, cookies, CAPTCHAs, JavaScript challenges and retries automatically, use the [Web Unlocker API](/products/web-unlocker/introduction).
</Tip>

## Related

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/products/residential/quickstart">
    Create a Residential proxy zone and get your credentials.
  </Card>

  <Card title="Send your first request" icon="paper-plane" href="/products/residential/send-your-first-request">
    Route your first request in Python, Node.js or cURL.
  </Card>

  <Card title="Network access" icon="key" href="/products/residential/network-access">
    Complete KYC and unlock full residential access.
  </Card>

  <Card title="Configure your proxy" icon="sliders" href="/products/residential/configure-your-proxy">
    Set country targeting, session control and rotation.
  </Card>
</CardGroup>


# Residential network access policy
Source: https://docs.brightdata.com/products/residential/network-access

Bright Data Residential proxies require KYC review by the compliance team and are available to verified companies only. No automatic or instant access.

Bright Data Residential proxies are available only to verified companies that pass a human-reviewed KYC (Know Your Customer) check by the Bright Data compliance team. There is no automatic, instant or self-serve path to the Residential network.

<Note>
  **Existing zones are unaffected.** Residential zones created on or before July 7, 2026 continue to work as expected. The KYC requirement applies only to new Residential zones created after July 7, 2026. Customers already verified for Residential access keep it and nothing changes.
</Note>

## Who can access the Residential network?

Residential access is granted only to registered companies, and only after the Bright Data compliance team reviews and approves your KYC submission.

* **Verified companies only.** You must sign up on behalf of a registered company and verify a corporate email domain. Accounts on a personal email (for example Gmail or Outlook) are not eligible for Residential access.
* **Human-reviewed KYC.** Every Residential request is reviewed by the Bright Data compliance team. Approval is never automatic, instant or self-serve.
* **All Residential proxy types.** For new Residential zones created after July 7, 2026, KYC approval is required for every proxy type: shared rotating IPv4, the IPv4 and IPv6 "Mega Pool", IPv6 and dedicated Residential proxies.
* **Existing zones keep working.** Residential zones created on or before July 7, 2026 continue as usual. The KYC requirement applies only to new Residential zones created after July 7, 2026, and customers already verified for Residential access do not need to reapply.

<Warning>
  Some restrictions also apply on the Datacenter and ISP networks. For example, government websites are blocked across all networks. See the [proxy errors catalog](/proxy-networks/errorCatalog) for the specific errors.
</Warning>

## What can I use without KYC?

If you have not completed KYC, or your use case does not need Residential IPs, use one of these alternatives. None of them require KYC:

* **[ISP proxies](/products/isp/introduction)** give you static, residential-registered IPs with datacenter speed and stability. Use them for ad verification, QA and long-session workloads.
* **[Datacenter proxies](/products/data-center/introduction)** give you fast, low-cost shared or dedicated IPs. Use them for high-volume requests to sites without strict anti-bot defenses.
* **[Web Unlocker API](/products/web-unlocker/introduction)** is a fully managed unblocking product that handles headers, cookies, CAPTCHAs and retries automatically, billed per successful request.

These are alternatives to Residential proxies. They are not a limited or trial Residential mode.

## Residential proxy network policy

Bright Data monitors Residential network traffic 24/7 to keep the network compliant with its [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy). Because Residential IPs come from real people who opted in, access is scoped to the use case the compliance team approved during KYC.

* Requests to domains or categories outside your approved use case are blocked and return an `Access denied` error with the classified category.
* Restricted HTTP methods and targets that are not part of your approved use case are also blocked.
* To widen the sites and methods you can target, keep your KYC use case current with the compliance team.

## KYC verification

KYC (Know Your Customer) is the mandatory, human-reviewed verification step for Residential network access. The Bright Data compliance team validates your company and use case before granting access. Because a person reviews every submission, access is never granted instantly.

### How to request Residential access

1. Sign in to your Bright Data account and add a user with a **company email domain**. KYC applications are accepted only from registered businesses.

2. Add funds to your account balance. KYC is not available in [Playground](/general/faqs#what-is-playground-mode) or [Limited Trial](/general/faqs#what-is-limited-trial-mode) modes.

3. Submit the KYC form with details about your business and scraping use case, plus a company registration document.

   [Start KYC verification](https://brightdata.com/cp/kyc)

4. The Bright Data compliance team reviews your submission. You will receive a decision by email, and can track the status in your control panel under **Settings > Profile**.

<AccordionGroup>
  <Accordion title="Why do I need KYC for Residential proxies?">
    Residential IP addresses are linked to 100% real people who opted in to the Bright Data network. KYC (Know Your Customer) lets the Bright Data compliance team verify your business and use case before you route traffic through those real peers. This keeps the network compliant with the highest ethics and compliance standards and protects the people behind the IPs. Residential access is granted only after this human review, so there is no automatic or instant approval.
  </Accordion>

  <Accordion title="I signed up with a personal email. Can I use Residential?">
    No. Residential proxies are available only to verified companies. KYC applications are accepted only from registered businesses with a corporate email domain, so a personal-email account (for example Gmail, Outlook or iCloud) cannot be approved for Residential access. Add a user with your company email domain, then submit KYC. Without KYC you can still use [ISP proxies](/products/isp/introduction), [Datacenter proxies](/products/data-center/introduction) and the [Web Unlocker API](/products/web-unlocker/introduction).
  </Accordion>

  <Accordion title="Can I switch my existing ISP or Datacenter zone to Residential?">
    Only after KYC approval. Converting or creating a Residential zone is blocked until the Bright Data compliance team approves your KYC submission. Your existing ISP and Datacenter zones keep working as usual while your KYC is under review.
  </Accordion>

  <Accordion title="What is the process for KYC verification?">
    Submit details about yourself and your scraping use case so the Bright Data compliance team can verify your eligibility. Start the KYC process below:

    [Start KYC verification](https://brightdata.com/cp/kyc)

    <Warning>
      The KYC process is not available in [Playground](/general/faqs#what-is-playground-mode) or [Limited Trial](/general/faqs#what-is-limited-trial-mode) modes. It can be started only after adding real funds to the account balance.
    </Warning>
  </Accordion>

  <Accordion title="How long does KYC approval take?">
    Filling in the form takes a few minutes. Approval is not automatic: the Bright Data compliance team reviews every submission. Once submitted, the review runs through the compliance process, and you can see the status in your control panel under **Settings > Profile**. You will be updated on your KYC status within 48 hours of completing the process.
  </Accordion>

  <Accordion title="How do I know that my KYC has been approved?">
    You can check the status of your KYC at any time in your control panel under **Settings > Profile**, shown as "Account verification status". A notification about the submission and the approval or decline of your request is also sent to your email once the review is complete.
  </Accordion>

  <Accordion title="Do I have to complete KYC to use the Residential network?">
    Yes. KYC approval is required for all Residential network access, and it is reviewed by the Bright Data compliance team. There is no automatic or no-KYC path to any Residential proxy. Without KYC, use [ISP proxies](/products/isp/introduction), [Datacenter proxies](/products/data-center/introduction) or the [Web Unlocker API](/products/web-unlocker/introduction).
  </Accordion>

  <Accordion title="Is this a one-time process?">
    The KYC information is documented in Bright Data systems so the compliance team can review your use case again if needed. Bright Data monitors its network 24/7 and may reach out for additional clarification or information to keep the network safe.
  </Accordion>

  <Accordion title="Who is eligible for the KYC process?">
    Bright Data accepts KYC applications from registered businesses with a company domain. To submit a KYC request, verify a company email address on your account.
  </Accordion>

  <Accordion title="What information will I need to share?">
    The KYC process requires basic information about your business, such as a description of your use case and general contact information. The more detail you share about your business and use case, the easier it is for the Bright Data Compliance and Ethics team to evaluate and approve your request. Further clarification, validation or identification may be requested as a follow-up.
  </Accordion>

  <Accordion title="Why might I need to provide identification?">
    As part of verification, the Bright Data compliance team may request a valid government-issued ID, such as a driver's license or passport, to verify the identity of the point of contact. Because Bright Data IP addresses are linked to 100% real peers, verifying identities is an essential part of keeping the network secure and reliable.
  </Accordion>

  <Accordion title="Do I need to set up a video call?">
    The Bright Data compliance team may request a brief video call to verify additional information about your business or intended use case. This step ensures compliance with policy and ethical standards during the review.
  </Accordion>

  <Accordion title="What is a company registration form or certificate of incorporation?">
    A company registration form (also called a "Certificate of incorporation") is used by government offices as proof of registering a new business. It usually contains the company's official information, including the formal name, registered office address and company registration identifier. It is typically available to the company's legal counsel or finance department and can be shared as proof of registration.
  </Accordion>

  <Accordion title="Can I use Bright Data services while my KYC is being reviewed?">
    Yes. You can use all other Bright Data products and services, including [ISP proxies](/products/isp/introduction), [Datacenter proxies](/products/data-center/introduction) and the [Web Unlocker API](/products/web-unlocker/introduction), while your KYC request is being processed.
  </Accordion>

  <Accordion title="Can I still use Datacenter and ISP if my Residential KYC was declined?">
    Yes. If your KYC was not approved, you can still use the other Bright Data products and services according to the Bright Data [license](https://brightdata.com/license).
  </Accordion>

  <Accordion title="What happens during the KYC video call?">
    On the call, the Bright Data compliance team learns more about your company and activities, confirms your use case and specific requirements, and may view relevant systems and workflow, so Bright Data can support your needs as accurately as possible.
  </Accordion>

  <Accordion title="What if I don't have a LinkedIn or website?">
    The verification process requires vetting a company website and an active online presence. If you have another form of online presence besides LinkedIn (such as a portfolio, GitHub or an alternative business profile), share it when submitting your application.
  </Accordion>

  <Accordion title="What if I don't want to do a video call?">
    If you were asked to do a video call, it is a mandatory step. It helps the Bright Data compliance team verify your identity and understand your use case. Without completing the call, Residential network access cannot be granted.
  </Accordion>

  <Accordion title="Can I use Bright Data for personal projects?">
    No. Bright Data is a B2B platform and supports business-related use cases only. Personal projects, such as scraping for a hobby or a side project, are not approved.
  </Accordion>

  <Accordion title="What kind of use cases are not allowed?">
    See the Bright Data [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy).
  </Accordion>

  <Accordion title="I submitted my KYC but haven't heard back. What should I do?">
    Expect an update within 48 hours of submitting your KYC. If it has been longer, check the status in your control panel under **Settings > Profile**, or contact your account manager or the Bright Data support team.
  </Accordion>
</AccordionGroup>


# Create your first Residential proxy
Source: https://docs.brightdata.com/products/residential/quickstart

Set up your first Bright Data Residential proxy: sign in, create a proxy in the Control Panel, verify your account and earn $5 credit for first-time setup.

<Callout icon="badge-dollar">
  **Verify your account and get \$5 credit**

  Add a payment method to verify your account and receive a \$5 credit. You won’t be charged at this stage.
</Callout>

<Warning>
  **Residential proxies require a KYC-verified business account.** Access is granted only after the Bright Data compliance team reviews and approves your KYC, so a new Residential zone stays disabled until then. Start at [KYC verification](https://brightdata.com/cp/kyc) and see the [Residential network access policy](/products/residential/network-access). No KYC yet? Use [ISP proxies](/products/isp/introduction) or [Datacenter proxies](/products/data-center/introduction), which need no KYC.
</Warning>

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>} />

  <Step title={<>Open the <a href="https://brightdata.com/cp/zones/new">Create Proxy</a> page</>}>
    Navigate to **Create Proxy** under the **Proxies** section in the left menu.

    <Frame>
      <img alt="Create Proxy" />
    </Frame>
  </Step>

  <Step title="Choose Residential Proxy">
    Select **Residential Proxy** and click **Continue**.

    <Frame>
      <img alt="Residential Proxy" />
    </Frame>
  </Step>

  <Step title="Assign a name to your proxy">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The proxy name cannot be changed once created.**

      All other settings can be modified later. For details, see [Configure your Proxy](/products/residential/configure-your-proxy).
    </Warning>

    <Frame>
      <img alt="Proxy Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Create Proxy**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize proxy creation">
    Click **Create Proxy**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your proxy is now ready to use.
  </Step>
</Steps>


# Send your first Residential proxy request
Source: https://docs.brightdata.com/products/residential/send-your-first-request

Send your first request through Bright Data Residential proxies with copy-paste code examples in cURL, Python, Node.js, and Java.

<Accordion title="This guide works for all the proxy products" icon="check">
  1. Residential Proxy
  2. Mobile Proxy
  3. ISP Proxy
  4. Datacenter Proxy
  5. SERP API
  6. Browser API
  7. Web Unlocker API
</Accordion>

To get started, you need your proxy credentials, your `Username` and `Password` along with the `Host` name. You can find these credentials in the **Overview** tab of the proxy product.

## Code Examples

Once you have your proxy credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```javascript Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "http://brdtest.com/myip.json"
  response = requests.get(url, proxies=proxies)
  pprint.pprint(response.json())

  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>

  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
    }
  }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```
</CodeGroup>

The code above uses the residential proxy to send a request to [http://brdtest.com/myip.json](http://brdtest.com/myip.json). It returns your IP information in a JSON format:

```json Output theme={null}
{
  "ip": "ALLOCATED_IP",
  "country": "PK",
  "asn": {
    "asnum": 203020,
    "org_name": "HostRoyale Technologies Pvt Ltd"
  },
  "geo": {
    "city": "Islamabad",
    "region": "IS",
    "region_name": "Islamabad",
    "postal_code": "44040",
    "latitude": 33.7233,
    "longitude": 73.0435,
    "tz": "Asia/Karachi",
    "lum_city": "islamabad",
    "lum_region": "is"
  }
}
```

Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice and ...

**That's it!**


# Custom CDP functions
Source: https://docs.brightdata.com/products/scraping-browser/cdp-functions/custom

Reference for Bright Data Browser API custom CDP functions that extend the standard Chrome DevTools Protocol with unblocking and session controls.

## How to solve CAPTCHAs

When navigating a page with Browser API, our integrated CAPTCHA solver **automatically solves all CAPTCHAs** by default. You can monitor this auto-solving process in your code with the following custom CDP functions.

<Note>
  If you would like to disable CAPTCHA solver entirely through the Control Panel see our feature for [Disable Captcha Solver](/products/scraping-browser/features/captcha-solver)
</Note>

<Note>
  Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default.
</Note>

## CAPTCHA Solver - Automatic Solve

<AccordionGroup>
  <Accordion title="Captcha.solve">
    Use this command to return the status after the captcha was solved, failed, or not detected.

    <CodeGroup>
      ```js Captcha.solve theme={null}
      Captcha.solve({
          detectTimeout?: number // Detect timeout in millisecond for solver to detect captcha
          options?: CaptchaOptions[] // Configuration options for captcha solving
      }) : SolveResult
      ```

      ```js SolveResult theme={null}
      SolveResult : {
        status: SolveStatus // Detect and solve status
        type?: string // Detected captcha type
        error?: string // Error if captcha was not solved
      }
      ```

      ```js SolveStatus theme={null}
      SolveStatus : string enum {
        "not_detected" // Captcha was not detected
        "solve_finished" // Captcha successfully solved
        "solve_failed" // Captcha detected, but was not solved
        "invalid" // Something goes wrong
      }
      ```
    </CodeGroup>

    **Examples**

    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      const page = await browser.newPage();
      const client = await page.createCDPSession();
      await page.goto('https://site-with-captcha.com/');

      // Note 1: If no captcha was found it will return not_detected status after detectTimeout
      // Note 2: Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default

      const {status} = await client.send('Captcha.solve', {detectTimeout: 30*1000});
      console.log(`Captcha solve status: ${status}`)
      ```

      ```python Python - Playwright theme={null}
      page = await browser.new_page()
      client = await page.context.new_cdp_session(page)
      await page.goto('https://site-with-captcha.com/')

      # Note 1: If no captcha was found it will return not_detected status after detectTimeout
      # Note 2: Once a CAPTCHA is solved, if there is a form to submit, it will be submitted by default

      solve_result = await client.send('Captcha.solve', { 'detectTimeout': 30*1000 })
      status = solve_result['status']
      print(f'Captcha solve status: {status}')
      ```

      ```c# C# - PuppeteerSharp theme={null}
      var page = await browser.NewPageAsync();
      var client = page.Client;
      await page.GoToAsync(url);
      var result = await client.SendAsync("Captcha.solve", new
      {
          detectTimeout = 10 * 1000,
      });
      var status = result.Value.GetProperty("status").GetString();
      Log($"Captcha solve status: {status}");
      ```

      ```c# C# - Playwright theme={null}
      var page = await browser.NewPageAsync();
      var cdpSession = await page.Context.NewCDPSessionAsync(page);
      await page.GotoAsync(url);
      var result = await cdpSession.SendAsync("Captcha.solve", new Dictionary<string, object>
      {
          ["detectTimeout"] = 10 * 1000
      });
      var status = result.Value.GetProperty("status").GetString();
      Log($"Captcha solve status: {status}");
      ```
    </CodeGroup>

    <Note>
      If CAPTCHA-solving fails, please attempt a retry. If the issue persists, submit a support request detailing the specific problem you encountered.
    </Note>
  </Accordion>

  <Accordion title="Custom CDP commands for CAPTCHA status">
    Use the commands below to pinpoint a more specific stage in the CAPTCHA solving flow:

    | | |
    | - | - |
    | `Captcha.detected` | Browser API has encountered a CAPTCHA and has begun to solve it |
    | `Captcha.solveFinished` | Browser API successfully solved the CAPTCHA |
    | `Captcha.solveFailed` | Browser API failed in solving the CAPTCHA |
    | `Captcha.waitForSolve` | Browser API waits for CAPTCHA solver to finish |

    **Examples**

    <Tabs>
      <Tab title="Asynchronous">
        The following code sets up a CDP session, listens for CAPTCHA events, and handles timeouts:

        <CodeGroup>
          ```js NodeJS - Puppeteer theme={null}
          // Node.js - Puppeteer - waiting for CAPTCHA solving events
          const client = await page.target().createCDPSession();
          await new Promise((resolve, reject)=>{
            client.on('Captcha.solveFinished', resolve);
            client.on('Captcha.solveFailed', ()=>reject(new Error('Captcha failed')));
            setTimeout(reject, 5 * 60 * 1000, new Error('Captcha solve timeout'));
          });
          ```

          ```python Python - Playwright theme={null}
          # Python - Playwright - waiting for CAPTCHA solving events
          client = await page.context.new_cdp_session(page)
          client.on('Captcha.detected', lambda c: print('Captcha detected', c))
          client.on('Captcha.solveFinished', lambda _: print('Captcha solved!'))
          client.on('Captcha.solveFailed', lambda _: print('Captcha failed!'))
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Synchronous">
        <Warning>
          Selenium doesn't support asynchronous server-driven events like Puppeteer and Playwright.
        </Warning>

        The `Captcha.waitForSolve` command waits for Browser API's CAPTCHA solver to finish.

        ```python Python - Selenium theme={null}
        # Python Selenium - Waiting for Captcha to auto-solve after navigate
        driver.execute('executeCdpCommand', {
            'cmd': 'Captcha.waitForSolve',
            'params': {},
        })
        ```
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

## CAPTCHA Solver - Manual Control

If you would like to either manually configure or fully disable our default CAPTCHA solver and instead call the solver manually or solve on your own, see the following CDP commands and functionality.

<AccordionGroup>
  <Accordion title="Captcha.setAutoSolve">
    This command is used to control the auto-solving of a CAPTCHA. You can disable auto-solve or configure algorithms for different CAPTCHA types and manually trigger this:

    <CodeGroup>
      ```js Captcha.setAutoSolve theme={null}
      Captcha.setAutoSolve({
        autoSolve: boolean // Whether to automatically solve captcha after navigate
        options?: CaptchaOptions[] // Configuration options for captcha auto-solving
      }) : void
      ```

      ```js CaptchaOptions theme={null}
      CaptchaOptions : {
        type: string // Captcha type
        disabled?: boolean // Disable detect and solve for specified captcha
        ... // additional options related to captcha type
      }
      ```
    </CodeGroup>

    Examples of CDP commands to disable auto-solver **completely** within the session:

    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // Node.js Puppeteer - Disable Captcha auto-solver completely
      const page = await browser.newPage();
      const client = await page.target().createCDPSession();
      await client.send('Captcha.setAutoSolve', { autoSolve: false })
      ```

      ```python Python - Playwright theme={null}
      # Python Playwright - Disable Captcha auto-solver completely
      page = await browser.new_page()
      client = await page.context.new_cdp_session(page)
      await client.send('Captcha.setAutoSolve', {'autoSolve': False})
      ```

      ```python - Selenium theme={null}
      # Python Selenium - Disable Captcha auto-solver completely
      driver.execute('executeCdpCommand', {
          'cmd': 'Captcha.setAutoSolve',
          'params': {'autoSolve': False},
      })
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Disable auto-solver for a specific CAPTCHA type only - Examples">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // Node.js Puppeteer - Disable Captcha auto-solver for ReCaptcha only
      const page = await browser.newPage();
      const client = await page.target().createCDPSession();
      await client.send('Captcha.setAutoSolve', {
          autoSolve: true,
          options: [{
              type: 'usercaptcha',
              disabled: true,
          }],
      });
      ```

      ```python Python - Playwright theme={null}
      # Python Playwright - Disable Captcha auto-solver for ReCaptcha only
      page = await browser.new_page()
      client = await page.context.new_cdp_session(page)
      await client.send('Captcha.setAutoSolve', {
          'autoSolve': True,
          'options': [{
              'type': 'usercaptcha',
              'disabled': True,
          }],
      })
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Manually solving CAPTCHAs - Examples">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // Node.js Puppeteer - manually solving CAPTCHA after navigation
      const page = await browser.newPage();
      const client = await page.target().createCDPSession();
      await client.send('Captcha.setAutoSolve', { autoSolve: false });
      await page.goto('https://site-with-captcha.com', { timeout: 2*60*1000 });
      const {status} = await client.send('Captcha.solve', { detectTimeout: 30*1000 });
      console.log('Captcha solve status:', status);
      ```

      ```python Python - Playwright theme={null}
      # Python Playwright- manually solving CAPTCHA after navigation
      page = await browser.new_page()
      client = await page.context.new_cdp_session(page)
      await client.send('Captcha.setAutoSolve', {'autoSolve': False})
      await page.goto('https://site-with-captcha.com', timeout=2*60_000)
      solve_result = await client.send('Captcha.solve', {'detectTimeout': 30_000})
      print('Captcha solve status:', solve_result['status'])
      ```

      ```python Python - Selenium theme={null}
      # Python Selenium - manually solving CAPTCHA after navigation
      driver.execute('executeCdpCommand', {
          'cmd': 'Captcha.setAutoSolve',
          'params': {'autoSolve': False},
      })
      driver.get('https://site-with-captcha.com')
      solve_result = driver.execute('executeCdpCommand', {
          'cmd': 'Captcha.solve',
          'params': {'detectTimeout': 30_000},
      })
      print('Captcha solve status:', solve_result['value']['status'])
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="CaptchaOptions for other Captcha types">
    For the following three CAPTCHA types we support the following additional options to control and configure our auto-solving algorithm.

    <Tabs>
      <Tab title="CF Challenge">
        ```js CF Challenge theme={null}
        timeout: 40000
        selector: '#challenge-body-text, .challenge-form'
        check_timeout: 300
        error_selector: '#challenge-error-title'
        success_selector: '#challenge-success[style*=inline]'
        check_success_timeout: 300
        btn_selector: '#challenge-stage input[type=button]'
        cloudflare_checkbox_frame_selector: '#turnstile-wrapper iframe'
        checkbox_area_selector: '.ctp-checkbox-label .mark'
        wait_timeout_after_solve: 500
        wait_networkidle: {timeout: 500}
        ```
      </Tab>

      <Tab title="HCaptcha">
        ```js HCaptcha theme={null}
        detect_selector:
          '#cf-hcaptcha-container, #challenge-hcaptcha-wrapper .hcaptcha-box, .h-captcha'
        pass_proxy: true
        submit_form: true
        submit_selector: '#challenge-form body > form[action*="internalcaptcha/captchasubmit"]'
        value_selector: '.h-captcha textarea[id^="h-captcha-response"]'

        ```
      </Tab>

      <Tab title="usercaptcha (reCAPTCHA)">
        ```js UserCaptcha (reCAPTCHA) theme={null}
        { // configuration keys and default values for reCAPTCHA (type=usercaptcha)
          type: 'usercaptcha',
          // selector to retrieve sitekey and/or action
          selector: '.g-recaptcha, .recaptcha',
          // attributes to search for sitekey
          sitekey_attributes: ['data-sitekey', 'data-key'],
          // attributes to search for action
          action_attributes: ['data-action'],
          // detect selectors
          detect_selector: `
            .g-recaptcha[data-sitekey] > *,
            .recaptcha > *,
            iframe[src*="www.google.com/recaptcha/api2"],
            iframe[src*="www.recaptcha.net/recaptcha/api2"],
            iframe[src*="www.google.com/recaptcha/enterprise"]`,
          // element to type response code into
          reponse_selector: '#g-recaptcha-response, .g-recaptcha-response',
          // should solver submit form automatically after captcha solved
          submit_form: true,
          // selector for submit button
          submit_selector: '[type=submit]',
        }
        ```
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

## How to emulate devices

<AccordionGroup>
  <Accordion title="Emulation.getSupportedDevices">
    Use this command to get a list of all possible devices that can be emulated. This method returns an array of device options that can be used with the setDevice command.

    ```js Example theme={null}
    const devices = await client.send("Emulation.getSupportedDevices");
    console.log(devices);
    ```
  </Accordion>

  <Accordion title="Emulation.setDevice">
    Once you've received the list above of supported devices, you can emulate a specific device using the Emulation.setDevice command. This command changes the screen width, height, userAgent, and devicePixelRatio to match the specified device.

    <CodeGroup>
      ```js Usage theme={null}
      await client.send("Emulation.setDevice", { device: "[device_name]" });
      ```

      ```js Example theme={null}
      await client.send("Emulation.setDevice", { device: "Vivo X200 Pro" });
      ```
    </CodeGroup>

    ### Landscape mode

    If you wish to change the orientation to landscape (for devices that support it), add the string `landscape` after the `device_name`.

    ```js Example theme={null}
    await client.send("Emulation.setDevice", { device: "Vivo X200 Pro landscape" });
    ```
  </Accordion>
</AccordionGroup>

## How to block ads

Enabling the `AdBlock` feature can reduce **bandwidth usage** and **improve performance** on ad-heavy websites by blocking ad and tracker requests before they are downloaded.

### Ad blocker CDP commands

* `Unblocker.enableAdBlock` – Enables ad blocker (default: off)
* `Unblocker.disableAdBlock` – Disables ad blocker

#### Parameters

| Parameter | Type | Description |
| - | - | - |
| `version` | `string` | Blocking engine version. Pass `'2'` (recommended) to use the current engine with up-to-date filter lists. When omitted, a legacy engine is used. |
| `mode` | `string` | Optional, requires `version: '2'`. Blocking coverage: `'ads'` (the default) blocks ad networks; `'full'` also blocks trackers and analytics - the widest coverage and biggest bandwidth reduction; `'none'` disables the built-in lists, so only the domains in `list` are blocked. |
| `list` | `string[]` | Optional, requires `version: '2'`. Custom domains to block **in addition** to the `mode` coverage. Each entry blocks requests to that domain and all of its subdomains. |

<Tip>
  Enable ad blocking before navigating to the target page.
</Tip>

```js Example theme={null}
const client = await page.createCDPSession();

await client.send('Unblocker.enableAdBlock', { version: '2' });

// widest coverage (ads + trackers):
// await client.send('Unblocker.enableAdBlock', { version: '2', mode: 'full' });

// additionally block custom domains:
// await client.send('Unblocker.enableAdBlock', { version: '2', list: ['annoying-widget.example.com'] });

await page.goto('https://example.com');
```

<Note>
  Blocked requests are reported in the browser's DevTools console with the message `Resource was blocked by ad-blocking`.
</Note>

See the full [ad blocker example script](https://github.com/luminati-io/sbr-examples/blob/main/nodejs/puppeteer-ad-block/scrape.js).

## How to block cookie consent banners

The `CookieBlock` feature blocks the scripts of common third-party consent-management platforms (CMPs), so cookie consent banners never load - no need to find and click "Accept" buttons in your automation.

### Cookie blocker CDP commands

* `Unblocker.enableCookieBlock` – Enables cookie consent blocking (default: off)
* `Unblocker.disableCookieBlock` – Disables cookie consent blocking

#### Parameters

| Parameter | Type | Description |
| - | - | - |
| `list` | `string[]` | Optional. Custom domains to block **in addition** to the built-in CMP coverage. Each entry blocks requests to that domain and all of its subdomains. |

<Tip>
  Enable cookie blocking before navigating to the target page.
</Tip>

```js Example theme={null}
const client = await page.createCDPSession();

await client.send('Unblocker.enableCookieBlock');

// additionally block a site-specific consent script:
// await client.send('Unblocker.enableCookieBlock', { list: ['cmp.example.com'] });

await page.goto('https://example.com');
```

<Note>
  The built-in coverage blocks banners served by common third-party CMPs. Banners hosted by the website itself are not covered by it - to block those, find the domain serving the consent script (for example, in the DevTools Network tab) and pass it in the `list` parameter, as in the example above.
</Note>

## How to persist sessions

Use this command to reuse the same proxy peer across multiple browsing sessions. This is useful for scenarios where maintaining a consistent session is required, such as preserving browser states or IP-based continuity.

### Session persistence CDP commands

* `Proxy.useSession` – Associates a session with a specific session ID.
* `sessionId` – A unique string that identifies your session.

<Note>
  Use the CDP command before navigation to the target page.
</Note>

```js Example theme={null}
const client = await page.createCDPSession();
await client.send('Proxy.useSession', { sessionId });
await page.goto('https://geo.brdtest.com/mygeo.json');
```

<Tip>
  See the full [session persistence example script](https://github.com/luminati-io/sbr-examples/blob/main/nodejs/puppeteer-proxy-session/scrape.js).
</Tip>

## Getting Session ID

Use this command to retrieve the unique ID of your current browser session. This is useful when you need to look up session logs via the [Session Logs API](/api-reference/browser-api/get-session), such as investigating errors, unexpected behavior, or high bandwidth usage.

### Session ID CDP command

* `Browser.getSessionId`

```js Example (Puppeteer) theme={null}
const page = await browser.newPage();
const client = await page.target().createCDPSession();
const result = await client.send('Browser.getSessionId');
const sessionId = result.sessionId;
console.log('Current session ID:', sessionId);
```

```json Returns theme={null}
{
  "sessionId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
```

## How to download files

You can automate file downloads in your Browser API flows using the custom Download CDP domain. This is useful for workflows that require downloading files (e.g., CSV, PDF) directly during browser automation.

### File download CDP commands

* `Download.enable` – Enables file downloads for specified content types.
* `Download.downloadRequest` – Fires when request results in download.
* `Download.getLastCompleted` – Retrieves information about the last completed download.
* `Download.getDownloadedBody` – Gets the actual downloaded file content.

```js Example theme={null}
const client = await page.createCDPSession();

// Enable downloads for binary files like CSV
await client.send('Download.enable', { allowedContentTypes: ['application/octet-stream'] });

// initiate download file
await Promise.all([
  new Promise(resolve => client.once('Download.downloadRequest', resolve)),
  page.click(selector),
]);

// After download completes:
const { id } = await client.send('Download.getLastCompleted');
const { body, base64Encoded } = await client.send('Download.getDownloadedBody', { id });
const fs = require('fs');
fs.writeFileSync('./downloaded_file.csv', base64Encoded ? Buffer.from(body, 'base64') : body);
```

<Tip>
  See the full [file download example script](https://github.com/luminati-io/sbr-examples/blob/main/nodejs/puppeteer-file-download/scrape.js).
</Tip>

## Faster Text Input

For scenarios that need rapid or bulk text input, use the custom Input.type CDP command. This approach is much faster than standard CDP text input methods, making it well suited for automation tasks requiring high-speed typing or handling large volumes of text.

### Faster text input CDP commands

* `Input.type` - Sends keystrokes or simulates typing the specified text into the currently focused element.

```js Example theme={null}
const client = await page.createCDPSession();

// Focus the input element
await page.focus('input');

// Type a message
await client.send('Input.type', {
  text: 'what is the best place to try pizza and pasta?'
});
```

## Custom Client SSL/TLS Certificates

Use this command to install custom client SSL/TLS certificates where required for specific domain authentication. These certificates are applied for the duration of a **single** Browser API session and are automatically removed once the session ends.

<AccordionGroup>
  <Accordion title="Browser.addCertificate">
    ```javascript theme={null}
    Browser.addCertificate(params: {
      cert: string // base64 encoded certificate file
      pass: string // password for the certificate
    }) : void
    ```
  </Accordion>

  <Accordion title="Code examples">
    * Replace the example values `SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD` with your valid Browser API credentials.
    * Replace `client.pfx` with the actual path to your certificate file. This file should be a valid SSL/TLS client certificate in .pfx format.
    * Replace `secret` with the actual password for the certificate.

      <CodeGroup>
        ```js NodeJS - Puppeteer theme={null}
        const puppeteer = require('puppeteer-core');
        const fs = require('fs/promises');
        const {
          AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
          TARGET_URL = 'https://example.com',
          CERT_FILE = 'client.pfx',
          CERT_PASS = 'secret',
        } = process.env;
        async function scrape(url = TARGET_URL, file = CERT_FILE, pass = CERT_PASS) {
          if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
            throw new Error(`Provide Browser API credentials in AUTH`
                + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
          const browser = await puppeteer.connect({ browserWSEndpoint });
          try {
            console.log(`Connected! Installing ${file} certificate...`);
            const page = await browser.newPage();
            const client = await page.createCDPSession();
            const cert = (await fs.readFile(CERT_FILE)).toString('base64');
            await client.send('Browser.addCertificate', { cert, pass });
            console.log(`Installed! Navigating to ${url}...`);
            await page.goto(url, { timeout: 2 * 60 * 1000 });
            console.log(`Navigated! Scraping page content...`);
            const data = await page.content();
            console.log(`Scraped! Data: ${data}`);
          } finally {
            await browser.close();
          }
        }
        scrape();
        ```

        ```python Python - Selenium theme={null}
        from os import environ
        from base64 import standard_b64encode
        from selenium.webdriver import Remote, ChromeOptions as Options
        from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection
        AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
        TARGET_URL = environ.get('TARGET_URL', default='https://example.com')
        CERT_FILE = environ.get('CERT_FILE', default='client.pfx')
        CERT_PASS = environ.get('CERT_PASS', default='secret')
        def scrape(url=TARGET_URL, file=CERT_FILE, pswd=CERT_PASS):
            if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
               raise Exception('Provide Browser API credentials in AUTH '
                            'environment variable or update the script.')
            print('Connecting to Browser...')
            server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
            connection = Connection(server_addr, 'goog', 'chrome')
            driver = Remote(connection, options=Options())
            try:
                print(f'Connected! Installing {file} certificate...')
                with open(file, 'rb') as f:
                    cert = standard_b64encode(f.read()).decode()
                driver.execute('executeCdpCommand', {
                    'cmd': 'Browser.addCertificate',
                    'params': {'cert': cert, 'pass': pswd},
                })
                print(f'Installed! Navigating to {url}...')
                driver.get(url)
                print('Navigated! Scraping page content...')
                data = driver.page_source
                print(f'Scraped! Data: {data}')
            finally:
                driver.quit()
        scrape()
        ```
      </CodeGroup>
  </Accordion>
</AccordionGroup>


# Standard CDP functions
Source: https://docs.brightdata.com/products/scraping-browser/cdp-functions/standard

Reference for standard CDP functions on the Bright Data Browser API: cookies, country targeting, navigation and Puppeteer or Playwright commands.

Browser API supports CDP so all puppeteer functions/features work within our browsers. You can find all puppeteer API documentation and usage examples on the [official puppeteer documentation page](https://pptr.dev/). We have also added a few Bright Data-specific [custom CDP events](/products/scraping-browser/cdp-functions/custom) which can be useful as well.

The following are a few common browser navigation functions to get you started.

<AccordionGroup>
  <Accordion title="Get Page HTML">
    ```js NodeJS - Puppeteer theme={null}
    const page = await browser.newPage();  
    await page.goto('https://example.com');  
    const html = await page.content();
    ```

    For more info: [https://pptr.dev/api/puppeteer.page.content](https://pptr.dev/api/puppeteer.page.content)
  </Accordion>

  <Accordion title="Click on element">
    ```js NodeJS - Puppeteer theme={null}
    // node.js puppeteer   
    const page = await browser.newPage();  
    await page.goto('https://example.com');  
    await page.click('a[href]');
    ```

    For more info: [https://pptr.dev/api/puppeteer.page.click](https://pptr.dev/api/puppeteer.page.click)
  </Accordion>

  <Accordion title="Scroll to page bottom">
    You might need to scroll the viewport to the bottom at times, such as when activating 'infinite scroll'. Here's how:

    ```js NodeJS - Puppeteer theme={null}
    // node.js puppeteer   
    const page = await browser.newPage();  
    await page.goto('https://example.com');  
    await page.evaluate(()=>window.scrollBy(0, window.innerHeight));
    ```
  </Accordion>

  <Accordion title="Take Screenshot">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
      // More info at https://pptr.dev/api/puppeteer.page.screenshot  
      await page.screenshot({ path: 'screenshot.png', fullPage: true });
      ```

      ```python Python - Playwright theme={null}
      # More info at <https://playwright.dev/python/docs/screenshots>  
      await page.screenshot(path='screenshot.png', full_page=True)
      ```

      ```cs C# - PuppeteerSharp theme={null}
      await page.ScreenshotAsync("screenshot.png", new ()  
      {  
          FullPage = true,  
      });
      ```

      ```C# C# - Playwright theme={null}
      var screenshotPath = "screenshot.png";
                  
      await page.ScreenshotAsync(new PageScreenshotOptions
      {
          Path = screenshotPath,
          FullPage = true
      });
      ```
    </CodeGroup>

    <Note>
      When running the example scripts above the screenshot above will be saved as “screenshot.png” within your files.
    </Note>
  </Accordion>

  <Accordion title="Set Cookies">
    Please note that this is supported onl for customers who completed the KYC verification process.

    ```js NodeJS Puppeteer theme={null}
    const page = await browser.newPage();  
    await page.setCookie({name: 'LANG', value: 'en-US', domain: 'example.com'});  
    await page.goto('https://example.com');
    ```

    For more info: [https://pptr.dev/api/puppeteer.page.setcookie](https://pptr.dev/api/puppeteer.page.setcookie)
  </Accordion>

  <Accordion title="Blocking Endpoints">
    It is possible to block endpoints that are not required to save bandwidth. See an example of this below:

    ```js NodeJS - Puppeteer theme={null}
    // connect to a remote browser...
    const blockedUrls = ['*doubleclick.net*'];
    const page = await browser.newPage();
    const client = await page.target().createCDPSession();
    await client.send('Network.enable');
    await client.send('Network.setBlockedURLs', {urls: blockedUrls});
    await page.goto('https://washingtonpost.com');
    ```
  </Accordion>

  <Accordion title="Country Targeting">
    When using the Browser API, the same **country-targeting** parameter is available to use as in our other proxy products.

    When setting up your script, add the `-country` flag, **after** your "USER" credentials within the Bright Data endpoint, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    ```js theme={null}
    const SBR_WS_ENDPOINT = `wss://${USERNAME}-country-us:${PASSWORD}@brd.superproxy.io:9222`;
    ```

    In the example above, we added `-country-us` to the Bright Data endpoint within our script, so our request will originate from the United States ("us").

    #### EU region

    You can target the entire European Union region in the same manner as "Country" above by adding "eu" after "country" in your request: `-country-eu` Requests sent using `-country-eu`, will use IPs from **one** of the countries below which are included automatically within "eu":

    ```sh Countries theme={null}
    AL, AZ, KG, BA, UZ, BI, XK, SM, DE, AT, CH, UK, GB, IE, IM, FR, ES, NL, IT, PT, BE, AD, MT, MC, MA, LU, TN, DZ, GI, LI, SE, DK, FI, NO, AX, IS, GG, JE, EU, GL, VA, FX, FO
    ```

    <Note>
      The allocation of a country within the EU is random.
    </Note>
  </Accordion>
</AccordionGroup>


# Browser API code examples
Source: https://docs.brightdata.com/products/scraping-browser/code-examples

Explore Bright Data Browser API code examples across 3 technologies (Playwright, Puppeteer, Selenium) for headless browser scraping at scale.

Below are examples of Browser API usage in various scenarios and libraries.

<Warning>
  Please make sure to install required libraries before continuing
</Warning>

## Make your first request in minutes

Test the Browser API in minutes with these ready-to-use code examples.

<CardGroup>
  <Card title="Nodejs Puppeteer Example" icon="code" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-puppeteer-project" />

  <Card title="Node.js Playwright Example" icon="code" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-playwright-project" />

  <Card title="Node.js Selenium Example" icon="code" href="https://github.com/luminati-io/bright-data-scraping-browser-nodejs-selenium-project" />
</CardGroup>

<Tabs>
  <Tab title="Basic">
    Simple scraping of targeted page

    ### Select your preferred tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright theme={null}
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await playwright.chromium.connectOverCDP(endpointURL);
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping page content...`);
                  const data = await page.content();
                  console.log(`Scraped! Data: ${data}`);
              } finally {
                  await browser.close();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```

          ```js Puppeteer theme={null}
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await puppeteer.connect({ browserWSEndpoint });
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping page content...`);
                  const data = await page.content();
                  console.log(`Scraped! Data: ${data}`);
              } finally {
                  await browser.close();
              }
          }

          function getErrorDetails(error) {
              if (error.target?._req?.res) {
                  const {
                      statusCode,
                      statusMessage,
                  } = error.target._req.res;
                  return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(getErrorDetails(error)
                      || error.stack
                      || error.message
                      || error);
                  process.exit(1);
              });
          }
          ```

          ```js Selenium theme={null}
          #!/usr/bin/env node
          const { Builder, Browser } = require('selenium-webdriver');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const server = `https://${AUTH}@brd.superproxy.io:9515`;
              const driver = await new Builder()
                  .forBrowser(Browser.CHROME)
                  .usingServer(server)
                  .build();
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  await driver.get(url);
                  console.log(`Navigated! Scraping page content...`);
                  const data = await driver.getPageSource();
                  console.log(`Scraped! Data: ${data}`);
              } finally {
                  await driver.quit();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Python">
        <CodeGroup>
          ```python Playwright - Async theme={null}
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          async def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = await playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = await browser.new_page()
                  await page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping page content...')
                  data = await page.content()
                  print(f'Scraped! Data: {data}')
              finally:
                  await browser.close()


          async def main():
              async with async_playwright() as playwright:
                  await scrape(playwright)


          if __name__ == '__main__':
              asyncio.run(main())

          ```

          ```python Playwright - Sync theme={null}
          #!/usr/bin/env python3
          from os import environ
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = browser.new_page()
                  page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping page content...')
                  data = page.content()
                  print(f'Scraped! Data: {data}')
              finally:
                  browser.close()


          def main():
              with sync_playwright() as playwright:
                  scrape(playwright)


          if __name__ == '__main__':
              main()

          ```

          ```python Selenium theme={null}
          #!/usr/bin/env python3
          from os import environ
          from selenium.webdriver import Remote, ChromeOptions as Options
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
              connection = Connection(server_addr, 'goog', 'chrome')
              driver = Remote(connection, options=Options())
              try:
                  print(f'Connected! Navigating to {url}...')
                  driver.get(url)
                  print('Navigated! Scraping page content...')
                  data = driver.page_source
                  print(f'Scraped! Data: {data}')
              finally:
                  driver.quit()


          if __name__ == '__main__':
              scrape()

          ```

          ```python Selenium - Mobile-agent theme={null}
          #!/usr/bin/env python3 
          from os import environ 
          from selenium.webdriver import Remote, ChromeOptions as Options 
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection 

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') 
          TARGET_URL = environ.get('TARGET_URL', default='https://httpbin.org/user-agent') 
          USER_AGENT = 'Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.3 Mobile/15E148 Safari/604.1' 
          SCREEN_WIDTH = 390 
          SCREEN_HEIGHT = 844 
          DEVICE_SCALE_FACTOR = 3 

          def scrape(url=TARGET_URL): 
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD': 
                  raise Exception('Provide Browser API credentials in AUTH ' + 
                                  'environment variable or update the script.') 
              print('Connecting to Browser...') 
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515' 
              connection = Connection(server_addr, 'goog', 'chrome') 
              driver = Remote(connection, options=Options()) 
              try: 
                  print(f'Connected! Emulating mobile...') 
                  driver.execute('executeCdpCommand', { 
                      'cmd': 'Emulation.setUserAgentOverride', 
                      'params': { 
                          'userAgent': USER_AGENT, 
                      }, 
                  }) 
                  driver.execute('executeCdpCommand', { 
                      'cmd': 'Emulation.setDeviceMetricsOverride', 
                      'params': { 
                          'width': SCREEN_WIDTH, 
                          'height': SCREEN_HEIGHT, 
                          'deviceScaleFactor': DEVICE_SCALE_FACTOR, 
                          'mobile': True, 
                      }, 
                  }) 
                  print(f'Navigating to {url}...') 
                  driver.get(url) 
                  print('Navigated! Checking screen and user-agent...') 
                  driver.get_screenshot_as_file('./page.png') 
                  ua = driver.execute_script('return navigator.userAgent') 
                  print(f'User-Agent is {ua}') 
              finally: 
                  driver.quit() 


          if __name__ == '__main__': 
              scrape()

          ```
        </CodeGroup>
      </Tab>

      <Tab title="C#">
        <CodeGroup>
          ```cs Puppeteer theme={null}
          using PuppeteerSharp;
          using System.Net.WebSockets;
          using System.Text;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private async Task<IBrowser> Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var options = new ConnectOptions()
                  {
                      BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                      WebSocketFactory = async (uri, options, cToken) =>
                      {
                          var socket = new ClientWebSocket();
                          var authBytes = Encoding.UTF8.GetBytes(_auth);
                          var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                          socket.Options.SetRequestHeader("Authorization", authHeader);
                          socket.Options.KeepAliveInterval = TimeSpan.Zero;
                          await socket.ConnectAsync(uri, cToken);
                          return socket;
                      },
                  };
                  return await Puppeteer.ConnectAsync(options);
              }

              public async Task Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var browser = await Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      var page = await browser.NewPageAsync();
                      await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                      Log("Navigated! Scraping page content...");
                      var data = await page.GetContentAsync();
                      Log($"Scraped! Data: {data}");
                  } finally {
                      await browser.CloseAsync();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static async Task Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }
          ```

          ```cs Selenium theme={null}
          using OpenQA.Selenium;
          using OpenQA.Selenium.Chrome;
          using OpenQA.Selenium.Remote;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private IWebDriver Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
                  var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
                  var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                          "/session/{sessionId}/goog/cdp/execute");
                  executor.TryAddCommand("cdp", cdpCommand);
                  var capabilities = new ChromeOptions().ToCapabilities();
                  return new RemoteWebDriver(executor, capabilities);
              }

              public void Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var driver = Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      driver.Navigate().GoToUrl(url);
                      Log("Navigated! Scraping page content...");
                      var data = driver.PageSource;
                      Log($"Scraped! Data: {data}");
                  } finally {
                      driver.Quit();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static void Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Captcha">
    Open a page and wait for captcha to solve

    ### Select your pefered tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright theme={null}
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await playwright.chromium.connectOverCDP(endpointURL);
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  const client = await page.context().newCDPSession(page);
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await client.send('Captcha.waitForSolve', {
                      detectTimeout: 10 * 1000,
                  });
                  console.log(`Captcha status: ${status}`);
              } finally {
                  await browser.close();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```

          ```js Puppeteer theme={null}
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await puppeteer.connect({ browserWSEndpoint });
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  const page = await browser.newPage();
                  const client = await page.createCDPSession();
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await client.send('Captcha.waitForSolve', {
                      detectTimeout: 10 * 1000,
                  });
                  console.log(`Captcha status: ${status}`);
              } finally {
                  await browser.close();
              }
          }

          function getErrorDetails(error) {
              if (error.target?._req?.res) {
                  const {
                      statusCode,
                      statusMessage,
                  } = error.target._req.res;
                  return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(getErrorDetails(error)
                      || error.stack
                      || error.message
                      || error);
                  process.exit(1);
              });
          }
          ```

          ```js Selenium theme={null}
          #!/usr/bin/env node
          const { Builder, Browser } = require('selenium-webdriver');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const server = `https://${AUTH}@brd.superproxy.io:9515`;
              const driver = await new Builder()
                  .forBrowser(Browser.CHROME)
                  .usingServer(server)
                  .build();
              try {
                  console.log(`Connected! Navigating to ${url}...`);
                  await driver.get(url);
                  console.log(`Navigated! Waiting captcha to detect and solve...`);
                  const { status } = await driver.sendAndGetDevToolsCommand('Captcha.waitForSolve', {
                      detectTimeout: 10000,
                  });
                  console.log(`Captcha status: ${status}`);
              } finally {
                  await driver.quit();
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Python">
        <CodeGroup>
          ```python Playwright - Async theme={null}
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          async def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = await playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = await browser.new_page()
                  client = await page.context.new_cdp_session(page)
                  await page.goto(url, timeout=2*60_000)
                  print('Navigated! Waiting captcha to detect and solve...')
                  result = await client.send('Captcha.waitForSolve', {
                      'detectTimeout': 10 * 1000,
                  })
                  status = result['status']
                  print(f'Captcha status: {status}')
              finally:
                  await browser.close()


          async def main():
              async with async_playwright() as playwright:
                  await scrape(playwright)


          if __name__ == '__main__':
              asyncio.run(main())

          ```

          ```python Playwright - Sync theme={null}
          #!/usr/bin/env python3
          from os import environ
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print(f'Connected! Navigating to {url}...')
                  page = browser.new_page()
                  client = page.context.new_cdp_session(page)
                  page.goto(url, timeout=2*60_000)
                  print('Navigated! Waiting captcha to detect and solve...')
                  result = client.send('Captcha.waitForSolve', {
                      'detectTimeout': 10 * 1000,
                  })
                  status = result['status']
                  print(f'Captcha status: {status}')
              finally:
                  browser.close()


          def main():
              with sync_playwright() as playwright:
                  scrape(playwright)


          if __name__ == '__main__':
              main()

          ```

          ```python Selenium theme={null}
          #!/usr/bin/env python3
          from os import environ
          from selenium.webdriver import Remote, ChromeOptions as Options
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
              connection = Connection(server_addr, 'goog', 'chrome')
              driver = Remote(connection, options=Options())
              try:
                  print(f'Connected! Navigating to {url}...')
                  driver.get(url)
                  print('Navigated! Waiting captcha to detect and solve...')
                  result = driver.execute('executeCdpCommand', {
                      'cmd': 'Captcha.waitForSolve',
                      'params': {'detectTimeout': 10 * 1000},
                  })
                  status = result['value']['status']
                  print(f'Captcha status: {status}')
              finally:
                  driver.quit()


          if __name__ == '__main__':
              scrape()

          ```
        </CodeGroup>
      </Tab>

      <Tab title="C#">
        <CodeGroup>
          ```cs Puppeteer theme={null}
          using PuppeteerSharp;
          using System.Net.WebSockets;
          using System.Text;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private async Task<IBrowser> Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var options = new ConnectOptions()
                  {
                      BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                      WebSocketFactory = async (uri, options, cToken) =>
                      {
                          var socket = new ClientWebSocket();
                          var authBytes = Encoding.UTF8.GetBytes(_auth);
                          var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                          socket.Options.SetRequestHeader("Authorization", authHeader);
                          socket.Options.KeepAliveInterval = TimeSpan.Zero;
                          await socket.ConnectAsync(uri, cToken);
                          return socket;
                      },
                  };
                  return await Puppeteer.ConnectAsync(options);
              }

              public async Task Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var browser = await Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      var page = await browser.NewPageAsync();
                      var client = await page.Target.CreateCDPSessionAsync();
                      await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                      Log("Navigated! Waiting captcha to detect and solve...");
                      var result = await client.SendAsync("Captcha.waitForSolve", new
                      {
                          detectTimeout = 10 * 1000,
                      });
                      var status = (string) result["status"]!;
                      Log($"Captcha status: {status}");
                  } finally {
                      await browser.CloseAsync();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static async Task Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }
          ```

          ```cs Selenium theme={null}
          using OpenQA.Selenium;
          using OpenQA.Selenium.Chrome;
          using OpenQA.Selenium.Remote;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private WebDriver Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
                  var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
                  var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                          "/session/{sessionId}/goog/cdp/execute");
                  executor.TryAddCommand("cdp", cdpCommand);
                  var capabilities = new ChromeOptions().ToCapabilities();
                  return new RemoteWebDriver(executor, capabilities);
              }

              public void Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var driver = Connect();
                  try {
                      Log($"Connected! Navigating to {url}...");
                      driver.Navigate().GoToUrl(url);
                      Log("Navigated! Waiting captcha to detect and solve...");
                      var result = (Dictionary<string, object>) driver.ExecuteCustomDriverCommand("cdp", new ()
                      {
                          {"cmd", "Captcha.waitForSolve"},
                          {"params", new Dictionary<string, object>(){
                              {"detectTimeout", 10000},
                          }},
                      }) as Dictionary<string, object>;
                      var status = (string) result!["status"];
                      Log($"Captcha status: {status}");
                  } finally {
                      driver.Quit();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static void Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }

          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Advanced">
    Inspect scraping session, advanced scraping using js snippets

    ### Select your preferred tech-stack

    <Tabs>
      <Tab title="NodeJS">
        <CodeGroup>
          ```js Playwright theme={null}
          #!/usr/bin/env node
          const playwright = require('playwright');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await playwright.chromium.connectOverCDP(endpointURL);
              try {
                  console.log(`Connected! Starting inspect session...`);
                  const page = await browser.newPage();
                  const client = await page.context().newCDPSession(page);
                  const { frameTree: { frame } } = await client.send('Page.getFrameTree');
                  const { url: inspectUrl } = await client.send('Page.inspect', {
                      frameId: frame.id,
                  });
                  console.log(`You can inspect this session at: ${inspectUrl}.`);
                  console.log(`Scraping will continue in 10 seconds...`);
                  await sleep(10);
                  console.log(`Navigating to ${url}...`);
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping paragraphs...`);
                  const data = await page.$$eval('p', els => els.map(el => el.innerText));
                  console.log(`Scraped! Data:`, data);
                  console.log(`Session will be closed in 1 minute...`);
                  await sleep(60);
              } finally {
                  console.log(`Closing session.`);
                  await browser.close();
              }
          }

          function sleep(seconds) {
              return new Promise(resolve => setTimeout(resolve, seconds * 1000));
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```

          ```js Puppeteer theme={null}
          #!/usr/bin/env node
          const puppeteer = require('puppeteer-core');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
              const browser = await puppeteer.connect({ browserWSEndpoint });
              try {
                  console.log(`Connected! Starting inspect session...`);
                  const page = await browser.newPage();
                  const client = await page.createCDPSession();
                  const { frameTree: { frame } } = await client.send('Page.getFrameTree');
                  const { url: inspectUrl } = await client.send('Page.inspect', {
                      frameId: frame.id,
                  });
                  console.log(`You can inspect this session at: ${inspectUrl}.`);
                  console.log(`Scraping will continue in 10 seconds...`);
                  await sleep(10);
                  console.log(`Navigating to ${url}...`);
                  await page.goto(url, { timeout: 2 * 60 * 1000 });
                  console.log(`Navigated! Scraping paragraphs...`);
                  const data = await page.$$eval('p', els => els.map(el => el.innerText));
                  console.log(`Scraped! Data:`, data);
                  console.log(`Session will be closed in 1 minute...`);
                  await sleep(60);
              } finally {
                  console.log(`Closing session.`);
                  await browser.close();
              }
          }

          function sleep(seconds) {
              return new Promise(resolve => setTimeout(resolve, seconds * 1000));
          }

          function getErrorDetails(error) {
              if (error.target?._req?.res) {
                  const {
                      statusCode,
                      statusMessage,
                  } = error.target._req.res;
                  return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
              }
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(getErrorDetails(error)
                      || error.stack
                      || error.message
                      || error);
                  process.exit(1);
              });
          }
          ```

          ```js Selenium theme={null}
          #!/usr/bin/env node
          const { Builder, Browser, By } = require('selenium-webdriver');
          const {
              AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
              TARGET_URL = 'https://example.com',
          } = process.env;

          async function scrape(url = TARGET_URL) {
              if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
                  throw new Error(`Provide Browser API credentials in AUTH`
                      + ` environment variable or update the script.`);
              }
              console.log(`Connecting to Browser...`);
              const server = `https://${AUTH}@brd.superproxy.io:9515`;
              const driver = await new Builder()
                  .forBrowser(Browser.CHROME)
                  .usingServer(server)
                  .build();
              const cdp = (name, params = {}) => driver.sendAndGetDevToolsCommand(name, params);
              try {
                  console.log(`Connected! Starting inspect session...`);
                  const { frameTree: { frame } } = await cdp('Page.getFrameTree');
                  const { url: inspectUrl } = await cdp('Page.inspect', {
                      frameId: frame.id,
                  });
                  console.log(`You can inspect this session at: ${inspectUrl}.`);
                  console.log(`Scraping will continue in 10 seconds...`);
                  await sleep(10);
                  console.log(`Navigating to ${url}...`);
                  await driver.get(url);
                  console.log(`Navigated! Scraping paragraphs...`);
                  const paragraphs = await driver.findElements(By.css('p'));
                  const data = await driver.executeScript(els => els.map(el => el.innerText), paragraphs);
                  console.log(`Scraped! Data:`, data);
                  console.log(`Session will be closed in 1 minute...`);
                  await sleep(60);
              } finally {
                  console.log(`Closing session.`);
                  await driver.quit();
              }
          }

          function sleep(seconds) {
              return new Promise(resolve => setTimeout(resolve, seconds * 1000));
          }

          if (require.main == module) {
              scrape().catch(error => {
                  console.error(error.stack || error.message || error);
                  process.exit(1);
              });
          }
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Python">
        <CodeGroup>
          ```python Playwright - Async theme={null}
          #!/usr/bin/env python3
          import asyncio
          from os import environ
          from playwright.async_api import Playwright, async_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          async def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = await playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print('Connected! Starting inspect session...')
                  page = await browser.new_page()
                  client = await page.context.new_cdp_session(page)
                  frames = await client.send('Page.getFrameTree')
                  frame_id = frames['frameTree']['frame']['id']
                  inspect = await client.send('Page.inspect', {
                      'frameId': frame_id,
                  })
                  inspect_url = inspect['url']
                  print(f'You can inspect this session at: {inspect_url}.')
                  print('Scraping will continue in 10 seconds...')
                  await asyncio.sleep(10)
                  print(f'Navigating to {url}...')
                  await page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping paragraphs...')
                  data = await page.eval_on_selector_all(
                      'p', 'els => els.map(el => el.innerText)')
                  print('Scraped! Data', data)
                  print('Session will be closed in 1 minute...')
                  await asyncio.sleep(60)
              finally:
                  print('Closing session.')
                  await browser.close()


          async def main():
              async with async_playwright() as playwright:
                  await scrape(playwright)


          if __name__ == '__main__':
              asyncio.run(main())

          ```

          ```python Playwright - Sync theme={null}
          #!/usr/bin/env python3
          from os import environ
          from time import sleep
          from playwright.sync_api import Playwright, sync_playwright

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(playwright: Playwright, url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
              browser = playwright.chromium.connect_over_cdp(endpoint_url)
              try:
                  print('Connected! Starting inspect session...')
                  page = browser.new_page()
                  client = page.context.new_cdp_session(page)
                  frames = client.send('Page.getFrameTree')
                  frame_id = frames['frameTree']['frame']['id']
                  inspect = client.send('Page.inspect', {
                      'frameId': frame_id,
                  })
                  inspect_url = inspect['url']
                  print(f'You can inspect this session at: {inspect_url}.')
                  print('Scraping will continue in 10 seconds...')
                  sleep(10)
                  print(f'Navigating to {url}...')
                  page.goto(url, timeout=2*60_000)
                  print('Navigated! Scraping paragraphs...')
                  data = page.eval_on_selector_all(
                      'p', 'els => els.map(el => el.innerText)')
                  print('Scraped! Data', data)
                  print('Session will be closed in 1 minute...')
                  sleep(60)
              finally:
                  print('Closing session.')
                  browser.close()


          def main():
              with sync_playwright() as playwright:
                  scrape(playwright)


          if __name__ == '__main__':
              main()

          ```

          ```python Selenium theme={null}
          #!/usr/bin/env python3
          from os import environ
          from time import sleep
          from selenium.webdriver import Remote, ChromeOptions as Options
          from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection
          from selenium.webdriver.common.by import By

          AUTH = environ.get('AUTH', default='SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD')
          TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


          def scrape(url=TARGET_URL):
              if AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD':
                  raise Exception('Provide Browser API credentials in AUTH ' +
                                  'environment variable or update the script.')
              print('Connecting to Browser...')
              server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
              connection = Connection(server_addr, 'goog', 'chrome')
              driver = Remote(connection, options=Options())

              def cdp(cmd, params={}):
                  return driver.execute('executeCdpCommand', {
                      'cmd': cmd,
                      'params': params,
                  })['value']
              try:
                  print('Connected! Starting inspect session...')
                  frames = cdp('Page.getFrameTree')
                  frame_id = frames['frameTree']['frame']['id']
                  inspect = cdp('Page.inspect', {
                      'frameId': frame_id,
                  })
                  inspect_url = inspect['url']
                  print(f'You can inspect this session at: {inspect_url}.')
                  print('Scraping will continue in 10 seconds...')
                  sleep(10)
                  print(f'Navigating to {url}...')
                  driver.get(url)
                  print('Navigated! Scraping paragraphs...')
                  paragraphs = driver.find_elements(By.TAG_NAME, 'p')
                  data = driver.execute_script(
                      'return arguments[0].map(el => el.innerText)', paragraphs)
                  print('Scraped! Data', data)
                  print('Session will be closed in 1 minute...')
                  sleep(60)
              finally:
                  print('Closing session.')
                  driver.quit()


          if __name__ == '__main__':
              scrape()

          ```
        </CodeGroup>
      </Tab>

      <Tab title="C#">
        <CodeGroup>
          ```cs Puppeteer theme={null}
          using PuppeteerSharp;
          using System.Net.WebSockets;
          using System.Text;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private async Task<IBrowser> Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var options = new ConnectOptions()
                  {
                      BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                      WebSocketFactory = async (uri, options, cToken) =>
                      {
                          var socket = new ClientWebSocket();
                          var authBytes = Encoding.UTF8.GetBytes(_auth);
                          var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                          socket.Options.SetRequestHeader("Authorization", authHeader);
                          socket.Options.KeepAliveInterval = TimeSpan.Zero;
                          await socket.ConnectAsync(uri, cToken);
                          return socket;
                      },
                  };
                  return await Puppeteer.ConnectAsync(options);
              }

              public async Task Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var browser = await Connect();
                  try {
                      Log("Connected! Starting inspect session...");
                      var page = await browser.NewPageAsync();
                      var client = await page.Target.CreateCDPSessionAsync();
                      var frames = await client.SendAsync("Page.getFrameTree");
                      var frameId = (string) frames!["frameTree"]!["frame"]!["id"]!;
                      var inspect = await client.SendAsync("Page.inspect",
                              new { frameId = frameId });
                      var inspectUrl = (string) inspect!["url"]!;
                      Log($"You can inspect this session at: {inspectUrl}");
                      Log("Scraping will continue in 10 seconds...");
                      await Task.Delay(10 * 1000);
                      Log($"Navigating to {url}...");
                      await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                      Log("Navigated! Scraping paragraphs...");
                      var paragraphs = await page.QuerySelectorAllHandleAsync("p");
                      var data = await paragraphs.EvaluateFunctionAsync(
                              "els => els.map(el => el.innerText)");
                      Log($"Scraped! Data: {data}");
                      Log("Session will be closed in 1 minute...");
                      await Task.Delay(60 * 1000);
                  } finally {
                      Log("Closing session.");
                      await browser.CloseAsync();
                  }
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static async Task Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  await scraper.Scrape(url);
              }

          }

          ```

          ```cs Selenium theme={null}
          using OpenQA.Selenium;
          using OpenQA.Selenium.Chrome;
          using OpenQA.Selenium.Remote;

          class Scraper
          {

              private string _auth;

              public Scraper(string auth)
              {
                  _auth = auth;
              }

              private WebDriver Connect()
              {
                  if (_auth == "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD")
                  {
                      throw new Exception("Provide Browser API credentials in AUTH"
                              + " environment variable or update the script.");
                  }
                  var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
                  var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
                  var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                          "/session/{sessionId}/goog/cdp/execute");
                  executor.TryAddCommand("cdp", cdpCommand);
                  var capabilities = new ChromeOptions().ToCapabilities();
                  return new RemoteWebDriver(executor, capabilities);
              }

              public void Scrape(string url)
              {
                  Log("Connecting to Browser...");
                  var driver = Connect();
                  try {
                      Log("Connected! Starting inspect session...");
                      var frames = Cdp(driver, "Page.getFrameTree");
                      var frameId = frames.Get<string>("frameTree", "frame", "id");
                      var inspect = Cdp(driver, "Page.inspect", new (){
                          {"frameId", frameId},
                      });
                      var inspectUrl = inspect.Get<string>("url");
                      Log($"You can inspect this session at: {inspectUrl}");
                      Log("Scraping will continue in 10 seconds...");
                      Thread.Sleep(10 * 1000);
                      Log($"Navigating to {url}...");
                      driver.Navigate().GoToUrl(url);
                      Log("Navigated! Scraping paragraphs...");
                      var paragraphs = driver.FindElements(By.CssSelector("p"));
                      var data = (IEnumerable<object>) driver.ExecuteScript(
                              "return arguments[0].map(el => el.innerText);", paragraphs);
                      Log($"Scraped! Data: [{string.Join(", ", data)}]");
                      Log("Session will be closed in 1 minute...");
                      Thread.Sleep(60 * 1000);
                  } finally {
                      Log("Closing session.");
                      driver.Quit();
                  }
              }

              private Dictionary<string, object> Cdp(WebDriver driver, string cmd, Dictionary<string, object>? args = null)
              {
                  var result = driver.ExecuteCustomDriverCommand("cdp", new ()
                  {
                      {"cmd", cmd},
                      {"params", args ?? new ()},
                  });
                  return (Dictionary<string, object>) result;
              }

              private static string Env(string name, string defaultValue)
              {
                  return Environment.GetEnvironmentVariable(name) ?? defaultValue;
              }

              private static void Log(string message)
              {
                  Console.WriteLine(message);
              }

              public static void Main()
              {
                  var auth = Env("AUTH", "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD");
                  var url = Env("TARGET_URL", "https://example.com");
                  var scraper = new Scraper(auth);
                  scraper.Scrape(url);
              }

          }

          static class DictionaryUtility {
              static public T Get<T>(this Dictionary<string, object> dict, params string[] path)
              {
                  object result = dict;
                  foreach (var name in path)
                  {
                      if (result is Dictionary<string, object> obj)
                          result = obj[name];
                      else
                          throw new Exception("Wrong type");
                  }
                  return (T) result;
              }
          }

          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

***

## Optimizing Bandwidth Usage with Browser API

When optimizing your web scraping projects, conserving bandwidth is key. Explore our tips and guidelines below to utilize bandwidth-saving techniques within your script and ensure efficient, resource-friendly scraping.

### **Avoid Unnecessary Media Content**

Downloading unnecessary media (images, videos) is a common bandwidth drain. You can block these resources directly within your script.

<Note>
  Resource-blocking can occasionally impact page loading due to anti-bot expectations. If you see issues after blocking resources, revert your blocking logic before contacting support.
</Note>

<Tabs>
  <Tab title="Block All Images">
    <CodeGroup>
      ```js NodeJS - Puppeteer theme={null}
       const page = await browser.newPage();  
        
        // Enable request interception  
        await page.setRequestInterception(true);  
        
        // Listen for requests  
        page.on('request', (request) => {  
          if (request.resourceType() === 'image') {  
            // If the request is for an image, block it  
            request.abort();  
          } else {  
            // If it's not an image request, allow it to continue  
            request.continue();  
         }  
       });
      ```

      ```python Selenium theme={null}
      # Set the preference to not load images  
      prefs = {"profile.managed_default_content_settings.images": 2}  
      chrome_options.add_experimental_option("prefs", prefs)  
        
      # Create a new Chrome browser instance with the defined options  
      driver = webdriver.Chrome(options=chrome_options)  
        
      driver.get('https://example.com')
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Block Specific Image Formats">
    ```js theme={null}
     const page = await browser.newPage();  
      
      // Enable request interception  
      await page.setRequestInterception(true);  
      
      // Listen for requests  
      page.on('request', (interceptedRequest) => {  
      
        // Check if the request URL ends with '.png' or '.jpg'  
        if (  
          interceptedRequest.url().endsWith('.png') ||  
          interceptedRequest.url().endsWith('.jpg')  
        ) {  
      
          // If the request is for a PNG or JPG image, block it  
          interceptedRequest.abort();  
        } else {  
          // If it's not a PNG or JPG image request, allow it to continue  
          interceptedRequest.continue();  
       }  
     });
    ```
  </Tab>

  <Tab title="Block images and fonts">
    ```js Playwright theme={null}
     // Create a new context with specific resource types blocked  
      const context = await browser.newContext({  
        fetchResourceTypesToBlock: ['image', 'font']  
      });  
      
      const page = await context.newPage();  
      
      // Navigate to a webpage  
      await page.goto('https://example.com');
    ```
  </Tab>
</Tabs>

***

### **Block Unnecessary Network Requests**

Blocking media type requests alone may not always reduce your bandwidth usage. Some websites have ad spaces that continuously refresh ads, and others use live bidding mechanisms that constantly search for new ads if one fails to load properly.

In such cases, it's important to identify and block these specific network requests. Doing so will decrease the number of network requests and, consequently, lower your bandwidth usage.

```js Example theme={null}
 const blocked_resources = [
     "image",
     "stylesheet",
     "font",
     "media",
     "svg"
 ];
 
 const blocked_urls = [
     'www.googletagmanager.com/gtm.js',
     'cdn.adapex.io/hb',
     'pagead2.googlesyndication.com/',
 ];
 
 await page.setRequestInterception(true);
 
 page.on('request', request => {
     counter++;
     const is_url_blocked = blocked_urls.some(p => request.url().includes(p));
     const is_resource_blocked = blocked_resources.includes(request.resourceType());
     if (is_url_blocked || is_resource_blocked) {
         request.abort();
     } else {
         request.continue();
     }
 });
```

***

### **Use Browser Cache Efficiently**

One common inefficiency in scraping jobs is the repeated downloading of the same resources during a single session.

Leveraging the browser's built-in cache can significantly increase your scraping efficiency. When you navigate to multiple pages on the same domain, static resources like CSS files, JavaScript libraries, images, and fonts are automatically cached and reused. This saves bandwidth by avoiding redundant fetches and ensures faster page loads for subsequent requests.

#### Code Example

<Note>
  This example demonstrates how browser caching improves performance across multiple navigations to the same domain. Make sure to replace USER:PASS with your own credentials
</Note>

```js Puppeteer theme={null}
#!/usr/bin/env node
const puppeteer = require('puppeteer-core');

const AUTH = process.env.AUTH || 'USER:PASS';
const SBR_WS_ENDPOINT = `wss://${AUTH}@brd.superproxy.io:9222`;
const URL = 'https://www.ebay.com';

async function main() {
    console.log('Connecting to Scraping Browser...');
    const browser = await puppeteer.connect({
        browserWSEndpoint: SBR_WS_ENDPOINT,
    });
    
    try {
        const page = await browser.newPage();
        page.setDefaultTimeout(2 * 60 * 1000);
        
        const searchTerms = ['laptop', 'headphones', 'keyboard'];
        const timings = [];
        
        for (let i = 0; i < 3; i++) {
            console.log(`Running search ${i + 1}/3 for "${searchTerms[i]}"...`);
            
            const start = Date.now();
            await page.goto(URL, { waitUntil: "domcontentloaded" });
            const navTime = Date.now() - start;
            timings.push(navTime);
            console.log(`Search ${i + 1} nav time is ${navTime}ms`);
            
            // Wait for search input and perform search
            await page.waitForSelector("#gh-ac", { timeout: 30000 });
            await page.type("#gh-ac", searchTerms[i]);
            await page.click("#gh-search-btn");
            
            // Wait for results
            await page.waitForSelector("#srp-river-main", { timeout: 30000 });
        }
        
        console.log('\nResults:');
        const diff1to2 = timings[1] - timings[0];
        const diff1to3 = timings[2] - timings[0];

        console.log(
		`1st: ${timings[0]}ms | `+
        `2nd: ${timings[1]}ms (${diff1to2 > 0 ? '+' : ''}${diff1to2}ms) | `+
        `3rd: ${timings[2]}ms (${diff1to3 > 0 ? '+' : ''}${diff1to3}ms)`);
        
    } catch (error) {
        console.error(`ERROR: ${error.message}`);
        process.exit(1);
    } finally {
        await browser.close();
    }
}

main().catch(error => {
    console.error(`ERROR: ${error.message}`);
    process.exit(1);
});
```

#### Expected Output

```text theme={null}
Connecting to Scraping Browser...
Running search 1/3 for "laptop"...
Search 1 nav time is 10417ms
Running search 2/3 for "headphones"...
Search 2 nav time is 3133ms
Running search 3/3 for "keyboard"...
Search 3 nav time is 3243ms

Results:
1st: 10417ms | 2nd: 3133ms (-7284ms) | 3rd: 3243ms (-7174ms)
```

### Other strategies to try

* **Limit Your Requests:** Scrape only the data you need.
* **Concurrency Control:** Avoid opening too many concurrent pages; this can overload resources.
* **Session Management:** Properly close sessions to save resources and bandwidth.
* **Opt for APIs:** Use official APIs when available, they're often less bandwidth-intense.
* **Fetch Incremental Data:** Only scrape new/updated content, not the entire dataset every time.

***

***


# How to configure the Browser API
Source: https://docs.brightdata.com/products/scraping-browser/configuration

Configure the Bright Data Browser API with your username and password, connect 1 of 3 drivers (Puppeteer, Playwright, Selenium) and run browser sessions.

To get started, you’ll need your **Browser API credentials**, specifically the **Username** and **Password** used by your web automation tool. These credentials are available in the **Overview** tab of the Browser API zone you created earlier.

Before proceeding, make sure you have your preferred browser automation framework (such as Puppeteer, Playwright, or Selenium) already installed. If it’s not installed yet, complete that setup first to ensure a smooth configuration process.

## Browser API Quick Start Examples

Run these basic examples to check that your Browser API is working (remember to swap in your credentials and target URL):

<Tip>
  For advanced examples, such as handling [**captchas**](/products/scraping-browser/cdp-functions/custom#captcha-solver), see the [**Code Examples**](/products/scraping-browser/code-examples) section.
</Tip>

<Tabs>
  <Tab title="NodeJS">
    <CodeGroup>
      ```js Puppeteer theme={null}
      #!/usr/bin/env node
      const puppeteer = require('puppeteer-core');
      const {
          // Replace with your Browser API zone credentials
          AUTH = 'USER:PASS',
          TARGET_URL = 'https://example.com',
      } = process.env;

      async function scrape(url = TARGET_URL) {
          if (AUTH == 'USER:PASS') {
              throw new Error(`Provide Browser API credentials in AUTH`
                  + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
          const browser = await puppeteer.connect({ browserWSEndpoint });
          try {
              console.log(`Connected! Navigating to ${url}...`);
              const page = await browser.newPage();
              const client = await page.createCDPSession();
              const { frameTree: { frame } } = await client.send('Page.getFrameTree');
              const { url: inspectUrl } = await client.send('Page.inspect', {
                  frameId: frame.id,
              });
              console.log(`You can inspect this session at: ${inspectUrl}.`);
              await page.goto(url, { timeout: 2 * 60 * 1000 });
              console.log(`Navigated! Scraping page content...`);
              const data = await page.content();
              console.log(`Scraped! Data: ${data}`);
          } finally {
              await browser.close();
          }
      }

      function getErrorDetails(error) {
          if (error.target?._req?.res) {
              const {
                  statusCode,
                  statusMessage,
              } = error.target._req.res;
              return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
          }
      }

      if (require.main == module) {
          scrape().catch(error => {
              console.error(getErrorDetails(error)
                  || error.stack
                  || error.message
                  || error);
              process.exit(1);
          });
      }
      ```

      ```js Playwright theme={null}
      #!/usr/bin/env node
      const playwright = require('playwright');
      const {
          // Replace with your Browser API zone credentials
          AUTH = 'USER:PASS',
          TARGET_URL = 'https://example.com',
      } = process.env;

      async function scrape(url = TARGET_URL) {
          if (AUTH == 'USER:PASS') {
              throw new Error(`Provide Browser API credentials in AUTH`
                  + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
          const browser = await playwright.chromium.connectOverCDP(endpointURL);
          try {
              console.log(`Connected! Navigating to ${url}...`);
              const page = await browser.newPage();
              const client = await page.context().newCDPSession(page);
              const { frameTree: { frame } } = await client.send('Page.getFrameTree');
              const { url: inspectUrl } = await client.send('Page.inspect', {
                  frameId: frame.id,
              });
              console.log(`You can inspect this session at: ${inspectUrl}.`);
              await page.goto(url, { timeout: 2 * 60 * 1000 });
              console.log(`Navigated! Scraping page content...`);
              const data = await page.content();
              // Print HTML data
              console.log(`Scraped! Data: ${data}`);
          } finally {
              await browser.close();
          }
      }

      if (require.main == module) {
          scrape().catch(error => {
              console.error(error.stack || error.message || error);
              process.exit(1);
          });
      }
      ```

      ```js Selenium theme={null}
      #!/usr/bin/env node
      const { Builder, Browser } = require('selenium-webdriver');
      const {
          // Replace with your Browser API zone credentials
          AUTH = 'USER:PASS',
          TARGET_URL = 'https://example.com',
      } = process.env;

      async function scrape(url = TARGET_URL) {
          if (AUTH == 'USER:PASS') {
              throw new Error(`Provide Browser API credentials in AUTH`
                  + ` environment variable or update the script.`);
          }
          console.log(`Connecting to Browser...`);
          const server = `https://${AUTH}@brd.superproxy.io:9515`;
          const driver = await new Builder()
              .forBrowser(Browser.CHROME)
              .usingServer(server)
              .build();
          const cdp = (name, params = {}) => driver.sendAndGetDevToolsCommand(name, params);
          try {
              console.log(`Connected! Navigating to ${url}...`);
              const { frameTree: { frame } } = await cdp('Page.getFrameTree');
              const { url: inspectUrl } = await cdp('Page.inspect', {
                  frameId: frame.id,
              });
              console.log(`You can inspect this session at: ${inspectUrl}.`);
              await driver.get(url);
              console.log(`Navigated! Scraping page content...`);
              const data = await driver.getPageSource();
              console.log(`Scraped! Data: ${data}`);
          } finally {
              await driver.quit();
          }
      }

      if (require.main == module) {
          scrape().catch(error => {
              console.error(error.stack || error.message || error);
              process.exit(1);
          });
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Python">
    <CodeGroup>
      ```python Playwright theme={null}
      #!/usr/bin/env python3
      import asyncio
      from os import environ
      from playwright.async_api import Playwright, async_playwright

      # Replace with your Browser API zone credentials
      AUTH = environ.get('AUTH', default='USER:PASS')
      TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


      async def scrape(playwright: Playwright, url=TARGET_URL):
          if AUTH == 'USER:PASS':
              raise Exception('Provide Browser API credentials in AUTH '
                              'environment variable or update the script.')
          print('Connecting to Browser...')
          endpoint_url = f'wss://{AUTH}@brd.superproxy.io:9222'
          browser = await playwright.chromium.connect_over_cdp(endpoint_url)
          try:
              print(f'Connected! Navigating to {url}...')
              page = await browser.new_page()
              client = await page.context.new_cdp_session(page)
              frames = await client.send('Page.getFrameTree')
              frame_id = frames['frameTree']['frame']['id']
              inspect = await client.send('Page.inspect', {
                  'frameId': frame_id,
              })
              inspect_url = inspect['url']
              print(f'You can inspect this session at: {inspect_url}.')
              await page.goto(url, timeout=2*60_000)
              print('Navigated! Scraping page content...')
              data = await page.content()
              print(f'Scraped! Data: {data}')
          finally:
              await browser.close()


      async def main():
          async with async_playwright() as playwright:
              await scrape(playwright)


      if __name__ == '__main__':
          asyncio.run(main())
      ```

      ```python Selenium theme={null}
      #!/usr/bin/env python3
      from os import environ
      from selenium.webdriver import Remote, ChromeOptions as Options
      from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

      # Replace with your Browser API zone credentials
      AUTH = environ.get('AUTH', default='USER:PASS')
      TARGET_URL = environ.get('TARGET_URL', default='https://example.com')


      def scrape(url=TARGET_URL):
          if AUTH == 'USER:PASS':
              raise Exception('Provide Browser API credentials in AUTH '
                              'environment variable or update the script.')
          print('Connecting to Browser...')
          browserWSEndpoint = f'https://{AUTH}@brd.superproxy.io:9515'
          connection = Connection(browserWSEndpoint, 'goog', 'chrome')
          driver = Remote(connection, options=Options())

          def cdp(cmd, params={}):
              return driver.execute('executeCdpCommand', {
                  'cmd': cmd,
                  'params': params,
              })['value']

          try:
              print(f'Connected! Navigating to {url}...')
              frames = cdp('Page.getFrameTree')
              frame_id = frames['frameTree']['frame']['id']
              inspect = cdp('Page.inspect', {
                  'frameId': frame_id,
              })
              inspect_url = inspect['url']
              print(f'You can inspect this session at: {inspect_url}')
              driver.get(url)
              print('Navigated! Scraping page content...')
              data = driver.page_source
              print(f'Scraped! Data: {data}')
          finally:
              driver.quit()


      if __name__ == '__main__':
          scrape()
      ```
    </CodeGroup>
  </Tab>

  <Tab title="C#">
    <CodeGroup>
      ```cs PuppeteerSharp theme={null}
      using PuppeteerSharp;
      using System.Net.WebSockets;
      using System.Text;

      class Scraper
      {

          private string _auth;

          public Scraper(string auth)
          {
              _auth = auth;
          }

          private async Task<IBrowser> Connect()
          {
              if (_auth == "USER:PASS")
              {
                  throw new Exception("Provide Browser API credentials in AUTH"
                          + " environment variable or update the script.");
              }
              var options = new ConnectOptions()
              {
                  BrowserWSEndpoint = "wss://brd.superproxy.io:9222",
                  WebSocketFactory = async (uri, options, cToken) =>
                  {
                      var socket = new ClientWebSocket();
                      var authBytes = Encoding.UTF8.GetBytes(_auth);
                      var authHeader = "Basic " + Convert.ToBase64String(authBytes);
                      socket.Options.SetRequestHeader("Authorization", authHeader);
                      socket.Options.KeepAliveInterval = TimeSpan.Zero;
                      await socket.ConnectAsync(uri, cToken);
                      return socket;
                  },
              };
              return await Puppeteer.ConnectAsync(options);
          }

          public async Task Scrape(string url)
          {
              Console.WriteLine("Connecting to Browser...");
              var browser = await Connect();
              try {
                  Console.WriteLine($"Connected! Navigating to {url}...");
                  var page = await browser.NewPageAsync();
                  var client = await page.Target.CreateCDPSessionAsync();
                  var frames = await client.SendAsync("Page.getFrameTree");
                  var frameId = frames!.Value.GetProperty("frameTree").GetProperty("frame")
      										.GetProperty("id").GetString();
                  var parameters = new Dictionary<string, object> { { "frameId", frameId } };
                  var inspect = await client.SendAsync("Page.inspect", parameters);
                  var inspectUrl = inspect!.Value.GetProperty("url").GetString();
                  Console.WriteLine($"You can inspect this session at: {inspectUrl}");
                  await page.GoToAsync(url, /* timeout= */ 2 * 60 * 1000);
                  Console.WriteLine("Navigated! Scraping page content...");
                  var data = await page.GetContentAsync();
                  Console.WriteLine($"Scraped! Data: {data}");
              } finally {
                  await browser.CloseAsync();
              }
          }

          private static string Env(string name, string defaultValue)
          {
              return Environment.GetEnvironmentVariable(name) ?? defaultValue;
          }

          public static async Task Main()
          {
              // Replace with your Browser API zone credentials
              var auth = Env("AUTH", "USER:PASS");
              var url = Env("TARGET_URL", "https://example.com");
              var scraper = new Scraper(auth);
              await scraper.Scrape(url);
          }

      }
      ```

      ```cs Playwright theme={null}
      using Microsoft.Playwright;

      class Scraper
      {

          private IPlaywright _pw;
          private string _auth;

          public Scraper(IPlaywright pw, string auth)
          {
              _pw = pw;
              _auth = auth;
          }

          private async Task<IBrowser> Connect()
          {
              if (_auth == "USER:PASS")
              {
                  throw new Exception("Provide Browser API credentials in AUTH"
                          + " environment variable or update the script.");
              }
              var endpointURL = $"wss://{_auth}@brd.superproxy.io:9222";
              return await _pw.Chromium.ConnectOverCDPAsync(endpointURL);
          }

          public async Task Scrape(string url)
          {
              Console.WriteLine("Connecting to Browser...");
              var browser = await Connect();
              try {
                  Console.WriteLine($"Connected! Navigating to {url}...");
                  var page = await browser.NewPageAsync();
                  var client = await page.Context.NewCDPSessionAsync(page);
                  var frames = await client.SendAsync("Page.getFrameTree");
                  var frameId = frames!.Value.GetProperty("frameTree").GetProperty("frame")
      										.GetProperty("id").GetString();
                  var parameters = new Dictionary<string, object> { { "frameId", frameId } };
                  var inspect = await client.SendAsync("Page.inspect", parameters);
                  var inspectUrl = inspect!.Value.GetProperty("url").GetString();
                  Console.WriteLine($"You can inspect this session at: {inspectUrl}");
                  await page.GotoAsync(url, new (){ Timeout = 2 * 60 * 1000 });
                  Console.WriteLine("Navigated! Scraping page content...");
                  var data = await page.ContentAsync();
                  Console.WriteLine($"Scraped! Data: {data}");
              } finally {
                  await browser.CloseAsync();
              }
          }

          private static string Env(string name, string defaultValue)
          {
              return Environment.GetEnvironmentVariable(name) ?? defaultValue;
          }

          public static async Task Main()
          {
              // Replace with your Browser API zone credentials
              var auth = Env("AUTH", "USER:PASS");
              var url = Env("TARGET_URL", "https://example.com");
              var pw = await Playwright.CreateAsync();
              var scraper = new Scraper(pw, auth);
              await scraper.Scrape(url);
          }

      }
      ```

      ```cs Selenium theme={null}
      using OpenQA.Selenium;
      using OpenQA.Selenium.Chrome;
      using OpenQA.Selenium.Remote;

      class Scraper
      {

          private string _auth;

          public Scraper(string auth)
          {
              _auth = auth;
          }

          private WebDriver Connect()
          {
              if (_auth == "USER:PASS")
              {
                  throw new Exception("Provide Browser API credentials in AUTH"
                          + " environment variable or update the script.");
              }
              var uri = new Uri($"https://{_auth}@brd.superproxy.io:9515");
              var executor = new HttpCommandExecutor(uri, TimeSpan.FromSeconds(60));
              var cdpCommand = new HttpCommandInfo(HttpCommandInfo.PostCommand,
                      "/session/{sessionId}/goog/cdp/execute");
              executor.TryAddCommand("cdp", cdpCommand);
              var capabilities = new ChromeOptions().ToCapabilities();
              return new RemoteWebDriver(executor, capabilities);
          }

          public void Scrape(string url)
          {
              Console.WriteLine("Connecting to Browser...");
              var driver = Connect();
              try {
                  Console.WriteLine($"Connected! Navigating to {url}...");
                  var frames = Cdp(driver, "Page.getFrameTree");
                  var frameId = frames.Get<string>("frameTree", "frame", "id");
                  var inspect = Cdp(driver, "Page.inspect", new (){
                      {"frameId", frameId},
                  });
                  var inspectUrl = inspect.Get<string>("url");
                  Console.WriteLine($"You can inspect this session at: {inspectUrl}");
                  driver.Navigate().GoToUrl(url);
                  Console.WriteLine("Navigated! Scraping page content...");
                  var data = driver.PageSource;
                  Console.WriteLine($"Scraped! Data: {data}");
              } finally {
                  driver.Quit();
              }
          }

          private static string Env(string name, string defaultValue)
          {
              return Environment.GetEnvironmentVariable(name) ?? defaultValue;
          }

          private Dictionary<string, object> Cdp(WebDriver driver, string cmd, Dictionary<string, object>? args = null)
          {
              var result = driver.ExecuteCustomDriverCommand("cdp", new ()
              {
                  {"cmd", cmd},
                  {"params", args ?? new ()},
              });
              return (Dictionary<string, object>) result;
          }

          public static void Main()
          {
              // Replace with your Browser API zone credentials
              var auth = Env("AUTH", "USER:PASS");
              var url = Env("TARGET_URL", "https://example.com");
              var scraper = new Scraper(auth);
              scraper.Scrape(url);
          }

      }

      static class DictionaryUtility {

          static public T Get<T>(this Dictionary<string, object> dict, params string[] path)
          {
              object result = dict;
              foreach (var name in path)
              {
                  if (result is Dictionary<string, object> obj)
                      result = obj[name];
                  else
                      throw new Exception("Wrong type");
              }
              return (T) result;
          }
      }
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## How same-domain navigation works

Browser API sessions are structured to allow unlimited navigations within the same domain. This means users can freely navigate, load new pages, click links, scroll, and perform other interactive actions throughout the session, as long as all navigations remain on the same domain. To start a scraping job on a different domain, it is necessary to begin a new session.

## Session Time Limits

Browser API has 2 kinds of timeouts aimed to safeguard our customers from uncontrolled usage.

1. Idle Session Timeout: in case a browser session is kept open for 5 minutes and above in an idle mode, meaning no usage going through it, Browser API will automatically timeout the session.
2. Maximum Session Length Timeout: Browser API session can last up to 60 minutes. Once the maximum session time is reached the session will automatically timeout.


# Browser API error codes
Source: https://docs.brightdata.com/products/scraping-browser/error-codes

Reference for Bright Data Browser API error codes, grouped into four categories, with each code's meaning and a suggested action to resolve it.

This reference lists Bright Data Browser API error codes, grouped into four categories, with each code's meaning and a suggested action.

When a request fails, Browser API returns a specific error code. Find the code in the tables below and follow the "Suggested Action" column.

## Access and permissions

These errors indicate an access or permissions issue. The request was stopped either because your Browser API zone requires a configuration change, or because the target is restricted by Bright Data's compliance safeguards.

| <div>Error Code</div> | Meaning | Suggested Action |
| - | - | - |
| `brob` | Target is blocked by robots.txt. | Robots.txt is a limitation from the target site defining what bots can and can't access. To remove it, complete [KYC verification](/products/residential/network-access). |
| `brul` | Target restricted by Bright Data. | If accessing blocked resources is required, get permission from compliance at [compliance@brightdata.com](mailto:compliance@brightdata.com). |
| `custom_headers` | Customer does not have permission to change headers or cookies. | Enable **Custom headers and cookies** in your zone configurations in your Browser API zone. |
| `wrong_customer_name` | Invalid username. | Verify your username is correct in the Bright Data control panel. |
| `zone_not_found` | The specified zone does not exist or is not active. | Confirm that you're using the correct and active "Browser API" zone from the Bright Data control panel. |
| `wrong_password` | Incorrect zone password. | Verify your zone password is correct in the Bright Data control panel. |
| `missing_credentials` | Authentication credentials missing. | Add valid Browser API credentials to your script. |

## Proxy errors

These errors indicate a routing or connection issue between the Browser API and the underlying proxy network. They typically happen when the proxy network struggles to establish or maintain a stable connection.

| <div>Error Code</div> | Meaning | Suggested Action |
| - | - | - |
| `no_peers` | Failed to establish connection with peer. | Retry after some time, or remove peer restrictions (country, session, location). |
| `proxy_no_peer` | Failed to establish connection with peer. | Retry after some time, or remove peer restrictions (country, session, location). |
| `reserve_no_result` | No peers available in the targeted country. | Try removing or changing country targeting. |
| `geo_no_navigation` | Cannot resolve geolocation before navigating (occurs when calling `Proxy.getGeolocation` before navigating to a page). | Navigate to a page first, then retry. |
| `proxy_cooling_peers` | No peers available because the assigned peer is in a cooling period. | Retry after some time, or remove peer restrictions (country, session, location). |
| `proxy_no_peers_cooling` | No peers available because the assigned peer is in a cooling period. | Retry after some time, or remove peer restrictions (country, session, location). |
| `proxy_timeout` | Proxy connection timeout. | Retry after some time. |

### `proxy_error` messages

The `proxy_error` code is part of the Proxy errors above, but it covers several proxy-side conditions. The exact cause is described in the accompanying message:

| Message | Suggested Action |
| - | - |
| Country is not permitted for targeting. | Try a different country. |
| Proxy unable to resolve the targeted site host. | Check that the site is available. |
| Proxy connection timeout. | Retry after some time. |
| Peer failed to establish a connection to the target site. | Retry after some time. |

## Session limits

Browser API sessions are time-boxed to ensure optimal performance. These errors occur when a session runs too long, sits idle, or navigates multiple domains. To avoid them, break your tasks into shorter sessions and close connections promptly.

| <div>Error Code</div> | Meaning | Suggested Action |
| - | - | - |
| `session_timeout` | Session reached the 60-minute limit. | Reduce session time; split into multiple sessions. |
| `inactivity_timeout` | Session terminated after 5 minutes with no CDP command sent to the browser. | Send CDP commands periodically to keep the session active, or close the session when done. |
| `network_inactivity_timeout` | Session terminated after 5 minutes of no network activity. | Disconnect from the browser after scraping (for WebDriver, also delete the session). |
| `client_timeout` | Connection from customer to browser not established in time (30s). | Check your internet connection and retry. |
| `navigate_domains_limit` | Session limited to one domain. | Open a new session per domain. |

## Browser and target site

These errors occur in the browser layer due to invalid script commands, timeouts or unexpected crashes. To resolve them, debug your automation code or retry the session.

| <div>Error Code</div> | Meaning | Suggested Action |
| - | - | - |
| `cdp_cmd_timeout` | A command to the browser timed out. | Retry the command. |
| `browser_disconnected` | Browser disconnected due to a temporary internal error. | Retry, or establish a new session. |
| `no_free_workers` | No browsers were available to handle the request. This occurs before a browser connection is established and usually indicates a temporary issue. | Retry after some time. If it persists, contact [support](mailto:support@brightdata.com). |
| `worker_disconnect` | The browser worker crashed or there was an internal infrastructure failure. | Retry, or establish a new session. |
| `job_killed` | The browser session was closed due to an infrastructure failure. | Retry, or establish a new session. |
| `page_navigated_error` | An error occurred during navigation, usually related to an internal issue. | Retry, or establish a new session. |

### `cdp_error` messages

The `cdp_error` code is part of the Browser and target site errors above, but it covers several browser-side conditions. The exact cause is described in the accompanying message:

| Message | Suggested Action |
| - | - |
| The browser target or session was closed and can't accept commands. | Fix script errors in your code (often caused by a missing `await` statement). |
| A CDP command was misused (for example, invalid arguments passed to `Fetch.dropRequests`). | Verify the command name and its parameters are valid and correctly formatted for that CDP command. |

## Chromium network errors (net::ERR\_\*)

When the browser can't reach or load a target site, it returns a standard Chrome network error prefixed with `net::ERR_`. These are the same errors you'd see in a regular Chrome browser, and they typically point to the state of the target site. For example, the site is temporarily down, unreachable or has an invalid TLS certificate.

Error response format:

```text theme={null}
Error: net::ERR_CONNECTION_CLOSED at https://example.com
```

Because these are native Chrome errors, there are many possible codes. To understand a specific error and its cause, search the exact error name on [source.chromium.org](https://source.chromium.org).

<Note>
  **Need more help?** For further assistance, contact [support@brightdata.com](mailto:support@brightdata.com).
</Note>


# Browser API FAQs
Source: https://docs.brightdata.com/products/scraping-browser/faqs

FAQs about Bright Data's Browser API across 3 supported drivers (Puppeteer, Playwright, Selenium), debugging tips and integration guidelines.

<AccordionGroup>
  <Accordion title="Can I choose the country that the Browser API will scrape from?">
    Browser API automatically selects the optimal IP type and location for each request using Bright Data’s advanced unblocking capabilities. While it’s possible to specify a location, this is generally not recommended because the automated system ensures the best success for page access.

    If you need to launch from a specific country, you can add the `-country` flag with the appropriate two-letter ISO code after your username in the endpoint. For full instructions and examples, see our [location targeting documentation](/products/scraping-browser/features/proxy-location).

    If you need to target a specific region (not just a country), check out our [Proxy.setLocation guide.](/products/scraping-browser/features/proxy-location#how-to-set-the-geolocation-radius)
  </Accordion>

  <Accordion title="Which programming languages and tools are fully supported by Browser API?">
    * Browser API has full, native support for these combinations:
      * **Node.js**: Puppeteer (native), Playwright (native), Selenium WebDriverJS
      * **Python**: Playwright for Python, Selenium WebDriver for Python
      * **Java**: Playwright for Java, Selenium WebDriver for Java
      * **C# (.NET)**: Playwright for .NET, Selenium WebDriver for .NET

    See the [code examples](/products/scraping-browser/code-examples) page for a variety of examples using the supported libraries.
  </Accordion>

  <Accordion title="How can I use Browser API with other languages and tools?">
    * Browser API can also be integrated with other languages using community or third-party libraries:
      * **Java**: Puppeteer Java
      * **Ruby**: Puppeteer-Ruby, playwright-ruby-client, Selenium WebDriver for Ruby
      * **Go**: chromedp, playwright-go, Selenium WebDriver for Go
    * For languages not listed, integration is possible if the library supports remote Chrome DevTools Protocol or WebDriver.

    <Note>
      For best results and access to the full feature set, use the native integrations listed in the fully supported languages FAQ.
    </Note>
  </Accordion>

  <Accordion title="How do I see the status of the captcha?">
    You can use the CDP functionality to wait for a captcha to be solved and check its status. For detailed instructions and sample code, see this [guide](/products/scraping-browser/cdp-functions/custom#captcha-solver)

    For example, you can add this code snippet at the point in your script where you expect a captcha to appear:

    <CodeGroup>
      ```sh NodeJS, Puppeteer theme={null}
      const client = await page.target().createCDPSession();  
      const {status} = await client.send('Captcha.solve', {detectTimeout: 30*1000});   
      console.log(`Captcha solve status: ${status}`)   
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How can I debug what's happening behind the scenes during my Browser API session?">
    You can monitor a live Browser API session by launching the **Browser API Debugger** on your local machine. This is similar to setting headless browser to 'FALSE' on Puppeteer.

    The **Browser API Debugger** serves as a valuable resource, enabling you to inspect, analyze, and fine-tune your code alongside Chrome Dev Tools, resulting in better control, visibility, and efficiency.

    ## Where do I find the Browser API Debugger?

    The Browser API Debugger can be launched via two methods:

    * Manually via Control Panel
    * Remotely via your script.

      <Tabs>
        <Tab title="via Control Panel">
          The Browser API Debugger can be easily accessed within your Bright Data [Control Panel](https://brightdata.com/cp/). Follow these steps:

          1. Within the control panel, go to [Web Access](https://brightdata.com/cp/web_access/) view
          2. Click on your specific Browser API
          3. Click on the **Overview** tab
          4. On the right side, Click on the "Chrome Dev Tools Debugger" button <img alt="chrome-devtools-debugger.png" /> **Getting Started with the Debugger & Chrome Dev Tools**

          <Steps>
            <Step title="Open a Browser API Session">
              * Ensure you have an **active** Browser API session
              * If you don't yet know how to launch a Browser API session, see our [Quick Start](/products/scraping-browser/introduction) guide.
            </Step>

            <Step title="Launch the Debugger">
              * Once your session is up and running you can now launch the Debugger.
              * Click on the Debugger button within your *Overview* tab to launch the Browser API Debugger interface (see the screenshot [above](#h_01H17FZAYFCAKBQ358JN5G2FQP) )
            </Step>

            <Step title="Connect with your live browser sessions">
              * Within the Debugger interface, you will find a list of your live Browser API sessions.
              * Select the preferred session that you wish to debug
              * Click on the session link or copy/paste it into your browser of choice, and this will establish a connection between the Debugger and your selected session.
            </Step>
          </Steps>
        </Tab>

        <Tab title="via Code (remote)">
          To access and launch the debugger session directly from your script, you'll need to send the CDP command: `Page.inspect`.

          <CodeGroup>
            ```js Puppeteer theme={null}
            // Node.js Puppeteer - Inspect page using devtools  
            const page = await browser.newPage();  
            const client = await page.target().createCDPSession();  
            const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});  
            const {url: inspectUrl} = await client.send('Page.inspect', {  
                frameId: frame.id,  
            });  
            console.log(`Inspect session at ${inspectUrl}`);
            ```

            ```js Playwright theme={null}
            // Node.js Playwright - Inspect page using devtools  
            const page = await browser.newPage();  
            const client = await page.context().newCDPSession(page);  
            const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});  
            const {url: inspectUrl} = await client.send('Page.inspect', {  
                frameId: frame.id,  
            });  
            console.log(`Inspect session at ${inspectUrl}`);
            ```

            ```Python Playwright theme={null}
            # Python Playwright - Inspect page using devtools  
            page = await browser.new_page()  
            client = await page.context.new_cdp_session(page)  
            frame_tree = await client.send('Page.getFrameTree', {})  
            frame_id = frame_tree['frameTree']['frame']['id']  
            inspect = await client.send('Page.inspect', {'frameId': frame_id})  
            inspect_url = inspect['url']  
            print('Inspect session at', inspect_url)
            ```

            ```cs PuppeteerSharp theme={null}
            // C# PuppeteerSharp - Inspect page using devtools  
            var page = await browser.NewPageAsync();  
            var client = await page.Target.CreateCDPSessionAsync();  
            var frameTree = await client.SendAsync("Page.getFrameTree");  
            var frameId = frameTree!["frameTree"]!["frame"]!["id"]!;  
            var inspect = await client.SendAsync("Page.inspect", new { frameId = frameId });  
            var inspectUrl = inspect["url"]!;  
            Console.WriteLine($"Inspect session at {inspectUrl}");
            ```

            ```cs Playwright theme={null}
            // C# Playwright - Inspect page using devtools  
            var page = await browser.NewPageAsync();  
            var client = await page.Context.NewCDPSessionAsync(page);  
            var frameTree = await client.SendAsync("Page.getFrameTree");  
            var frameId = frameTree.Value  
                .GetProperty("frameTree")  
                .GetProperty("frame")  
                .GetProperty("id")  
                .GetString()!;  
            var inspect = await client.SendAsync("Page.inspect", new ()  
            {  
                { "frameId", frameId },  
            });  
            var inspectUrl = inspect.Value  
                .GetProperty("url")  
                .GetString()!;  
            Console.WriteLine($"Inspect session at {inspectUrl}");
            ```
          </CodeGroup>
        </Tab>
      </Tabs>

      **Leveraging Chrome Dev Tools**

      * With the Browser API Debugger now connected to your live session, you gain access to the powerful features of [Chrome Dev Tools](https://chromedevtools.github.io/devtools-protocol/).
      * Utilize the Dev Tools interface to inspect HTML elements, analyze network requests, debug JavaScript code, and monitor performance. Leverage breakpoints, console logging, and other debugging techniques to identify and resolve issues within your code. <img alt="test-sites.png" />
  </Accordion>

  <Accordion title="How to automatically launch devtools locally to view your live browser session?">
    If you would like to automatically launch devtools on every session to view your live browser session, you can integrate the following code snippet:

    ```js NodeJS - Puppeteer theme={null}
    // Node.js Puppeteer - launch devtools locally  

    // Add these requirements in addition to the other required imports
    const { exec } = require('child_process');  
    const chromeExecutable = 'google-chrome';  

    // Add these functions to the top of the script  
    const delay = ms => new Promise(resolve => setTimeout(resolve, ms));  
    const openDevtools = async (page, client) => {  
        // get current frameId  
        const frameId = page.mainFrame()._id;  
        // get URL for devtools from Browser API  
        const { url: inspectUrl } = await client.send('Page.inspect', { frameId });  
        // open devtools URL in local chrome  
        exec(`"${chromeExecutable}" "${inspectUrl}"`, error => {  
            if (error)  
                throw new Error('Unable to open devtools: ' + error);  
        });  
        // wait for devtools ui to load  
        await delay(5000);  
    };  

    // Add these lines before navigating to the target URL  
    const page = await browser.newPage();  
    const client = await page.target().createCDPSession();  
    await openDevtools(page, client);  
    await page.goto('http://example.com');

    ```
  </Accordion>

  <Accordion title="How can I get a screenshot of what's happening in the browser?">
    <Tabs>
      <Tab title="Triggering a screenshot">
        You can easily trigger a screenshot of the browser at any time by adding the following to your code:

        ```js NodeJS theme={null}
        // node.js puppeteer - Taking screenshot to file screenshot.png 
        await page.screenshot({ path: 'screenshot.png', fullPage: true });
        ```

        To take screenshots on Python and C# see [here.](/products/scraping-browser/code-examples)
      </Tab>

      <Tab title="Launch devtools locally">
        See our full section on [opening devtools automatically.](/products/scraping-browser/features/troubleshooting#scraping-browser-debugger)
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Why does the initial navigation for certain pages take longer than others?">
    There is a lot of “behind the scenes” work that goes into unlocking your targeted site.

    Some sites will take just a few seconds for navigation, while others might take even up to a minute or two as they require more complex unlocking procedures. As such, we recommend setting your navigation timeout to “2 minutes” to give the navigation enough time to succeed if needed.

    You can set your navigation timeout to 2 minutes by adding the following line in your script **before** your “page.goto” call.

    <CodeGroup>
      ```js Puppeteer theme={null}
      // node.js puppeteer - Navigate to site with 2 min timeout  
      page.goto('<https://example.com>', { timeout: 2*60*1000 });  
      ```

      ```python Playwright theme={null}
      # python playwright - Navigate to site with 2 min timeout   
      page.goto('<https://example.com>', timeout=2*60*1000)  
      ```

      ```cs PuppeteerSharp theme={null}
      // C# PuppeteerSharp - Navigate to site with 2 min timeout   
      await page.GoToAsync("https://example.com", new NavigationOptions()  
      {  
          Timeout = 2*60*1000,  
      });
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="What should I do when I get an error from the Browser API?">
    Each error returned by the Browser API includes an error code that indicates the cause of the failure. Check the [error codes page](https://docs.brightdata.com/products/scraping-browser/error-codes) to find the meaning of the code you received and the suggested action.
  </Accordion>

  <Accordion title="Which status codes does the Browser API return for errors?">
    When a request fails, the Browser API may return a specific HTTP status code. Here are some common error codes, their meanings, and the suggested actions:

    | Error Code | Meaning | Suggested Action |
    | :- | :- | :- |
    | Unexpected server response: 407 | Authentication Error | Check your authentication credentials (username, password) and verify that you are using the correct “Browser API” zone from the Bright Data control panel |
    | Unexpected server response: 403 | Authentication Error | Check your authentication credentials (username, password) and verify that you are using the correct "Browser API" zone from the Bright Data control panel. |
    | Unexpected server response: 503 | Service Unavailable | We are likely scaling browsers right now to meet demand. Try to reconnect in 1 minute. |
  </Accordion>

  <Accordion title="I can't seem to establish a connection with Browser API, do I have a connection issue?">
    If you're experiencing connection issues, you can test your local Browser API connection with a simple curl to the following endpoint:

    ```sh Shell theme={null}
    curl -v -u SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD https://brd.superproxy.io:9222/json/protocol
    ```

    #### If a JSON is returned within the response:

    * Your authentication and connection to Browser API are successful. Confirm you are using these exact configurations in your script.
    * If you are still facing issues connecting to Browser API, [contact support](mailto:support@brightdata.com) for further assistance.

    #### If a JSON is not returned within the response:

    * Check your authentication details from your Browser API zone, and ensure the USER and PASS values are correct.
    * Verify network Configuration: Confirm your network and/or firewall is not blocking outbound connections to `https://brd.superproxy.io:9222`.
    * If the issue persists, please [contact support](mailto:support@brightdata.com) for further assistance.
  </Accordion>

  <Accordion title="How to Integrate Browser API with .NET Puppeteer Sharp?">
    Integration with the Browser API product with C# requires patching the PuppeteerSharp library to add support for websocket authentication. This can be done like the following:

    ```cs C# PuppeteerSharp theme={null}
    using PuppeteerSharp;  
    using System.Net.WebSockets;  
    using System.Text;  
      
    // Set the authentication credentials  
    var auth = "SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD";  
    // Construct the WebSocket URL with authentication  
    var ws = $"wss://{auth}@brd.superproxy.io:9222";  
    // Custom WebSocket factory function  
    async Task<WebSocket> ws_factory(Uri url, IConnectionOptions options, CancellationToken cancellationToken)  
      
    {  
        // Create a new ClientWebSocket instance
        var socket = new ClientWebSocket();  
        // Extract the user information (username and password) from the URL  
        var user_info = url.UserInfo;  
        if (user_info != "")  
        {  
            // Encode the user information in Base64 format  
            var auth = Convert.ToBase64String(Encoding.Default.GetBytes(user_info));  
            // Set the "Authorization" header of the WebSocket options with the encoded credentials  
            socket.Options.SetRequestHeader("Authorization", $"Basic {auth}");  
        }  
      
        // Disable the WebSocket keep-alive interval  
        socket.Options.KeepAliveInterval = TimeSpan.Zero;  
        // Connect to the WebSocket endpoint  
        await socket.ConnectAsync(url, cancellationToken);  
        return socket;  
    }  
      
    // Create ConnectOptions and configure the options  
    var options = new ConnectOptions()  
      
    {  
        // Set the BrowserWSEndpoint to the WebSocket URL  
        BrowserWSEndpoint = ws,  
        // Set the WebSocketFactory to the custom factory function  
        WebSocketFactory = ws_factory,  
    };  
      
    // Connect to the browser using PuppeteerSharp  
    Console.WriteLine("Connecting to browser...");  
      
    using (var browser = await Puppeteer.ConnectAsync(options))  
    {  
        Console.WriteLine("Connected! Navigating...");  
        // Create a new page instance  
        var page = await browser.NewPageAsync();  
        // Navigate to the specified URL  
        await page.GoToAsync("https://example.com");  
        Console.WriteLine("Navigated! Scraping data...");  
        // Get the content of the page  
        var content = await page.GetContentAsync();  
        Console.WriteLine("Done!");  
        Console.WriteLine(content);  
    }
    ```
  </Accordion>

  <Accordion title="How does the Browser API pricing work?">
    Browser API pricing is simple: you only pay for gigabytes of traffic that you transferred through the Browser API.

    There is no cost for instances or time using the Browser API - only traffic.

    Every account also gets 5,000 free credits per month. The Browser API draws from that pool at 5 credits per MB of traffic, so the full allowance covers 1,000 MB (nearly 1 GB) of Browser API traffic each month. See [Free tier](/general/account/billing-and-pricing/free-tier).

    It doesn't matter what country you are using, traffic is billed at the same rates. Because you pay by traffic, you probably will want to minimize it.

    The only exception to this is premium domains, which cost more per gigabyte, because Bright Data needs to invest a significantly higher amount of effort and resources to unblock. You can find more information about premium domains in your Browser API configuration pages.
  </Accordion>

  <Accordion title="How do I reduce data and bandwidth consumption with Browser API?">
    To reduce bandwidth usage and make your scraping more efficient, you can:

    * Block unnecessary resources such as images, stylesheets, and ads using request interception or CDP custom functions
    * Take advantage of browser caching
    * Follow best practices for request management

    For practical tips and code examples, see our [**Bandwidth Optimization Guide.**](/products/scraping-browser/code-examples#optimizing-bandwidth-usage-with-browser-api)<br />For instructions and code on blocking ads using CDP custom functions, see our custom **[Ad Blocker](/products/scraping-browser/cdp-functions/custom#ad-blocker).**
  </Accordion>

  <Accordion title="Is password typing allowed with Browser API?">
    Bright Data is committed to collecting only publicly available data. To uphold this commitment, Browser API is configured by default to prevent any attempts to log in to accounts by disabling password entry. This restriction helps ensure that no non-public data, including any data accessible only behind a login, is scraped. For your reference, please review our Acceptable Use Policy at [https://brightdata.com/acceptable-use-policy](https://brightdata.com/acceptable-use-policy) .

    In certain cases, it may be possible to override this default block. If you require an exception, you must first complete our Know-Your-Customer (KYC) process available at [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc). Once you have completed the process, please contact our compliance department directly at [compliance@brightdata.com](mailto:compliance@brightdata.com) to submit your request (you could also request the permissions during your KYC process).
  </Accordion>

  <Accordion title="How can I keep the same IP address in Browser API sessions?">
    The Browser API supports maintaining IP address across multiple browser sessions using a custom CDP function. This allows you to reuse the same proxy peer for consecutive requests by associating them with the same session ID.

    For implementation details and sample code, see our documentation on [Session Persistence](/products/scraping-browser/cdp-functions/custom#session-persistence)
  </Accordion>

  <Accordion title="What’s the difference between integrating a proxy with automation scripts and using the Browser API?">
    **1. Integrating a Proxy with Automation Scripts**

    * You set up proxies directly in your own scripts using tools like Puppeteer, Playwright, or Selenium.
    * You manage everything: browser setup, sessions, scaling, anti-bot challenges (CAPTCHAs, fingerprints, headers, etc.).
    * Offers full control and flexibility, but you’re responsible for maintaining and troubleshooting all aspects, including unblocking and scalability.

    **2. Using the Browser API**

    * You connect your automation scripts to a managed browser running in Bright Data’s cloud.
    * Bright Data handles infrastructure, scaling, anti-bot/unblocking (CAPTCHAs, fingerprints, etc.), and proxy rotation.
    * You focus only on your scraping logic. It’s easier to scale, especially for complex interactive sites.
    * Ideal if you want powerful scraping without the need to maintain or build your own anti-bot solutions.

    **Summary:** With direct proxy integration, you’re in control but manage all complexity. With Browser API, Bright Data takes care of the hardest parts and you only write your scraping workflow.

    For more details, see the [Browser API introduction](/products/scraping-browser/introduction).
  </Accordion>

  <Accordion title="How to make scraping faster with Browser API?">
    Browser API performance and optimization are managed on our side. We are always working to improve speed and reliability. There is no user-accessible setting to directly increase browser speed.

    Blocking unnecessary network requests (such as images, ads, and analytics) in your script can reduce data usage and may sometimes improve page load speed when using Browser API, but faster loading is not guaranteed. The main, reliable benefit is saving bandwidth.

    For more details and example code, see our [bandwidth-saving guide](/products/scraping-browser/code-examples#optimizing-bandwidth-usage-with-browser-api).
  </Accordion>

  <Accordion title="How do I know what type of proxies the Browser API is using?">
    By default, Browser API uses Residential proxies. For some domains that require KYC, it may automatically switch to Datacenter proxies if needed for compliance.

    Learn more about KYC and Residential proxy access [here](/products/residential/network-access).

    <Note>
      The linked page covers Residential proxy access and KYC requirements. Some details about SSL errors and other proxy types do not apply to Browser API.
    </Note>
  </Accordion>

  <Accordion title="How do I connect to Browser API with Playwright, Puppeteer, or Selenium?">
    To connect to the Browser API, you need your zone username and zone password.

    * For Playwright and Puppeteer, connect using a WebSocket (`wss://`) endpoint with the host `brd.superproxy.io` and port `9222`.
      * **Example connection URL:** `wss://${AUTH}@brd.superproxy.io:9222`
    * For Selenium, connect using an HTTPS endpoint with the host `brd.superproxy.io` and port `9515`.
      * **Example connection URL:** `https://${AUTH}@brd.superproxy.io:9515`

    See the [Configuration page](/products/scraping-browser/configuration) for code examples on how to connect with each library, using your zone username and password in the connection URL.

    <Warning>
      Do not add extra or custom connection options to your settings, as this can break the connection or degrade performance. Simply use the provided WebSocket or HTTPS endpoints with your zone credentials.
    </Warning>

    <Note>
      Currently, the only way to connect to Browser API is via WebSocket or HTTPS endpoints using your zone credentials (username and password). There is no REST API connection method at this time.
    </Note>
  </Accordion>

  <Accordion title="Proxy vs. Browser API, what’s the difference and which endpoint do I use?">
    * Regular Proxy Network: you launch your own browser/process and route traffic through `brd.superproxy.io:44445`, authenticating with `brd-customer-<CID>-zone-<ZONE>:<PASSWORD>` .
    * Browser API (formerly Scraping Browser): Bright Data spins up a managed, cloud Chrome for you. You **do not** start `puppeteer.launch()`. Instead, you attach to the remote browser:

    <CodeGroup>
      ```sh NodeJS, Puppeteer theme={null}
      const puppeteer = require('puppeteer-core');

      const AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD';      // found in Browser API Zone → Overview
      const WS  = `wss://${AUTH}@brd.superproxy.io:9222`; 

      (async () => {
        const browser = await puppeteer.connect({browserWSEndpoint: WS});
        const page = await browser.newPage();
        await page.goto('https://example.com', {timeout: 2*60*1000});
        console.log(await page.title());
        await browser.close();
      })(); 
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Can I navigate to multiple URLs in a single Browser API session?">
    Yes - Browser API sessions support unlimited navigations within the same domain. You can freely navigate between pages, click links, submit forms, scroll, and perform other interactive actions throughout the session, as long as all navigations remain on the same domain.

    To start a scraping job on a different domain, you need to begin a new session.
  </Accordion>
</AccordionGroup>


# Disable CAPTCHA solver
Source: https://docs.brightdata.com/products/scraping-browser/features/captcha-solver

By default, as part of our full proxy unblocking solution, Browser API also solves CAPTCHAs that are encountered while returning your proxy request.

When disabling CAPTCHA solver, our unlocker algorithm still takes care of the entire ever-changing flow of finding the best proxy network, customizing headers, fingerprinting, and more, but intentionally does not solve CAPTCHAs automatically, giving your team a lightweight, streamlined solution, that broadens the scope of your potential scraping opportunities.

Best for:

* Scraping data from websites without getting blocked
* Emulating real-user web behavior

<Accordion title="How can I get started?">
  To disable automated CAPTCHA solving, navigate to your Browser API zone and open the Configuration tab. Locate the CAPTCHA Solver setting in the main configuration area and switch the toggle off.
</Accordion>

<Note>
  If you would like to manually configure our default CAPTCHA solver through CDP commands on your own, see [custom CDP functions](/products/scraping-browser/cdp-functions/custom)
</Note>


# Browser API playground
Source: https://docs.brightdata.com/products/scraping-browser/features/playground

Use the Bright Data Browser API Playground to run example scripts, watch live browser sessions and inspect logs. Currently supports 1 driver: Puppeteer in JS.

The Playground is a code editor for experimenting with the Browser API. With this tool you can run ready-made example scripts or edit the scripts and run your own for testing purposes.
Playground Supported Libraries, Languages and Features

While Browser API supports all common libraries and languages, the current version of the playground can be used with Puppeteer and JavaScript. We promise to add the rest soon enough!

Please note that any features that involve a connection with the user side infrastructure will be supported in production but not in the playground, for example saving files to the user’s file system or using pre-installed libraries like Cheerio. To test Browser API with it’s full capabilities use your usual coding environment.

## Which playground features are available

* Code editor:
  * By default the code editor will be hosting an example scraper script
  * Script examples can be edited freely or including completely removing them and building any custom script from scratch to run with the Browser API
  * A reset button to revert back to the original example script
* Console logs view
* Web interaction and results view: presents the raw HTML going through the browser or visualizes the browser interactions.

<Frame>
  <img alt="playground-features.png" />
</Frame>

## Ready Made Example

Run existing example scripts to instantly see the product at work. The example scripts demo the scraping of real target sites. You will be able to see the full script, console logs and a visualization of the browser interaction with the target site.

## How to edit code in the playground

Use the code editor to edit the default example scripts or replace them altogether with your own and run any custom scripts to view results or debug your code.
If needed you can always click the reset button and revert back to the original example script.


# Browser API: premium domains
Source: https://docs.brightdata.com/products/scraping-browser/features/premium-domains

Enable Premium Domains on the Bright Data Browser API to unblock the hardest target sites, with pricing shown in your zone cost estimate before activation.

## Enable Premium Domains

When creating your Browser API zone, enable the 'Premium Domains' switch.

## Pricing

Once enabled, the premium price will be reflected in the "Estimated cost" section.

<Note>
  Even after enabled, only specific requests to these domains will be priced at the higher rate. Requests to other domains will be kept at the default lower tier.
</Note>

## Current List of Premium Domains

<Note>
  This list is frequently changing based on our website classification logic. You can see the most up-to-date list within your proxy zone.
</Note>

<div>Loading...</div>


# Browser API geolocation targeting
Source: https://docs.brightdata.com/products/scraping-browser/features/proxy-location

Geo-target the Bright Data Browser API to countries, states or cities across 195 countries. Automatic peer selection is on by default; manual overrides.

<Tip>
  Browser API automatically selects the optimal peer location for your sessions, reducing the need for manual configuration in **most** cases. Manual geo-targeting is useful when accessing region-restricted or location-specific data.
</Tip>

* [**Country**](/products/scraping-browser/features/proxy-location#how-to-target-a-country) - targets peers from a specific country
* [**Geolocation radius**](/products/scraping-browser/features/proxy-location#how-to-set-the-geolocation-radius) – targets peers using an exact latitude, longitude, and radius simulating a precise physical location for more granular geo-targeted data collection.

## How to target a country

Add the `-country` flag, after your `USER` credentials within the Bright Data endpoint, followed by the 2-letter ISO code for that country.

For example, Browser API using Puppeteer in the USA:

<CodeGroup>
  ```sh NodeJS, Puppeteer theme={null}
  const SBR_WS_ENDPOINT = `wss://${USERNAME}-country-us:${PASSWORD}@brd.superproxy.io:9222`;
  ```
</CodeGroup>

**EU region** You can target the entire European Union region in the same manner as "Country" above by adding "eu" after "country" in your request: "-country-eu".

Requests sent using -country-eu, will use IPs from one of the countries below which are included automatically within "eu": `AL, AZ, KG, BA, UZ, BI, XK, SM, DE, AT, CH, UK, GB,IE, IM, FR, ES, NL, IT, PT, BE, AD, MT, MC, MA, LU, TN, DZ, GI, LI, SE, DK, FI, NO, AX, IS, GG, JE, EU, GL, VA, FX, FO.`

## How to set the geolocation radius

Use the `Proxy.setLocation` function to dynamically change the location of your proxies using an exact latitude, longitude, and radius.

### Parameters

<ParamField type="float">
  Specifies the latitude of the desired proxy location.
</ParamField>

<ParamField type="float">
  Specifies the longitude of the desired proxy location.
</ParamField>

<ParamField type="number">
  The radius of the geolocation in kilometers. Defines the maximum distance from the provided latitude and longitude within which to search for available peers.
</ParamField>

<ParamField type="boolean">
  Defines the desired behavior in case no peers are available in the specified distance.

  `strict: true` - Bright Data will search for available peers only within the specific distance.

  `strict: false` - if no peers are available in the specified distance we will automatically expand the distance and look for the nearest available peers.
</ParamField>

### How to use proxy location targeting

The `Proxy.setLocation` command should be invoked before navigating to the site for which the proxy is intended. This ensures that the proxy location is set accurately according to the specified parameters before any data requests are made.

**How to run examples**

You need to get Browser API credentials in the control panel. Pass it in format `SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD` as environment variable `AUTH`

<CodeGroup>
  ```sh Shell theme={null}
  export AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```sh CMD theme={null}
  set AUTH=brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
  ```

  ```powershell Powershell theme={null}
  $Env:AUTH = 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>'
  ```
</CodeGroup>

<Tip>
  You can also pass `TARGET_URL` environment variable to change default targeted website.
</Tip>

### Code Examples

Change proxy location before scraping

<Tip>
  Select your preferred tech-stack
</Tip>

<CodeGroup>
  ```js NodeJS - Playwright theme={null}
  #!/usr/bin/env node
  const playwright = require('playwright');
  const {
      AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
      TARGET_URL = 'https://geo.brdtest.com/mygeo.json',
      LOCATION = 'amsterdam',
  } = process.env;

  const LOCATIONS = Object.freeze({
      amsterdam: { lat: 52.377956, lon: 4.897070 },
      london: { lat: 51.509865, lon: -0.118092 },
      new_york: { lat: 40.730610, lon: -73.935242 },
      paris: { lat: 48.864716, lon: 2.349014 },
  });

  async function scrape(url = TARGET_URL, location = LOCATION) {
      if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
          throw new Error(`Provide Browser API credentials in AUTH`
              + ` environment variable or update the script.`);
      }
      if (!LOCATIONS[location]) {
          throw new Error(`Unknown location`);
      }
      const { lat, lon } = LOCATIONS[location];
      console.log(`Connecting to Browser...`);
      const endpointURL = `wss://${AUTH}@brd.superproxy.io:9222`;
      const browser = await playwright.chromium.connectOverCDP(endpointURL);
      try {
          console.log(`Connected! Changing proxy location`
              + ` to ${location} (${lat}, ${lon})...`);
          const page = await browser.newPage();
          const client = await page.context().newCDPSession(page);
          await client.send('Proxy.setLocation', {
              lat, lon,
              distance: 50 /* kilometers */,
              strict: true,
          });
          console.log(`Navigating to ${url}...`);
          await page.goto(url, { timeout: 2 * 60 * 1000 });
          console.log(`Navigated! Scraping data...`);
          const data = await page.$eval('body', el => el.innerText);
          console.log(`Scraped! Data:`, JSON.parse(data));
      } finally {
          await browser.close();
      }
  }

  if (require.main == module) {
      scrape().catch(error => {
          console.error(error.stack || error.message || error);
          process.exit(1);
      });
  }
  ```

  ```js NodeJS - Puppeteer theme={null}
  #!/usr/bin/env node
  const puppeteer = require('puppeteer-core');
  const {
      AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
      TARGET_URL = 'https://geo.brdtest.com/mygeo.json',
      LOCATION = 'amsterdam',
  } = process.env;

  const LOCATIONS = Object.freeze({
      amsterdam: { lat: 52.377956, lon: 4.897070 },
      london: { lat: 51.509865, lon: -0.118092 },
      new_york: { lat: 40.730610, lon: -73.935242 },
      paris: { lat: 48.864716, lon: 2.349014 },
  });

  async function scrape(url = TARGET_URL, location = LOCATION) {
      if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
          throw new Error(`Provide Browser API credentials in AUTH`
              + ` environment variable or update the script.`);
      }
      if (!LOCATIONS[location]) {
          throw new Error(`Unknown location`);
      }
      const { lat, lon } = LOCATIONS[location];
      console.log(`Connecting to Browser...`);
      const browserWSEndpoint = `wss://${AUTH}@brd.superproxy.io:9222`;
      const browser = await puppeteer.connect({ browserWSEndpoint });
      try {
          console.log(`Connected! Changing proxy location`
              + ` to ${location} (${lat}, ${lon})...`);
          const page = await browser.newPage();
          const client = await page.createCDPSession();
          await client.send('Proxy.setLocation', {
              lat, lon,
              distance: 50 /* kilometers */,
              strict: true,
          });
          console.log(`Navigating to ${url}...`);
          await page.goto(url, { timeout: 2 * 60 * 1000 });
          console.log(`Navigated! Scraping data...`);
          const data = await page.$eval('body', el => el.innerText);
          console.log(`Scraped! Data:`, JSON.parse(data));
      } finally {
          await browser.close();
      }
  }

  function getErrorDetails(error) {
      if (error.target?._req?.res) {
          const {
              statusCode,
              statusMessage,
          } = error.target._req.res;
          return `Unexpected Server Status ${statusCode}: ${statusMessage}`;
      }
  }

  if (require.main == module) {
      scrape().catch(error => {
          console.error(getErrorDetails(error)
              || error.stack
              || error.message
              || error);
          process.exit(1);
      });
  }
  ```

  ```js NodeJS - Selenium theme={null}
  #!/usr/bin/env node
  const { Builder, Browser, By } = require('selenium-webdriver');
  const {
      AUTH = 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD',
      TARGET_URL = 'https://geo.brdtest.com/mygeo.json',
      LOCATION = 'amsterdam',
  } = process.env;

  const LOCATIONS = Object.freeze({
      amsterdam: { lat: 52.377956, lon: 4.897070 },
      london: { lat: 51.509865, lon: -0.118092 },
      new_york: { lat: 40.730610, lon: -73.935242 },
      paris: { lat: 48.864716, lon: 2.349014 },
  });

  async function scrape(url = TARGET_URL, location = LOCATION) {
      if (AUTH == 'SBR_ZONE_FULL_USERNAME:SBR_ZONE_PASSWORD') {
          throw new Error(`Provide Browser API credentials in AUTH`
              + ` environment variable or update the script.`);
      }
      if (!LOCATIONS[location]) {
          throw new Error(`Unknown location`);
      }
      const { lat, lon } = LOCATIONS[location];
      console.log(`Connecting to Browser...`);
      const server = `https://${AUTH}@brd.superproxy.io:9515`;
      const driver = await new Builder()
          .forBrowser(Browser.CHROME)
          .usingServer(server)
          .build();
      try {
          console.log(`Connected! Changing proxy location`
              + ` to ${location} (${lat}, ${lon})...`);
          await driver.sendAndGetDevToolsCommand('Proxy.setLocation', {
              lat, lon,
              distance: 50 /* kilometers */,
              strict: true,
          });
          console.log(`Navigating to ${url}...`);
          await driver.get(url);
          console.log(`Navigated! Scraping data...`);
          const body = await driver.findElement(By.css('body'));
          const data = await body.getText();
          console.log(`Scraped! Data:`, JSON.parse(data));
      } finally {
          await driver.quit();
      }
  }

  if (require.main == module) {
      scrape().catch(error => {
          console.error(error.stack || error.message || error);
          process.exit(1);
      });
  }
  ```
</CodeGroup>

## How to get proxy geolocation

Use this command to retrieve the exact geo-location information of the proxy peer assigned to your current browser session. This is useful for logging and verifying the assigned peer's location on your end.

### Proxy geolocation CDP command

* `Proxy.getGeolocation`

<Note>
  Use the CDP command after navigation to the target page.
</Note>

```js Example (Puppeteer) theme={null}
const page = await browser.newPage();
const client = await page.createCDPSession();
await page.goto('https://example.com');
const geolocation = await client.send('Proxy.getGeolocation');
console.log('Proxy Geolocation:', geolocation);
```

```json Returns theme={null}
{
  "result": {
    "ip_version": 4,
    "country": "us",
    "asn": {
      "asnum": 7018,
      "org_name": "AT&T Enterprises, LLC"
    },
    "geo": {
      "city": "Rogers",
      "city_slug": "rogers",
      "region": "ar",
      "region_slug": "ar",
      "region_name": "Arkansas",
      "postal_code": "72758",
      "latitude": 36.3174,
      "longitude": -94.1548,
      "tz": "America/Chicago"
    }
  }
}
```


# Browser API troubleshooting
Source: https://docs.brightdata.com/products/scraping-browser/features/troubleshooting

Get troubleshooting tips for the Bright Data Browser API. Use the debugger to analyze and optimize web scraping with Chrome Dev Tools.

## Browser API Debugger

Web scraping projects often require intricate interactions with target websites and debugging is vital for identifying and resolving issues found during the development process. The Browser API Debugger serves as a valuable resource, enabling you to inspect, analyze, and fine-tune your code alongside Chrome Dev Tools, resulting in better control, visibility, and efficiency.

### Where to find it

Our Browser API Debugger can be launched via two methods:

1. Manually via Control Panel
2. Remotely via your script

Choose your preferred method below to see more:

<Tabs>
  <Tab title="Manually via Control Panel">
    The Browser API Debugger can be easily accessed within your Bright Data Control Panel. Follow these steps:

    1. Within the control panel, go to [Web Access](https://brightdata.com/cp/web_access/) view
    2. Click on your specific Browser API
    3. Click on the **Overview** tab
    4. On the right side, Click on the "Chrome Dev Tools Debugger" button seen below: <img alt="Where to find it" />

    ### Getting Started with the Debugger & Chrome Dev Tools

    <Steps>
      <Step title="Open a Browser API Session">
        * Ensure you have an active Browser API session
        * If you don't yet know how to launch a Browser API session, see our Quick Start guide.
      </Step>

      <Step title="Launch the Debugger">
        * Once your session is up and running you can now launch the Debugger.
        * Click on the Debugger button within your 'Overview' tab to launch the Browser API Debugger interface (see the screenshot above )
      </Step>

      <Step title="Connect with your live browser sessions">
        * Within the Debugger interface, you will find a list of your live Browser API sessions.
        * Select the preferred session that you wish to debug
        * Click on the session link or copy/paste it into your browser of choice, and this will establish a connection between the Debugger and your selected session.

        <Frame>
          <img alt="Where to find it" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Remotely via your script">
    To access and launch the debugger session directly from your script, you'll need to send the CDP command: `Page.inspect`.

    See the following examples:

    <CodeGroup>
      ```js NodeJS theme={null}
      // Puppeteer - Inspect page using devtools
      const page = await browser.newPage();
      const client = await page.target().createCDPSession();
      const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});
      const {url: inspectUrl} = await client.send('Page.inspect', {
          frameId: frame.id,
      });
      console.log(`Inspect session at ${inspectUrl}`);

      // Playwright - Inspect page using devtools
      const page = await browser.newPage();
      const client = await page.context().newCDPSession(page);
      const {frameTree: {frame}} = await client.send('Page.getFrameTree', {});
      const {url: inspectUrl} = await client.send('Page.inspect', {
          frameId: frame.id,
      });
      console.log(`Inspect session at ${inspectUrl}`);
      ```

      ```python Python theme={null}
      # Playwright - Inspect page using devtools
      page = await browser.new_page()
      client = await page.context.new_cdp_session(page)
      frame_tree = await client.send('Page.getFrameTree', {})
      frame_id = frame_tree['frameTree']['frame']['id']
      inspect = await client.send('Page.inspect', {'frameId': frame_id})
      inspect_url = inspect['url']
      print('Inspect session at', inspect_url)
      ```

      ```cs C# theme={null}
      // PuppeteerSharp - Inspect page using devtools
      var page = await browser.NewPageAsync();
      var client = await page.Target.CreateCDPSessionAsync();
      var frameTree = await client.SendAsync("Page.getFrameTree");
      var frameId = frameTree!["frameTree"]!["frame"]!["id"]!;
      var inspect = await client.SendAsync("Page.inspect", new { frameId = frameId });
      var inspectUrl = inspect["url"]!;
      Console.WriteLine($"Inspect session at {inspectUrl}");

      // Playwright - Inspect page using devtools
      var page = await browser.NewPageAsync();
      var client = await page.Context.NewCDPSessionAsync(page);
      var frameTree = await client.SendAsync("Page.getFrameTree");
      var frameId = frameTree.Value
          .GetProperty("frameTree")
          .GetProperty("frame")
          .GetProperty("id")
          .GetString()!;
      var inspect = await client.SendAsync("Page.inspect", new ()
      {
          { "frameId", frameId },
      });
      var inspectUrl = inspect.Value
          .GetProperty("url")
          .GetString()!;
      Console.WriteLine($"Inspect session at {inspectUrl}");
      ```
    </CodeGroup>
  </Tab>
</Tabs>

### Leveraging Chrome Dev Tools

* With the Browser API Debugger now connected to your live session, you gain access to the powerful features of Chrome Dev Tools.
* Utilize the Dev Tools interface to inspect HTML elements, analyze network requests, debug JavaScript code, and monitor performance. Leverage breakpoints, console logging, and other debugging techniques to identify and resolve issues within your code.

<Frame>
  <img alt="test-sites.png" />
</Frame>

### Automatically opening devtools locally to view your live browser session

If you would like to automatically launch devtools on every session to view your live browser session, you can integrate the following code snippet:

```js NodeJS - Puppeteer theme={null}
// Launch devtools locally

const { exec } = require('child_process');
const chromeExecutable = 'google-chrome';

const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
const openDevtools = async (page, client) => {
    // get current frameId
    const frameId = page.mainFrame()._id;
    // get URL for devtools from Browser API
    const { url: inspectUrl } = await client.send('Page.inspect', { frameId });
    // open devtools URL in local chrome
    exec(`"${chromeExecutable}" "${inspectUrl}"`, error => {
        if (error)
            throw new Error('Unable to open devtools: ' + error);
    });
    // wait for devtools ui to load
    await delay(5000);
};

const page = await browser.newPage();
const client = await page.target().createCDPSession();
await openDevtools(page, client);
await page.goto('http://example.com');
```

### How to use the debugger

Check out the Browser API Debugger in action below

<Frame>
  <iframe title="Debugger Walkthrough" />
</Frame>

## Error codes

Review the [full list of Browser API error codes](/products/scraping-browser/error-codes), including each code's meaning and a suggested action.

## FAQs

Check out our [frequently asked questions](/products/scraping-browser/faqs) regarding Browser API

## How To

Find out more about the [common library navigational functions](/products/scraping-browser/code-examples) and examples for browser automation and specifically for Browser API


# Run your first browser session
Source: https://docs.brightdata.com/products/scraping-browser/five-minute-how-to

Launch your first Bright Data Browser API session in under 5 minutes with JavaScript rendering, page interaction and dynamic content, no infrastructure.

This guide helps you launch your **first real browser session in under 5 minutes** using the Bright Data Browser API.<br />It is designed for developers who need **JavaScript rendering, page interaction, or dynamic content**, without managing browsers or infrastructure.

By the end of this guide, you will:

* Verify your Browser API setup
* Launch a live browser session
* Load a website that requires JavaScript rendering

## What you need before starting (1 minute)

Before you begin, make sure you have:

* A Bright Data account
* An active **Browser API zone**
* A valid **Browser API zone** \*\*credentials \*\*(Username and Password)

You can find your **credentials** in the **Overview** tab of your Browser API in the Bright Data Control Panel.

If you haven’t created a Browser API yet, follow **Create Your First Browser API** before continuing.

## Step 1: Choose a JavaScript-based website (30 seconds)

Select a website that requires JavaScript rendering.

Good examples:

* [https://quotes.toscrape.com/js/](https://quotes.toscrape.com/js/)
* [https://www.nike.com](https://www.nike.com)
* [https://www.amazon.com](https://www.amazon.com)

Make sure the URL:

* Starts with `https://`
* Requires client-side rendering or user-like interaction

## Step 2: Understand how the Browser API works (30 seconds)

The Browser API launches a **real, cloud-based browser session** on your behalf.

With each session, Bright Data:

* Launches a browser instance
* Applies realistic fingerprints and headers
* Handles proxy routing and anti-bot challenges
* Returns rendered page content or session output

You do not need to manage browsers, drivers, or automation infrastructure.

## Step 3: Start your first Browser API session (2 minutes)

Replace the placeholders below with your actual values:

* USER:PASS
* YOUR\_TARGET\_URL

Copy one of the example code snippets below and paste it into your IDE of choice.<br />Simply run the code after replacing the parameters to start your session!

<Tabs>
  <Tab title="NodeJS">
    <CodeGroup>
      ```javascript Puppeteer theme={null}
      #!/usr/bin/env node
      const puppeteer = require('puppeteer-core');

      const AUTH = 'USER:PASS';
      const TARGET_URL = 'YOUR_TARGET_URL';

      async function main() {
          console.log('Connecting to Browser...');
          const browser = await puppeteer.connect({
              browserWSEndpoint: `wss://${AUTH}@brd.superproxy.io:9222`
          });

          const page = await browser.newPage();

          // Get debugging URL
          const client = await page.createCDPSession();
          const { frameTree: { frame } } = await client.send('Page.getFrameTree');
          const { url: inspectUrl } = await client.send('Page.inspect', {
              frameId: frame.id
          });
          console.log(`You can inspect this session at: ${inspectUrl}`);

          // Navigate to target
          await page.goto(TARGET_URL);

      	console.log(await page.content());
          await page.screenshot({ path: 'screenshot.png', fullPage: true });
          console.log('Navigation complete!');

          await browser.close();
      }

      main().catch(console.error);
      ```

      ```javascript Playwright theme={null}
      #!/usr/bin/env node
      const playwright = require('playwright');

      const AUTH = 'USER:PASS';
      const TARGET_URL = 'YOUR_TARGET_URL';

      async function main() {
          console.log('Connecting to Browser...');
          const browser = await playwright.chromium.connectOverCDP(
              `wss://${AUTH}@brd.superproxy.io:9222`
          );

          const page = await browser.newPage();

          // Get debugging URL
          const client = await page.context().newCDPSession(page);
          const { frameTree: { frame } } = await client.send('Page.getFrameTree');
              const { url: inspectUrl } = await client.send('Page.inspect', {
                  frameId: frame.id,
              });
          console.log(`You can inspect this session at: ${inspectUrl}.`);

          // Navigate to target
          await page.goto(TARGET_URL);

      	console.log(await page.content());
          await page.screenshot({ path: 'screenshot.png', fullPage: true });
          console.log('Navigation complete!');
          
          await browser.close();
      }

      main().catch(console.error);
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Python">
    <CodeGroup>
      ```python Playwright theme={null}
      #!/usr/bin/env python3
      import asyncio
      from playwright.async_api import async_playwright

      AUTH = 'USER:PASS'
      TARGET_URL = 'YOUR_TARGET_URL'

      async def main():
          print('Connecting to Browser...')
          
          async with async_playwright() as p:
              browser = await p.chromium.connect_over_cdp(
                  f'wss://{AUTH}@brd.superproxy.io:9222'
              )
              page = await browser.new_page()
              
              # Get debugging URL
              client = await page.context.new_cdp_session(page)
              frame_tree = await client.send('Page.getFrameTree')
              frame_id = frame_tree['frameTree']['frame']['id']
              inspect_result = await client.send('Page.inspect', {'frameId': frame_id})
              print(f"Debug URL: {inspect_result['url']}")
              
              # Navigate to target
              await page.goto(TARGET_URL)

              print(await page.content())
              await page.screenshot(path='screenshot.png', full_page=True)
              print('Navigation complete!')
              
              await browser.close()

      if __name__ == '__main__':
          try:
              asyncio.run(main())
          except Exception as e:
              print(f'Error: {e}')
      ```

      ```python Selenium theme={null}
      #!/usr/bin/env python3
      from selenium.webdriver import Remote, ChromeOptions as Options
      from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection as Connection

      AUTH = 'USER:PASS'
      TARGET_URL = 'YOUR_TARGET_URL'

      def main():
          print('Connecting to Browser...')
          
          server_addr = f'https://{AUTH}@brd.superproxy.io:9515'
          connection = Connection(server_addr, 'goog', 'chrome')
          driver = Remote(connection, options=Options())
          
          def cdp(cmd, params={}):
              return driver.execute('executeCdpCommand', {
                  'cmd': cmd,
                  'params': params,
              })['value']
          
          try:
              # Get debugging URL
              frame_tree = cdp('Page.getFrameTree')
              frame_id = frame_tree['frameTree']['frame']['id']
              inspect_result = cdp('Page.inspect', {'frameId': frame_id})
              print(f"Debug URL: {inspect_result['url']}")
              
              # Navigate to target
              driver.get(TARGET_URL)

              print(driver.page_source)
              driver.save_screenshot('screenshot.png')
              print('Navigation complete!')
          finally:
              driver.quit()

      if __name__ == '__main__':
          try:
              main()
          except Exception as e:
              print(f'Error: {e}')
      ```
    </CodeGroup>
  </Tab>
</Tabs>

This code:

* Connects to a remote browser session
* Prints the live session URL
* Fully renders the page using JavaScript
* Prints the HTML content of the page
* Takes a screenshot of the rendered page
* Closes the browser session

## Step 4: Review the response (30 seconds)

If successful, you will receive:

* Fully rendered HTML content + screenshot
* JavaScript-generated elements included

If the page content matches what you see in a real browser, your Browser API setup is working correctly.

## Common issues and quick fixes (30 seconds)

* **407 Auth Failed:** Authentication is missing or invalid<br />→ Verify the Username and Password credentials
* **Invalid URL:** The desired URL is in incorrect format<br />→ Confirm the TARGET\_URL parameter was changed to a valid URL

## What you just accomplished

In under 5 minutes, you:

* Connected to a remote headless browser session
* Loaded a JavaScript-heavy website
* Retrieved rendered content

Your Browser API is now ready for advanced workflows.

## Where to go next

Once your first session works, you can:

* Interact with pages (clicks, scrolling, inputs)
* Run multi-step browser workflows
* Review **Browser API Configuration** for advanced controls
* Check **Troubleshooting** if you encounter issues


# Introduction to Bright Data’s Browser API
Source: https://docs.brightdata.com/products/scraping-browser/introduction

Learn how Bright Data's Browser API enables large-scale browser-based data collection with automation, proxy management and built-in unblocking.

## Overview

Bright Data’s **Browser API** is designed for **browser-based data collection workflows** that require full page rendering, user-like interactions, and advanced unblocking capabilities.

As part of Bright Data’s **Unlocker Scraping Suite**, the Browser API allows you to run your scraping logic directly on **fully managed cloud browsers**, eliminating the need to maintain your own browser infrastructure, proxy networks, or anti-bot handling logic.

Instead of running browsers locally or managing complex proxy configurations, your code executes on Bright Data’s dedicated browser environment, automatically optimized to bypass modern anti-bot systems at scale.

## How the Browser API works

With the Browser API, your scraping scripts run inside **real, hosted browsers** that are pre-configured for high success rates and stability.

Behind the scenes, Bright Data handles:

* Automatic proxy rotation across multiple networks, including residential IPs
* Browser fingerprint management to emulate real-user behavior
* Custom headers and session handling
* CAPTCHA detection and solving
* Intelligent retries and session recovery

This allows you to focus entirely on **writing scraping logic**, while Bright Data manages the full browser execution and unblocking lifecycle.

## Supported browser automation frameworks

The Browser API integrates seamlessly with standard browser automation tools, including:

* **Puppeteer**
* **Playwright**
* **Selenium**

These integrations allow you to reuse existing scripts and tooling while instantly gaining access to scalable, production-ready browser infrastructure.

> See the full list of supported integrations in our [Integrations documentation](/integrations/introduction).

## Why use the Browser API

The Browser API is ideal when static HTTP requests are not enough and full browser interaction is required.

Use the Browser API when you need to:

* Navigate multi-step user flows
* Fill out forms and submit inputs
* Click buttons, links, and menus
* Scroll and load dynamically rendered content
* Interact with JavaScript-heavy websites
* Bypass advanced bot detection and CAPTCHAs

## Best suited for

The Browser API is best suited for:

* Websites that rely heavily on JavaScript rendering
* Complex workflows requiring real-user interactions
* Large-scale browser automation with unpredictable anti-bot behavior
* Teams without a scalable in-house browser and proxy infrastructure
* Teams that need built-in CAPTCHA solving without integrating or maintaining a separate solver
* Use cases requiring **unlimited concurrent browser sessions**

## How to get started

To get started with the Browser API, follow the **Quick Start** guide to create your Browser API zone and run your first automated browser session in minutes.


# Create your first Browser API
Source: https://docs.brightdata.com/products/scraping-browser/quickstart

Set up your first Bright Data Browser API in the Control Panel in 5 steps, configure access credentials and run your first headless browser scraping job.

> Get started with Bright Data’s [Browser API](https://brightdata.com/products/scraping-browser) in just a few steps. This guide walks you through creating your Browser API zone so you can begin running browser-based scraping jobs right away.

<Callout icon="badge-dollar">
  **Start free, no credit card required**

  Your account gets **5,000 free credits every month**, drawn from a single shared pool across the eligible products. The Browser API spends 5 credits per MB of traffic, so the full allowance covers 1,000 MB (nearly 1 GB) of Browser API traffic. Create your Browser API zone and start running browser sessions immediately, no payment method needed. [Learn more about the free tier](/general/account/billing-and-pricing/free-tier).
</Callout>

## What you’ll accomplish in this guide

By the end of this quick start, you will:

* Create your first **Browser API zone**
* Prepare your account for browser-based scraping
* Be ready to run automated browser sessions using Puppeteer, Playwright, or Selenium

No local browser setup or proxy configuration is required.

## How to set up step by step

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>}>
    Log in to your Bright Data account using your credentials. If you don’t have an account yet, you’ll be prompted to create one before proceeding.
  </Step>

  <Step title={<>Navigate to the <a href="https://brightdata.com/cp/web_access/new">Create an API</a> page</>}>
    From the Bright Data Control Panel:

    **1.** Open the left-hand navigation menu<br />**2.** Select **Web Access**<br />**3.** Click **Create API** to begin setting up a new API zone

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Choose Browser API">
    On the API selection screen, choose **Browser API**. This option enables full browser automation with built-in proxy management, fingerprinting, CAPTCHA handling, and unblocking logic.

    Click **Continue** to proceed.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Assign a name to your Browser API">
    Enter a **clear and descriptive name** for your Browser API zone. This helps you identify the zone later, especially if you manage multiple APIs.

    You may also add an optional description for internal reference.

    <Warning>
      **The Browser API name cannot be changed once created.** You can modify all other settings later.

      For details, see [your Browser API Configuration](https://brightdata.com/cp/web_access).
    </Warning>

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Finalize API creation">
    Review your configuration and click **Add API**. Your Browser API zone is now created and immediately available for use.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>
</Steps>

## What’s next?

Once your Browser API is created, you can:

* Retrieve your **connection details** from the Overview tab
* Connect using **Puppeteer**, **Playwright**, or **Selenium**
* Start running automated browser sessions at scale

Continue to **Send Your First Browser Request** to launch your first browser session and verify everything is working correctly.

> To find navigation and other pages in this documentation, fetch the llms.txt file at: [https://docs.brightdata.com/llms.txt](https://docs.brightdata.com/llms.txt)


# SERP API async requests
Source: https://docs.brightdata.com/products/serp-api/asynchronous-requests

Send async Bright Data SERP API (31 languages) and Web Unlocker API requests: compare with sync mode, learn when async is faster and configure async parameters.

<Note>
  Async is supported by both **Web Unlocker API** and **SERP API** products
</Note>

## Async VS Sync requests

There are 2 ways for us to handle your Web Unlocker API and SERP API requests:

* `default` **Synchronous requests** - Send a request and get a real-time response immediately
* **Asynchronous requests** - Send a request (without waiting for an immediate response) and retrieve the results later via our designated API endpoint. Callback times are usually up to 5 minutes but may take up to 8 hours during peak periods. Responses are stored for up to 48 hours from the time the request was sent.

<Tip>
  Async is recommended for those with high-volume requests who **don't** need to serve an immediate or live response and can wait a few minutes to retrieve all their responses at once.
</Tip>

### Why should I use Async?

* 99.99% success rate
* Stability
* Flexibility - the ability to retrieve your requests at a later time of your choosing (and not have to wait for the response immediately after sending the request)

### How it works

Sending requests and receiving responses with Async mode is a two-step flow:

* **Sending the request** - This request includes the search parameters, returns a `response_ID`, and is a direct request (i.e. you will be billed for this request).
* **Collecting the response** - This request includes the `response_ID` and is free of charge (i.e. you will not be billed for this request). If you call for a `response_ID` which is still being processed you will receive a 202 status code.

<Note>
  We store responses for up to 48 hours from the time the request was sent.
</Note>

### How to get started

<Steps>
  <Step title="Enable &#x22;Asynchronous requests&#x22;">
    Within your specific Web Unlocker API or SERP API [zone](https://brightdata.com/cp/zones), under "Advanced settings", enable the "Asynchronous requests" toggle. <img alt="Asynchronous requests toggle in the zone advanced settings" />
  </Step>

  <Step title="[Optional] Setting up a webhook (POST or GET)">
    This is where you will get notified on the status of your future requests

    <Note>
      A webhook can also be set **per** request (see "Initial request parameters" below)
    </Note>
  </Step>

  <Step title="Sending an async request">
    The request syntax is slightly different from that of synchronous requests and requires an [API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F) for authentication. See a basic example below (for more request parameters see below):

    ```sh theme={null}
    curl -i --silent --compressed "https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]" \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer [API_KEY]" \
      -d '{"country":"us","query":{"q":"pizza","num":"100","hl":"en","gl":"au"}}'
    ```

    You'll receive a response to the above that contains an `x-response-id` header with the ID of your request. This is the `RESPONSE_ID` for this request which you will use when collecting your results in the next step.

    <Note>
      You can easily save the `RESPONSE_ID` in your script by initializing it along with your request like this:

      ```js theme={null}
      RESPONSE_ID=$(
      	curl -i --silent --compressed "[https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]](https://api.brightdata.com/unblocker/req?customer=%5BACCOUNT_ID%5D&zone=%5BZONE_NAME%5D)" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY" -d '{"country":"us","query":{"q":"pizza","num":"100","hl":"en","gl":"au"}}' | sed -En 's/^x-response-id: (.*)/\1/p' | tr -d '\r'
      )
      ```
    </Note>
  </Step>

  <Step title="Webhook notification">
    If you've set up a webhook, you'll receive a notification immediately when the requests are ready with the following parameters: `status`, `response_id`, `request_url` and `hook_data` (optional - if you've used the `webhook_data` parameter in your request).

    <Tip>
      ### Allowlist our webhook IPs

      Our asynchronous webhooks delivery sends notifications from a pair of stable IP addresses, so please make sure to allowlist them:

      1. `100.27.150.189`
      2. `18.214.10.85`
    </Tip>
  </Step>

  <Step title="Collecting your results">
    We recommend to wait 20 seconds prior to the first poling request to get the response, 10 seconds for the second pole and 5 for the rest.

    Bright Data may apply rate limit for excessive poling requests without response.

    To get the response, use the `RESPONSE_ID` received in step 3, send the following:

    ```sh theme={null}
    curl -i --silent --compressed "https://api.brightdata.com/unblocker/get_result?customer=[ACCOUNT_ID]&zone=[zone_name]&response_id=${[RESPONSE_ID]}" \
       -H "Authorization: Bearer [API_KEY]"
    ```
  </Step>
</Steps>

## API - Request creation - `POST /{unblocker|serp}/req`

```sh Example theme={null}
curl -i --silent --compressed "https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [API_KEY]" \
  -d '{"url":"https://example.com?foo=bar","country":"us"}'
```

### Parameters

<Warning>
  (\*) mandatory parameter
</Warning>

| Parameter | Type | Description |
| - | - | - |
| url (\*) | String | Defines the url of the request |
| method | String | Defines the HTTP method of the request |
| headers | Object | Defines headers to be used in the request |
| body | String or Object | Defines body to be sent with request. If an object is specified, it is serialized to JSON, and Content-Type header is set to application/json. |
| country | String | Defines country to be used for request (2-letters code) |
| webhook\_url | String | Defines the URL to which the job status notification will be sent. If you don't want to setup a default webhook (above) or prefer the URL to be different per request, use this. |
| webhook\_method | String | Defines the HTTP method to use with the webhook\_url (GET or POST) |
| webhook\_data | Any | Defines the data that will be sent with job status notification |

### Which SERP-specific parameters to use

| Parameter | Type | Description |
| - | - | - |
| query (\*) | Object | |
| brd\_json | 1 or "html" | Defines the response format |

```sh SERP Example theme={null}
curl -i --silent --compressed "https://api.brightdata.com/unblocker/req?customer=[ACCOUNT_ID]&zone=[zone_name]" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer [API_KEY]" \
  -d '{"country":"us","query":{"q":"pizza","num":"100","hl":"en","gl":"au"},"brd_json":"1"}'
```

## API - Response collection - `GET /{unblocker|serp}/get_result`

Note: `response_id` comes from the `x-response-id` header of the request creation response

```sh Example theme={null}
curl -k -v --compressed "https://api.brightdata.com/unblocker/get_result?customer={ACCOUNT_ID&zone={ASYNC_ZONE}&response_id={response_id}" \
  -H "Authorization: Bearer {API_Key}" \
  -o {Your_result_ouput_file}
```

### Parameters

<Warning>
  (\*) mandatory parameter
</Warning>

| Parameter | Description |
| - | - |
| response\_id (\*) | Defines the job id. Received in the response headers of your initial async request. |


# SERP API configuration
Source: https://docs.brightdata.com/products/serp-api/configuration

Configure the Bright Data SERP API: choose JSON or raw HTML format, switch sync and async modes and enrich ad data with key request parameters.

## Default response format

When you configure your SERP API you can select between different default response formats:

1. Raw HTML: no parsing at all. Get the HTML response as is.
2. Full JSON: our full interpretation of Google's SERP HTML to JSON.
3. Light JSON: a subset of full JSON
4. Parsed Bing: our full interpretation of Bing's SERP HTML to JSON.
5. Markdown: our full interpretation of Google's and Bing's SERP HTML to markdown `*.md` file.
6. Screenshot: an image capture of the SERP HTML page as interpreted by a browser.

To read more on our response options and advanced response formats see: [Parsed JSON results](/products/serp-api/parsed-json-results)

## Google Ads

Bright Data provides a special setting which brings more Google ads data. In your SERP API zone's Configuration tab, the **Google Ads** section offers two options:

1. **Standard** (default): fetches both organic search results and ads, encompassing a broad geographical scope.
2. **Maximized**: fetches an even greater variety of ads search results and ads, mimicking an incognito browsing scenario without cookies.

## How to configure advanced settings

### Custom Headers and Cookies

Bright Data enables you to send your custom headers and cookies. Once you do so, we will not override your settings and will relay your requests to the search engine. You can choose from a pre-approved list of headers and cookies or request a new one and go through an approval process.

Once custom headers and cookies are selected, Bright Data will charge you for **all** requests. When using the default setting without customized cookies, Bright Data charges for successful requests only.

### How to send asynchronous requests

You can work with Bright Data APIs using an asynchronous mode, where the request is sent immediately, and you will be notified when the response is ready. It usually takes a few minutes for the response to be posted back. For non real-time applications we recommend Async mode to assure a higher success rate.

When submitting an asynchronous request, Bright Data handles it in the background. You can either poll for the response or configure a webhook where we will notify you on request completion. This allows you to collect responses at a later, more convenient time via a designated endpoint, increasing stability and efficiency. [Learn more](/products/serp-api/asynchronous-requests)

#### Webhook Configuration

Webhook has two configurable options:

1. Webhook address URL
2. Webhook method (GET/POST)

On your network you should add our webhook agent origin IPs.

<Tip>
  ### Allowlist our webhook IPs

  Our asynchronous webhook delivery sends notifications from a pair of stable IP addresses:

  1. `100.27.150.189`
  2. `18.214.10.85`

  Customers may need to allowlist these IPs on their side.
</Tip>


# SERP troubleshooting
Source: https://docs.brightdata.com/products/serp-api/debugging

Troubleshoot Bright Data SERP API (31 languages) requests using the x-brd-debug response header to capture detailed request and response diagnostics.

## Debugging SERP API

Use the `x-brd-debug` response header to extract detailed debug information about your requests.

Activate by appending `-debug-full` to your proxy username:

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE-debug-full:$PASSWORD@brd.superproxy.io:44445 \
  "https://www.google.com/search?q=bright+data"
```

The `x-brd-debug` response header will look like this:

```javascript theme={null}
req_id=hl_d09913c7_a1lw123bkcg; bytes_up=2842; bytes_down=562418; billed=false; destination_ip=162.219.225.118; used_req_headers=accept-language,accept; peer_ip=r868133f79d0c3fa9d7c7ccca0151af2e; peer_country=us; render=false
```

| Field | Description |
| - | - |
| `req_id` | Internal request ID - include in bug reports |
| `bytes_up` | Outgoing traffic recorded while processing the request |
| `bytes_down` | Incoming traffic recorded while processing the request |
| `billed` | Whether the request is considered billable |
| `destination_ip` | IP of the remote server used to fetch the data |
| `used_req_headers` | Custom headers relayed in the initial request |
| `peer_ip` | Unique identifier for the IP used - useful for validating IP rotation |
| `peer_country` | Country of the peer used for the request |
| `render` | Whether the result is browser-rendered HTML or a raw HTTP response |

## Common Error Codes

| Error | Description |
| - | - |
| `404` | Invalid URL - likely broken or dead |
| `403` | URL is valid but access is forbidden |
| `502` | Most common SERP API error - see detail in `x-brd-error-code` |
| `407` | Incorrect credentials (password or zone name) |
| `429` | Rate limit / auto-throttle - contact support |
| `401` `411` `444` | Bad request - missing headers or cookies |
| `503` | Service unavailable - browser check failed |

```http Example 429 response theme={null}
HTTP/1.1 429 The request was auto-throttled due to low success rate
x-brd-error-code: sr_rate_limit
x-brd-error: The request was auto-throttled due to low success rate
date: Tue, 23 Jan 2024 17:07:19 GMT
connection: keep-alive
```

## SERP API error catalog

Fast SERP runs inside the SERP API and shares its error codes. When a request fails, the error code is returned in the `x-brd-error-code` response header and a human-readable message in `x-brd-error`, as shown in the examples below. None of the errors in this catalog are billed.

### HTTP Error 502

A 502 means the request failed due to an issue on Bright Data's side. Read the error code to tell them apart.

| `x-brd-error-code` | `x-brd-error` | Description |
| - | - | - |
| `unexpected_q` | Search query mismatch | Google returned results for a different query than the effective query Bright Data sent to Google (query truncation/cloaking). By default the request fails with this error instead of returning mismatched data. To receive the data anyway, see [Handling query mismatches](#handling-query-mismatches-unexpected_q). |
| `verifying` | challenge page detected | The request reached the search engine, but it returned a verification page instead of results. The page cannot be solved or skipped, so the request fails and is not billed. Wait a minimum of 15 seconds before retrying the same query. |

```http Example query mismatch response theme={null}
x-brd-error-code: unexpected_q
x-brd-error: Search query mismatch
```

### HTTP Error 429

A 429 means a rate limit was reached. Read the error code to tell them apart.

| `x-brd-error-code` | `x-brd-error` | Description |
| - | - | - |
| `sr_rate_limit` | The request was auto-throttled due to low success rate. Please decrease your request rate to %LIMIT%/min. | Applied per target host. The limit is calculated dynamically from the success rate observed for that host, so it changes over time. Decrease your request rate and concurrency for that host to the rate given in the message. Retrying immediately fails, retrying only helps after backing off. When no active limit is set, the message states no rate. |
| `bucket_rate_limit` | Your system is sending too many of this type of request. If you need to send more, contact your Account Manager | Applied per zone and per account, against the request rate configured for them. Reduce your request rate to stay within the configured limit, or contact your account manager to raise it. Retrying immediately fails. Wait for the period given in `x-brd-rate-limit-period-ms` before retrying. |
| `failed_query_rejected` | This query recently failed and cannot be attempted at this time. Please try again later, after a minimum of 15 seconds. | Applied per zone and per query string. That query recently failed, so it is banned for 15 seconds and immediate retries fail as well. Retry after a minimum of 15 seconds. Other queries are unaffected and can continue at full rate. |
| `repeat_query_rejected` | This query cannot be attempted at this time. Please try again later, after a minimum of 15 seconds. | Applied per zone and per query string. The same query was sent too many times in a short window. Wait at least 15 seconds before resending that query, and avoid sending identical queries concurrently. Other queries are unaffected. |
| `client_10110` | Your account exceeded the allowed rate limits. Reduce requests rate and try again or complete the verification process to remove rate limits. You will not be charged for this request. | Applied per account, on accounts that have not completed verification. Returned in `x-brd-err-code` and `x-brd-err-msg` rather than `x-brd-error-code` and `x-brd-error`, because it is raised by the proxy layer. Reduce your total account request rate, or complete [account verification](/general/account/limited-trial-restrictions). |

```http Example rejected query response theme={null}
x-brd-error-code: failed_query_rejected
x-brd-error: This query recently failed and cannot be attempted at this time. Please try again later, after a minimum of 15 seconds.
```

Because `client_10110` uses the proxy-layer headers, read both when handling a 429:

```js theme={null}
const code = headers['x-brd-error-code'] || headers['x-brd-err-code'];
```

`sr_rate_limit` and `bucket_rate_limit` responses also state the limit that was applied:

| Header | Value |
| - | - |
| `x-brd-rate-limit` | The limit that was reached |
| `x-brd-rate-limit-period-ms` | The period that limit is measured over, in milliseconds |

## Handling query mismatches (unexpected\_q)

By default, when Bright Data detects that Google returned results for a different query than the effective query Bright Data sent to Google, the request returns the `unexpected_q` error and you are not billed. If you prefer to receive the mismatched data and validate it yourself, enable `return_mismatch`:

* **Proxy requests** - add the request header:
  ```http theme={null}
  x-unblock-data-options: {"return_mismatch": true}
  ```
* **API requests** - add to the request body:
  ```json theme={null}
  "data_options": {"return_mismatch": true}
  ```

<Warning>
  With `return_mismatch` enabled, mismatched responses are returned as successful requests and are billed. Validate them using the fields described in the next section.
</Warning>

## How to detect query truncation

<Note>
  When [automatic search query optimization](/products/serp-api/features#automatic-search-query-optimization) is enabled, `general.query` is the effective query Bright Data sent to Google after any eligible optimization. Compare this value, not necessarily the query originally submitted, with `general.detected_query`.
</Note>

Google sometimes returns results for a shorter version of the effective query Bright Data sent to Google. For example, a search for `pizza in tlv` can return results for `pizza`. This behavior applies to both the SERP API and Fast SERP text (web) search. By default these responses return the `unexpected_q` error (see above). If you enabled `return_mismatch`, validate each response yourself by comparing `general.query` with `general.detected_query`, then checking for a `spelling` object to tell a genuine spelling correction apart from a truncated search:

1. If `general.query` and `general.detected_query` match, Google returned results for the effective query Bright Data sent.
2. If they differ, check for a `spelling` object:
   * **`spelling` present** - Google auto-corrected the spelling and the results are valid for the corrected query.
   * **`spelling` absent** - Google truncated (cloaked) the effective query and returned results for a shorter version.

The example below shows an auto-corrected query, where `detected_query` differs from `query` but a `spelling` object confirms the results are valid:

```text theme={null}
{
  "general": {
    "query": "pizaa",
    "detected_query": "pizza"
  },
  "spelling": {
    "original_text": "pizaa",
    "original_link": "https://www.google.com/search?q=pizaa&nfpr=1",
    "auto_corrected_text": "pizza",
    "auto_corrected_link": "https://www.google.com/search?q=pizza&spell=1"
  },
  "organic": [ ... ]
}
```

For the `general` and `spelling` field definitions, see [Parsed JSON results](/products/serp-api/parsed-json-results) for the SERP API or [Fast SERP web search](/products/serp-api/fast-serp/web-search) for Fast SERP.

## What happens when a query is blocked

When Bright Data detects that Google has flagged a query, that exact query is blocked across the SERP API and Fast SERP for 15 seconds. Any request for the same query during that window returns the `failed_query_rejected` error (or `repeat_query_rejected` if the query was throttled for being repeated). Retry the query after the 15-second window, or vary the query, to receive results. Repeatedly hammering flagged queries hurts overall success rates. If your queries are generated synthetically (templates, LLMs, keyword permutations), track which patterns repeatedly trigger rejections or truncation and reformulate them. See [SERP API error catalog](#serp-api-error-catalog) for the full error responses.

## Get Success Rate Statistics Per Domain

Retrieve SERP API success rate stats from the past 7 days. Supports single domain or wildcard.

```bash Single domain theme={null}
curl "https://api.brightdata.com/unblocker/success_rate/google.com" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY"
```

```bash All monitored TLDs theme={null}
curl "https://api.brightdata.com/unblocker/success_rate/google.*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY"
```

<Warning>
  Once you provide your API key, replace all `$API_KEY`, `$CUSTOMER_ID`, `$ZONE`, and `$PASSWORD` placeholders accordingly.
</Warning>


# SERP API FAQs
Source: https://docs.brightdata.com/products/serp-api/faqs

FAQs about the Bright Data SERP API (31 languages): setup, troubleshooting, Google Image and Hotels scraping and advanced search techniques.

<AccordionGroup>
  <Accordion title="Why should I use Bright Data's SERP API?">
    The Bright Data SERP API solution allows you to focus on what matters most, the data. It provides you with a 3-in-1 proxy unlocking solution that autonomously takes care of the **proxy management** (which proxy to use and when), **unlocking logic** (captcha solving, fingerprinting, retries, best headers, etc), and **scraping** functionality. 

    <Tab title="Easy to integrate">
      In your code its as easy as swapping out the 1 line of your regular proxy network request with this 1 line SERP API request
    </Tab>

    <Tab title="Pay only for success">
      You only pay for successful requests.
    </Tab>

    <Tab title="Stable and predictable Billing">
      Because pricing is done according to number of pages (price per 1k requests), the bandwidth of your request doesn't matter.
    </Tab>

    <Tab title="Accuracy">
      Use real user devices with laser-focused geotargeting (including city-level) to collect accurate Search Engine Result Pages (SERPs) from major search engines as a real user.
    </Tab>

    <Tab title="Built for volume and scale">
      Bright Data can support your growing traffic needs and peak periods with high success rates and exceptional response time (under 5 seconds), regardless of your request volume.
    </Tab>

    <Tab title="Reduce costs">
      Save money on data extraction engineers and IT professionals, without worrying about server maintenance.
    </Tab>

    <Tab title="Avoid operational headaches">
      Each request is sent from a different IP ensuring no IP is flagged or banned.
    </Tab>

    <Tab title="Structured data response">
      Get parsed or unparsed responses in JSON or HTML format for easy integration with any system.
    </Tab>

    <Tab title="Highly customized">
      Bright Data supports a wide variety of tailored parameters to answer your search requirements including different search types, different devices, results per page, etc.
    </Tab>

    <Tab title="Real Residential IPs">
      Access 400M+ monthly residential IPs in all geolocations.
    </Tab>
  </Accordion>

  <Accordion title="How to use SERP API for &#x22;Google Search By Image&#x22;?">
    With Bright Data’s SERP API, it’s easy to collect Google Search by Image data.

    Google reverse image search (officially "Google Search by Image"), is a service provided by Google that allows users to search for images **using an image as the starting point**, rather than a written or spoken search query.

    <Note>
      The JSON response includes the image in base64 encoding.
    </Note>

    <CodeGroup>
      ```sh Search by image URL theme={null}
      curl -v --compressed --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/searchbyimage?image_url={TARGET_IMAGE_URL}"
      ```

      ```sh Search by an image stored locally theme={null}
      curl -v --compressed --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> 'http://www.google.com/searchbyimage/upload' -o results_page.html -F 'encoded_image=@{FULL_IMAGE_FILE_PATH}'
      ```
    </CodeGroup>

    See the rest of our [Google Image SERP features.](/products/serp-api/query-parameters/google#lens)
  </Accordion>

  <Accordion title="How to collect hotel data with SERP API?">
    Bright Data's SERP API makes it easy to collect hotel data, like prices, availability, reviews, and more.

    **There are two ways to collect hotel data:**

    <Tabs>
      <Tab title="Google Search Hotel Knowledge">
        **Provides limited info per specific hotel on pricing and dates**

        When you search for a specific hotel using Google Search, its details and reviews appear in the knowledge graph/widget that you can see on the right side below:

        <img alt="hotels-html.png" />

        You can set arrival and departure dates, the number of guests, and compare pricing..

        With SERP API, you can set these fields to collect different price combinations using dedicated parameters. See the full set of hotel parameters and features in our [Google Hotels query parameters documentation](/products/serp-api/query-parameters/google#hotels).

        <img alt="hotels-availability.png" />
      </Tab>

      <Tab title="Google Travel Hotel page">
        **Provides full details on hotels, pricing, and dates**

        SERP API also lets you target the hotel page in Google Travel (Google.\*/travel/hotels/…), where you can find more prices and search by additional parameters (including arrival and departure dates, the number of adults and children, the children’s ages, and whether or not it has free cancellation) to collect more price combinations.

        <Note>
          Only //Google.\*/travel/hotels/… URLs are supported.
        </Note>

        Go to the control panel [API Guide](https://brightdata.com/cp/serp_api/api/google/hotels) for an explanation of how to target this page and the dedicated parameters you can use, or see our [Google Hotels query parameters documentation](/products/serp-api/query-parameters/google#hotels).

        <img alt="hotel-info.png" />
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to send SERP API HTTPS requests without SSL Certificate?">
    When targeting HTTPS, URL data is encrypted. Therefore, for SERP API to decrypt the data and return the result, you will need to download and install the [Bright Data Certificate](/general/account/ssl-certificate).

    Here are sample code on how to send HTTPS requests:

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://www.google.com/search?q=pizza&brd_json=1" -v --insecure --compressed --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
      ```

      ```js NodeJS theme={null}
      process.env.NODE_TLS_REJECT_UNAUTHORIZED = 0;
      ```

      ```java Java theme={null}
      -Dcom.sun.net.ssl.checkRevocation=false
      ```

      ```cs C# theme={null}
      ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;
      ```

      ```python Python theme={null}
      # for native `request` library:
      import ssl
      ssl._create_default_https_context = ssl._create_unverified_context

      # for `requests` library, disable the ssl check directly in the .get() method:
      # requests.get(url, proxies=proxies, verify=False)
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to send HTTPS requests with SSL validation?">
    <Tabs>
      <Tab title="Shell">
        Use the `cacert` flag followed by the certificate file path:

        ```sh Shell theme={null}
        curl -v --compressed "https://www.google.com/search?q=pizza&brd_json=1" --cacert "{cert file path}" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>

        ```
      </Tab>

      <Tab title="Java">
        Please import the certificate to the Java Keystore. Here's an example using Java keytool to import the certificate:

        <CodeGroup>
          ```java Java theme={null}
          %JAVA_HOME% Keystore (mostly the cacerts file in ..\lib\security\).
          ```

          ```sh Keytool Command Example theme={null}
          keytool -import -alias <cert alias> -file <cert name>.cer -keystore <keystore filename> -storepass <keystore password>

          # After running the keytool command you will be prompted to trust the certificate: answer ‘y’
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Other Programming Languages">
        Follow the instructions in the following article on [how to download and Install the Bright Data certificate](/general/account/ssl-certificate) to your local machine's Trusted Root Certification Authorities.

        ```sh Shell theme={null}
        T_ID&zone={ASYNC_ZONE}&output={output_fomat_html/json}&response_id={response_id} -H "Authorization: Bearer {API_KEY}" -o {Your_result_ouput_file}
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to parse JSON with SERP API?">
    Please refer to this article: [Parsing Search Results](/products/serp-api/parsed-json-results)
  </Accordion>

  <Accordion title="How to send multiple queries in an identical API request? (DEPRECATED)">
    <Warning>
      The `multi` parameter was deprecated on December 7, 2025, and is no longer supported. Requests that include `multi` return only the first result. Do not use `multi` to send parallel SERP requests. Send each search as a separate SERP API request instead.
    </Warning>
  </Accordion>

  <Accordion title="I saw that Google recently stopped supporting the `num` parameter in requests. Are you working on an alternative solution?">
    Indeed, as of September 10, 2025, Google has started phasing out the `num` parameter feature.

    Due to this change, we recommend that customers requiring additional Google SERP pages (beyond the first) transition to use Bright Data’s Scrapers endpoint (Google SERP – 100 Results) to get positions 1–100 in a single call, no manual pagination, while controlling depth with start\_page/end\_page (1..10 ≈ Top 100).

    Learn more on how to [get top 100 results in 1 call](/products/serp-api/get-top-100-google-results).
  </Accordion>

  <Accordion title="What are common use cases for SERP API?">
    <Tab title="Organic Keyword Tracking">
      Mapping a company's ranking for various keywords in different locations
    </Tab>

    <Tab title="Brand Protection">
      Track top results for company brands and trademarks
    </Tab>

    <Tab title="Price Comparison">
      Search for products on online shopping websites and compare prices between different vendors
    </Tab>

    <Tab title="Market Research">
      Collect information about companies, contacts, locations, and more
    </Tab>

    <Tab title="Detect Copyright Infringements">
      Search for images or other copyright-protected content
    </Tab>

    <Tab title="Ad Intelligence">
      See which ads are showing for keywords in different countries, including double-click & Google ad services
    </Tab>
  </Accordion>

  <Accordion title="How to query Microsoft Bing with dates filter?">
    In the following article, we will analyze the different options for date-specific search queries on Bing and how to use them effectively

    ## Types of Date Filter Queries

    <Tabs>
      <Tab title="All dates">
        No date filter applied

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY](https://www.bing.com/search?q=YOUR_QUERY)
      </Tab>

      <Tab title="Past 24 hours">
        Add `filters=ex1%3a"ez1"` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1%3a"ez1](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1%3a"ez1)"
      </Tab>

      <Tab title="Past week">
        Add `filters=ex1%3a"ez2"` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1%3a"ez2](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1%3a"ez2)"
      </Tab>

      <Tab title="Past year">
        Add `filters=ex1%3a"ez3"` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1%3a"ez3](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1%3a"ez3)"
      </Tab>

      <Tab title="Exact Match">
        Specify the exact date range by adding `filters=ex1:"ez5_StartDateSequence_EndDateSequence”` to the URL

        * URL: [https://www.bing.com/search?q=YOUR\_QUERY\&filters=ex1:"ez5\_StartDateSequence\_EndDateSequence”](https://www.bing.com/search?q=YOUR_QUERY\&filters=ex1:"ez5_StartDateSequence_EndDateSequence”)

        <Tip>
          `StartDateSequence` and `EndDateSequence` can be calculated using the logic below.
        </Tip>
      </Tab>
    </Tabs>

    ***

    ## Determining the Sequence String for “Exact Match” Query

    To perform an Exact match date search, you need to calculate the sequence string for your desired date range. Follow these steps to determine the sequence string.

    <Steps>
      <Step title="Use known sequence as a “Starting Point”">
        Use January 1, 2024 as the starting point with known sequence: `19723`
      </Step>

      <Step title="Calculate StartDateSequence">
        * Count the days from January 1 to your desired starting date.
        * Add the number of days counted to the sequence number of January 1 to get the `StartDateSequence`.
          <Tip>
            Counting starts from “**0**”. e.g. 0, 1, 2, 3 ...
          </Tip>

        > #### Example:
        >
        > To calculate the sequence number for February 4, 2024:
        >
        > * Total days from January 1 to February 4: 35 days
        > * 35 - 1 (counting starts at “0”) = 34
        > * February 4, 2024: 19723 (Jan1) + 34 = 19757 (`StartDateSequence`)
      </Step>

      <Step title="Calculate EndDateSequence">
        Add the number of days in your date range to the `StartDateSequence` to get the `EndDateSequence`.

        > #### Example:
        >
        > To calculate the sequence number for February 20, 2024:
        >
        > * February 4, 2024: 19757
        > * Days from February 4 to February 20: 17 days
        > * 17 - 1 (counting starts at “0”) = 16
        > * February 20, 2024: 19757 + 16 = 19773 (`EndDateSequence`)
      </Step>

      <Step title="Form the Sequence String">
        * Use the format `ez5_StartDateSequence_EndDateSequence`
        * Replace `StartDateSequence` with the sequence number calculated above for the starting date.
        * Replace `EndDateSequence` with the sequence number calculated above for the ending date.

        > #### Example: For February 4, 2024, to February 20, 2024:
        >
        > * Calculated `StartDateSequence`: 19757
        > * Calculated `EndDateSequence`: 19773
        > * Sequence string: `ez5_19757_19773`
        > * URL for query `pizza`: <br />[https://www.bing.com/search?q=pizza\&filters=ex1:"ez5\_19757\_19773](https://www.bing.com/search?q=pizza\&filters=ex1:"ez5_19757_19773)"

        <Frame>
          <img alt="bing-exact-date-filter.png" />
        </Frame>
      </Step>
    </Steps>

    With the above, you can construct URLs to query Bing for any specific date range.
  </Accordion>

  <Accordion title="Why am I getting the error: &#x22;400 this endpoint is not supported&#x22;?">
    SERP API supports a select number of generic domains/endpoints related to search engines, some specific subdomains or endpoints, may not be supported -  example: `https://trends.google.com/trends` Is not supported while `https://trends.google.com/trends/explore` Is supported.

    To see a list of working examples of domains and paths that are supported, we highly recommend that you check the [SERP Playground](https://brightdata.com/cp/zones/serp_playground) and the [SERP Documentation](/products/serp-api/query-parameters).
  </Accordion>

  <Accordion title="How can I get faster SERP API response times?">
    Use `"data_format": "parsed_light"` for [faster top 10 results](/products/serp-api/introduction#get-only-top-10-results-faster-response), or contact [sales@brightdata.com](mailto:sales@brightdata.com) for [sub-1-second premium routing](/products/serp-api/introduction#sub-1-second-response-time).
  </Accordion>
</AccordionGroup>


# Fast SERP images search
Source: https://docs.brightdata.com/products/serp-api/fast-serp/images-search

Use Bright Data Fast SERP for Google Images via the native proxy interface. Receive compact JSON image results suited for real-time applications.

Bright Data offers a fast SERP service for Images. This service responds with a compact JSON to power real-time applications that need image search results. To gain access, please contact your Bright Data account manager.

## Fast Images Search Request

Fast SERP for Google Images works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

Both the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.

### Native proxy request

```text theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=pizza&udm=2&brd_json=1"
```

## Response Format

A successful response contains a single required `images` array.

### `images` array

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Title or alt text of the image |
| `link` | string | No | URL of the source page where the image was found |
| `image` | string | No | Thumbnail image URL |
| `original_image` | string | No | Full-resolution image URL |
| `image_width` | integer | No | Displayed image width in pixels |
| `image_height` | integer | No | Displayed image height in pixels |
| `original_width` | integer | No | Original image width in pixels |
| `original_height` | integer | No | Original image height in pixels |
| `blurred` | boolean | No | Whether the image is blurred |

## Example Response

```text theme={null}
{
  "images": [
    {
      "global_rank": 1,
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image_width": 400,
      "image_height": 300,
      "original_width": 1200,
      "original_height": 900,
      "blurred": false
    },
    {
      "global_rank": 2,
      "title": "Neapolitan Pizza with Fresh Basil",
      "link": "https://www.example-food.com/neapolitan",
      "image": "https://www.example-food.com/images/neapolitan-thumb.jpg",
      "original_image": "https://www.example-food.com/images/neapolitan-full.jpg",
      "image_width": 400,
      "image_height": 300,
      "original_width": 1600,
      "original_height": 1200,
      "blurred": false
    },
    {
      "global_rank": 3,
      "title": "New York Style Pizza Slice",
      "link": "https://www.example-pizza.com/ny-style",
      "image": "https://www.example-pizza.com/images/ny-slice-thumb.jpg",
      "original_image": "https://www.example-pizza.com/images/ny-slice-full.jpg",
      "image_width": 400,
      "image_height": 267,
      "original_width": 2000,
      "original_height": 1333,
      "blurred": false
    },
    {
      "global_rank": 4,
      "title": "Homemade Deep Dish Chicago Pizza",
      "link": "https://www.example-recipe.com/deep-dish",
      "image": "https://www.example-recipe.com/images/deep-dish-thumb.jpg",
      "original_image": "https://www.example-recipe.com/images/deep-dish-full.jpg",
      "image_width": 400,
      "image_height": 400,
      "original_width": 1500,
      "original_height": 1500,
      "blurred": false
    },
    {
      "global_rank": 5,
      "title": "Wood-Fired Pizza from Naples",
      "link": "https://www.example-travel.com/naples-pizza",
      "image": "https://www.example-travel.com/images/naples-pizza-thumb.jpg",
      "original_image": "https://www.example-travel.com/images/naples-pizza-full.jpg",
      "image_width": 400,
      "image_height": 267,
      "original_width": 3000,
      "original_height": 2000,
      "blurred": false
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search\_images.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search_images.schema.json)

## Supported parameters

| Parameter | Description | Example | Notes |
| - | - | - | - |
| `q` | Search query (**must be first in URL**) | `q=pizza` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl` | Two-letter country code for search country | `gl=us` | |
| `hl` | Two-letter language code for page language | `hl=en` | |
| `brd_json` | **Required.**`1` = parsed JSON | `brd_json=1` | |


# Fast SERP maps search
Source: https://docs.brightdata.com/products/serp-api/fast-serp/maps-search

Use Bright Data Fast SERP for Google Maps via the native proxy interface. Receive compact JSON Maps results suited for real-time applications.

Use Bright Data's Fast SERP service to retrieve compact Maps search results in real time via a native proxy interface.

## Google Maps endpoints

Google Maps Fast SERP supports two response types depending on the URL you target:

* **Maps search results**, a list of places matching a search query, returning an `organic` array
* **Place detail page**, a single place record, returning a `place` object

Both endpoints require the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter. Omitting either will result in an unexpected response format.

## Fast Maps Search Request

Fast SERP for Google Maps works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

### Maps search results

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/search/coffee+shops+new+york/?hl=en&gl=us&brd_json=1"
```

### Place detail page: using Place ID

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4&hl=en&gl=us&brd_json=1"
```

### Place details page: using Map Link

```text theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e379c3784bfe3b:0x839c689710299cfc?hl=en&gl=us&brd_json=1"
```

## Response Format

The response is one of two shapes depending on the targeted URL: a search results page returns an `organic` array; a place detail page returns a `place` object. Search results use `OrganicMapsSearchItem`; place detail pages use `OrganicMapsPlaceItem`. The two are identical except for the shape of the `reviews` array.

### `organic` array / `place` object

Both the items in `organic` and the `place` object share the following fields:

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Name of the place |
| `address` | string | No | Full address of the place |
| `phone` | string | No | Phone number of the place |
| `link` | string | No | URL to the place's website |
| `map_link` | string | No | URL to the place on Google Maps |
| `map_id` | string | No | Google Maps place identifier |
| `map_id_encoded` | string | No | Encoded version of the Google Maps place identifier |
| `description` | string | No | Short description of the place |
| `price` | string | No | Price range indicator, e.g. `"$$"` |
| `rating` | number | No | Average customer rating |
| `reviews_cnt` | number | No | Total number of customer reviews |
| `latitude` | number | No | Latitude coordinate of the place |
| `longitude` | number | No | Longitude coordinate of the place |
| `image` | string | No | Primary image URL |
| `original_image` | string | No | Original full-resolution image URL |
| `thumbnail` | string | No | Thumbnail image URL |
| `open_hours` | object | No | Opening hours keyed by day, e.g. `"Monday": "9am–5pm"` |
| `category` | array | No | List of place categories (see below) |
| `images` | array | No | List of place images (see below) |
| `menu_images` | array | No | List of menu images (see below) |
| `tags` | array | No | List of place attribute tags (see below) |
| `reviews` | array | No | List of customer reviews (see below) |

### `category` items

| Field | Type | Required | Description |
| - | - | - | - |
| `id` | string | Yes | Category identifier |
| `title` | string | Yes | Full category name |
| `title_short` | string | No | Shortened category name |

### `images` and `menu_images` items

| Field | Type | Required | Description |
| - | - | - | - |
| `image` | string | Yes | Image URL |
| `image_width` | integer | No | Displayed image width in pixels |
| `image_height` | integer | No | Displayed image height in pixels |
| `original_width` | integer | No | Original image width in pixels |
| `original_height` | integer | No | Original image height in pixels |

### `tags` items

| Field | Type | Required | Description |
| - | - | - | - |
| `group_id` | string | Yes | Identifier of the tag group |
| `group_title` | string | Yes | Display name of the tag group |
| `key_id` | string | Yes | Identifier of the tag key |
| `key_title` | string | Yes | Display name of the tag key |
| `value` | number | No | Numeric value associated with the tag |
| `value_title` | string | No | Display label for the tag value |
| `value_title_short` | string | No | Shortened display label for the tag value |

### `reviews` items (maps search results)

Search results carry a single short review snippet per place, with three fields only.

| Field | Type | Description |
| - | - | - |
| `text` | string | Review text snippet |
| `avatar` | string | URL of the reviewer's profile image |
| `link` | string | URL to the review on Google Maps |

<Note>
  On search results pages Google exposes only a snippet - no author, rating, timestamps, or images. Use the place detail endpoint for full review objects.
</Note>

### `reviews` items (place detail page)

| Field | Type | Description |
| - | - | - |
| `author` | string | Name of the reviewer |
| `avatar` | string | URL of the reviewer's profile image |
| `author_reviews_cnt` | number | Total number of reviews written by this author |
| `author_photos_cnt` | number | Total number of photos uploaded by this author |
| `rating` | number | Rating given in this review |
| `text` | string | Review text content |
| `timestamp_added` | string | Date/time the review was posted |
| `timestamp_edited` | string | Date/time the review was last edited |
| `link` | string | URL to the review |
| `source` | string | Platform source of the review |
| `source_logo` | string | URL of the source platform's logo |
| `images` | array of strings | List of image URLs attached to the review |
| `response_text` | string | Owner's reply to the review |
| `response_timestamp_added` | string | Date/time the owner's reply was posted |
| `response_timestamp_edited` | string | Date/time the owner's reply was last edited |

## Example Response

### Maps search results

```text theme={null}
{
  "organic": [
    {
      "global_rank": 1,
      "title": "Example Coffee Co.",
      "address": "123 Main St, New York, NY 10001",
      "phone": "+1 212-555-0100",
      "link": "https://www.example-coffee.com",
      "map_link": "https://www.google.com/maps/place/example-coffee",
      "map_id": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52",
      "map_id_encoded": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
      "price": "$$",
      "rating": 4.7,
      "reviews_cnt": 1280,
      "latitude": 40.7128,
      "longitude": -74.0060,
      "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
      "open_hours": {
        "Monday": "7am–7pm",
        "Tuesday": "7am–7pm",
        "Wednesday": "7am–7pm",
        "Thursday": "7am–7pm",
        "Friday": "7am–8pm",
        "Saturday": "8am–8pm",
        "Sunday": "9am–6pm"
      },
      "category": [
        { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
      ],
      "tags": [
        {
          "group_id": "service_options",
          "group_title": "Service options",
          "key_id": "dine_in",
          "key_title": "Dine-in",
          "value": 1,
          "value_title": "Available",
          "value_title_short": "Yes"
        }
      ],
      "reviews": [
        {
          "text": "I love that they have vegan options and I enjoyed their iced coffee too.",
          "avatar": "https://ssl.gstatic.com/local/servicebusiness/default_user.png",
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xKNlJXWklUR1JHYVZwVVFUZDNlbFYxTUhSTVZYYxAB!2m1!1s0x0:0x2c2119fb675d62e7!3m1!1s2@1"
        }
      ]
    }
  ]
}
```

### Maps Place detail page

```text theme={null}
{
  "place": {
    "global_rank": 1,
    "title": "Example Coffee Co.",
    "address": "123 Main St, New York, NY 10001",
    "phone": "+1 212-555-0100",
    "link": "https://www.example-coffee.com",
    "map_link": "https://www.google.com/maps/place/example-coffee",
    "map_id": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52",
    "map_id_encoded": "ChIJN1t_tDeuEmsRUsoyG83frY4",
    "description": "Specialty coffee shop serving single-origin espresso and pour-overs.",
    "price": "$$",
    "rating": 4.7,
    "reviews_cnt": 1280,
    "latitude": 40.7128,
    "longitude": -74.0060,
    "thumbnail": "https://www.example-coffee.com/images/thumb.jpg",
    "images": [
      {
        "image": "https://www.example-coffee.com/images/interior.jpg",
        "image_width": 800,
        "image_height": 600,
        "original_width": 1600,
        "original_height": 1200
      }
    ],
    "open_hours": {
      "Monday": "7am–7pm",
      "Friday": "7am–8pm",
      "Saturday": "8am–8pm",
      "Sunday": "9am–6pm"
    },
    "category": [
      { "id": "coffee_shop", "title": "Coffee Shop", "title_short": "Coffee" }
    ],
    "reviews": [
      {
        "text": "Excellent coffee and bakery treats in a clean, modern space. The almond croissant was buttery and flaky, with a nice level of sweetness.",
        "author": "Sviatlana.B",
        "avatar": "https://lh3.googleusercontent.com/a-/ALV-UjUavxkeqq5_Po5gMMQ5svtrPEqox1tWnoBiOD0jDpBU1ymA7jE=s120-c-rp-mo-ba12-br100",
        "author_reviews_cnt": 76,
        "author_photos_cnt": 490,
        "rating": 5,
        "timestamp_added": "2026-05-11T00:19:15.594Z",
        "timestamp_edited": "2026-05-12T10:18:13.857Z",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "images": [
          "https://lh3.googleusercontent.com/grass-cs/ACvplmNq1ASznw8ls76jo9sg-GcIDwywKkOM_XdonRCWZjaLUisyUKXS90lzQl7l_E8Iw4Uwk-Eu4LpuQtwe0FhSdQ4h8wlln887K7RSRqWxxvoF91nxtne-oeW3oBWTe8DkCJZHrOd_R2eUv6g=k-no"
        ],
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21oeloxQnFlbE5aTVY5RVlYcFFWa2xmTTNjd2JYYxAB!2m1!1s0x0:0x143482a9c81bf22b!3m1!1s2@1"
      }
    ]
  }
}
```

Response schema, Maps search results: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_maps\_search.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_maps_search.schema.json)

Response schema, place detail page: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_maps\_place.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_maps_place.schema.json)

## Supported parameters

| Parameter | Description | Example | Notes |
| - | - | - | - |
| `gl` | Two-letter country code for search country | `gl=us` | |
| `hl` | Two-letter language code for page language | `hl=en` | |
| `brd_json` | **Required.**`1` = parsed JSON | `brd_json=1` | |
| `search term` | Search query term embedded in URL | `coffee+shops+near+me` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |

***


# Fast SERP news search
Source: https://docs.brightdata.com/products/serp-api/fast-serp/news-search

Use Bright Data's Fast SERP service to retrieve compact Google News search results in real time.

Bright Data offers a fast SERP service for News. This service responds with a compact JSON to power real-time applications that need up-to-date news results. To gain access, please contact your Bright Data account manager.

## Google News endpoints

Google offers two endpoints for news search results:

[news.google.com](http://news.google.com) and [https://www.google.com/search/q=\[searchTerm\]\&tbm=nws](https://www.google.com/search/q=\[searchTerm]\&tbm=nws)

Bright Data offers **Fast SERP** results only for: [https://www.google.com/search/q=\[searchTerm\]\&tbm=nws](https://www.google.com/search/q=\[searchTerm]\&tbm=nws) . Bright Data will provide results for [news.google.com](http://news.google.com) , but with in our regular SERP.

## Fast News Search Request

Fast SERP for Google News works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

<Note>
  For Fast SERP, **both** the `x-unblock-data-format: parsed_light`request header **and** the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.
</Note>

### Native proxy request

```shell theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=earthquake&tbm=nws&brd_json=1"
```

<Tip>
  Fast SERP news search supports [automatic search query optimization](/products/serp-api/features#automatic-search-query-optimization). Add the `x-unblock-search-rewrite: on` header to enable it.
</Tip>

## Response Format

A successful response returns a JSON object with the following top-level fields.

### `general` object

Reports the effective query Bright Data sent to Google and the query Bright Data detected that Google returned results for.

| Field | Type | Description |
| - | - | - |
| `query` | string | The effective query Bright Data sent to Google. When automatic query optimization is enabled, this includes any eligible adjustments |
| `detected_query` | string | The query Bright Data detected that Google returned results for. It can differ from `query` when Google modifies, corrects, or truncates the search |

<Note>
  When [automatic search query optimization](/products/serp-api/features#automatic-search-query-optimization) is enabled, `general.query` contains the effective query Bright Data sent to Google after any eligible optimization. If your application needs the original query exactly as submitted, retain it in your application.

  If `general.query` and `general.detected_query` differ, check for a `spelling` object. When present, `spelling` contains the correction or suggestion displayed by Google, such as a “Did you mean” prompt.
</Note>

### Choosing image format

For news articles search results in Fast SERP, Bright Data offers to receive the data either as embedded Base64 binary code or as a URL. The default is Base64.

In order to get the image links use this header: `-H 'x-unblock-img-format: link'`

Example:

```text theme={null}
curl  --proxy fserp.brd.superproxy.io:44445 --proxy-user [username]:[password] -k -H 'x-unblock-data-format: parsed_light' -H 'x-unblock-img-format: link' "https://www.google.com/search?q=earthquake&tbm=nws&brd_json=1" --output nws_links.json
```

### `news` array

The primary array of individual news results.

| Field | Type | Description |
| - | - | - |
| `link` | string | URL of the news article |
| `title` | string | Headline of the article |
| `source` | string | Name of the news publisher |
| `source_logo` | string | URL of the publisher's logo image or Base64 image binary code |
| `date` | string | Publication date/time of the article |
| `image` | string | URL of the article's thumbnail image or Base64 image binary code |
| `global_rank` | integer | Rank position of the result on the page |

### `article_sets` array

Grouped article clusters organized by topic, each containing a `heading` label and an `items` array of articles.

<Note>
  article\_sets is not guaranteed to appear in every response. Your implementation should handle its absence gracefully.
</Note>

### Example response with image links

```JSON theme={null}
{
  "general": {
    "query": "earthquake",
    "detected_query": "earthquake"
  },
  "organic": [],
  "news": [
    {
      "link": "https://www.example-news.com/world/earthquake-latest",
      "title": "Major Earthquake Strikes Pacific Region",
      "source": "Example News",
      "source_logo": "https://www.example-news.com/logo.png",
      "date": "2 hours ago",
      "image": "https://www.example-news.com/images/earthquake.jpg",
      "global_rank": 1
    },
    {
      "link": "https://www.another-outlet.com/earthquake-update",
      "title": "Rescue Operations Underway After Earthquake",
      "source": "Another Outlet",
      "source_logo": "https://www.another-outlet.com/logo.png",
      "date": "3 hours ago",
      "image": "https://www.another-outlet.com/images/rescue.jpg",
      "global_rank": 2
    }
  ],
  "article_sets": [
    {
      "heading": "Latest Updates",
      "items": [
        {
          "link": "https://www.example-news.com/world/earthquake-latest",
          "title": "Major Earthquake Strikes Pacific Region",
          "source": "Example News",
          "date": "2 hours ago"
        }
      ]
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search\_news.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search_news.schema.json)

## Supported parameters

| Parameter | Description | Example | Notes |
| - | - | - | - |
| `q` | Search query (**must be first in URL**) | `q=earthquake` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl` | Two-letter country code for search country | `gl=us` | |
| `hl` | Two-letter language code for page language | `hl=en` | |
| `brd_json` | **Required.**`1` = parsed JSON | `brd_json=1` | |

**Headers**

| Header | Description | Example |
| - | - | - |
| `x-unblock-data-format` | **Required.** Must be `parsed_light` | `parsed_light` |
| `x-unblock-img-format` | Image format: `link` (URL) or default (Base64) | `link` |
| `x-unblock-search-rewrite` | Enables automatic optimization of eligible search queries | `on` |

***


# Fast SERP quickstart
Source: https://docs.brightdata.com/products/serp-api/fast-serp/quickstart

Get started with Bright Data Fast SERP.  Apply through your account manager and run high-volume Google search queries.

## How do I get access to Bright Data's Fast SERP?

Access to fast SERP is available through your account manager. Reach out to them at [sales@brightdata.com](mailto:sales@brightdata.com) to see if your account qualifies.

## How fast is Fast SERP?

Fast SERP responds at least twice as fast than our full regular SERP, with P(90) around 1 second.

*P(90) is the 90th percentile meaning 90% of the requests.*

## Which Google searches are supported under Fast SERP?

Fast SERP supports multiple search verticals. See the relevant page for that search type.

Supported verticals:

1. Web Search
2. News
3. Shopping
4. Images
5. Maps

## What volume in QPS (queries per second) is supported?

Bright Data's can support high volume SERP traffic from hundreds to thousands of QPS.

Consider both your POC/testing volume and your expected production volume before getting started. This helps ensure your zone is configured correctly for your workload. If you're unsure, start with an estimate, your account manager can adjust your rate allocation as your usage grows. If your usage fluctuates on short time spans (like sudden or planned high bursts, or sudden or planned zero traffic periods) - let us know so we can ensure level of service.

For the fair use rate limit that applies to SERP API accounts, see [SERP API fair use: rate limit](/general/usage-monitoring/serp-rate-limit).

## Do I need to control or throttle traffic on my end?

If your system has internal rate-limiting or load control mechanisms, share those details with your account manager. This helps align your zone's capacity with your infrastructure's behavior and avoids unnecessary errors.

## Should I use the native proxy interface or the REST API?

Fast SERP works best with the **native proxy interface**, it is slightly faster than the REST API. A REST API interface can be provided if required by your architecture.

## Which geographic region will my scrapers run from?

Fast SERP supports multiple deployment regions: **US East**, **US West**, **EU**, and **APAC**. Knowing your scraper region(s) in advance helps optimize routing and latency. If your production traffic is distributed across multiple regions, let your account manager know.


# Fast SERP shopping search
Source: https://docs.brightdata.com/products/serp-api/fast-serp/shopping-search

Use Bright Data's Fast SERP service to retrieve compact Shopping search results in real time via a native proxy interface.

## Fast SERP: Google Shopping endpoints

Google Shopping offers two types of pages that Fast SERP supports:

* **Shopping search results**, a listing of products for a given search query, via `https://www.google.com/search?q=[searchTerm]&udm=28`
* **Product detail page (PDP)**, a full product page with offers, specifications, and reviews, via a Google Shopping product URL

Both endpoints require the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter. Omitting either will result in an unexpected response format.

## Fast Shopping Search Request

Fast SERP for Google Shopping works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

### Shopping search results

Use the `udm=28` parameter to retrieve the Google Shopping search results listing page.

```bash theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=iphone&udm=28&brd_json=1"
```

### Response Format

A successful shopping search response contains a `shopping` array.

#### `shopping` array

| Field | Type | Required | Description |
| - | - | - | - |
| `price` | string | Yes | Displayed price of the product |
| `link` | string | Yes | URL to the product listing or merchant page |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Product name |
| `shop` | string | No | Name of the merchant or seller |
| `image` | string | No | URL of the product thumbnail image |
| `rating` | number | No | Average customer rating |
| `reviews_cnt` | integer | No | Number of customer reviews |
| `old_price` | string | No | Original price before discount, if applicable |
| `foreign_price` | string | No | Price as displayed in the merchant's own currency, when it differs from the search currency |
| `price_details` | array of objects | No | Breakdown of the price into named components. Each object carries `type` and `price`, and both are always present |
| `tag` | string | No | Promotional label Google attaches to the listing, e.g. `"Sale"` |

#### Example response, shopping search results

```json theme={null}
{
  "shopping": [
    {
      "title": "Apple iPhone 16 128GB Black",
      "link": "https://www.example-store.com/iphone-16-black",
      "price": "$799.00",
      "old_price": "$899.00",
      "foreign_price": "€739.00",
      "price_details": [
        { "type": "item", "price": "$799.00" },
        { "type": "shipping", "price": "$0.00" },
        { "type": "tax", "price": "$65.92" }
      ],
      "tag": "Sale",
      "shop": "Example Store",
      "rating": 4.8,
      "reviews_cnt": 3240,
      "image": "https://www.example-store.com/images/iphone-16.jpg",
      "global_rank": 1
    },
    {
      "title": "Apple iPhone 16 256GB White",
      "link": "https://www.another-store.com/iphone-16-white",
      "price": "$899.00",
      "shop": "Another Store",
      "rating": 4.7,
      "reviews_cnt": 1850,
      "image": "https://www.another-store.com/images/iphone-16-white.jpg",
      "global_rank": 2
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_shopping.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_shopping.schema.json)

## Fast Shopping Product Request

Fast SERP for Google Shopping product pages works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

For Fast SERP, both the `x-unblock-data-format: parsed_light` request header and the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.

<Note>
  Google Shopping product (PDP) URLs are short-lived. They carry an encoded `prds=` payload that Google rotates frequently, so a copied URL stops resolving after a short window. Do not hardcode a product URL. Instead, use whatever URL Google routes to when you open a product from a shopping search result tile, then append `&brd_json=1`.
</Note>

### Native proxy request

```shell theme={null}
curl -v --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user username:password \
  -k \
  "<GOOGLE_SHOPPING_PRODUCT_URL>&brd_json=1" \
  -H 'x-unblock-data-format: parsed_light'
```

## Response Format

A successful response is structured around three top-level fields: `product`, `product_offers`, and `product_spec`.

### `product` object

Top-level product information.

| Field | Type | Description |
| :- | :- | :- |
| `title` | string | Name of the product |
| `description` | string | Full product description |
| `images` | array of strings | List of product image URLs |
| `rating` | number \| null | Average customer rating |
| `reviews_cnt` | integer | Total number of customer reviews |
| `ai_images` | array of strings | Links to images in ai segment |

### `product_offers` array

List of individual seller offers for the product.

| Field | Type | Description |
| :- | :- | :- |
| `seller` | string | Name of the seller or merchant |
| `link` | string | URL to the seller's product page |
| `logo` | string | URL of the seller's logo image |
| `item_price` | array of strings | Current price(s) displayed for the offer |
| `item_old_price` | array of strings | Previous/crossed-out price(s), if applicable |
| `total_price` | array of strings | Total cost(s) of the offer including shipping and tax, as displayed by the seller |
| `shipping` | string | Shipping cost or delivery information |
| `rating` | number | Seller or offer rating |
| `reviews_cnt` | integer | Number of reviews for this offer |
| `details` | array of strings | List of offer detail highlights |
| `details_and_offers` | string | Combined details and promotional offer text |
| `payment_methods` | string | Accepted payment methods |

### `product_spec` object

Technical specifications grouped into sections.

| Field | Type | Description |
| :- | :- | :- |
| `specs` | array | List of specification sections |
| `specs[].data` | array | List of spec items within the section |
| `specs[].data[].name` | string | Specification label, e.g. `"Display size"` |
| `specs[].data[].value` | string | Specification value, e.g. `"6.1 inches"` |

## Example Response

```json theme={null}
{
  "product": {
    "title": "Apple iPhone 17 Pro Max",
    "description": "The Apple iPhone 17 Pro Max features the latest A-series chip, a pro camera system, and all-day battery life in a titanium design.",
    "images": [
      "https://www.example-store.com/images/iphone-17-pro-max-front.jpg",
      "https://www.example-store.com/images/iphone-17-pro-max-back.jpg"
    ],
    "ai_images": [
      "https://www.example-store.com/images/iphone-17-pro-max-ai-1.jpg",
      "https://www.example-store.com/images/iphone-17-pro-max-ai-2.jpg"
    ],
    "rating": 4.9,
    "reviews_cnt": 5120
  },
  "product_offers": [
    {
      "seller": "Example Store",
      "link": "https://www.example-store.com/iphone-17-pro-max",
      "logo": "https://www.example-store.com/logo.png",
      "item_price": ["$1,199.00"],
      "item_old_price": ["$1,299.00"],
      "total_price": ["$1,298.92"],
      "shipping": "Free shipping",
      "rating": 4.9,
      "reviews_cnt": 2100,
      "details": ["In stock", "Ships within 24 hours"],
      "details_and_offers": "In stock. Ships within 24 hours. 10% off with code SAVE10.",
      "payment_methods": "Visa, Mastercard, PayPal"
    },
    {
      "seller": "Another Store",
      "link": "https://www.another-store.com/iphone-17-pro-max",
      "logo": "https://www.another-store.com/logo.png",
      "item_price": ["$1,209.00"],
      "item_old_price": [],
      "total_price": ["$1,314.75"],
      "shipping": "$5.99 shipping",
      "rating": 4.7,
      "reviews_cnt": 980,
      "details": ["In stock"],
      "details_and_offers": "In stock. Standard delivery 3-5 days.",
      "payment_methods": "Visa, Mastercard"
    }
  ],
  "product_spec": {
    "specs": [
      {
        "data": [
          { "name": "Display size", "value": "6.9 inches" },
          { "name": "Display type", "value": "Super Retina XDR OLED" }
        ]
      },
      {
        "data": [
          { "name": "Storage", "value": "256GB" },
          { "name": "RAM", "value": "12GB" },
          { "name": "Processor", "value": "Apple A19 Pro" }
        ]
      },
      {
        "data": [
          { "name": "Main camera", "value": "48MP" },
          { "name": "Battery capacity", "value": "4685 mAh" }
        ]
      }
    ]
  }
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_shopping\_product.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_shopping_product.schema.json)

## Supported parameters

| Parameter | Description | Example | Notes |
| - | - | - | - |
| `q` | Search query (**must be first in URL**) | `q=iphone` | Query size must be under 8,000 charachters. <br />Longer queries fail with error. |
| `gl` | Two-letter country code for search country | `gl=us` | |
| `hl` | Two-letter language code for page language | `hl=en` | |
| `brd_json` | **Required.**`1` = parsed JSON | `brd_json=1` | |

***


# Fast SERP web search
Source: https://docs.brightdata.com/products/serp-api/fast-serp/web-search

Use Bright Data Fast SERP to retrieve compact JSON search results in real time via a native proxy interface, for low-latency apps.

Bright Data offers a fast SERP service with a compact JSON response, to power real-time applications in need of search results.

To gain access to Bright Data FAST SERP service, please contact your Bright Data account manager.

## Fast SERP Request

Fast SERP works best with the native proxy interface. If you need a REST API interface for your architecture, one can be provided.

<Note>
  For Fast SERP, **both** the `x-unblock-data-format: parsed_light`request header **and** the `brd_json=1` URL parameter are required. Omitting either will result in an unexpected response format.
</Note>

<Tip>
  Fast SERP supports [automatic search query optimization](/products/serp-api/features#automatic-search-query-optimization). Add the `x-unblock-search-rewrite: on` header to enable it.
</Tip>

### How to get organic results

Use header value `x-unblock-data-format: parsed_fast`, this request header will return organic results.

```shell theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_fast' \
  "https://www.google.com/search?q=pizza&brd_json=1" \
  > output.json
```

#### Organic results: response format

#### `organic` array

The primary array of web search results, present in both `parsed_light` and `parsed_fast` responses.

| Field | Type | Description |
| :- | :- | :- |
| `link` | string | URL of the result page |
| `title` | string | Title of the result |
| `description` | string | Snippet/summary shown in the search result |
| `global_rank` | integer | Rank position of the result on the page |
| `extensions` | array | Optional list of site links associated with the result (see below) |

#### `extensions` items

| Field | Type | Description |
| :- | :- | :- |
| `type` | string | Type of extension, e.g. `site_link` |
| `link` | string | URL of the site link |
| `text` | string | Anchor text of the site link |

### Example response, `parsed_fast` (organic results)

```text theme={null}
{
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "global_rank": 1,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza",
          "text": "Neapolitan pizza"
        }
      ]
    },
    {
      "link": "https://www.example-pizza.com/best-pizza-nyc",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975.",
      "global_rank": 2
    },
    {
      "link": "https://www.pizza-guide.com/top-10",
      "title": "Top 10 Pizza Places in NYC",
      "description": "Discover the highest-rated pizza restaurants across all five boroughs.",
      "global_rank": 3
    }
  ]
}
```

### Organic results with "Top Stories"

Use header value `x-unblock-data-format: parsed_light`, this request header will return Google's "Top Stories" in the response alongside organic results.

```shell theme={null}
curl -i --proxy fserp.brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER>-zone-<ZONE>:<PASSWORD> \
  -k \
  -H 'x-unblock-data-format: parsed_light' \
  "https://www.google.com/search?q=pizza&brd_json=1" \
  > output.json
```

### `general` object

Returned in every `parsed_light` response. Reports the effective query Bright Data sent to Google and the query Bright Data detected that Google returned results for, which lets you detect when Google truncates a search.

| Field | Type | Description |
| - | - | - |
| `query` | string | The effective query Bright Data sent to Google. When automatic query optimization is enabled, this includes any eligible adjustments |
| `detected_query` | string | The query Bright Data detected that Google returned results for. It can differ from `query` when Google modifies, corrects, or truncates the search |

<Note>
  When [automatic search query optimization](/products/serp-api/features#automatic-search-query-optimization) is enabled, `general.query` contains the effective query Bright Data sent to Google after any eligible optimization. If your application needs the original query exactly as submitted, retain it in your application.
</Note>

<Note>
  If `detected_query` differs from `query`, check for a `spelling` section in the response. If `spelling` is present, the difference is due to automatic spelling correction and the response is valid. If `spelling` is absent, the query was cloaked and results were returned for a truncated version of the effective query.

  By default, cloaked responses are not returned as data: the request fails with the `unexpected_q` error and is not billed. You will only receive responses where `detected_query` differs without a `spelling` section if you enabled the `return_mismatch` option. See [Handling query mismatches](/products/serp-api/debugging#handling-query-mismatches-unexpected_q) on the debugging page.
</Note>

### `spelling` object

Returned in a `parsed_light` response only when Google applies or suggests a spelling correction. All fields are nullable and appear only when Google provides that variant.

| Field | Type | Description |
| - | - | - |
| `original_text` | string \| null | The original query keyword before correction |
| `original_link` | string \| null | Google search URL for the original query |
| `auto_corrected_text` | string \| null | The corrected keyword Google searched instead |
| `auto_corrected_link` | string \| null | Google search URL for the corrected query |
| `auto_included_text` | string \| null | Term Google automatically included in the search |
| `auto_included_link` | string \| null | Google search URL for the auto-included term |
| `suggested_text` | string \| null | Keyword Google suggests ("Did you mean") without changing the results |
| `suggested_link` | string \| null | Google search URL for the suggested query |
| `original_empty` | boolean | `true` when Google returned no results for the original query |

### `top_stories` array

Returned only when using `x-unblock-data-format: parsed_light`. Contains Google's "Top Stories" news carousel results.

| Field | Type | Description |
| - | - | - |
| `link` | string | URL of the news article |
| `title` | string | Headline of the article |
| `source` | string | Name of the news publisher |
| `date` | string | Publication date/time of the article |
| `image` | string | URL of the article's thumbnail image |

### Example response, `parsed_light` (with Top Stories)

```text theme={null}
{
  "general": {
    "query": "pizza",
    "detected_query": "pizza"
  },
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "global_rank": 1,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza",
          "text": "Neapolitan pizza"
        },
        {
          "type": "site_link",
          "link": "https://en.wikipedia.org/wiki/Pizzeria",
          "text": "Pizzeria"
        }
      ]
    },
    {
      "link": "https://www.example-pizza.com/best-pizza-nyc",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975.",
      "global_rank": 2
    }
  ],
  "top_stories": [
    {
      "link": "https://www.example-news.com/pizza-festival",
      "title": "NYC Pizza Festival Returns This Summer",
      "source": "Example News",
      "date": "3 hours ago",
      "image": "https://www.example-news.com/images/pizza-fest.jpg"
    },
    {
      "link": "https://www.another-outlet.com/pizza-record",
      "title": "World Record Pizza Baked in Naples",
      "source": "Another Outlet",
      "date": "5 hours ago",
      "image": "https://www.another-outlet.com/images/pizza-record.jpg"
    }
  ]
}
```

<Note>
  Query truncation detection and blocked-query behavior (`failed_query_rejected`, `repeat_query_rejected`) apply to the whole SERP API, not just Fast SERP. See [How to detect query truncation](/products/serp-api/debugging#how-to-detect-query-truncation) and [What happens when a query is blocked](/products/serp-api/debugging#what-happens-when-a-query-is-blocked) on the SERP API debugging page.
</Note>

Response schema, with Top Stories: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search.schema.json)

Response schema, without Top Stories: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search\_web.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search_web.schema.json)

## Supported parameters

| Parameter | Description | Example | Notes |
| - | - | - | - |
| `q` | Search query (**must be first in URL**) | `q=pizza` | Query size must be under 8,000 characters. <br />Longer queries fail with error. |
| `gl` | Two-letter country code for search country | `gl=us` | |
| `hl` | Two-letter language code for page language | `hl=en` | |
| `brd_json` | **Required.**`1` = parsed JSON | `brd_json=1` | |
| `tbs` | Time-based filtering (`qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`, `qdr:y`) | `tbs=qdr:d` | See [time filtering](/products/serp-api/query-parameters/google#tbs). Values containing `li:1` are rejected. |

***


# Google SERP features
Source: https://docs.brightdata.com/products/serp-api/features

Configure Bright Data SERP API features including response format, parsing options and header overrides for Google search results.

## Parsing and response format configuration

You can control and override the default API response format setup defined during API creation in Bright Data control panel.

We allow either override by URL parameter `brd_json` or by relaying a header `x-unblock-data-format`

| Parameter | Type | Required | Default | Accepted values |
| :- | :- | :- | :- | :- |
| `brd_json` | URL | No | none | `1`, `html` |
| `x-unblock-data-format` | HTTP header | No | none | `parsed_light, html, screenshot` |

***

### Get response as raw HTML

Add header parameter: `x-unblock-data-format: html`.

Example:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user  brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k -H "x-unblock-data-format: html" "https://www.google.com/search?q=pizza"
```

***

### Get response as Full JSON

Add header parameter: `x-unblock-data-format: json`or add URL parameter: `brd_json=1`.

Examples:

```sh Header parameter theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k -H "x-unblock-data-format: json" "https://www.google.com/search?q=pizza"
```

```sh URL Parameter theme={null}
  curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://www.google.com/search?q=pizza&brd_json=1"
```

***

### Get Full JSON with a structure holding the full HTML  as `string`

Add URL parameter: `brd_json=html` or  header parameter: `x-unblock-data-format: html`

Example:

```sh JSON+HTML theme={null}
  curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://www.google.com/search?q=pizza&brd_json=html"
```

***

### Get light JSON

Add header parameter: `x-unblock-data-format: parsed_light` or URL parameter `brd_json=parsed_light` to get a faster response (works twice as fast as Full SERP) with fewer components.

Full schema documentation can be seen here: [https://docs.brightdata.com/products/serp-api/parsed-json-results#google-response-schema-light-json](/products/serp-api/parsed-json-results#google-response-schema-light-json)

Examples:

```sh Header parameter theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k -H "x-unblock-data-format: parsed_light" "https://www.google.com/search?q=pizza"
```

```sh URL parameter theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "https://www.google.com/search?q=pizza&brd_json=parsed_light"
```

***

### Get response as screenshot

Add header parameter: `x-unblock-data-format: screenshot` . Response will be a binary PNG image. In the example below add `--output` flag to `curl` to capture response to image file.

Example:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k -H "x-unblock-data-format: screenshot" "https://www.google.com/search?q=pizza" --output screenshot.png
```

***

## Automatic search query optimization

Bright Data can automatically optimize eligible Google Search queries before sending them to Google. These adjustments are designed to improve request success while preserving the original search intent.

This optional feature is supported by both SERP API and Fast SERP. Because optimization behavior may evolve, some queries may be adjusted while others are sent unchanged.

### Native proxy

Enable automatic query optimization by adding the `x-unblock-search-rewrite: on` request header:

<CodeGroup>
  ```bash SERP API theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>:<ZONE_PASSWORD> \
    -k \
    -H 'x-unblock-search-rewrite: on' \
    -H 'x-unblock-data-format: json' \
    'https://www.google.com/search?q=latest+technology+news'
  ```

  ```bash Fast SERP theme={null}
  curl --proxy fserp.brd.superproxy.io:44445 \
    --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>:<ZONE_PASSWORD> \
    -k \
    -H 'x-unblock-search-rewrite: on' \
    -H 'x-unblock-data-format: parsed_light' \
    'https://www.google.com/search?q=latest+technology+news&brd_json=1'
  ```
</CodeGroup>

### API request

When using the Bright Data API, add `"search_rewrite": true` to the JSON request body:

```bash theme={null}
curl -X POST 'https://api.brightdata.com/request' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "zone": "<ZONE_NAME>",
    "url": "https://www.google.com/search?q=latest+technology+news",
    "format": "raw",
    "data_format": "parsed_light",
    "search_rewrite": true
  }'
```

### Parsed response fields

When automatic query optimization is enabled, use these fields to understand which query produced the response:

| Field | Description |
| :- | :- |
| `general.query` | The effective query Bright Data sent to Google after applying any eligible optimization |
| `general.detected_query` | The query Bright Data detected that Google returned results for |
| `spelling` | Google's displayed spelling correction or suggestion, such as a “Did you mean” prompt, when present |

<Note>
  If your application needs the original query exactly as submitted, retain it in your application. In parsed responses, `general.query` contains the effective query sent to Google.
</Note>

For information about comparing `general.query` and `general.detected_query`, see [How to detect query truncation](/products/serp-api/debugging#how-to-detect-query-truncation).

***

## Get element rectangle information <Badge>BETA</Badge>

Add URL parameter `brd_rects=1` in order to get results rectangle area as displayed on search result screen. This allows you to know when, in relation to `viewport` (which signifies screen resolution used to render the page) how much space does the result take on the visible screen.`viewport` (screen size) can be found in `general` element.

Notes:

1. Getting rectangle data will increase response time. Expect response time to range between 5 seconds to 60 seconds per request.
2. In BETA version you must also relay`brd_json=1` URL parameter in addition to `brd_rects=1` .

Response elements which have rectangle information:

* `organic`
* `videos`
* `images`
* `people_also_ask`
* `ai_overview`
* `related_searches`
* `perspectives`
* `forums `
* `pagination`
* `latest_posts`

Example:

```bash theme={null}
curl -vx \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \ 
 "https://www.google.com/search?q=bright+data&brd_json=1&brd_rects=1"
```

## How to configure routing

**Pin requests to the same IP with** `x-brd-session`**.** This feature will attempt to keep the same proxy IP address which was used previously.

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-session: my-session-123' \
  "https://www.google.com/search?q=bright+data"
```

## Page Load configuration

**Wait for a specific element with `x-brd-expect`** *(requires* `custom_expect `*permission).*

Use this option in order to prevent premature response, and wait till specific element is rendered by google.

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-expect: {"element": "#search"}' \
  "https://www.google.com/search?q=bright+data"
```

## URL Control configuration

**Append a URL fragment with `x-brd-url-fragment`:**

Use this option if you need to maintain a base URL address, and append a suffix by your logic.

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-url-fragment: !/results/section2' \
  "https://www.google.com/search?q=bright+data"
```

## Get current rate limit

Send the `x-brd-get-rate-limit` header to have the response include the current rate limit for the target website.

```bash theme={null}
curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-brd-get-rate-limit: true' \
  "https://www.google.com/search?q=bright+data"   
```

For the account-level rate limit and the HTTP 429 response, see [SERP API fair use: rate limit](/general/usage-monitoring/serp-rate-limit).

## Request Headers: Summary

The following headers can be passed with your SERP API requests to control behavior, session pinning, output format, and more.

| Header or URL parameter | Availability | Purpose |
| :- | :- | :- |
| `x-brd-expect` | Zones with `custom_expect` permission | Custom success/failure validation criteria for response content |
| `x-unblock-data-format` | All | Controls output format: `json, html, light_json, screenshot, parsed` |
| `x-brd-url-fragment` | All (browser step) | Appends a URL fragment (`#...`) to the request URL for browser rendering |
| `x-brd-session` | All | Sets a customer session ID to pin requests to the same peer/IP |
| `x-request-priority` | All | Request priority hint - may influence internal routing decisions |
| `x-brd-get-rate-limit` | All | When present, response includes current rate limit info headers |
| `cookie` | Zones with `cookie_whitelist` or `header_whitelist` containing `cookie` | Customer cookies forwarded to target site (filtered by whitelist) |
| Any header in `header_whitelist` rule | Zones with `cust_head` permission | Custom headers forwarded verbatim to the target site |
| `brd_rects=1` | All | Show element rectangle data |
| `x-unblock-search-rewrite` | SERP API and Fast SERP | Set to `on` to allow Bright Data to optimize eligible search queries before sending them |
| `search_rewrite` | SERP API JSON requests | Set to `true` in the JSON request body to allow Bright Data to optimize eligible search queries before sending them |


# Get started with Bing SERP API
Source: https://docs.brightdata.com/products/serp-api/get-started-bing-serp-api

Start using Bright Data's Bing SERP API in 3 steps: Sign in, create a SERP zone, get your API key, and begin collecting Bing search data.

## Make your first request in minutes

Test the Bing SERP API in minutes with this ready-to-use code example.

<CardGroup>
  <Card title="Node.js Example" icon="code" href="https://github.com/brightdata/bright-data-bing-serp-api-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/brightdata/bright-data-bing-serp-api-python-project" />
</CardGroup>

## Bing SERP API Quick Start Examples

Run these basic examples to check that your Bing SERP API is working (remember to update in your API key and query):

<CodeGroup>
  ```shell cURL theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.bing.com/search?q=pizza",
      "format": "raw"
    }'
  ```

  ```javascript bing-serp.js theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.bing.com/search?q=pizza',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python bing_serp.py theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.bing.com/search?q=pizza',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</CodeGroup>

## Links to get started with Bing SERP API

* [SERP API introduction](/products/serp-api/introduction)
* [Get API key](/api-reference/authentication)
* [Bing query parameters](/products/serp-api/query-parameters/bing)

## Microsoft Bing API to Bright Data SERP API migration guide

[Bing API to Bright Data SERP API migration guide](/products/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide)


# Get started with Google SERP API
Source: https://docs.brightdata.com/products/serp-api/get-started-google-serp-api

Start using Bright Data's Google SERP API in 3 steps: Sign in, create a SERP zone, get your API key, and begin collecting Google search data.

## Make your first request in minutes

Test the Google SERP API in minutes with this ready-to-use code example.

<CardGroup>
  <Card title="Node.js Example" icon="code" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/brightdata/bright-data-serp-api-python-project" />
</CardGroup>

## Google SERP API Quick Start Examples

Run these basic examples to check that your Google SERP API is working (remember to update in your API key and query):

<CodeGroup>
  ```shell cURL theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza",
      "format": "raw"
    }'
  ```

  ```javascript google-serp.js theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python google_serp.py theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</CodeGroup>

## Links to get started with Google SERP API

* [SERP API introduction](/products/serp-api/introduction)
* [Get API key](/api-reference/authentication)
* [Google query parameters](/products/serp-api/query-parameters/google)


# Get top 100 Google results
Source: https://docs.brightdata.com/products/serp-api/get-top-100-google-results

Fetch positions 1-100 from Google search in a single Bright Data request with control over language, location, pagination depth and AI Overview extraction.

<Note>
  This guide uses the Scrapers (Datasets) to return Google SERP positions 1-100 in one request. You control language, geo-targeting, pagination depth, and device type. This is guides overcome the challenge in getting 100 results   (`n=100`)  after parameter deprecation by google.
</Note>

## Prerequisites

Before you begin, ensure you have:

* An active Bright Data account
* Your API key (found in your dashboard under **Users and API keys**)
* Dataset ID: `gd_mfz5x93lmsjjjylob`

<Note>
  **Pricing:** One successful API call = one billable request, regardless of page depth. Retries are included; no bandwidth fees apply. See [SERP Pricing & Billing](/products/serp-api/pricing-and-billing) for details.
</Note>

## Quick start

Try these examples to fetch the top 100 results in one request. Replace `${API_KEY}` with your actual API key.

### How to send a basic request

This example returns approximately 100 results (10 pages × \~10 results per page):

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
    -H "Authorization: Bearer ${API_KEY}" \
    -H "Content-Type: application/json" \
    -d '[{
      "url": "https://www.google.com/",
      "keyword": "pizza",
      "language": "en",
      "country": "US",
      "start_page": 1,
      "end_page": 10
    }]'
  ```

  ```js Node.js theme={null}
  import fetch from "node-fetch";

  const API_KEY = process.env.API_KEY;
  const DATASET_ID = "gd_mfz5x93lmsjjjylob";

  const payload = [
    {
      url: "https://www.google.com/",
      keyword: "pizza",
      language: "en",
      country: "US",
      start_page: 1,
      end_page: 10,
    },
  ];

  const res = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=${DATASET_ID}&include_errors=true`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${API_KEY}`,
      },
      body: JSON.stringify(payload),
    }
  );

  const job = await res.json();
  console.log(job); // Contains snapshot_id for status checks and download
  ```

  ```py Python theme={null}
  import os
  import json
  import requests

  API_KEY = os.environ.get("API_KEY")
  DATASET_ID = "gd_mfz5x93lmsjjjylob"

  payload = [
      {
          "url": "https://www.google.com/",
          "keyword": "pizza",
          "language": "en",
          "country": "US",
          "start_page": 1,
          "end_page": 10
      }
  ]

  res = requests.post(
      f"https://api.brightdata.com/datasets/v3/trigger?dataset_id={DATASET_ID}&include_errors=true",
      headers={
          "Authorization": f"Bearer {API_KEY}",
          "Content-Type": "application/json",
      },
      data=json.dumps(payload),
  )

  print(res.json())  # Contains snapshot_id for status checks
  ```
</CodeGroup>

### Which parameters to use

| Parameter | Type | Description | Example |
| - | - | - | - |
| `keyword` | string | Search term to query | `"pizza"` |
| `language` | string | UI language (ISO 639-1) | `"en"`, `"de"` |
| `country` | string | Geographic location (ISO 3166-1) | `"US"`, `"DE"` |
| `start_page` | integer | First page to scrape | `1` |
| `end_page` | integer | Last page to scrape | `10` (≈ top 100) |
| `collapse_aio` | boolean | Collapse the AI Overview section | `true`, `false` (default) |

<Tip>
  **Page ranges:** Use `start_page` and `end_page` to control depth:

  * `1..2` ≈ Top 20 results
  * `1..5` ≈ Top 50 results
  * `1..10` ≈ Top 100 results

  Smaller ranges complete faster and return smaller payloads.
</Tip>

## AI Overview extraction

The API automatically captures **Google's AI Overview** when available for your search query.

### What is AI Overview?

AI Overview is Google's AI-generated summary that appears at the top of search results. It provides quick answers synthesized from multiple sources.

### Response field

The AI Overview text is returned in the `aio_text` field:

```json theme={null}
{
  "keyword": "does honey expire?",
  "aio_text": "No, pure honey does not expire , as its high sugar content, low moisture, and acidity create an environment hostile to bacteria. While pure honey can last indefinitely, commercial honey may have a \"best by\" date for quality rather than safety...",
  "organic": [...],
  "people_also_ask": [...]
}
```

<Note>
  **AI Overview availability:** The `aio_text` field will be `null` or empty if no AI Overview is shown for your search.
</Note>

### Controlling AI Overview visibility

Use the `collapse_aio` parameter to control whether the AI Overview section is expanded or collapsed in the returned SERP.

| Value | Behavior |
| - | - |
| `collapse_aio=true` | AI Overview is collapsed |
| `collapse_aio=false` | AI Overview is expanded (default) |

Collapsing AI Overview prevents it from pushing organic results down the page, which produces more stable pixel-position metrics and consistent layout data comparable to historical baselines.

```json theme={null}
{
  "url": "https://www.google.com/",
  "keyword": "pizza",
  "language": "en",
  "country": "US",
  "start_page": 1,
  "end_page": 10,
  "collapse_aio": true
}
```

### Example processing

```js theme={null}
const results = await response.json();

results.forEach(result => {
  if (result.aio_text) {
    console.log('AI Overview:', result.aio_text);
    
    // Split into sections
    const sections = result.aio_text.split('\n\n');
    sections.forEach(section => console.log(section));
  }
});
```

## Understanding the async workflow

Scrapers is asynchronous. Here's how it works:

1. **Trigger** your request → receive a `snapshot_id`
2. **Monitor** progress using the `snapshot_id`
3. **Download** results when complete

### Which API endpoints to call

| Action | Method | Endpoint |
| - | - | - |
| Trigger request | POST | `/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob` |
| Check progress | GET | `/datasets/v3/progress/{snapshot_id}` |
| Download results | GET | `/datasets/v3/snapshot/{snapshot_id}` |

<Info>
  Learn more about the async workflow in [Asynchronous Requests](/products/serp-api/asynchronous-requests).
</Info>

### Complete workflow example

<CodeGroup>
  ```js Node.js theme={null}
  import fetch from "node-fetch";

  const API_KEY = process.env.API_KEY;
  const DATASET_ID = "gd_mfz5x93lmsjjjylob";

  // Step 1: Trigger request
  const triggerRes = await fetch(
    `https://api.brightdata.com/datasets/v3/trigger?dataset_id=${DATASET_ID}&include_errors=true`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${API_KEY}`,
      },
      body: JSON.stringify([
        {
          url: "https://www.google.com/",
          keyword: "pizza",
          language: "en",
          country: "US",
          start_page: 1,
          end_page: 10,
        },
      ]),
    }
  );

  const { snapshot_id } = await triggerRes.json();

  // Step 2: Poll for completion
  for (let attempt = 1; ; attempt++) {
    await new Promise((resolve) => setTimeout(resolve, 5000)); // Wait 5 seconds
    const progressRes = await fetch(
      `https://api.brightdata.com/datasets/v3/progress/${snapshot_id}`,
      {
        headers: { Authorization: `Bearer ${API_KEY}` },
      }
    );
    const progress = await progressRes.json();
    if (progress.status === "ready") break;
    if (progress.status === "failed" || progress.status === "canceled") {
      throw new Error(`Snapshot ${progress.status}: ${progress.error_message ?? "no details"}`);
    }
    if (attempt === 120) throw new Error("Snapshot was not ready after 10 minutes"); // stop after about 10 minutes
  }

  // Step 3: Download results
  const downloadRes = await fetch(
    `https://api.brightdata.com/datasets/v3/snapshot/${snapshot_id}?format=json`,
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  const results = await downloadRes.json();
  console.log(results);
  ```

  ```python Python theme={null}
  import os
  import time
  import requests

  API_KEY = os.getenv("API_KEY")
  DATASET_ID = "gd_mfz5x93lmsjjjylob"

  # Step 1: Trigger request
  trigger_url = f"https://api.brightdata.com/datasets/v3/trigger?dataset_id={DATASET_ID}&include_errors=true"
  trigger_response = requests.post(
      trigger_url,
      headers={
          "Content-Type": "application/json",
          "Authorization": f"Bearer {API_KEY}",
      },
      json=[
          {
              "url": "https://www.google.com/",
              "keyword": "pizza",
              "language": "en",
              "country": "US",
              "start_page": 1,
              "end_page": 10,
          }
      ],
  )

  snapshot_id = trigger_response.json()["snapshot_id"]

  # Step 2: Poll for completion
  for attempt in range(120):  # stop after about 10 minutes
      time.sleep(5)  # Wait 5 seconds
      progress_url = f"https://api.brightdata.com/datasets/v3/progress/{snapshot_id}"
      progress_response = requests.get(
          progress_url,
          headers={"Authorization": f"Bearer {API_KEY}"},
      )
      progress = progress_response.json()
      if progress["status"] == "ready":
          break
      if progress["status"] in ("failed", "canceled"):
          raise RuntimeError(f"Snapshot {progress['status']}: {progress.get('error_message', 'no details')}")
  else:
      raise TimeoutError("Snapshot was not ready after 10 minutes")

  # Step 3: Download results
  download_url = f"https://api.brightdata.com/datasets/v3/snapshot/{snapshot_id}?format=json"
  download_response = requests.get(
      download_url,
      headers={"Authorization": f"Bearer {API_KEY}"},
  )

  results = download_response.json()
  print(results)
  ```
</CodeGroup>

## How to configure advanced options

### Batch multiple queries

Process multiple search queries in one request:

```json theme={null}
[
  {
    "url": "https://www.google.com/",
    "keyword": "pizza",
    "language": "en",
    "country": "US",
    "start_page": 1,
    "end_page": 10
  },
  {
    "url": "https://www.google.com/",
    "keyword": "coffee",
    "language": "de",
    "country": "DE",
    "start_page": 1,
    "end_page": 10
  },
  {
    "url": "https://www.google.com/",
    "keyword": "running shoes",
    "language": "en",
    "country": "GB",
    "start_page": 1,
    "end_page": 5
  }
]
```

### Mobile search results

Add `"brd_mobile": true` to get mobile SERP data:

```bash cURL theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '[{
      "url": "https://www.google.com/",
      "keyword": "running shoes",
      "language": "en",
      "country": "US",
      "start_page": 1,
      "end_page": 10,
      "brd_mobile": true
    }]'
```

### Get results from the Web tab (udm=14)

The Google `udm` parameter defines which search tab the SERP comes from. The Bright Data SERP Scraper maps the native Google `udm` value to its own request parameter, `udm_web`.

To return results from the **Web** tab (`udm=14` on Google), set `udm_web` to `true` in your request:

<Note>
  The `udm_web` parameter cannot be combined with the `tbm` parameter.
</Note>

```bash cURL theme={null}
curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_mfz5x93lmsjjjylob&include_errors=true" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '[{
    "url": "https://www.google.com/",
    "keyword": "pizza kraków",
    "language": "pl",
    "country": "PL",
    "uule": "w+CAIQICIGUG9sYW5k",
    "udm_web": true,
    "include_paginated_html": true
  }]'
```

### Include HTML snapshots

Capture raw HTML alongside parsed data for auditing or custom parsing:

```json theme={null}
{
  "url": "https://www.google.com/",
  "keyword": "pizza",
  "language": "en",
  "country": "US",
  "start_page": 1,
  "end_page": 10,
  "include_paginated_html": true
}
```

When enabled, results include `pagination[].page_html` for each page.

### How to localize requests

Target specific markets with language and country combinations:

```json theme={null}
// German language, Germany location
{
  "keyword": "laufschuhe",
  "language": "de",
  "country": "DE",
  "start_page": 1,
  "end_page": 5
}

// English language, UK location
{
  "keyword": "trainers",
  "language": "en",
  "country": "GB",
  "start_page": 1,
  "end_page": 10
}

// Spanish language, Mexico location
{
  "keyword": "zapatos deportivos",
  "language": "es",
  "country": "MX",
  "start_page": 1,
  "end_page": 10
}
```

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How do I select specific output fields?">
    You can choose which parsed fields to return for all pages. To also include raw HTML for each page, add `"include_paginated_html": true` to your request. This returns `pagination[].page_html` alongside parsed fields.
  </Accordion>

  <Accordion title="Can I control AI Overview (AIO) visibility?">
    Yes. Use the `collapse_aio` boolean parameter to control AI Overview visibility:

    * `collapse_aio=true`, AI Overview is collapsed, keeping organic results in stable positions
    * `collapse_aio=false`, AI Overview is expanded (default behavior)

    Collapsing AIO is useful when consistent pixel-position metrics or layout comparisons against historical data are required.
  </Accordion>

  <Accordion title="What changed with the browser worker implementation?">
    We now use a browser worker for SERP scraping. This reduces duplicate results, improves session continuity across pagination, and enables richer outputs (such as AI Overview). All existing requests remain backward-compatible.
  </Accordion>

  <Accordion title="How does pricing work for top 100 results?">
    One successful API call = one billable request, even when it returns 100+ results across 10 pages. Retries are included automatically, and there are no additional bandwidth fees. See [SERP Pricing & Billing](/products/serp-api/pricing-and-billing) for full details.
  </Accordion>

  <Accordion title="What is the difference between language and country parameters?">
    * `language`: Controls the UI language Google uses (e.g., `"en"`, `"de"`, `"es"`)
    * `country`: Controls the geographic location for results (e.g., `"US"`, `"DE"`, `"MX"`)

    These can be combined independently to target specific markets.
  </Accordion>

  <Accordion title="How long does it take to get results?">
    Time varies based on query complexity and page depth. Smaller page ranges (e.g., `1..2`) complete faster than larger ranges (e.g., `1..10`). Use the Progress API to monitor your request status.
  </Accordion>

  <Accordion title="How to use tbs parameter?">
    Common usages for tbs to filter by date are:

    * Past hour:  tbs=qdr:h
    * Past 24 hours: tbs=qdr:d
    * Past week:  tbs=qdr:w
    * Past month:  tbs=qdr:m
    * Past year:  tbs=qdr:y\
       

    You can also set a custom range using tbs=cdr:1,cd\_min:MM/DD/YYYY,cd\_max:MM/DD/YYYY\
    Example:\
    ...\&tbs=cdr:1,cd\_min:1/1/2024,cd\_max:2/1/2024
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup>
  <Card title="Pricing & Billing" icon="credit-card" href="/products/serp-api/pricing-and-billing">
    Understand how requests are billed
  </Card>

  <Card title="Google query parameters" icon="sliders" href="/products/serp-api/query-parameters/google">
    Explore all available parameters
  </Card>

  <Card title="Parsed JSON results" icon="code" href="/products/serp-api/parsed-json-results">
    Learn about the response structure
  </Card>

  <Card title="Asynchronous requests" icon="clock" href="/products/serp-api/asynchronous-requests">
    Deep dive into the async workflow
  </Card>
</CardGroup>


# Guidelines for getting more Google ads
Source: https://docs.brightdata.com/products/serp-api/guidelines-for-getting-more-google-ads

Structure Bright Data SERP API requests across 31 languages to maximize paid-ad coverage. Tune query intent, vertical, geo and device for higher ad density.

This document covers the key strategies for structuring Google SERP requests so that more paid ads appear in the response. This is relevant for use cases like competitive intelligence, ad monitoring, ad verification, PPC research, and SERP data collection at scale.

Google's SERP is dynamic, not every query returns ads. Getting more ads in your SERP results requires understanding what triggers them.

This article quotes data and information from studies and knowledge we have collected: since ad presentation logic and strategy may change, those guidelines are provided as heuristics and initial direction for investigationa and implementation and may change over time.

***

## Understanding the Context

Not all Google searches return ads. Google only serves paid results when it determines that the user's query has purchasing or commercial intent. This means the way a query is phrased, the niche it targets, the geography it is served in, and the technical setup of the request all play a role in how many ads appear. Optimizing each of these layers will consistently increase the number of ads returned per SERP request.

***

## Part 1. Query-Level Triggers: What Types of Queries Return More Ads

### Use Commercial and Transactional Intent Keywords

The single most reliable way to get ads in a SERP is to use commercial or transactional-intent queries. Google serves ads when users are perceived as likely to purchase. The following table shows how different intent types affect ad density:

| Intent Type | Example Modifiers | Ad Rate |
| - | - | - |
| Transactional | buy, shop, price, affordable, order | Very High |
| Commercial | best, top, reviews, compare, deals | High |
| Informational | how to, what is, why | Low |
| Navigational | Brand names alone | Low |

Transactional "buy" keywords return shopping boxes in over 80% of SERPs. "Affordable" returns shopping results in over 73% of cases.

***

### Target High-Ad-Density Niches

Certain niches are heavily monetized and nearly always show ads. Prioritizing keywords from these verticals will produce higher ad yield per request:

| Niche | Approximate Ad Presence |
| - | - |
| Fashion and Beauty | 83% |
| Pets | 80% |
| Ecommerce and Retail | 78% |
| Healthcare | 65% |
| Insurance | 42% |
| Legal | High |
| Finance | High |

***

### Use 3 to 4 Word Middle-Tail Queries

Query length significantly affects whether ads appear. Research across over 100,000 keywords shows that 3-word and 4-word queries produce the highest rate of ad appearances, at approximately 15.75% and 15.54% respectively. Single-word or very long queries produce significantly fewer ads.

Middle-tail queries strike a balance between specificity and search volume, making them ideal for triggering advertiser competition. An example would be "buy running shoes online" rather than just "shoes" or "what are the best minimalist running shoes for flat feet and knee problems."

***

### Append Proven Commercial Modifiers to Base Keywords

To systematically trigger ads, append intent modifiers to core product or service keywords.

Transactional modifiers with the highest ad density:

* buy, shop, order, purchase, cheap, affordable, discount, deals, free shipping, coupon

Commercial modifiers with strong ad density:

* best, top, reviews, compare, vs, price, cost, rated

For example, instead of using "running shoes," use "buy running shoes cheap" or "best running shoes price 2025."

***

## Part 2. Request Configuration: Technical Setup for More Ads

### Set the Right Geo-Location

Ads are far more concentrated in certain markets. Google's ad inventory is densest in the United States, followed by the United Kingdom, Australia, and Canada. When configuring SERP requests, setting the country parameter to the US and the language to English will produce maximum ad yield. Localized markets in developing regions will return significantly fewer or no ads.

***

### Use Desktop Device Emulation

There is a significant difference in ad rates between desktop and mobile. Desktop SERPs return higher ad volumes, with up to four text ads at the top and additional shopping carousels. Mobile SERPs, particularly when AI Overviews are present, return ads in only a small fraction of queries. For collecting more ads, desktop results should be the default target.

***

### Avoid Personalized or Logged-In Sessions

Personalized Google sessions can suppress ads if the user's history suggests a purchase has already been made or if behavioral targeting has deprioritized certain ad categories. For consistent and maximum ad results, use clean sessions with no browsing history, disable personalization where possible, and rotate session cookies when operating at scale.

***

### Avoid Queries That Trigger AI Overviews

Research shows that 87% of SERPs that contain an AI Overview show no ads at all. Since AI Overviews expanded significantly in 2024 and 2025, they have become a major suppressor of ad display. To avoid this, prefer queries that are clearly commercial or transactional, as AI Overviews rarely appear for purchase-intent searches. Purely informational queries such as "how to" or "what is" are the most likely to trigger AI Overviews and the least likely to return ads.

***

## Part 3. Ad Types and How to Trigger Each

### How to trigger text ads

Text ads appear at the top and bottom of search results and are the most common ad format. They are triggered by keyword searches with commercial or transactional intent. High-CPC categories such as legal, insurance, and finance almost always return text ads, with up to four appearing at the top of the page.

### How to trigger shopping ads

Shopping ads appear as visual product carousels with images, prices, and merchant information. They are triggered by product-specific searches that include terms like buy, shop, price, or deals. Including a brand name alongside the product type produces the best results. For example: "Nike running shoes buy."

### Local Services Ads

Local Services Ads are triggered by local combined with service-category queries, such as "plumber near me" or "lawyer in New York." Appending a city name or the phrase "near me" to a service keyword is the most reliable way to trigger this format.

***

## Part 4. Targeting High-CPC Keywords for Maximum Ad Slots

High-CPC keywords attract more advertisers, which fills more ad slots on the SERP. The following categories consistently produce the highest ad density:

| Category | Typical CPC Range |
| - | - |
| Legal (lawyers, attorneys) | \$50 to \$100+ |
| Insurance | \$30 to \$60 |
| Finance, Loans, Credit | \$20 to \$50 |
| Healthcare and Medical | \$15 to \$40 |
| Real Estate | \$10 to \$25 |
| SaaS and B2B Software | \$10 to \$50 |

Searching for "personal injury lawyer \[city]" or "business insurance quote" will almost always return three to four text ads at the top of the page.

***

## Part 5. Scaling Tips for Systematic Ad Collection

***

### Use Standard Result Sets

As of early 2025, Google removed support for the num=100 parameter that previously allowed 100 results per page. The most stable approach is to use the default 10-result page. Standard result pages reliably return up to four text ads at the top, up to three text ads at the bottom, and shopping carousels where applicable.

***

### Target Queries at Peak Advertiser Hours

Ad auctions are dynamic and advertiser budgets fluctuate throughout the day. More advertisers compete during business hours, particularly on weekdays. The best windows for returning a full set of ads are Tuesday through Thursday between 9am and 5pm in the target geography. Weekends and late-night queries often return fewer ads as daily budgets exhaust or campaigns are paused.

***

## Part 6. Ad Position Reference

The following breakdown shows where ads typically appear in a standard non-AI Overview SERP:

| Ad Position | Trigger | Notes |
| - | - | - |
| Text ads at the top | High-competition commercial terms | Up to 4 ads |
| Shopping carousels | Product-specific queries | Appear above organic results |
| Text ads at the bottom | Most commercial queries | Up to 3 ads |
| Text ads top and bottom | Highly commercial queries | Maximum coverage |

***

## Part 7. Example Queries Designed to Return Maximum Ads

The following query structures are designed to reliably produce high ad density across different formats:

* "buy car insurance online cheap", text ads and shopping
* "best personal injury lawyer New York", four top text ads
* "compare health insurance plans 2025", text ads and shopping
* "affordable running shoes free shipping", shopping carousel and text ads
* "online MBA program cost", text ads in a high-CPC education category
* "best CRM software for small business", text and shopping ads
* "deals on laptops buy now", heavy shopping ads
* "home loan rates today", text ads in a high-CPC finance category

***

## What to remember

Getting more ads in Google SERP results is primarily a function of query intent, niche selection, geography, and technical configuration. Commercial and transactional queries in high-value niches, targeted at US audiences on desktop devices, using clean sessions and residential proxies through a reliable SERP API, will consistently return the highest number of paid results per request. Avoiding informational queries, AI Overview triggers, and personalized sessions are equally important in ensuring maximum ad yield.


# Introduction to SERP API
Source: https://docs.brightdata.com/products/serp-api/introduction

Use the Bright Data SERP API to collect structured search results from Google, Bing and other engines in under 1 second per request, with no proxy setup.

Collect search engine results at scale without managing proxies, CAPTCHAs, or parsing. Get structured data from Google, Bing, and other search engines in under 1 second.

**Perfect for:**

* SEO rank tracking and keyword monitoring
* AI agents performing web search and data enrichment
* Brand protection and ad intelligence
* Competitive market research and price comparison

<Tip>
  Pay only for successful delivery.
</Tip>

## Before you start

1. Sign in: [https://brightdata.com/cp/start](https://brightdata.com/cp/start)
2. Create a SERP API: [https://brightdata.com/cp/learn\_more/serp-api](https://brightdata.com/cp/learn_more/serp-api)
3. Get your API key: [/api-reference/authentication](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F)

<Tip>
  New to Bright Data? See the step-by-step guide: [/products/serp-api/quickstart](/products/serp-api/quickstart)
</Tip>

## Quickstart

A minimal request with cURL. Replace `YOUR_API_KEY` and `zone` with your values:

<CodeGroup>
  ```shell cURL theme={null}
  curl -X POST https://api.brightdata.com/request \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d '{
      "zone": "YOUR_SERP_API_ZONE",
      "url": "https://www.google.com/search?q=pizza&hl=en&gl=us",
      "format": "raw"
    }'
  ```

  ```javascript Node.js theme={null}
  // Node 18+ (global fetch)
  const resp = await fetch('https://api.brightdata.com/request', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY',
    },
    body: JSON.stringify({
      zone: 'YOUR_SERP_API_ZONE',
      url: 'https://www.google.com/search?q=pizza&hl=en&gl=us',
      format: 'raw' // set to "json" for parsed output
    }),
  });

  console.log(await resp.text());
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY',
  }

  payload = {
      'zone': 'YOUR_SERP_API_ZONE',
      'url': 'https://www.google.com/search?q=pizza&hl=en&gl=us',
      'format': 'raw'  # set to "json" for parsed output
  }

  r = requests.post('https://api.brightdata.com/request',
                    headers=headers, json=payload)

  print(r.text)
  ```
</CodeGroup>

<Tip>
  Prefer Markdown output? Set <code>"data\_format": "markdown"</code> to receive Markdown SERP structure.
</Tip>

<Tip>
  Prefer JSON output? Set query parameter <code>"brd\_json=1"</code> to receive JSON SERP structure.
</Tip>

<CardGroup>
  <Card title="Node.js example" icon="code" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" />

  <Card title="Python example" icon="code" href="https://github.com/brightdata/bright-data-serp-api-python-project" />
</CardGroup>

## What you'll get (parsed JSON preview)

A compact look at the parsed structure you can expect:

```json theme={null}
{
  "engine": "google",
  "query": "pizza",
  "results": [
    { 
      "type": "organic", 
      "position": 1, 
      "title": "Best Pizza Near Me", 
      "url": "https://example.com" 
    }
  ]
}
```

See the full schema and examples: [/products/serp-api/parsed-json-results](/products/serp-api/parsed-json-results#example-response)

## Supported engines and parameters

* Google, Bing, DuckDuckGo, Yandex, Baidu, Yahoo, Naver
* Engine-specific query parameters:
  * Google: [/products/serp-api/query-parameters/google](/products/serp-api/query-parameters/google)
  * Bing: [/products/serp-api/query-parameters/bing](/products/serp-api/query-parameters/bing)

## How SERP API performs

### Get only top 10 results (faster response)

If you only need the top 10 organic results without ads or knowledge panels, add `"data_format": "parsed_light"` for faster response times:

<CodeGroup>
  ```bash cURL highlight={8} theme={null}
  curl -X POST 'https://api.brightdata.com/request' \
    -H 'Authorization: Bearer <API_KEY>' \
    -H 'Content-Type: application/json' \
    -d '{
      "zone": "<ZONE_NAME>",
      "url": "https://www.google.com/search?q=pizza&hl=en&gl=us",
      "format": "raw",
      "data_format": "parsed_light"
    }'
  ```

  ```javascript scrape.js highlight={11} theme={null}
  const response = await fetch('https://api.brightdata.com/request', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <API_KEY>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      zone: '<ZONE_NAME>',
      url: 'https://www.google.com/search?q=pizza&hl=en&gl=us',
      format: 'raw',
      data_format: 'parsed_light'
    })
  });

  const data = await response.json();
  console.log(data.organic);  // Array of top 10 results
  ```

  ```python scrape.py highlight={8} theme={null}
  response = requests.post(
      'https://api.brightdata.com/request',
      headers={'Authorization': 'Bearer <API_KEY>'},
      json={
          'zone': '<ZONE_NAME>',
          'url': 'https://www.google.com/search?q=pizza&hl=en&gl=us',
          'format': 'raw',
          'data_format': 'parsed_light'
      }
  )

  data = response.json()
  print(data['organic'])  # Array of top 10 results
  ```
</CodeGroup>

Response example, trimmed to the first two organic results:

```json successful JSON response theme={null}
{
  "organic": [
    {
      "link": "https://example.com/pizza",
      "title": "Best Pizza in NYC - Joe's Pizza",
      "description": "Family-owned pizzeria serving authentic New York slices since 1975...",
      "global_rank": 1
    },
    {
      "link": "https://example.com/pizza-guide",
      "title": "Top 10 Pizza Places in NYC",
      "description": "Discover the highest-rated pizza restaurants across all five boroughs...",
      "global_rank": 2,
      "extensions": [
        {
          "type": "site_link",
          "link": "https://example.com/pizza-guide/brooklyn",
          "text": "Brooklyn"
        }
      ]
    }
  ]
}
```

### Sub-1-second response time

Get complete SERP results (organic, ads, knowledge panels, and all elements) in **under 1 second** with premium routing infrastructure designed for mission-critical AI applications.

**Ideal for:**

* AI agents performing real-time data enrichment
* Multi-step research workflows and fact verification
* Model evaluation and response grounding
* User-facing search applications requiring instant results

<Note>
  Contact your Account Manager or [sales@brightdata.com](mailto:sales@brightdata.com) to request access.
</Note>

## When to use asynchronous requests

Use async for large volumes, slower pages, or long-running queries. This improves reliability and throughput.

* Guide: [/products/serp-api/asynchronous-requests](/products/serp-api/asynchronous-requests)

<Tip>
  Targeting non-SERP pages? Use the Web Unlocker API: [/scraping-automation/web-unlocker](/products/web-unlocker/introduction)
</Tip>

## Troubleshooting quick hits

* **401/403**: Check your API key and zone permissions. See: [/api-reference/authentication](/api-reference/authentication)
* **429**: Reduce concurrency or switch to async. See: [/products/serp-api/asynchronous-requests](/products/serp-api/asynchronous-requests)
* **Empty/partial results**: Verify engine-specific parameters (e.g., `hl`, `gl`, `uule`, `location`). See: engine query parameters above.
* **Unexpected results:** This may occur when using non-latin letters. Google search query requests demands encoding the query request in that case.
* **Still stuck?** See FAQs: [/products/serp-api/faqs](/products/serp-api/faqs)

## Next steps

<CardGroup>
  <Card title="Send your first request" icon="bolt" href="/products/serp-api/send-your-first-request" />

  <Card title="SERP Pricing & Billing" icon="dollar-sign" href="/products/serp-api/pricing-and-billing" />

  <Card title="Query parameters (Google)" icon="sliders" href="/products/serp-api/query-parameters/google" />

  <Card title="Parsed JSON results" icon="list" href="/products/serp-api/parsed-json-results" />

  <Card title="Asynchronous requests" icon="clock" href="/products/serp-api/asynchronous-requests" />

  <Card title="Quick Start" icon="road" href="/products/serp-api/quickstart" />

  <Card title="FAQs" icon="circle-question" href="/products/serp-api/faqs" />
</CardGroup>


# Parsed JSON results with SERP API
Source: https://docs.brightdata.com/products/serp-api/parsed-json-results

Use Bright Data SERP API parsing to convert raw HTML responses into structured JSON for Google and Bing. Covers 12 countries.

## What is Parsing?

[Parsing](https://brightdata.com/blog/web-data/what-is-data-parsing) for SERP API is the process of transforming a raw HTML response into a **structured JSON** with fields and values of data. This advanced parsing functionality is supported specifically for Google & Bing.

When parsing is activated, data from SERP HTMLs are further structured into usable fields and values (such as, `rank`, `link`, `title`, `description`, `rating`, and dozens more fields) enabling you to monitor competitor SERP rankings, analyze keyword trends, and gather valuable market insights.

## Which type of responses does Bright Data SERP provide?

Bright Data provides the following parsing options:

1. Raw HTML: no parsing at all. Get the HTML response as is.
2. Full JSON: our full interpertation of Google's SERP HTML to JSON.
3. Light JSON: a subset of full JSON, including only the organic results and google's "Top Stories" .
4. Parsed Bing: our full interpertation of Bing's SERP HTML to JSON.
5. Markdown: our full interpertation of Google's and Bing's SERP HTML to markdown `*.md` file.
6. Screenshot: an image capture of the SERP HTML page as interperted by a browser.

## Overriding default configuration

In order to override default data format, learn how to use the designated header parameter here: [https://docs.brightdata.com/products/serp-api/features](/products/serp-api/features)

***

## Google response schema: Light JSON

This schema usually returns twice as fast as the Full JSON. It includes 10 organic reults and covers less components than full JSON.

## Response Format

A successful response may contain the following top-level fields depending on the query. Only `organic` is guaranteed in every response.

***

### `general` object

Returned in every Light JSON response. Reports the effective query Bright Data sent to Google and the query Bright Data detected that Google returned results for, which lets you detect when Google truncates a search.

| Field | Type | Description |
| - | - | - |
| `query` | string | The effective query Bright Data sent to Google. When automatic query optimization is enabled, this includes any eligible adjustments |
| `detected_query` | string | The query Bright Data detected that Google returned results for. It can differ from `query` when Google modifies, corrects, or truncates the search |

<Note>
  When [automatic search query optimization](/products/serp-api/features#automatic-search-query-optimization) is enabled, `general.query` contains the effective query Bright Data sent to Google after any eligible optimization. If your application needs the original query exactly as submitted, retain it in your application.
</Note>

<Note>
  If `detected_query` differs from `query`, check for a `spelling` object in the response. If `spelling` is present, the difference is due to automatic spelling correction and the response is valid. If `spelling` is absent, the query was cloaked and results were returned for a truncated version of the effective query. See [How to detect query truncation](/products/serp-api/debugging#how-to-detect-query-truncation).

  By default, cloaked responses are not returned as data: the request fails with the `unexpected_q` error and is not billed. You will only receive responses where `detected_query` differs without a `spelling` object if you enabled the `return_mismatch` option. See [Handling query mismatches](/products/serp-api/debugging#handling-query-mismatches-unexpected_q) on the debugging page.
</Note>

***

### `spelling` object

Returned in a Light JSON response only when Google applies or suggests a spelling correction. All fields are nullable and appear only when Google provides that variant.

| Field | Type | Description |
| - | - | - |
| `original_text` | string \| null | The original query keyword before correction |
| `original_link` | string \| null | Google search URL for the original query |
| `auto_corrected_text` | string \| null | The corrected keyword Google searched instead |
| `auto_corrected_link` | string \| null | Google search URL for the corrected query |
| `auto_included_text` | string \| null | Term Google automatically included in the search |
| `auto_included_link` | string \| null | Google search URL for the auto-included term |
| `suggested_text` | string \| null | Keyword Google suggests ("Did you mean") without changing the results |
| `suggested_link` | string \| null | Google search URL for the suggested query |
| `original_empty` | boolean | `true` when Google returned no results for the original query |

***

### `organic` array, required

The primary list of web search results.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Title of the result |
| `link` | string | No | URL of the result page |
| `description` | string | No | Snippet/summary shown in the search result |
| `image` | string | No | Image associated with the result |
| `extensions` | array | No | Site links or other extensions (see below) |

#### `extensions` items

| Field | Type | Required | Description |
| - | - | - | - |
| `type` | string | Yes | Extension type, e.g. `"site_link"` |
| `text` | string | No | Anchor text of the extension link |
| `link` | string | No | URL of the extension link |
| `description` | string | No | Description text, if available |
| `extended` | boolean | No | Whether the extension is in expanded form |

***

### `top_ads` / `bottom_ads` arrays

Paid advertisement results appearing above or below organic results.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the ad on the page |
| `title` | string | No | Ad headline |
| `link` | string | No | Destination URL of the ad |
| `display_link` | string | No | Displayed URL shown in the ad |
| `referral_link` | string | No | Referral tracking URL |
| `description` | string | No | Ad description text |
| `extensions` | array | No | Ad extensions (same structure as organic extensions) |

***

### `top_stories` object

Google's Top Stories news carousel. Contains a `heading` label and an `items` array of inline news items.

| Field | Type | Required | Description |
| - | - | - | - |
| `heading` | string | No | Section heading, e.g. `"Top Stories"` |
| `items` | array | No | List of inline news items (see below) |
| `posts` | array | No | List of post items (see below) |

#### `top_stories.items` items

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the item on the page |
| `title` | string | No | Headline of the article |
| `link` | string | No | URL of the article |
| `story` | string | No | Short summary or excerpt |
| `image` | string | No | Thumbnail image URL |

***

### `article_sets` array

Grouped article clusters organized by topic, each containing a `heading` label and an `items` array of inline news items. Not guaranteed to appear in every response, your implementation should handle its absence gracefully.

| Field | Type | Required | Description |
| - | - | - | - |
| `heading` | string | No | Topic heading for the article cluster |
| `items` | array | No | List of inline news items (same structure as `top_stories.items`) |
| `posts` | array | No | List of post items (see below) |

***

### `news` array

News results embedded in the search page.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Headline of the article |
| `link` | string | No | URL of the article |
| `source` | string | No | Publisher name |
| `source_logo` | string | No | Publisher logo URL |
| `date` | string | No | Publication date/time |
| `description` | string | No | Article snippet |
| `image` | string | No | Thumbnail image URL |

***

### `videos` array

Video results embedded in the search page.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Video title |
| `link` | string | No | URL to the video |

***

### `shorts` array

Short-form video results embedded in the search page.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Title of the short video |
| `link` | string | No | URL to the short video |
| `image` | string | No | Thumbnail image URL |

***

### `images` array

Image results embedded in the search page.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Image title |
| `link` | string | No | URL of the source page |
| `image` | string | No | Thumbnail image URL |
| `original_image` | string | No | Full-resolution image URL |
| `image_width` | integer | No | Displayed image width in pixels |
| `image_height` | integer | No | Displayed image height in pixels |
| `original_width` | integer | No | Original image width in pixels |
| `original_height` | integer | No | Original image height in pixels |
| `blurred` | boolean | No | Whether the image is blurred |
| `is_hidden` | boolean | No | Whether the images is hidden |

***

### `shopping` array

Shopping results embedded within web search results.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `price` | string | Yes | Displayed price of the product |
| `link` | string | Yes | URL to the product page |
| `title` | string | No | Product name |
| `shop` | string | No | Merchant name |
| `old_price` | string | No | Original price before discount, if applicable |
| `rating` | number | No | Product rating |
| `reviews_cnt` | integer | No | Number of reviews |
| `image` | string | No | Product image URL |

***

### `snack_pack_map` object

The map image associated with the local pack results.

| Field | Type | Description |
| - | - | - |
| `image` | string | Map image URL |
| `link` | string | URL to Google Maps |

***

### `snack_pack` array

Local business results shown in the map pack.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `name` | string | No | Business name |
| `link` | string | No | URL to the business website |
| `cid` | string | No | Google Customer ID of the business |
| `site` | string | No | Business website domain |
| `address` | string | No | Business address |
| `phone` | string | No | Phone number |
| `maps_link` | string | No | URL to the business on Google Maps |
| `rating` | number | No | Average customer rating |
| `reviews_cnt` | number | No | Total number of reviews |
| `work_status` | string | No | Current open/closed status |
| `work_status_details` | string | No | Detailed status, e.g. `"Open until 10:00 PM"` |
| `summary` | string | No | Short description of the business |
| `tags` | array of strings | No | Attribute tags, e.g. `["Dine-in", "Takeaway"]` |
| `image` | string | No | Business image URL |

***

### `overview` object

Knowledge panel overview for an entity, parsed from featured snippet elements.

| Field | Type | Description |
| - | - | - |
| `title` | string | Entity name |
| `kgmid` | string | Google Knowledge Graph ID |
| `items` | array | List of overview items (see below) |

#### `overview.items` items

| Field | Type | Description |
| - | - | - |
| `type` | string | Item type, e.g. `"fact"`, `"image"` |
| `attrid` | string | Attribute identifier from Google's data |
| `title` | string | Label of the attribute |
| `values` | array of strings | Attribute values |
| `href` | string | URL associated with the attribute |
| `source` | string | Source name |
| `image` | string | Image URL, if applicable |
| `image_alt` | string | Alt text for the image |

***

### `perspectives` array

Perspective results from forums, social media, and editorial sources.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Perspective title |
| `link` | string | No | URL to the full post |
| `image` | string | No | Image URL |

***

### `latest_posts` array

Latest social or editorial posts widget.

| Field | Type | Required | Description |
| - | - | - | - |
| `global_rank` | integer | Yes | Rank position of the result on the page |
| `title` | string | No | Post title |
| `link` | string | No | URL to the post |
| `image` | string | No | Post image URL |

***

## Example Response

```JSON theme={null}
{
  "general": {
    "query": "pizza",
    "detected_query": "pizza"
  },
  "organic": [
    {
      "global_rank": 1,
      "title": "Pizza - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients.",
      "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/pizza.jpg/220px.jpg",
      "extensions": [
        { "type": "site_link", "text": "Neapolitan pizza", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza", "extended": false },
        { "type": "site_link", "text": "Pizzeria", "link": "https://en.wikipedia.org/wiki/Pizzeria", "extended": false }
      ]
    },
    {
      "global_rank": 2,
      "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
      "link": "https://www.pizzahut.com/",
      "description": "Order pizza online for fast delivery or carryout from a store near you.",
      "extensions": [
        { "type": "site_link", "text": "Menu", "link": "https://www.pizzahut.com/menu", "extended": false }
      ]
    },
    {
      "global_rank": 3,
      "title": "Domino's Pizza - Order Online for Delivery or Carryout",
      "link": "https://www.dominos.com/",
      "description": "Order Domino's pizza online for delivery or carryout. Find deals, coupons, and track your order in real time.",
      "extensions": []
    }
  ],
  "top_ads": [
    {
      "global_rank": 4,
      "title": "Order Pizza Online — Fast Delivery Guaranteed",
      "link": "https://www.example-pizza-ad.com/order",
      "display_link": "www.example-pizza-ad.com",
      "referral_link": "https://www.example-pizza-ad.com/ref=google",
      "description": "Hot fresh pizza delivered to your door in 30 minutes or less.",
      "extensions": [
        { "type": "site_link", "text": "Order Now", "link": "https://www.example-pizza-ad.com/order" }
      ]
    }
  ],
  "top_stories": {
    "heading": "Top Stories",
    "items": [
      {
        "global_rank": 5,
        "title": "NYC Pizza Festival Returns for Its Biggest Year Yet",
        "link": "https://www.example-news.com/nyc-pizza-festival-2026",
        "story": "The annual NYC Pizza Festival is back with over 50 vendors and live entertainment.",
        "image": "https://www.example-news.com/images/pizza-festival.jpg"
      },
      {
        "global_rank": 6,
        "title": "The Science Behind the Perfect Pizza Crust",
        "link": "https://www.another-outlet.com/pizza-crust-science",
        "story": "Researchers reveal the chemistry that makes a pizza crust perfectly crispy.",
        "image": "https://www.another-outlet.com/images/pizza-crust.jpg"
      }
    ]
  },
  "article_sets": [
    {
      "heading": "Latest pizza news",
      "items": [
        {
          "global_rank": 7,
          "title": "World Record Pizza Baked in Naples",
          "link": "https://www.example-news.com/world-record-pizza",
          "story": "A team of chefs in Naples broke the world record for the longest pizza ever made.",
          "image": "https://www.example-news.com/images/record-pizza.jpg"
        }
      ]
    }
  ],
  "news": [
    {
      "global_rank": 8,
      "title": "Pizza Sales Surge as Comfort Food Trend Continues",
      "link": "https://www.example-business.com/pizza-sales-surge",
      "source": "Example Business News",
      "source_logo": "https://www.example-business.com/logo.png",
      "date": "3 hours ago",
      "description": "Pizza delivery and carryout sales have hit record highs this quarter.",
      "image": "https://www.example-business.com/images/pizza-sales.jpg"
    }
  ],
  "videos": [
    {
      "global_rank": 9,
      "title": "How to Make Perfect Homemade Pizza",
      "link": "https://www.youtube.com/watch?v=abc123"
    },
    {
      "global_rank": 10,
      "title": "Classic New York Pizza At Home",
      "link": "https://www.youtube.com/watch?v=def456"
    }
  ],
  "shorts": [
    {
      "global_rank": 11,
      "title": "60-Second Pizza Dough Hack",
      "link": "https://www.youtube.com/shorts/xyz789",
      "image": "https://i.ytimg.com/vi/xyz789/hqdefault.jpg"
    }
  ],
  "images": [
    {
      "global_rank": 12,
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image_width": 400,
      "image_height": 300,
      "original_width": 1200,
      "original_height": 900,
      "blurred": false
    }
  ],
  "shopping": [
    {
      "global_rank": 13,
      "title": "Ooni Koda 16 Gas Powered Pizza Oven",
      "link": "https://www.example-store.com/ooni-koda-16",
      "price": "$599.00",
      "old_price": "$699.00",
      "shop": "Example Store",
      "rating": 4.8,
      "reviews_cnt": 3120,
      "image": "https://www.example-store.com/images/ooni-koda.jpg"
    }
  ],
  "snack_pack_map": {
    "image": "https://maps.googleapis.com/maps/api/staticmap?center=40.7128,-74.0060&zoom=13",
    "link": "https://www.google.com/maps/search/pizza+near+me"
  },
  "snack_pack": [
    {
      "global_rank": 14,
      "name": "Joe's Pizza",
      "link": "https://www.joespizzanyc.com",
      "cid": "12345678901234567",
      "site": "joespizzanyc.com",
      "address": "7 Carmine St, New York, NY 10014",
      "phone": "+1 212-366-1182",
      "maps_link": "https://www.google.com/maps/place/Joe%27s+Pizza",
      "rating": 4.7,
      "reviews_cnt": 5230,
      "work_status": "Open",
      "work_status_details": "Open until 4:00 AM",
      "summary": "Iconic NY pizza slice joint",
      "tags": ["Dine-in", "Takeaway", "No delivery"],
      "image": "https://www.joespizzanyc.com/images/storefront.jpg"
    }
  ],
  "overview": {
    "title": "Pizza",
    "kgmid": "/m/0663v",
    "items": [
      { "type": "fact", "attrid": "place_of_origin", "title": "Place of origin", "values": ["Naples, Italy"], "href": "https://en.wikipedia.org/wiki/Naples", "source": "Wikipedia" },
      { "type": "fact", "attrid": "main_ingredients", "title": "Main ingredients", "values": ["Dough", "Tomato sauce", "Mozzarella", "Toppings"], "href": "" },
      { "type": "image", "attrid": "image", "title": "Pizza", "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/pizza.jpg/220px.jpg", "image_alt": "A classic Margherita pizza" }
    ]
  },
  "perspectives": [
    {
      "global_rank": 15,
      "title": "Why Neapolitan Pizza is the Gold Standard",
      "link": "https://www.reddit.com/r/pizza/comments/example",
      "image": "https://www.reddit.com/images/pizza-post.jpg"
    }
  ],
  "latest_posts": [
    {
      "global_rank": 16,
      "title": "I tried 30 NYC pizza slices in one weekend — here's my ranking",
      "link": "https://www.example-blog.com/nyc-pizza-ranking",
      "image": "https://www.example-blog.com/images/pizza-ranking.jpg"
    }
  ],
  "bottom_ads": [
    {
      "global_rank": 17,
      "title": "Best Pizza Deals Online — Order Now",
      "link": "https://www.example-pizza-ad2.com/order",
      "display_link": "www.example-pizza-ad2.com",
      "referral_link": "https://www.example-pizza-ad2.com/ref=google",
      "description": "Find the best pizza deals in your area. Fast delivery, great prices.",
      "extensions": []
    }
  ]
}
```

Response schema: [https://api.brightdata.com/data\_schemas/fast\_serp/google\_search.schema.json](https://api.brightdata.com/data_schemas/fast_serp/google_search.schema.json)

***

## Google response schema: Full JSON

A successful Google Search response is a JSON object that may contain the following top-level fields depending on the query and search context.

Response schema: [https://api.brightdata.com/data\_schemas/serp/google\_search.schema.json](https://api.brightdata.com/data_schemas/serp/google_search.schema.json)

***

### `general` object

Metadata about the search request and results.

| Field | Type | Description |
| - | - | - |
| `query` | string | The effective query Bright Data sent to Google. When automatic query optimization is enabled, this includes any eligible adjustments |
| `detected_query` | string | The query Bright Data detected that Google returned results for. It can differ from `query` when Google modifies, corrects, or truncates the search |
| `results_cnt` | integer | Total number of results reported by Google |
| `search_time` | number | Time taken by Google to process the search, in seconds |
| `language` | string | Language of the search results |
| `country` | string | Country name associated with the search |
| `country_code` | string | Two-letter country code |
| `search_type` | string | Type of search, e.g. `"text"`, `"shopping"` |
| `is_mobile` | boolean | Whether the request was made as a mobile device |
| `is_empty` | boolean | Whether the results page returned no results |
| `consent_type` | string | Consent mode applied to the request |

<Note>
  When [automatic search query optimization](/products/serp-api/features#automatic-search-query-optimization) is enabled, `general.query` contains the effective query Bright Data sent to Google after any eligible optimization. If your application needs the original query exactly as submitted, retain it in your application.
</Note>

<Note>
  When `detected_query` differs from `query`, check for a `spelling` object to tell a genuine spelling correction apart from a truncated (cloaked) query. By default, cloaked responses fail with the `unexpected_q` error (not billed) instead of returning data; to receive them anyway, enable `return_mismatch`. See [Handling query mismatches](/products/serp-api/debugging#handling-query-mismatches-unexpected_q) on the debugging page.
</Note>

***

### `input` object

Details about the original request.

| Field | Type | Description |
| - | - | - |
| `original_url` | string | The URL that was requested |
| `user_agent` | string | User agent string used for the request |
| `request_id` | string | Bright Data internal request identifier |

***

### `organic` array

The primary list of web search results.

| Field | Type | Description |
| - | - | - |
| `link` | string | URL of the result page |
| `amp_link` | string | AMP version URL, if available |
| `title` | string | Title of the result |
| `display_link` | string | Displayed URL shown in the result |
| `source` | string | Source name |
| `description` | string | Snippet shown in the search result |
| `snippet_highlighted_words` | array of strings | Words highlighted in the snippet |
| `last_modified_date` | string | Last modified date of the page, if available |
| `icon` | string | Favicon of the result |
| `image` | string | Image associated with the result |
| `thumbnail` | string | Thumbnail image URL |
| `extensions` | array | Site links or other extensions (see below) |
| `subresults` | array | Indented sub-results under the main result (see below) |
| `similar_link` | string | Link to similar pages |
| `cached_link` | string | Link to Google's cached version |
| `translate_link` | string | Link to translated version |
| `global_rank` | integer | Rank position of the result on the page |

#### `extensions` items

| Field | Type | Description |
| - | - | - |
| `type` | string | Extension type, e.g. `"site_link"` |
| `text` | string | Anchor text |
| `link` | string | URL of the extension link |
| `description` | string | Description text, if available |
| `extended` | boolean | Whether the extension is in expanded form |
| `inline` | boolean | Whether the extension is displayed inline |

#### `subresults` items

| Field | Type | Description |
| - | - | - |
| `link` | string | URL of the sub-result |
| `title` | string | Title of the sub-result |
| `description` | string | Snippet of the sub-result |
| `display_link` | string | Displayed URL of the sub-result |
| `global_rank` | integer | Rank position of the sub-result |

***

### `top_ads` / `bottom_ads` arrays

Paid advertisement results appearing above or below organic results.

| Field | Type | Description |
| - | - | - |
| `title` | string | Ad headline |
| `link` | string | Destination URL of the ad |
| `display_link` | string | Displayed URL shown in the ad |
| `referral_link` | string | Referral tracking URL |
| `description` | string | Ad description text |
| `phone` | string | Phone number shown in the ad, if any |
| `deal_link` | string | Link to a deal associated with the ad |
| `deal_text` | string | Deal text, if any |
| `image` | string | Image shown in the ad |
| `extensions` | array | Ad extensions (same structure as organic extensions) |
| `global_rank` | integer | Rank position of the ad |

***

### `top_pla` / `bottom_pla` / `jackpot_pla` arrays

Product Listing Ads (shopping ads) appearing at the top, bottom, or in a prominent carousel.

| Field | Type | Description |
| - | - | - |
| `title` | string | Product name |
| `link` | string | URL to the product page |
| `referral_link` | string | Referral tracking URL |
| `price` | string | Displayed price |
| `old_price` | string | Original price before discount, if applicable |
| `shop` | string | Merchant name |
| `shipping` | string | Shipping information |
| `rating` | number | Product rating |
| `reviews_cnt` | integer | Number of reviews |
| `extensions` | array of strings | Additional labels or badges |
| `image` | string | Product image URL |
| `view_all` | boolean | Whether this is a "view all" sentinel row that links to the full result list |
| `global_rank` | integer | Rank position of the item |

***

### `shopping` array

Shopping results embedded within web search results.

| Field | Type | Description |
| - | - | - |
| `title` | string | Product name |
| `link` | string | URL to the product page |
| `shop_link` | string | URL to the merchant's store page |
| `description` | string | Product description |
| `price` | string | Displayed price |
| `old_price` | string | Original price before discount, if applicable |
| `shop` | string | Merchant name |
| `shipping` | string | Shipping information |
| `rating` | number | Product rating |
| `reviews_cnt` | integer | Number of reviews |
| `trusted_store` | boolean | Whether the merchant is marked as a trusted store |
| `compare_prices` | string | Link or label for comparing prices |
| `image` | string | Product image URL |
| `referral_link` | string | Referral tracking URL |
| `global_rank` | integer | Rank position of the item |

***

### `news` array

News results embedded in the search page.

| Field | Type | Description |
| - | - | - |
| `title` | string | Headline of the article |
| `link` | string | URL of the article |
| `source` | string | Publisher name |
| `source_logo` | string | Publisher logo URL |
| `description` | string | Article snippet |
| `date` | string | Publication date/time |
| `image` | string | Thumbnail image URL |
| `global_rank` | integer | Rank position of the result |

***

### `top_stories` object

Google's "Top Stories" news carousel.

| Field | Type | Description |
| - | - | - |
| `items` | array | List of top story items |
| `items[].title` | string | Headline |
| `items[].link` | string | Article URL |
| `items[].source` | string | Publisher name |
| `items[].source_logo` | string | Publisher logo URL |
| `items[].date` | string | Publication date/time |
| `items[].image` | string | Thumbnail image URL |
| `items[].global_rank` | integer | Rank position |

***

### `videos` / `short_videos` arrays

Video results embedded in the search page.

| Field | Type | Description |
| - | - | - |
| `title` | string | Video title |
| `link` | string | URL to the video |
| `source` | string | Platform or publisher name |
| `date` | string | Publication date |
| `duration` | string | Video duration as displayed |
| `duration_sec` | integer | Video duration in seconds |
| `image` | string | Thumbnail image URL |
| `key_moments` | array | List of key moment timestamps (see below) |
| `global_rank` | integer | Rank position |

#### `key_moments` items

| Field | Type | Description |
| - | - | - |
| `title` | string | Label for the key moment |
| `link` | string | URL to the specific timestamp |
| `start` | string | Start time as displayed |
| `start_sec` | integer | Start time in seconds |
| `image` | string | Preview image URL |

***

### `images` array

Image results embedded in the search page.

| Field | Type | Description |
| - | - | - |
| `title` | string | Image title |
| `link` | string | URL of the source page |
| `source` | string | Source site name |
| `source_logo` | string | Source site logo URL |
| `original_image` | string | URL of the full-resolution image |
| `image` | string | Thumbnail image URL |
| `global_rank` | integer | Rank position |

***

### `featured_snippets` array

Featured snippet boxes appearing at the top of results.

| Field | Type | Description |
| - | - | - |
| `type` | string | Snippet type, e.g. `"paragraph"`, `"list"`, `"table"` |
| `title` | string | Snippet title |
| `description` | string | Snippet text content |
| `value` | string | Value shown in the snippet, if applicable |
| `link` | string | Source URL |
| `display_link` | string | Displayed source URL |
| `source` | string | Source name |
| `image` | string | Image URL, if applicable |
| `items` | array | List items for list-type snippets (`text`, `value`) |
| `global_rank` | integer | Rank position |

***

### `people_also_ask` array

"People also ask" questions shown on the results page.

| Field | Type | Description |
| - | - | - |
| `question` | string | The question text |
| `answer` | string | The answer snippet |
| `link` | string | Source URL for the answer |
| `title` | string | Title of the source page |
| `display_link` | string | Displayed source URL |
| `global_rank` | integer | Rank position |

***

### `knowledge` object

Google Knowledge Panel for an entity.

| Field | Type | Description |
| - | - | - |
| `title` | string | Entity name |
| `subtitle` | string | Entity category or subtitle |
| `type` | string | Entity type |
| `description` | string | Description of the entity |
| `description_source` | string | Source of the description |
| `description_link` | string | URL of the description source |
| `kgmid` | string | Google Knowledge Graph ID |
| `link` | string | Official website URL |
| `image` | string | Main image URL |
| `facts` | array | List of fact items (`predicate`, `title`, `value`, `link`) |
| `widgets` | array | Additional knowledge widgets |

***

### `ai_overview` object

Google AI Overview summary shown at the top of some results pages.

| Field | Type | Description |
| - | - | - |
| `texts` | array | List of content blocks (type: `title`, `paragraph`, `list`, `code`) |
| `texts[].type` | string | Content block type |
| `texts[].snippet` | string | Text content of the block |
| `texts[].links` | array | Inline links within the block (`text`, `link`) |
| `texts[].reference_indexes` | array of integers | Indexes pointing to the `references` array |
| `references` | array | Source references cited in the AI overview |
| `references[].href` | string | URL of the reference |
| `references[].title` | string | Title of the reference |
| `references[].source` | string | Source name |
| `references[].index` | integer | Reference index |
| `global_rank` | integer | Rank position |

***

### `snack_pack` array

Local business results shown in the map pack.

| Field | Type | Description |
| - | - | - |
| `name` | string | Business name |
| `link` | string | URL to the business website |
| `cid` | string | Google Customer ID of the business |
| `rating` | number | Average customer rating |
| `reviews_cnt` | integer | Number of reviews |
| `type` | string | Business category |
| `price` | string | Price range indicator |
| `phone` | string | Phone number |
| `address` | string | Business address |
| `work_status` | string | Current open/closed status |
| `work_status_details` | string | Detailed status description |
| `maps_link` | string | URL to the business on Google Maps |
| `sponsored` | boolean | Whether the listing is a sponsored result |
| `tags` | array of strings | Attribute tags for the business |
| `global_rank` | integer | Rank position |

***

### `snack_pack_map` object

The map image associated with the local pack results.

| Field | Type | Description |
| - | - | - |
| `image` | string | Map image URL |
| `link` | string | URL to Google Maps |
| `lat` | string | Latitude of the map center |
| `lng` | string | Longitude of the map center |

***

### `jobs` object

Job listing results embedded in the search page.

| Field | Type | Description |
| - | - | - |
| `title` | string | Widget title |
| `items` | array | List of job items |
| `items[].title` | string | Job title |
| `items[].company` | string | Company name |
| `items[].location` | string | Job location |
| `items[].source` | string | Job board or source |
| `items[].description` | string | Job description snippet |
| `items[].link` | string | URL to the job listing |
| `items[].tags` | array | List of tags (`name`, `value`) |

***

### `flights` object

Flight results widget.

| Field | Type | Description |
| - | - | - |
| `title` | string | Widget title |
| `from` | string | Departure location |
| `to` | string | Destination |
| `date_from` | string | Departure date |
| `date_to` | string | Return date |
| `flight_class` | string | Cabin class |
| `ticket_type` | string | One-way or round trip |
| `items` | array | List of flight options (`logo`, `title`, `travel_time`, `stops`, `price`, `link`) |
| `date_price_items` | array | Alternate date pricing (`departure_date`, `return_date`, `price`) |

***

### `hotels_selection` object

Hotel results widget.

| Field | Type | Description |
| - | - | - |
| `title` | string | Widget title |
| `items[].name` | string | Hotel name |
| `items[].link` | string | URL to the hotel listing |
| `items[].price` | string | Displayed price |
| `items[].rating` | number | Hotel rating |
| `items[].reviews_cnt` | integer | Number of reviews |
| `items[].tags` | array of strings | Attribute labels |
| `items[].image` | string | Hotel image URL |

***

### `recipes` object

Recipe results widget.

| Field | Type | Description |
| - | - | - |
| `title` | string | Widget title |
| `items[].title` | string | Recipe name |
| `items[].link` | string | URL to the recipe |
| `items[].rating` | number | Recipe rating |
| `items[].reviews_cnt` | integer | Number of reviews |
| `items[].source` | string | Source site |
| `items[].cook_time` | string | Cooking time |
| `items[].ingredients` | array of strings | List of ingredients |
| `items[].image` | string | Recipe image URL |

***

### `popular_products` object

Popular products widget embedded in results.

| Field | Type | Description |
| - | - | - |
| `title` | string | Widget title |
| `items[].title` | string | Product name |
| `items[].price` | string | Displayed price |
| `items[].link` | string | URL to the product |
| `items[].rating` | number | Product rating |
| `items[].reviews_cnt` | integer | Number of reviews |
| `items[].features` | array of strings | Product feature highlights |
| `items[].image` | string | Product image URL |

***

### `weather` object

Weather widget shown for weather-related queries.

| Field | Type | Description |
| - | - | - |
| `title` | string | Location name |
| `temperature` | string | Current temperature |
| `image` | string | Weather condition icon URL |
| `daily_forecast` | array | Day-by-day forecast (`day`, `image`, `temperature.daytime`, `temperature.nighttime`) |
| `hourly_forecast` | object | Hourly precipitation and wind data |
| `additional_info` | array | Extra info items (`type`, `text`) |

***

### `currency_exchange` object

Currency conversion widget.

| Field | Type | Description |
| - | - | - |
| `exchange_rate` | number | Current exchange rate |
| `date` | string | Date of the rate |
| `exchange` | array | Converted amounts (`amount`, `currency`) |
| `history` | array | Historical rates (`exchange_rate`, `date`) |

***

### `related` array

"Related searches" shown at the bottom of the page.

| Field | Type | Description |
| - | - | - |
| `text` | string | Related search text |
| `link` | string | URL to the related search |
| `expanded` | boolean | Whether this item has nested related items |
| `items` | array | Nested related items, same structure |

***

### `pagination` object

Pagination data for the results page.

| Field | Type | Description |
| - | - | - |
| `current_page` | integer | Current page number |
| `next_page` | integer | Next page number |
| `next_page_link` | string | URL to the next page |
| `pages` | array | List of available pages (`page`, `start`, `link`) |

***

### `spelling` object

Spell correction data, if Google corrected or suggested an alternative query.

| Field | Type | Description |
| - | - | - |
| `original_text` | string | The original query as submitted |
| `original_link` | string | URL to search with the original query |
| `original_empty` | boolean | Whether the original query returned no results |
| `auto_corrected_text` | string | Query Google automatically corrected to |
| `auto_corrected_link` | string | URL for the auto-corrected query |
| `suggested_text` | string | Alternative spelling suggestion |
| `suggested_link` | string | URL for the suggested spelling |

***

### `forums` object

Forum and discussion results embedded in the page.

| Field | Type | Description |
| - | - | - |
| `items[].title` | string | Forum post or thread title |
| `items[].source` | string | Forum or platform name |
| `items[].link` | string | URL to the forum thread |
| `items[].answers` | array | List of answers (`text`, `link`, `is_top_answer`) |

***

### `latest_posts` object

Latest social or editorial posts widget.

| Field | Type | Description |
| - | - | - |
| `title` | string | Widget title |
| `items[].title` | string | Post title |
| `items[].source` | string | Publisher or platform name |
| `items[].channel` | string | Channel or account name |
| `items[].date` | string | Publication date |
| `items[].link` | string | URL to the post |
| `items[].image` | string | Post image URL |
| `items[].global_rank` | integer | Rank position |

***

### `perspectives` array

Perspectives results from forums, social media, and editorial sources.

| Field | Type | Description |
| - | - | - |
| `title` | string | Perspective title |
| `author` | string | Author name |
| `source` | string | Source platform |
| `text` | string | Excerpt or summary |
| `date` | string | Publication date |
| `link` | string | URL to the full post |
| `image` | string | Image URL |
| `global_rank` | integer | Rank position |

***

### `navigation` array

Top navigation links shown on the results page (e.g. Images, News, Videos).

| Field | Type | Description |
| - | - | - |
| `title` | string | Label of the navigation item |
| `href` | string | URL of the navigation link |

***

### `chips` array

Refinement chip filters shown below the search bar.

| Field | Type | Description |
| - | - | - |
| `label` | string | Chip label text |
| `link` | string | URL for applying the chip filter |
| `image_url` | string | Icon image URL, if applicable |

### Example Full JSON

```sh Full JSON response example theme={null}
{
  "general": {
    "query": "pizza",
    "detected_query": "pizza",
    "results_cnt": 2340000000,
    "search_time": 0.52,
    "language": "en",
    "country": "United States",
    "country_code": "US",
    "search_type": "text",
    "is_mobile": false,
    "is_empty": false,
    "consent_type": "none"
  },
  "input": {
    "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
    "request_id": "hl_a1b2c3d4e5f6g7h8"
  },
  "navigation": [
    { "title": "Images", "href": "https://www.google.com/search?q=pizza&udm=2" },
    { "title": "News", "href": "https://www.google.com/search?q=pizza&tbm=nws" },
    { "title": "Videos", "href": "https://www.google.com/search?q=pizza&udm=7" },
    { "title": "Shopping", "href": "https://www.google.com/search?q=pizza&tbm=shop" }
  ],
  "navigation_tabs": [
    { "title": "All", "link": "https://www.google.com/search?q=pizza" },
    { "title": "Images", "link": "https://www.google.com/search?q=pizza&udm=2" }
  ],
  "navigation_filters": [
    {
      "title": "Any time",
      "is_active": true,
      "has_popup": true,
      "popup_items": [
        { "title": "Past hour", "is_active": false },
        { "title": "Past 24 hours", "is_active": false },
        { "title": "Past week", "is_active": false },
        { "title": "Past month", "is_active": false },
        { "title": "Past year", "is_active": false }
      ]
    }
  ],
  "chips": [
    { "label": "pizza dough", "link": "https://www.google.com/search?q=pizza+dough", "image_url": "https://example.com/chips/dough.jpg" },
    { "label": "pizza near me", "link": "https://www.google.com/search?q=pizza+near+me", "image_url": "https://example.com/chips/nearby.jpg" },
    { "label": "pizza recipes", "link": "https://www.google.com/search?q=pizza+recipes", "image_url": "https://example.com/chips/recipes.jpg" }
  ],
  "top_ads": [
    {
      "title": "Order Pizza Online — Fast Delivery Guaranteed",
      "link": "https://www.example-pizza-ad.com/order",
      "display_link": "www.example-pizza-ad.com",
      "referral_link": "https://www.example-pizza-ad.com/ref=google",
      "description": "Hot fresh pizza delivered to your door in 30 minutes or less. Order now.",
      "extensions": [
        { "type": "site_link", "text": "Order Now", "link": "https://www.example-pizza-ad.com/order", "extended": false },
        { "type": "site_link", "text": "Deals", "link": "https://www.example-pizza-ad.com/deals", "extended": false }
      ],
      "global_rank": 1
    }
  ],
  "featured_snippets": [
    {
      "type": "paragraph",
      "title": "What is pizza?",
      "description": "Pizza is a dish of Italian origin consisting of a usually round, flat base of leavened wheat-based dough topped with tomatoes, cheese, and often various other ingredients.",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "display_link": "en.wikipedia.org › wiki › Pizza",
      "source": "Wikipedia",
      "global_rank": 2
    }
  ],
  "ai_overview": {
    "texts": [
      {
        "type": "paragraph",
        "snippet": "Pizza is one of the world's most popular foods, originating in Naples, Italy. It typically consists of a leavened dough base topped with tomato sauce, mozzarella cheese, and a variety of toppings.",
        "links": [
          { "text": "History of pizza", "link": "https://en.wikipedia.org/wiki/History_of_pizza" }
        ],
        "reference_indexes": [0, 1]
      },
      {
        "type": "list",
        "snippet": "Common pizza styles include:",
        "list": [
          { "type": "paragraph", "snippet": "Neapolitan — thin, soft crust, simple toppings" },
          { "type": "paragraph", "snippet": "New York-style — large, foldable slices" },
          { "type": "paragraph", "snippet": "Chicago deep dish — thick crust, layered toppings" }
        ],
        "reference_indexes": [2]
      }
    ],
    "references": [
      { "index": 0, "href": "https://en.wikipedia.org/wiki/Pizza", "title": "Pizza - Wikipedia", "source": "Wikipedia" },
      { "index": 1, "href": "https://en.wikipedia.org/wiki/History_of_pizza", "title": "History of pizza", "source": "Wikipedia" },
      { "index": 2, "href": "https://www.example-food.com/pizza-styles", "title": "Pizza Styles Around the World", "source": "Example Food" }
    ],
    "global_rank": 3
  },
  "organic": [
    {
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "amp_link": "https://en.m.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "display_link": "en.wikipedia.org › wiki › Pizza",
      "source": "Wikipedia",
      "description": "Pizza is an Italian dish consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature.",
      "snippet_highlighted_words": ["Pizza", "Italian", "dough"],
      "icon": "https://en.wikipedia.org/favicon.ico",
      "extensions": [
        { "type": "site_link", "text": "Neapolitan pizza", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza", "extended": false, "inline": false },
        { "type": "site_link", "text": "Pizzeria", "link": "https://en.wikipedia.org/wiki/Pizzeria", "extended": false, "inline": false },
        { "type": "site_link", "text": "Pizza Margherita", "link": "https://en.wikipedia.org/wiki/Pizza_Margherita", "extended": false, "inline": false }
      ],
      "global_rank": 4
    },
    {
      "link": "https://www.pizzahut.com/",
      "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
      "display_link": "www.pizzahut.com",
      "source": "Pizza Hut",
      "description": "Order pizza online for fast delivery or carryout from a store near you. View our full menu, nutritional information, store locations, and more.",
      "snippet_highlighted_words": ["pizza"],
      "icon": "https://www.pizzahut.com/favicon.ico",
      "extensions": [
        { "type": "site_link", "text": "Menu", "link": "https://www.pizzahut.com/menu", "extended": false, "inline": false },
        { "type": "site_link", "text": "Locations", "link": "https://www.pizzahut.com/locations", "extended": false, "inline": false }
      ],
      "global_rank": 5
    },
    {
      "link": "https://www.dominos.com/",
      "title": "Domino's Pizza - Order Online for Delivery or Carryout",
      "display_link": "www.dominos.com",
      "source": "Domino's",
      "description": "Order Domino's pizza online for delivery or carryout. Find deals, coupons, and track your order in real time.",
      "snippet_highlighted_words": ["pizza"],
      "icon": "https://www.dominos.com/favicon.ico",
      "extensions": [],
      "global_rank": 6
    },
    {
      "link": "https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps",
      "title": "Pizza Margherita in 4 easy steps",
      "display_link": "www.bbcgoodfood.com › recipes",
      "source": "BBC Good Food",
      "description": "Even a novice cook can master the art of perfect pizza with our step-by-step guide to making a classic Margherita.",
      "snippet_highlighted_words": ["pizza", "Margherita"],
      "icon": "https://www.bbcgoodfood.com/favicon.ico",
      "extensions": [],
      "global_rank": 7
    }
  ],
  "videos": [
    {
      "title": "How to Make Perfect Homemade Pizza",
      "link": "https://www.youtube.com/watch?v=abc123",
      "source": "YouTube",
      "date": "2025-11-01",
      "duration": "12:34",
      "duration_sec": 754,
      "image": "https://i.ytimg.com/vi/abc123/hqdefault.jpg",
      "key_moments": [
        { "title": "Making the dough", "link": "https://www.youtube.com/watch?v=abc123&t=30", "start": "0:30", "start_sec": 30, "image": "https://i.ytimg.com/vi/abc123/moment1.jpg" },
        { "title": "Adding toppings", "link": "https://www.youtube.com/watch?v=abc123&t=480", "start": "8:00", "start_sec": 480, "image": "https://i.ytimg.com/vi/abc123/moment2.jpg" }
      ],
      "global_rank": 8
    },
    {
      "title": "Classic New York Pizza At Home",
      "link": "https://www.youtube.com/watch?v=def456",
      "source": "YouTube",
      "date": "2025-09-15",
      "duration": "9:45",
      "duration_sec": 585,
      "image": "https://i.ytimg.com/vi/def456/hqdefault.jpg",
      "key_moments": [],
      "global_rank": 9
    }
  ],
  "top_stories": {
    "items": [
      {
        "title": "NYC Pizza Festival Returns for Its Biggest Year Yet",
        "link": "https://www.example-news.com/nyc-pizza-festival-2026",
        "source": "Example News",
        "source_logo": "https://www.example-news.com/logo.png",
        "date": "2 hours ago",
        "image": "https://www.example-news.com/images/pizza-festival.jpg",
        "global_rank": 10
      },
      {
        "title": "The Science Behind the Perfect Pizza Crust",
        "link": "https://www.another-outlet.com/pizza-crust-science",
        "source": "Another Outlet",
        "source_logo": "https://www.another-outlet.com/logo.png",
        "date": "5 hours ago",
        "image": "https://www.another-outlet.com/images/pizza-crust.jpg",
        "global_rank": 11
      }
    ]
  },
  "images": [
    {
      "title": "Classic Margherita Pizza",
      "link": "https://www.example-recipe.com/margherita",
      "source": "Example Recipe",
      "source_logo": "https://www.example-recipe.com/logo.png",
      "original_image": "https://www.example-recipe.com/images/margherita-full.jpg",
      "image": "https://www.example-recipe.com/images/margherita-thumb.jpg",
      "global_rank": 12
    },
    {
      "title": "Neapolitan Pizza with Fresh Basil",
      "link": "https://www.example-food.com/neapolitan",
      "source": "Example Food",
      "source_logo": "https://www.example-food.com/logo.png",
      "original_image": "https://www.example-food.com/images/neapolitan-full.jpg",
      "image": "https://www.example-food.com/images/neapolitan-thumb.jpg",
      "global_rank": 13
    }
  ],
  "shopping": [
    {
      "title": "Ooni Koda 16 Gas Powered Pizza Oven",
      "link": "https://www.example-store.com/ooni-koda-16",
      "shop_link": "https://www.example-store.com",
      "description": "Gas-powered outdoor pizza oven. Reaches 950°F in 20 minutes.",
      "price": "$599.00",
      "old_price": "$699.00",
      "shop": "Example Store",
      "shipping": "Free shipping",
      "rating": 4.8,
      "reviews_cnt": 3120,
      "trusted_store": true,
      "image": "https://www.example-store.com/images/ooni-koda.jpg",
      "global_rank": 14
    },
    {
      "title": "Pizza Stone for Oven and Grill",
      "link": "https://www.another-store.com/pizza-stone",
      "shop_link": "https://www.another-store.com",
      "description": "14-inch cordierite pizza stone, evenly distributes heat for a crispy crust.",
      "price": "$34.99",
      "shop": "Another Store",
      "shipping": "$4.99 shipping",
      "rating": 4.6,
      "reviews_cnt": 8740,
      "trusted_store": false,
      "image": "https://www.another-store.com/images/pizza-stone.jpg",
      "global_rank": 15
    }
  ],
  "top_pla": [
    {
      "title": "Ooni Fyra 12 Wood Pellet Pizza Oven",
      "link": "https://www.example-shop.com/ooni-fyra",
      "referral_link": "https://www.example-shop.com/ref=gpla",
      "price": "$349.00",
      "old_price": "$399.00",
      "shop": "Example Shop",
      "shipping": "Free shipping",
      "rating": 4.7,
      "reviews_cnt": 2340,
      "image": "https://www.example-shop.com/images/ooni-fyra.jpg",
      "global_rank": 16
    }
  ],
  "knowledge": {
    "title": "Pizza",
    "subtitle": "Dish",
    "type": "Food",
    "description": "Pizza is a dish of Italian origin consisting of a usually round, flat base of leavened wheat-based dough topped with tomatoes, cheese, and often various other ingredients.",
    "description_source": "Wikipedia",
    "description_link": "https://en.wikipedia.org/wiki/Pizza",
    "kgmid": "/m/0663v",
    "link": "https://en.wikipedia.org/wiki/Pizza",
    "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a3/Eq_it-na_pizza-margherita_sep2005_sml.jpg/220px.jpg",
    "facts": [
      { "predicate": "Place of origin", "title": "Place of origin", "value": "Naples, Italy", "link": "https://en.wikipedia.org/wiki/Naples" },
      { "predicate": "Main ingredients", "title": "Main ingredients", "value": "Dough, tomato sauce, cheese, toppings", "link": "" },
      { "predicate": "Serving temperature", "title": "Serving temperature", "value": "Hot", "link": "" }
    ],
    "widgets": [
      {
        "type": "list",
        "key": "Variations",
        "predicate": "Variations",
        "title": "Popular variations",
        "items": [
          { "title": "Neapolitan pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/Neapolitan_pizza" },
          { "title": "New York-style pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/New_York-style_pizza" },
          { "title": "Chicago-style pizza", "subtitle": "Pizza style", "link": "https://en.wikipedia.org/wiki/Chicago-style_pizza" }
        ]
      }
    ]
  },
  "people_also_ask": [
    {
      "question": "What is the most popular pizza topping?",
      "answer": "Pepperoni is the most popular pizza topping in the United States, appearing on approximately 36% of all pizzas ordered.",
      "link": "https://www.example-food.com/popular-pizza-toppings",
      "title": "Most Popular Pizza Toppings in America",
      "display_link": "www.example-food.com",
      "global_rank": 17
    },
    {
      "question": "Where was pizza invented?",
      "answer": "Pizza was invented in Naples, Italy. The modern pizza with tomato sauce and mozzarella is believed to have originated there in the 18th or early 19th century.",
      "link": "https://en.wikipedia.org/wiki/Pizza",
      "title": "Pizza - Wikipedia",
      "display_link": "en.wikipedia.org",
      "global_rank": 18
    }
  ],
  "snack_pack_map": {
    "image": "https://maps.googleapis.com/maps/api/staticmap?center=40.7128,-74.0060&zoom=13",
    "link": "https://www.google.com/maps/search/pizza+near+me",
    "lat": "40.7128",
    "lng": "-74.0060"
  },
  "snack_pack": [
    {
      "name": "Joe's Pizza",
      "link": "https://www.joespizzanyc.com",
      "cid": "12345678901234567",
      "rating": 4.7,
      "reviews_cnt": 5230,
      "type": "Pizza restaurant",
      "price": "$",
      "phone": "+1 212-366-1182",
      "address": "7 Carmine St, New York, NY 10014",
      "work_status": "Open",
      "work_status_details": "Open until 4:00 AM",
      "maps_link": "https://www.google.com/maps/place/Joe%27s+Pizza",
      "sponsored": false,
      "tags": ["Dine-in", "Takeaway", "No delivery"],
      "global_rank": 19
    },
    {
      "name": "Grimaldi's Pizzeria",
      "link": "https://www.grimaldis-pizza.com",
      "cid": "98765432109876543",
      "rating": 4.5,
      "reviews_cnt": 8910,
      "type": "Pizza restaurant",
      "price": "$$",
      "phone": "+1 718-858-4300",
      "address": "1 Front St, Brooklyn, NY 11201",
      "work_status": "Open",
      "work_status_details": "Open until 10:00 PM",
      "maps_link": "https://www.google.com/maps/place/Grimaldi%27s+Pizzeria",
      "sponsored": false,
      "tags": ["Dine-in", "Takeaway"],
      "global_rank": 20
    }
  ],
  "recipes": {
    "title": "Pizza recipes",
    "items": [
      {
        "title": "Classic Margherita Pizza",
        "link": "https://www.bbcgoodfood.com/recipes/pizza-margherita",
        "rating": 4.8,
        "reviews_cnt": 1240,
        "source": "BBC Good Food",
        "cook_time": "25 mins",
        "ingredients": ["pizza dough", "tomato sauce", "mozzarella", "fresh basil", "olive oil"],
        "image": "https://www.bbcgoodfood.com/images/margherita.jpg"
      },
      {
        "title": "Easy Pepperoni Pizza",
        "link": "https://www.example-recipe.com/pepperoni-pizza",
        "rating": 4.6,
        "reviews_cnt": 890,
        "source": "Example Recipe",
        "cook_time": "30 mins",
        "ingredients": ["pizza dough", "tomato sauce", "mozzarella", "pepperoni", "oregano"],
        "image": "https://www.example-recipe.com/images/pepperoni.jpg"
      }
    ]
  },
  "popular_products": {
    "title": "Popular pizza-related products",
    "items": [
      {
        "title": "Ooni Koda 16 Pizza Oven",
        "price": "$599.00",
        "link": "https://www.example-store.com/ooni-koda-16",
        "rating": 4.8,
        "reviews_cnt": 3120,
        "features": ["Gas powered", "Reaches 950°F", "16-inch capacity"],
        "image": "https://www.example-store.com/images/ooni-koda.jpg"
      }
    ]
  },
  "perspectives": [
    {
      "title": "Why Neapolitan Pizza is the Gold Standard",
      "author": "John Smith",
      "source": "Reddit",
      "text": "After trying pizza across 12 countries, I keep coming back to true Neapolitan pizza. The simplicity of the ingredients and the high-heat cooking is unmatched.",
      "date": "2026-03-10",
      "link": "https://www.reddit.com/r/pizza/comments/example",
      "image": "https://www.reddit.com/images/pizza-post.jpg",
      "global_rank": 21
    }
  ],
  "forums": {
    "items": [
      {
        "title": "What makes a great pizza dough?",
        "source": "Reddit",
        "subtitles": ["r/pizza", "452 comments"],
        "link": "https://www.reddit.com/r/pizza/comments/dough-question",
        "answers": [
          { "text": "High protein flour, long cold fermentation, and proper hydration are the three keys.", "link": "https://www.reddit.com/r/pizza/comments/dough-question/answer1", "is_top_answer": true },
          { "text": "Don't overwork the dough and let it rest at room temperature before stretching.", "link": "https://www.reddit.com/r/pizza/comments/dough-question/answer2", "is_top_answer": false }
        ]
      }
    ]
  },
  "related": [
    { "text": "pizza dough recipe", "link": "https://www.google.com/search?q=pizza+dough+recipe", "expanded": false },
    { "text": "pizza near me", "link": "https://www.google.com/search?q=pizza+near+me", "expanded": false },
    { "text": "best pizza in New York", "link": "https://www.google.com/search?q=best+pizza+in+new+york", "expanded": false },
    { "text": "homemade pizza", "link": "https://www.google.com/search?q=homemade+pizza", "expanded": false }
  ],
  "spelling": {
    "original_text": "pizza",
    "original_link": "https://www.google.com/search?q=pizza",
    "original_empty": false,
    "auto_corrected_text": "",
    "auto_corrected_link": "",
    "suggested_text": "",
    "suggested_link": ""
  },
  "pagination": {
    "current_page": 1,
    "next_page": 2,
    "next_page_start": 10,
    "next_page_link": "https://www.google.com/search?q=pizza&start=10",
    "pages": [
      { "page": 1, "start": 0, "link": "https://www.google.com/search?q=pizza" },
      { "page": 2, "start": 10, "link": "https://www.google.com/search?q=pizza&start=10" },
      { "page": 3, "start": 20, "link": "https://www.google.com/search?q=pizza&start=20" }
    ]
  },
  "bottom_ads": [
    {
      "title": "Best Pizza Deals Online — Order Now",
      "link": "https://www.example-pizza-ad2.com/order",
      "display_link": "www.example-pizza-ad2.com",
      "referral_link": "https://www.example-pizza-ad2.com/ref=google",
      "description": "Find the best pizza deals in your area. Fast delivery, great prices.",
      "extensions": [],
      "global_rank": 22
    }
  ]
}
```


# Bing to Bright Data SERP migration guide
Source: https://docs.brightdata.com/products/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide

Migrate from the retired Microsoft Bing Search API to the Bright Data SERP API (31 languages) for Bing. Step-by-step request mapping and response examples.

<Warning>
  [Microsoft Bing Search APIs retiring on August 11, 2025](https://learn.microsoft.com/en-us/lifecycle/announcements/bing-search-api-retirement). Bright Data SERP API for Bing domain continues to be supported.
</Warning>

<Info>
  **Migration benefits**

  * Drop-in replacement with minimal code changes
  * 1:1 compatible JSON response schema
  * Enhanced request flexibility supporting both query-based and URL-based requests
</Info>

## Quick start migration (5 Minutes)

<Steps>
  <Step title="Get your API Key">
    [Sign up for Bright Data](https://brightdata.com/?hs_signup=1\&utm_source=docs) and get your API key from the dashboard.
  </Step>

  <Step title="Update your endpoint">
    Replace `api.bing.microsoft.com` with `api.brightdata.com/request`
  </Step>

  <Step title="Add parameters in body & test your first request">
    ```bash theme={null}
    curl -X POST 'https://api.brightdata.com/request' \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "search_engine": "bing",
        "query": "test search",
        "data_format": "parsed_bing_api",
        "format": "json",
        "zone": "your_zone_name_"
      }'
    ```
  </Step>
</Steps>

## Step-by-step migration guide

### Step 1: Account setup

<AccordionGroup>
  <Accordion title="1.1 Create Bright Data account">
    1. Visit [brightdata.com/signup](https://brightdata.com/?hs_signup=1\&utm_source=docs)
    2. Navigate to **Zones** → **Create Zone** → **SERP API**
    3. Copy your API key credentials
  </Accordion>

  <Accordion title="1.2 Configure Authentication">
    Replace your Bing API key with Bright Data credentials:

    **Before (Bing):**

    ```http theme={null}
    Ocp-Apim-Subscription-Key: YOUR_BING_KEY
    ```

    **After (Bright Data):**

    ```http theme={null}
    Authorization: Bearer YOUR_API_KEY
    ```
  </Accordion>
</AccordionGroup>

### Step 2: Update request format

<Tabs>
  <Tab title="cURL">
    **Before (Bing API):**

    ```bash theme={null}
    curl -X GET "https://api.bing.microsoft.com/v7.0/search?q=openai" \
      -H "Ocp-Apim-Subscription-Key: YOUR_BING_KEY"
    ```

    **After (Bright Data):**

    ```bash theme={null}
    curl -X POST "https://api.brightdata.com/request" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "search_engine": "bing",
        "query": "openai",
        "data_format": "parsed_bing_api",
        "format": "json",
        "zone": "your_zone_name"
      }'
    ```
  </Tab>

  <Tab title="Python">
    **Before (Bing API):**

    ```python theme={null}
    import requests

    headers = {
        'Ocp-Apim-Subscription-Key': 'YOUR_BING_KEY'
    }

    response = requests.get(
        'https://api.bing.microsoft.com/v7.0/search',
        headers=headers,
        params={'q': 'openai'}
    )
    ```

    **After (Bright Data):**

    ```python theme={null}
    import requests

    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }

    payload = {
        'search_engine': 'bing',
        'query': 'openai',
        'data_format': 'parsed_bing_api',
        'format': 'json',
        'zone': 'your_zone_name'
    }

    response = requests.post(
        'https://api.brightdata.com/request',
        headers=headers,
        json=payload
    )
    ```
  </Tab>

  <Tab title="Node.js">
    **Before (Bing API):**

    ```javascript theme={null}
    const axios = require('axios');

    const response = await axios.get(
        'https://api.bing.microsoft.com/v7.0/search',
        {
            headers: {
                'Ocp-Apim-Subscription-Key': 'YOUR_BING_KEY'
            },
            params: { q: 'openai' }
        }
    );
    ```

    **After (Bright Data):**

    ```javascript theme={null}
    const axios = require('axios');

    const response = await axios.post(
        'https://api.brightdata.com/request',
        {
            search_engine: 'bing',
            query: 'openai',
            data_format: 'parsed_bing_api',
            format: 'json',
            zone: 'your_zone_name'
        },
        {
            headers: {
                'Authorization': 'Bearer YOUR_API_KEY',
                'Content-Type': 'application/json'
            }
        }
    );
    ```
  </Tab>
</Tabs>

### Step 3: Handle response format

The response format remains identical to Bing's API when using `data_format: "parsed_bing_api"`:

<CodeGroup>
  ```json Response Structure theme={null}
  {
    "_type": "SearchResponse",
    "queryContext": {
      "originalQuery": "openai"
    },
    "webPages": {
      "totalEstimatedMatches": 12300000,
      "value": [
        {
          "name": "OpenAI",
          "url": "https://openai.com/",
          "displayUrl": "openai.com",
          "snippet": "OpenAI is an AI research and deployment company..."
        }
      ]
    },
    "images": { "value": [...] },
    "videos": { "value": [...] },
    "relatedSearches": { "value": [...] }
  }
  ```

  ```python Parse Results theme={null}
  # Your existing Bing API parsing code works unchanged
  data = response.json()

  # Extract web results
  web_results = data.get('webPages', {}).get('value', [])
  for result in web_results:
      print(f"Title: {result['name']}")
      print(f"URL: {result['url']}")
      print(f"Snippet: {result['snippet']}")

  # Extract images
  images = data.get('images', {}).get('value', [])
  for image in images:
      print(f"Image: {image['thumbnailUrl']}")
  ```
</CodeGroup>


# SERP pricing & billing
Source: https://docs.brightdata.com/products/serp-api/pricing-and-billing

Bright Data SERP API pricing: per-1,000 successful requests with parsing and unlocking included, no bandwidth fees and failed requests not billed.

Bright Data SERP API uses **per‑1,000 successful requests** pricing. Failed/errored requests are not billed. Parsing and unlocking are included, no bandwidth fees.

> * Billing unit: per successful request (per 1,000)
> * Parsing/unlocking included (no bandwidth fees)
> * Async: “send request” billed; “collect/retrieve” free

[Bright Data SERP API price tiers and volume discounts](https://brightdata.com/pricing/serp?utm_source=docs\&utm_medium=pricing-billing\&utm_campaign=serp_pricing)

## Pay per success

By default, Bright Data bills **only successful responses**.

* Unit: per 1,000 successful requests
* Included: parsing (JSON/Markdown/HTML), proxy management, and unlocking/CAPTCHA handling
* No bandwidth fees

If a request is retried behind the scenes, you’re **not** charged extra. Only the successfully delivered response is billed.

<Warning>
  **Custom headers and cookies change the billing model.** When custom headers or cookies are selected for a SERP API zone, **all requests are billed, including failed or errored requests**. Without customized headers or cookies, the default pay-per-success model applies.

  See [Custom Headers and Cookies](/products/serp-api/configuration#custom-headers-and-cookies) for configuration and billing details.
</Warning>

***

## How async billing works

Use asynchronous mode for long‑running jobs or large batches.

* **Billed**: the initial “send request” call
* **Not billed**: the follow‑up “collect/retrieve” call

See: [Asynchronous Requests](/products/serp-api/asynchronous-requests)

***

## What’s included in the unit price

* Structured outputs: **JSON**, **Markdown**, or **raw HTML**
* Proxy management & **unlocking** (incl. CAPTCHA handling)
* Automatic retries and best header/device logic
* City/ZIP geotargeting; **desktop and mobile** user agents

***

## FAQs

**Are failed or errored requests billed?**<br />By default, no. Failed or errored requests are not billed when using the standard SERP API configuration. However, when custom headers or cookies are selected for the zone, **all requests are billed regardless of their outcome**. See [Custom Headers and Cookies](/products/serp-api/configuration#custom-headers-and-cookies).

**Are retries or async “collect” requests billed?**<br />Automatic retries are included. In async mode, the initial “send request” call is billed, while the follow-up “collect/retrieve” call is not billed.

**Is parsing included?**<br />Yes. JSON, Markdown, and HTML outputs are included in the unit price.

**Do you charge bandwidth fees?**<br />No. There are no bandwidth fees. Billing is per successful request by default. If custom headers or cookies are selected, all requests are billed, including failed or errored requests.

***

## See also

* [SERP pricing](https://brightdata.com/pricing/serp?utm_source=docs\&utm_medium=pricing-billing\&utm_campaign=serp_pricing)
* [Introduction to SERP API](/products/serp-api/introduction)
* [Asynchronous Requests](/products/serp-api/asynchronous-requests)
* [Parsed JSON Results](/products/serp-api/parsed-json-results)


# SERP API Bing query parameters
Source: https://docs.brightdata.com/products/serp-api/query-parameters/bing

Configure Bing search queries on the Bright Data SERP API with parameters for localization, geo, pagination, device targeting and custom output.

<Warning>
  [Microsoft Bing Search APIs retiring on August 11, 2025](https://learn.microsoft.com/en-us/lifecycle/announcements/bing-search-api-retirement). Bright Data SERP API for Bing domain continues to be supported.
  [Bing API to Bright Data SERP API migration guide](/products/serp-api/parsed-json-results/bing-to-bright-data-serp-migration-guide).
</Warning>

## Search

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `setLang`

    A language to use for user interface strings. You may specify the language using either a 2-letter or 4-letter code. Using 4-letter codes is preferred.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&setLang=en-US"
    ```
  </Accordion>

  <Accordion title="Geo-Location" icon="location-dot">
    ### `location`

    A location for the search origin. Should be used together with `lat` (latitude) and `lon` (longitude) parameters.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&location=New+York%2C+New+York%2C+United+States&lat=40.7001958&lon=-74.1087142"
    ```

    ### `cc`

    A 2-character country code of the country where the results come from.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&cc=us"
    ```

    ### `mkt`

    A market where the search results come from.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&mkt=en-US"
    ```
  </Accordion>

  <Accordion title="Pagination" icon="file">
    ### `count`

    This attibute was deprecated by bing and is no longer supported.

    ### `first`

    An offset that indicates the number of search results to skip before returning results. The default value is 1.

    Use this parameter along with the `count` parameter to page results. For example, set `count` to 10 and `first` to 1 to get the first page of results.
    For each subsequent page, increment `first` by 10 (for example, 1, 11, 21).
    It is possible for multiple pages to include some overlap in results.

    > #### Examples:
    >
    > `first=1` (default) - first page of results \
    > `first=11` - second page of results \
    > `first=21` - third page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&first=11"
    ```
  </Accordion>

  <Accordion title="Filters" icon="filter">
    ### `safesearch`

    Used to filter webpages, images, and videos for adult content.

    > **The following are the possible filter values:** \
    > `safesearch=off`, Returns content with adult text and images but not adult videos \
    > `safesearch=moderate`, Returns webpages with adult text, but not adult images or videos \
    > `safesearch=strict`, Does not return adult text, images, or videos

    The default is Moderate.

    NOTE: If the request comes from a market that Bing's adult policy requires that safeSearch be set to Strict, Bing ignores the safesearch value and uses Strict.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&safesearch=off"
    ```
  </Accordion>

  <Accordion title="Device" icon="mobile-screen-button">
    ### `brd_mobile`

    Define what device type to be represented in user-agent

    Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

    > **For specific mobile platform provide one of the following values:** \
    > `brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) \
    > `brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) \
    > `brd_mobile=android` - Android phone \
    > `brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&brd_mobile=1"
    ```
  </Accordion>

  <Accordion title="Browser" icon="table-columns">
    ### `brd_browser`

    Define what browser to be represented in user-agent. \
    Can be combined with `brd_mobile` to get according mobile browser. \
    Default will provide random browser.

    > **For specific browser provide one of the following values:** \
    > `brd_browser=chrome` - Google Chrome \
    > `brd_browser=safari` - Safari \
    > `brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.bing.com/search?q=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# SERP API DuckDuckGo query parameters
Source: https://docs.brightdata.com/products/serp-api/query-parameters/duckduckgo

Configure DuckDuckGo search queries on the Bright Data SERP API with parameters for localization, safe search, time range and device targeting.

## Search

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `kl`

    Country and language code used to define the country and language of search. See the [full list here](https://api.brightdata.com/serp/duckduckgo/kl_values).

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&kl=us-en"
    ```

    ### `kad`

    Language of the search page interface: buttons, menu. See the [full list here](https://api.brightdata.com/serp/duckduckgo/kad_values)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza"
    ```
  </Accordion>

  <Accordion title="Safe search" icon="shield">
    ### `kp`

    Removes adult content from search results.

    > **Available values are:** \
    > ` 1` - Turn on safe search \
    > `-1` - Moderate search content \
    > `-2` - Turn off safe search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&kp=1"
    ```
  </Accordion>

  <Accordion title="Time range" icon="calendar">
    ### `df`

    Time range to search.

    > **Available values are:** \
    > `d` - Past day \
    > `w` - Past week \
    > `m` - Past month \
    > `w` - Past year

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&df=d"
    ```
  </Accordion>

  <Accordion title="Device" icon="mobile-screen-button">
    ### `brd_mobile`

    Define what device type to be represented in user-agent

    Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

    > **For specific mobile platform provide one of the following values:** \
    > `brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) \
    > `brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) \
    > `brd_mobile=android` - Android phone \
    > `brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&brd_mobile=1"
    ```
  </Accordion>

  <Accordion title="Browser" icon="table-columns">
    ### `brd_browser`

    Define what browser to be represented in user-agent. \
    Can be combined with `brd_mobile` to get according mobile browser. \
    Default will provide random browser.

    > **For specific browser provide one of the following values:** \
    > `brd_browser=chrome` - Google Chrome \
    > `brd_browser=safari` - Safari \
    > `brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://duckduckgo.com/?q=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# SERP API Google query parameters
Source: https://docs.brightdata.com/products/serp-api/query-parameters/google

Configure the Bright Data SERP API (31 languages) for Google search, Maps, Trends, Reviews, Images, Lens, Hotels and Flights with parameters per access point.

## The Search URL

Bright Data uses advanced parsing and access logic to provide you reliable response of search results, as fast as possible. We require that your search prefix will not carry any arguments in the URL **before** the `q=` argument. Relaying arguments before the `q` argument may result in delays in response and lower success rate.

Example for correct URL with the `gl` argument appended for search results in the US:

```text theme={null}
https://www.google.com/search?q=pizza&gl=us
```

Example for **incorrect** URL, with `gl` argument preceding `q` argument.

```text theme={null}
https://www.google.com/search?gl=us&q=pizza
```

### How to search for a term comprised of multiple words?

When you issue the query, add a `+` character in between the words in your search term. So if you want to search for "pizza in paris" the search string should be: `pizza+in+paris`

```text theme={null}
https://www.google.com/search?q=pizza+in+paris
```

## Web search

### Query parameters

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    <Note>
      Google now serves all search results exclusively through `google.com` and as such, any **SERP API** request sent to a different Google TLD (e.g., `google.co.uk`, `google.ca`) will automatically be routed through `google.com`.

      **Localization** is no longer determined by the TLD and should instead be configured solely using the `gl` (country) and `hl` (language) query parameters below:
    </Note>

    ### `gl`

    Two-letter country code used to define the country of search

    ```sh gl theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> "https://www.google.com/maps/search/hotels+new+york/?gl=us"
    ```

    ***

    ### `hl`

    Two-letter language code used to define the page languages

    ```sh hl theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&hl=en"
    ```
  </Accordion>

  <Accordion title="Search type" icon="magnifying-glass">
    ### `tbm`

    Define search type. For regular search there is no need to use the `tbm` parameter while other types have a unique `tbm` value.

    > #### Example:
    >
    > `tbm=nws` - news <br />`tbm=vid` - videos <br />`tbm=lcl` - Google Places (local search results)

    <Note>
      For Image search, see the [Images](#images) section.
    </Note>

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=deli&hl=en&gl=us&tbm=lcl&uule=Charleston,South+Carolina,United+States&brd_json=1"
    ```

    ### `udm`

    > #### Example:
    >
    > `udm=1` - Google Places (local search results) <br />`udm=28` - shopping <br />`udm=39` - short videos

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=28"
    ```

    ### `ibp`

    Use the `ibp` parameter for Jobs search type.

    > #### Example:
    >
    > `ibp=htl;jobs` - Jobs

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs"
    ```

    ### `safe`

    Use the `safe` flag with values `active` or `off` to enable or disable safe search.

    > #### Example:
    >
    > `safe=active` - Safe search is ON `safe=off`    - Safe search is off

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&safe=active"
    ```
  </Accordion>

  <Accordion title="Time filtering" icon="clock">
    ### `tbs`

    Filter results by publication date. Use `tbs` rather than `after:` / `before:` operators inside the `q` string, which are more likely to trigger blocks.

    > #### Examples:
    >
    > `tbs=qdr:h` - past hour <br />`tbs=qdr:d` - past 24 hours <br />`tbs=qdr:w` - past week <br />`tbs=qdr:m` - past month <br />`tbs=qdr:y` - past year

    ```sh theme={null}
    curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/search?q=pizza&brd_json=1&tbs=qdr:d"
    ```

    <Warning>
      Any `tbs` value containing `li:1` is rejected on all SERP API endpoints - including combined values such as `tbs=qdr:d,li:1` and percent-encoded forms. It causes a high CAPTCHA rate and is blocked for all accounts. Requests using it fail with:

      ```text theme={null}
      HTTP 400
      X-Brd-Error-Code: invalid_query
      X-Brd-Error: li:1 is forbidden due to high captcha rate
      ```
    </Warning>
  </Accordion>

  <Accordion title="Pagination" icon="file">
    ### `start`

    Define the result offset - results to start from the selected value. Used for managing pagination.

    > #### Examples:
    >
    > `start=0` (default) - first page of results <br />`start=10` - second page of results <br />`start=20` - third page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&start=20"
    ```

    ***

    ### `num`

    <Warning>
      **Deprecated by Google on September 11, 2025.** The `num` parameter no longer sets how many Google results are returned.

      * Google now returns about 10 results per page. The result set size can vary.
      * Use the `start` parameter to paginate through the result set.
      * To get the top 100 results in one request, use the [Get Top 100 Google Results](/products/serp-api/get-top-100-google-results) feature.
    </Warning>
  </Accordion>

  <Accordion title="Geo-Location" icon="location-dot">
    ### `uule`

    Stands for the encoded location you want to use for your search and will be used to change geo-location. A CSV with all available `uule` values can be [downloaded here](https://developers.google.com/adwords/api/docs/appendix/geotargeting).

    The value of column "Canonical Name" from the CSV can be used as a raw string to the API

    > #### Example:
    >
    > `&uule=New+York,New+York,United+States`

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw"

    ```

    #### Using geographic coordinates for location <Badge>BETA</Badge>

    You can provide a set of `latitude` , `longitude` and `radius` as uule parameters, and Bright Data will compose the closest possible uule encoded location for you.

    The format is `uule=lat,lon,radius`

    > #### Example - searching pizza with Eiffel Tower coordinates: `Lat=48.8584`,  `lon=2.2945` and `radius=200`:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&uule=48.8584,2.2945,200" 
    ```
  </Accordion>

  <Accordion title="Device" icon="mobile-screen-button">
    ### `brd_mobile`

    Define what device type to be represented in user-agent. <br />Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

    > **For specific mobile platform provide one of the following values:** <br />`brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) <br />`brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) <br />`brd_mobile=android` - Android phone <br />`brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&brd_mobile=1"
    ```
  </Accordion>

  <Accordion title="Browser" icon="table-columns">
    ### `brd_browser`

    Define what browser to be represented in user-agent. <br />Can be combined with `brd_mobile` to get according mobile browser. <br />Default will provide random browser.

    > **For specific browser provide one of the following values:** <br />`brd_browser=chrome` - Google Chrome <br />`brd_browser=safari` - Safari <br />`brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&brd_browser=chrome"
    ```
  </Accordion>

  <Accordion title="Hotel search" icon="buildings">
    ### `hotel_occupancy`

    Number of guests to book a room for (up to 4).

    <Note>
      See `brd_occupancy` parameter of Hotels which provides more flexibility.
    </Note>

    > #### Examples:
    >
    > `hotel_occupancy=1` - for 1 guest <br />`hotel_occupancy=2` (default) - for 2 guests

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&hotel_occupancy=4"
    ```

    ***

    ### `hotel_dates`

    Check-in date and check-out date, separated by comma.<br />Format: `YYYY-MM-DD,YYYY-MM-DD`

    > #### Examples:
    >
    > `hotel_dates=2022-05-01,2022-05-03` - find rooms available from 1st until 3rd of May, 2022

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&hotel_dates=2023-05-01%2C2023-05-03"
    ```
  </Accordion>

  <Accordion title="AI Overview" icon="brain">
    ### `brd_ai_overview`

    Setting `brd_ai_overview=2` will **increase** the likelihood of receiving Google's Generative AI Overviews in your SERP responses, typically appearing in \~15-20%+ of results.

    <Note>
      * Expect an extra \~5-10 seconds of latency in SERP API’s response time with this query parameter, as it launches a browser to capture the entire AI Overview content.
      * To better trigger an AI Overview, your SERP keywords must be relevant to topics that Google considers suitable for generative responses.
    </Note>

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2"
    ```

    ### Parsed AI Overviews Example

    <CodeGroup>
      ```sh Request: Parsed AIO theme={null}
      curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=does+honey+ever+expire&brd_json=1&brd_ai_overview=2"
      ```

      ```json Response: AIO exists theme={null}
      {
      //Displaying AIO field snippet below from within the full parsed JSON
        "ai_overview": {
          "texts": [
            {
              "type": "paragraph",
              "snippet": "To make the best pizza, focus on a good pizza dough, high heat baking, and fresh, high-quality toppings. Start with a slow fermentation for the dough, bake on a hot surface like a pizza stone or baking steel, and use fresh, quality toppings.",
              "snippet_highlighted_words": "focus on a good pizza dough, high heat baking, and fresh, high-quality toppings",
              "reference_indexes": [4, 5, 7, 9, 11, 12, 16]
            },
            {
              "type": "paragraph",
              "snippet": "Here's a more detailed breakdown:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "Slow Fermentation: . Opens in new tabAllow the dough to ferment for a longer period, ideally overnight in the refrigerator. This develops the flavor and makes the crust more chewy and crispy according to Serious Eats and Food & Wine.",
                  "reference_indexes": [2, 3, 6, 22]
                },
                {
                  "type": "paragraph",
                  "snippet": "Flour Selection: . Opens in new tabUse a combination of bread flour for strength and all-purpose flour for a nice rise.",
                  "reference_indexes": [14]
                },
                {
                  "type": "paragraph",
                  "snippet": "Dough Preparation: . Opens in new tabStretch the dough carefully to avoid overworking it, which can make it tough.",
                  "reference_indexes": [13]
                }
              ],
              "title": "1. Dough:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "High Heat: Preheat your oven to the highest temperature it can reach, ideally between 450°F and 500°F (232°C and 260°C).",
                  "reference_indexes": [9, 12]
                },
                {
                  "type": "paragraph",
                  "snippet": "Hot Baking Surface: Use a pizza stone or baking steel to distribute heat evenly and create a crispy crust.",
                  "reference_indexes": [9, 11]
                },
                {
                  "type": "paragraph",
                  "snippet": "Baking Time: Monitor the pizza closely and bake for 6-15 minutes, depending on the crust thickness and toppings.",
                  "reference_indexes": [9, 12, 17, 21, 23]
                }
              ],
              "title": "2. Baking:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "Layering: Start with the sauce, followed by a layer of cheese, then meats, and finally vegetables.",
                  "reference_indexes": [15]
                },
                {
                  "type": "paragraph",
                  "snippet": "Fresh Ingredients: Use fresh, high-quality ingredients for the sauce, cheese, and toppings.",
                  "reference_indexes": [0, 4, 18, 20]
                },
                {
                  "type": "paragraph",
                  "snippet": "Pre-Cooked Toppings: Pre-cook toppings like sausage and vegetables that may not cook completely in the short baking time.",
                  "reference_indexes": [10]
                },
                {
                  "type": "paragraph",
                  "snippet": "Sauce: Consider using a simple sauce made with fresh crushed tomatoes, garlic, basil, olive oil, and spices.",
                  "reference_indexes": [0, 4]
                },
                {
                  "type": "paragraph",
                  "snippet": "Cheese: Consider using a combination of low-moisture mozzarella for melting and fresh mozzarella for flavor.",
                  "reference_indexes": [4]
                }
              ],
              "title": "3. Toppings:"
            },
            {
              "type": "list",
              "list": [
                {
                  "type": "paragraph",
                  "snippet": "Dough Storage: Store the dough in a bowl, oiled to prevent sticking, and covered tightly with plastic wrap.",
                  "reference_indexes": [2]
                },
                {
                  "type": "paragraph",
                  "snippet": "Crust: Consider using a baking stone, cast-iron griddle, or perforated pizza pan for a crispier crust.",
                  "reference_indexes": [8, 11]
                },
                {
                  "type": "paragraph",
                  "snippet": "Tossing Dough: For a more professional look, consider using the dough tossing technique.",
                  "reference_indexes": [1, 19, 24]
                }
              ],
              "title": "4. Optional but Recommended:"
            },
            {
              "type": "paragraph",
              "snippet": "This video demonstrates 5 pro chef secrets to the perfect pizza: 57sBigger Bolder Baking with Gemma StaffordYouTube · Jul 18, 2019",
              "image": {
                "image": "https://i.ytimg.com/vi/0hqLSZPaThU/mqdefault.jpg?sqp=-oaymwEGCPgEEOQC&rs=AMzJL3ldq2W1-OGaL6qxskwJT0GAYMe_4w",
                "image_url": "https://i.ytimg.com/vi/0hqLSZPaThU/mqdefault.jpg?sqp=-oaymwEGCPgEEOQC&rs=AMzJL3ldq2W1-OGaL6qxskwJT0GAYMe_4w"
              }
            }
          ],
          "references": [
            {
              "href": "https://www.youtube.com/watch?v=mRx_odAj-XQ&t=147",
              "title": "The Best Pizza You'll Ever Make | Epicurious 101 - YouTube",
              "subtitle": "Apr 18, 2023 — and they have a ton of flavor as well i'm using crushed peeled tomatoes. you can use whole peeled or diced tomatoes. w...",
              "source": "YouTube · Epicurious",
              "index": 0
            }
            // ... more references follow
          ]
        }
      }
      ```

      ```js Response: AIO Doesn't exist theme={null}
      {
      //Returned within response headers, displayed when adding `-i` OR `-v` to your request

      `x-brd-warning: AI Overview did not appear on original SERP. Please ensure that you are using the brd_ai_overview=2 query parameter (https://docs.brightdata.com/products/serp-api/query-parameters/google#ai-overview), and that your query is relevant for triggering an AI Overview.`
      }
      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers (session pinning, output format, rate-limit info), see [SERP API features](/products/serp-api/features#request-headers-summary).

The most useful header for Google Web search is `x-unblock-data-format: parsed_light`, which returns a parsed JSON limited to the top 10 organic results with approximately 50% lower latency than full JSON parsing.

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/search?q=pizza"
```

## Maps

### Query parameters

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh gl theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?gl=us"
    ```

    ***

    ### `hl`

    Two-letter language code used to define the page languages

    ```sh hl theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?hl=en"
    ```
  </Accordion>

  <Accordion title="Coordinates" icon="location-dot">
    ### `geo params`

    Parameters defining GPS coordinates of a search location. It should be constructed the following way: `@ + latitude + , + longitude + , + zoom`.

    > #### Example:
    >
    > `@47.30227,1.67458,14.00z`

    <Tip>
      The `zoom` parameter is optional but recommended for higher precision. It ranges from 3z, map completely zoomed out - to 21z, map completely zoomed in
    </Tip>

    ```sh theme={null}
     curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z"
    ```
  </Accordion>

  <Accordion title="Pagination [Deprecated]" icon="file">
    <Warning>
      **Pagination parameters deprecated on December, 15th 2025.**
    </Warning>

    To get all google maps information use our [Scrapers](/products/scrapers/overview).  Our scrapers library includes a google maps scraper which covers the full data retrieved from a google maps search. Direct scraper link (requires login to Bright Data) [Google Maps Scraper API](/products/scrapers/overview). 

    ### `start `\[deprecated]

    Define the result offset - results to start from the selected value. Used for managing pagination.

    > #### Examples:
    >
    > `start=0` (default) - first page of results <br />`start=10` - second page of results <br />`start=20` - third page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?start=20"
    ```

    ***

    <Warning>
      **Deprecated by Google on September 11, 2025.** The `num` parameter no longer sets how many Google results are returned.

      * Google now returns about 10 results per page. The result set size can vary.
      * Use the `start` parameter to paginate through the result set.
      * To get the top 100 results in one request, use the [Get Top 100 Google Results](/products/serp-api/get-top-100-google-results) feature.
    </Warning>
  </Accordion>

  <Accordion title="Maps place overview" icon="buildings">
    ### `fid`

    Get the results of a Google Maps Place by `fid`.

    Use GET request on [http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s](http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s) with the `fid` value at the end.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a"
    ```
  </Accordion>

  <Accordion title="Sorting and filtering" icon="filter">
    ### `brd_accommodation_type`

    Accommodation type: Hotels or Vacation Rentals.

    > #### Examples:
    >
    > `brd_accommodation_type`=hotels (default) - search for Hotels <br />`brd_accommodation_type`=vacation\_rentals - search for Vacation Rentals

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals"
    ```
  </Accordion>

  <Accordion title="Output format" icon="magnifying-glass">
    ### `brd_json`

    Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

    > #### Examples:
    >
    > `brd_json=1` - return results in JSON <br />`brd_json=html` - return JSON with "html" field containing raw HTML

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?brd_json=1"
    ```
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/products/serp-api/features#request-headers-summary).

For Google Maps, set `x-unblock-data-format: parsed_light` to receive parsed JSON results with reduced latency:

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/maps/search/hotels+new+york/"
```

## Trends

**Required parameter**<br />`brd_json=1`: Returns parsed JSON results (Trends supports parsed results only).

<Warning>
  We support only the “Trending now” tab within Google Trends (`https://trends.google.com/trending`). Other tabs (e.g. "Explore", "Home") are not supported as they require login access for full functionality.
</Warning>

### Query parameters

<AccordionGroup>
  <Accordion title="Geo" icon="map-location-dot">
    ### `geo`

    Location of interest, two-letter country code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trending?geo=US&hours=24&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Time range" icon="calendar">
    ### `hours`

    Time window for trending searches.

    > **Available values are:**<br />`4` - Past 4 hours<br />`24` - Past 24 hours<br />`48` - Past 48 hours<br />`168` - Past 7 days

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trending?geo=US&hours=168&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Localization" icon="flag">
    ### `hl`

    Preferred language, two-letter language code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trending?geo=US&hours=24&hl=de&brd_json=1"
    ```
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/products/serp-api/features#request-headers-summary).

Google Trends responses are always parsed JSON when `brd_json=1` is set, so the `x-unblock-data-format` header is not needed for this endpoint. Use `x-brd-session: <session-id>` to pin requests to the same peer when running consecutive Trends queries.

## Reviews

<Warning>
  Update: Since 22-July-2026 reviews endpoint is not supported as google stopped servicing this endpoint and requests fail with a `502` error. Our teams are working to resolve the issue. All google reviews code examples below will fail when run with Bright Data SERP
</Warning>

### Query parameters

<AccordionGroup>
  <Accordion title="Feature id" icon="stars">
    ### `fid`

    Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.

    > #### For example:
    >
    > [https://www.google.com/search?q=hilton%20new%20york%20midtown](https://www.google.com/search?q=hilton%20new%20york%20midtown)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0"
    ```
  </Accordion>

  <Accordion title="Localization" icon="flag">
    ### `hl`

    Preferred language, two-letter language code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&hl=de"
    ```
  </Accordion>

  <Accordion title="Sorting and filtering" icon="filter">
    ### `sort`

    The way reviews are sorted.

    > **Possible values are:**<br />`sort=qualityScore` (default) - most relevant first<br />`sort=newestFirst` - newest first<br />`sort=ratingHigh` - highest rating first<br />`sort=ratingLow` - lowest rating first

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&sort=newestFirst"
    ```

    ### `filter`

    Filter keyword. Will respond with reviews that contain specified keyword only.

    > #### For Example:
    >
    > `filter=awesome` - search for reviews containing 'awesome' word

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&filter=awesome"
    ```
  </Accordion>

  <Accordion title="Pagination" icon="file">
    ### `start`

    Define the result offset - results to start from the selected value. Used for managing pagination.

    > #### Examples:
    >
    > `start=0` (default) - first page of results <br />`start=10` - second page of results <br />`start=20` - third page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&start=10"
    ```

    ### `num`

    <Warning>
      **Deprecated by Google on September 11, 2025.** The `num` parameter no longer sets how many Google results are returned.

      * Google now returns about 10 results per page. The result set size can vary.
      * Use the `start` parameter to paginate through the result set.
      * To get the top 100 results in one request, use the [Get Top 100 Google Results](/products/serp-api/get-top-100-google-results) feature.
    </Warning>
  </Accordion>

  <Accordion title="Sample Response" icon="brackets-curly">
    ```json expandable theme={null}
    {
      "reviews": [
        {
          "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
            "display_name": "DLSharpsteen",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "5/5",
          "created": "a month ago",
          "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXfHOWf_k3xFLr7N87GuvjsQHzsDSZb3FW1zjSl6LV32uKV4qI=s120-c-rp-mo-ba4-br100",
            "display_name": "Brian Ash",
            "link": "https://www.google.com/maps/contrib/109749787540014073287?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkQ4TU9uTTNuazJUWGoyZWtyN3Rrdnc%7C0dK0Oisp5f4%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "4/5",
          "created": "a month ago",
          "date": "2025-12-30",
          "comment": "The staff here were friendly and helpful. Everyone was cheerful and considerate. The staff here made our experience pleasant and memorable. The rooms were nice, but the location is perfect if you want to be in thick of the hustle and bustle of the city. Conveniently located, great facilities and a room rate that won’t break the bank. I wouldn’t hesitate to book again.",
          "review_reply": "Dear Brian,\nThank you for the wonderful review. We are glad to hear our team’s friendliness and positive energy helped make your stay pleasant and memorable. It is great to know you enjoyed the room, facilities, and our convenient location, along with a rate that added value to your visit. We truly appreciate your recommendation and look forward to welcoming you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "a month ago",
          "photos": [
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvvgQTSLWCQ056w1UnyiW-HQ8XlJcxFI9RPlNSPw_VjGFToRpXmZvl4zi-1EmutHol0y9EkjJNn7LOXgLtV3M-RZiUdzUcP-0K8jXXVbbJV__zujNJUalJNXk_8iiwT7XV4aLirkNDDr40",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvD_OHm_eM5-xlDtQ_JsJ2G1nFk-C6yxA8kPImAvVnoWEOpmKD-GITwiBPBKFTCXchntdML8EoT1Fwn5WTal5L6PKNOaX4qSVbDJngSeiEkpwX0AB538R2qQNNVSgWFIQ-zenCQzRf535iu",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvPerK2Ko2feiSaSqQCwOyOrUUqeaZw1UEgef_uhHDtHRf13LCTDbS75syJviepVU9D_rM6qZBaxF4PLP_2lj3Z3Mkoo20FgyLuBZeuZVfblLk1irwTk3PtYliKvi2o9do1Ny74hExGanYP",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptH2vxFE-97SR1-wApwuBbfgPUhrskiO6TB47_87hNDP_e6z7RENf90h8aOB3pOmF-FBXrEqc_PsxqKM6GnbGlDzWd3mhvdf8qHm1abUEIiE_IoFBrd5M47Yl_IOVSQauqT8ojHDdOijkKZ",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9psSapsiHkevwQyqPBj3PGj5eaFmKqzSkxJoGsW7GpJdVvaH1V-2J0vje7ebkIIc5supUOZ1p_C_TlTyBeYr4XvxyIbW-TAt5kadEwN8lTWcrmDts3XG8INb2qyC5tXiY2usAl7wLN6BaRzf",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvufCVXOTmOu11veUvZlM1SzXWm-BSGnIlpEJLfRyoD70KDQvp4R5qRY5p4jIzlmlsXRGSlvsfqeZYzrPVoO6amg1HbiDFoiXnndGaNos1MIGFC_DeN9rgIsvwKiS3MoUD-lSOx7sFZ3IEE",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9pumyMXze6Vad_DZrwdn-kb4FH_pfJ51p7a7sND0a_46CXOQLiGN0KVNC4-TU2QDjlcQOpnbCC6pggGw7uDwqSl-r6m-kvb89CaIbdY0zzQ5We8XK7EtpDO7nPMDqfbka1GWeYYNlRedBqQf",
            "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptmv7dNkFRK6-Seq0iQTzBnh5NY2ddlrAOLtHP3dpA1Txew87zOcdBFbPciTR5DRQTA_Qgh0NPSH23bSEnrw6fDOihixxEjOKaWAmcliJ2Bsq2XtaOS_j2QmkfF0OcwUnzMOWP1psei0paj"
          ],
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Couple",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 3,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 4,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            },
            {
              "id": "HOTELS_VIBE",
              "name": "Hotel highlights",
              "value": "Great view",
              "description": "How would you describe the hotel?"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK7OOVJIAqO_bUXJsXNClGhPiS_codAAJ_4jbQhjngD2I5VQA=s120-c-rp-mo-ba3-br100",
            "display_name": "L File",
            "link": "https://www.google.com/maps/contrib/112336634363254268566?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9XSlh5QXRTZ0lwV1ozMnhDRGg3a0E%7C0dCjYvbWq6w%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "4/5",
          "created": "2 months ago",
          "comment": "Awesome location, rooms were clean and comfortable.  Bar drinks are just ok, food is meh.  But I didn’t go to NYC to eat/drinkk in my hotel.  Its location is perfect.  We walked about 5 miles a day to see what we wanted and to go where we wanted.  Subway was easy to use.  The elevators are nice, but they do need more.  Construction on one, but there is almost always a line to go up and getting down is awful.  Give yourself plenty of time and the higher the room, the easier to get “on”.  Oftentimes people had been waiting multiple stops for the elevator to get down to the lobby, if on lower floors, but it would be full.  That was the only pitfall, but could be a significant one if you are in a hurry.",
          "review_reply": "Thank you for sharing your experience with us. We are glad to hear you enjoyed the clean and comfortable rooms, as well as our convenient location, which made it easy to explore the city on foot and by subway. We appreciate your comments regarding food, beverages, and elevator availability, and we will be reviewing these concerns with our team to help improve the overall guest experience. We appreciate you staying with us and hope to have the chance to host you again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "2 months ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Family",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 4,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
            "display_name": "Diana Nichols",
            "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "5/5",
          "created": "a month ago",
          "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
          "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "a month ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Business",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Solo",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 5,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_ROOMS",
              "name": "Rooms",
              "value": "My room was perfect and bigger than I expected for NYC.",
              "description": "Rooms"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_SAFETY",
              "name": "Safety",
              "value": "Lots of police officers around! Felt extremely safe.",
              "description": "Safety"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
              "name": "Noteworthy details",
              "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
              "description": "Noteworthy details"
            },
            {
              "id": "HOTELS_VIBE",
              "name": "Hotel highlights",
              "value": "Luxury",
              "description": "How would you describe the hotel?"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
            "display_name": "Natiesha Wray Henry",
            "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "5/5",
          "created": "a month ago",
          "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
          "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "a month ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Family",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 5,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_ROOMS",
              "name": "Rooms",
              "value": "Cozy and comfortable",
              "description": "Rooms"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
              "name": "Nearby activities",
              "value": "Times Square is walkable from here",
              "description": "Nearby activities"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
              "name": "Walkability",
              "value": "10 out of 10",
              "description": "Walkability"
            },
            {
              "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
              "name": "Noteworthy details",
              "value": "Parking and traffic is a nightmare.",
              "description": "Noteworthy details"
            },
            {
              "id": "HOTELS_VIBE",
              "name": "Hotel highlights",
              "value": "Kid-friendly",
              "description": "How would you describe the hotel?"
            }
          ]
        },
        {
          "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
            "display_name": "R471LZalext",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "3/5",
          "created": "2 months ago",
          "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxAYr7LFV6ZMNckj3q8VKiPdMIZXgCzt920CSu2v1nYG3GzQ=s120-c-rp-mo-ba4-br100",
            "display_name": "Elia Alejandra",
            "link": "https://www.google.com/maps/contrib/107082141027365570078?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJvNEtuLUo1N1hOc3R2ejd2WHRNN0E%7C0d6T99EL24S%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "2/5",
          "created": "3 months ago",
          "comment": "Room had a nice view. Staff was friendly.\nRoom was dirty when we walked in. There were hairs in the bathtub, and sink wasn’t very clean. Restrooms and rooms along with furniture are very old! Bedsheets had some hairs and not very clean. Room was cleaned once out of 4 days so it’s not daily. They do give you a 35$ voucher for the cafe they have and 25$ for their services. Luggage hold is free if you get there early but they charge 5$ a piece if you need to check out of your room but still have time before the airport. Elevators are nice they have a system that makes it run smoother.\nHotel seems very central so that’s a good thing. Lots of things around but that’s just New York.\nOver all because of how old rooms seems and how dirty it was 2/5. Wouldn’t stay here again .",
          "review_reply": "Dear Elia,\nThank you for taking the time to share such detailed feedback. We’re glad to hear you enjoyed the wonderful view, the fantastic location, and the friendliness of the team, but we’re truly sorry to learn that the room did not meet expectations during your stay. Your comments about cleanliness, upkeep, and service frequency are important, and they’ll be shared with the appropriate teams so we can take a closer look. We appreciate you noting the helpful amenities like the café credit, services credit, luggage storage, and elevator system as well. We’re grateful for your perspective and hope the rest of your time in New York City was wonderful.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "3 months ago",
          "details": [
            {
              "id": "HOTELS_PILOT_TRIP_TYPE",
              "name": "Trip type",
              "value": "Vacation",
              "description": "What kind of trip was it?"
            },
            {
              "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
              "name": "Travel group",
              "value": "Family",
              "description": "Who did you travel with?"
            },
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 1,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 3,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 4,
              "description": "Location"
            }
          ]
        },
        {
          "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
            "display_name": "Amanda Garcia",
            "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
          },
          "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
          "source": "Google",
          "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
          "rating": "5/5",
          "created": "2 months ago",
          "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
          "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
          "review_reply_created": "2 months ago",
          "details": [
            {
              "id": "HOTELS_ASPECT_ROOMS",
              "name": "Rooms",
              "value": 5,
              "description": "Rooms"
            },
            {
              "id": "HOTELS_ASPECT_SERVICES",
              "name": "Service",
              "value": 5,
              "description": "Service"
            },
            {
              "id": "HOTELS_ASPECT_LOCATION",
              "name": "Location",
              "value": 5,
              "description": "Location"
            }
          ]
        },
        {
          "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
            "display_name": "LisaO964",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "4/5",
          "created": "a month ago",
          "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
        },
        {
          "review_id": "ChdDSUhNMG9nS0VNT3NySlBUc01UbTZRRRAB",
          "reviewer": {
            "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qdvd3mFTmnQslJajBtyC7hGXBv5KKEN_7z5ZnXByEfDkAAFDmgEV3HW1P9_iXApXyf1XA=s120-c-br100",
            "display_name": "bobrobb",
            "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en"
          },
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=DE&supul=en",
          "source": "Tripadvisor",
          "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
          "rating": "2/5",
          "created": "a month ago",
          "comment": "On a positive, the location is excellent and the room was big enough for a family which I think is a rarity for such a location.  We visited from 30th Dec to 6th Jan and in all honesty the hotel is just not set up to be running at capacity.  There were queues for everything, check in, check out, restrooms, bars and the lifts.  The lifts deserve a special mention - if on a lower floor you might have to wait for 5 to 6 lifts to get one that had any capacity if heading down at a busy time.  The service at check in and check out was pretty non- existent, the $35 “destination charge” is to encourage you to spend in their bar.  If lucky enough to actually get served in the lobby bar 2 x beers is more than the $35 - it just leaves a bad taste.  There are no tea and coffee facilities in room (a given in UK), but on a positive note towels were changed daily.  When checking out this morning nobody asked us how our stay was, totally impersonal, then we got hit with the $5 per item holding fee, to hold our baggage from 12 noon to 2 pm - as we had 7 items (hand luggage also counts as a separate item) we got a $35 charge after checking out.  If anyone genuinely cared about customer experience, that would have been taken out of your destination charge, but of course that isn’t possible.    It is a shame really, a once grand hotel, living off the Hilton brand, in need of a refurb with a clear focus on revenue creation as opposed to customer experience.  The location just isn’t enough to make up for the lack of experience I’m afraid - there are much better out there."
        }
      ]
    }

    ```
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/products/serp-api/features#request-headers-summary).

For Google Reviews, set `x-unblock-data-format: parsed_light` to receive parsed JSON results. Combine with `x-brd-session: <session-id>` to pin paginated review fetches (`start`) to the same peer.

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" -H "x-brd-session: my-session-123" "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0"
```

## Images

Google image search uses `udm=2` (replaces deprecated `tbm=isch` since March 2026). Below are the parameters specific to image search.

### Query parameters

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=2&gl=us"
    ```

    ***

    ### `hl`

    Two-letter language code used to define the page languages

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=2&hl=en"
    ```
  </Accordion>

  <Accordion title="Search type" icon="magnifying-glass">
    ### `udm`

    Use `udm=2` to enter Google Image search.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=2"
    ```

    ### `safe`

    You can control the images' search with 3 modes:

    1. `off` - This will display all images, even inapproproate ones.
    2. `on` or `active` - This mode will filter out from the results in appropriate results.
    3. `images` - This mode will show a blurred version of the inappropriate images.

    Use `safe=[mode]` to get the required results.

    This is examples for blured images filter. 

    > We cannot publish inappropriate search terms in our documentation - so our default search term here will remain `pizza` . To see the actual impact, you need to modify the search term.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=2&safe=images"
    ```

    ### `tbm` \[deprecated]

    <Warning>
      `tbm=isch` is deprecated since March 2026 and now redirects to `udm=2`. Use `udm=2` instead.
    </Warning>

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&tbm=isch"
    ```
  </Accordion>

  <Accordion title="Image size" icon="image">
    ### `tbs`

    Usage: `tbs=isz:[l|m|i]` to set preferred image size filter (large, medium, small).

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&udm=2&tbs=isz:l"
    ```

    <Note>
      `tbs=li:1` is rejected on image search as well as web search. See [`tbs` under Web search](#tbs).
    </Note>
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/products/serp-api/features#request-headers-summary).

For Google Image search, set `x-unblock-data-format: parsed_light` to receive parsed JSON results:

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/search?q=pizza&udm=2"
```

## Lens

### Query parameters

<AccordionGroup>
  <Accordion title="Image URL" icon="image">
    ### `url`

    URL of image you want to search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png"
    ```
  </Accordion>

  <Accordion title="Localization" icon="flag">
    ### `hl`

    Preferred language, two-letter language code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de"
    ```
  </Accordion>

  <Accordion title="Upload image as file" icon="arrow-up-from-bracket">
    ### `upload`

    Upload an image named `cat.jpg` located in a current directory (not supported on async zones)

    ```sh theme={null}
    curl -F "encoded_image=@cat.jpg" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/v3/upload"
    ```
  </Accordion>

  <Accordion title="Get exact matches" icon="expand">
    ### `brd_lens`

    The `brd_lens` parameter in your request fetches specific Google Lens **tab results** by specifying a tab value (e.g. `products`, `homework`, `visual_matches`, `exact_matches`). <img alt="brd_lens" />

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/uploadbyurl?url=https%3A//cdn.shopify.com/s/files/1/0243/303[…]6-05d7-4eb6-bf06-8e0c143f4f00.png%3Fv%3D1693159120&brd_json=1&brd_lens=visual_matches"
    ```
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/products/serp-api/features#request-headers-summary).

For Google Lens, set `x-unblock-data-format: parsed_light` to receive parsed JSON results. When uploading an image as a file (`POST` to `/v3/upload`), `x-brd-session: <session-id>` is required to keep the upload and result fetch on the same peer.

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png"
```

## Hotels

### Query parameters

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&gl=us"
    ```

    ### `hl`

    Two-letter language code used to define the page language

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&hl=en"
    ```
  </Accordion>

  <Accordion title="Booking dates and options" icon="calendar">
    ### `brd_dates`

    Check-in date and check-out date, separated by comma.

    > #### Format:
    >
    > `YYYY-MM-DD,YYYY-MM-DD`
    >
    > #### Example:
    >
    > `2022-01-20,2022-02-05`

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_dates=2022-04-03%2C2022-04-10"
    ```

    ### `brd_occupancy`

    Number of guests to book a room for (maximum 6 guests).

    > #### Examples:
    >
    > `brd_occupancy=1` - look for a room for 1 person <br />`brd_occupancy=2` (default) - for 2 persons <br />`brd_occupancy=3` - for 3 persons, etc.

    Also supports a comma-separated list of integers where:

    * first value is a number of adult guests
    * subsequent values are ages of children

    > #### Format:
    >
    > `brd_occupancy=<number of adults>,<child 1 age>,<child 2 age>,...,<child N age>`
    >
    > #### Examples:
    >
    > `brd_occupancy=1,5,7,12` - for 1 adult and 3 children (5, 7 and 12 years old) <br />`brd_occupancy=2,1,3` - for 2 adults and 2 children (1 and 3 years old)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_occupancy=4"
    ```

    ### `brd_free_cancellation`

    Show only offers with free cancellation.

    > #### Examples:
    >
    > `brd_free_cancellation=true` - with free cancellation <br />`brd_free_cancellation=false` (default) - show any offers

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_free_cancellation=true"
    ```

    ### `brd_accommodation_type`

    Accommodation type: Hotels or Vacation Rentals.

    > #### Examples:
    >
    > `brd_accommodation_type=hotels` (default) - search for Hotels <br />`brd_accommodation_type=vacation_rentals` - search for Vacation Rentals

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_accommodation_type=vacation_rentals"
    ```

    ### `brd_currency`

    Currency to show prices at (3-letter code).

    > #### Examples:
    >
    > `brd_currency=USD` - United States Dollars <br />`brd_currency=EUR` - Euro <br />`brd_currency=INR` - Indian Rupees

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_currency=USD"
    ```
  </Accordion>

  <Accordion title="Output format" icon="magnifying-glass">
    ### `brd_mobile`

    Define what device type to be represented in user-agent

    Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

    > **For specific mobile platform provide one of the following values:** <br />`brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) <br />`brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) <br />`brd_mobile=android` - Android phone <br />`brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_mobile=1"
    ```

    ### `brd_json`

    Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

    > #### Examples:
    >
    > `brd_json=1` - return results in JSON <br />`brd_json=html` - return JSON with "html" field containing raw HTML

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_json=1"
    ```
  </Accordion>
</AccordionGroup>

### Headers

For the full list of SERP API request headers, see [SERP API features](/products/serp-api/features#request-headers-summary).

For Google Hotels, set `x-unblock-data-format: parsed_light` to receive parsed JSON results. Combine with `x-brd-session: <session-id>` to keep `brd_dates` and `brd_occupancy` queries pinned to a stable peer.

```sh theme={null}
curl -k --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -H "x-unblock-data-format: parsed_light" "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices"
```

## Flights

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC&gl=us"
    ```

    ### `hl`

    Two-letter language code used to define the page language

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC&hl=en"
    ```
  </Accordion>

  <Accordion title="Flight details" icon="plane-departure">
    ### `tfs`

    String representing flight search parameters

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC"
    ```

    ### `curr`

    Defines the currency of returned prices

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC&curr=USD"
    ```
  </Accordion>
</AccordionGroup>


# SERP API Yandex query parameters
Source: https://docs.brightdata.com/products/serp-api/query-parameters/yandex

Explore Yandex query parameters for the Bright Data SERP API (31 languages), including localization, pagination, time range and device targeting for results.

## Search

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `lr`

    Region or country to search.

    > #### Examples:
    >
    > `1` - Berlin \
    > `2` - London \
    > `84` - USA \
    > `95` - Canada \
    > `134` - China

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&lr=84"
    ```

    ### `lang`

    Two-letter language code used to define the page language

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&lang=en"
    ```
  </Accordion>

  <Accordion title="Pagination" icon="file">
    ### `p`

    Define the result page - results to start from the selected value. Used for managing pagination.

    > #### Examples:
    >
    > `p=1` (default) - first page of results \
    > `p=2` - second page of results \
    > `p=4` - fourth page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&p=1"
    ```
  </Accordion>

  <Accordion title="Time range" icon="calendar">
    ### `within`

    Time range to search.

    > **Available values are:** \
    > `77` - Past 24 hours \
    > `1` - Past 2 weeks \
    > `[%pm]` - Past month

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&within=1"
    ```
  </Accordion>

  <Accordion title="Device" icon="mobile-screen-button">
    ### `brd_mobile`

    Define what device type to be represented in user-agent

    Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

    > **For specific mobile platform provide one of the following values:** \
    > `brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) \
    > `brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) \
    > `brd_mobile=android` - Android phone \
    > `brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&brd_mobile=1"
    ```
  </Accordion>

  <Accordion title="Browser" icon="table-columns">
    ### `brd_browser`

    Define what browser to be represented in user-agent. \
    Can be combined with `brd_mobile` to get according mobile browser. \
    Default will provide random browser.

    > **For specific browser provide one of the following values:** \
    > `brd_browser=chrome` - Google Chrome \
    > `brd_browser=safari` - Safari \
    > `brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.yandex.com/search/?text=pizza&brd_browser=chrome"
    ```
  </Accordion>
</AccordionGroup>


# Create your first SERP API
Source: https://docs.brightdata.com/products/serp-api/quickstart

Get started with the Bright Data SERP API in 3 steps: create a zone, generate credentials and send your first Google search query.

<Callout icon="badge-dollar">
  **Start free, no credit card required**

  Your account gets **5,000 free credits every month**, drawn from a single shared pool across the eligible products, and SERP API requests spend from that shared pool. Create your SERP API and start sending requests immediately, no payment method needed. [Learn more about the free tier](/general/account/billing-and-pricing/free-tier).
</Callout>

<Steps>
  <Step title="<a href=&#x22;https://brightdata.com/cp/start&#x22;>Sign in to Bright Data</a>" />

  <Step title={<>Navigate to <a href="https://brightdata.com/cp/web_access/new">Create an API</a> page</>}>
    Navigate to **Create an API** under the **Web Access API** section in the left menu.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Choose SERP API">
    Select **SERP API** and click **Continue**.

    <Frame>
      <img alt="SERP API" />
    </Frame>
  </Step>

  <Step title="Assign a name to your SERP API">
    Enter a meaningful name. Optionally, add a short description.

    <Warning>
      **The SERP API name cannot be changed once created.**

      All other settings can be modified later. For details, see [Configure your API](/products/serp-api/configuration).
    </Warning>

    <Frame>
      <img alt="API Name" />
    </Frame>
  </Step>

  <Step title="Finalize API creation">
    Click **Add API**. Your SERP API is now ready to use.
  </Step>
</Steps>


# Send your first SERP API request
Source: https://docs.brightdata.com/products/serp-api/send-your-first-request

Step-by-step guide to sending your first SERP API request, with copy-paste curl examples for HTTP and SOCKS5 proxy interfaces.

## Make your first request in minutes

Test the SERP API in minutes with this ready-to-use code example.

<CardGroup>
  <Card title="Node.js Example" icon="code" href="https://github.com/luminati-io/bright-data-serp-api-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/luminati-io/bright-data-web-unlocker-python-project" />
</CardGroup>

Bright Data offers two methods for accessing SERP API, both delivering **identical** results while catering to different customer workflows:

<CardGroup>
  <Card title="Direct API access (recommended)" href="/products/serp-api/send-your-first-request#direct-api-access-recommended">
    A pure REST API method for easy access and straightforward integration.
  </Card>

  <Card title="Native proxy-based access" href="/products/serp-api/send-your-first-request#native-proxy-based-access">
    For workflows that rely on proxy-based routing.
  </Card>
</CardGroup>

## Direct API access (recommended)

A simple and RESTful way to interact with Bright Data's SERP API. Direct API access abstracts proxy management and allows you to send requests via a central endpoint, ensuring ease of use and straightforward REST API integration.

### When to use direct API access

* Centralized endpoint: Access SERP API via a single, RESTful endpoint.
* Streamlined direct integration: Eliminating the complexity of managing proxies or routing.
* Single API key authentication: Secure and easy to use, replacing the need for username-password management.

### Sending your first request

After [setting up](/products/serp-api/quickstart) your SERP API zone, you'll find a working SERP API request example and your API key within your zone's **Overview** tab:

<Frame>
  <img alt="SERP API Overview tab" />
</Frame>

The following is an example of a simple SERP API cURL request:

```sh Direct API access - cURL theme={null}

curl -H "Content-Type: application/json" -H "Authorization: Bearer [INSERT_YOUR_API_KEY]" -d '{"zone": "[INSERT_YOUR_SERP_API_ZONE_NAME]","url": "[INSERT_YOUR_TARGET_URL]", "format": "raw"}' https://api.brightdata.com/request
```

### Request breakdown

1. API Endpoint: [`https://api.brightdata.com/request`](https://api.brightdata.com/request)
2. Authorization Header: `Authorization: Bearer [INSERT YOUR API key]`
   * Your API key is found within your SERP API zone.
3. Payload:
   * `zone`: Your specific SERP API **zone name**.
   * `url`: The full SERP target URL (including SERP query params) that you wish to access via SERP API.
   * `format`: Defines the response format. Use `raw` to receive the raw response from the target site.

### Generating your Bright Data API key

A Bright Data API key is your secure authentication token for accessing SERP API via Direct API access. When adding a new SERP API zone in the [control panel](https://brightdata.com/cp/web_access), an API key will be generated automatically and can be found within the **Overview** tab of your zone.

<Frame>
  <img alt="SERP API key" />
</Frame>

**To generate a new API key:**

* Navigate to [Account settings](https://brightdata.com/cp/setting/users).
* Scroll down and click the Add API key button.
* Follow the on-screen instructions to complete the process.

<Tip>
  We strongly recommend to have an expiration date set on your API key for increased security.
</Tip>

<Warning>
  The API key will be shown to you on the screen **only** so make sure you copy and store it in a safe location per your organization's policies
</Warning>

## Native proxy-based access

In order to access SERP API, you will need to provide credentials which are comprised of:

1. Your customer ID
2. Your SERP API zone name
3. Your SERP API password
4. Bright Data SSL certificate

### Where to find your customer ID

Customer ID can be found in the welcome email you received, or by clicking your account initial letter on the top right screen of your control panel, or by clicking here: [Account settings](https://brightdata.com/cp/setting/customer_details) .

### Zone name and password

Your zone name and password can be found in the overview tab of your SERP API zone in the control panel.

### Bright Data SSL Certificate

<Warning>
  Prevent SSL errors by setting up Bright Data SSL certificate
</Warning>

SSL Certificate can be found by clicking "SSL certificate" wizard on your zone's overview top menu. See further instructions here:  [SSL certificate](/general/account/ssl-certificate#how-to-download-the-ssl-certificate).

Alternatively, you can  [ignore SSL errors](/general/account/ssl-certificate#how-to-ignore-ssl-errors).

### SERP API: HTTPS Proxy code examples

Once you have your API credentials, use the following code to send your first request:

<CodeGroup>
  ```sh cURL theme={null}
  curl "https://www.google.com/search?q=pizza" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k
  ```

  ```js Node.js theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

  (async () => {
    const response = await fetch('https://www.google.com/search?q=pizza');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  import pprint
  import requests


  host = 'brd.superproxy.io'
  port = 44445

  username = 'brd-customer-<customer_id>-zone-<zone_name>'
  password = '<zone_password>'

  proxy_url = f'http://{username}:{password}@{host}:{port}'

  proxies = {
      'http': proxy_url,
      'https': proxy_url
  }


  url = "https://www.google.com/search?q=pizza&brd_json=1"
  response = requests.get(url, proxies=proxies, verify=False)
  pprint.pprint(response.json())
  ```

  ```php PHP theme={null}

  <?php
  echo 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  $curl = curl_init('https://www.google.com/search?q=pizza');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
  curl_exec($curl);
  ?>
  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

  uri = URI.parse('https://www.google.com/search?q=pizza')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https') do |http|
      http.request(req)
  end

  puts result.body
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example {
    static void Main() {
      var client = new WebClient();
      client.Proxy = new WebProxy("brd.superproxy.io:44445");
      client.Proxy.Credentials = new NetworkCredential(
        "brd-customer-<customer_id>-zone-<zone_name>",
        "<zone_password>"
      );
      Console.WriteLine(client.DownloadString("https://www.google.com/search?q=pizza"));
    }
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          System.out.println("To enable your free eval account and get "
              +"CUSTOMER, YOURZONE and YOURPASS, please contact "
              +"sales@brightdata.com");
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("https://www.google.com/search?q=pizza").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
      .'YOURPASS, please contact sales@brightdata.com';
  use LWP::UserAgent;
  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  print $agent->get('https://www.google.com/search?q=pizza')->content();
  ```

  ```vb VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
          Console.WriteLine("To enable your free eval account and get " & 
              "CUSTOMER, YOURZONE and YOURPASS, please contact " &
              "sales@brightdata.com")
          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("https://www.google.com/search?q=pizza"))
      End Sub
  End Module
  ```
</CodeGroup>

## Send your first async request

Asynchronous requests submit a job, return a `response_id` immediately, and let you collect results later. Use async when you do not need the result in the same HTTP response.

### Enable asynchronous requests

In your SERP API [zone](https://brightdata.com/cp/web_access), open **Advanced settings** and turn on **Asynchronous requests**.

<Frame>
  <img alt="Enable async requests" />
</Frame>

### Submit the job

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.brightdata.com/serp/req?zone=YOUR_ZONE_NAME' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
        "query": {"q": "pizza"},
        "brd_json": "json"
      }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.brightdata.com/serp/req?zone=YOUR_ZONE_NAME"

  payload = {
      "query": {"q": "pizza"},
      "brd_json": "json",
  }
  headers = {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json()["response_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/serp/req?zone=YOUR_ZONE_NAME",
    {
      method: "POST",
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ query: { q: "pizza" }, brd_json: "json" }),
    }
  );

  const data = await response.json();
  console.log(data.response_id);
  ```
</CodeGroup>

You should see a `response_id`:

```json theme={null}
{
  "response_id": "s4t7w3619285042ra9dke1m8qx"
}
```

Save it. You need it to collect the result.

### Check status and collect the result

While the job is still running, the API returns HTTP `202` with `"Request is pending"`. Once it completes, fetch the result:

```bash theme={null}
curl --silent --compressed \
  "https://api.brightdata.com/unblocker/get_result?response_id=YOUR_RESPONSE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.json
```

`results.json` holds the structured SERP response. For the full field-by-field schema, see [Parsed JSON results](/products/serp-api/parsed-json-results).

| Detail | Value |
| :- | :- |
| Typical processing time | Up to 5 minutes, extending to 8 hours at peak |
| Result retention | 48 hours from submission |

### Can Bright Data push the response to my endpoint?

Not with the SERP API async endpoint. Collect results by polling with the `response_id`. If you need Bright Data to deliver a payload to an endpoint you control, use the [Google Scraper API](/products/scrapers/google/introduction), which supports webhook delivery.

For webhook setup, the async-versus-sync comparison and the full parameter list, see [Asynchronous requests](/products/serp-api/asynchronous-requests).


# Web Unlocker API configuration
Source: https://docs.brightdata.com/products/web-unlocker/configuration

Configure the Bright Data Web Unlocker API (98% success rate): async processing, custom headers, cookies and auto-throttling controls.

## How to configure Advanced settings

Advanced settings allow you to fine-tune how the Web Unlocker API processes requests, handles failures, and optimizes success rates.

### How to enable asynchronous requests

By default, requests are processed synchronously, returning a response immediately.<br />For long-running or high-volume workloads, you can enable **asynchronous requests**.

With asynchronous processing:

* Requests are handled in the background
* Responses can be retrieved later via a designated endpoint
* Overall stability and throughput are improved for large-scale jobs

This mode is recommended when:

* Target websites respond slowly
* You are processing large batches of URLs
* You want to decouple request submission from response handling

Learn more about asynchronous workflows here: [Asynchronous requests](/products/web-unlocker/send-your-first-request#send-your-first-async-request)

### Custom Web Unlocker API (Custom Headers & Cookies)

By default, the Web Unlocker API automatically generates optimal headers and cookies for each request. In some advanced scenarios, you may need full control over these values to access a **specific site version or user flow**.

Enabling **Custom Headers & Cookies** allows you to override the automated behavior and provide your own values.

<Note>
  Enabling **Custom Headers & Cookies** introduces the following changes:

  <AccordionGroup>
    <Accordion title="Access to a Pre-approved List of Headers and Cookies">
      You gain access to a pre-approved list of supported headers and cookies. This list allows you to verify whether the values you need are already approved for use with your target website.
    </Accordion>

    <Accordion title="Send Request for New Headers/Cookies">
      If your required headers or cookies are not listed, you can submit an approval request to Bright Data’s compliance team. The request must include details about the header/cookie and its purpose. Once reviewed, you will be notified when approval is granted.
    </Accordion>

    <Accordion title="Charging for All Requests">
      Unlike the regular Web Unlocker API logic, which only charges for successful requests, enabling this feature means you’ll be charged for 100% of the requests (both successful and failed). This change is due to Bright Data not having full control over the process and its performance.
    </Accordion>
  </AccordionGroup>
</Note>

#### Enable custom headers & cookies

To enable this feature:

1. Log in to the **Bright Data Control Panel**
2. Select the relevant **Web Unlocker API zone**
3. Open **Advanced Settings** and enable **Custom headers & cookies**.
4. Once enabled, start sending custom headers and cookies with your requests.

Once enabled, you can begin sending custom headers and cookies with your requests.

### Control over auto-throttling

The Web Unlocker API includes an intelligent **auto-throttling mechanism** designed to protect performance and reduce unnecessary costs.

Auto-throttling dynamically adjusts request behavior based on real-time success rates.

<Tabs>
  <Tab title="Automatic optimization">
    The system continuously evaluates request performance and automatically applies better-performing configurations when available.
  </Tab>

  <Tab title="Low success-rate protection">
    If the success rate for a target site drops below a defined threshold, the system begins throttling requests. This prevents repeated failures and conserves resources.
  </Tab>

  <Tab title="Customizable success threshold">
    By default, the throttling threshold is set to **70% success rate**.

    When **Custom Headers & Cookies** are enabled, you can customize this threshold to any value that fits your workload. This is especially useful when all requests are billable and tighter control is required.
  </Tab>
</Tabs>

### How to set usage limits

**Usage limits** let you cap spending or traffic on a zone, so a runaway job or an unexpected traffic spike cannot exceed your budget.

To enable this feature:

1. Log in to the [Bright Data Control Panel](https://brightdata.com/cp/web_access)
2. Select the relevant **Web Unlocker API zone**
3. Open **Advanced settings** and enable **Usage limit**
4. Set a **daily** or **monthly** cap on spending or traffic, and choose what happens when the cap is reached

## Web Unlocker API Premium Domains <Badge>Deprecated 20-May-2026</Badge>

<Warning>
  Web Unlocker Premium domains have deprecated and customers signed up with Bright Data after 20-May-2026 will not have this configuration option. We are gradually removing this feature from other customers too: we will notify you by email if your account is impacted.
</Warning>

#### For customers signed up prior to 20-May-2026:

Some websites employ more advanced anti-bot and traffic filtering mechanisms that require additional resources to unblock successfully. To support these targets, Bright Data offers a **separate premium pricing tier** for a predefined list of domains.

You can review the current list of premium domains here: [Current list of premium domains](/products/web-unlocker/features#current-list-of-premium-domains)

When premium domains are enabled:

* Requests to listed domains are charged at the premium rate
* The estimated cost is reflected in the **Estimated cost** section of your zone

<Note>
  Enabling premium domains does **not** affect all traffic.

  Only requests made to domains on the premium list are billed at the higher rate. Requests to all other domains continue to use the standard pricing tier.
</Note>


# Web Unlocker API error codes
Source: https://docs.brightdata.com/products/web-unlocker/error-codes

Catalog of Bright Data Web Unlocker API errors by HTTP status, with each x-brd-error-code value's meaning and the action to resolve it.

This reference explains how to identify Web Unlocker API errors, how the same error appears in each access mode and how to resolve the most common error codes.

## How do I know the error came from Web Unlocker and not the target site?

Every Web Unlocker error carries an `x-brd-error` response header describing the failure. Most also carry a machine-readable code: `x-brd-error-code` for unlocker-level errors, or `x-brd-err-code` for proxy-level errors passed through. Requests rejected before unlocking starts are the exception: authentication failures (401), an unknown zone name and request validation failures (400) return a real outer status with a plain-text or JSON body and no `x-brd-*` headers at all. Once a request passes those checks, an absent `x-brd-error` means the response came from the target site itself, including its own error pages and its own 4xx/5xx statuses, which are delivered to you as-is.

Branch your logic on the code rather than on the message text, because messages carry request-specific details such as selectors, hostnames and timeout values.

## Where does the error appear in each access mode?

The same error codes are returned in both access modes. What differs is where the HTTP status lives:

| Access mode | Endpoint | Where the status is |
| - | - | - |
| Direct API | `api.brightdata.com/request` | The outer response is `200 OK` once the request reaches the unlocker. The result status is in the `x-brd-status-code` header. Requests rejected before unlocking starts return a real outer status: `401` for API-key problems, `400` for an unknown zone name or an invalid URL. |
| Native proxy | `brd.superproxy.io:33335` | The HTTP status of the response itself, with the error message, or a shortened form of it, in the status reason phrase. |

On the native proxy, country and session options move from JSON body parameters into username flags (for example `-country-us`), but produce the same error codes.

The same failure, on the Direct API:

```http Direct API response theme={null}
HTTP/1.1 200 OK
x-brd-error: Navigation failed: The SSL/TLS certificate presented by the server is not valid for the current date
x-brd-error-code: net_err_cert_date_invalid
x-brd-status-code: 502
```

and on the native proxy:

```http Native proxy response theme={null}
HTTP/1.1 502 Navigation failed
x-brd-error: Navigation failed: The SSL/TLS certificate presented by the server is not valid for the current date
x-brd-error-code: net_err_cert_date_invalid
```

## Which headers carry the error code?

Two sets of error headers exist, by layer:

| Layer | Code header | Message header | Documented in |
| - | - | - | - |
| Unlocker-level | `x-brd-error-code` | `x-brd-error` | This page |
| Proxy-level, passed through (`policy_*`, `client_*`, `peer_*`, `target_*`) | `x-brd-err-code` | `x-brd-err-msg` | [Proxy error catalog](/proxy-networks/errorCatalog) |

Both families can appear in either access mode. Responses with a `400`, `403` or `407` status also carry an RFC9209 `Proxy-Status` header, whose `details` field repeats the proxy-level code (for example `details="policy_20020: Bad Port used..."`). The 502 unlock failures listed below do not carry that header.

## Which errors clear on a retry?

Retrying is worth doing for errors caused by the peer or by the unlock attempt, because each request uses a different peer. Errors caused by a property of the target, or by your own request parameters, return the same result on every attempt.

| Behaviour | Codes |
| - | - |
| Retrying can succeed | `reject_block`, `resolve_failed_*` |
| Retrying returns the same error, so fix the cause instead | `net_err_cert_date_invalid`, `net_err_cert_common_name_invalid`, `net_err_cert_authority_invalid`, `document_load_failed` when the cause is a TLS or cipher mismatch, `proxy_error` when the host does not resolve, `no_peers` |
| Configuration errors, unchanged until the zone or the request changes | `premium`, `feature_not_active`, `ub_bad_endpoint_robots` |

## Error catalog

### HTTP Error 400

A 400 means the request was refused before an unlock attempt was made, because the zone configuration or the request itself blocks it. These responses do not include an `x-brd-debug` header.

#### `premium`

| `x-brd-error` | Suggested action |
| - | - |
| Targeting %HOST% requires Premium permissions. To enable 'Premium domains', go to your Web Unlocker zone configuration page: %ZONE\_EDIT\_URL% ... | Enable [Premium domains](/products/web-unlocker/features#web-unlocker-api-premium-domains) in the zone configuration. The message links directly to your zone's edit page. Enabling it makes the same request to the same domain succeed. |

#### `feature_not_active`

| `x-brd-error` | Suggested action |
| - | - |
| Manual expect is not enabled for this zone | The request used a Custom Web Unlocker feature, for example the `x-unblock-expect` header, that is not enabled on the zone. Enable the matching [Custom Web Unlocker API feature](/products/web-unlocker/features#custom-web-unlocker-api), or remove the header. Note that custom features switch the zone to 100% billing. |

#### `ub_bad_endpoint_robots`

| `x-brd-error` | Suggested action |
| - | - |
| Request Failed (bad\_endpoint): Requested site is not available for immediate access mode in accordance with robots.txt. Ask your account manager to get full access for targeting this site | The requested path is disallowed by the target's `robots.txt`, and the account is in immediate (no-KYC) access mode, which honors `robots.txt`. Complete [KYC verification](/general/account/limited-trial-restrictions) or ask your account manager for full access. The same request from a full-access account is not blocked by this check. |

#### Request validation (Direct API only, real outer 400)

| Body | Suggested action |
| - | - |
| `zone "..." not found` | The `zone` value does not match any zone in your account. Check the zone name in the [control panel](https://brightdata.com/cp/zones). The same mistake on the native proxy returns `407` with `client_10002` instead. |
| `{"error":"Request validation failed","error_code":"validation",...}` | Malformed request body, for example a URL without `https://`. Fix the field named in `details`. |

### HTTP Error 401 (Direct API only)

API-key authentication happens before the request reaches the unlocker, so these return a **real outer 401** with a plain-text body and no `x-brd-*` headers.

| Body | Cause | Suggested action |
| - | - | - |
| `Invalid token` | The `Authorization: Bearer` value is a well-formed token that is not a valid API key, for example revoked or mistyped. | Check your [API key](/api-reference/authentication). |
| `Auth method is not supported` | The `Authorization` header does not use the `Bearer` scheme, for example a bare token, `Token <key>`, lowercase `bearer`, or `Bearer` followed by more than one space. | Send the header as `Authorization: Bearer <API key>`, with that exact capitalization and a single space. |
| `Credentials are invalid` | The `Authorization` header uses the `Basic` scheme. | Use `Bearer` with an API key instead of Basic auth. |
| `User authentication is required` | The `Authorization` header is missing. | Add `Authorization: Bearer <API key>` to the request. |

### HTTP Error 403

Access is restricted by Bright Data policy. Most of these carry a proxy-level code in `x-brd-err-code`, documented in the [proxy error catalog](/proxy-networks/errorCatalog).

| `x-brd-err-code` | When it fires | Suggested action |
| - | - | - |
| `policy_20020` | The destination port is not supported, for example `:25` or `:8080`. | Use a [supported port](/proxy-networks/faqs). |
| `client_10090` | The `zone` value points to a Browser API (Scraping Browser) zone, which cannot be used through the Web Unlocker request interface. | Use a browser connection for that zone, see [Browser API](/products/scraping-browser/introduction), or pass a Web Unlocker zone in `zone`. |
| *(no code returned)* | The target is a private or reserved address, or is blocked by policy. The message reads `Forbidden: You tried to target ... but got blocked. It can be related to your blacklist or whitelist settings or the target site is not allowed by Bright Data policy. ...` | Target a public hostname permitted by Bright Data policy, and check the zone's allowlist and denylist. |

### HTTP Error 407

Authentication against the proxy layer failed. On the native proxy this is the outer status, with a summary in the status reason phrase. On the Direct API the same `407` appears in `x-brd-status-code`.

| `x-brd-err-code` | Status line | Cause | Suggested action |
| - | - | - | - |
| `client_10000` | `407 Auth failed` | Wrong zone password, or wrong customer ID. | Check the zone password and customer ID in the [control panel](https://brightdata.com/cp/zones). |
| `client_10002` | `407 Zone not found` | The zone name is misspelled, disabled or deleted. | Confirm the zone is active, or list zones with [Get active zones](/api-reference/account-management-api/Get_active_Zones). |
| `client_10010` | `407 Proxy Authentication Required` | No proxy credentials were sent. | Add `brd-customer-<id>-zone-<zone>:<password>` as the proxy user. |
| `client_10001` | `407 Invalid Auth` | Request parameters are carried inside the proxy username, so a malformed value, for example the country `usa` instead of `us`, fails to parse even when the zone name and password are correct. | Check the format of the parameters in the username before changing credentials. A two-letter lowercase country code parses correctly. |

### HTTP Error 429

#### `sr_rate_limit`

| `x-brd-error` | Suggested action |
| - | - |
| The request was auto-throttled due to low success rate | Bright Data's health monitor throttled requests to this target after its success rate dropped. Contact [support](mailto:support@brightdata.com). |

### HTTP Error 502

A 502 means the unlock attempt itself failed. The reason is in `x-brd-error-code`.

#### `reject_block`

| `x-brd-error` | Suggested action |
| - | - |
| captcha or protection page found | A CAPTCHA or protection page was detected, so the response was rejected instead of being delivered. Retry: each attempt uses a different peer, and the same request to the same URL has been observed to succeed on a later attempt. |

#### `resolve_failed_*`

| `x-brd-error` | Suggested action |
| - | - |
| Captcha resolve failed | A CAPTCHA solve was attempted and did not complete. The suffix names the challenge type, for example `resolve_failed_akamai_interstitial`. Retry, as with `reject_block`. If one URL keeps failing, report it to support with the `req_id`. |

#### `http_status`

| `x-brd-error` | Suggested action |
| - | - |
| response status was rejected: %STATUS% status code | The target answered with a blocking HTTP status, so the response was discarded instead of being delivered. This also covers a 429 returned by the target site itself. Each attempt uses a different peer, so a retry is worth one attempt. If the code persists, the target is blocking the current setup: contact support with the `req_id`. |

#### `expect_element`

| `x-brd-error` | Suggested action |
| - | - |
| waiting for selector "%SELECTOR%" failed: timeout %MS%ms exceeded | The page loaded, but an element the unlocker waits for did not appear within its wait. Observed waits range from 30 to 150 seconds, so a client timeout shorter than that aborts the request before the error is returned: allow at least 180 seconds. A URL that returns this code repeatedly keeps returning it, so report it to support with the `req_id` rather than retrying. With [manual expect](/products/web-unlocker/features#manual-expect-elements) enabled, first confirm your own selector exists on the page. |

#### `navigation_timeout`

| `x-brd-error` | Suggested action |
| - | - |
| Navigation timeout @ %URL% | The rendered page did not finish navigating within the time limit. If one URL times out consistently, report it to support with the `req_id`. |

#### `domcontentloaded_event_timeout`

| `x-brd-error` | Suggested action |
| - | - |
| Timed out waiting for window\.DomContentLoaded event | The rendered page did not fire its `DOMContentLoaded` event within the time limit. If one URL returns this consistently, report it to support with the `req_id`. |

#### `document_load_failed`

| `x-brd-error` | Suggested action |
| - | - |
| Navigation failed: %NET\_ERR% | Rendered navigation failed before a document was received. The message carries the underlying Chrome network error, for example `net::ERR_EMPTY_RESPONSE` or `net::ERR_SSL_VERSION_OR_CIPHER_MISMATCH`. Look up that name on [source.chromium.org](https://source.chromium.org) to identify the cause. When the cause is a property of the target, such as a TLS or cipher mismatch, every attempt returns the same result. |

#### `net_err_cert_date_invalid`

| `x-brd-error` | Suggested action |
| - | - |
| Navigation failed: The SSL/TLS certificate presented by the server is not valid for the current date | The target's TLS certificate is expired, or not yet valid. Open the URL in a browser to confirm. Every attempt returns the same result, and an invalid certificate on the target's side cannot be bypassed. |

#### `net_err_cert_common_name_invalid`

| `x-brd-error` | Suggested action |
| - | - |
| Navigation failed: The SSL/TLS certificate presented by the server doesn't match the domain name being accessed | The target's TLS certificate does not cover the hostname being requested. Confirm the hostname, and check the certificate in a browser. |

#### `net_err_cert_authority_invalid`

| `x-brd-error` | Suggested action |
| - | - |
| Navigation failed: Invalid certificate on target site | The target's TLS certificate is signed by an untrusted or unknown certificate authority. Check the certificate chain in a browser. |

#### `net_err_closed`

| `x-brd-error` | Suggested action |
| - | - |
| Navigation failed: Network connection was closed by other party. | The connection was closed by the other end before the response completed. If one URL returns this consistently, report it to support with the `req_id`. |

#### `rate_limit`

| `x-brd-error` | Suggested action |
| - | - |
| Navigation failed: Failed to open proxy tunnel (reason = "Unexpected Status 429 (ext\_proxy\_connect\_error)") | A rate limit was reached on the Bright Data side while the connection was being opened. A rate limit returned by the target site itself is reported as `http_status`, not as this code. Reduce the request rate to this target, and contact support with the `req_id` if it continues. |

#### `proxy_error`

| `x-brd-error` | Suggested action |
| - | - |
| Could not resolve host %HOST%. Check host name is correctly spelled and retry. If host is properly spelled or can only be resolved from a specific region contact brightdata support for DNS support. | The proxy layer could not complete the fetch, most often because the host did not resolve. Check the hostname spelling. A host that does not resolve returns the same error on every attempt, so retrying does not help despite what the message says. If the host resolves only from a specific region, contact support. |

#### `no_peers`

| `x-brd-error` | Suggested action |
| - | - |
| Unexpected Status 502 (no\_peer) | No peer was available for the request. This is returned for every request that targets a country with no available peers, including valid ISO codes for countries where Bright Data has none. Change or remove the `country` value: the same request succeeds once a country with available peers is used. |

### HTTP Error 503

Service unavailable. A browser check failed or was not completed. A 503 served by the target site itself is delivered as-is, with no `x-brd-error` header.


# Web Unlocker API features
Source: https://docs.brightdata.com/products/web-unlocker/features

Reference for Bright Data Web Unlocker API features (98% success rate): CAPTCHA solving, Premium Domains, custom headers, cookies and Browser Rendering.

## Disable CAPTCHA Solving

By default, as part of our full proxy unblocking solution, Web Unlocker API also solves CAPTCHAs that are encountered while returning your proxy request.

When disabling CAPTCHA solver, our intelligent algorithm still takes care of the entire ever-changing flow of finding the best proxy network, customizing headers, fingerprinting, and more, but intentionally does not solve CAPTCHAs automatically, giving your team a lightweight, streamlined solution, that broadens the scope of your potential scraping opportunities.

**Best for:**

* Scraping data from websites without getting blocked
* Emulating real-user web behavior
* Teams that don't have an unblocking infrastructure in-house and **don't want** their scraper to solve CAPTCHAs automatically

<Accordion title="How can I get started?">
  To disable CAPTCHA solving, open the relevant zone and go to the **Configuration** tab, where you will find the **CAPTCHA Solver** toggle. Switch it off to disable CAPTCHA solving.
</Accordion>

## Web Unlocker API Premium Domains

Premium domains are a part of Bright Data's tiered website classification system. These are websites that are more challenging to unblock than others and require additional Web Unlocker API resources.

In this article, we will see the current list of Premium domains, understand how to target them, and go over the special pricing.

<Note>
  The premium domains list is updated quarterly using our website classification logic and we’ll notify you via email 30 days in advance of any changes to your domains. You can always access the most up-to-date list in your Web Unlocker API zone.
</Note>

### Current List of Premium Domains

<Accordion title="Expand to view current premium domains">
  <div>
    Loading...
  </div>
</Accordion>

### Enable Premium Domains

When creating your Web Unlocker API zone, check the 'Premium Domains' box under Special features

<Frame>
  <img alt="Enable Premium Domains" />
</Frame>

### Pricing

Once enabled, the premium price will be reflected in the "Estimated cost" section. Check out the [pricing page](https://brightdata.com/pricing) to see exact numbers, but keep in mind these prices are usually for "Pay as you go" plans and you can enjoy significant discounts if you sign up to a package or talk to our sales people!

<Note>
  Even after enabled, only specific requests to these domains will be priced at the higher rate. Requests to other domains will be kept at the default lower tier.
</Note>

## Geolocation Targeting `-country-country_code`

<Tip>
  Web Unlocker automatically selects the optimal IP location for targeting your domain, reducing the need for manual configuration in **most** cases. Manual geo-targeting is useful when accessing region-restricted or location-specific data.
</Tip>

If you want to target from a specific **country** in Web Unlocker API refer to [geolocation targeting](/api-reference/proxy/geolocation-targeting).

## Mobile User-agent Targeting `-ua-mobile`

By default, Web Unlocker API uses desktop-specific user agents for your requests. To use a **mobile** user agent instead, simply append `-ua-mobile` to your request. 

## Scrape as markdown

Web Unlocker is able to live convert your pages from HTML to markdown. This makes it easier to feed your LLM training system, for example.

To activate the feature, add the `x-unblock-data-format: markdown` header when using the native proxy interface, or set `data_format: 'markdown'` when using the API.

<CodeGroup>
  ```shell HTTP API theme={null}
  API_KEY=your_api_key_here
  ZONE=your_zone_here
  curl -v \
     -H "Authorization: Bearer $API_KEY" \
     -H 'content-type: application/json' \
     --data '{"url": "https://example.com", "zone": "'$ZONE'", "format": "raw", "data_format": "markdown"}' \
     https://api.brightdata.com/request
  ```

  ```shell Native proxy interface theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-data-format: markdown' \
      https://example.com
  ```
</CodeGroup>

## Return a screenshot

Web Unlocker is able to take a screenshot of the page you are trying to scrape. This can be useful for debugging or for monitoring the page's appearance.

To activate the feature, add the `x-unblock-data-format: screenshot` header when using the native proxy interface or add `data_format: screenshot` to request body when using API interface.

Output format is `.png`

<CodeGroup>
  ```shell HTTP API theme={null}
  curl -k https://api.brightdata.com/request \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR API KEY>" \
  -d '{"zone":"unblocker","url":"https://example.com","format":"raw","data_format":"screenshot"}' \
  --silent --output example_com.png
  ```

  ```shell Native proxy interface theme={null}
  curl -k \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-data-format: screenshot' \
      https://example.com > example_com.png
  ```
</CodeGroup>

## Unlock Fragmented URL in a single call

Unlock a fragmanted URL (broken by a `#` charachter) using Web Unlocker API.

### Using REST API

Just provide the fragmented URL, Bright Data Unlocker will handle and retreive the results. Response time may take a bit longer due to increased processing and retreival.

Example:

```bash theme={null}
curl 'https://api.brightdata.com/request' -H 'Content-Type: application/json' -H 'Authorization: Bearer API_KEY' -d '{"zone": "zone3","url": "https://www.somesite.com#!/path1/id11133/9*Fmt=100", "format": "raw", "headers": {"x-unblock-expect": "{\"element\": \".pace-done\"}"}}'
```

### Using Native API

A special header is introduced for this purpose: `x-unblock-url-fragment` . Relay this header and add the fragment.

Example:

```bash theme={null}
curl -i --proxy brd.superproxy.io:44445 --proxy-user brd-customer-someID-zone-myunlocker:**passwd** -k "https://www.site.com/" -H 'x-unblock-url-fragment: !/path1/id11133/9*Fmt=100' -H 'x-unblock-expect: {"element": ".pace-done"}' 
```

## Force JavaScript rendering with a browser

You can instruct Web Unlocker to force JavaScript rendering using a browser by adding the `render `parameter to your request. Since this flag forces browser use, you may see significant increase in response time, so use it only when needed, and scarcely.

<CodeGroup>
  ```shell HTTP API theme={null}
  curl -k https://api.brightdata.com/request \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR API KEY>" \
  -d '{"zone":"unblocker","url":"https://example.com","format":"raw","render":"true"}' 
  ```

  ```shell Native proxy interface theme={null}
  curl -k \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE-render:$PASSWORD@brd.superproxy.io:44445 \
       https://example.com
  ```
</CodeGroup>

## Custom Web Unlocker API

Gain enhanced control over your requests with flexible options to fine-tune website behavior and optimize request handling.

By default, Web Unlocker API automatically manages all request headers, cookies, expect elements etc., to get the best known results and any extra elements that are sent along with the request are disregarded.

Custom Web Unlocker API allows you to override the automated parameters and send your own custom values specific to your needs.

### Which custom features are available

* [Manual headers & cookies](/products/web-unlocker/features#manual-headers-%26-cookies)
* [Manual ‘expect’ elements](/products/web-unlocker/features#manual-%E2%80%98expect%E2%80%99-elements)

### How to enable

In the Control Panel, go to your specific **Web Unlocker API** zone -> Configuration -> Advanced Settings, and enable the Custom Web Unlocker API feature you want to use.

<img alt="Enable Premium Domains" />

Once enabled, you can now send Custom Web Unlocker API requests.

### How billing changes with custom features

Unlike the regular Web Unlocker API billing logic, which only charges for successful requests, when any of the above Custom Web Unlocker API features are **enabled**, you'll be billed for 100% of the requests (both successful and failed).

Since you are now in control of certain request paramaters, Bright Data can no longer take full responsibility for the unlocking process and its performance.

<Warning>
  **Be advised:**

  * We do not allow cookies for login/authentication purposes
  * Adding custom paramaters to your request may result in blocking and a drop in the success rate.
</Warning>

### Manual headers & cookies

Override automated headers/cookies and send your own custom values in order to target specific versions of a website.

<Note>
  Enabling **Custom Headers & Cookies** results in the following

  <AccordionGroup>
    <Accordion title="Access to Pre-approved List of Headers/Cookies">
      You'll gain access to a pre-approved list of headers and cookies. You can browse through this list to verify that the required headers and cookies are approved for your target site.
    </Accordion>

    <Accordion title="Send Request for New Headers/Cookies">
      If your required headers or cookies are not on the pre-approved list, you can submit a form to our compliance team for approval. This process involves providing information about the headers/cookies and their necessity. After a short approval process is completed, you will be notified by our compliance team.
    </Accordion>

    <Accordion title="Charging for All Requests">
      Unlike the regular Web Unlocker API billing logic, which only charges for successful requests, enabling this feature means you'll be charged for 100% of the requests (both successful and failed). This change is due to Bright Data not having full control over the process and its performance.
    </Accordion>
  </AccordionGroup>
</Note>

### Manual ‘expect’ elements

In case of receiving partially rendered/loaded pages, you can use the `x-unblock-expect` header to instruct Web Unlocker API to wait for specific elements or text before returning the response.<br />This feature allows you to define expectations, such as a CSS selector, specific text, or the page body, that must be present before the page is considered fully loaded.

You can configure this per request with the `x-unblock-expect` header seen below.

**Add header**

<CodeGroup>
  ```shell Element must exist theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-expect: {"element": ".some-css-selector"}' \
      https://example.com
  ```

  ```shell Page must include text theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
      -H 'x-unblock-expect: {"text": "items in stock"}' \
      https://example.com
  ```
</CodeGroup>

### Amazon-specific geolocation headers

Web Unlocker API allows you to pass custom headers to simulate a user-selected city and  ZIP code on Amazon, enabling access to region-specific content, pricing, and delivery options.

* `x-unblock-city` - Simulates selecting a city.
* `x-unblock-zipcode` - Simulates selecting a ZIP code on Amazon.
* `x-unblock-get-sponsored` - Simulated sponsored-specific rules on Amazon pages to improve the consistency/appearance of sponsored results. It’s recommended to use it only on requests where sponsored data is required (omit otherwise).

<CodeGroup>
  ```shell Example theme={null}
  curl -vk \
  -x brd-customer-$CUSTOMER_ID-zone-$ZONE:$PASSWORD@brd.superproxy.io:44445 \
  -H 'x-unblock-zipcode: 10001' \
  -H 'x-unblock-city: New York' \
  https://www.amazon.com/
  ```
</CodeGroup>

## Monitor Web Unlocker API Usage

To review your current Web Unlocker API CPM, navigate to [My APIs](https://brightdata.com/cp/web_access) page, and review the **Requests** column for request counts (the basis for CPM billing); the **Traffic** column shows bandwidth used.

<Frame>
  <img alt="Monitor Web Unlocker API Usage" />
</Frame>

### How to read usage numbers

The **Traffic** column above shows bandwidth used; the number of **successful requests** is displayed in the **Requests** column. In the example above, 115k requests are equal to 115 CPM, so you'll be billed according to the rate of 10 CPMs for that billing cycle.

### How is usage calculated?

Your Web Unlocker API usage is measured by CPM. CPM is the cost of 1000 **successful requests,** meaning only successful Web Unlocker API requests will count toward your billing.

See our [Billing & Pricing](/general/account/billing-and-pricing/payment) page to learn more.

## Debugging Web Unlocker API

Sometimes it's useful to extract some debug info about your requests to understand what happened inside them in more detail.

We provide the `x-brd-debug` response header for this purpose.

How you switch it on depends on which access type you're using, the same Native / API choice you see in the Playground of your [zone](https://brightdata.com/cp/web_access):

| Access type | How to enable |
| - | - |
| Native proxy interface | Append `-debug-full` to the proxy username |
| HTTP API | Set `"debug": true` in the request body |

For asynchronous requests, set `"debug": true` on the **submit** call to `/unblocker/req`. The `x-brd-debug` header is then returned by `/unblocker/get_result` when you collect the response. Submitting without the flag returns no debug header at collection time.

<Note>
  This feature is only available for the Web Unlocker API and is NOT available for our proxy products.
</Note>

<Tip>
  `x-brd-debug` is a **response header**, so two flags matter:

  * Print headers with `-v` or `-i`. A plain `curl` shows only the body, which looks like the feature returned nothing.
  * On the native proxy interface, keep `-k` for HTTPS targets. Without it curl rejects the proxy's certificate, the tunnelled request never completes, and you see only the bare `HTTP/1.1 200 OK` of the CONNECT, with no debug header.
</Tip>

<CodeGroup>
  ```shell Native proxy interface theme={null}
  curl -vk \
      -x brd-customer-$CUSTOMER_ID-zone-$ZONE-debug-full:$PASSWORD@brd.superproxy.io:44445 \
      https://example.com
  ```

  ```shell HTTP API (sync) theme={null}
  curl -i --request POST \
    --url https://api.brightdata.com/request \
    --header "Authorization: Bearer $API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
      "zone": "web_unlocker1",
      "url": "https://example.com",
      "format": "raw",
      "debug": true
    }'
  ```

  ```shell HTTP API (async) theme={null}
  # 1. Submit the job with "debug": true, and keep the response_id.
  RESPONSE_ID=$(curl --silent --request POST \
    --url "https://api.brightdata.com/unblocker/req?zone=web_unlocker1" \
    --header "Authorization: Bearer $API_KEY" \
    --header "Content-Type: application/json" \
    --data '{"url": "https://example.com", "debug": true}' \
    | sed -En 's/.*"response_id":"([^"]+)".*/\1/p')

  # 2. Collect the result. x-brd-debug is returned here, not on the submit.
  #    Wait ~20s before the first poll, 10s before the second, then 5s.
  #    HTTP 202 means the job is still running.
  curl -i --silent --compressed \
    --url "https://api.brightdata.com/unblocker/get_result?response_id=$RESPONSE_ID" \
    --header "Authorization: Bearer $API_KEY"
  ```
</CodeGroup>

The format of the `x-brd-debug` header looks like this:

```text theme={null}
req_id=hl_d09913c7_a1lw123bkcg; bytes_up=2842; bytes_down=562418; billed=false; destination_ip=162.219.225.118; used_req_headers=accept-language,accept; peer_ip=r868133f79d0c3fa9d7c7ccca0151af2e; peer_country=us; render=false
```

| Field | Description |
| - | - |
| req\_id | The internal ID of your request in the Bright Data Web Unlocker API. Include it in bug reports so Bright Data support can trace exactly what happened in your specific request |
| bytes\_up | The amount of outgoing traffic, in bytes, that the Bright Data Web Unlocker API recorded while processing this request |
| bytes\_down | The amount of incoming traffic, in bytes, that the Bright Data Web Unlocker API recorded while processing this request |
| billed | Whether the Bright Data Web Unlocker API counts this request as billable. Returns `true` or `false` |
| destination\_ip | The IP address of the target server from which the data was fetched |
| used\_req\_headers | The custom request headers that were relayed to the target site in the initial request |
| peer\_ip | A unique identifier for the peer IP address used to make the request. Use it to validate that IP rotation is working as you expect |
| peer\_country | Two-letter country code of the peer used for the request, for example `us` |
| render | Whether the returned page is browser-rendered HTML (`true`) or the response body of a single HTTP request (`false`) |
| captcha\_solved | Whether a CAPTCHA was solved during the processing of the request. Returns `true` or `false` |
| captcha\_type | The CAPTCHA service of the solved CAPTCHA |

## Common Error Codes

Occasionally, for a number of reasons, you might receive an unexpected error code in response to your Web Unlocker API request.

The following list will provide you with a deeper understanding of what the source of the issue may be.

| Error | Description |
| - | - |
| `404` | Page not found. Invalid URL, which suggests the URL might be broken or dead. |
| [403](/proxy-networks/faqs#what-is-error-code-403) | The URL you're trying to access is valid, but you are forbidden from accessing that URL. |
| [502](/proxy-networks/faqs#what-is-error-code-502) | Error code `502` is the most common error for Web Unlocker API users, the descriptive part is under the `x-luminati-error-code`. |
| `407` | This error code suggests one of your account credentials is incorrect (password or zone's name). |
| `429` | This error code implies a rate limit (rare). In such cases, if the response appears as below, Bright Data is applying auto-throttling to the request, and you should open a ticket or email [support@brightdata.com](mailto:support@brightdata.com) for assistance. |
| `401` | Unauthorized request, The API key is invalid (`Invalid token`), the `Authorization` header does not use the `Bearer` scheme (`Auth method is not supported`), or the header is missing (`User authentication is required`). |
| `503` | HTTP error code `503` means "Service Unavailable". Browser check failed or browser check wasn't completed |

```js theme={null}
< HTTP/1.1 429 The request was auto-throttled due to low success rate  
< x-luminati-error-code: sr_rate_limit
< x-luminati-error: The request was auto-throttled due to low success rate
< x-brd-error-code: sr_rate_limit
< x-brd-error: The request was auto-throttled due to low success rate
< date: Tue, 23 Jan 2024 17:07:19 GMT
< connection: keep-alive
< keep-alive: timeout=5
< transfer-encoding: chunked
< 
* Connection #0 to host brd.superproxy.io left intact
```

<Accordion title="Contact support for further assistance">
  If you encounter an issue with Web Unlocker API, before reporting it to us, please test with the instructions and tips below:

  1. Open '[Your Web Unlocker API](https://brightdata.com/cp/web_access)' in your control panel, then click the Playground Tab.
  2. Select `Shell` language
  3. Paste the URL of your target in the 'URL' box
  4. Copy with the button on the right
  5. Add `-v -o test` to your command (this will turn on verbose logging, and create an output file named 'test' for you to share with our support agents)
  6. Run the command and check the output (make sure to check the static source HTML for the data also)

  If this test reproduces your issue, please contact [support@brightdata.com](mailto:support@brightdata.com) and share the following within the body of the email:

  1. The `curl` request you sent to generate the result
  2. The full verbose output from running the command
  3. The response returned from running it (the 'test' file)
  4. Whether you are using a browser automation tool or not (The Web Unlocker API does not support them or any 3rd party integrations except for your code).
</Accordion>

## Get Success Rate Statistics Per Domain

The following API endpoint returns Web Unlocker API success rate statistics for the past 7 days by default. Use the optional `from_datetime`, `to_datetime` and `url_pattern` query parameters to set a different date range or filter by request URL.

The statistics can be obtained per single domain like `example.com` or for a wildcard domain like `example.*` in order to get statistics for all top-level domains.

**Note**: calling this API endpoint requires using your [API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F)

Full parameter and response reference: [Web Unlocker API success rate](/api-reference/rest-api/unlocker/get-success-rate).

**How to get statistics for a single domain?**

<CodeGroup>
  ```shell Request theme={null}
      curl "https://api.brightdata.com/unblocker/success_rate/example.com" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response theme={null}
      {"example.com":0.9835556363554884} 
  ```
</CodeGroup>

**How to get statistics for all monitored top level domains?**

<CodeGroup>
  ```shell Request theme={null}
      curl "https://api.brightdata.com/unblocker/success_rate/example.*" -H "Content-Type: application/json" -H "Authorization: Bearer API_KEY"
  ```

  ```shell Response theme={null}
      {"example.com":0.9835548316870116,"example.fr":0.987469724604454,"example.co.uk":0.9503769840916476,"example.ca":0.9904893224078992,"example.de":0.9864620859972142,"example.es":0.9845641506811664,"example.in":0.8558596797075156,"example.it":0.9890758071645432,"example.co.jp":0.996804161764218,"example.com.mx":0.9710054259117241,"example.com.au":0.9969920926297628,"example.ae":0.617948700199661,"example.nl":0.9872124916314797,"example.pl":0.9899010819017637,"example.com.br":0.9804172881460471,"example.com.be":0.9928999059667324,"example.se":0.9888455998636585,"example.sa":0.9939472688535012,"example.com.tr":0.7967697653998838,"example.eg":0.9990248073774932}
  ```
</CodeGroup>


# Web Unlocker API overview
Source: https://docs.brightdata.com/products/web-unlocker/introduction

Bright Data Web Unlocker API (98% success rate) handles proxy rotation, anti-bot challenges and CAPTCHA solving in 1 call. Returns clean HTML or JSON.

The **Web Unlocker API** unlocks any public web page in a single API call with a 98% success rate and returns clean HTML or JSON. You send one request with your target URL, and Bright Data handles proxy rotation, browser fingerprints, CAPTCHA solving and retries on its side. You pay only for successful requests.

The Web Unlocker API is part of Bright Data's [Unlocker scraping suite](/left-over/scraping-automation-introduction). Instead of managing proxies, headers, fingerprints and anti-bot logic yourself, you call one endpoint and get back a response that is already unblocked and ready to parse.

```sh Direct API access theme={null}
curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"zone":"YOUR_ZONE_NAME","url":"https://example.com","format":"raw"}' \
  https://api.brightdata.com/request
```

The response is the target page's raw HTML or JSON. No proxy orchestration, browser automation or custom retry logic is required. See [Send your first request](/products/web-unlocker/send-your-first-request) for the full walkthrough with Python, Node.js and cURL examples.

## How does the Web Unlocker API work?

Every request is optimized on Bright Data's side before it reaches the target site. A single call to `https://api.brightdata.com/request`:

* Selects the most effective proxy network for the target site
* Sets request headers and fingerprints to match real-user browser traffic
* Solves CAPTCHAs and anti-bot challenges automatically
* Retries failed attempts with alternative configurations until the request succeeds
* Charges only for requests that return a successful response

Bright Data provides two access methods that return identical results: **direct API access**, a REST call to a single endpoint (recommended), and **native proxy-based access**, which routes requests through the Bright Data super proxy. See [Send your first request](/products/web-unlocker/send-your-first-request) to set up either one.

## When should you use the Web Unlocker API?

Use the Web Unlocker API when you need reliable, large-scale access to public web data without building and maintaining proxy and anti-bot infrastructure yourself. It fits:

* Scraping any website, including sites with advanced anti-bot protection
* Emulating real-user behavior to reach protected or geo-restricted content
* Engineering teams without a scalable proxy and unblocking stack
* Production workloads that need high success rates and predictable, pay-per-success costs

<Warning>
  Social network account management is not a supported use case for the Web Unlocker API. This includes managing accounts on Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat and Discord.
</Warning>

<Note>
  The Web Unlocker API is not intended for browser-based automation or third-party browser tools such as [Adspower](/integrations/adspower), [Puppeteer](/integrations/puppeteer), [Playwright](/integrations/playwright), or [Multilogin (MLA)](/integrations/multilogin). If your workflow requires direct interaction with a browser or scripted user actions, use the [Browser API](https://brightdata.com/products/scraping-browser) instead.
</Note>

## FAQ

### What format does the Web Unlocker API return?

With native proxy access, the target page's raw HTML is returned as-is. With direct API access, set `format` in the request body: `"raw"` for the unmodified response, or `"json"` for a JSON envelope. Either way, the body comes back ready to parse, with no post-processing required

### Do you pay for failed requests?

No. With both the Web Unlocker API and the [SERP API](/products/serp-api/introduction), you are charged only for successful requests to your target domain.

### Can the Web Unlocker API control a browser?

No. The Web Unlocker API returns page content from a single request. For scripted browser actions such as clicking, scrolling or filling forms, use the [Browser API](https://brightdata.com/products/scraping-browser).

### Does the Web Unlocker API work on search engines?

For Google, Bing and other search engines, use the [SERP API](/products/serp-api/introduction). It is purpose-built for search result pages and returns parsed results.

## Related

<CardGroup>
  <Card title="Send your first request" icon="paper-plane" href="/products/web-unlocker/send-your-first-request">
    Make your first Web Unlocker API call in Python, Node.js or cURL.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/products/web-unlocker/quickstart">
    Create a Web Unlocker API zone and get your API key.
  </Card>

  <Card title="Configuration" icon="sliders" href="/products/web-unlocker/configuration">
    Tune country targeting, response format and request options.
  </Card>

  <Card title="Target API endpoints" icon="list-check" href="/products/web-unlocker/target-api-endpoints">
    Get the highest success rates and lowest cost per request.
  </Card>
</CardGroup>


# Create your first Web Unlocker API
Source: https://docs.brightdata.com/products/web-unlocker/quickstart

Set up your first Bright Data Web Unlocker API (98% success rate): create the API in the Control Panel, configure credentials and send your first request.

<Callout icon="badge-dollar">
  **Start free, no credit card required**

  Your free tier includes **5,000 credits every month** for the Web Unlocker API. Create your Web Unlocker API and start sending requests immediately, no payment method needed. [Learn more about the free tier](/general/account/billing-and-pricing/free-tier).
</Callout>

This quick start walks you through creating your first **Web Unlocker API zone** in the Bright Data Control Panel.<br />Once completed, your API will be ready to send unlock requests and return clean HTML or JSON responses.

## How to set up step by step

<Steps>
  <Step title={<a href="https://brightdata.com/cp/start">Sign in to Bright Data</a>}>
    Log in to your Bright Data account using your credentials. If you don’t have an account yet, you’ll be prompted to create one before proceeding.
  </Step>

  <Step title={<>Navigate to the <a href="https://brightdata.com/cp/web_access/new">Create an API</a> page</>}>
    From the Bright Data Control Panel:

    **1.** Open the left-hand navigation menu from the dashboard.<br />**2.** Select **Web Access** view from the menu.<br />**3.** Click **Create API** to start creating a new API.

    <Frame>
      <img alt="Create an API" />
    </Frame>
  </Step>

  <Step title="Choose Web Unlocker API">
    In the API selection screen, choose **Web Unlocker API**. This enables automatic proxy management and unblocking logic for your requests.

    Click **Continue** to proceed.

    <Frame>
      <img alt="Web Unlocker API" />
    </Frame>
  </Step>

  <Step title="Assign a name to your Web Unlocker API">
    Enter a **clear and descriptive name** for your Web Unlocker API. This helps you identify the API later, especially if you manage multiple zones.

    You may also add an optional description for internal reference.

    <Warning>
      **The Web Unlocker API name cannot be changed once created.** You can modify all other settings later, including domains, headers, and throttling options. For details, see [Configure your API](/products/web-unlocker/configuration).
    </Warning>

    <Frame>
      <img alt="API Name" />
    </Frame>
  </Step>

  <Step title="Add payment method (free trial users only)">
    If you signed up with a personal email (e.g., Gmail, GitHub) and have not yet added a payment method, the primary button will read **Add payment method** instead of **Add API**.

    Click the button to open the payment verification form and complete the process. You will **not** be charged, this is for identity verification only.

    <Info>
      Already have a payment method on file? This step is skipped automatically. For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>
  </Step>

  <Step title="Finalize API creation">
    Review your configuration and click **Add API**. If you were redirected to add a payment method, your zone is created automatically once verification completes. Your Web Unlocker API zone is now created and immediately available for use.

    <Frame>
      <img alt="Save API" />
    </Frame>
  </Step>
</Steps>


# Send your first Web Unlocker API request
Source: https://docs.brightdata.com/products/web-unlocker/send-your-first-request

Send your first request using Bright Data Web Unlocker API (98% success rate) with step-by-step guidance, request breakdowns and real-world code examples.

## Make your first request in minutes

Once your Web Unlocker API is created, you can begin unlocking websites immediately. This guide walks you through sending your **first successful request**, explains the available access methods, and provides ready-to-use examples.

<CardGroup>
  <Card title="Node.js Example" icon="code" href="https://github.com/luminati-io/bright-data-web-unlocker-nodejs-project" />

  <Card title="Python Example" icon="code" href="https://github.com/luminati-io/bright-data-web-unlocker-python-project" />
</CardGroup>

## Choose an access method

Bright Data provides **two ways** to access the Web Unlocker API. Both methods return **identical results**, but are optimized for different workflows.

<CardGroup>
  <Card title="Direct API access (recommended)" href="/products/web-unlocker/send-your-first-request#direct-api-access-recommended">
    A pure REST API method for easy access and straightforward integration.
  </Card>

  <Card title="Native proxy-based access" href="/products/web-unlocker/send-your-first-request#native-proxy-based-access">
    For workflows that rely on proxy-based routing.
  </Card>
</CardGroup>

## Direct API access (recommended)

A simple and RESTful way to interact with Bright Data’s Web Unlocker API. Direct API access abstracts proxy management and allows you to send requests via a central endpoint, ensuring ease of use and straightforward REST API integration.

### When to use direct API access

* **Centralized endpoint:** Access Web Unlocker API via a single, RESTful endpoint.
* **Streamlined direct integration:** Eliminating the complexity of managing proxies or routing.
* **Single API key authentication:** Secure and easy to use, replacing the need for username-password management.

### Sending your first request

After [setting up](/products/web-unlocker/quickstart) your Web Unlocker API zone, you can find:

* Your **API key**
* A ready-to-use request example
* Your **zone name**

in the **Overview** tab of your Web Unlocker API zone.

<Frame>
  <img alt="Web Unlocker API Overview tab" />
</Frame>

The following is an example of a simple Web Unlocker API cURL request:

```sh Direct API access - cURL theme={null}
curl -H "Content-Type: application/json" -H "Authorization: Bearer [INSERT_YOUR_API_KEY]" -d "{\"zone\": \"[INSERT_YOUR_WEB_UNLOCKER_ZONE_NAME]\", \"url\": \"[INSERT_YOUR_TARGET_URL]\", \"format\": \"raw\", \"body\": \"{\\\"key\\\":\\\"value\\\"}\"}" https://api.brightdata.com/request
```

### Request breakdown

1. API Endpoint: [`https://api.brightdata.com/request`](https://api.brightdata.com/request)
2. Authorization Header: `Authorization: Bearer [INSERT YOUR API key]`
   * Your API key is found within your Web Unlocker API zone.
3. Payload:
   * `zone`: Your specific Web Unlocker API **zone name**.
   * `url`: The target URL you wish to access via Web Unlocker API.
   * `format`: Defines the response format. Use `raw` to receive the raw response from the target site.
   * \[Optional] `body`: Specifies the raw POST payload sent to the target URL. e.g. `"body": "{\"key\":\"value\"}"`

### Generating your Bright Data API key

A Bright Data API key is your secure authentication token for accessing Web Unlocker API via Direct API access. When adding a new Web Unlocker API zone in the [control panel](https://brightdata.com/cp/web_access), an API key will be generated automatically and can be found within the **Overview** tab of your zone.

<Frame>
  <img alt="Web Unlocker API key" />
</Frame>

**To generate a new API key:**

* Navigate to [Account settings](https://brightdata.com/cp/setting/users).
* Scroll down and click the Add API key button.
* Follow the on-screen instructions to complete the process.

<Tip>
  We strongly recommend having an expiration date set on your API key for increased security.
</Tip>

<Warning>
  The API key will be shown to you on the screen **only** so make sure you copy and store it in a safe location per your organization's policies
</Warning>

## Native proxy-based access

Proxy-based access is designed for workflows that already use proxy routing. Instead of a REST endpoint, requests are sent through Bright Data’s super proxy.

### Which credentials are required

In order to access Web Unlocker, you will need to provide credentials which are comprised of:

1. **Your customer ID**
2. **Your Web Unlocker API zone name**
3. **Your Web Unlocker API password**
4. **Bright Data SSL certificate**

### Where to find your customer ID

Customer ID can be found in the welcome email you received, or by clicking your account initial letter on the top right screen of your control panel, or by clicking here: [Account settings](https://brightdata.com/cp/setting/customer_details) .

### Zone name and password

Your zone name and password can be found in the overview tab of your unlocker zone in the control panel.

### Bright Data SSL Certificate

<Warning>
  Prevent SSL errors by setting up Bright Data SSL certificate
</Warning>

SSL Certificate can be found by clicking "SSL certificate" wizard on your zone's overview top menu. See further instructions here:  [SSL certificate](/general/account/ssl-certificate#download-the-ssl-certificate).

Alternatively, you can  [ignore SSL errors](/general/account/ssl-certificate#how-to-ignore-ssl-errors%3F).

### Web Unlocker API: HTTPS Proxy code examples

Once you have your credentials, use the following code to send your first request:

<Accordion title="Expand for code examples">
  <CodeGroup>
    ```sh cURL theme={null}
    curl "http://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    ```javascript Node.js theme={null}
    #!/usr/bin/env node

    const { ProxyAgent, setGlobalDispatcher } = require('undici');

    setGlobalDispatcher(new ProxyAgent('http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'));

    (async () => {
      const response = await fetch('http://brdtest.com/myip.json');
      console.log(await response.text());
    })();
    ```

    ```python Python theme={null}
    import pprint
    import requests

    host = 'brd.superproxy.io'  
    port = 44445
    username = 'brd-customer-<customer_id>-zone-<zone_name>'
    password = '<zone_password>'
    proxy_url = f'http://{username}:{password}@{host}:{port}'
    proxies = {
      'http': proxy_url,
      'https': proxy_url
    }

    url = "http://brdtest.com/myip.json"

    response = requests.get(url, proxies=proxies)
    pprint.pprint(response.json())
    ```

    ```php php theme={null}
    <?php

    echo 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com';

    $curl = curl_init('http://brdtest.com/myip.json');
    curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
    curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');
    curl_exec($curl);
    ?> 
    ```

    ```ruby Ruby theme={null}
    #!/usr/bin/ruby

    require 'uri'
    require 'net/http'
    require 'net/https'

    puts 'To enable your free eval account and get CUSTOMER, YOURZONE and YOURPASS, please contact sales@brightdata.com'

    uri = URI.parse('http://brdtest.com/myip.json')
    proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')
    req = Net::HTTP::Get.new(uri)
    result = proxy.start(uri.host,uri.port, :use_ssl  => uri.scheme == 'https') do |http|

    http.request(req)

    end

    puts result.body
    ```

    ```cs C# theme={null}
    using System;
    using System.Net;
    class Example {
      static void Main() {
        var client = new WebClient();
        client.Proxy = new WebProxy("brd.superproxy.io:44445");
        client.Proxy.Credentials = new NetworkCredential(
          "brd-customer-<customer_id>-zone-<zone_name>",
          "<zone_password>"
        );

        Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
      }
    }
    ```

    ```java Java theme={null}

    package example;
    import org.apache.http.HttpHost;
    import org.apache.http.client.fluent.*;

    public  class Example {
      public  static  void main(String[] args) throws Exception {
        System.out.println(
          "To enable your free eval account and get "
          +"CUSTOMER, YOURZONE and YOURPASS, please contact "
          +"sales@brightdata.com"
        );

        HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);

        String res = Executor.newInstance()
          .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
          .returnContent().asString();

        System.out.println(res);
      }
    }
    ```

    ```perl Perl theme={null}

    #!/usr/bin/perl
    print 'To enable your free eval account and get CUSTOMER, YOURZONE and '
    .'YOURPASS, please contact sales@brightdata.com';

    use LWP::UserAgent;
    my  $agent = LWP::UserAgent->new();

    $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
    print  $agent->get('http://brdtest.com/myip.json')->content();

    ```

    ```vb VBA theme={null}
    Imports System.Net
    Module Module1

    Sub Main()

    Console.WriteLine("To enable your free eval account and get " &
    "CUSTOMER, YOURZONE and YOURPASS, please contact " &
    "sales@brightdata.com")

    Dim Client As  New WebClient
    Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
    Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
    Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
    End Sub
    End Module
    ```
  </CodeGroup>

  The code above uses your Web Unlocker API zone to send a request to [http://brdtest.com/myip.json](http://brdtest.com/myip.json). It returns your IP information in a JSON format:

  ```json Output theme={null}
  {
    "ip": "ALLOCATED_IP",
    "country": "PK",
    "asn": {
      "asnum": 203020,
      "org_name": "HostRoyale Technologies Pvt Ltd"
    },
    "geo": {
      "city": "Islamabad",
      "region": "IS",
      "region_name": "Islamabad",
      "postal_code": "44040",
      "latitude": 33.7233,
      "longitude": 73.0435,
      "tz": "Asia/Karachi",
      "lum_city": "islamabad",
      "lum_region": "is"
    }
  }
  ```

  Now, replace “[https://brdtest.com/myip.json”](https://brdtest.com/myip.json”) with the website of your choice.
</Accordion>

For an interactive display of every Web Unlocker API use case, integration and preference, see the [API examples](https://brightdata.com/cp/zones/proxy_examples) page in the control panel.

## Common issues and quick fixes

* **401 Unauthorized**
  Authentication is missing or invalid.
  → Verify the `Authorization` header and your API key.

* **400 Bad Request**
  The request payload is invalid.
  → Ensure `zone`, `url` and `format` are all present.

* **Content looks incomplete**
  → Try another public URL, or review the [configuration options](/products/web-unlocker/configuration).

For the full list of status codes and their causes, see [Error codes](/products/web-unlocker/error-codes).

## Send your first async request

Asynchronous requests submit a job, return a `response_id` immediately, and let you collect the result later. Use async when you do not need the unlocked page in the same HTTP response.

### Enable asynchronous requests

In your Web Unlocker API [zone](https://brightdata.com/cp/web_access), open **Advanced settings** and turn on **Asynchronous requests**.

<Frame>
  <img alt="Enable async requests" />
</Frame>

### Submit the job

Send a `POST` to the [async request endpoint](/api-reference/rest-api/unlocker/request):

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.brightdata.com/unblocker/req?zone=YOUR_ZONE_NAME' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
        "url": "https://geo.brdtest.com/welcome.txt"
      }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.brightdata.com/unblocker/req?zone=YOUR_ZONE_NAME"

  payload = {"url": "https://geo.brdtest.com/welcome.txt"}
  headers = {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json()["response_id"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.brightdata.com/unblocker/req?zone=YOUR_ZONE_NAME",
    {
      method: "POST",
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ url: "https://geo.brdtest.com/welcome.txt" }),
    }
  );

  const data = await response.json();
  console.log(data.response_id);
  ```
</CodeGroup>

You should see a `response_id`:

```json theme={null}
{
  "response_id": "s4t7w3619285042ra9dke1m8qx"
}
```

### Poll for the result

While the job runs, the API returns HTTP `202` with `"Request is pending"`. Wait before polling, or Bright Data may rate-limit excessive empty polls:

| Poll | Wait before it |
| :- | :- |
| First | 20 seconds |
| Second | 10 seconds |
| Subsequent | 5 seconds |

Once complete, [retrieve the result](/api-reference/rest-api/unlocker/get-results):

```bash theme={null}
curl --silent --compressed \
  "https://api.brightdata.com/unblocker/get_result?response_id=YOUR_RESPONSE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.json
```

`results.json` contains the status code, response headers and the unlocked page body:

```json theme={null}
{
  "status_code": 200,
  "headers": {
    "content-type": "text/plain; charset=utf-8",
    "server": "nginx"
  },
  "body": "Welcome to Bright Data! Here are your proxy details ..."
}
```

### Can Bright Data push the result to my endpoint?

Yes. Instead of polling, configure a webhook and Bright Data delivers the result to a URL you control when the job finishes. See [Webhooks setup](/products/web-unlocker/setup-webhooks).


# Set up webhooks for Web Unlocker API
Source: https://docs.brightdata.com/products/web-unlocker/setup-webhooks

Configure webhooks for the Bright Data Web Unlocker API (98% success rate) to receive HTTP callbacks when async jobs complete, instead of polling for results.

<AccordionGroup>
  <Accordion title="Understand how webhooks work" icon="lightbulb">
    When using [asynchronous requests](/api-reference/rest-api/unlocker/request), the Web Unlocker API processes jobs in the background.

    Instead of polling for results, you can configure a webhook. A webhook is an HTTP endpoint that Bright Data calls when your job is completed.

    The flow looks like this:

    1. Send async request
    2. Receive `response_id`
    3. Bright Data processes the request
    4. Bright Data sends a notification to your `webhook_url`
    5. Use the `response_id` to retrieve the result

    <Tip>
      Webhooks notify you when a job is ready, they do not include the full response body.
    </Tip>
  </Accordion>

  <Accordion title="Prerequisites" icon="list-check">
    The following are required:

    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
    * [A Bright Data API key](/api-reference/authentication#how-do-i-generate-a-new-api-key)
    * [An active Web Unlocker API zone](https://brightdata.com/cp/web_access)
    * [Basic knowledge of cURL](https://curl.se/)
    * [A working asynchronous request setup using the Web Unlocker API](/products/web-unlocker/send-your-first-request#send-your-first-async-request)
  </Accordion>
</AccordionGroup>

<Steps>
  <Step title="Create a webhook endpoint">
    You need a publicly accessible URL to receive webhook notifications.

    <Tip>
      For demonstration purposes, we'll use [webhook.site](https://webhook.site).

      It instantly generates a temporary webhook URL and lets you inspect incoming requests in real time, including headers, query parameters, and payloads.
    </Tip>
  </Step>

  <Step title="Send an async request with webhook">
    Add the `webhook_url` parameter to your request:

    <CodeGroup>
      ```bash cURL theme={null}
      curl --request POST \
        --url 'https://api.brightdata.com/unblocker/req?zone=<unlocker-zone-name>' \
        --header 'Authorization: Bearer <API_KEY>' \
        --header 'Content-Type: application/json' \
        --data '{
          "url": "https://geo.brdtest.com/welcome.txt",
          "webhook_url": "https://webhook.site/<webhook-url-id>"
        }'
      ```

      ```python Python theme={null}
        import requests

        url = "https://api.brightdata.com/unblocker/req?zone=<unlocker-zone-name>"

        payload = {
            "url": "https://geo.brdtest.com/welcome.txt",
            "webhook_url": "https://webhook.site/<webhook-url-id>",
        }
        headers = {
            "Authorization": "Bearer <API_KEY>",
            "Content-Type": "application/json"
        }

        response = requests.post(url, json=payload, headers=headers)

        print(response.text)
      ```

      ```js Node.js theme={null}
      const options = {
        method: 'POST',
        headers: {Authorization: 'Bearer <API_KEY>', 'Content-Type': 'application/json'},
        body: JSON.stringify({
          url: 'https://geo.brdtest.com/welcome.txt',
          webhook_url: 'https://webhook.site/<webhook-url-id>',
        })
      };

      fetch('https://api.brightdata.com/unblocker/req?zone=<unlocker-zone-name>', options)
        .then(res => res.json())
        .then(res => console.log(res))
        .catch(err => console.error(err));
      ```
    </CodeGroup>

    <Callout icon="key">
      Replace `<API_KEY>`, `<unlocker-zone-name>`, `<webhook-url-id>` with your actual values.
    </Callout>
  </Step>

  <Step title="Receive webhook notification">
    Once the request is processed, Bright Data sends a POST request to your `webhook_url`.

    ```json theme={null}
    // A typical webhook request includes:
    {
      "status": 200,
      "response_id": "<RESPONSE_ID>",
      "request_url": "https://geo.brdtest.com/welcome.txt"
    }
    ```

    If you're using webhook.site, you can inspect the incoming request, including payload fields and headers (e.g., `user-agent`).

    <Tip>
      This webhook notifies you that the request has completed.
    </Tip>
  </Step>

  <Step title={<>Retrieve the result using <code>response_id</code></>}>
    Use the `response_id` from the webhook to fetch the actual result:

    ```sh wrap theme={null}
    curl --silent --compressed \
      "https://api.brightdata.com/unblocker/get_result?response_id=<RESPONSE_ID>" \
      -H "Authorization: Bearer <API_KEY>" \
      -o results.json
    ```

    Then inspect the output:

    ```sh theme={null}
    cat results.json
    ```

    The file will contain the full response, including headers and body.
  </Step>

  <Step title={<><Badge>Optional</Badge> Attach custom data to webhook</>}>
    You can include custom metadata using `webhook_data`. When using `webhook_method` as `POST`, this data will be sent in the request body of the webhook notification.

    ```bash wrap theme={null}
    curl --request POST \
      --url 'https://api.brightdata.com/unblocker/req?zone=<unlocker-zone-name>' \
      --header 'Authorization: Bearer <API_KEY>' \
      --header 'Content-Type: application/json' \
      --data '{
        "url": "https://geo.brdtest.com/welcome.txt",
        "webhook_url": "https://webhook.site/a14a55b3-c3cc-4890-84f2-eeebe4b264a4",
        "webhook_method": "POST",
        "webhook_data": "{\"job_id\": \"my_job_123\", \"source\": \"test_script\"}"
      }'
    ```

    The `webhook_data` field is returned unchanged in the webhook notification. This allows you to attach identifiers such as job IDs or metadata, making it easier to map responses to your internal workflows.
  </Step>

  <Step title="Congratulations" icon="party-horn">
    You’ve successfully set up webhooks with the Web Unlocker API. You can now receive real-time notifications for completed jobs and build more efficient, event-driven scraping workflows.
  </Step>
</Steps>


# How to target API endpoints
Source: https://docs.brightdata.com/products/web-unlocker/target-api-endpoints

Target API endpoints with the Bright Data Web Unlocker API (98% success rate): direct access, falling back to the source page and Browser API interception.

## Overview

When using Web Unlocker API, targeting specific API endpoints of product or other pages is a common strategy to extract necessary data efficiently. In most scenarios, Web Unlocker API can access these API endpoints successfully. However, there are instances where unlocking an API endpoint may face challenges, while the required data remains accessible on the main webpage.

## How to target an API endpoint

### Direct API Access

Initially, attempt to directly target the API endpoint with Web Unlocker API. This method in most cases will work out of the box.

### Alternative Approach for Unblocking Issues

If direct API endpoint targeting is unsuccessful, shift your focus to the main webpage from which the API gathers its data. Web Unlocker API is designed to access and unlock data on these primary web pages effectively. This will ensure you still retrieve the necessary information without direct API access.

### Leveraging Browser API for Complex Cases

For cases where accessing the API endpoint directly is critical, and alternative methods are not sufficient, our [Browser API](/products/scraping-browser/introduction) can be utilized.

Use Browser API to load the webpage, and set the request interception on the API call that is done by the frontend, so you can read the desired API response.

### Can I use Web Unlocker API with Browsers (e.g. Chrome) or Browser Automation Libraries (e.g., Puppeteer, Playwright, Selenium)?

**No.** You should not use the Web Unlocker API with browsers (e.g., Chrome, Firefox, Edge), anti-detect browsers (e.g., Adspower, Multilogin), or browser automation libraries (e.g., Puppeteer, Playwright, Selenium).

Web Unlocker API is optimized for scraping data from websites **without interaction**, focusing on delivering clean HTML/JSON responses to singular requests while managing proxy and unblocking infrastructure.

Using the Web Unlocker API directly with browsers usually does not work, and even if it does, it can also lead to unnecessarily increased costs.

If you do need to interact with web pages, you have a few options:

* **For regular browsers** (e.g., Chrome, Firefox, Edge) and **anti-detect browsers** (e.g., Adspower, Multilogin), you should use our **proxy networks** (Data Center, ISP, Mobile, Residential). Integration guides for these products are available here: [Proxy Integrations (brightdata.com)](/integrations/introduction)

* **For browser automation libraries** (e.g., Puppeteer, Playwright, Selenium), you may use proxy networks; but an even better solution is the **Browser API** product, which provides unblocking capabilities similar to the Web Unlocker API but is designed to work seamlessly with browser automation. For more information on the Browser API, visit: [Introduction to Browser API - Bright Data Docs](/products/scraping-browser/introduction)


# Proxy configuration options
Source: https://docs.brightdata.com/proxy-networks/config-options

Control Bright Data proxy targeting (195 countries), IP rotation, session handling, DNS resolution and routing behavior using proxy username parameters.

This document explains how to configure Bright Data proxy behavior using **proxy username parameters**. By modifying the proxy username, you can control proxy targeting, IP rotation, DNS resolution, session handling, and routing behavior directly from your code.

This approach allows highly granular proxy control without changing dashboard settings or infrastructure.

## Proxy networks authentication

Bright Data proxy access is authenticated using a **proxy username and password**. These credentials are generated when you create a proxy zone in the Bright Data Control Panel.

Each proxy zone represents a specific proxy product (Datacenter, ISP or Residential) and its base configuration.

### Native access via proxy user name and password

After creating a Bright Data proxy zone, you receive:

* A **proxy username**
* A **proxy password**

The proxy username is not just an identifier, it also defines **how the proxy behaves**.

The **proxy username** is composed of:

* Your account ID
* Your zone name
* Optional configuration parameters

#### Proxy username structure

`brd-customer-[customerID]-zone-[zone name]-[optional parameters]`

<Warning>
  You cannot change the **zone name** after it has been created. If you need to change the zone name, you must create a new zone. Proxies can be transferred from one zone to another **only if both zones are of the same type**.
</Warning>

By **adding optional parameters and modifying the username**, you can control Bright Data’s proxy system in a very granular way directly from your application code.

The sections below describe the available configuration options. A fully elaborated and complete list is available in the [Proxy API reference documentation](/api-reference/proxy/).

## Intergrate with 3rd Parties & Tools

Bright Data proxies can be integrated with a wide range of third-party tools, automation frameworks, browsers, and HTTP clients. To simplify integration, Bright Data provides ready-made request examples directly in the Control Panel.

You can access these examples here: [https://brightdata.com/cp/zones/proxy\_examples](https://brightdata.com/cp/zones/proxy_examples)

These examples help you:

* Construct correct proxy requests
* Validate credentials
* Test targeting and rotation behavior
* Integrate proxies into existing tools and workflows

## Proxy targeting options

These settings let you easily configure proxies for a specific country, state, city, zip code and ASN.

<Note>
  Datacenter and ISP proxies only support country targeting
</Note>

| Parameter | Description | Example username |
| - | - | - |
| -country-xx | Select a country using two letter code, or `eu` for random country in the European Union.   List of country codes is [here](/general/faqs#where-can-i-see-the-list-of-country-codes) | `brd-customer-<customer_id>-zone-<zone_name>-country-us` |
| | | |
| -state-xxxxx | Targets a state in the US using the two letter code. You must include US as country. | `brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny` |
| -city-xxxxx | Targets a city. You must include the country (e.g. username-country-fr-city-paris). Do not use spaces (e.g. -city-sanfrancisco) | `brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco` |
| -zip-xxxxx | Targets a US zip code. Use a 5-digit zipcode | `brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-37501` |
| -asn-xxxxx | Targets an ASN from [the list](https://bgp.potaroo.net/cidr/autnums.html) | `brd-customer-<customer_id>-zone-<zone_name>-asn-56386` |
| -os-xxxxx | Only for Residential proxies. Allows targeting `Windows`, `MacOS`, or`android` | `brd-customer-<customer_id>-zone-<zone_name>-os-windows` |

## Controlling your proxies' DNS

DNS resolution determines **where domain names are resolved** before the request is sent.

Bright Data allows you to control whether DNS resolution happens:

* On the proxy peer
* On Bright Data’s Super Proxy servers

| Function | Parameter | Description | Example username |
| - | - | - | - |
| Choose where DNS resolution is done | -dns-local or -dns-remote | Lets you choose if DNS is resolved `remote` on the proxy connecting to the site, or `local` on Bright Data's servers ('Super Proxies'). More info [here](/api-reference/proxy/configuring_dns_resolution) | `brd-customer-<customer_id>-zone-<zone_name>-dns-local` |

## Controlling your proxies rotation

The following options allow you to set how we rotate within the proxies in the zone, or attach to a specific proxy, and what shall we do if the peer is not available from some reason.
For more information regarding the way IP rotation works with our proxy products, and for further explanation of the following options, please see [this article](/api-reference/proxy/rotate_ips)

| Function | Parameter | Description | Example username |
| - | - | - | - |
| Keep the same IP for multiple requests or rotate IPs | `-session-xxxxxx` | Each unique session ID will get a unique IP, can be used to target the same IP repeatedly or force rotation. Recommended for implementing programmatic IP rotation. | `brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345` |
| Selecting specific IP | `-ip-x.x.x.x` | Available only for zones with dedicated IPs allocated | `brd-customer-<customer_id>-zone-<zone_name>-ip-1.2.3.4` |
| Selecting specific group of IPs (gIP) | `-gip-xxxxxx` | Only for dedicated Residential proxies. | `brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0` |
| Keeping track of individual responses | `-c_tag-xxxxxx` | Include a unique c\_tag flag in their requests. In response, businesses echo back the same tag in the header. This seamless exchange ensures that each response is bound to its corresponding request, eliminating confusion and streamlining data management.. | `brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE>` |
| Bind to peer in session | `-const` | Use the same peer for the session. If peer is unavailable, a 502 error will be returned with "no peer available". It should be used together with `-session`<br />[Read more.](/api-reference/proxy/keep_same_peer_in_session) | `brd-customer-<customer_id>-zone-<zone_name>-const` |

## Controlling 'Super Proxies'

Super Proxies are Bright Data’s routing servers responsible for selecting and managing the actual proxy peers (Datacenter, ISP, or Residential).

> Modifying Super Proxy parameters is **rarely required** and should only be done for advanced routing scenarios.

| Function | Parameter | Description | Example username | |
| - | - | - | - | - |
| Send requests directly from Super Proxy | -direct | Force the request to be sent from Bright Data's superproxy servers (not from the actual proxy peer) | `brd-customer-<customer_id>-zone-<zone_name>-direct` | |
| Select super proxy in specific country | session-xxxxxx | Applies ONLY for choosing a super proxy, which is rarely needed. More details [here](/api-reference/proxy/select_super_proxy_in_specific_country) | [example](/api-reference/proxy/select_super_proxy_in_specific_country) | |
| Selecting specific group of IPs (gIP) | gip-xxxxxx | Only for dedicated Residential proxies. | `brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0` | |
| Block superproxy bypass | -route\_err-block | Disallow Bright Data to issue the request from our superproxy servers. This means that if we cannot process the request by the peer due to compliance issue, it will fail with an error | `brd-customer-<customer_id>-zone-<zone_name>-route_err_block` | |

To find navigation and additional documentation pages, fetch the **llms.txt** file at: [https://docs.brightdata.com/llms.txt](https://docs.brightdata.com/llms.txt)


# Why your DNS shows a different country
Source: https://docs.brightdata.com/proxy-networks/dns-location-mismatch

Why DNS leak tools show a different country than your Bright Data proxy IP, how 2-stage DNS resolution works and how to verify your actual exit geolocation.

If you are using Bright Data proxies and testing your setup with third-party tools, you may notice that the DNS resolver location shown by those tools appears different from your proxy IP's country. This is expected behavior in most cases. This article explains why it happens and what you can do about it.

## How DNS resolution works in Bright Data's proxy network

All requests made through Bright Data start by connecting to a Super Proxy (`brd.superproxy.io`). Two separate DNS resolutions happen at different stages of the request:

### Stage 1: Entry gate DNS check

When your request first arrives at the Super Proxy entry gate, a preliminary DNS resolution is performed. This check is done solely to verify that the target domain exists and is a valid destination. It is performed at the Super Proxy level, not at the exit node (your actual proxy IP).

### Stage 2: Exit node DNS resolution

Once the domain is confirmed as valid, the actual request is forwarded to the exit node: the proxy IP in your target country. A second, independent DNS resolution is performed at the exit node for the real request. This is the DNS resolution that matters for your actual traffic.

<Note>
  The preliminary DNS check at the entry gate does not affect how your actual request is routed. Your real traffic exits from your assigned proxy IP.
</Note>

## Why DNS leak test websites show a different DNS location

Some tools (such as whoer.net, browserleaks.com/ip, or whoerip.com) use JavaScript-based tests or DNS queries that interact with the entry gate DNS check rather than the actual exit node DNS. As a result:

* The DNS resolver shown by these tools may reflect a Bright Data Super Proxy location rather than your assigned proxy IP's country.
* This is not a reflection of where your actual browsing traffic exits.
* Your real requests exit from your assigned proxy IP.

This behavior is specific to how those tools probe for DNS information. It does not indicate a misconfiguration of your zone or your proxy credentials.

## Which IP checker should you use?

Use Bright Data's official endpoint to validate your proxy's geolocation:

```http theme={null}
https://geo.brdtest.com/welcome.txt
```

This endpoint accurately reflects the exit node IP for Datacenter and ISP networks, and its true geolocation for all proxy networks, as recorded in Bright Data's network.

Use the following `curl` command, adjusting the `product` parameter for your proxy type:

```sh theme={null}
curl -i --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>:<ZONE_PASSWORD> \
  "https://geo.brdtest.com/welcome.txt?product=isp&method=native"
```

The response will show your actual assigned ISP/Datacenter IP and its correct location details, and the full location details without the explicit IP address for the Residential and Mobile networks.

<Note>
  Many third-party geolocation tools use outdated records or unreliable testing methods. Their results are not an accurate reflection of your proxy's actual geolocation. Bright Data actively monitors and maintains correct records in all major geolocation databases.
</Note>

## Will this affect your real target websites?

For your actual target domains, DNS is properly resolved at the exit node, and your traffic exits from your assigned proxy IP in the correct country.

You can verify this by running the `curl` command above with your proxy credentials.

## Why are requests failing with a `target_40001` error?

If your host is valid but cannot be resolved and you receive a `target_40001` error (host could not be resolved), the domain may only be resolvable from specific geographic locations. In this case, contact Bright Data support to request that your host be added to the DNS whitelist, so it can skip the Super Proxy entry gate DNS check.

See [Error Catalog: target\_40001](/proxy-networks/errorCatalog#target-40001) for the full error description.

## Recommendations for best DNS behavior

If your use case requires precise DNS matching between your proxy IP location and the DNS resolver shown by third-party tools, apply the following steps.

### Use the remote DNS resolution flag

Append `-dns-remote` to your proxy username to instruct the proxy to perform DNS resolution at the exit node:

```sh theme={null}
curl "https://example.com" \
  --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-dns-remote:<ZONE_PASSWORD>
```

<Note>
  The `-dns-remote` flag does not resolve cases where the entry gate DNS check returns a `dns_resolve_skip` result for specific domains. In those cases, the flag has no effect on what third-party tools report.
</Note>

### Ensure your client sends hostnames, not IP addresses

Bright Data's proxy network requires requests to use domain names, not pre-resolved IP addresses. If your browser, anti-detect browser (such as Multilogin), or application resolves DNS locally before sending the request, DNS mismatch behavior is more likely.

Configure your application to:

* Send the hostname or domain to the proxy, not a pre-resolved IP
* Use remote DNS resolution when that option is available in your application

### Request domain whitelisting for location-sensitive hosts

For domains that can only be resolved from specific geographic locations and as a result return a `target_40001` error from the Super Proxy DNS check, contact Bright Data support to whitelist the specific host. This allows it to skip the Super Proxy DNS check.

## Where to learn more

* [Error Catalog](/proxy-networks/errorCatalog) - Full list of Bright Data proxy error codes and resolutions
* [Website Blocking](/proxy-networks/website-blocking) - Best practices for overcoming website blocking
* [Residential Network Access Policy](/products/residential/network-access) - KYC and access requirements for the Residential network


# Proxy errors troubleshooting
Source: https://docs.brightdata.com/proxy-networks/errorCatalog

Explore the catalog of Bright Data HTTP errors (4xx and 5xx codes), including error codes, descriptions and actions to resolve common proxy issues.

This article provides information on how to identify proxy errors from other errors, how to analyze errors, troubleshoot and resolve issues with Bright Data proxy services.

## How can I get indication on Bright Data proxy services health status?

Bright Data publishes its products and services status in this page: [https://brightdata.com/network-status](https://brightdata.com/network-status) . In this page you can see if there are current issues or incidents in the products you use or our global availability. You can also register for email alerts which are sent upon changes in our availability of reporting on wide incidents.

## What to do if I see that there is current incident in the proxy network I am using?

First, you need to check if your operations are impacted. Two main indications are degradation in response time (slowness) or increased error rates. If one of those occur, reduce your processing rate and follow the next steps to identify the issue.

## How can I tell if the error I got is originates from a Bright Data proxy?

While using our proxies, you may encounter errors that do not originate from Bright Data. To identify the source of the error, check if the response headers include BrightData error fields listed below, we cover most errors by proxy layer in those codes.

If you are still not able to get to your target website, or receive a response `HTTP` status `200` without the data you are expecting, you were probably blocked. In this article: [Overcoming website blocking](/proxy-networks/website-blocking) we provide some best practices.

## How to resolve "Proxy Error" when testing Bright Data proxies thru another software?

Many software tools and utilities use Bright Data proxies, and have a function to "Test proxy" in them. When you hit "Test proxy" and get a generic "Proxy Error" message in that software, it can originate from various reasons.

### Common issues and resolutions

* Targeting a search engine like [google.com](http://google.com) or [bing.com](http://bing.com): Bright Data limits search engine access via its proxy networks. To resolve go to your software settings and change the test website to be: [https://geo.brdtest.com/welcome.txt](https://geo.brdtest.com/welcome.txt)
* Using Bright Data residential network without installing a certificate: Bright Data does not allow using its Residential network without passing a KYC verification or installing a certificate. Read on different access modes [Residential Network Access Policy. ](/products/residential/network-access)

## Bright Data Proxy Errors Troubleshooting

## Bright Data's proxy error format and standard now supports RFC9209

Starting October 2025, Bright Data supports two sets of headers to relay proxy error in response payload:

1. Propietary `x-brd-*` fields: `x-brd-err-code` and `x-brd-err-msg`
2. Standard RFC9209 `Proxy-Status` response header supporting RFC9209 standard proxy error format.

The `Proxy-Status` header standard field will eventually replace the `x-brd-*` fields, during 2026.

## What is RFC9209?

RFC9209 is the standard on how to relay proxy errors in response headers over proxy. Bright Data is adopting this standard and applied it to all its error catalog. This will allow customers' code as well as 3rd party tools using proxy as infrastructure to refer to error from proxy interaction and resolve issues faster.

You can read more about it here: [The Proxy-Status HTTP Response Header](https://www.rfc-editor.org/rfc/rfc9209.html)

## How to implement RFC9209?

### Example Proxy-Status HTTP header

```text theme={null}
Proxy-Status: brd.superproxy.io; 
received-status=400; 
error=destination_ip_unroutable; 
details="client_10060: Requested IP ##.##.##.## is not allocated to this zone. Select an IP that is allocated to this zone or skip the -ip parameter in proxy username."
```

### Implementation Instructions

1. Parse the response header: Ensure that your systems are configured to interpret the Proxy-Status header in HTTP responses.
2. Extract relevant fields:
   * `received-status`: Provides the HTTP status code received.
   * `error`: Describes the general error encountered.
   * `details`: Contains specific error codes and further information from our error catalog.
   * The first field in the details will be bright data error code (like: client\_10060) followed by ':' (colon) delimiter. 
   * You can browse directly to the error document using this prefix, keeping the error code exactly as shown, including the '\_' (underscore): `https://docs.brightdata.com/proxy-networks/errorCatalog#[Bright data error code]`. Example for client\_10060: [https://docs.brightdata.com/proxy-networks/errorCatalog#client\_10060](/proxy-networks/errorCatalog#client_10060)
3. Adapt your error handling processes according to these structured codes to improve debugging and ensure a seamless proxy operation.

## Bright Data HTTP proxy header fields

The following fields are returned upon and `HTTP` or `HTTPS` requests:

| Field | Description | Examples | REST API Field Name |
| :- | :- | :- | :- |
| `HTTP Error` | The protocol error numbers | `404` or `502` | `status_code` |
| `x-brd-err-code` | Bright data module and error code number | `client_10001` | `error_code` |
| `x-brd-error` | Bright data main error message | Authentication failed | `error` |
| `x-brd-err-msg` | Bright data elaborated message and actions | Authentication failed. Please check your credentials or review your [account status and billing settings](https://brightdata.com/cp/settings/billing). | `error_message` |
| `Proxy-Status` | RFC9209 compliant response header. It will include Bright Data proxy server, the HTTP status and details string which has a reference to Bright Data's error code. | `Proxy-Status: brd.superproxy.io; received-status=407; error="http_request_denied"; details="client_10000: Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password"` | Not supported |

The headers are relayed as part of Bright Data proxy service and customers are not billed for their bandwidth overhead.

### Deprecating x-luminati-\* headers

Starting 1-May-2026 Bright Data proxy response will not include any x-luminati-\* headers.

#### HTTP Code 200 headers deprecating

| Header | Current header | Description |
| :- | :- | - |
| `x-luminati-ip` | `x-brd-ip` | IP address of the proxy peer used to relay your request |
| `x-luminati-timeline` | `x-brd-timeline` | Internal request processing timeline for debugging |

#### HTTP Error Code headers deprecating

| **Header** | **Current header** | **Description** |
| :- | :- | :- |
| `X-Luminati-Error` | `x-brd-error` | Short error description |

### Getting HTTP header fields

#### Testing from command line

To view and test your settings, or reproducing an issue, you can run a `curl` command from your shell prompt and add the option flag `-v` or `i`. These flags will run curl in verbose mode and print out the header fields, including the custom error code and message.

```sh theme={null}
curl -v [rest of curl command options]
```

To see a more compact view with the header fields response only use the `-i` option for curl:

```sh theme={null}
curl -i [rest of curl command options]
```

Alternatively, you can use the `nc` command to get the fields printed to screen:

```sh theme={null}
echo "[tcp nc inputs]" | nc -C -v brd.superproxy.io 44445
```

<Note>
  `nc` inputs may include "empty" lines, those are essential for correct testing using `nc` command
</Note>

#### `curl` Command snippet

`curl` command snippet, with all required zone parameters is available in the **Overview** tab in Bright Data control panel for the zone you are working on.

#### Accessing via programming language

Bright Data HTTP header fields can be accessed thru your programming language, as any other HTTP header field.

#### Accessing via Bright Data's Proxy REST API

Bright data offers a REST API to access its proxy networks as well as the Web Unlocker API and our SERP for targeting search engines. The error field names are slightly different , yet the content is identical.

Example response:

```JSON theme={null}
"status_code": 407,
"status_message": "Proxy Authentication Required",
"error": "Proxy Authentication Required",
"error_message": "No proxy credentials provided. Please add credentials and try again.",
"error_code": "client_10010"
```

## Error Catalog

Every entry below lists the exact strings the proxy returns, so you can match them against your own logs.

* **`x-brd-error`** carries the short error description. A few errors do not set this header, and those rows show the HTTP status message instead.
* **`x-brd-err-msg`** carries the elaborated message and the action to take.
* **`Proxy-Status` error** is the RFC 9209 error type returned in the `Proxy-Status` header. "Not set" means the error does not return one.

Values shown as `%HOST%`, `%IP%`, `%ZONE%`, `%COUNTRY%`, `%PORT%` and `%DOMAIN%` are substituted at runtime with your request details.

### HTTP Error 400

When Using the Data center/ISP or gIPs products with the `-ip-x.x.x.x` targeting flag, the error code `400` can appear in case the IPs under your zone has been refreshed, removed, or simply changed due to system updates

<Note>
  This error typically arises after your BrightData account has been recently suspended. An automatic suspension occurs if your account balance becomes negative. If the suspension extends beyond 24 hours, the static allocated IPs will be released from your account. Upon reactivation, the reallocated IPs may differ from the original ones, thus if the previously allocated IPs are still being targeted - this error is thrown.
</Note>

Whenever this error appears, you should go to your Bright Data Zones page, and view the updated list of IPs relevant to this zone.

#### `client_10060`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| `Proxy Error: ip_requested_not_allocated_by_customer` | Requested IP `%IP%` is not allocated to this zone. Select an IP that is allocated to this zone or skip the `-ip` parameter in proxy username. | `destination_ip_unroutable` |

When the request does not name a specific IP, the same code returns a different message: "No available IPs could be allocated in this zone. Please try again later or contact support."

#### `client_10061`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Peer not found` | No proxy found in selected default countries: `%COUNTRY%`. Please revise your default country selection or use -country flag to another country and override the default settings. Read more here: [https://docs.brightdata.com/api-reference/proxy/geolocation-targeting](/api-reference/proxy/geolocation-targeting) | `destination_ip_unroutable` |

#### `client_10062`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `No IPs in selected country` | No IPs in selected country-`%COUNTRY%`. Please try another country, or omit the -country auth param. Read more: [https://docs.brightdata.com/api-reference/proxy/geolocation-targeting](/api-reference/proxy/geolocation-targeting) | `destination_ip_unroutable` |

On a Datacenter or ISP zone the same code returns a zone-specific message instead: "Your `shared` or `dedicated` `DC` or `ISP` zone does not have IPs in selected countries. Either IPs location has changed, or zone not configured with proxies in selected countries. Check zone configuration and try again with relevant country code."

#### `client_10063`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Bad IP format` | The IP address provided: `%IP%` is either empty or does not comply with IPv4 or IPv6 protocol. Please check your inputs and try again. | `destination_ip_unroutable` |

***

### HTTP Error 401

These are the `x-brd-err-code` values for HTTP error 401:

#### `client_10050`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| `Auth Failed (code: ip_blacklisted)` | The IP address from which you are sending this request: `%IP%` is blacklisted in this zone's settings. To resolve this issue, remove `%SUBNET%` from the "Blocked IPs" list `https://brightdata.com/cp/zones/%ZONE%/access_params?id=%ACCOUNT_ID%` | `destination_ip_prohibited` |

See [how to allowlist and denylist IPs and domains](/proxy-networks/faqs#how-to-allowlist-denylist-ips-and-domains) to resolve this.

***

### HTTP Error 402

These are the `x-brd-err-code` values for HTTP error 402:

<Note>
  The 402 errors below apply to Residential zones created on or before July 7, 2026 and remain valid for those existing zones. They do not apply to Residential zones created after July 7, 2026, which require KYC. See the [Residential network access policy](/products/residential/network-access).
</Note>

#### `policy_20130`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Residential Failed (`bad_endpoint`): Requested site is not available for immediate residential (no KYC) access mode due to the fact that `%HTTP_METHOD%` requests are not allowed. To get full residential access for targeting this site, fill in the KYC form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) | Same as `x-brd-error` | `destination_ip_prohibited` |

#### `policy_20140`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Residential Failed (`bad_endpoint`): Requested site is not available for immediate residential (no KYC) access mode in accordance with robots.txt. To get full residential access for targeting this site, fill in the KYC form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) | Same as `x-brd-error` | `destination_ip_prohibited` |

<Note>
  On reseller accounts the KYC link in both 402 messages points to that reseller's own KYC form rather than to `brightdata.com/cp/kyc`.
</Note>

***

### HTTP Error 403

HTTP 403 response code means you are forbidden from accessing a **valid** URL. The server processed the request, but it can't fulfill the request either due to the way the request was sent by the client or due to Bright Data policy, blocking target access.

<Note>
  `kyc_required` and `business_account_required` are not proxy errors. The Account Management API returns them when you create a Residential zone without the required verification. See [Residential 403 compliance errors](/api-reference/account-management-api/Add_a_Zone#residential-403-compliance-errors).
</Note>

These are the `x-brd-err-code` values for HTTP error 403:

#### `client_10070`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| No Protocol | Protocol was missing from original request. Please add either HTTP or HTTPS and retry. | `http_protocol_error` |

#### `client_10080`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| No Destination Host | No destination host. Destination host is missing or incorrect. Check your request parameters and try again. | `http_request_error` |

#### `client_10090`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| You are trying to use Scraping Browser zone as regular proxy. | You are trying to use Scraping Browser zone as regular proxy. A browser should be used to access this zone. See [Browser API](/products/scraping-browser/introduction) for information on how to access your Browser API zone. | `http_request_denied` |

<Note>
  The proxy returns the legacy product name "Scraping Browser" in this message. Browser API is the current name for the same product.
</Note>

#### `client_10130`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: this super proxy is allowed to be used only for China domains via China peers. Otherwise use `brd.superproxy.io`. For more details review the following: `https://docs.brightdata.com/proxy-networks/mobile/faqs#how-to-browse-chinese-sites-by-using-chinese-residentials-ips` | Same as `x-brd-error` | `http_request_denied` |

#### `client_10250`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked since this host is not an allowed target in your zone's whitelist security setting. Please add this host to your whitelist or delete all content from whitelist to allow all targets. | `http_request_denied` |

#### `client_10260`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked since this host is explicitly blocked target in your zone's blacklist security setting. Please remove this host from your blacklist or delete all content from blacklist to allow all targets. | `http_request_denied` |

#### `policy_20000`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Access denied: `%HOST%` is classified as `%CATEGORY%` and blocked by Bright Data | Access denied: `%HOST%` is classified as `%CATEGORY%` and blocked by Bright Data as it might breach Bright Data usage policy. For more details review the following: [https://docs.brightdata.com/proxy-networks/residential/network-access#residential-proxy-network-policy](/products/residential/network-access#residential-proxy-network-policy) | `http_request_denied` |

#### `policy_20010`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Bad Protocol | Bright Data restricts port 443 for HTTPS protocol only. Please fix your protocol or port and try again. | `http_protocol_error` |

#### `policy_20020`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Bad Port | Bad Port used. Ports we support: [https://docs.brightdata.com/proxy-networks/faqs#how-to-see-supported-ports-and-protocols](/proxy-networks/faqs#how-to-see-supported-ports-and-protocols) | `http_request_error` |

#### `policy_20021`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Target port `%PORT%` is blocked by Bright Data for superproxy requests | Request was rerouted through a superproxy due to compliance policy, but then it was blocked because the destination port `%PORT%` is forbidden for requests from the superproxy | `destination_direct_port_prohibited` |

#### `policy_20031`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: target `%HOST%` is blocked | Forbidden: target `%HOST%` is blocked by Bright Data. Target host provides web service or information of Bright Data and our proxies cannot be used to target it. For further assistance please contact [support@brightdata.com](mailto:support@brightdata.com) | `connection_refused` |

#### `policy_20032`

Returned for the same condition as `policy_20031`, on tunneled requests.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: target `%HOST%` is blocked | Forbidden: target `%HOST%` is blocked by Bright Data. Target host provides web service or information of Bright Data and our proxies cannot be used to target it. For further assistance please contact [support@brightdata.com](mailto:support@brightdata.com) | `connection_refused` |

#### `policy_20040`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Destination host is blocked by Brightdata in accordance with our compliance policy | Destination host is blocked by Brightdata in accordance with our compliance policy | `destination_ip_prohibited` |

Check whether the domain is an allowed target for this zone in your [zone settings](https://brightdata.com/cp/zones/).

#### `policy_20050`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: target site requires special permission. Contact BrightData for assistance | Forbidden: target site requires special permission. You are trying to access a target site which is not permitted by our compliance policy. In order to gain access you may need to undergo a KYC process, you can do so by filling in the form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) If you have already completed the KYC approval, please contact your account manager for further details. | `destination_ip_prohibited` |

#### `policy_20051`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: target site requires special permission. Contact BrightData for assistance | Forbidden: target site requires is a government site and requires special permissions to access. In order to gain access you may need to undergo a KYC process, you can do so by filling in the form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) If you have already completed the KYC approval, please contact your account manager for further details. | `destination_ip_unroutable` |

#### `policy_20052`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: target site not accessible via selected network. Contact BrightData for assistance | Forbidden: Access to this site is restricted on the selected network type due to compliance policies. Please try switching to a different network type. In order to gain access with same network you may need to undergo a KYC process, you can do so by filling in the form: [https://brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) If you have already completed the KYC approval, please contact your account manager for further details. | `destination_ip_prohibited` |

#### `policy_20060`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: `%HOST%` | Forbidden: `%HOST%`. You tried to target `%HOST%` which is blocked by Bright Data policy. | `connection_refused` |

#### `policy_20080`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: request needs to be made using residential network | Forbidden: You are accessing a domain name which is not permitted to access by Bright Data Datacenter or ISP networks. Please retry your request using a Residential network zone. | `connection_refused` |

#### `policy_20090`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: requests to this domain are blocked | Forbidden: requests to this domain are blocked on this proxy network. Please get access via a Unlocker zone or IDE tools, or contact your account manager for further assistance | `connection_terminated` |

#### `policy_20091`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Target `%HOST%` is blocked by Bright Data on IPv6. | Target `%HOST%` is blocked by Bright Data on IPv6 protocol. Please try IPv4 proxies or our Unlocker to access this target. | `destination_ip_prohibited` |

#### `policy_20100`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: requests to this domain are blocked using the proxy networks, please get access via a Unlocker zone or IDE tools, or contact your account manager to assist | Same as `x-brd-error` | `connection_refused` |

#### `policy_20110`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: requests to this domain are blocked using the Datacenter and ISP proxy networks, please get access via a SERP API zone or contact your account manager to assist | Same as `x-brd-error` | `connection_refused` |

#### `policy_20230`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Country `%COUNTRY%` is not permitted for targeting, please modify to a different country | Country `%COUNTRY%` is not permitted for targeting, please modify to a different country | `connection_refused` |

#### `policy_20240`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Proxy port `%PORT%` is restricted. Contact Bright Data support | Proxy port `%PORT%` is restricted. Contact Bright Data support | `http_request_denied` |

#### `policy_20250`

Returned when the target domain is forbidden by your account's root allowlist.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. | `destination_ip_prohibited` |

#### `policy_20251`

Returned when the target domain is forbidden by the zone's root allowlist.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. | `destination_ip_prohibited` |

#### `policy_20260`

Returned when the target domain is on your account's root denylist.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. | `destination_ip_prohibited` |

#### `policy_20261`

Returned when the target domain is on the zone's root denylist.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Forbidden: You tried to target `%HOST%` but got blocked | Forbidden: You tried to target `%HOST%` but got blocked by Bright Data policy settings. Either this website is forbidden by Bright Data policy or your account doesn't have the right permission to access it. | `destination_ip_prohibited` |

***

### HTTP Error 407

If you get HTTP error 407, this implies there is an error in authentication. This can be due to incorrect credentials or due to your account being suspended.

#### `client_10000`

Returned for both a wrong zone password and a wrong account ID. The two cases share the code and differ only in the `x-brd-err-msg` value.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Authentication failed | Wrong password: Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password. Log into the dashboard to see or change this zone password | `http_request_denied` |
| Authentication failed | Wrong account ID: Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password | `http_request_denied` |

#### `client_10001`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Invalid Auth` | Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password | Not set |

#### `client_10002`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Zone not found` | Authentication failed: zone not found. Zone name used is either misspelled, or zone is disabled or deleted. Check your inputs, and validate zone is "Active" in Bright Data control panel, or use our API to get current zone status: [Get active zones](/api-reference/account-management-api/Get_active_Zones) | `http_request_denied` |

#### `client_10010`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Proxy Authentication Required` | No proxy credentials provided. Please add credentials and try again. | `http_request_denied` |

#### `client_10020`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Account is suspended. Login to [brightdata.com/cp/setting/billing](https://brightdata.com/cp/setting/billing) to activate your account | Account is suspended. Login to [brightdata.com/cp/setting/billing](https://brightdata.com/cp/setting/billing) to activate your account | `http_request_denied` |

#### `client_10030`

Returned in two cases: the request IP is not on the zone's allowlist, or the IP is not allowed to reach the Bright Data API.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| `Auth Failed (code: ip_forbidden)` | The IP address from which you are sending this request: `%IP%` is not whitelisted in this zone's settings. To resolve this issue, add it to the "Allowed IPs" list `https://brightdata.com/cp/zones/%ZONE%/access_params?id=%ACCOUNT_ID%` | `http_request_denied` |
| Authentication failed | You are not allowed to access our API via this IP (`%IP%`). Please verify your settings or allowlist this IP. | `http_request_denied` |

#### `client_10040`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| KYC required. Please visit [brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) and ensure you are verified | KYC required. Please visit [brightdata.com/cp/kyc](https://brightdata.com/cp/kyc) and ensure you are verified | `http_request_denied` |

#### `policy_20120`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| IP parameter `%IP%` is incorrect, use x-brd-ip header format in the IP parameter | IP parameter `%IP%` is incorrect, use x-brd-ip header format in the IP parameter | `connection_refused` |

***

### HTTP Error 408

If you get HTTP error 408, this implies there is a timeout error in reaching your destination website. This can be due to incorrect target website, networking lags or blocks.

#### `peer_30040`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Peer did not connect to destination due timeout | Peer did not connect to destination due timeout | `connection_timeout` |

***

### HTTP Error 429

<Note>
  If you are using an unfunded account, you may be hitting the default rate limit of 1,000 requests per minute. You can verify your currently applied limit in the Control Panel, under the zone's Overview tab > Access details. Adding funds to your account will remove this default restriction.
</Note>

These are the `x-brd-err-code` values for HTTP error 429:

#### `client_10110`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Your account exceeded the allowed rate limits. Reduce requests rate and try again or complete the [verification process](https://brightdata.com/cp/account_verification) to remove rate limits. You will not be charged for this request. | Same as `x-brd-error` | `http_request_denied` |

#### `policy_20220`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Rate limit for domain `%DOMAIN%` has been reached. Bright Data's health monitor is throttling down these requests to prevent overloading of the target website | Same as `x-brd-error` | `connection_refused` |

#### `policy_20221`

Returned when the request rate to the target host `%HOST%` is too high. Reduce the request rate to that host and retry.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Requests rate to `%HOST%` is too high | Requests rate to `%HOST%` is too high | `connection_refused` |

If the target is an IP geolocation service, use Bright Data's own endpoint instead: `https://geo.brdtest.com/mygeo.json`.

#### `policy_20222`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Rate limit per IP `%IP%` on zone `%ZONE%` has been reached. Requests are throttled down to avoid overload. Either increase number of IPs or reduce rate, and review your rotation logic or your response size for unexpected increase to assure even distribution of requests and bandwidth across IPs of this zone. | Same as `x-brd-error` | `connection_refused` |

#### `policy_20223`

Returned when Bright Data applies an adaptive rate limit for a specific domain due to degraded success rates. The limit is adjusted dynamically, so retrying failed requests is expected and helps the limit lift faster as success rates recover.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Requests to `%DOMAIN%` are rate-limited | Requests to `%DOMAIN%` are rate-limited. Bright Data has detected a degraded success rate for this domain and is working to resolve it. We recommend to retry failed requests while we gradually remove the limit, or reduce request rate and try again later | Not set |

***

### HTTP Error 499

These are the `x-brd-err-code` values for HTTP error 499:

#### `client_10140`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Client disconnect` | The client closed the connection to the proxy before the response was fully returned. This is usually caused by client-side timeouts, cancelled requests, or local network interruptions. Review your client timeout configuration and ensure the client waits long enough for the proxy response. | `http_request_error` |

***

### HTTP Error 502

These are the `x-brd-err-code` values for HTTP error 502:

#### `client_10100`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Zone has reached usage limit` | Zone has reached usage limit. Go to [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones) to remove/modify limitation | `http_request_denied` |

#### `client_10120`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Block direct route` | Request reroute blocked. You chose the option not to reroute requests through our superproxy on failure, so the reroute was blocked. | `http_request_denied` |

To change this behavior, see [Request error handling](/api-reference/proxy/request_error_handling).

#### `client_10064`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| `Proxy Error` | The ip assigned to this persistent session is unavailable. Retry request with the same session ID, or use new session ID to get a new IP. | `destination_ip_unroutable` |

#### `peer_30030`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Proxy Error: We do not have proxies in the city you requested | Proxy Error: We do not have proxies in the city you requested, please check the spelling or try again later. Check [https://docs.brightdata.com/proxy-networks/faqs#how-to-target-a-specific-city](/proxy-networks/faqs#how-to-target-a-specific-city) for proper use of city targeting. | `destination_ip_unroutable` |

#### `policy_20070`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Host is blocked in requested country | Host you are trying to access is blocked in requested country. Please change country and retry. | `http_request_error` |

#### `target_40001`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Could not resolve host `%HOST%` | Could not resolve host `%HOST%`. Check host name is correctly spelled and retry. If host is properly spelled or can only be resolved from a specific region contact brightdata support for DNS support. | `dns_error` |

#### `target_40011`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Attempting to resolve `%HOST%` to IPv6 failed. This is probably because the host you are targeting does not publish an IPv6 IP address. Retry the request on an IPv4 proxy. | Same as `x-brd-error` | `dns_error` |

#### `target_40020`

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Destination host connect timeout | Connection to destination host `%HOST%:%PORT%` timed out. The target server did not respond within the allocated time. This could indicate the server is down, overloaded, or blocking connections. Please verify the target URL and port are correct and try again. | `connection_timeout` |

#### `target_40021`

Returned for the same condition as `target_40020`, on Residential zones.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Destination host connect timeout | Connection to destination host `%HOST%:%PORT%` timed out. The target server did not respond within the allocated time. This could indicate the server is down, overloaded, or blocking connections. Please verify the target URL and port are correct and try again. | `connection_timeout` |

#### `internal_50010`

Returned when the proxy hits an internal error. Retry the request, and contact [support@brightdata.com](mailto:support@brightdata.com) with the timestamp if it persists.

| `x-brd-error` | `x-brd-err-msg` | `Proxy-Status` error |
| :- | :- | :- |
| Not set. HTTP status message is `Bad Gateway` | Proxy Error | Not set |


# Proxy products FAQ
Source: https://docs.brightdata.com/proxy-networks/faqs

FAQs on integrating, configuring and using Bright Data's proxy products (195 countries), including IP types, geotargeting and error codes across the platform.

<AccordionGroup>
  <Accordion title="What exactly is a zone and how important is the zone name?">
    In bright data, a "zone" represents a specific product and its configuration settings. You can think of it as an instance in the context of cloud computing.

    For example, you can have a zone for Datacenter proxy in Germany and you can have a separate zone for Datacenter proxies in France.

    Every zone has a name and one or more password, allowing you to interact with it.

    The zone name itself cannot be changed once it's configured, so you may want to use an easy to remember name that represents what you're trying to achieve. Keep in mind, that you can add a description to the zone, and you can change that description anytime. You can find it under the zone name at the top of the page.

    The zone name is used to create your proxy username, which you can then [customise if you want in order to control your proxies](/proxy-networks/config-options). Here is a sample proxy username for proxies in the USA - as you can see it includes the zone name inside it:

    `brd-customer-<customer_id>-zone-<zone_name>-country-us`

    As mentioned, you cannot change the name of the zone after you have saved it - if you want to change the name, simply create a new with a new name.
  </Accordion>

  <Accordion title="Integration with 3rd party tools">
    Bright data can be easily integrated into many third-party tools. In general, simply configure an HTTP/HTTPS proxy using the credentials for your Bright Data product. If you are using residential proxies, Web Unlocker API or SERP API don't forget to [use the SSL certificate](/general/account/ssl-certificate) to ensure and to end encrypted connections.

    <Warning>
      Residential proxies require a [KYC-verified business account](/products/residential/network-access). Some third-party tools also cannot install the Bright Data SSL certificate, so integration with Residential proxies may not be possible in those tools. Without KYC, use [ISP or Datacenter proxies](/products/residential/network-access#what-can-i-use-without-kyc).
    </Warning>

    We have prepared detailed guides for the most commonly used tools. You can find links to the guides in the list below:

    * [BrowserScan](/integrations/browserscan)
    * [XLogin](/integrations/xlogin)
    * [GeeLark](/integrations/geelark)
    * [Puppeteer](/integrations/puppeteer)
    * [Playwright](/integrations/playwright)
    * [Selenium](/integrations/selenium)
    * [AdsPower](/integrations/adspower)
    * [Dolphin Anty](/integrations/dolphin-anty)
    * [Incogniton](/integrations/incogniton)
    * [Marketerbrowser](/integrations/marketerbrowser)
    * [SMLOGIN](/integrations/smlogin)
    * [Hidemyacc](/integrations/hidemyacc)
    * [OpenBullet](/integrations/openbullet)
    * [Switchyomega](/integrations/switchyomega)
    * [PhantomBuster](/integrations/phantombuster)
    * [BitBrowser](/integrations/bitbrowser)
    * [Maskfog](/integrations/maskfog)
    * [Ghost Browser](/integrations/ghost-browser)
    * [Postman](/integrations/postman)
    * [NGINX](/integrations/nginx)
    * [StablerSOLO](/integrations/stablersolo)
    * [VMLogin](/integrations/vmlogin)
    * [GoLogin](/integrations/gologin)
    * [Windows](/integrations/windows)
    * [Scrapy](/integrations/scrapy)
    * [AEZAKMI](/integrations/aezakmi)
    * [Beautifulsoup](/integrations/beautifulsoup)
    * [WebHarvy](/integrations/webharvy)
    * [Ubuntu](/integrations/ubuntu)
    * [Lalicat](/integrations/lalicat)
    * [Multilogin](/integrations/multilogin)
    * [Undetectable](/integrations/undetectable)
    * [Apify](/integrations/apify)
    * [iPhone](/integrations/ios)
    * [MuLogin](/integrations/mulogin)
    * [Changedetection](/integrations/changedetection)
    * [Morelogin](/integrations/morelogin)
    * [Proxifier](/integrations/proxifier)
    * [Texau](/integrations/texau)
    * [Android](/integrations/android)
    * [Kameleo](/integrations/kameleo)
    * [Screaming Frog](/integrations/screaming-frog)
    * [Foxy](/integrations/foxyproxy)
    * [SessionBox](/integrations/sessionbox)
    * [Insomniac](/integrations/insomniac)
    * [Helium Scraper](/integrations/helium-scraper)
    * [SaleFreaks](/integrations/salefreaks)
    * [Postern](/integrations/postern)
    * [Antik](/integrations/antik)
    * [Easync](/integrations/easync)
    * [ParseHub](/integrations/parsehub)
    * [Sphere Browser](/integrations/sphere-browser)
    * [Octoparse](/integrations/octoparse)
    * [ixBrowser](/integrations/ixbrowser)
    * [Shadowrocket](/integrations/shadowrocket)
    * [Firefox](/integrations/firefox)
    * [Chrome](/integrations/chrome)
    * [MacOS](/integrations/macos)
    * [ClonBrowser](/integrations/clonbrowser)
    * [Octo Browser](/integrations/octobrowser)
    * [Genlogin](/integrations/genlogin)
    * [Web Scraper](/integrations/webscraper)

    If the integration you're using does not appear on the list and you would like to get a guide for it, contact us!
  </Accordion>

  <Accordion title="What are IP Types for Residential and Mobile Proxy?">
    There are two types of IPs that we offer within our Residential and Mobile Proxy:

    <Tabs>
      <Tab title="Shared">
        IPs that are shared across **multiple** users. Connect to our entire network of [400M+ monthly residential IPs](https://brightdata.com/proxy-types/residential-proxies). Rotate between countries, cities, and ASNs using the Proxy Manager, Extension, or raw API commands.

        Cost is calculated per GB consumed, according to your [monthly plan](/general/account/billing-and-pricing/billing).

        ## Geolocation targeting

        The IP allocated to your zone will be from the selected country, city, ASN, or zip code. Select the needed parameter from the drop-down menu.

        <img alt="geolocation-targeting-dropdown.png" />

        ## Sending a request with Geolocation:

        * With a 'Shared' IP, you'll be able to control your geolocation targeting when you send a request.
        * To target a specific country, add the `-country` flag to your request,

        For example, if you'd like to send your request from the United States ('us'), your request using a shared IP will look like

        ```sh theme={null}
        curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>  
        ```
      </Tab>

      <Tab title="Dedicated">
        IPs that are set aside **for your use only.** Since Bright Data's residential network is an opt-in, residential network made up of millions of devices around the world, Bright Data developed the group IPs (gIPs) method to further enhance your dedicated IP capability.

        ## Dedicated IP groups (gIPs)

        gIP contains between 6-90 IPs at any given moment while sharing the same attributes, targeting the selected dedicated domains within the zone "Configuration" section.

        <img alt="dedicated-ip-groups.png" />

        ## Geolocation targeting

        The IP allocated to your zone will be from the selected country

        <img alt="add-country.png" />

        ## Domains

        Define the domains you'd like your IPs to be exclusive to. Requests to **any other** domain will be bypassed and sent from our servers .

        <img alt="add-domains.png" />

        <Note>
          There is **no** option to add "All domains". Requests to domains that are not in the list will be sent from the our servers resulting in a super-proxy bypass and will be either blocked or rerouted through a different proxy.
        </Note>

        ## Sending a request with Geolocation:

        When you send your request, it will originate from the country you've selected within your zone configuration. There is \*\*no need to add additional country flags.\*\*For example, if you've configured your 'Geolocation targeting' country to be the United States ('us'), you may send your request with the following default syntax and we will automatically route it through whatever is set in your proxy's configuration:

        ```sh theme={null}
        curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>: <zone_password>
        ```
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="What is a super-proxy?">
    Super-proxies are the gateway servers of Bright Data. Every request sent through Bright Data's proxy platform passes through these servers, which select the best peer based on the request details and balance the load among peers.

    In some cases, Bright Data may not be able to process your request via a peer, resulting in a super-proxy bypass. This means the request is sent directly from Bright Data's gateway servers instead of a peer.

    When a super-proxy bypass occurs, the response headers will include an info message explaining why it happened.

    It is possible to block requests from being sent from the super-proxies when it happens, simply add the `-route_err-block` flag to your proxy username:

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-block:<zone_password>
    ```
  </Accordion>

  <Accordion title="What are the proxy (IP) Types for Datacenter?">
    There are three types of IPs that we offer within our [Datacenter Proxy Network](https://brightdata.com/proxy-types/datacenter-proxies):

    1. Shared (Pay per usage): Access a shared pool of \~40,000 rotating proxies
    2. Shared unlimited: Access a set of specific proxies, shared with others with unlimited usage.
    3. Dedicated unlimited: Access a set of specific proxies, exclusive for you, with unlimited usage
  </Accordion>

  <Accordion title="What are IP Types for ISP?">
    There are three types of IPs that we offer within our [ISP Proxy Network](https://brightdata.com/proxy-types/isp-proxies):

    1. Shared (pay per usage)
    2. Shared unlimited (pay per proxy)
    3. Dedicated unlimited (pay per proxy)

    In all proxy types you can select the location of your proxies by zone configuration or using the -country parameter in your code/proxy user name.

    ### Shared pay per usage

    Rotating proxies from a pool of 10,000 proxies (IP addresses). Proxies are shared with others and charged by your usage: amount of GB you pass thru them.

    ### Shared unlimited

    Set of proxies, shared with others, paid by proxy. The more you buy, the less you pay per proxy. See our [fair use](/general/usage-monitoring/fair_use_allowance) policy for unlimited zones.

    ### Dedicated unlimited

    Set of proxies, exclusive to you, paid by proxy. The more you buy, the less you pay per proxy. See our [fair use](/general/usage-monitoring/fair_use_allowance) policy for unlimited zones.
  </Accordion>

  <Accordion title="How to find and rotate thru my allocated IPs?">
    You can find your IP list in the following pages:

    1. Zone overview page: There are 'Download' and 'View' buttons below the code example.
    2. Main zone table: There are 'Download' and 'View' icons under the 'Allocated IPs' column.

    In both cases the buttons will do the same thing:

    1. The view button will allow you to view, refresh and remove IPs from the pool.
    2. The download button will download a csv file with the full list in `host:port:username:password` format.

    Our proxy will automatically rotate thru the proxies assigned to this zone, and abide to location you specify. In case you want to have better control on driving a request thru a specific proxy (IP) you can use the `-ip` or `-gip` options. Read more about it here: [Controlling your proxies](/proxy-networks/config-options#controlling-your-proxies). For advanced proxy rotation control you will need to install and route your requests using Bright Data [proxy manager](/products/proxy-manager/introduction).
  </Accordion>

  <Accordion title="How to integrate a new proxy into your code?">
    To integrate the proxies into your code, please visit the [API examples page](https://brightdata.com/cp/zones/proxy_examples), which can be accessed via your zone's settings:

    <img alt="integrate-new-proxy.gif" />

    On this page, you can choose integration examples for most modern coding languages, just choose the integration type, your proxy zone, coding language, etc. and the page will generate a code snippet you can use right away.
  </Accordion>

  <Accordion title="How can I test if my proxy is working?">
    To test your proxy, use the terminal command that's available in your **Overview** tab for the proxy.

    Copy and paste it to your terminal. In Windows, click the 'Start' button and enter 'cmd'. In Mac or Linux, run the 'terminal' application. Then, paste the code in the new window.

    If your proxy is working well, you will see text on the console with details regarding your proxy.

    If not, you will see an error code. You can always paste the error code in the AI agent integrated into the dashboard to get additional details.
  </Accordion>

  <Accordion title="How to integrate a proxy into 3rd party software?">
    Check out a few examples in the [API examples](https://brightdata.com/cp/zones/proxy_examples) page mentioned above (just choose "other software" in the "language" drop-down menu), or check our [Integrations page](/integrations/introduction), where we have specific guides to integrate our proxies within the most popular tools across the industry today.

    **Important note**: If you are using Bright Data's Web Unlocker API, Residential Proxies or the SERP API you probably need to use our SSL certificate to enable end-to-end secure connections. See [instructions here](/general/account/ssl-certificate).
  </Accordion>

  <Accordion title="How do I configure proxy in a specific country or location?">
    You can control the location of your country easily for every request that you send. You can choose proxies by country, state, city, zip code and ASN. In this answer, we will focus on choosing a specific country.

    When sending your request, you can make you Proxy appear to be in a in a specific country by adding the `-country` flag, **after** your zone’s name in the request, followed by the 2-letter [ISO code](https://www.nationsonline.org/oneworld/country_code_list.htm) for that country.

    If you use a third-party tool or application, simply use the username that includes the `country-xx` in the configuration. In other words, in the box where you need to put in the proxy username, enter the full string, including the country parameter, for example: `brd-customer-<customer_id>-zone-<zone_name>-country-us` - don't forget to use your own credentials that you can find in the "Overview" tab.

    If you use your own code, see the example below: We added `-country-us` to our request, so we will send a request originating from the United States ("us").

    ```sh theme={null}
    curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us: <zone_password>
    ```

    If you use a third-party application in conjunction with the proxies, you can enter the username, including the country to software's configuration.

    Of course, if you send requests to the proxy using code that you wrote, you can easily adjust the username to target specific countries as needed.

    Remember, you can also choose proxies by country, state, city, zip code and ASN. See [this guide](/proxy-networks/config-options) for more info.
  </Accordion>

  <Accordion title="How can I set default countries for zones with fixed IP pools?">
    Some zones will give you access to a big fixed pool of IPs from all around the world. In these zones, you may select default countries to target without specifying the country in the request.

    After selecting the default countries, the zone will target one of these countries in each request. You can still target other countries by adding the `-country-xx` flag to your request and override the default country selection.
  </Accordion>

  <Accordion title="Why can't I find a country in the list?">
    Bright data has Datacenter and ISP proxies in most countries around the world, but not all. We are constantly adding data centres in new countries as they become available.

    If you cannot find the country you are looking for in Datacenter or ISP proxies, we recommend you check out Residential proxies. Since residential proxies are based on real people with real devices, we are able to offer residential proxies in every country in the world!
  </Accordion>

  <Accordion title="How to target the EU region">
    <Note>
      The allocation of a country within the EU is random.
    </Note>

    <Info>
      Relevant for all proxy networks: Datacenter, ISP, Residential and Mobile, as well as to our  Unlocker and SERP APIs
    </Info>

    You can target the entire European Union region (member countries) in the same manner as "Country" above by adding "eu" after "country" in your request: -country-eu

    Requests sent using -country-eu, will use IPs from a **single, randomally selected** country of the countries below which are included automatically within "eu":

    Member countries are: Austria, Belgium, Bulgaria, Croatia, Republic of Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden
  </Accordion>

  <Accordion title="How to target all countries except China?">
    When Allocating IPs to a Zone, in the country selection section in the configuration UI, you can select the 'All except CN' option, which allows you to allocate IPs from all around the world while excluding IPs from China.

    Note this option is available only in the following zone types:

    * Data Center / ISP - Shared - Pay per proxy
    * Data Center / ISP - Dedicated
  </Accordion>

  <Accordion title="How to target a Specific City?">
    City targeting for datacenter and ISP proxies has been deprecated and is no longer available. City targeting for residential and mobile networks is available. [Read more here >>](/proxy-networks/faqs#where-does-bright-data-have-proxies)
  </Accordion>

  <Accordion title="Where does Bright Data have proxies?">
    Bright Data offers proxies in every country in the world, except in the following countries:

    * Iran
    * Iraq
    * Syria
    * Lebanon
    * Palestine
    * North Korea
    * Cuba
    * Sudan
    * Belarus
    * Russia

    If you need proxies from these countries, unfortunately Bright Data will not be able to help you.
  </Accordion>

  <Accordion title="How to view the proxy event log?">
    The event log will show you (at most) the last 200 requests you made with any zone in your account.

    In your Bright Data control panel's proxies page: [https://brightdata.com/cp/zones](https://brightdata.com/cp/zones)

    Go to the "Event Log" tab:

    <img alt="event-log.png" />

    The presented data is:

    * **Date:** Time and date of the request
    * **Zone:** What Zone was used for the request
    * **Source IP:** What IP the request was made from
    * **URL:** The target site of the request
    * **Result:** Success or Fail of the request

      <img alt="event-log-headers.png" />
  </Accordion>

  <Accordion title="How to enable automatic IP fallbacks? (formerly 100% uptime)">
    <Info>
      Applicable for Datacenter & ISP
    </Info>

    The **Automatic Failover** was built to prevent any ‘external’ events from affecting the user. The idea is simple and works the same way for both problems described above – if Bright Data detects a problem, like a connectivity issue or an IP where the GEO isn’t exactly what you asked for when buying that IP, we will automatically route your requests through other IPs which are exactly the same as the original IPs.

    At the same time, we wanted to make sure that customers that must use specific IPs will not be affected – so we made some exceptions:

    * If a specific IP is targeted in your request we will not assign a fallback IP to it
    * Automatic Failover will not interrupt a live connection. If the fallback is needed, it will play in once the next connection is established

    The **Automatic Failover** brings immediate value by providing 100% connectivity and continuous high-performance level, **free of charge and without having to make any changes in your code or how you work.**

    <Note>
      Automatic Failover feature can be turned on or off, [via API](/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone).
    </Note>
  </Accordion>

  <Accordion title="How to enable Automatic Failover for proxies?">
    Navigate to your proxy configuration settings, and under **Advanced settings** enable **‘Automatic failover’**
  </Accordion>

  <Accordion title="How to keep using the same IP in multiple requests?">
    * This can be done by adding the session flag to the proxy username:

    ```sh theme={null}
    brd.superproxy.io:44445 br-customer-<customer_id>-zone-<zone_name>-session-rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.

    * Session ID can be any random string/counter: requests with the same session string will use the same Proxy Peer (as long as possible); requests with different session strings will be assigned different Proxy Peers.
    * To force an IP change, just modify the session ID
    * If an assigned Proxy Peer(exit node IP) becomes unavailable, the Super Proxy will return an error "502 - No peers available" for the first request and then on the second request the super proxy will assign a new peer even if you do not change the session ID.
    * The Session IP is kept persistent for up to 7 minutes of idle time. After 7 minutes with no requests, the IP is released back to the pool.<br />To keep this Session/IP for longer, send a tiny keep-alive request no longer than 7 minutes, to prevent this session from becoming idle for over 7 minute.<br />This request may be anything small, such as /favicon.ico, or even a request that returns 404 (as long as the web server does not disconnect the socket due to this request).
    * If you have multiple Clients and would like to ignore your Clients source IP (which is used together with your session ID to create a session), then you want to use a global session then add `glob_` as a prefix to your session:

    ```sh theme={null}
    brd-customer-<customer_id>-zone-<zone_name>-session-glob_rand39484
    ```

    Full request example:

    ```sh theme={null}
    brd-customer-CXXXXX-zone-ZONE_X-session-glob_rand39484
    ```

    Generate the random number on thread startup, and change it when you want to change the Proxy Peer assigned for the thread's connection.
  </Accordion>

  <Accordion title="Where do I find is my proxy address and port?">
    You can find your proxy address and port in the "Overview" tab inside the proxies that you configured.

    To do this, click on my zones, then click the line with the proxy you need.

    On the overview tab you can also copy your proxy list, download it, refresh your proxies etc.
  </Accordion>

  <Accordion title="How to allowlist/denylist IPs and domains?">
    Allowlisting your IP is a good way to keep your account secure, as it prevents others from accessing your proxies even if they have your username and password.

    When you allowlist an IP, only that IP will be allowed to send requests to your proxies. As soon as a single IP exists in this list - all other IPs will no longer be able to access the zone's proxies and will be blocked.

    Access from allowlisted IP still requires you to provide your zone's username and password to gain access to the zone's proxies.

    Allowlisting does not impact access to Bright Data control panel: it only restricts access to the proxies.

    To add IPs to a zone's denylist/allowlist, there are 2 ways:

    * Via the control panel: <img alt="whitelist-blacklist.png" /> Add all the relevant IPs and domains you'll allow access to with your proxy zone.
      * Go to any of your zone's settings, and click the "Configuration" tab.
      * Scroll down to the "Security settings" section, as they are both responsible for white/denylisting IPs and domains, respectively:
    * **Via API endpoints:**
      * [Add IP to Zone allowlist](/api-reference/account-management-api/allowlist-ip)
      * [Remove IP from Zone allowlist](/api-reference/account-management-api/remove-ip-from-zone-allowlist)
      * [Add IP to Zone denylist](/api-reference/account-management-api/denylist-ip)
      * [Remove IP from Zone denylist](/api-reference/account-management-api/remove-ip-from-zone-denylist)
      * [Remove domain from Zone allowlist/denylist](/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist)
      * [Add domain to Zone allowlist/denylist](/api-reference/account-management-api/allowlist-or-denylist-domains)

    #### Important tips re allowlist:

    * Example for adding domains: <img alt="domain-add-example.png" />
    * Example for adding IPs: <img alt="ip-add-example.png" />
    * IPs that should be allowlisted are **your** machine's IPs that you'll be sending requests with, **not** the proxy IPs in your zones.
    * We **strongly recommend** allowlisting your IPs wherever possible, since when the allowlist is empty, you run the risk of getting your non-allowlisted IPs temporarily blocked in the case where our automatic security blocking system detects any irregular activity. See more info within [this video.](https://brightdata.com/static/video/howto/blacklist_system_explanation.mp4?md5=153602994-22bce32a\&hver=2)
    * There is **no limit** on how many IPs/domains you can add to the allowlist and we also support ranges of IPs.
  </Accordion>

  <Accordion title="How to see supported Ports & Protocols?">
    #### HTTP and HTTPS Protocols

    Protocols `HTTP` & `HTTPS` are supported by default.

    #### SOCKS5 Protocol

    Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    SOCKS5 is supported for all Bright Data's proxy networks: Datacenter, ISP, Residential, and Mobile.

    See here for [full SOCKS5 configuration instructions](/proxy-networks/socks5)

    #### Target Ports

    We distinguish between two kinds of ports: Bright Data proxy & scraping services ports and using specific ports when targeting hosts (websites). This FAQ refers to target ports ; by which the proxy peer should communicate with the target website.

    Ports 80 and 443 are available by default in all zones, for HTTP and HTTPS protocols.

    In zones of proxies of type Datacenter or ISP, all ports higher than 1024 are supported by default.

    In zones of proxies of type Residential or Mobile, the following ports wills be available by default: 8080, 8443, 5678, 1962, 2000, 4443, 4433, 4430, 4444 and 1969.

    Bright Data can support additional ports by request. Every request to support a new port will be followed by a dedicated and additional compliance process with the Bright Data compliance team.<br />Examples of ports that require Bright Data compliance review before activation:

    To make a request to add a port permission to your zone:

    * Go to your zone's settings (it will open on the "configuration" tab by default, if not, please click it)
    * Scroll down to "advanced options" and click it
    * Enable "ports"
    * Input the port numbers you would like to get approved
    * Fill out the form and wait for our compliance team to contact you and approve the request

      <img alt="add-ports.gif" />
  </Accordion>

  <Accordion title="How to target specific OS?">
    Bright Data allows targeting the following **Operating Systems**:

    <CodeGroup>
      ```sh Windows theme={null}
        curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh macOS theme={null}
        curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```

      ```sh Android theme={null}
        curl --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<zone_password> --proxy brd.superproxy.io:44445 "<target_site>"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to refresh IPs Allocated to Your Zone?">
    If you've selected 'Pay per IP' shared, or a dedicated IP type in your zone configuration, you'll be allocated a fixed IP address. From time to time, depending on your use case, you may need to refresh these IP addresses.

    In order to refresh IPs allocated to your zone, navigate to your selected zone, under **'Allocated IPs'** click on **'Show allocated IPs'**, **check the box** of the IP or gIP you wish to refresh and click **'Refresh'**

    <img alt="refresh-ips.gif" />

    <Note>
      Refreshing an IP or gIP will result in an extra charge.
    </Note>

    Alternatively, you can use API to refresh your [dedicated Residential IPs](/api-reference/account-management-api/Refresh_dedicated_residential_IPs) or your [Datacenter/ISP IPs](/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs)
  </Accordion>

  <Accordion title="How to use a specific IP?">
    When using Bright Data's Residential Proxy network, you may find the need to use a specific IP allocated to your zone.

    1. **Send a test request** with a '--verbose' or '-v' option added (this will turn on verbose logging)

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --verbose --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
    ```

    1. **Locate** the x-brd-ip response header and copy its value

       <img alt="x-brd-ip.png" />

    2. **Add** the -ip- flag to your request, after your zone’s name and use the **hashed IP value** copied in the previous step

    3. Send a test request, and **review the response**

    ```sh theme={null}
    curl "https://brdtest.com/myip.json" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-<hashed-ip>:<zone_password>
    ```

    We recommend using [https://brdtest.com/myip.json](https://brdtest.com/myip.json) as the target domain for testing, and to review your IP credentials.
  </Accordion>

  <Accordion title="How to targeting an ASN specific IP?">
    This feature can be enabled by adding the ASN parameter to your Zone configuration, under **Geolocation Targeting**.

    <img alt="asn-targeting.png" />

    Once the configuration is saved, the ASN flag can be added to the Zone's credentials<br />and be integrated when using the Residential proxies. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-<asn-number>:<zone_password> "<target_site>"
    ```

    **Note:** Values for ASN number can be found [here](https://bgp.potaroo.net/cidr/autnums.html).
  </Accordion>

  <Accordion title="How to Target Residential IP groups (gIPs)?">
    Dedicated Residential IPs can be selected in the form of [gIPs](/products/residential/configure-your-proxy#ip-groups-gips). They can be allocated under the zone's configuration page by selecting a "Dedicated" IP type and choosing a number of gips. Also targeting a specific domain is required.

    <img alt="number-of-dedicated-gIPs.png" />

    Once the configuration is saved, selecting "Show allocated Dedicated residential IPs" will provide<br />a list of hash values that represent group IPs.

    <img alt="show-allocated-dedicated-ips.png" />

    These values can be used to target a specific gip. For example:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-<gip_hash_value>:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="How to review usage stats for proxy products in the control panel">
    There are two ways to track usage:

    #### Proxy Dashboard

    Access the Main Proxy Dashboard [here](https://brightdata.com/cp/zones/dashboard)

    * Data Usage per Network: Shows total bandwidth and number of requests for each proxy product over the selected timeframe.
    * Usage Overview: Displays a graph where you can select timeframe, data point (bandwidth, requests, average bandwidth per request), and filter by zone, product, or target domain. You can also compare usage between timeframes using the "Compare to" option.

    #### Zone Overview Page

    * In the zone 'Overview' section you can view stats for a specific zone, with options to compare timeframes, choose data points (bandwidth, requests, bandwidth per request), and view additional metrics in a table below the graph.
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese Residentials IPs">
    **When outside of China**<br />Targeting Chinese Residential IP peers is enough:

    ```sh theme={null}
    curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-cn:<zone_password> "<target_site>"
    ```
  </Accordion>

  <Accordion title="Carrier-specific Proxy peer IP">
    * You can choose to use a specific carrier from this list:

    ```text theme={null}
    a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, 
    dt, docomo, dtac, etisalat, idea,  meo, mtn, mtnza, 
    optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, 
    tmobile, tigo, tim, verizon,  vodacomza, vodafone, vivo, zain,
    vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, 
    cellc, ooredoo, drei, umobile, cableone, proximus, mobitel, o2, 
    bouygues, free, sfr, digicel
    ```

    * For Example

    <CodeGroup>
      ```sh Deutsche Telekom theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-dt
      ```

      ```sh Sprint theme={null}
      brd-customer-<customer_id>-zone-<zone_name>-carrier-sprint
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="About geolocation databases, and how to check the proxy IP information?">
    Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records for MaxMind GeoDB.

    There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them.

    In order to see our information about the proxy IP that you are using, please use the following link: [https://geo.brdtest.com/mygeo.json](https://geo.brdtest.com/mygeo.json)
  </Accordion>

  <Accordion title="Which Bright Data products are best for scraping search engines (SERPs)?">
    #### For single-step scraping:

    [SERP API](/products/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more.

    #### For multi-step scraping (playwright/puppeteer/selenium):

    [Browser API](/products/scraping-browser/introduction) is the ideal product as it is our fully cloud-hosted browser designed to help you easily focus on your multi-step data collection while we take care of the full proxy and unblocking infrastructure for you, including CAPTCHA solving.
  </Accordion>

  <Accordion title="Can I target Google SERPs from the Residential, Datacenter, or ISP Proxy network?">
    **Residential Proxy** - No, [SERP API](/products/serp-api/introduction) is the ideal product for targeting SERPs as it has a guaranteed success rate (pay only for success) with active unlocking, automatically chooses the best proxies, customizes headers, fingerprinting, solves CAPTCHAs, and more. Targeting Google SERPs from the Residential network will result in Super-proxy bypass, which will casue the request to be sent from our servers instead of the peer.

    **Datacenter & ISP Proxies** - No. When attempting to specifically target Google through either of these proxy networks, your request will be denied and you will receive the following error message in the response headers:

    ```text theme={null}
    HTTP/1.1 403 Search engine host is not allowed
    x-brd-error: Forbidden: This target URL isn't supported on proxy networks, use the SERP API product for targeting this URL. You may contact your account manager or open a support ticket for assistance
    ```
  </Accordion>

  <Accordion title="Residential & Mobile networks">
    When targeting search engines through the Residential or Mobile networks, the request will not go through the Residential or Mobile peer but instead will be sent directly through one of our super proxies. The reason for this behavior is to support the integration of the Residential and Mobile networks with a browser, which might need to load search engine resource endpoints from the target website.

    **In case you target a search engine domain using Residential or Mobile networks, the request will be passed directly through the super proxy, and the following response header will serve as an indication:**

    ```sh theme={null}
    x-luminati-ip: superproxy bypass
    ```
  </Accordion>

  <Accordion title="Can I Send requests to IPs and not domain name?">
    No - requests directly to the host server, and not to the domain name are forbidden while using Bright data.<br />Requests using URL format such as 1.1.1.1:443 will be executed using the super proxy server, not the proxy peer IP.

    Example of a request using the super proxy:

    <img alt="x-luminati-ip.png" />
  </Accordion>

  <Accordion title="Can I use port 25 or any other SMTP port, or send an email by using the proxy IP?">
    Since BrightData cares about our community and peers quality, SMTP requests which can be used for spamming are blocked. Please note that mail domains are also blocked from access, and requests to mail domains will be sent from the super proxy server, and not the peer IP.
  </Accordion>

  <Accordion title="Does Bright Data support the Socks5 protocol">
    Yes. Bright data supports `SOCKS5` protocol, with a default port 22228 assigned for SOCKS5 communication.

    See here for [full SOCKS5 configuration instructions](/proxy-networks/socks5) or visit the [SOCKS5 proxies page](https://brightdata.com/solutions/socks5-proxies).
  </Accordion>

  <Accordion title="How do I control from where the request is performed?">
    * You can choose to perform the request from the super proxy directly instead of the IP of the peer. In that case the IP of the request will be the one of the Super proxy. You will need to add **'-direct'** to your request authorization string. `brd-customer-<customer_id>-zone-<zone_name>-direct`
  </Accordion>

  <Accordion title="How do I refresh session (IP)?">
    Using the same IP for a long period of time makes it easier for the target website to mark the IP as proxy and can make your request get detectable by the target website. Refreshing your IPs will result in allocation of new IPs from Bright Data instead of your existing ones in your pool allowing you to gain control over your pool and reach higher success rates.
  </Accordion>

  <Accordion title="How to browse Chinese sites by using Chinese residential IPs?">
    No special settings required, just use `country-cn` flag in your credentials
  </Accordion>

  <Accordion title="How to use the same IP for an extended period of time and how long can I keep it? (long session)">
    If you wish to keep the same IP for a long time for session-based use, you have the following options:

    * Target a specific IP with the `-ip` flag: View your proxy list in your zone's pool (can be found in the control panel in the zone's 'overview' tab) choose one IP and target it  using the `-ip` flag. This will route all your requests to the same IP. You can use the same IP as long as it is allocated to your zone.
    * Keep same session IP: By utilizing the `-session-<SESSION_ID> `flag your requests will be routed to the same IP. To make sure that the same IP is kept bound to your session ID, you need to ensure that the session is not kept idle for more than . You can have multiple parallel sessions at the same time - each one with a different IP allocated to it.

    Optional: By utilizing the [Proxy Manager](/products/proxy-manager/introduction) you can make use of the [long single session](/products/proxy-manager/configuration#presets) preset which will automatically send dummy requests at regular intervals to ensure the IP is kept allocated.

    <Note>
      For residential/mobile zones, IPs are real users' devices' IPs, and therefore can be used only when the user's device is idle (i.e. the device is connected to the internet, has enough battery power, and the user is not currently using it). If the IP becomes unavailable, Bright Data will automatically assign you with another available residential IP of the same type and geo-location as you used.
    </Note>

    For more instructions and examples please see the following article: [https://docs.brightdata.com/proxy-networks/config-options#controlling-your-proxies-rotation](/proxy-networks/config-options#controlling-your-proxies-rotation)
  </Accordion>

  <Accordion title="What is Error code 502?">
    HTTP error code 502 means "Bad Gateway". This error occurs when you send a request to a URL, but the URL's server receives an invalid response from another server that it depends on to fulfill the request.

    Bright Data uses the http headers to show additional information about the HTTP error, which helps in identifying the root cause and resolving the issue.

    Check our [error catalog](/proxy-networks/errorCatalog#http-error-502) for HTTP Error 502 reasons.
  </Accordion>

  <Accordion title="What is Error code 403?">
    HTTP 403 response code means you are forbidden from accessing a **valid** URL. The server understands the request, but it can't fulfill the request because of client-side issues.

    Bright Data uses the http headers to show additional information about the HTTP error, which helps in identifying the root cause and resolving the issue.

    Check our [error catalog](/proxy-networks/errorCatalog#http-error-403) for HTTP Error 403 reasons.
  </Accordion>

  <Accordion title="Why am I getting SSL errors? (ERR_CERT_AUTHORITY_INVALID)">
    If you've tried using the residential or mobile proxy networks and have encounterred one of the following errors or ones similar to them:

    * net::ERR\_SSL\_PROTOCOL\_ERROR
    * ERR\_INVALID\_CERT
    * Error: self-signed certificate in certificate chain
    * ERROR: No matching issuer found
    * NET::ERR\_CERT\_AUTHORITY\_INVALID
    * SSL: CERTIFICATE\_VERIFY\_FAILED

    It means that you are using the residential or mobile networks over HTTPS and have not handled the SSL verification correctly.

    For more info on Residential network access and KYC, see the [Residential network access policy](/products/residential/network-access).

    **How to resolve the SSL errors?**

    You have the following options:

    * Utilize API access instead of native proxy access: If you are connecting programmatically you should consider connecting via the API method - which handles the SSL certificate for you behind the scenes: [API access vs Native Proxy access](/api-reference/authentication)
    * Complete the know-your-customer (KYC) process, which takes \~2-3 business days to process - after which you'll be able to use the residential/mobile network with minimal restrictions, which also resolves the SSL errors. To complete KYC process fill in the [KYC form](https://brightdata.com/cp/kyc)
    * Install the BrightData SSL certificate, according to our [SSL certificate installation guide](/general/account/ssl-certificate) (note that for some specific integration methods installing the ssl certificate may not be possible due to it not being supported)
      <Note>
        This solution may not be supported by certain third party proxy tools e.g., GoLogin, MultiLogin.
      </Note>
    * If you are utilizing our proxies through code (NodeJS, Python, C#, etc.) or console, you can ignore SSL verification entirely, which resolves all SSL verification errors. We provide examples on how to do this in the [SSL certificate documentation page](/general/account/ssl-certificate)
    * Use a different product: instead of Residential proxies you could use a different product such as Data Center or ISP proxies, which do not require "Special Permissions" (KYC). You could do this as a temporary measure until your KYC form is approved.
  </Accordion>

  <Accordion title="How do I redirect `curl` ourput to a file?">
    When scraping large files or in order to record `curl` output, you may want to redirect the output to a file. In order to do so add `--output [filename]` to your `curl` command options.
  </Accordion>

  <Accordion title="How can I allow/block targeting specific domains in my zone?">
    You can control access by allowing or blocking specific domains through simple configurations within your zones. Follow these steps to manage domain access:

    1. Visit the [Zones Page](https://brightdata.com/cp/zones) Go to the Zones Page in your dashboard.
    2. Select Your Desired Zone Choose the zone you wish to configure for domain access.
    3. Navigate to the 'Configuration' Tab Once in your selected zone, locate the Configuration tab, then scroll down to  Security Options.
    4. Allowing or Blocking Domains
       * To allow specific domains, add them to Allowed Target Hosts.
       * To block specific domains, add them to Blocked Target Hosts.
    5. Domain Wildcard Options
       * Root Domain Inclusion: Adding a root domain (e.g., example.com) will automatically include all its subdomains (e.g., sub.example.com).
       * Wildcard Use: Utilize the \* wildcard to cover all subdomains and suffix variations. For instance, adding example.\* will include sub.example.\* and various domain suffixes like example.com, example.co.uk, etc.

    <Tip>
      These configurations provide flexibility in managing domain-level access for your proxy zones, ensuring secure and controlled connectivity.
    </Tip>
  </Accordion>

  <Accordion title="How do I target government websites?">
    By default, Bright Data blocks proxy traffic to what classifies as Government websites. Some countries' government websites do not have special domain name suffix (like `.gov` or `.gov.[country_code]` , yet those domains still qualify as government domains and getting blocked.  

    When you get this specific reason block, check your response headers for `x-brd-err-code` : if the value is `policy_20051` - this is a government website block. A value of `policy_20000` is a different block, meaning the target is classified in a category that Bright Data blocks. See the [proxy errors catalog](/proxy-networks/errorCatalog) for the full text of both codes.

    To gain access to government website, Bright Data will require you to identify your business and usecase via our KYC process. [Read more about KYC process](/products/residential/network-access#kyc-verification) or start the KYC [here](https://brightdata.com/cp/kyc). 
  </Accordion>

  <Accordion title="Why am I getting errors about robots.txt?">
    robots.txt is a file that website owners use to define which areas of their site can be accessed by automated systems. On the Residential network, Bright Data adheres to these rules to ensure ethical compliance. Requests to blocked areas will return a 502 Residential Failed (bad\_endpoint) error.

    To resolve these errors you can choose one of these solutions:

    * Keep your KYC use case current with the Bright Data compliance team, so your approved Residential access covers the sites you target. Residential access requires KYC approval. To start or review the process, see the [KYC form](https://brightdata.com/cp/kyc).
    * Use our other products that do not require KYC verification, such as [ISP proxies](/products/isp/introduction) and [Datacenter proxies](/products/data-center/introduction).
    * Avoid navigating to the web paths that the website is blocking in the robots.txt file.

    For more information, please see the following article: [https://docs.brightdata.com/products/residential/network-access](/products/residential/network-access)
  </Accordion>

  <Accordion title="Do you offer IPv6 Proxies and how do I get IPv6 proxies?">
    We will consider providing IPv6 proxies to selected customers. Please contact us for inquires in regards to [support@brightdata.com](mailto:support@brightdata.com)
  </Accordion>

  <Accordion title="How to understand why I am getting a certain error?">
    To try and understand the reason your are encountering a specific error while using our proxy networks, you should try to recreate the same request on which you encountered the error and send it via cURL on CMD/BASH or some other http request service such as Postman.

    While sending the request, ensure you are attaching the `-v` or `-verbose` flag to the request (for cURL), this will ensure you receive the response headers which contain important information regarding the source of the error and will guide you to a solution.

    If the response headers include `x-brd-` then the error originates with BrightData and you should check the [BrightData Error Catalog](/proxy-networks/errorCatalog) for further advice

    Otherwise, there has not been a failure on our side - and you should instead check the article regarding [Website Blocking](/proxy-networks/website-blocking)

    It could also be that the error originates from issues with your integration, you should check if you've integrated correctly, for help with integration - please see our [Integrations Section](/integrations/introduction)
  </Accordion>

  <Accordion title="Does Bright Data have any request limits? ">
    Bright Data allows large scale proxy access and operations, we do not enforce a global requests limit (also known as "Rate limit"), but we do monitor customers' usage - and alert if this usage is exceeding normal behavior. We do protect our proxy networks and if requests rate is too high you will receive an HTTP Error 429 ([see description of error and troubleshooting here](/proxy-networks/errorCatalog#http-error-429)).

    We monitor both general requests inflow as well as **number of requests per proxy (IP)**, if we identify and overload on a specific proxy IP we may throttle it and return an HTTP error 429 with specific error message indicating such scenario. You will be requested to add more IPs or reduce your load.

    We highly recommend when encountering rate limit error (HTTP error 429) to review you rotation logic (in case you refer explicitly to proxy IPs) - you may have been targeting a specific set of IPs with requests while leaving the others unused.
  </Accordion>

  <Accordion title="Why cant I access (blocked) google, bing.com, youtube.com with proxies?">
    As part of BrightData's policy - we perform blocks or [Super-Proxy-Bypasses](/proxy-networks/faqs#what-is-a-super-proxy) when users try to access google.com, youtube.com, bing.com and a handful of other select domains with our regular proxies. If you wish to scrape google search result data or youtube.com, please use [SERP API](/products/serp-api/introduction) or Web Unlocker API instead.
  </Accordion>

  <Accordion title="Why am i getting wrong geolocation when checking proxy IP?">
    When checking your brightdata proxy IP location and details via third party IP checker sites, you may receive in results the 'wrong' geolocation, this can be due to two main reasons:

    * Geolocation Databases: Geolocation databases (GeoDB) are used by internet websites to query information about the IP address used by the users. Bright Data monitors and maintains correct records for MaxMind GeoDB. There are many other smaller GeoDBs, most of which are using outdated records or flawed testing methods, and so the information they present is not accurate or is presented to lure their viewers to buy VPN or proxy products from them.
    * Super Proxy Bypass: For third party IP checkers we may perform a superproxy bypass instead of completely blocking the request, this is done in order to retain our IP's reputation. When this is done, you may see the location of our superproxy not of your proxy peer. Dont worry - for other regular websites your real proxy peer will be used. [What is a superproxy bypass?](/proxy-networks/faqs#what-is-a-super-proxy)

    To avoid such issues, please only use our official IP checker website, which will show you the accurate information: [https://geo.brdtest.com/mygeo.json](https://geo.brdtest.com/mygeo.json)
  </Accordion>

  <Accordion title="How can I use Bright Data proxies in IP:PORT format?">
    Bright Data proxies natively support the industry-standard format: `IP/HOST:PORT:USERNAME:PASSWORD`. If your integration method does not support this format and requires `IP:PORT` only, you can use **Bright Data Proxy Manager**, a free, open-source tool that allows you to route requests to our proxies using the `IP:PORT` format.

    For more details on configuring Proxy Manager for this setup, refer to our guide: [Port Targeting Configuration](/products/proxy-manager/configuration#port-targeting)
  </Accordion>

  <Accordion title="Why has my IP address been added to the zone denylist? ">
    #### Handling IP Restrictions on Your Account

    If Bright Data detects unusual or suspicious activity originating from a particular IP address on one of your zones, the automated security measures will denylist that IP to protect your account. While this system effectively prevents most malicious activity, it occasionally may block legitimate users, resulting in an `ip_forbidden` error message.

    #### How to Resolve This Issue

    If you encounter this error, you can quickly resolve it by:

    1. Go to the \*\*'Proxy' \*\*tab
    2. Navigate to the affected Proxy/Zone from the list
    3. Select **'Security Settings'** in the configuration panel
    4. Find the**IP allowlist**  option
    5. Add your current machine's IP address to the allowlist

    Once your IP is allowlisted for the Proxy/zone, you'll regain immediate access to the service.
  </Accordion>

  <Accordion title="How to get your Bright Data connection information?">
    ### Your proxy access information

    Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

    To get access to the proxy zone:

    1. Login to Bright Data control panel
    2. Select the proxy zone or setup a new one
    3. Click on the new zone name, and select the **Overview** tab.
    4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
    5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
    6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

    ### Access Details Section Example

    <Frame>
      <img alt="your-proxy-list" />
    </Frame>

    ### Residential proxy access

    To access Bright Data's **Residential Proxies** you will need to either get verified by our compliance team, or install a certificate. [Read more...](/products/residential/network-access)

    ### Targeting search engines?

    If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines. [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

    ### Avoid `PROXY ERROR` in your tool

    Some tools use search engines as a test target for proxy: if your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the third-party tool's configuration, and not controlled by Bright Data).
  </Accordion>

  <Accordion title="Does Bright Data proxies support HTTP3?">
    Yes. We offer selected customers to use our advanced high performance proxy networks with HTTP3 protocol.
  </Accordion>

  <Accordion title="What should I know to work with HTTP3 with Bright Data proxy network? ">
    ### How do I know if my target domain supports HTTP3?

    You can tell if your target domain advertises on HTTP3 by sending a `curl` request checking the response header for `alt-svc` header. If this header exists in the response it means the domain is offering access over HTTP3.

    ```text theme={null}
    curl -k -i https://[my target website]
    ```

    Alternatively, you can check [https://http3check.net/](https://http3check.net/) or similar websites.

    ### Can I use my installed `curl` to query over HTTP3?

    Yes - but you need a specifically built `curl` utility which is supporting `HTTP3`. Most popular released of `curl` does not support `HTTP3`.

    ### Why should I use HTTP3?

    Some websites expect HTTP3 traffic ; so by accessing with target's expected protocols you may experience smoother unblocked access. For some use cases, HTTP3 access is faster than HTTP2, so your throughput can be higher.

    ### Do I need to perform special setup on my proxies?

    No. All the proxies provided by Bright Data can relay HTTP3 traffic without special setting or modifications.

    ### Do I need to modify my operations or access to use HTTP3?

    Consult your IT, Network and Security administrators on enabling HTTP3 from your network. Some network or firewall settings may be required to allow this traffic to flow from/to your organization's network.

    ### How can I see if my chrome browser is utilizing HTTP3 for traffic?

    Open your chrome browser in development mode, and open the network tab. In `protocol` column, if you see `h3` it means requests are sent and received over HTTP3.

    ### What tools does Bright Data offer to assist with HTTP3 implementation? 

    Bright Data offers a local javascript based router which forces HTTP3 use. It is for educational purposes and not production. To get the utility contact your Bright Data account manager. 
  </Accordion>

  <Accordion title="Can I export my logs? ">
    Yes - Bright Data supports exporting your logs to AWS S3 store. Set this up in your control panel here: [https://brightdata.com/cp/setting/logs\_delivery](https://brightdata.com/cp/setting/logs_delivery)

    ***Note: Your AWS S3 bucket must be in us-east-1 region***
  </Accordion>
</AccordionGroup>


# SOCKS and SOCKS5 proxies
Source: https://docs.brightdata.com/proxy-networks/socks5

Use the SOCKS5 protocol with Bright Data Datacenter, ISP, Residential and Mobile proxy networks. Includes connection examples and authentication methods.

## Supported SOCKS Protocols

Bright Data supports SOCKS protocol version 5: `SOCKS5`.

## Using SOCKS5 for your scraping tasks

The most common protocols for internet data collection are `HTTP` and `HTTPS`, some of the tools or utilities require `SOCKS5` for their operations.

In Bright Data, we do not distinguish between `HTTP` , `HTTPS` and [`SOCKS5 proxies`](https://brightdata.com/solutions/socks5-proxies): all our proxies support all three protocols. You can switch between protocols while using the same proxy.

## Do you really need  SOCKS5?

Our `HTTP` and `HTTPS` proxy solutions are usually the best fit for scraping websites, offering lowest cost and highest performance. However, if the the task still requires `SOCKS5` Bright Data can provide quality proxies around the globe.

## Supported Proxy types & HTTP protocols

`SOCKS5` proxy connections are supported on all Bright Data proxy networks: Datacenter, ISP, Residential and Mobile.

Bright data support HTTP/S version 2.0 only via SOCKS.

We do not support tunneling HTTP/2 versiob 3.0 via SOCKS.

<Info>
  Using `SOCKS5` over Bright Data **Residential proxy**  is supported only towards `HTTPS` targets, `HTTP` targets will be supported soon.
</Info>

## SOCKS5 Main proxy port configuration

<Note>
  **`Bright Data  uses port 22228 for SOCKS5`**
</Note>

When using `SOCKS5` make sure to use `brd.superproxy.io:22228` and not the standard port <Tooltip>[`44445`](/general/faqs#which-port-shall-i-use-22225-or-33335)</Tooltip> for `HTTP` and `HTTPS` protocols.

## SOCKS5 targeting with Bright Data

<Warning>
  **Bright Data supports only hostnames (domain names) for SOCKS5 proxies**
</Warning>

Per our compliance regulation, we allow `SOCKS5` requests **only** with hostnames/domain names relayed as target. Requests sent with explicit IPs or local IP resolution, are **blocked**.

Hence, configure your code, client or calling application to:

1. Use domain name as target
2. Resolve DNS remotely and not locally

Adhering to those rules will ensure the request to get to the target domain IP, thru our proxy peer.

### Which target ports to use

#### Datacenter & ISP

Bright Data supports all ports higher than `1024` for datacenter and ISP proxies.

#### Residential & Mobile

Bright Data supports ports: `8080`, `8443`, `5678`, `1962`, `2000`, `4443`, `4433`, `4430`, `4444` and `1969` for Residential & Mobile proxies.

## Using SOCKS5 with `curl`, `Javascript` & `Python`

<Tabs>
  <Tab title="curl">
    <Warning>
      **`Use socks5h://brd.superproxy.io:22228 when issuing curl requests`**
    </Warning>

    To use `curl` with Bright Data SOCKS5 proxies, you have to explicitly:

    1. Add `-x` to your command line parameters
    2. Use SOCKS5h protocol for remote DNS lookup
    3. Use proxy address as `brd.superproxy.io:22228`
    4. Provide Bright Data proxy zone credentials
    5. **Residential and Mobile proxies**: Add curl `-k` option to ignore SSL errors proxies or [Setup SSL Certificate](/general/account/ssl-certificate#using-the-ssl-certificate-in-your-code)

    Requests which do not comply with all the above are blocked.

    Examples `curl` command:

    ```bash theme={null}
    curl -i -k -x socks5h://brd.superproxy.io:22228 --proxy-user [USERNAME]:[PASSWORD] "https://geo.brdtest.com/welcome.txt"
    ```
  </Tab>

  <Tab title="Javascript">
    Example code for `SOCKS5` request:

    ```javascript theme={null}
    // install https://www.npmjs.com/package/socks-proxy-agent
    const https = require('https');
    const { SocksProxyAgent } = require('socks-proxy-agent');
    const user_pass = 'brd-customer-[ACCOUNT ID]-zone-[ZONE NAME]:[ZONE PASSWORD]';
    const socks_proxy_url = `socks5h://${user_pass}@brd.superproxy.io:22228`;
    const agent = new SocksProxyAgent(socks_proxy_url);
    https.get('https://geo.brdtest.com/welcome.txt', {agent},
      res=>res.pipe(process.stdout));
    ```
  </Tab>

  <Tab title="Python">
    Example code for `SOCKS5` request:

    ```python theme={null}
    # https://docs.python-requests.org/en/latest/user/advanced/#socks
    import requests
    user_pass = 'brd-customer-[ACCOUNT ID]-zone-[ZONE NAME]:[ZONE PASSWORD]'
    socks_proxy_url = f'socks5h://{user_pass}@brd.superproxy.io:22228'
    resp = requests.get('https://geo.brdtest.com/welcome.txt',
      proxies=dict(http=socks_proxy_url, https=socks_proxy_url))

    print(resp.text)
    ```
  </Tab>
</Tabs>

### Troubleshooting with `curl`

We recommend using `curl` to troubleshoot your `SOCKS5` requests, and adding `curl` options `-i` or `-v` for printing header fields. Look for `x-brd-error`, `x-brd-err-code` and `x-brd-err-msg` for elaborated error messages sent by Bright Data proxy networks.
To see our full error catalog (for `HTTP` and `HTTPS` as well) visit this page: [Proxy errors troubleshooting](/proxy-networks/errorCatalog)

## SOCKS5 Authentication configuration

<Note>
  **Bright Data must receive proxy zone credentials to access SOCKS5 proxy**
</Note>

The authentication is done also similarly to `HTTP` and `HTTPS` by relaying the user and password for the proxy access.

Some tools or utilities will give you place to input the credentials and port separately as parameters, as seen in the control panel, and some will require you to provide a url with the credentials delimited single parameter: `userName:password@brd.superproxy.io:22228`.

## SOCKS5 Geo-location & country selection

Location setting is identical to [HTTP/HTTPS proxies geo-targeting](/proxy-networks/config-options) and is set by adding `-country-[country code]` to your SOCKS5 username.

Example for `curl` command to get a SOCKS5 proxy in Italy (country code: `it`):

```bash theme={null}
curl -i -k -x socks5h://brd.superproxy.io:22228 --proxy-user [proxy zone user]-country-it:[zone password] "https://geo.brdtest.com/welcome.txt" -v
```

## Difference between SOCKS5 and SOCKS5h

The difference between **SOCKS5** and **SOCKS5h** lies in how they handle DNS (Domain Name System) resolution:

1. **SOCKS5**: In the standard SOCKS5 proxy, the **client** resolves the DNS. This means that the domain name (e.g., `example.com`) is resolved into an IP address **before** it is passed through the proxy. The proxy then routes traffic to the resolved IP address.
2. **SOCKS5h**: The "h" stands for "hostname." In this case, the **proxy** server resolves the DNS. The client sends the domain name (not the IP address) to the proxy server, which resolves it and forwards the request. This is useful if you want to hide the destination domain names from the client's network.

To summarize:

* **SOCKS5**: DNS resolution happens on the**client-side**.
* **SOCKS5h**: DNS resolution happens on the **proxy-side**.

Bright Data supports **proxy side** SOCKS5h only.


# Overcoming website blocking
Source: https://docs.brightdata.com/proxy-networks/website-blocking

Troubleshoot 4xx and 5xx blocking on Bright Data proxies: read network errors, identify block types and apply rotation, headers and Unlocker fixes.

The first step for troubleshooting your error is checking the entire network error response - It could contain critical information regarding the origin of the error and possibly instructions for resolving it.

To analyze the entire response you can run a `curl` command from your shell prompt and add the option flag `-v` or `-i`. These flags will run curl in verbose mode and print out the header fields

```bash theme={null}
curl -v [rest of curl command options]
```

## How to avoid blocks

### How to choose IPs

The main things to consider for IPs are:

* Geolocation: it's generally best to match the peer country to the country of the target.
  Using more specific targeting can also help:
  City is more specific than State, and State more specific than country

* Pool type: using Shared IPs can be a cost saving measure if the target isn't sensitive to multiple requests from the same IP. If the target is sensitive to that, using Dedicated IPs can help.

* Quality: Bright Data offers 4 'normal' proxy networks, in addition to our Automated Scraping Solutions.
  These are listed below in order of increasing difficulty to detect:
  Data Center - ISP - Residential - Mobile
  If one of these networks is consistently blocked, trying the next one down in the list may help get past the blocking.

* Consistency: for single-URL scrapes, you should generally be rotating the IP frequently to avoid rate limits. If you're trying to emulate a real user, the tips in the section below can help keep the IP consistent.

### How to manage sessions

* If you're trying to mimic a real user, you should use the session ID username parameter:
  [Proxy and IP Rotation control](/api-reference/proxy/rotate_ips#using-the-same-proxy-for-multiple-requests-session)
  This tells us that for a request with the same ID, you want to keep the same IP for the request.
  Doing this allows you to appear more like a normal user when using rotating networks like Residential and Mobile.

* If your use-case is single scrapes, you might still want to use this parameter, but in a different way:
  When the ID changes, that tells us that you want to use a different IP than the last one.
  Iterating over multiple IDs within 60 seconds will allow you to rotate through your allocated IPs.

### Request Method / Fingerprint

* Request Method: "Normal users" will typically use a browser to access websites. You can integrate the proxies into a regular browser, either directly or via our extension (available [here](https://chrome.google.com/webstore/detail/bright-data/efohiadmkaogdhibjbmeppjpebenaool?hl=en)).
  If you're using a different integration, like browser automation, or direct API requests, it's important to keep this in mind and make your requests look as much like a real browser as possible to avoid detection.

* Fingerprint: Part of looking like a real user is the headers and cookies you send with the request, but another part is having the same attributes that a real browser would have. You can find many resources online about this, and we also offer the Web Unlocker API and Browser API, which manage all of this on your behalf.

## When to use an automated solution

Should you find that none of our proxy solutions (Datacenter, ISP, Residential, Mobile proxies) are effective for your needs, We recommend trying our [Automated Scraping Solutions](/left-over/scraping-automation-introduction), particularly the Web Unlocker API, which autonomously manage all of the above mentioned measures and more to ensure high success rates.


# Python SDK
Source: https://docs.brightdata.com/api-reference/SDK

Install the Bright Data Python SDK (thousands of scrapers) to scrape URLs, search the web, run platform scrapers and connect Playwright to the Browser API.

This guide shows how to install the Bright Data Python SDK and call every feature it exposes: URL scraping, search engines, platform-specific scrapers (LinkedIn, Amazon, Instagram, TikTok, YouTube, Reddit, Pinterest, ChatGPT, Perplexity, Digikey), Scraper Studio, datasets, and the Browser API.

<img alt="Bright Data Python SDK banner" />

## Installation and setup

Install the package via pip:

```bash theme={null}
pip install brightdata-sdk
```

### Configuration

You must provide your API key. You can find it in your [Bright Data Control Panel](https://brightdata.com/cp/api_keys).

**Option 1: Environment variable (recommended)**

```bash theme={null}
export BRIGHTDATA_API_KEY="YOUR_API_KEY"
```

<Note>
  The Python SDK looks for your API key in this order: the `token` argument, `BRIGHTDATA_API_TOKEN`, `BRIGHTDATA_API_KEY`, then the key stored by `brightdata login`. `BRIGHTDATA_API_KEY` is the variable the [Bright Data CLI](/products/cli/installation) reads, so one export covers both. If both variables are set, `BRIGHTDATA_API_TOKEN` wins. Versions before 2.5.0 read only `BRIGHTDATA_API_TOKEN`; upgrade with `pip install -U brightdata-sdk` or export that variable instead.
</Note>

**Option 2: Direct initialization**

```python theme={null}
# Async client
from brightdata import BrightDataClient

async with BrightDataClient(token="YOUR_API_KEY") as client:
    ...

# Sync client
from brightdata import SyncBrightDataClient

with SyncBrightDataClient(token="YOUR_API_KEY") as client:
    ...
```

## Basic usage

Use `SyncBrightDataClient` for simple scripts. Use `BrightDataClient` with asyncio for high-concurrency workloads.

<CodeGroup>
  ```python Synchronous theme={null}
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient() as client:
      # Scrape a URL
      data = client.scrape_url("https://example.com")
      print(f"Result: {data.data}")

      # Search Google
      search = client.search.google(query="Bright Data")
      print(f"Found: {len(search.data)}")
  ```

  ```python Asynchronous theme={null}
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient() as client:
          result = await client.scrape_url("https://example.com")
          print(result.data)

          search = await client.search.google(query="Bright Data")
          print(f"Found: {len(search.data)}")

  if __name__ == "__main__":
      asyncio.run(main())
  ```
</CodeGroup>

## Launch scrapes and web searches

<CodeGroup>
  ```python Search Engines theme={null}
  from brightdata import BrightDataClient

  client = BrightDataClient()

  # Google search
  results = client.search.google(
      query="best shoes of 2025",
      location="United States",
      language="en",
      num_results=20
  )

  # Bing search
  results = client.search.bing(
      query="python tutorial",
      location="United States"
  )

  # Yandex search
  results = client.search.yandex(
      query="latest news",
      location="Germany"
  )

  if results.success:
      print(f"Cost: ${results.cost:.4f}")
      print(f"Time: {results.elapsed_ms():.2f}ms")
  ```

  ```python Web Scraping theme={null}
  from brightdata import BrightDataClient

  client = BrightDataClient()

  # Scrape single URL
  result = client.scrape_url("https://example.com")

  # Scrape multiple URLs concurrently
  urls = [
      "https://example1.com",
      "https://example2.com",
      "https://example3.com"
  ]
  results = client.scrape_url(urls)

  for r in results:
      if r.success:
          print(f"Success: {r.data[:200]}...")
          r.save_to_file(f"result_{hash(r.data)}.json")
  ```
</CodeGroup>

<Check>
  When working with multiple queries or URLs, requests are handled concurrently for optimal performance.
</Check>

## Use platform-specific scrapers for structured data

Extract structured data from Amazon, LinkedIn, Facebook, Instagram, TikTok, YouTube, Reddit, Pinterest, ChatGPT, Perplexity, and Digikey.

<CodeGroup>
  ```python Amazon theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          products = await client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
          reviews = await client.scrape.amazon.reviews(
              url="https://amazon.com/dp/B0CRMZHDG8",
              pastDays=30,
              keyWord="quality"
          )
          sellers = await client.scrape.amazon.sellers(
              url="https://amazon.com/sp?seller=AXXXXXXXXXXX"
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      products = client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
      reviews = client.scrape.amazon.reviews(
          url="https://amazon.com/dp/B0CRMZHDG8",
          pastDays=30,
          keyWord="quality"
      )
      sellers = client.scrape.amazon.sellers(
          url="https://amazon.com/sp?seller=AXXXXXXXXXXX"
      )
  ```

  ```python LinkedIn theme={null}
  # Async: collect by URL, then discover by parameters
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          profiles = await client.scrape.linkedin.profiles(
              url="https://www.linkedin.com/in/johndoe"
          )
          companies = await client.scrape.linkedin.companies(
              url="https://www.linkedin.com/company/bright-data"
          )
          jobs = await client.scrape.linkedin.jobs(
              url="https://www.linkedin.com/jobs/view/123456"
          )
          posts = await client.scrape.linkedin.posts(
              url="https://www.linkedin.com/feed/update/urn:li:activity:123"
          )

          # Discover by parameters
          job_results = await client.search.linkedin.jobs(
              keyword="python developer",
              location="New York",
              remote=True
          )
          profile_results = await client.search.linkedin.profiles(
              first_name="John",
              last_name="Doe"
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      profiles = client.scrape.linkedin.profiles(url="https://www.linkedin.com/in/johndoe")
      companies = client.scrape.linkedin.companies(
          url="https://www.linkedin.com/company/bright-data"
      )
      jobs = client.scrape.linkedin.jobs(url="https://www.linkedin.com/jobs/view/123456")
      posts = client.scrape.linkedin.posts(
          url="https://www.linkedin.com/feed/update/urn:li:activity:123"
      )
  ```

  ```python Facebook & Instagram theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          await client.scrape.facebook.posts_by_profile(
              url="https://www.facebook.com/nasa", num_of_posts=10
          )
          await client.scrape.facebook.posts_by_group(
              url="https://www.facebook.com/groups/example"
          )
          await client.scrape.facebook.posts_by_url(
              url="https://www.facebook.com/post/123456"
          )
          await client.scrape.facebook.comments(
              url="https://www.facebook.com/post/123456", num_of_comments=100
          )
          await client.scrape.facebook.reels(url="https://www.facebook.com/nasa")

          await client.scrape.instagram.profiles(url="https://www.instagram.com/nasa/")
          await client.scrape.instagram.posts(url="https://www.instagram.com/p/Cuf4s0MNqNr")
          await client.scrape.instagram.reels(
              url="https://www.instagram.com/reel/C5Rdyj_q7YN/"
          )
          await client.scrape.instagram.comments(
              url="https://www.instagram.com/p/CesFC7JLyFl/"
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      client.scrape.facebook.posts_by_profile(
          url="https://www.facebook.com/nasa", num_of_posts=10
      )
      client.scrape.instagram.profiles(url="https://www.instagram.com/nasa/")
  ```

  ```python TikTok theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          profiles = await client.scrape.tiktok.profiles(
              url="https://www.tiktok.com/@username"
          )
          posts = await client.scrape.tiktok.posts(
              url="https://www.tiktok.com/@user/video/7433494424040017194"
          )
          comments = await client.scrape.tiktok.comments(
              url="https://www.tiktok.com/@user/video/7216019547806092550"
          )
          fast_posts = await client.scrape.tiktok.posts_by_profile_fast(
              url="https://www.tiktok.com/@bbc"
          )
          search = await client.scrape.tiktok.posts_by_search_url_fast(
              url="https://www.tiktok.com/search?q=cats", num_of_posts=10
          )


  asyncio.run(main())
  ```

  ```python YouTube theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          videos = await client.scrape.youtube.videos(
              url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
              transcription_language="English"
          )
          channels = await client.scrape.youtube.channels(
              url="https://www.youtube.com/@MrBeast/about"
          )
          comments = await client.scrape.youtube.comments(
              url="https://www.youtube.com/watch?v=dQw4w9WgXcQ", num_of_comments=100
          )


  asyncio.run(main())
  ```

  ```python Reddit theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          posts = await client.scrape.reddit.posts(
              url="https://www.reddit.com/r/python/comments/abc123/"
          )
          by_keyword = await client.scrape.reddit.posts_by_keyword(
              keyword="machine learning", sort_by="Top", date="Past week"
          )
          by_subreddit = await client.scrape.reddit.posts_by_subreddit(
              url="https://www.reddit.com/r/datascience/"
          )
          comments = await client.scrape.reddit.comments(
              url="https://www.reddit.com/r/python/comments/abc123/", days_back=30
          )


  asyncio.run(main())
  ```

  ```python Pinterest theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          posts = await client.scrape.pinterest.posts(
              url="https://www.pinterest.com/pin/3166662230556591/"
          )
          profiles = await client.scrape.pinterest.profiles(
              url="https://www.pinterest.com/boredpanda/"
          )

          # Discover by parameters
          by_keyword = await client.search.pinterest.posts_by_keyword(
              keyword="spaghetti recipes"
          )
          by_profile = await client.search.pinterest.posts_by_profile(
              url="https://www.pinterest.com/grandmapowpow/", num_of_posts=20
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      posts = client.scrape.pinterest.posts(
          url="https://www.pinterest.com/pin/3166662230556591/"
      )
      profiles = client.scrape.pinterest.profiles(
          url="https://www.pinterest.com/boredpanda/"
      )
  ```

  ```python ChatGPT theme={null}
  # Async
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          result = await client.scrape.chatgpt.prompt(
              "Explain async programming", web_search=True
          )
          batch = await client.scrape.chatgpt.prompts(
              prompts=["Explain Python", "Explain JavaScript"]
          )


  asyncio.run(main())

  # Sync
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(auto_create_zones=False) as client:
      result = client.scrape.chatgpt.prompt(
          "Explain async programming", web_search=True
      )
      batch = client.scrape.chatgpt.prompts(
          prompts=["Explain Python", "Explain JavaScript"]
      )
  ```

  ```python Digikey & Perplexity theme={null}
  import asyncio
  from brightdata import BrightDataClient

  async def main():
      async with BrightDataClient(auto_create_zones=False) as client:
          parts = await client.scrape.digikey.products(
              url="https://www.digikey.com/en/products/detail/abc"
          )
          answer = await client.scrape.perplexity.search(
              prompt="What is new in battery technology?"
          )


  asyncio.run(main())
  ```
</CodeGroup>

## Run your custom Scraper Studio scrapers

```python theme={null}
# Async
from brightdata import BrightDataClient

async with BrightDataClient() as client:
    data = await client.scraper_studio.run(
        collector="c_abc123",
        input={"url": "https://example.com/product/1"}
    )
    job = await client.scraper_studio.trigger(
        "c_abc123", {"url": "https://example.com/product/1"}
    )
    data = await job.wait_and_fetch(timeout=120)
    status = await client.scraper_studio.status("j_abc123")

# Sync
from brightdata import SyncBrightDataClient

with SyncBrightDataClient() as client:
    data = client.scraper_studio.run(
        collector="c_abc123",
        input={"url": "https://example.com/product/1"}
    )
    status = client.scraper_studio.status("j_abc123")
```

## Datasets API

Access pre-collected data snapshots.

```python theme={null}
from brightdata import SyncBrightDataClient

with SyncBrightDataClient() as client:
    # 1. Request snapshot with filters
    print("Requesting snapshot...")
    snapshot_id = client.datasets.imdb_movies(
        filter={"name": "year", "operator": "=", "value": 2024},
        records_limit=10
    )

    # 2. Download (SDK polls automatically)
    print(f"Snapshot {snapshot_id} ready. Downloading...")
    data = client.datasets.imdb_movies.download(snapshot_id)
    print(f"Downloaded {len(data)} records.")
```

<Tip>
  In your IDE, hover over the `BrightDataClient` class or **any of its methods** to view available parameters, type hints, and usage examples. The SDK provides full IntelliSense support.
</Tip>

## Use dataclass payloads for type safety

The SDK includes dataclass payloads with runtime validation and helper properties.

```python theme={null}
from brightdata import BrightDataClient
from brightdata.payloads import (
    AmazonProductPayload,
    LinkedInJobSearchPayload,
    ChatGPTPromptPayload
)

client = BrightDataClient()

# Amazon product with validation
amazon_payload = AmazonProductPayload(
    url="https://amazon.com/dp/B123456789",
    reviews_count=50  # Runtime validated.
)
print(f"ASIN: {amazon_payload.asin}")  # Helper property
print(f"Domain: {amazon_payload.domain}")

# LinkedIn job search
linkedin_payload = LinkedInJobSearchPayload(
    keyword="python developer",
    location="San Francisco",
    remote=True
)
print(f"Remote search: {linkedin_payload.is_remote_search}")

# Use with client
result = client.scrape.amazon.products(**amazon_payload.to_dict())
```

## Connect to scraping browser

Connect Playwright to Bright Data's cloud browser via the Browser API.

```python theme={null}
from brightdata import BrightDataClient
from playwright.async_api import async_playwright

client = BrightDataClient(
    browser_username="brd-customer-xxxx-zone-scraping_browser1",
    browser_password="YOUR_ZONE_PASSWORD",
)

async with async_playwright() as pw:
    browser = await pw.chromium.connect_over_cdp(client.browser.get_connect_url())
    page = await browser.new_page()
    await page.goto("https://example.com", timeout=120000)
    print(await page.content())
    await browser.close()
```

## Use the CLI tool

The SDK includes a command-line interface for terminal usage.

```bash theme={null}
# Search operations
brightdata search google "python tutorial" --location "United States"
brightdata search linkedin jobs --keyword "python developer" --remote

# Scrape operations
brightdata scrape amazon products "https://amazon.com/dp/B123"
brightdata scrape linkedin profiles "https://linkedin.com/in/johndoe"

# Generic web scraping
brightdata scrape generic "https://example.com" --output-format pretty

# Save results to file
brightdata search google "AI news" --output-file results.json
```

## Async usage for better performance

For concurrent operations, pass a list of URLs to `scrape_url` and run inside an async context manager.

```python theme={null}
import asyncio
from brightdata import BrightDataClient

async def main():
    async with BrightDataClient() as client:
        results = await client.scrape_url([
            "https://example1.com",
            "https://example2.com",
            "https://example3.com",
        ], mode="async", poll_timeout=180)

        for result in results:
            print(result.data)

asyncio.run(main())
```

## Resources

<CardGroup>
  <Card title="GitHub repository" icon="github" href="https://github.com/brightdata/sdk-python">
    View source code, examples, and contribute
  </Card>

  <Card title="Examples directory" icon="code" href="https://github.com/brightdata/sdk-python/tree/main/examples">
    10+ working examples for all features
  </Card>

  <Card title="PyPI page" icon="box" href="https://pypi.org/project/brightdata-sdk/">
    Package listing and release history
  </Card>
</CardGroup>

## What's new

| Feature | Description |
| - | - |
| **Scraper Studio** | `client.scraper_studio.run/trigger/status()`. Trigger and fetch your custom Scraper Studio scrapers. Available on both sync and async clients. |
| **Browser API** | `client.browser.get_connect_url()`. Connect Playwright/Puppeteer to Bright Data's cloud browser. Replaces `client.connect_browser()`. |
| **New scrapers** | TikTok, YouTube, Reddit, Pinterest, Digikey, Perplexity added to `client.scrape.*` |
| **Platform search** | `client.search.linkedin` / `amazon` / `instagram` / `tiktok` / `youtube` / `pinterest` / `chatgpt`. Discover content by parameters, not just URLs. |
| **126+ Datasets** | Full catalog via `client.datasets.*` with `.sample()` and `.download()` |
| **Full sync parity** | `SyncBrightDataClient` now covers all features: scrapers, search, discover, scraper studio, browser |


# JavaScript SDK
Source: https://docs.brightdata.com/api-reference/SDK-JS

Install and use the Bright Data JavaScript SDK (thousands of scrapers) to scrape URLs, search Google/Bing/Yandex and connect to the Browser API from Node.js.

This guide shows how to install the Bright Data JavaScript SDK, scrape URLs, run searches, call platform-specific scrapers (LinkedIn, Amazon, Instagram, and more), and connect to the Browser API and Scraper Studio from Node.js.

## Install the package

Open the terminal and run:

```bash theme={null}
npm install @brightdata/sdk
```

In your code file, import the package and launch your first requests:

```javascript theme={null}
import { bdclient } from '@brightdata/sdk';

const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

const html = await client.scrapeUrl('https://example.com');
const google = await client.search.google('pizza restaurants');

console.log(google);
await client.close();
```

## Launch scrapes and web searches

<CodeGroup>
  ```javascript search(...) theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  const google = await client.search.google('best laptops 2026');
  const bing = await client.search.bing('python tutorial');
  const yandex = await client.search.yandex('AI news');

  console.log({ google, bing, yandex });
  await client.close();
  ```

  ```javascript scrape(...) theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  const html = await client.scrapeUrl('https://example.com');
  const md = await client.scrapeUrl('https://example.com', {
      dataFormat: 'markdown',
      country: 'us',
  });

  console.log({ html, md });
  await client.close();
  ```
</CodeGroup>

## Platform scrapers and datasets

Collect data from popular platforms by URL, or discover content by parameters.

<CodeGroup>
  ```javascript LinkedIn theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  // Collect by URL
  const profiles = await client.scrape.linkedin.collectProfiles([
      'https://www.linkedin.com/in/satyanadella/',
  ]);
  const companies = await client.scrape.linkedin.collectCompanies([
      'https://www.linkedin.com/company/bright-data',
  ]);
  const jobs = await client.scrape.linkedin.collectJobs([
      'https://www.linkedin.com/jobs/view/123456',
  ]);
  const posts = await client.scrape.linkedin.collectPosts([
      'https://www.linkedin.com/feed/update/urn:li:activity:123',
  ]);

  // Discover by parameters
  const byKeyword = await client.scrape.linkedin.discoverJobs(
      [{ keyword: 'python developer', location: 'New York', remote: true }],
      {}
  );
  const byName = await client.scrape.linkedin.discoverProfiles(
      [{ firstName: 'John', lastName: 'Doe' }],
      {}
  );
  const compPosts = await client.scrape.linkedin.discoverCompanyPosts(
      [{ url: 'https://www.linkedin.com/company/bright-data' }],
      {}
  );
  const userPosts = await client.scrape.linkedin.discoverUserPosts(
      [{ url: 'https://www.linkedin.com/in/satyanadella' }],
      {}
  );
  ```

  ```javascript Amazon theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });

  // Collect by URL
  const products = await client.scrape.amazon.collectProducts(
      ['https://www.amazon.com/dp/B0D77BX8Y4'],
      {}
  );
  const reviews = await client.scrape.amazon.collectReviews(
      ['https://www.amazon.com/dp/B0D77BX8Y4'],
      {}
  );
  const sellers = await client.scrape.amazon.collectSellers(
      ['https://www.amazon.com/sp?seller=AXXX'],
      {}
  );

  // Discover by parameters
  const byKeyword = await client.scrape.amazon.discoverProductsByKeyword(
      [{ keyword: 'wireless headphones' }],
      {}
  );
  const byCategory = await client.scrape.amazon.discoverProductsByCategoryURL(
      ['https://amazon.com/s?category=electronics'],
      {}
  );
  const byBSUrl = await client.scrape.amazon.discoverProductsByBestSellerURL(
      ['https://amazon.com/gp/bestsellers/electronics'],
      {}
  );

  // One-call orchestrated (trigger, poll, and return)
  const result = await client.scrape.amazon.products([
      'https://www.amazon.com/dp/B0D77BX8Y4',
  ]);
  ```

  ```javascript Instagram theme={null}
  const profiles = await client.scrape.instagram.collectProfiles([
      'https://www.instagram.com/natgeo/',
  ]);
  const posts = await client.scrape.instagram.collectPosts([
      'https://www.instagram.com/p/ABC123/',
  ]);
  const reels = await client.scrape.instagram.collectReels([
      'https://www.instagram.com/reel/XYZ789/',
  ]);
  const comments = await client.scrape.instagram.collectComments([
      'https://www.instagram.com/p/ABC123/',
  ]);
  ```

  ```javascript Facebook theme={null}
  const profilePosts = await client.scrape.facebook.collectPostsByProfile([
      'https://www.facebook.com/nasa',
  ]);
  const groupPosts = await client.scrape.facebook.collectPostsByGroup([
      'https://www.facebook.com/groups/example',
  ]);
  const postByUrl = await client.scrape.facebook.collectPostsByUrl([
      'https://www.facebook.com/post/123456',
  ]);
  const comments = await client.scrape.facebook.collectComments([
      'https://www.facebook.com/post/123456',
  ]);
  const reels = await client.scrape.facebook.collectReels([
      'https://www.facebook.com/nasa',
  ]);
  ```

  ```javascript TikTok theme={null}
  const profiles = await client.scrape.tiktok.collectProfiles([
      'https://www.tiktok.com/@tiktok',
  ]);
  const posts = await client.scrape.tiktok.collectPosts([
      'https://www.tiktok.com/@user/video/7433494424040017194',
  ]);
  const comments = await client.scrape.tiktok.collectComments([
      'https://www.tiktok.com/@user/video/7216019547806092550',
  ]);
  ```

  ```javascript YouTube theme={null}
  const videos = await client.scrape.youtube.collectVideos([
      'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
  ]);
  ```

  ```javascript Reddit theme={null}
  const posts = await client.scrape.reddit.collectPosts([
      'https://www.reddit.com/r/technology/top/',
  ]);
  ```

  ```javascript ChatGPT / Perplexity / Digikey / Pinterest theme={null}
  const chatgpt = await client.scrape.chatGPT.search([
      'What are the latest trends in AI?',
  ]);
  const perplexity = await client.scrape.perplexity.search([
      'Latest breakthroughs in battery tech?',
  ]);
  const parts = await client.scrape.digikey.collectProducts([
      'https://www.digikey.com/en/products/detail/abc',
  ]);
  const pins = await client.scrape.pinterest.collectPosts([
      'https://www.pinterest.com/pin/123456',
  ]);
  ```
</CodeGroup>

## Scraper Studio

Run your custom Scraper Studio collectors from the SDK.

```javascript theme={null}
// Run and get results in one call
const results = await client.scraperStudio.run('c_your_collector_id', {
    input: { url: 'https://example.com/product/1' },
});
// results is [{ input, data, error, responseId, elapsedMs }]

// Manual: trigger, wait, and fetch
const job = await client.scraperStudio.trigger('c_your_collector_id', {
    url: 'https://example.com/product/1',
});
const data = await job.waitAndFetch();

// Check status
const status = await client.scraperStudio.status('j_abc123');
// status.status is 'queued' | 'running' | 'done' | 'failed'
```

## Browser API

Connect Playwright to Bright Data's cloud browser.

```javascript theme={null}
import { bdclient } from '@brightdata/sdk';
import { chromium } from 'playwright';

const client = new bdclient({
    apiKey: 'YOUR_API_KEY',
    browserUsername: 'brd-customer-xxxx-zone-scraping_browser1',
    browserPassword: 'YOUR_ZONE_PASSWORD',
});

const browser = await chromium.connectOverCDP(client.browser.getConnectUrl());
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();
await client.close();
```

## Datasets API

Query and download from any of the 126+ Bright Data datasets.

```javascript theme={null}
const ds = client.datasets;

// Query, then download
const snapshotId = await ds.instagramProfiles.query(
    { url: 'https://www.instagram.com/natgeo/' },
    { records_limit: 10 }
);
const rows = await ds.instagramProfiles.download(snapshotId);

// Same pattern across the full catalog
await ds.amazonProducts.query({ url: 'https://amazon.com/dp/B123' });
await ds.linkedinProfiles.query({ url: 'https://linkedin.com/in/johndoe' });
await ds.imdbMovies.query({}, { records_limit: 50 });
await ds.redditPosts.query({ subreddit: 'technology' });
await ds.glassdoorReviews.query({ company: 'Bright Data' });

// Get field metadata
const meta = await ds.instagramProfiles.getMetadata();
```

## Client and method parameters

<AccordionGroup>
  <Accordion title="Client" description="Add client parameters" icon="circle-info">
    | Parameter | Type | Description | Default |
    | - | - | - | - |
    | `apiKey` | `string` | Your API key (or `BRIGHTDATA_API_KEY` env var) | . |
    | `autoCreateZones` | `boolean` | Auto-create zones if they do not exist | `true` |
    | `webUnlockerZone` | `string` | Custom Web Unlocker zone name | . |
    | `serpZone` | `string` | Custom SERP zone name | . |
    | `browserUsername` | `string` | Browser API username (or `BRIGHTDATA_BROWSERAPI_USERNAME` env var) | . |
    | `browserPassword` | `string` | Browser API password (or `BRIGHTDATA_BROWSERAPI_PASSWORD` env var) | . |
    | `logLevel` | `string` | Log level | `'INFO'` |
    | `structuredLogging` | `boolean` | Use structured JSON logging | `true` |
    | `verbose` | `boolean` | Enable verbose logging | `false` |

    ```javascript theme={null}
    const client = new bdclient({
        apiKey: 'YOUR_API_KEY',
        autoCreateZones: true,
        webUnlockerZone: 'unlocker_zone1',
        serpZone: 'serp_zone1',
        browserUsername: 'brd-customer-xxxx-zone-scraping_browser1',
        browserPassword: 'YOUR_ZONE_PASSWORD',
        logLevel: 'INFO',
        structuredLogging: true,
        verbose: false,
    });
    ```
  </Accordion>

  <Accordion title="Search" description="Add advanced search parameters" icon="magnifying-glass-chart">
    Search the web using the SERP API.

    | Name | Type | Description | Default |
    | - | - | - | - |
    | `query` | `string \| string[]` | Search query string or array of queries | . |
    | `options.searchEngine` | `'google' \| 'bing' \| 'yandex'` | Search engine | `'google'` |
    | `options.zone` | `string` | Zone identifier (auto-configured if null) | . |
    | `options.format` | `'json' \| 'raw'` | Response format | `'raw'` |
    | `options.method` | `string` | HTTP method | `'GET'` |
    | `options.country` | `string` | Two-letter country code | `''` |
    | `options.dataFormat` | `'markdown' \| 'screenshot' \| 'html'` | Returned content format | `'html'` |
    | `options.concurrency` | `number` | Max parallel workers | `10` |
    | `options.timeout` | `number (ms)` | Request timeout | `30000` |
  </Accordion>

  <Accordion title="Scrape" description="Add advanced scrape parameters" icon="spider">
    Scrape a single URL or list of URLs using the Web Unlocker API.

    | Name | Type | Description | Default |
    | - | - | - | - |
    | `url` | `string \| string[]` | Single URL string or array of URLs | . |
    | `options.zone` | `string` | Zone identifier (auto-configured if null) | . |
    | `options.format` | `'json' \| 'raw'` | Response format | `'raw'` |
    | `options.method` | `string` | HTTP method | `'GET'` |
    | `options.country` | `string` | Two-letter country code | `''` |
    | `options.dataFormat` | `'markdown' \| 'screenshot' \| 'html'` | Returned content format | `'html'` |
    | `options.concurrency` | `number` | Max parallel workers | `10` |
    | `options.timeout` | `number (ms)` | Request timeout | `30000` |
  </Accordion>

  <Accordion title="saveResults" description="Save content to local file." icon="floppy-disk">
    | Name | Type | Description | Default |
    | - | - | - | - |
    | `content` | `any` | Content to save | . |
    | `options.filename` | `string` | Output filename (auto-generated if null) | . |
    | `options.format` | `'json' \| 'csv' \| 'txt'` | File format | . |
  </Accordion>
</AccordionGroup>

## Error handling

<AccordionGroup>
  <Accordion title="Logging" description="Enable advanced logging" icon="ballot">
    Enable `VERBOSE` in the Client for advanced logging (see Client parameters). Use the `listZones()` function to check available zones.
  </Accordion>

  <Accordion title="Authentication" description="Bright Data Auth" icon="rectangle-barcode">
    Create a [Bright Data](https://brightdata.com/) account and copy your API key. Go to [account settings](https://brightdata.com/cp/setting/users) and make sure your API key has **admin permissions**.
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup>
  <Card title="GitHub" icon="github" href="https://github.com/brightdata/bright-data-sdk-js?tab=readme-ov-file">
    Visit the Bright Data SDK GitHub repository
  </Card>
</CardGroup>


# Authentication
Source: https://docs.brightdata.com/api-reference/authentication

Authenticate with Bright Data using 1 of 2 methods: API Access with an API key or Native Access with proxy username and password. Billed at the same rate.

Bright Data ensures secure access to its services.

Bright Data provides two primary methods for authentication:

1. **API Access** - Authenticate and interact with the Bright Data platform using an API key/token.
2. **Native Access** - Authenticate and interact with the Bright Data platform using proxy protocol `username` and `password`.

<Note>
  Both API and Native access methods are billed at the same rate. Usage is charged according to your pricing plan for each Bright Data product.
</Note>

## How do I authenticate with API Key?

An API key is a secure hashed token used to authenticate with Bright Data API. We create a default key for you upon account creation automatically.
You can create additional API keys for different users and with different permissions.

<Note>
  Manage your API Keys anytime in the [Account settings](https://brightdata.com/cp/setting/users).
</Note>

### How do I relay the API key within a request?

Here’s an example request:

```sh Sample Request theme={null}
curl --request POST \
  --url https://api.brightdata.com/request \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "zone": "my_unlocker_zone",
    "url": "https://example.com/page",
    "format": "json",
    "method": "GET",
    "country": "us",
    "data_format": "markdown"
  }'
```

The important part of this request is the `Authorization` header:

```sh theme={null}
'Authorization: Bearer <token>'
```

This `<token>` is your **API key**, which is required for every API request.

### How do I authenticate with the CLI, Python SDK and JavaScript SDK?

The Bright Data CLI, Python SDK and JavaScript SDK use the same API key. Pass the key once when you set up the client, and every request the client sends carries the `Authorization` header for you.

<CodeGroup>
  ```bash CLI theme={null}
  npm install -g @brightdata/cli
  bdata login --api-key YOUR_API_KEY
  ```

  ```python Python theme={null}
  from brightdata import SyncBrightDataClient

  with SyncBrightDataClient(token="YOUR_API_KEY") as client:
      ...
  ```

  ```javascript JavaScript theme={null}
  import { bdclient } from '@brightdata/sdk';

  const client = new bdclient({ apiKey: 'YOUR_API_KEY' });
  ```
</CodeGroup>

* `bdata` is the short alias of `brightdata`. Run `bdata login` without a flag to sign in through the browser instead. The CLI stores the key locally and reads `BRIGHTDATA_API_KEY` in non-interactive environments. See [CLI installation](/products/cli/installation).
* The JavaScript SDK and the Python SDK (version 2.5.0 and later) also read `BRIGHTDATA_API_KEY`, so one variable covers the CLI and both SDKs. The Python SDK checks `BRIGHTDATA_API_TOKEN` first if it is set. See the [Python SDK](/api-reference/SDK) and [JavaScript SDK](/api-reference/SDK-JS).

### How do I generate a new API key?

To generate a new API key, follow these steps:

<Steps>
  <Step title="Sign In">
    Sign in to Bright Data's control panel and go to your [Account settings](https://brightdata.com/cp/setting/users).
  </Step>

  <Step title="Click 'Add API key'">
    Click the **Add API key** button in the top right of the API key section.

    <Warning>
      If you don’t see the 'API key' section, switch to an **admin account**. only admins can generate API keys.\
      Note: Each user can generate only one API key. The total number of API keys cannot exceed the number of account users.
    </Warning>
  </Step>

  <Step title="Configure your API key">
    Set the User, Permissions, and Expiration date (or choose 'Unlimited'), then click **Save**.
  </Step>

  <Step title="Save your API key locally">
    <Warning>
      Once generated, your API key will only be shown once. Be sure to **save it in a secure location**.
    </Warning>
  </Step>
</Steps>

### What are API Key options and configuration?

When creating an API key, you can assign one of five permission levels to control access and ensure security based on user roles or use cases. [Learn more about user roles here](/api-reference/authentication#understanding-api-key-permissions).

#### What permissions level does an API key have?

There are 5 types of permissions to choose from to control API key access:

* **Admin:** Grants full access to the account, including all Billing, Financial, product settings and configurations.
* **Finance:** Allows access to Billing and Financial pages only.
* **Ops:** Allows access to proxy/API configurations but restricts Billing access.
* **Limit:** Permits management of proxy passwords and IP allowlists/denylists.
* **User:** Enables API usage on the proxy/API level without access to Billing or product configuration pages.

#### Does the API Key have an expiration date?

When creating an API key, you can setup its expiration date. Requests authenticating with this key past the expiration date will be denied.

You can setup the expiration date as `unlimited` - although this is possible, we strongly recommend to setup an expiration date.

Consult your organization's information or data security officer for instructions.

#### How can I view the API Key settings and configuration?

You can view and manage your API Keys in [Account settings](https://brightdata.com/cp/setting/users).

#### What are Agent API keys?

Agent API keys authenticate the [Bright Data MCP](/products/mcp-server/overview) server and AI agents. Bright Data lists them in a separate **Agent API keys** table in [Account settings](https://brightdata.com/cp/setting/users), under **Users and API keys**, below the regular API keys. Each row shows the key's status, the masked key and the expiration date. Open the row menu and choose **Edit key configuration** to change the expiration date, or **Revoke key** to disable the key.

#### Why can't I see a plain text version of my API Key, or copy it?

For your security, we do not allow plain text view of  API keys with `admin` permissions. After creation you will be offered to copy and save the key.

#### Can I refresh the API key?

Yes. Once you click "Refresh" we will generate a new API key. After the refresh, any request you will send with the old key will fail to authenticate.

#### Where should I save the API key with admin permissions?

API keys are like passwords and should be dealt and saved with outmost care and under controlled access. Consult your IT manager or security administrator on how and where to save the keys per your organizations' processes and regulation.

## How do I authenticate with native proxy protocol?

### Which products can I access with proxy protocol?

Proxy protocol access is supported by:

* All proxy networks (Datacenter, ISP, Residential, and Mobile)
* Web Unlocker
* Scraping Browser

### How do I authenticate with native proxy username and password?

Here’s an example of a Native Access request:

```sh Sample Request theme={null}
curl "https://www.example.com" \
  -i --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-[ACCOUNT_ID]-zone-[PROXY_NAME]:[PROXY_PASSWORD]
```

The key part of this request is the `--proxy-user` parameter which holds the authentication credentials:

```sh proxy-user theme={null}
brd-customer-[ACCOUNT_ID]-zone-[PROXY_NAME]:[PROXY_PASSWORD]
```

This parameter is made up of three elements combined into a single string:

1. `ACCOUNT_ID` - your unique customer identifier.
2. `PROXY_NAME` - the name you gave your proxy or API (e.g., `web_unlocker1`, `datacenter_proxy1`).
3. `PROXY_PASSWORD` - the password shown in your Access Details.

Together, they form the complete proxy-user value.

### Username/password format

* All parameters are case sensitive.
* The string must be consecutive without spaces.
* `-` (dash/minus sign) separates the username substrings, and `:` (colon) separates the username from the password.

#### Account ID

Your Account ID is a unique identifier automatically generated when your Bright Data account is created. It is used for authentication and account-related operations.

To find your Account ID, follow these steps:

<Steps>
  <Step title={<>Click on <a href="https://brightdata.com/cp/setting/customer_details">Account Settings</a> in the left-hand menu.</>} />

  <Step title="Open the Profile tab." />

  <Step title="Locate and copy your Account ID." />
</Steps>

<Frame>
  <img alt="Account ID " />
</Frame>

<Note>
  Your Account ID is always a text string that begins with `hl_###`.
</Note>

#### Username

Each product you create in the Bright Data dashboard is assigned a **Username** visible in the product's **Access Details** section. The username follows this format:

```text theme={null}
brd-customer-[ACCOUNT_ID]-zone-[PRODUCT_NAME]
```

For example: `brd-customer-hl_7abed23d-zone-web_unlocker1`

This name is set **once** when you create a proxy or API and cannot be changed later. You can find your username by opening your proxy or API (under [Proxies](https://brightdata.com/cp/zones) or [Web Access](https://brightdata.com/cp/zones)) and checking the **Access Details** section.

#### Password

Each proxy or API is assigned a unique **Password** that is required for authenticating Native Access requests. You can find it in the **Access Details** section.

To view or update your password, follow these steps:

<Steps>
  <Step title="Open your product in the dashboard (under Proxies or Web Access)." />

  <Step title="Locate the Password field in the Access Details section." />

  <Step title="Copy your current password, or generate a new one from the Configuration tab under Security Settings." />
</Steps>

## Comparing API Access vs. Native Access

| Feature | API Access | Native Access |
| :- | :- | :- |
| **Used for** | Seamless integration with scripts, automation tools, or third-party APIs | Direct proxy connections in browsers, crawlers, or proxy-compatible tools |
| **Recommended products** | - [Web Unlocker API](/products/web-unlocker/introduction)<br />- [SERP](/products/serp-api/introduction)<br />- [Browsers](/products/scraping-browser/introduction)<br />- [Scrapers](/products/scrapers/overview)<br />- [Functions](/products/scraper-studio/introduction)<br />- [Marketplace](/datasets/marketplace) | [Proxies](/left-over/proxy-networks-introduction) |
| [**SSL certificate**](/general/account/ssl-certificate) | Not required | Required to access without KYC the residential network & unlocker. More info [here.](/products/residential/network-access) |
| **Connection via** | API endpoint | Proxy endpoint |
| **Authentication** | [API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F) | `username:password` |
| **Output options** | HTML or JSON | HTML |


# Scraper async requests
Source: https://docs.brightdata.com/api-reference/rest-api/scraper/asynchronous-requests

api-reference/rest-api/scraper/scraper-rest-api.json POST /datasets/v3/trigger
Trigger a Bright Data Scraper API async collection with POST /datasets/v3/trigger. Returns a snapshot ID to monitor progress and download results.

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"user_name":"zoobarcelona"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/trigger",
      params={
          "dataset_id": "gd_l1vikfch901nx3by4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "user_name",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={"input": [{"user_name": "zoobarcelona"}], "limit_per_input": None},
  )

  snapshot = response.json()
  print("Snapshot ID:", snapshot["snapshot_id"])
  ```

  ```javascript Node.js (Axios) theme={null}
  import axios from "axios";

  const response = await axios.post(
    "https://api.brightdata.com/datasets/v3/trigger",
    { input: [{ user_name: "zoobarcelona" }], limit_per_input: null },
    {
      params: {
        dataset_id: "gd_l1vikfch901nx3by4",
        notify: false,
        include_errors: true,
        type: "discover_new",
        discover_by: "user_name",
      },
      headers: { Authorization: "Bearer YOUR_API_KEY" },
    }
  );

  console.log("Snapshot ID:", response.data.snapshot_id);
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l1vikfch901nx3by4",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "user_name",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/trigger?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ input: [{ user_name: "zoobarcelona" }], limit_per_input: null }),
  });

  const snapshot = await response.json();
  console.log("Snapshot ID:", snapshot.snapshot_id);
  ```
</RequestExample>

`POST /datasets/v3/trigger` starts an asynchronous Scraper API collection and returns a `snapshot_id`. The example discovers Instagram profiles by username (`gd_l1vikfch901nx3by4`). To get the records in the same response instead, call [`POST /datasets/v3/scrape`](/api-reference/scrapers/synchronous-requests) with the same query and body.

## Request body

Send an object with an `input` array:

| Field | Type | Description |
| :- | :- | :- |
| `input` | array of objects, required | The inputs to scrape. The fields depend on the scraper, for example `url` or `user_name` |
| `limit_per_input` | integer or `null` | Maximum records returned per input, or `null` |
| `deliver` | object | Delivery destination for this job. See [How to deliver Scraper API results](/products/scrapers/scrapers-library/data-delivery) |

A bare JSON array of input objects is also accepted. It cannot carry `limit_per_input` or `deliver`.

## Query parameters in the example

| Parameter | Value in the example | Description |
| :- | :- | :- |
| `dataset_id` | `gd_l1vikfch901nx3by4` | The scraper to run |
| `notify` | `false` | Whether to send a completion notification |
| `include_errors` | `true` | Include error records in the results |
| `type` | `discover_new` | Discovery scrapers only |
| `discover_by` | `user_name` | Discovery scrapers only. The discovery method, which differs per scraper |

The example sends no `format` parameter.

## Output formats

Scraper API output formats are NDJSON (default), JSON, JSON lines, CSV and Parquet. Each one has its own API value, and not every value is accepted everywhere:

| Format | API value | `format` on `/scrape` | `format` on `/trigger` | `deliver.filename.extension` |
| :- | :- | :- | :- | :- |
| NDJSON (default) | `ndjson` | Yes | Yes | Yes |
| JSON | `json` | Yes | Yes | Yes |
| JSON lines | `jsonl` | Yes | Yes | Yes |
| CSV | `csv` | Yes | Yes | Yes |
| Parquet | `parquet` | Not listed | Not listed | Yes |

A `/scrape` request or a snapshot download with no `format` returns NDJSON, one record per line. Set `format=json` to get a JSON array instead. Verified on September 30, 2026.

"Not listed" means the value is not in the API specification for that parameter. NDJSON and JSON lines are separate API values, `ndjson` and `jsonl`.

Related guide: [How to scrape in bulk with async requests](/products/scrapers/scrapers-library/async-requests)

Error messages and fixes: [Scraper API error codes](/products/scrapers/error-codes)


# Deliver snapshot to storage or webhook
Source: https://docs.brightdata.com/api-reference/scrapers/delivery-apis/deliver-snapshot

api-reference/dca-api POST /datasets/v3/deliver/{snapshot_id}
Deliver a Bright Data Scraper API snapshot to webhook, S3, GCS, Azure, or Snowflake. Specify the snapshot ID and target in the request body.



# Download snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/delivery-apis/download-snapshot

api-reference/dca-api GET /datasets/v3/snapshot/{snapshot_id}
Download results from a completed Bright Data Scraper API async job by snapshot ID. Pull-based delivery with a 5 GB per-request size limit.

Use this endpoint to pull scraped data directly from the Bright Data API once an async collection job finishes. This is the simplest delivery method: you trigger a job, poll until the snapshot is `ready`, then download the results on demand.

## When to use API download

API download is the right choice when:

* You want a pull-based workflow instead of pushing data to your own infrastructure.
* You don't need results delivered to a specific storage bucket or webhook endpoint.
* Your result set fits within the 5 GB per-request size limit.
* You are prototyping or running ad-hoc jobs and don't want to configure a delivery destination.

If you need automatic delivery or larger result sets, see the other [delivery options](/products/scrapers/scrapers-library/data-delivery) (webhooks, Amazon S3, Google Cloud Storage, Azure, Snowflake).

## How it works

1. Trigger an async collection with [`POST /datasets/v3/trigger`](/api-reference/rest-api/scraper/asynchronous-requests). The response contains a `snapshot_id`.
2. Poll [`GET /datasets/v3/progress/{snapshot_id}`](/api-reference/scrapers/management-apis/monitor-progress) until `status` is `ready`.
3. Call this endpoint with the `snapshot_id` to download the data.

<Note>
  Results are retained for 30 days after the job completes. Download within that window, or configure a [delivery option](/products/scrapers/scrapers-library/data-delivery) to have data pushed to your storage automatically.
</Note>

## Quick example

```bash cURL theme={null}
curl "https://api.brightdata.com/datasets/v3/snapshot/s_m4x7enmven8djfqak?format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o results.json
```

The response is the raw dataset in the format you request. JSON returns an array of records, NDJSON and JSON Lines return one record per line, and CSV returns a header row followed by rows.

## Downloading large snapshots in parts

For snapshots larger than a few hundred megabytes, split the download into parts to avoid timeouts and memory pressure on your client:

1. Request the first batch with a `batch_size` (minimum 1000 records) and `part=1`.
2. Call [`GET /datasets/v3/snapshot/{snapshot_id}/parts`](/api-reference/scrapers/management-apis/get-snapshot-delivery-parts) to see how many parts exist.
3. Request each remaining part by incrementing the `part` parameter.

Keep `batch_size`, `format` and `compress` identical across all part requests, otherwise the API returns an error.

## Limits

| Limit | Value |
| :- | :- |
| Max download size per request | 5 GB |
| Result retention | 30 days |
| Minimum `batch_size` | 1000 records |
| Supported formats | `json`, `ndjson`, `jsonl`, `csv` |

## Endpoint


# Scrape Amazon products by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-collect-by-url

api-reference/sdk-specs/amazon-products-collect-by-url POST /datasets/v3/scrape
Collect Amazon product page data by product URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l7q7dkf244hwjntr0.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Products by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon product to collect.
    </ParamField>

    <ParamField type="number">
      Filter by the number of units bought in the past month.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/dp/B0FQFB8FMG"},
      {"url": "https://www.amazon.com/dp/B09V3KXJPB"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json theme={null}
  [
    {
      "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",
      "asin": "B0FQFB8FMG",
      "brand": "Apple",
      "initial_price": 249,
      "final_price": 199.99,
      "currency": "USD",
      "rating": 4.4,
      "reviews_count": 14302,
      "seller_name": "Amazon.com",
      "availability": "In Stock",
      "image_url": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_SL1500_.jpg",
      "url": "https://www.amazon.com/dp/B0FQFB8FMG"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon best sellers by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-best-sellers-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon products from a best sellers page URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l7q7dkf244hwjntr0.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by Best Sellers URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `best_sellers_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon best sellers page.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&notify=false&include_errors=true&type=discover_new&discover_by=best_sellers_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_l7q7dkf244hwjntr0",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "best_sellers_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l7q7dkf244hwjntr0",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "best_sellers_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Portable Bluetooth Speaker",
      "url": "https://www.amazon.com/dp/B09XY1234Z",
      "asin": "B09XY1234Z",
      "price": 39.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 85200,
      "seller_name": "AudioTech Direct",
      "brand": "AudioTech",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-bestseller.jpg",
      "description": "Compact portable speaker with 20-hour battery and waterproof design.",
      "category": "Electronics > Portable Audio > Speakers"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon products by category URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-category-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon products from a category page URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l7q7dkf244hwjntr0.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by Category URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `category_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon category page.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/s?bbn=172282&rh=n%3A172282"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.amazon.com/s?bbn=172282&rh=n%3A172282"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&notify=false&include_errors=true&type=discover_new&discover_by=category_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_l7q7dkf244hwjntr0",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "category_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.amazon.com/s?bbn=172282&rh=n%3A172282",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l7q7dkf244hwjntr0",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "category_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.amazon.com/s?bbn=172282&rh=n%3A172282",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "USB-C Fast Charging Cable 6ft",
      "url": "https://www.amazon.com/dp/B0B12345AB",
      "asin": "B0B12345AB",
      "price": 12.99,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 34500,
      "seller_name": "CablePro",
      "brand": "CablePro",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-category.jpg",
      "description": "Durable braided USB-C cable with fast charging support up to 100W.",
      "category": "Electronics > Accessories > Cables"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon products by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon products that match a search keyword with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l7q7dkf244hwjntr0.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for Amazon products.
    </ParamField>

    <ParamField type="string">
      The ZIP code to use for location-based results.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "wireless mouse",
        "zipcode": "10001"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"keyword":"wireless mouse","zipcode":"10001"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_l7q7dkf244hwjntr0",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"keyword": "wireless mouse", "zipcode": "10001"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l7q7dkf244hwjntr0",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ keyword: "wireless mouse", zipcode: "10001" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Ergonomic Wireless Mouse with USB Receiver",
      "url": "https://www.amazon.com/dp/B0C98765XY",
      "asin": "B0C98765XY",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.4,
      "reviews_count": 18700,
      "seller_name": "PeripheralsDirect",
      "brand": "ErgoClick",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-mouse.jpg",
      "description": "Lightweight ergonomic wireless mouse with adjustable DPI and silent clicks.",
      "category": "Electronics > Computers > Mice"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon products by UPC
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-discover-by-upc

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon products by UPC barcode number with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l7q7dkf244hwjntr0.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l7q7dkf244hwjntr0` to collect **Discover by UPC** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `upc`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The UPC code of the product to look up.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"upc": "012345678901"},
      {"upc": "098765432109"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"upc":"012345678901"},{"upc":"098765432109"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&notify=false&include_errors=true&type=discover_new&discover_by=upc"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_l7q7dkf244hwjntr0",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "upc",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"upc": "012345678901"}, {"upc": "098765432109"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l7q7dkf244hwjntr0",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "upc",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ upc: "012345678901" }, { upc: "098765432109" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Stainless Steel Water Bottle 32oz",
      "url": "https://www.amazon.com/dp/B0D11223AB",
      "asin": "B0D11223AB",
      "price": 19.99,
      "currency": "USD",
      "rating": 4.8,
      "reviews_count": 42300,
      "seller_name": "HydroGear",
      "brand": "HydroGear",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-bottle.jpg",
      "description": "Double-wall vacuum insulated water bottle that keeps drinks cold for 24 hours.",
      "category": "Sports & Outdoors > Water Bottles"
    }
  ]
  ```
</ResponseExample>


# Scrape Amazon global products by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect Amazon global product data by product URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lwhideng15g8jg63s7.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Products Global by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon product from any country domain.
    </ParamField>

    <ParamField type="number">
      Filter by the number of units bought in the past month.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.de/-/en/dp/B078TNNZK3"},
      {"url": "https://www.amazon.co.jp/dp/B0CWV9YTLV"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Bluetooth Portable Speaker Waterproof",
      "url": "https://www.amazon.de/-/en/dp/B078TNNZK3",
      "asin": "B078TNNZK3",
      "price": 59.99,
      "currency": "EUR",
      "rating": 4.5,
      "reviews_count": 23400,
      "seller_name": "AudioWorld DE",
      "brand": "SoundMax",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-global.jpg",
      "description": "Waterproof portable speaker with 360-degree sound and 12-hour battery.",
      "category": "Electronics > Audio > Speakers",
      "country_domain": "amazon.de"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon global by brand
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-brand

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon global products from a brand page URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lwhideng15g8jg63s7.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Brand** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `brand`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon brand page.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "brand_url": "https://www.amazon.com/stores/BrandName/page/12345678-ABCD-1234-EFGH-123456789012",
        "num_of_products": 20
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"brand_url":"https://www.amazon.com/stores/BrandName/page/12345678-ABCD-1234-EFGH-123456789012","num_of_products":20}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&notify=false&include_errors=true&type=discover_new&discover_by=brand"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lwhideng15g8jg63s7",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "brand",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "brand_url": "https://www.amazon.com/stores/BrandName/page/12345678-ABCD-1234-EFGH-123456789012",
                  "num_of_products": 20,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lwhideng15g8jg63s7",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "brand",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          brand_url: "https://www.amazon.com/stores/BrandName/page/12345678-ABCD-1234-EFGH-123456789012",
          num_of_products: 20,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Smart Fitness Tracker with Heart Rate Monitor",
      "url": "https://www.amazon.com/dp/B0D55667AB",
      "asin": "B0D55667AB",
      "price": 49.99,
      "currency": "USD",
      "rating": 4.3,
      "reviews_count": 9800,
      "seller_name": "FitTech Official",
      "brand": "FitTech",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-brand.jpg",
      "description": "Slim fitness tracker with continuous heart rate monitoring and sleep tracking.",
      "category": "Electronics > Wearables > Fitness Trackers",
      "country_domain": "amazon.com"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon global by category URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-category-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon global products from a category URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lwhideng15g8jg63s7.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Category URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `category_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon category page.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "category_url": "https://www.amazon.de/-/en/b?node=340843031",
        "num_of_products": 25
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"category_url":"https://www.amazon.de/-/en/b?node=340843031","num_of_products":25}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&notify=false&include_errors=true&type=discover_new&discover_by=category_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lwhideng15g8jg63s7",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "category_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "category_url": "https://www.amazon.de/-/en/b?node=340843031",
                  "num_of_products": 25,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lwhideng15g8jg63s7",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "category_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          category_url: "https://www.amazon.de/-/en/b?node=340843031",
          num_of_products: 25,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Mechanical Gaming Keyboard RGB Backlit",
      "url": "https://www.amazon.de/dp/B0C44556CD",
      "asin": "B0C44556CD",
      "price": 79.99,
      "currency": "EUR",
      "rating": 4.6,
      "reviews_count": 5600,
      "seller_name": "GamerGear EU",
      "brand": "KeyMaster",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-keyboard.jpg",
      "description": "Full-size mechanical keyboard with customizable RGB and hot-swappable switches.",
      "category": "Computers & Accessories > Keyboards",
      "country_domain": "amazon.de"
    }
  ]
  ```
</ResponseExample>


# Scrape Amazon reviews by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-reviews-collect-by-url

api-reference/sdk-specs/amazon-reviews-collect-by-url POST /datasets/v3/scrape
Collect Amazon customer reviews of a product by product URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_le8e811kzy4ggddlq.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_le8e811kzy4ggddlq` to collect **Reviews by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon product to collect reviews from.
    </ParamField>

    <ParamField type="string[]">
      An array of review IDs to exclude from the results.
    </ParamField>

    <ParamField type="number">
      The maximum number of reviews to collect for this URL.
    </ParamField>

    <ParamField type="boolean">
      Set to `true` to collect reviews only for the product variation in the URL.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/dp/B0FQFB8FMG", "max_reviews": 50}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.amazon.com/dp/B0FQFB8FMG",
      "asin": "B0FQFB8FMG",
      "reviewer_name": "John D.",
      "rating": 5,
      "review_title": "Best headphones I have ever owned",
      "review_text": "Incredible sound quality and the noise cancellation is top-notch. Battery lasts for days on a single charge.",
      "review_date": "2025-01-15T00:00:00.000Z",
      "verified_purchase": true
    }
  ]
  ```
</ResponseExample>


# Scrape Amazon seller info by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-sellers-info-collect-by-url

api-reference/sdk-specs/amazon-sellers-info-collect-by-url POST /datasets/v3/scrape
Collect Amazon seller profile information by seller URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lhotzucw1etoe5iw1k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lhotzucw1etoe5iw1k` to collect **Sellers Info by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon seller page to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "seller_name": "Electronics Hub",
      "seller_url": "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7",
      "seller_id": "A2FE2Y3KEQLBV7",
      "rating": 4.5,
      "reviews_count": 8920,
      "business_name": "Electronics Hub LLC",
      "business_address": "123 Commerce St, Seattle, WA 98101"
    }
  ]
  ```
</ResponseExample>


# Cancel snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/cancel-snapshot

api-reference/dca-api post /datasets/v3/snapshot/{snapshot_id}/cancel
Use Bright Data Scraper API management endpoints to cancel Snapshot. POST /datasets/v3/snapshot/{id}/cancel returns snapshot or job status as JSON.



# Get all scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-scrapers

api-reference/dca-api get /datasets/v3/scrapers
List every scraper on your Bright Data account. GET /datasets/v3/scrapers returns each scraper's dataset ID, domain, input schema and output fields.

<Tip>
  To look up dataset IDs without an API key, read [scrapers.json](/scrapers.json). It lists the dataset ID, name, domain and collection methods of every pre-built scraper and refreshes daily.
</Tip>


# Get snapshot delivery parts
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-snapshot-delivery-parts

api-reference/dca-api get /datasets/v3/snapshot/{snapshot_id}/parts
Use Bright Data Scraper API management endpoints to get Snapshot Delivery Parts. Endpoint: GET /datasets/v3/snapshot/{snapshot_id}/parts.



# Get snapshot input
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-snapshot-input

api-reference/dca-api get /datasets/v3/snapshot/{snapshot_id}/input
Use Bright Data Scraper API management endpoints to get Snapshot Input. GET /datasets/v3/snapshot/{id}/input returns snapshot or job status as JSON.



# Get snapshots
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/get-snapshots

api-reference/dca-api get /datasets/v3/snapshots
Use Bright Data Scraper API management endpoints to get Snapshots. GET /datasets/v3/snapshots returns snapshot or job status as JSON.



# Monitor delivery
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/monitor-delivery

api-reference/dca-api get /datasets/v3/delivery/{delivery_id}
Use Bright Data Scraper API management endpoints to monitor Delivery. GET /datasets/v3/delivery/{delivery_id} returns snapshot or job status as JSON.



# Monitor progress
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/monitor-progress

api-reference/dca-api get /datasets/v3/progress/{snapshot_id}
Use Bright Data Scraper API management endpoints to monitor Progress. GET /datasets/v3/progress/{id} returns snapshot or job status as JSON.

* [**Asynchronous Usage**](/api-reference/rest-api/scraper/asynchronous-requests)**:** Trigger a data collection job via the async endpoint (`/trigger`), receive a `snapshot_id`, and poll the Monitor Progress API until the status is ready, then download the results.
* [**Synchronous Usage**](/api-reference/scrapers/synchronous-requests)**:** If a sync request (`/scrape`) exceeds the 1-minute timeout, receive a `snapshot_id` to poll the Monitor Progress API and download the results once they are ready.

The Monitor Progress API provides flexibility and stability, allowing efficient handling of large data volumes by differentiating between immediate and delayed result retrievals.

<Tip>
  If the request takes too long, we recommend sending an Asynchronous request.
</Tip>


# Pause snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/pause-snapshot

api-reference/dca-api post /datasets/v3/snapshot/{snapshot_id}/pause
Use Bright Data Scraper API management endpoints to pause a running snapshot. POST /datasets/v3/snapshot/{id}/pause returns 200 OK as plain text.



# Rerun snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/rerun-snapshot

api-reference/dca-api post /datasets/v3/snapshot/{snapshot_id}/rerun
Use Bright Data Scraper API management endpoints to rerun Snapshot. POST /datasets/v3/snapshot/{id}/rerun returns snapshot or job status as JSON.



# Resume snapshot
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/resume-snapshot

api-reference/dca-api post /datasets/v3/snapshot/{snapshot_id}/resume
Use Bright Data Scraper API management endpoints to resume a paused snapshot. POST /datasets/v3/snapshot/{id}/resume returns 200 OK as plain text.



# Get snapshot log
Source: https://docs.brightdata.com/api-reference/scrapers/management-apis/snapshot-data

api-reference/dca-api get /datasets/v3/log/{snapshot_id}
Get a Bright Data Scraper API snapshot log: GET /datasets/v3/log/{id} returns snapshot or job status as JSON. Use Download snapshot for the records.



# Scrape Facebook comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-comments-collect-by-url

api-reference/sdk-specs/facebook-comments-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect Facebook comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkay758p1eanlolqw8` to collect **Facebook comments** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook post to collect comments from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/NASA/posts/1234567890"},
      {"url": "https://www.facebook.com/Meta/posts/9876543210"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/Pagina12ok/posts/pfbid0...",
      "post_id": "1287876623560800",
      "post_url": "https://www.facebook.com/Pagina12ok/posts/pfbid0...",
      "comment_id": "Y29tbWVudDox...",
      "user_name": "Norma Ester Mercado",
      "user_id": "pfbid0...",
      "user_url": "https://www.facebook.com/normaester.mercado.1",
      "date_created": "2026-04-02T23:46:29.000Z",
      "comment_text": "Great post, thanks for sharing!",
      "num_likes": 1,
      "num_replies": 0,
      "attached_files": null,
      "type": "Comment",
      "reply": true,
      "parent_comment_id": "Y29tbWVudDox..."
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook company reviews by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-company-reviews-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect Facebook reviews of a company page by reviews URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_m0dtqpiu1mbcyc2g86.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m0dtqpiu1mbcyc2g86` to collect **Facebook company reviews** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook page reviews to collect.
    </ParamField>

    <ParamField type="number">
      The number of reviews to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/PepsiCo/reviews/", "num_of_reviews": 50},
      {"url": "https://www.facebook.com/CocaCola/reviews/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/PepsiCo/reviews/",
      "review_id": "pfbid02abc123def456",
      "reviewer_name": "John Smith",
      "reviewer_url": "https://www.facebook.com/john.smith.123",
      "rating": 5,
      "review_text": "Great company with excellent products and customer service.",
      "date_posted": "2026-03-15T14:30:00.000Z",
      "num_likes": 3,
      "company_name": "PepsiCo",
      "company_url": "https://www.facebook.com/PepsiCo",
      "company_rating": 4.2,
      "total_reviews": 1250
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook events by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-events-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect Facebook event details by event URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_m14sd0to1jz48ppm51.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m14sd0to1jz48ppm51` to collect **Facebook events** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook event to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/events/1546764716269782"},
      {"url": "https://www.facebook.com/events/9876543210123456"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/events/1546764716269782",
      "event_id": "1546764716269782",
      "name": "Tech Innovation Summit 2026",
      "description": "Join us for a day of innovation and networking...",
      "start_date": "2026-06-15T09:00:00.000Z",
      "end_date": "2026-06-15T17:00:00.000Z",
      "location": "San Francisco Convention Center",
      "address": "747 Howard St, San Francisco, CA 94103",
      "organizer": "TechEvents Inc.",
      "organizer_url": "https://www.facebook.com/techevents",
      "attendees_count": 1250,
      "interested_count": 3400,
      "is_online": false,
      "ticket_url": "https://techsummit2026.eventbrite.com",
      "cover_photo": "https://...",
      "category": "Science & Technology"
    }
  ]
  ```
</ResponseExample>


# Discover Facebook events by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-events-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover Facebook events from an events search URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_m14sd0to1jz48ppm51.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m14sd0to1jz48ppm51` to collect **Facebook events** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Facebook events page URL to discover events from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/events/search/?q=tech+conference"},
      {"url": "https://www.facebook.com/events/search/?q=music+festival"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/events/1546764716269782",
      "event_id": "1546764716269782",
      "name": "Tech Innovation Summit 2026",
      "description": "Join us for a day of innovation and networking...",
      "start_date": "2026-06-15T09:00:00.000Z",
      "end_date": "2026-06-15T17:00:00.000Z",
      "location": "San Francisco Convention Center",
      "address": "747 Howard St, San Francisco, CA 94103",
      "organizer": "TechEvents Inc.",
      "organizer_url": "https://www.facebook.com/techevents",
      "attendees_count": 1250,
      "interested_count": 3400,
      "is_online": false,
      "ticket_url": "https://techsummit2026.eventbrite.com",
      "cover_photo": "https://...",
      "category": "Science & Technology"
    }
  ]
  ```
</ResponseExample>


# Discover Facebook events by venue
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-events-discover-by-venue

POST https://api.brightdata.com/datasets/v3/scrape
Discover Facebook events hosted at a named venue with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_m14sd0to1jz48ppm51.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m14sd0to1jz48ppm51` to collect **Facebook events** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The venue name or ID to discover events for.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"venue": "Madison Square Garden"},
      {"venue": "Staples Center"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/events/1546764716269782",
      "event_id": "1546764716269782",
      "name": "Tech Innovation Summit 2026",
      "description": "Join us for a day of innovation and networking...",
      "start_date": "2026-06-15T09:00:00.000Z",
      "end_date": "2026-06-15T17:00:00.000Z",
      "location": "San Francisco Convention Center",
      "address": "747 Howard St, San Francisco, CA 94103",
      "organizer": "TechEvents Inc.",
      "organizer_url": "https://www.facebook.com/techevents",
      "attendees_count": 1250,
      "interested_count": 3400,
      "is_online": false,
      "ticket_url": "https://techsummit2026.eventbrite.com",
      "cover_photo": "https://...",
      "category": "Science & Technology"
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook Marketplace by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-marketplace-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect Facebook Marketplace listings by listing URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lvt9iwuh6fbcwmx1a.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvt9iwuh6fbcwmx1a` to collect **Facebook Marketplace listings** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook Marketplace listing to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/marketplace/item/1234567890"},
      {"url": "https://www.facebook.com/marketplace/item/9876543210"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/1259177466401495",
      "title": "2018 Mercedes-Benz C 300 Convertible 27k miles",
      "initial_price": 35995,
      "final_price": 35995,
      "currency": "USD",
      "product_id": "1259177466401495",
      "condition": "USED",
      "description": "1 owner, 2.0 turbo all wheel drive, leather seating pkg...",
      "location": "Knoxville, TN",
      "country_code": "US",
      "images": ["https://..."],
      "seller_description": "1 owner, 2.0 turbo...",
      "color": "grey",
      "brand": null,
      "videos": null,
      "profile_id": "34591790377134943",
      "listing_date": "2026-04-02T11:25:00.000Z"
    }
  ]
  ```
</ResponseExample>


# Discover Facebook Marketplace by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-marketplace-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Discover Facebook Marketplace listings by search keyword with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lvt9iwuh6fbcwmx1a.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvt9iwuh6fbcwmx1a` to collect **Facebook Marketplace listings** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The search keyword for discovering Marketplace listings.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"keyword": "used iPhone"},
      {"keyword": "vintage furniture"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/1259177466401495",
      "title": "2018 Mercedes-Benz C 300 Convertible 27k miles",
      "initial_price": 35995,
      "final_price": 35995,
      "currency": "USD",
      "product_id": "1259177466401495",
      "condition": "USED",
      "description": "1 owner, 2.0 turbo all wheel drive, leather seating pkg...",
      "location": "Knoxville, TN",
      "country_code": "US",
      "images": ["https://..."],
      "seller_description": "1 owner, 2.0 turbo...",
      "color": "grey",
      "brand": null,
      "videos": null,
      "profile_id": "34591790377134943",
      "listing_date": "2026-04-02T11:25:00.000Z"
    }
  ]
  ```
</ResponseExample>


# Discover Facebook Marketplace by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-marketplace-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover Facebook Marketplace listings from a category URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lvt9iwuh6fbcwmx1a.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvt9iwuh6fbcwmx1a` to collect **Facebook Marketplace listings** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Facebook Marketplace search URL to discover listings from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/marketplace/category/electronics"},
      {"url": "https://www.facebook.com/marketplace/category/vehicles"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/marketplace/item/1259177466401495",
      "title": "2018 Mercedes-Benz C 300 Convertible 27k miles",
      "initial_price": 35995,
      "final_price": 35995,
      "currency": "USD",
      "product_id": "1259177466401495",
      "condition": "USED",
      "description": "1 owner, 2.0 turbo all wheel drive, leather seating pkg...",
      "location": "Knoxville, TN",
      "country_code": "US",
      "images": ["https://..."],
      "seller_description": "1 owner, 2.0 turbo...",
      "color": "grey",
      "brand": null,
      "videos": null,
      "profile_id": "34591790377134943",
      "listing_date": "2026-04-02T11:25:00.000Z"
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook pages and profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-pages-and-profiles-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect Facebook page and profile data by URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_mf124a0511bauquyow.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mf124a0511bauquyow` to collect **Facebook pages and profiles** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook page or profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/zuck"},
      {"url": "https://www.facebook.com/NASA"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "100063743733252",
      "url": "https://www.facebook.com/tgfightsport",
      "page_name": "TG-Fight Sport",
      "username": "tgfightsport",
      "entity_type": "PAGE",
      "summary_text": "Martial arts training for all levels...",
      "primary_category": "Martial Arts School",
      "address": { "formatted": "Alleestrasse 1, Beckum, Germany" },
      "phones": ["+49 176 68576249"],
      "emails": ["tg-fightsport@hotmail.com"],
      "websites": null,
      "rating": null,
      "contact_and_basic_info": {
        "basic_info": {
          "hours": { "open_now": true },
          "rating": { "count": 4, "value": 0 }
        },
        "categories": ["Martial Arts School"],
        "contact_info": {
          "address": { "formatted": "Alleestrasse 1, Beckum, Germany, 59269" },
          "emails": ["tg-fightsport@hotmail.com"],
          "websites": ["https://www.tg-fightsport.com/"]
        }
      },
      "followers": 870,
      "logo": "https://...",
      "is_verified": false
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook page posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url

api-reference/sdk-specs/facebook-pages-posts-collect-by-url POST /datasets/v3/scrape
Collect posts from a Facebook page by page URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lkaxegm826bjpoo9m5.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkaxegm826bjpoo9m5` to collect **Facebook page posts** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook page to collect posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/NASA"},
      {"url": "https://www.facebook.com/Meta"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/reel/1417029756382510/",
      "post_id": "1325707186087218",
      "user_url": "https://www.facebook.com/delish",
      "user_username_raw": "delish",
      "content": "Sweet niblets! This just unlocked a childhood memory",
      "date_posted": "2026-03-21T19:01:34.000Z",
      "hashtags": null,
      "num_comments": 1,
      "num_shares": 2,
      "num_likes_type": { "num": 34, "type": "Like" },
      "page_name": "Delish",
      "profile_id": "100059438474191",
      "page_intro": "Fun eats every day of the week.",
      "page_category": "News & media website",
      "page_logo": "https://...",
      "page_external_website": "likeshop.me/delish",
      "page_likes": null,
      "page_followers": 21000000,
      "page_is_verified": true,
      "original_post": { "user_avatar_image": null },
      "attachments": [
        {
          "attachment_url": "https://...",
          "id": "1417029756382510",
          "thumbnail_url": "https://...",
          "type": "Video",
          "url": "https://...",
          "video_length": "15509",
          "video_url": "https://..."
        }
      ],
      "page_url": "https://www.facebook.com/delish",
      "header_image": "https://...",
      "avatar_image_url": "https://...",
      "profile_handle": "delish",
      "is_sponsored": false,
      "shortcode": "1325707186087218",
      "video_view_count": 24093,
      "likes": 39,
      "post_type": "Reel",
      "following": 19,
      "count_reactions_type": [
        { "reaction_count": 34, "type": "Like" },
        { "reaction_count": 4, "type": "Haha" }
      ],
      "is_page": true,
      "play_count": 45717
    }
  ]
  ```
</ResponseExample>


# Discover Facebook page posts by username
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-pages-posts-discover-by-username

POST https://api.brightdata.com/datasets/v3/scrape
Discover posts from a Facebook page by page username with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lkaxegm826bjpoo9m5.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkaxegm826bjpoo9m5` to collect **Facebook page posts** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Facebook page username.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"user_name": "NASA"},
      {"user_name": "Meta"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/reel/1417029756382510/",
      "post_id": "1325707186087218",
      "user_url": "https://www.facebook.com/delish",
      "user_username_raw": "delish",
      "content": "Sweet niblets! This just unlocked a childhood memory",
      "date_posted": "2026-03-21T19:01:34.000Z",
      "hashtags": null,
      "num_comments": 1,
      "num_shares": 2,
      "num_likes_type": { "num": 34, "type": "Like" },
      "page_name": "Delish",
      "profile_id": "100059438474191",
      "page_intro": "Fun eats every day of the week.",
      "page_category": "News & media website",
      "page_logo": "https://...",
      "page_external_website": "likeshop.me/delish",
      "page_likes": null,
      "page_followers": 21000000,
      "page_is_verified": true,
      "original_post": { "user_avatar_image": null },
      "attachments": [
        {
          "attachment_url": "https://...",
          "id": "1417029756382510",
          "thumbnail_url": "https://...",
          "type": "Video",
          "url": "https://...",
          "video_length": "15509",
          "video_url": "https://..."
        }
      ],
      "page_url": "https://www.facebook.com/delish",
      "header_image": "https://...",
      "avatar_image_url": "https://...",
      "profile_handle": "delish",
      "is_sponsored": false,
      "shortcode": "1325707186087218",
      "video_view_count": 24093,
      "likes": 39,
      "post_type": "Reel",
      "following": 19,
      "count_reactions_type": [
        { "reaction_count": 34, "type": "Like" },
        { "reaction_count": 4, "type": "Haha" }
      ],
      "is_page": true,
      "play_count": 45717
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook group posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-posts-by-group-collect-by-url

api-reference/sdk-specs/facebook-posts-by-group-collect-by-url POST /datasets/v3/scrape
Collect posts from a Facebook group by group URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lz11l67o2cb3r0lkj3.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lz11l67o2cb3r0lkj3` to collect **Facebook posts by group** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook group to collect posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/groups/123456789"},
      {"url": "https://www.facebook.com/groups/987654321"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/groups/532855527252024/posts/2189486054922288/",
      "post_id": "2189486054922288",
      "user_url": "https://www.facebook.com/people/User/61557299394534/",
      "user_username_raw": "EnhleNandie Mhlutshwa",
      "content": null,
      "date_posted": "2026-03-26T19:05:20.000Z",
      "num_comments": 0,
      "num_shares": 0,
      "group_name": "Job Seekers Community",
      "group_id": "532855527252024",
      "group_url": "https://www.facebook.com/groups/532855527252024/",
      "group_category": "Public group",
      "group_logo": "https://...",
      "group_members": 226500,
      "group_created_at": "2019-07-17T07:27:18.000Z",
      "user_is_verified": false,
      "attachments": [],
      "post_type": "Post",
      "likes": null,
      "profile_id": "61557299394534"
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-posts-collect-by-url

api-reference/sdk-specs/facebook-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect Facebook posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm1571iy3mv57zw` to collect **Facebook posts** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/NASA/posts/1234567890"},
      {"url": "https://www.facebook.com/Meta/posts/9876543210"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/share/v/17yf2ZfpHp/",
      "post_id": "1528075055988555",
      "user_url": "https://www.facebook.com/thetoyinsider",
      "user_username_raw": "The Toy Insider",
      "content": "Hatchin' Yoshi is our whole personality until further notice. Hitting stores next month!",
      "date_posted": "2026-02-14T21:28:45.000Z",
      "num_comments": 966,
      "num_shares": 3500,
      "num_likes_type": [{ "num": 23800, "type": "Like" }],
      "profile_id": "100063582250570",
      "page_logo": "https://...",
      "page_likes": null,
      "page_followers": 36000,
      "page_is_verified": false,
      "attachments": [
        {
          "attachment_url": "https://...",
          "id": "1473877017491895",
          "type": "video",
          "url": "https://www.facebook.com/reel/1473877017491895",
          "video_length": "125767",
          "video_url": "https://..."
        }
      ],
      "page_url": "https://www.facebook.com/thetoyinsider",
      "profile_handle": "thetoyinsider",
      "is_sponsored": false,
      "video_view_count": 2300000,
      "likes": 23800,
      "post_type": "Post",
      "play_count": null
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Facebook profiles by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mf0urb782734ik94dz` to collect **Facebook profiles** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/zuck"},
      {"url": "https://www.facebook.com/sheryl"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/GoramHomes/mentions/",
      "name": "Goram Homes",
      "id": "100090557460648",
      "profile_photo": "https://...",
      "cover_photo": "https://...",
      "work": null,
      "college": null,
      "high_school": null,
      "photos": null
    }
  ]
  ```
</ResponseExample>


# Scrape Facebook reels by profile URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/facebook-reels-collect-by-url

api-reference/sdk-specs/facebook-reels-collect-by-url POST /datasets/v3/scrape
Collect Facebook reels from a profile by profile URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lyclm3ey2q6rww027t.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm3ey2q6rww027t` to collect **Facebook reels** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Facebook profile to collect reels from.
    </ParamField>

    <ParamField type="number">
      The number of recent reels to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include.
    </ParamField>

    <ParamField type="string">
      Start date filter `MM-DD-YYYY` (should be earlier than "end\_date").
    </ParamField>

    <ParamField type="string">
      End date filter `MM-DD-YYYY` (should be later than "start\_date").
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.facebook.com/MrBeast6000", "num_of_posts": 10},
      {"url": "https://www.facebook.com/NASA", "start_date": "01-01-2025", "end_date": "03-01-2025"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.facebook.com/reel/2128461008004479",
      "post_id": "1417440860423673",
      "user_url": "https://www.facebook.com/tmcnewsbr",
      "user_username_raw": "Radio Transamerica FM",
      "content": "Increase in US-Iran tensions...",
      "date_posted": "2026-04-06T00:00:00.000Z",
      "hashtags": ["#guerra", "#eua"],
      "num_comments": 2,
      "num_shares": 0,
      "video_view_count": 582,
      "likes": 3,
      "page_name": "Radio Transamerica FM",
      "profile_id": "100064733164731",
      "page_logo": "https://...",
      "page_likes": 0,
      "page_followers": 1200000,
      "thumbnail": "https://...",
      "page_url": "https://www.facebook.com/tmcnewsbr",
      "profile_handle": "tmcnewsbr",
      "shortcode": "2128461008004479",
      "length": 13.888,
      "audio": "AVAILABLE",
      "video_url": "https://..."
    }
  ]
  ```
</ResponseExample>


# Scrape Instagram comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-comments-collect-by-url

api-reference/sdk-specs/instagram-comments-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect Instagram comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_ltppn085pokosxh13` to collect **Comments by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Input specific post url to get the latest 15 comments
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url":"https://www.instagram.com/cats_of_instagram/reel/C4GLo_eLO2e/"},
      {"url":"https://www.instagram.com/catsofinstagram/p/CesFC7JLyFl/?img_index=1"},
      {"url":"https://www.instagram.com/cats_of_instagram/reel/C2TmNOVMSbG/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/nato",
      "comment_user": "met***han***r",
      "comment_user_url": "https://www.instagram.com/metlushanigor",
      "comment_date": "2026-03-14T01:13:08.000Z",
      "comment": "В реальних бойових діях ці танки за 5 хвилин будуть знищені,а солдати ще менше проживуть. Ви відстає НАТО на пʼять років",
      "likes_number": 0,
      "replies_number": 0,
      "replies": null,
      "hashtag_comment": null,
      "tagged_users_in_comment": null,
      "post_url": "https://www.instagram.com/p/DVyB2KkjS07/",
      "post_user": "******",
      "comment_id": "18168596065410257",
      "post_id": "3851148751604100411_985168596"
    }
  ]
  ```
</ResponseExample>


# Scrape Instagram posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-posts-collect-by-url

api-reference/sdk-specs/instagram-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect Instagram posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk5ns7kz21pck8jpis` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram posts to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url":"https://www.instagram.com/p/Cuf4s0MNqNr"},
      {"url":"https://www.instagram.com/p/DP861NijuwE"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/p/DIWPWGpsUQX",
      "user_posted": "limabijus",
      "description": "Coleção Laços 💝 Argolinhas cravejadas com micro zircônias em cores R$35,00\n\nParcelamos suas compras em até 12x no cartão \n\nFRETE FIXO PARA TODO PARÁ R$13,00 FRETE FIXO PARA TODO O BRASIL R$27,00\n\nCatálogo no link da bio.\n\n*Aceitamos todos os cartões\n*Pix\n\nLoja aberta das 08:00 as 18:30 Trav. Oriental do mercado. Rua ao lado da antiga Big Ben\n\n#açoinoxidável #açocirurgico #colarfolheado #joia",
      "hashtags": [
        "#a",
        "#a",
        "#colarfolheado",
        "#joia"
      ],
      "num_comments": 0,
      "date_posted": "2025-04-12T13:03:14.000Z",
      "likes": 51,
      "photos": [
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489610375_18494864488028192_2686112351885091669_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=0MufbR7woQgQ7kNvwFygZL-&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzNULCN5FUuEctA0H8JoRjWCeySVi7on4V_3tyVANwEgA&oe=69BD2DFE&_nc_sid=d885a2",
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490407159_18494864497028192_459288836599671444_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=8c3OWbQMg_UQ7kNvwGA-4tO&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzoD8Lfn2JLSIGWOpgggWRS0lM_Nq-kBOJbsWniZW1-Pg&oe=69BD36E2&_nc_sid=d885a2",
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489022963_18494864506028192_5811983443590937317_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=dmtlFzwSrRAQ7kNvwF3cFW1&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxkO5-J0PJ3blG-0l-j2FfZ8JbfvEFMNlkjuFfGyTcbDw&oe=69BD411D&_nc_sid=d885a2",
        "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490092032_18494864515028192_1690521244685472282_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=qBpqqD5ZCl0Q7kNvwEDczAS&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxTqMfbDWwQY0NuZGyko_XxDlqKSGGZhgNQiSpZOjQnTA&oe=69BD3BB2&_nc_sid=d885a2"
      ],
      "videos": null,
      "location": [
        "Capanema",
        "Pará",
        "Brasil"
      ],
      "latest_comments": null,
      "post_id": "3609139641052120087",
      "discovery_input": null,
      "has_handshake": null,
      "shortcode": "DIWPWGpsUQX",
      "content_type": "Carousel",
      "pk": "3609139641052120087",
      "content_id": "DIWPWGpsUQX",
      "engagement_score_view": null,
      "thumbnail": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489610375_18494864488028192_2686112351885091669_n.jpg?stp=c0.147.1284.1284a_dst-jpg_e35_s640x640_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=0MufbR7woQgQ7kNvwFygZL-&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxVSxvfL2zQbtGYyRFK9C75gO2TcK0jY6bsl6Xo1WM0dA&oe=69BD2DFE&_nc_sid=d885a2",
      "video_view_count": null,
      "product_type": null,
      "coauthor_producers": null,
      "tagged_users": null,
      "video_play_count": null,
      "followers": 20674,
      "posts_count": 9676,
      "profile_image_link": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-19/637167000_18562755475028192_7282452674783054648_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=w2D-l-4t3yAQ7kNvwG5fhmo&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfwK9IApnYM8GUqE3WY6EC9TiyKRaRbL6JS9314NMLywrQ&oe=69BD3DFE&_nc_sid=d885a2",
      "is_verified": true,
      "is_paid_partnership": false,
      "partnership_details": {
        "profile_id": null,
        "profile_url": null,
        "username": null
      },
      "user_posted_id": "312860191",
      "post_content": [
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634257469948",
          "index": 0,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489610375_18494864488028192_2686112351885091669_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=0MufbR7woQgQ7kNvwFygZL-&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzNULCN5FUuEctA0H8JoRjWCeySVi7on4V_3tyVANwEgA&oe=69BD2DFE&_nc_sid=d885a2"
        },
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634265835747",
          "index": 1,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490407159_18494864497028192_459288836599671444_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=8c3OWbQMg_UQ7kNvwGA-4tO&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzoD8Lfn2JLSIGWOpgggWRS0lM_Nq-kBOJbsWniZW1-Pg&oe=69BD36E2&_nc_sid=d885a2"
        },
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634257389672",
          "index": 2,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/489022963_18494864506028192_5811983443590937317_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=dmtlFzwSrRAQ7kNvwF3cFW1&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxkO5-J0PJ3blG-0l-j2FfZ8JbfvEFMNlkjuFfGyTcbDw&oe=69BD411D&_nc_sid=d885a2"
        },
        {
          "alt_text": "Photo by Lima Bijus on April 12, 2025.",
          "id": "3609139634257475832",
          "index": 3,
          "type": "Photo",
          "url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/490092032_18494864515028192_1690521244685472282_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QGaMKgfOzjq0wPKSDzaCmtVKzedbmcC6K7R8nhooYRtxVg3ff27v7SxrDXsxdo2W7k&_nc_ohc=qBpqqD5ZCl0Q7kNvwEDczAS&_nc_gid=nqIS79fttxt1Dm7FA1KvtA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxTqMfbDWwQY0NuZGyko_XxDlqKSGGZhgNQiSpZOjQnTA&oe=69BD3BB2&_nc_sid=d885a2"
        }
      ],
      "audio": {
        "audio_asset_id": null,
        "ig_artist_id": null,
        "ig_artist_username": null,
        "original_audio_title": null
      },
      "profile_url": "https://www.instagram.com/limabijus",
      "videos_duration": null,
      "images": [
        {
          "id": "360***963***746******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        },
        {
          "id": "360***963***583******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        },
        {
          "id": "360***963***738******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        },
        {
          "id": "360***963***747******",
          "url": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************"
        }
      ],
      "alt_text": "Photo by Lima Bijus on April 12, 2025.",
      "photos_number": 4,
      "audio_url": null
    }
  ]
  ```
</ResponseExample>


# Discover Instagram posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-posts-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Instagram posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk5ns7kz21pck8jpis` to collect **Discover by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect, missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include
    </ParamField>

    <ParamField type="integer">
      Start date filter `MM-DD-YYYY` (should be earlier than "end\_date")
    </ParamField>

    <ParamField type="integer">
      End date filter `MM-DD-YYYY` (should be later than "start\_date")
    </ParamField>

    <ParamField type="string">
      Posts to collect by type.

      One of: `post`, `reel`
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.instagram.com/marcusfaberfdp",
        "num_of_posts": 10,
        "start_date": "01-01-2025",
        "end_date": "03-01-2025",
        "post_type": "Post"
      },
      {
        "url": "https://www.instagram.com/meta/",
        "num_of_posts": "",
        "posts_to_not_include": [
          "3529568342229145484"
        ],
        "start_date": "03-01-2025",
        "end_date": "03-17-2025",
        "post_type": "Reel"
      },
      {
        "url": "https://instagram.com/tips_-_-_",
        "start_date": "",
        "end_date": "",
        "post_type": ""
      },
      {
        "url": "https://www.instagram.com/_blakegreiner_/",
        "start_date": "",
        "end_date": "",
        "post_type": ""
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.instagram.com/marcusfaberfdp","num_of_posts":10,"start_date":"01-01-2025","end_date":"03-01-2025","post_type":"Post"},{"url":"https://www.instagram.com/meta/","num_of_posts":"","posts_to_not_include":["3529568342229145484"],"start_date":"03-01-2025","end_date":"03-17-2025","post_type":"Reel"},{"url":"https://instagram.com/tips_-_-_","start_date":"","end_date":"","post_type":""},{"url":"https://www.instagram.com/_blakegreiner_/","start_date":"","end_date":"","post_type":""}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk5ns7kz21pck8jpis&notify=false&include_errors=true&type=discover_new&discover_by=url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk5ns7kz21pck8jpis",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.instagram.com/marcusfaberfdp",
                  "num_of_posts": 10,
                  "start_date": "01-01-2025",
                  "end_date": "03-01-2025",
                  "post_type": "Post",
              },
              {
                  "url": "https://www.instagram.com/meta/",
                  "num_of_posts": "",
                  "posts_to_not_include": ["3529568342229145484"],
                  "start_date": "03-01-2025",
                  "end_date": "03-17-2025",
                  "post_type": "Reel",
              },
              {
                  "url": "https://instagram.com/tips_-_-_",
                  "start_date": "",
                  "end_date": "",
                  "post_type": "",
              },
              {
                  "url": "https://www.instagram.com/_blakegreiner_/",
                  "start_date": "",
                  "end_date": "",
                  "post_type": "",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk5ns7kz21pck8jpis",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.instagram.com/marcusfaberfdp",
          num_of_posts: 10,
          start_date: "01-01-2025",
          end_date: "03-01-2025",
          post_type: "Post",
        },
        {
          url: "https://www.instagram.com/meta/",
          num_of_posts: "",
          posts_to_not_include: ["3529568342229145484"],
          start_date: "03-01-2025",
          end_date: "03-17-2025",
          post_type: "Reel",
        },
        {
          url: "https://instagram.com/tips_-_-_",
          start_date: "",
          end_date: "",
          post_type: "",
        },
        {
          url: "https://www.instagram.com/_blakegreiner_/",
          start_date: "",
          end_date: "",
          post_type: "",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account": "jen***ell***72",
      "fbid": "17841405188025881",
      "id": "5087052934",
      "followers": 7938,
      "posts_count": 835,
      "is_business_account": false,
      "is_professional_account": false,
      "is_verified": false,
      "avg_engagement": 0.0582,
      "external_url": null,
      "biography": "Pod: @raydarcydaily \nemail: jenny@darcydaily.com",
      "business_category_name": null,
      "category_name": null,
      "post_hashtags": null,
      "following": 2520,
      "posts": [
        {
          "caption": "BEING HUMAN - A six part series where Ray chats to 6 well known Irish people about what it means to be human. \n\nFirst episode Wednesday 18th March, and every Wednesday after.\n\nA What Next Production\nPresented by Ray D’Arcy\nProduced by Jenny Kelly\n\n#beinghuman \n#podcast \n#irishpodcast",
          "comments": 2,
          "content_type": "Video",
          "datetime": "2026-03-12T11:52:08.000Z",
          "id": "3851176228498036124",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/651142041_18334056292172935_8112879477358850984_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=W4Jy7OhEd8MQ7kNvwFBSQNv&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afwe_S8Bh8FtoL_RtvxoQ6RF2c20beQzWeLfJfizNBlciQ&oe=69BCEC94&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 36,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "beinghuman",
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVyIGAbDdWc",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQMSgH9bCDeY_VmVFTYEzrv9RMglEw0prtVd_QFRgC21aFXJ10hPg07pPxQ6VZdxe1vFeVnYABQlz2zcpXVrQqfV.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=F9Tybdk82ZQQ7kNvwGJ2sbT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzQwNTU2MDgxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjozLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTE3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=672fccf82fe0dcbe&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HUGlMdHlhY29GUzFoRFFEQU9udTlRZ1ByVDFKYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0E5NEZGMjZCMjU0OTFERkZBNzYzQjU2NDhBOUM5QThGX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOhor9vq6RQRUCKAJDMywXQF1AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfyDY32lp2KMgYLDKEK7Wx7ocPFPwwhGkiuWvBKwB_joLg&oe=69BCCEE9"
        },
        {
          "caption": "Our brand new daily podcast is starting tomorrow \n\nRay D’Arcy Daily \n\nWherever you get your podcasts.\n\nEmail us ray@darcydaily.com\n#podcast #irishpodcast",
          "comments": 86,
          "content_type": "Video",
          "datetime": "2026-03-08T16:21:04.000Z",
          "id": "3848412628930911784",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/649327000_1860456074651243_3014167701283875235_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=b0EoQkmauKkQ7kNvwGZzfjq&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxQfU7Ocg9M26vOgYlA3m4oy4cpmvDY9859u4P35lUqng&oe=69BCEFC3&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 992,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVoTuVwjd4o",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t16/f2/m69/AQNqwbuRAKLUvBo_BRm3bnGbIV2EPYfXffZLw2f3swiqVgfVNN31xLUjJYzBUmk31ks69X_8_c7EKmCelHv_buYH.mp4?strext=1&_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=iuf2XH_4eaAQ7kNvwGQqv3J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzM2MzkxNzIxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjo3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NjAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ce88cc19b1c12270&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSVhrcWlhdEZTUTBGLTBFQUNGU2oydVRFWlZ4YnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzIwNEVCQTgxMTJEMkM2ODRBNzFEREU0RTQwNTBFQThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOsuGkoJaRQRUCKAJDMywXQE464UeuFHsYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfzE-98jZ3zhfaRZuLxlWwz5GmrjBpxgERbFaOjPj7UIrw&oe=69BCCCA4"
        },
        {
          "caption": "We have some news! \n\nRAY D’ARCY DAILY - your daily podcast. \n\nThis five day a week show is nothing new, and yet ALL NEW. It’s Monday to Friday with Ray giving his own world view while surrounded by friends of the show, Jenny Kelly (that’s me 🤪), Mairead Ronan and Bernard O’Shea to name a few. \n\nWe hope you’ll join us. \nStarting Monday 9th. \n\nFollow the show now to make sure you never miss an episode. \n\nListen wherever you get your Podcasts #irishpodcast #podcast \n@cocomairead @bernardo.oshea @acast",
          "comments": 166,
          "content_type": "Video",
          "datetime": "2026-03-02T13:25:41.000Z",
          "id": "3843977898726623596",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/641425914_1446430403853586_8943556578413069821_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=j-4QNAsV4yEQ7kNvwEWKOeO&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy2MQCg7ccEpt8gZNJowsCxi2k7fkX141C5dFU-dvfEfg&oe=69BCC84E&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1158,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast"
          ],
          "url": "https://www.instagram.com/p/DVYjYhaDYls",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQM_D-LpDwCPxPZrnXzoyfkknE8jP_GwRpGwtEvjefP4KUFo7dAEFZ51YD7Nn6-NLnnVLm3sIF5e7jbT_ImFtRri.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=-FdPzVISP18Q7kNvwEcVVkv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzMwNTA3OTExNzI5MzUsImFzc2V0X2FnZV9kYXlzIjoxMywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=54251b7443d07334&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSnlFZHlhaTdRb2U1SmtFQURXYkJFSjd5XzEwYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzEyNEU2RjhEQkU4M0NCQ0Y3NEU5Njk2Q0I0NTJDRkIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaO7fTAgPSQQRUCKAJDMywXQGGqp--dsi0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfxknzHbQifAj5YoGVzxwXn2cPKeVRcRrdXbooIhlD8ZBQ&oe=69BCDC41"
        },
        {
          "caption": "PODCAST NEWS 📢\n\nAfter 3 years we have made the decision to hang up our ‘Jenny and Mairéad NOW' mics. \n\nWe have LOVED doing it. 💕\n\nWe re-connected with so many listeners from our radio days and got lots of new listeners along the way. We want to thank you for all the laughs and life stories you’ve shared with us. \n\nWe both have new commitments that we are diving into, so for today, we'll say ‘so long for now’ 💫 \n\nLots of love, \nJenny and Mairéad \nXx \n\nPS..leave your lips alone, buy a spray mop and remember… \"you’ll be dead forever”",
          "comments": 158,
          "content_type": "Image",
          "datetime": "2025-09-24T17:50:53.000Z",
          "id": "3728872417469969396",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/553161422_17973649637947844_5055340064665934469_n.webp?stp=dst-jpg_e35_s1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=0IDMJZLADZgQ7kNvwGBZl2R&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxVGERnGo1gjS9N7F4Hvi14Ek0zIbXq_m_2vnk8p1c0mQ&oe=69BCDBC8&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1572,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DO_nbUQDLP0",
          "video_url": null
        },
        {
          "caption": "I COULD have been a camogie player (never played in my life 🤣), and @cocomairead COULD have been a pop star … what COULD you have been? \n\nPodcast out tomorrow 6am #irishpodcast #podcast #jennyandmaireadnow",
          "comments": null,
          "content_type": "Video",
          "datetime": "2025-04-29T21:44:06.000Z",
          "id": "3621719997521697568",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.71878-15/491461907_976222424658362_5118993394906495251_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=fdEBmapVjIYQ7kNvwH9d2ns&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afz4h2HLZTuYioO61W7aDIMzXCHL34Tv_SD_q5TYfJ99iA&oe=69BCBEDC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 62,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "jennyandmaireadnow"
          ],
          "url": "https://www.instagram.com/p/DJC7yYoNZsg",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNdTe3n8U7HJAUZPYQ2IKytrTScEjIa2LVv7p-gcs7bfH2WDHkU1GuQ63tg4BxPEIFCVKgn-k9soAiz09MH_R_ORdQFWDf5N2MPRLY.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=Syer777RuQMQ7kNvwEmKdhm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTU5NDc3ODcyNzg2ODYyNywiYXNzZXRfYWdlX2RheXMiOjMxOSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=1d3eb966c62b0ed0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8zMTRBRkNEOTM4NTM5NjI2MzhBMUQwQ0QxNDk2QzE4QV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMjE3ODU0OTYzMjg1ODY0Xzk0ODMzNjE1ODI3NjU5Njg3OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmpqOPuauc1QUVAigCQzMsF0BRUQYk3S8bGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxYnVqq-YPFAKEW8CVj-CJBIvyL0qQSOxuzTNCksnr_Sg&oe=69BCE24D"
        },
        {
          "caption": "Podcast @jennyandmaireadnow out tomorrow 6am \n\n✨Mairead needs help\n✨Netflix Doc: Buy Now!\n✨2025 Manifesto\n✨Colour and word of the year \n✨Debutant Balls and Feis\n\nThanks to our sponsor @vhi_ie \n#irishpodcast #podcast #friendship",
          "comments": null,
          "content_type": "Video",
          "datetime": "2024-12-10T21:36:11.000Z",
          "id": "3520245279648780747",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/469729187_18286176577172935_8198072792922023263_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=skhiJmD75-kQ7kNvwEeKZA6&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzWsdPI0aqqm2_IHDtzlIqHu2mL76RyRwvUBMetthP-hg&oe=69BCCDF6&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 64,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "friendship"
          ],
          "url": "https://www.instagram.com/p/DDabG5HthHL",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQMy1Odi0RhpjgXggsSeeNNxmcDcNt0_X6IYxlCD21k4z4h46ndGKxoNjJIRjVg94CuujC1j-CiG89HT8-O9C-XPAl_3C_7p3GqzZ5M.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=zEKeRBdP2mAQ7kNvwENzKpk&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTIzMzY5MjkwNzcxNjE1MSwiYXNzZXRfYWdlX2RheXMiOjQ1OSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjUxLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=be7ed278cb04ea95&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BQjQyNThCNTU0QTJGNEIxODg3NjlBQUJFMDNDMzU4Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNTAyMTIxNTUwNzQwNjE0Xzc5ODkxODI2NzE3NDU1MDEwNy5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAm7vi1uLCCsQQVAigCQzMsF0BJmZmZmZmaGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_Afzvy10txzkdt9h08tJs_9VMlJicQjSggsPEZ61LEdGYmA&oe=69BCC63E"
        },
        {
          "caption": "This book took me a few weeks to read and it’s only 136 pages long. I could quite easily go back now and start it all over again. One of the most beautiful books I’ve read. It tells the story of 24 hours in the lives of 6 astronauts on the international space station. Each of the 16 chapters takes in one orbit of earth. It’s difficult to describe just how profound and touching this small book is. A love letter to Earth. It made me feel both sad and hopeful at the same time. I read that the author Samantha Harvey stopped writing half way through because she felt she didn’t have the right to write a book like this, so removed was it from her real life. I’m so glad she ignored that voice in her head because this book is something we will read for years and years to come. Stunning.",
          "comments": 6,
          "content_type": "Image",
          "datetime": "2024-12-04T19:34:23.000Z",
          "id": "3515840447256809542",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/623407206_17991231980916798_8528601805505725054_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1jkbYPze7PIQ7kNvwFhqTAc&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afzg1e_fEK30evjHAzSP597UW_USGzLTBIj1k-EIjQQMfA&oe=69BCCA41&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 109,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDKxkJRsVBG",
          "video_url": null
        },
        {
          "caption": "Pod out Wednesday 6am\n\n✨Kissing 💋\n✨Christmas Movies 🎬\n✨family traditions 🏡\n✨Nits 🦗\n\nThanks to our sponsor @vhi_ie",
          "comments": 1,
          "content_type": "Video",
          "datetime": "2024-12-03T21:00:59.000Z",
          "id": "3515158122554635287",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/503975082_1908008223345944_5512368651421990898_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=LBreF5ALN2IQ7kNvwE_RtAb&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzmTzT-OfgwVOhOYS62CUgEdWcUX2YsW20KyaTEXiv3Gg&oe=69BCD350&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 27,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDIWbA4MrQX",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNO52R4NspLq6_HyhxNcCLUQtKiP7dXhYXNEIO3IjvmzKdyZMS_YYgB2zRkbZs4SLFVBOdJpB3L19p9-zxxOyqHp9Lk-fOum-vlUa4.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=eyaMjy3BLs8Q7kNvwFAQ_2h&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc3MTU2NjI2MDMyMzQ3NSwiYXNzZXRfYWdlX2RheXMiOjQ2NiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQ5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=4e62294db6b90ea0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC82NTRENUM0OTczREYzNDQ0MzFDQTExRDQxRTY0RUI5Rl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMTYwODk0Nzg1Mzk1ODg1XzgyNDkxMDM2OTY3NjU4NTg4MS5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmppKkmt3OpQYVAigCQzMsF0BI7tkWhysCGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxxoxyLQuVwyz2uioRVM08hneqBb3CfGndyLkviQkDqVw&oe=69BCE6C8"
        },
        {
          "caption": "Podcast out NOW ✨\n\nWe really enjoyed our chat with @michealmartintd \n\n✨telepathy between him and his wife\n✨the ingredients to his perfect salad\n✨book club inspiration \n✨what he REALLY wanted to be when he grew up \n\n#jennyandmaireadnow #whatweknownow #irishpodcasts #friendship #collabrativestudio",
          "comments": 29,
          "content_type": "Video",
          "datetime": "2024-11-13T11:36:18.000Z",
          "id": "3500373609463083880",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/466773911_17936241830947844_3117143642697548716_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1pwaOyShnGoQ7kNvwGsRorU&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxMIFfgprmdzKi-AErgzTmN3E-gzqKmuT2QhUQC1TC7NQ&oe=69BCD28B&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 197,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "whatweknownow",
            "irishpodcasts",
            "friendship",
            "collabrativestudio"
          ],
          "url": "https://www.instagram.com/p/DCT00CFMvNo",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQNLvylMFRY6P74zmh9wwvuEJ7rtO-sItj8FJLT2nSb_PeMIpJmOm8SkfRH64lOCNztgBnZpZ-XoKhrc8CItJtQKS1Mut4lfPZFXbj8.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=qIweWDr6GKEQ7kNvwHO-YZz&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MzkwMzA5NDY3MzI4MjA3MiwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=15624de47fd39130&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8yOTQ3MDYwMDcyNEI5QTQ4Njk2RDIzNUNCQjZGNzI5MV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzIyMTQ3MTEyNDk4NDU0Xzg1NDM2NTk1NDU5NDg0NjEyNjYubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrDQtLiB9u4NFQIoAkMzLBdARfMzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_Afx5DWMCHEDJoObUP3-Lb7Hu9-RkPZteuaVDucxzxkaVtg&oe=69BCD8B3"
        },
        {
          "caption": "🎙️Bit of a different podcast for you this week! \n\nWe sat down with Tánaiste @michealmartintd and asked him ‘What He Knows Now.\n\n✨Life lessons that have got him this far. \n✨Friendships, family & grief\n✨Sea swimming, dry robes & switching off\n\n Full episode drops tomorrow at 6am wherever you get your podcasts. \n\nJ & M\n\nThank you to our sponsor @vhi_ie \n\n#jennyandmaireadnow #lifelessons #dryrobe  #seaswimming",
          "comments": 25,
          "content_type": "Video",
          "datetime": "2024-11-12T22:26:31.000Z",
          "id": "3499981808361075522",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/466690817_552614564296939_1070270335390837149_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=4Pn0CaGAEAwQ7kNvwGgi0OG&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy31s1gWLZgx-uRpeh_veSBHwycbYIjHaSe6e6ghEjJug&oe=69BCCA2F&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 367,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "lifelessons",
            "dryrobe",
            "seaswimming"
          ],
          "url": "https://www.instagram.com/p/DCSbuk3sPNC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQOQyKg3hXP5Vbemc9YXLsURych3495OTaZ-k5hA5Ud_bPJkecOs-XoiZXj14XHIu3zOfYzZrFmrf4xdztvyIdI8ID29tB2UCIKdGKQ.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=xQB7AZzudfwQ7kNvwFSfvDS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEwMzM1MzI5Nzg3MDA1NCwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjM2LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52ef0882b0559893&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BMzQxREExQUVBNTJCQUUzNDNCMUEyNzNCQ0FFMzNCQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80NTE4MzkyMTEzNTQwNTNfMjIyNDI2NDEzOTg0ODkxMDcwOC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmzPOM1s7f9QMVAigCQzMsF0BB92yLQ5WBGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&oh=00_Afxh28JyyPy9AVGT2wQv9pVAJuU58mjJPkCKFeb6f4Oh8w&oe=69BCE4E7"
        },
        {
          "caption": "Did a photoshoot with Stan because he’s just back from the hairdressers and looking so floofy and smelling beautiful 😍 I needed to document his clean smelling look as he will be rolling in some dirt/fox smell/ muck very soon 🤪 #dogsofinstagram #goldenretriever",
          "comments": 12,
          "content_type": "Carousel",
          "datetime": "2024-11-12T15:25:04.000Z",
          "id": "3499769896973330029",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.29350-15/466995326_990526599761200_5153153982064132557_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=UxLUkZuUog8Q7kNvwEC_RWC&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyUh-GMDlDzUu9nBtb6d8zt0aKqVnKXwgO24rSu4kLSnw&oe=69BCECBC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 432,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "dogsofinstagram",
            "goldenretriever"
          ],
          "url": "https://www.instagram.com/p/DCRri3As2Zt",
          "video_url": null
        },
        {
          "caption": "Behind the scenes brain melt during podcast recording @jennyandmaireadnow 😆 #irishpodcast #brainmelt",
          "comments": 5,
          "content_type": "Video",
          "datetime": "2024-11-06T13:01:12.000Z",
          "id": "3495348313982605954",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/504211000_1111075530847029_6819244619431359412_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=heyO9GE4JlsQ7kNvwFGOhvN&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyNVgaEmlBsmZcJ8ZLetflfbX0IbHpSFLa21YNcV-oLoA&oe=69BCE5A5&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 47,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "brainmelt"
          ],
          "url": "https://www.instagram.com/p/DCB-MW9MZqC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQNC9pTSh_sqrA-fhRMmhTUPsv-xrcuqgUEQScc1hUi7SBjj25GcbBoVf_NhjuetkQJhS0LduAJJfqz_Me4Kk3z5CX3qqgUtF3K282A.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=fKCWP4nLTc4Q7kNvwGRtcmn&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6OTY1MDc1OTg4NzgwMzE4LCJhc3NldF9hZ2VfZGF5cyI6NDk0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ed3daf27ab696a71&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8xMzQzOTZBRTEyMDg4RDg2MTYzQjIxQkEyMTM0MUVBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMDk1MDkzODgyMTI2MTkyXzg4Njc1NDA2NTc4NDE0MDA5NzMubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrzU8Lfo7rYDFQIoAkMzLBdAN7MzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_AfzX-ow_DcwGwG-N-wJRo2wUhFiBQWG9HH74zasp7_xKdg&oe=69BCE9BA"
        }
      ],
      "profile_image_link": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************",
      "profile_url": "htt***//i***agr*********nny************",
      "profile_name": "Jenny K***y",
      "highlights_count": 1,
      "highlights": [
        {
          "highlight_url": "https://www.instagram.com/stories/highlights/18026550763647585",
          "id": "18026550763647585",
          "image": "https://scontent-atl3-3.cdninstagram.com/v/t51.82787-15/573732645_18127616266495367_3673315206062571981_n.jpg?stp=c0.455.1170.1170a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QEE4OreRXzcQ2CqfikRW1dKnGrkuowmELfFxSlLCv0wKApkCk_6Wcbln6C2erPd-Xo&_nc_ohc=pr5PJJAmFYkQ7kNvwGad141&_nc_gid=uQYUd6X3lmUi--ZasXrx5A&edm=AGXveE0BAAAA&ccb=7-5&oh=00_AfxIP7Y-MDVbXrKf1PFIq3qOQemwInWjCDquh1v-Zuc0qQ&oe=69BCC45C&_nc_sid=522435",
          "owner": "jennykelly1972",
          "title": "📚"
        }
      ],
      "full_name": "Jenny K***y",
      "is_private": false,
      "bio_hashtags": null,
      "url": "https://www.instagram.com/jennykelly1972/",
      "is_joined_recently": false,
      "has_channel": false,
      "partner_id": "5087052934",
      "business_address": null,
      "related_accounts": [],
      "email_address": "jen***dar***ail******",
      "external_url_title": {
        "title": null,
        "url": null
      },
      "pronouns": null
    }
  ]
  ```
</ResponseExample>


# Scrape Instagram profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url

api-reference/sdk-specs/instagram-profiles-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect Instagram profiles by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1vikfch901nx3by4` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.instagram.com/cats_of_world_"},
      {"url": "https://www.instagram.com/dogsofinstagram"},
      {"url": "https://www.instagram.com/zoobarcelona"},
      {"url": "https://www.instagram.com/australiazoo"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account": "jen***ell***72",
      "fbid": "17841405188025881",
      "id": "5087052934",
      "followers": 7938,
      "posts_count": 835,
      "is_business_account": false,
      "is_professional_account": false,
      "is_verified": false,
      "avg_engagement": 0.0582,
      "external_url": null,
      "biography": "Pod: @raydarcydaily \nemail: jenny@darcydaily.com",
      "business_category_name": null,
      "category_name": null,
      "post_hashtags": null,
      "following": 2520,
      "posts": [
        {
          "caption": "BEING HUMAN - A six part series where Ray chats to 6 well known Irish people about what it means to be human. \n\nFirst episode Wednesday 18th March, and every Wednesday after.\n\nA What Next Production\nPresented by Ray D’Arcy\nProduced by Jenny Kelly\n\n#beinghuman \n#podcast \n#irishpodcast",
          "comments": 2,
          "content_type": "Video",
          "datetime": "2026-03-12T11:52:08.000Z",
          "id": "3851176228498036124",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/651142041_18334056292172935_8112879477358850984_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=W4Jy7OhEd8MQ7kNvwFBSQNv&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afwe_S8Bh8FtoL_RtvxoQ6RF2c20beQzWeLfJfizNBlciQ&oe=69BCEC94&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 36,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "beinghuman",
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVyIGAbDdWc",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQMSgH9bCDeY_VmVFTYEzrv9RMglEw0prtVd_QFRgC21aFXJ10hPg07pPxQ6VZdxe1vFeVnYABQlz2zcpXVrQqfV.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=F9Tybdk82ZQQ7kNvwGJ2sbT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzQwNTU2MDgxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjozLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTE3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=672fccf82fe0dcbe&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HUGlMdHlhY29GUzFoRFFEQU9udTlRZ1ByVDFKYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0E5NEZGMjZCMjU0OTFERkZBNzYzQjU2NDhBOUM5QThGX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOhor9vq6RQRUCKAJDMywXQF1AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfyDY32lp2KMgYLDKEK7Wx7ocPFPwwhGkiuWvBKwB_joLg&oe=69BCCEE9"
        },
        {
          "caption": "Our brand new daily podcast is starting tomorrow \n\nRay D’Arcy Daily \n\nWherever you get your podcasts.\n\nEmail us ray@darcydaily.com\n#podcast #irishpodcast",
          "comments": 86,
          "content_type": "Video",
          "datetime": "2026-03-08T16:21:04.000Z",
          "id": "3848412628930911784",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/649327000_1860456074651243_3014167701283875235_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=b0EoQkmauKkQ7kNvwGZzfjq&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxQfU7Ocg9M26vOgYlA3m4oy4cpmvDY9859u4P35lUqng&oe=69BCEFC3&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 992,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVoTuVwjd4o",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t16/f2/m69/AQNqwbuRAKLUvBo_BRm3bnGbIV2EPYfXffZLw2f3swiqVgfVNN31xLUjJYzBUmk31ks69X_8_c7EKmCelHv_buYH.mp4?strext=1&_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=iuf2XH_4eaAQ7kNvwGQqv3J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzM2MzkxNzIxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjo3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NjAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ce88cc19b1c12270&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSVhrcWlhdEZTUTBGLTBFQUNGU2oydVRFWlZ4YnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzIwNEVCQTgxMTJEMkM2ODRBNzFEREU0RTQwNTBFQThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOsuGkoJaRQRUCKAJDMywXQE464UeuFHsYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfzE-98jZ3zhfaRZuLxlWwz5GmrjBpxgERbFaOjPj7UIrw&oe=69BCCCA4"
        },
        {
          "caption": "We have some news! \n\nRAY D’ARCY DAILY - your daily podcast. \n\nThis five day a week show is nothing new, and yet ALL NEW. It’s Monday to Friday with Ray giving his own world view while surrounded by friends of the show, Jenny Kelly (that’s me 🤪), Mairead Ronan and Bernard O’Shea to name a few. \n\nWe hope you’ll join us. \nStarting Monday 9th. \n\nFollow the show now to make sure you never miss an episode. \n\nListen wherever you get your Podcasts #irishpodcast #podcast \n@cocomairead @bernardo.oshea @acast",
          "comments": 166,
          "content_type": "Video",
          "datetime": "2026-03-02T13:25:41.000Z",
          "id": "3843977898726623596",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/641425914_1446430403853586_8943556578413069821_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=j-4QNAsV4yEQ7kNvwEWKOeO&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy2MQCg7ccEpt8gZNJowsCxi2k7fkX141C5dFU-dvfEfg&oe=69BCC84E&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1158,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast"
          ],
          "url": "https://www.instagram.com/p/DVYjYhaDYls",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQM_D-LpDwCPxPZrnXzoyfkknE8jP_GwRpGwtEvjefP4KUFo7dAEFZ51YD7Nn6-NLnnVLm3sIF5e7jbT_ImFtRri.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=-FdPzVISP18Q7kNvwEcVVkv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzMwNTA3OTExNzI5MzUsImFzc2V0X2FnZV9kYXlzIjoxMywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=54251b7443d07334&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSnlFZHlhaTdRb2U1SmtFQURXYkJFSjd5XzEwYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzEyNEU2RjhEQkU4M0NCQ0Y3NEU5Njk2Q0I0NTJDRkIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaO7fTAgPSQQRUCKAJDMywXQGGqp--dsi0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfxknzHbQifAj5YoGVzxwXn2cPKeVRcRrdXbooIhlD8ZBQ&oe=69BCDC41"
        },
        {
          "caption": "PODCAST NEWS 📢\n\nAfter 3 years we have made the decision to hang up our ‘Jenny and Mairéad NOW' mics. \n\nWe have LOVED doing it. 💕\n\nWe re-connected with so many listeners from our radio days and got lots of new listeners along the way. We want to thank you for all the laughs and life stories you’ve shared with us. \n\nWe both have new commitments that we are diving into, so for today, we'll say ‘so long for now’ 💫 \n\nLots of love, \nJenny and Mairéad \nXx \n\nPS..leave your lips alone, buy a spray mop and remember… \"you’ll be dead forever”",
          "comments": 158,
          "content_type": "Image",
          "datetime": "2025-09-24T17:50:53.000Z",
          "id": "3728872417469969396",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/553161422_17973649637947844_5055340064665934469_n.webp?stp=dst-jpg_e35_s1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=0IDMJZLADZgQ7kNvwGBZl2R&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxVGERnGo1gjS9N7F4Hvi14Ek0zIbXq_m_2vnk8p1c0mQ&oe=69BCDBC8&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1572,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DO_nbUQDLP0",
          "video_url": null
        },
        {
          "caption": "I COULD have been a camogie player (never played in my life 🤣), and @cocomairead COULD have been a pop star … what COULD you have been? \n\nPodcast out tomorrow 6am #irishpodcast #podcast #jennyandmaireadnow",
          "comments": null,
          "content_type": "Video",
          "datetime": "2025-04-29T21:44:06.000Z",
          "id": "3621719997521697568",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.71878-15/491461907_976222424658362_5118993394906495251_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=fdEBmapVjIYQ7kNvwH9d2ns&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afz4h2HLZTuYioO61W7aDIMzXCHL34Tv_SD_q5TYfJ99iA&oe=69BCBEDC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 62,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "jennyandmaireadnow"
          ],
          "url": "https://www.instagram.com/p/DJC7yYoNZsg",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNdTe3n8U7HJAUZPYQ2IKytrTScEjIa2LVv7p-gcs7bfH2WDHkU1GuQ63tg4BxPEIFCVKgn-k9soAiz09MH_R_ORdQFWDf5N2MPRLY.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=Syer777RuQMQ7kNvwEmKdhm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTU5NDc3ODcyNzg2ODYyNywiYXNzZXRfYWdlX2RheXMiOjMxOSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=1d3eb966c62b0ed0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8zMTRBRkNEOTM4NTM5NjI2MzhBMUQwQ0QxNDk2QzE4QV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMjE3ODU0OTYzMjg1ODY0Xzk0ODMzNjE1ODI3NjU5Njg3OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmpqOPuauc1QUVAigCQzMsF0BRUQYk3S8bGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxYnVqq-YPFAKEW8CVj-CJBIvyL0qQSOxuzTNCksnr_Sg&oe=69BCE24D"
        },
        {
          "caption": "Podcast @jennyandmaireadnow out tomorrow 6am \n\n✨Mairead needs help\n✨Netflix Doc: Buy Now!\n✨2025 Manifesto\n✨Colour and word of the year \n✨Debutant Balls and Feis\n\nThanks to our sponsor @vhi_ie \n#irishpodcast #podcast #friendship",
          "comments": null,
          "content_type": "Video",
          "datetime": "2024-12-10T21:36:11.000Z",
          "id": "3520245279648780747",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/469729187_18286176577172935_8198072792922023263_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=skhiJmD75-kQ7kNvwEeKZA6&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzWsdPI0aqqm2_IHDtzlIqHu2mL76RyRwvUBMetthP-hg&oe=69BCCDF6&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 64,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "friendship"
          ],
          "url": "https://www.instagram.com/p/DDabG5HthHL",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQMy1Odi0RhpjgXggsSeeNNxmcDcNt0_X6IYxlCD21k4z4h46ndGKxoNjJIRjVg94CuujC1j-CiG89HT8-O9C-XPAl_3C_7p3GqzZ5M.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=zEKeRBdP2mAQ7kNvwENzKpk&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTIzMzY5MjkwNzcxNjE1MSwiYXNzZXRfYWdlX2RheXMiOjQ1OSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjUxLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=be7ed278cb04ea95&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BQjQyNThCNTU0QTJGNEIxODg3NjlBQUJFMDNDMzU4Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNTAyMTIxNTUwNzQwNjE0Xzc5ODkxODI2NzE3NDU1MDEwNy5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAm7vi1uLCCsQQVAigCQzMsF0BJmZmZmZmaGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_Afzvy10txzkdt9h08tJs_9VMlJicQjSggsPEZ61LEdGYmA&oe=69BCC63E"
        },
        {
          "caption": "This book took me a few weeks to read and it’s only 136 pages long. I could quite easily go back now and start it all over again. One of the most beautiful books I’ve read. It tells the story of 24 hours in the lives of 6 astronauts on the international space station. Each of the 16 chapters takes in one orbit of earth. It’s difficult to describe just how profound and touching this small book is. A love letter to Earth. It made me feel both sad and hopeful at the same time. I read that the author Samantha Harvey stopped writing half way through because she felt she didn’t have the right to write a book like this, so removed was it from her real life. I’m so glad she ignored that voice in her head because this book is something we will read for years and years to come. Stunning.",
          "comments": 6,
          "content_type": "Image",
          "datetime": "2024-12-04T19:34:23.000Z",
          "id": "3515840447256809542",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/623407206_17991231980916798_8528601805505725054_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1jkbYPze7PIQ7kNvwFhqTAc&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afzg1e_fEK30evjHAzSP597UW_USGzLTBIj1k-EIjQQMfA&oe=69BCCA41&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 109,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDKxkJRsVBG",
          "video_url": null
        },
        {
          "caption": "Pod out Wednesday 6am\n\n✨Kissing 💋\n✨Christmas Movies 🎬\n✨family traditions 🏡\n✨Nits 🦗\n\nThanks to our sponsor @vhi_ie",
          "comments": 1,
          "content_type": "Video",
          "datetime": "2024-12-03T21:00:59.000Z",
          "id": "3515158122554635287",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/503975082_1908008223345944_5512368651421990898_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=LBreF5ALN2IQ7kNvwE_RtAb&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzmTzT-OfgwVOhOYS62CUgEdWcUX2YsW20KyaTEXiv3Gg&oe=69BCD350&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 27,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDIWbA4MrQX",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNO52R4NspLq6_HyhxNcCLUQtKiP7dXhYXNEIO3IjvmzKdyZMS_YYgB2zRkbZs4SLFVBOdJpB3L19p9-zxxOyqHp9Lk-fOum-vlUa4.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=eyaMjy3BLs8Q7kNvwFAQ_2h&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc3MTU2NjI2MDMyMzQ3NSwiYXNzZXRfYWdlX2RheXMiOjQ2NiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQ5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=4e62294db6b90ea0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC82NTRENUM0OTczREYzNDQ0MzFDQTExRDQxRTY0RUI5Rl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMTYwODk0Nzg1Mzk1ODg1XzgyNDkxMDM2OTY3NjU4NTg4MS5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmppKkmt3OpQYVAigCQzMsF0BI7tkWhysCGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxxoxyLQuVwyz2uioRVM08hneqBb3CfGndyLkviQkDqVw&oe=69BCE6C8"
        },
        {
          "caption": "Podcast out NOW ✨\n\nWe really enjoyed our chat with @michealmartintd \n\n✨telepathy between him and his wife\n✨the ingredients to his perfect salad\n✨book club inspiration \n✨what he REALLY wanted to be when he grew up \n\n#jennyandmaireadnow #whatweknownow #irishpodcasts #friendship #collabrativestudio",
          "comments": 29,
          "content_type": "Video",
          "datetime": "2024-11-13T11:36:18.000Z",
          "id": "3500373609463083880",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/466773911_17936241830947844_3117143642697548716_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1pwaOyShnGoQ7kNvwGsRorU&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxMIFfgprmdzKi-AErgzTmN3E-gzqKmuT2QhUQC1TC7NQ&oe=69BCD28B&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 197,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "whatweknownow",
            "irishpodcasts",
            "friendship",
            "collabrativestudio"
          ],
          "url": "https://www.instagram.com/p/DCT00CFMvNo",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQNLvylMFRY6P74zmh9wwvuEJ7rtO-sItj8FJLT2nSb_PeMIpJmOm8SkfRH64lOCNztgBnZpZ-XoKhrc8CItJtQKS1Mut4lfPZFXbj8.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=qIweWDr6GKEQ7kNvwHO-YZz&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MzkwMzA5NDY3MzI4MjA3MiwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=15624de47fd39130&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8yOTQ3MDYwMDcyNEI5QTQ4Njk2RDIzNUNCQjZGNzI5MV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzIyMTQ3MTEyNDk4NDU0Xzg1NDM2NTk1NDU5NDg0NjEyNjYubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrDQtLiB9u4NFQIoAkMzLBdARfMzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_Afx5DWMCHEDJoObUP3-Lb7Hu9-RkPZteuaVDucxzxkaVtg&oe=69BCD8B3"
        },
        {
          "caption": "🎙️Bit of a different podcast for you this week! \n\nWe sat down with Tánaiste @michealmartintd and asked him ‘What He Knows Now.\n\n✨Life lessons that have got him this far. \n✨Friendships, family & grief\n✨Sea swimming, dry robes & switching off\n\n Full episode drops tomorrow at 6am wherever you get your podcasts. \n\nJ & M\n\nThank you to our sponsor @vhi_ie \n\n#jennyandmaireadnow #lifelessons #dryrobe  #seaswimming",
          "comments": 25,
          "content_type": "Video",
          "datetime": "2024-11-12T22:26:31.000Z",
          "id": "3499981808361075522",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/466690817_552614564296939_1070270335390837149_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=4Pn0CaGAEAwQ7kNvwGgi0OG&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy31s1gWLZgx-uRpeh_veSBHwycbYIjHaSe6e6ghEjJug&oe=69BCCA2F&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 367,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "lifelessons",
            "dryrobe",
            "seaswimming"
          ],
          "url": "https://www.instagram.com/p/DCSbuk3sPNC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQOQyKg3hXP5Vbemc9YXLsURych3495OTaZ-k5hA5Ud_bPJkecOs-XoiZXj14XHIu3zOfYzZrFmrf4xdztvyIdI8ID29tB2UCIKdGKQ.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=xQB7AZzudfwQ7kNvwFSfvDS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEwMzM1MzI5Nzg3MDA1NCwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjM2LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52ef0882b0559893&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BMzQxREExQUVBNTJCQUUzNDNCMUEyNzNCQ0FFMzNCQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80NTE4MzkyMTEzNTQwNTNfMjIyNDI2NDEzOTg0ODkxMDcwOC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmzPOM1s7f9QMVAigCQzMsF0BB92yLQ5WBGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&oh=00_Afxh28JyyPy9AVGT2wQv9pVAJuU58mjJPkCKFeb6f4Oh8w&oe=69BCE4E7"
        },
        {
          "caption": "Did a photoshoot with Stan because he’s just back from the hairdressers and looking so floofy and smelling beautiful 😍 I needed to document his clean smelling look as he will be rolling in some dirt/fox smell/ muck very soon 🤪 #dogsofinstagram #goldenretriever",
          "comments": 12,
          "content_type": "Carousel",
          "datetime": "2024-11-12T15:25:04.000Z",
          "id": "3499769896973330029",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.29350-15/466995326_990526599761200_5153153982064132557_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=UxLUkZuUog8Q7kNvwEC_RWC&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyUh-GMDlDzUu9nBtb6d8zt0aKqVnKXwgO24rSu4kLSnw&oe=69BCECBC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 432,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "dogsofinstagram",
            "goldenretriever"
          ],
          "url": "https://www.instagram.com/p/DCRri3As2Zt",
          "video_url": null
        },
        {
          "caption": "Behind the scenes brain melt during podcast recording @jennyandmaireadnow 😆 #irishpodcast #brainmelt",
          "comments": 5,
          "content_type": "Video",
          "datetime": "2024-11-06T13:01:12.000Z",
          "id": "3495348313982605954",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/504211000_1111075530847029_6819244619431359412_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=heyO9GE4JlsQ7kNvwFGOhvN&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyNVgaEmlBsmZcJ8ZLetflfbX0IbHpSFLa21YNcV-oLoA&oe=69BCE5A5&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 47,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "brainmelt"
          ],
          "url": "https://www.instagram.com/p/DCB-MW9MZqC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQNC9pTSh_sqrA-fhRMmhTUPsv-xrcuqgUEQScc1hUi7SBjj25GcbBoVf_NhjuetkQJhS0LduAJJfqz_Me4Kk3z5CX3qqgUtF3K282A.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=fKCWP4nLTc4Q7kNvwGRtcmn&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6OTY1MDc1OTg4NzgwMzE4LCJhc3NldF9hZ2VfZGF5cyI6NDk0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ed3daf27ab696a71&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8xMzQzOTZBRTEyMDg4RDg2MTYzQjIxQkEyMTM0MUVBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMDk1MDkzODgyMTI2MTkyXzg4Njc1NDA2NTc4NDE0MDA5NzMubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrzU8Lfo7rYDFQIoAkMzLBdAN7MzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_AfzX-ow_DcwGwG-N-wJRo2wUhFiBQWG9HH74zasp7_xKdg&oe=69BCE9BA"
        }
      ],
      "profile_image_link": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************",
      "profile_url": "htt***//i***agr*********nny************",
      "profile_name": "Jenny K***y",
      "highlights_count": 1,
      "highlights": [
        {
          "highlight_url": "https://www.instagram.com/stories/highlights/18026550763647585",
          "id": "18026550763647585",
          "image": "https://scontent-atl3-3.cdninstagram.com/v/t51.82787-15/573732645_18127616266495367_3673315206062571981_n.jpg?stp=c0.455.1170.1170a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QEE4OreRXzcQ2CqfikRW1dKnGrkuowmELfFxSlLCv0wKApkCk_6Wcbln6C2erPd-Xo&_nc_ohc=pr5PJJAmFYkQ7kNvwGad141&_nc_gid=uQYUd6X3lmUi--ZasXrx5A&edm=AGXveE0BAAAA&ccb=7-5&oh=00_AfxIP7Y-MDVbXrKf1PFIq3qOQemwInWjCDquh1v-Zuc0qQ&oe=69BCC45C&_nc_sid=522435",
          "owner": "jennykelly1972",
          "title": "📚"
        }
      ],
      "full_name": "Jenny K***y",
      "is_private": false,
      "bio_hashtags": null,
      "url": "https://www.instagram.com/jennykelly1972/",
      "is_joined_recently": false,
      "has_channel": false,
      "partner_id": "5087052934",
      "business_address": null,
      "related_accounts": [],
      "email_address": "jen***dar***ail******",
      "external_url_title": {
        "title": null,
        "url": null
      },
      "pronouns": null
    }
  ]
  ```
</ResponseExample>


# Discover Instagram profiles by username
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-profiles-discover-by-username

POST https://api.brightdata.com/datasets/v3/scrape
Discover Instagram profile data by account username with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l1vikfch901nx3by4.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1vikfch901nx3by4` to collect **Discover by Username** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `user_name`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The username of the Instagram profile.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"user_name": "zoobarcelona"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"user_name":"zoobarcelona"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_l1vikfch901nx3by4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "user_name",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"user_name": "zoobarcelona"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l1vikfch901nx3by4",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "user_name",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ user_name: "zoobarcelona" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account": "jen***ell***72",
      "fbid": "17841405188025881",
      "id": "5087052934",
      "followers": 7938,
      "posts_count": 835,
      "is_business_account": false,
      "is_professional_account": false,
      "is_verified": false,
      "avg_engagement": 0.0582,
      "external_url": null,
      "biography": "Pod: @raydarcydaily \nemail: jenny@darcydaily.com",
      "business_category_name": null,
      "category_name": null,
      "post_hashtags": null,
      "following": 2520,
      "posts": [
        {
          "caption": "BEING HUMAN - A six part series where Ray chats to 6 well known Irish people about what it means to be human. \n\nFirst episode Wednesday 18th March, and every Wednesday after.\n\nA What Next Production\nPresented by Ray D’Arcy\nProduced by Jenny Kelly\n\n#beinghuman \n#podcast \n#irishpodcast",
          "comments": 2,
          "content_type": "Video",
          "datetime": "2026-03-12T11:52:08.000Z",
          "id": "3851176228498036124",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/651142041_18334056292172935_8112879477358850984_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=W4Jy7OhEd8MQ7kNvwFBSQNv&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afwe_S8Bh8FtoL_RtvxoQ6RF2c20beQzWeLfJfizNBlciQ&oe=69BCEC94&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 36,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "beinghuman",
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVyIGAbDdWc",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQMSgH9bCDeY_VmVFTYEzrv9RMglEw0prtVd_QFRgC21aFXJ10hPg07pPxQ6VZdxe1vFeVnYABQlz2zcpXVrQqfV.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=F9Tybdk82ZQQ7kNvwGJ2sbT&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzQwNTU2MDgxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjozLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTE3LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=672fccf82fe0dcbe&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HUGlMdHlhY29GUzFoRFFEQU9udTlRZ1ByVDFKYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0E5NEZGMjZCMjU0OTFERkZBNzYzQjU2NDhBOUM5QThGX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOhor9vq6RQRUCKAJDMywXQF1AAAAAAAAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfyDY32lp2KMgYLDKEK7Wx7ocPFPwwhGkiuWvBKwB_joLg&oe=69BCCEE9"
        },
        {
          "caption": "Our brand new daily podcast is starting tomorrow \n\nRay D’Arcy Daily \n\nWherever you get your podcasts.\n\nEmail us ray@darcydaily.com\n#podcast #irishpodcast",
          "comments": 86,
          "content_type": "Video",
          "datetime": "2026-03-08T16:21:04.000Z",
          "id": "3848412628930911784",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/649327000_1860456074651243_3014167701283875235_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=b0EoQkmauKkQ7kNvwGZzfjq&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxQfU7Ocg9M26vOgYlA3m4oy4cpmvDY9859u4P35lUqng&oe=69BCEFC3&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 992,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "podcast",
            "irishpodcast"
          ],
          "url": "https://www.instagram.com/p/DVoTuVwjd4o",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t16/f2/m69/AQNqwbuRAKLUvBo_BRm3bnGbIV2EPYfXffZLw2f3swiqVgfVNN31xLUjJYzBUmk31ks69X_8_c7EKmCelHv_buYH.mp4?strext=1&_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=iuf2XH_4eaAQ7kNvwGQqv3J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzM2MzkxNzIxNzI5MzUsImFzc2V0X2FnZV9kYXlzIjo3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NjAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ce88cc19b1c12270&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSVhrcWlhdEZTUTBGLTBFQUNGU2oydVRFWlZ4YnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzIwNEVCQTgxMTJEMkM2ODRBNzFEREU0RTQwNTBFQThDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaOsuGkoJaRQRUCKAJDMywXQE464UeuFHsYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfzE-98jZ3zhfaRZuLxlWwz5GmrjBpxgERbFaOjPj7UIrw&oe=69BCCCA4"
        },
        {
          "caption": "We have some news! \n\nRAY D’ARCY DAILY - your daily podcast. \n\nThis five day a week show is nothing new, and yet ALL NEW. It’s Monday to Friday with Ray giving his own world view while surrounded by friends of the show, Jenny Kelly (that’s me 🤪), Mairead Ronan and Bernard O’Shea to name a few. \n\nWe hope you’ll join us. \nStarting Monday 9th. \n\nFollow the show now to make sure you never miss an episode. \n\nListen wherever you get your Podcasts #irishpodcast #podcast \n@cocomairead @bernardo.oshea @acast",
          "comments": 166,
          "content_type": "Video",
          "datetime": "2026-03-02T13:25:41.000Z",
          "id": "3843977898726623596",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/641425914_1446430403853586_8943556578413069821_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=j-4QNAsV4yEQ7kNvwEWKOeO&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy2MQCg7ccEpt8gZNJowsCxi2k7fkX141C5dFU-dvfEfg&oe=69BCC84E&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1158,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast"
          ],
          "url": "https://www.instagram.com/p/DVYjYhaDYls",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t16/f2/m69/AQM_D-LpDwCPxPZrnXzoyfkknE8jP_GwRpGwtEvjefP4KUFo7dAEFZ51YD7Nn6-NLnnVLm3sIF5e7jbT_ImFtRri.mp4?strext=1&_nc_cat=103&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=-FdPzVISP18Q7kNvwEcVVkv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTgzMzMwNTA3OTExNzI5MzUsImFzc2V0X2FnZV9kYXlzIjoxMywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0MSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=54251b7443d07334&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSnlFZHlhaTdRb2U1SmtFQURXYkJFSjd5XzEwYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzEyNEU2RjhEQkU4M0NCQ0Y3NEU5Njk2Q0I0NTJDRkIxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACaO7fTAgPSQQRUCKAJDMywXQGGqp--dsi0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&oh=00_AfxknzHbQifAj5YoGVzxwXn2cPKeVRcRrdXbooIhlD8ZBQ&oe=69BCDC41"
        },
        {
          "caption": "PODCAST NEWS 📢\n\nAfter 3 years we have made the decision to hang up our ‘Jenny and Mairéad NOW' mics. \n\nWe have LOVED doing it. 💕\n\nWe re-connected with so many listeners from our radio days and got lots of new listeners along the way. We want to thank you for all the laughs and life stories you’ve shared with us. \n\nWe both have new commitments that we are diving into, so for today, we'll say ‘so long for now’ 💫 \n\nLots of love, \nJenny and Mairéad \nXx \n\nPS..leave your lips alone, buy a spray mop and remember… \"you’ll be dead forever”",
          "comments": 158,
          "content_type": "Image",
          "datetime": "2025-09-24T17:50:53.000Z",
          "id": "3728872417469969396",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/553161422_17973649637947844_5055340064665934469_n.webp?stp=dst-jpg_e35_s1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=0IDMJZLADZgQ7kNvwGBZl2R&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxVGERnGo1gjS9N7F4Hvi14Ek0zIbXq_m_2vnk8p1c0mQ&oe=69BCDBC8&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 1572,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DO_nbUQDLP0",
          "video_url": null
        },
        {
          "caption": "I COULD have been a camogie player (never played in my life 🤣), and @cocomairead COULD have been a pop star … what COULD you have been? \n\nPodcast out tomorrow 6am #irishpodcast #podcast #jennyandmaireadnow",
          "comments": null,
          "content_type": "Video",
          "datetime": "2025-04-29T21:44:06.000Z",
          "id": "3621719997521697568",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.71878-15/491461907_976222424658362_5118993394906495251_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=fdEBmapVjIYQ7kNvwH9d2ns&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afz4h2HLZTuYioO61W7aDIMzXCHL34Tv_SD_q5TYfJ99iA&oe=69BCBEDC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 62,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "jennyandmaireadnow"
          ],
          "url": "https://www.instagram.com/p/DJC7yYoNZsg",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNdTe3n8U7HJAUZPYQ2IKytrTScEjIa2LVv7p-gcs7bfH2WDHkU1GuQ63tg4BxPEIFCVKgn-k9soAiz09MH_R_ORdQFWDf5N2MPRLY.mp4?_nc_cat=104&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=Syer777RuQMQ7kNvwEmKdhm&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTU5NDc3ODcyNzg2ODYyNywiYXNzZXRfYWdlX2RheXMiOjMxOSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjY5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=1d3eb966c62b0ed0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8zMTRBRkNEOTM4NTM5NjI2MzhBMUQwQ0QxNDk2QzE4QV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMjE3ODU0OTYzMjg1ODY0Xzk0ODMzNjE1ODI3NjU5Njg3OC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmpqOPuauc1QUVAigCQzMsF0BRUQYk3S8bGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxYnVqq-YPFAKEW8CVj-CJBIvyL0qQSOxuzTNCksnr_Sg&oe=69BCE24D"
        },
        {
          "caption": "Podcast @jennyandmaireadnow out tomorrow 6am \n\n✨Mairead needs help\n✨Netflix Doc: Buy Now!\n✨2025 Manifesto\n✨Colour and word of the year \n✨Debutant Balls and Feis\n\nThanks to our sponsor @vhi_ie \n#irishpodcast #podcast #friendship",
          "comments": null,
          "content_type": "Video",
          "datetime": "2024-12-10T21:36:11.000Z",
          "id": "3520245279648780747",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/469729187_18286176577172935_8198072792922023263_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=skhiJmD75-kQ7kNvwEeKZA6&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzWsdPI0aqqm2_IHDtzlIqHu2mL76RyRwvUBMetthP-hg&oe=69BCCDF6&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 64,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "podcast",
            "friendship"
          ],
          "url": "https://www.instagram.com/p/DDabG5HthHL",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQMy1Odi0RhpjgXggsSeeNNxmcDcNt0_X6IYxlCD21k4z4h46ndGKxoNjJIRjVg94CuujC1j-CiG89HT8-O9C-XPAl_3C_7p3GqzZ5M.mp4?_nc_cat=109&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=zEKeRBdP2mAQ7kNvwENzKpk&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTIzMzY5MjkwNzcxNjE1MSwiYXNzZXRfYWdlX2RheXMiOjQ1OSwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjUxLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=be7ed278cb04ea95&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BQjQyNThCNTU0QTJGNEIxODg3NjlBQUJFMDNDMzU4Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xNTAyMTIxNTUwNzQwNjE0Xzc5ODkxODI2NzE3NDU1MDEwNy5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAm7vi1uLCCsQQVAigCQzMsF0BJmZmZmZmaGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_Afzvy10txzkdt9h08tJs_9VMlJicQjSggsPEZ61LEdGYmA&oe=69BCC63E"
        },
        {
          "caption": "This book took me a few weeks to read and it’s only 136 pages long. I could quite easily go back now and start it all over again. One of the most beautiful books I’ve read. It tells the story of 24 hours in the lives of 6 astronauts on the international space station. Each of the 16 chapters takes in one orbit of earth. It’s difficult to describe just how profound and touching this small book is. A love letter to Earth. It made me feel both sad and hopeful at the same time. I read that the author Samantha Harvey stopped writing half way through because she felt she didn’t have the right to write a book like this, so removed was it from her real life. I’m so glad she ignored that voice in her head because this book is something we will read for years and years to come. Stunning.",
          "comments": 6,
          "content_type": "Image",
          "datetime": "2024-12-04T19:34:23.000Z",
          "id": "3515840447256809542",
          "image_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/623407206_17991231980916798_8528601805505725054_n.jpg?stp=dst-jpg_e35_p1080x1080_sh0.08_tt6&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1jkbYPze7PIQ7kNvwFhqTAc&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afzg1e_fEK30evjHAzSP597UW_USGzLTBIj1k-EIjQQMfA&oe=69BCCA41&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 109,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDKxkJRsVBG",
          "video_url": null
        },
        {
          "caption": "Pod out Wednesday 6am\n\n✨Kissing 💋\n✨Christmas Movies 🎬\n✨family traditions 🏡\n✨Nits 🦗\n\nThanks to our sponsor @vhi_ie",
          "comments": 1,
          "content_type": "Video",
          "datetime": "2024-12-03T21:00:59.000Z",
          "id": "3515158122554635287",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/503975082_1908008223345944_5512368651421990898_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=LBreF5ALN2IQ7kNvwE_RtAb&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfzmTzT-OfgwVOhOYS62CUgEdWcUX2YsW20KyaTEXiv3Gg&oe=69BCD350&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 27,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": null,
          "url": "https://www.instagram.com/p/DDIWbA4MrQX",
          "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m367/AQNO52R4NspLq6_HyhxNcCLUQtKiP7dXhYXNEIO3IjvmzKdyZMS_YYgB2zRkbZs4SLFVBOdJpB3L19p9-zxxOyqHp9Lk-fOum-vlUa4.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=eyaMjy3BLs8Q7kNvwFAQ_2h&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc3MTU2NjI2MDMyMzQ3NSwiYXNzZXRfYWdlX2RheXMiOjQ2NiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQ5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=4e62294db6b90ea0&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC82NTRENUM0OTczREYzNDQ0MzFDQTExRDQxRTY0RUI5Rl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMTYwODk0Nzg1Mzk1ODg1XzgyNDkxMDM2OTY3NjU4NTg4MS5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmppKkmt3OpQYVAigCQzMsF0BI7tkWhysCGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&oh=00_AfxxoxyLQuVwyz2uioRVM08hneqBb3CfGndyLkviQkDqVw&oe=69BCE6C8"
        },
        {
          "caption": "Podcast out NOW ✨\n\nWe really enjoyed our chat with @michealmartintd \n\n✨telepathy between him and his wife\n✨the ingredients to his perfect salad\n✨book club inspiration \n✨what he REALLY wanted to be when he grew up \n\n#jennyandmaireadnow #whatweknownow #irishpodcasts #friendship #collabrativestudio",
          "comments": 29,
          "content_type": "Video",
          "datetime": "2024-11-13T11:36:18.000Z",
          "id": "3500373609463083880",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.2885-15/466773911_17936241830947844_3117143642697548716_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=1pwaOyShnGoQ7kNvwGsRorU&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfxMIFfgprmdzKi-AErgzTmN3E-gzqKmuT2QhUQC1TC7NQ&oe=69BCD28B&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 197,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "whatweknownow",
            "irishpodcasts",
            "friendship",
            "collabrativestudio"
          ],
          "url": "https://www.instagram.com/p/DCT00CFMvNo",
          "video_url": "https://scontent-dfw5-1.cdninstagram.com/o1/v/t2/f2/m367/AQNLvylMFRY6P74zmh9wwvuEJ7rtO-sItj8FJLT2nSb_PeMIpJmOm8SkfRH64lOCNztgBnZpZ-XoKhrc8CItJtQKS1Mut4lfPZFXbj8.mp4?_nc_cat=110&_nc_sid=5e9851&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_ohc=qIweWDr6GKEQ7kNvwHO-YZz&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MzkwMzA5NDY3MzI4MjA3MiwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjQzLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=15624de47fd39130&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8yOTQ3MDYwMDcyNEI5QTQ4Njk2RDIzNUNCQjZGNzI5MV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMzIyMTQ3MTEyNDk4NDU0Xzg1NDM2NTk1NDU5NDg0NjEyNjYubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrDQtLiB9u4NFQIoAkMzLBdARfMzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_Afx5DWMCHEDJoObUP3-Lb7Hu9-RkPZteuaVDucxzxkaVtg&oe=69BCD8B3"
        },
        {
          "caption": "🎙️Bit of a different podcast for you this week! \n\nWe sat down with Tánaiste @michealmartintd and asked him ‘What He Knows Now.\n\n✨Life lessons that have got him this far. \n✨Friendships, family & grief\n✨Sea swimming, dry robes & switching off\n\n Full episode drops tomorrow at 6am wherever you get your podcasts. \n\nJ & M\n\nThank you to our sponsor @vhi_ie \n\n#jennyandmaireadnow #lifelessons #dryrobe  #seaswimming",
          "comments": 25,
          "content_type": "Video",
          "datetime": "2024-11-12T22:26:31.000Z",
          "id": "3499981808361075522",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.71878-15/466690817_552614564296939_1070270335390837149_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=4Pn0CaGAEAwQ7kNvwGgi0OG&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_Afy31s1gWLZgx-uRpeh_veSBHwycbYIjHaSe6e6ghEjJug&oe=69BCCA2F&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 367,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "jennyandmaireadnow",
            "lifelessons",
            "dryrobe",
            "seaswimming"
          ],
          "url": "https://www.instagram.com/p/DCSbuk3sPNC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQOQyKg3hXP5Vbemc9YXLsURych3495OTaZ-k5hA5Ud_bPJkecOs-XoiZXj14XHIu3zOfYzZrFmrf4xdztvyIdI8ID29tB2UCIKdGKQ.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=xQB7AZzudfwQ7kNvwFSfvDS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNDgwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTEwMzM1MzI5Nzg3MDA1NCwiYXNzZXRfYWdlX2RheXMiOjQ4NywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjM2LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=52ef0882b0559893&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC9BMzQxREExQUVBNTJCQUUzNDNCMUEyNzNCQ0FFMzNCQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYRmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC80NTE4MzkyMTEzNTQwNTNfMjIyNDI2NDEzOTg0ODkxMDcwOC5tcDQVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmzPOM1s7f9QMVAigCQzMsF0BB92yLQ5WBGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&oh=00_Afxh28JyyPy9AVGT2wQv9pVAJuU58mjJPkCKFeb6f4Oh8w&oe=69BCE4E7"
        },
        {
          "caption": "Did a photoshoot with Stan because he’s just back from the hairdressers and looking so floofy and smelling beautiful 😍 I needed to document his clean smelling look as he will be rolling in some dirt/fox smell/ muck very soon 🤪 #dogsofinstagram #goldenretriever",
          "comments": 12,
          "content_type": "Carousel",
          "datetime": "2024-11-12T15:25:04.000Z",
          "id": "3499769896973330029",
          "image_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.29350-15/466995326_990526599761200_5153153982064132557_n.jpg?stp=dst-jpg_e35_p1080x1080_tt6&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=UxLUkZuUog8Q7kNvwEC_RWC&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyUh-GMDlDzUu9nBtb6d8zt0aKqVnKXwgO24rSu4kLSnw&oe=69BCECBC&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 432,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "dogsofinstagram",
            "goldenretriever"
          ],
          "url": "https://www.instagram.com/p/DCRri3As2Zt",
          "video_url": null
        },
        {
          "caption": "Behind the scenes brain melt during podcast recording @jennyandmaireadnow 😆 #irishpodcast #brainmelt",
          "comments": 5,
          "content_type": "Video",
          "datetime": "2024-11-06T13:01:12.000Z",
          "id": "3495348313982605954",
          "image_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/504211000_1111075530847029_6819244619431359412_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH-MUSe6C4PkyFc8saG_6IRC_V3hZ9c7StCViUw-zl5K7a2Qh7u0q29i7etbbV1SI4&_nc_ohc=heyO9GE4JlsQ7kNvwFGOhvN&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AfyNVgaEmlBsmZcJ8ZLetflfbX0IbHpSFLa21YNcV-oLoA&oe=69BCE5A5&_nc_sid=8b3546",
          "is_pinned": false,
          "likes": 47,
          "location": {
            "has_public_page": null,
            "id": null,
            "name": null,
            "slug": null
          },
          "post_hashtags": [
            "irishpodcast",
            "brainmelt"
          ],
          "url": "https://www.instagram.com/p/DCB-MW9MZqC",
          "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m367/AQNC9pTSh_sqrA-fhRMmhTUPsv-xrcuqgUEQScc1hUi7SBjj25GcbBoVf_NhjuetkQJhS0LduAJJfqz_Me4Kk3z5CX3qqgUtF3K282A.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=fKCWP4nLTc4Q7kNvwGRtcmn&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6OTY1MDc1OTg4NzgwMzE4LCJhc3NldF9hZ2VfZGF5cyI6NDk0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=f8NLMHfSvJHjKW7CNjdR5w&_nc_ss=8&_nc_zt=28&vs=ed3daf27ab696a71&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8xMzQzOTZBRTEyMDg4RDg2MTYzQjIxQkEyMTM0MUVBOV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMDk1MDkzODgyMTI2MTkyXzg4Njc1NDA2NTc4NDE0MDA5NzMubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrzU8Lfo7rYDFQIoAkMzLBdAN7MzMzMzMxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&oh=00_AfzX-ow_DcwGwG-N-wJRo2wUhFiBQWG9HH74zasp7_xKdg&oe=69BCE9BA"
        }
      ],
      "profile_image_link": "htt***//s***ten*********cdn*********************885************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************",
      "profile_url": "htt***//i***agr*********nny************",
      "profile_name": "Jenny K***y",
      "highlights_count": 1,
      "highlights": [
        {
          "highlight_url": "https://www.instagram.com/stories/highlights/18026550763647585",
          "id": "18026550763647585",
          "image": "https://scontent-atl3-3.cdninstagram.com/v/t51.82787-15/573732645_18127616266495367_3673315206062571981_n.jpg?stp=c0.455.1170.1170a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QEE4OreRXzcQ2CqfikRW1dKnGrkuowmELfFxSlLCv0wKApkCk_6Wcbln6C2erPd-Xo&_nc_ohc=pr5PJJAmFYkQ7kNvwGad141&_nc_gid=uQYUd6X3lmUi--ZasXrx5A&edm=AGXveE0BAAAA&ccb=7-5&oh=00_AfxIP7Y-MDVbXrKf1PFIq3qOQemwInWjCDquh1v-Zuc0qQ&oe=69BCC45C&_nc_sid=522435",
          "owner": "jennykelly1972",
          "title": "📚"
        }
      ],
      "full_name": "Jenny K***y",
      "is_private": false,
      "bio_hashtags": null,
      "url": "https://www.instagram.com/jennykelly1972/",
      "is_joined_recently": false,
      "has_channel": false,
      "partner_id": "5087052934",
      "business_address": null,
      "related_accounts": [],
      "email_address": "jen***dar***ail******",
      "external_url_title": {
        "title": null,
        "url": null
      },
      "pronouns": null
    }
  ]
  ```
</ResponseExample>


# Scrape all Instagram reels
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-reels-collect-all

POST https://api.brightdata.com/datasets/v3/scrape
Collect all reels from an Instagram profile by profile URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lyclm20il4r5helnj.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm20il4r5helnj` to collect **all Reels** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url_all_reels`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<Warning>
  **`start_date` and `end_date` are not supported.** Instagram no longer exposes a reel publish date to the source this scraper reads, so Bright Data removed both fields from the input schema in August 2026. Passing either field returns a [`bad_input`](/products/scraper-studio/error-codes) error rather than collecting the full profile. Use `num_of_posts` to cap how many reels a run collects.
</Warning>

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect, missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {
        "url":"https://www.instagram.com/billieeilish",
        "num_of_posts":20
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.instagram.com/billieeilish","num_of_posts":20}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm20il4r5helnj&notify=false&include_errors=true&type=discover_new&discover_by=url_all_reels"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lyclm20il4r5helnj",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "url_all_reels",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.instagram.com/billieeilish",
                  "num_of_posts": 20,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lyclm20il4r5helnj",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "url_all_reels",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.instagram.com/billieeilish",
          num_of_posts: 20,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/DH_cMAXRIQY/",
      "user_posted": "abracadabraboutique",
      "description": "Conjunto súper cómodo y moderno. Sólo en Abracadabra 😍🔥💣\n\n#indumentariafemenina🛍❤️ #indumentaria #calzado #calzadomujer #nuevosingresos #nuevatemporada #nuevacoleccion",
      "hashtags": [
        "#indumentariafemenina🛍❤️",
        "#indumentaria",
        "#calzado",
        "#calzadomujer",
        "#nuevosingresos",
        "#nuevatemporada",
        "#nuevacoleccion"
      ],
      "num_comments": 4,
      "date_posted": "2025-04-03T16:34:48.000Z",
      "likes": 73,
      "views": 1693,
      "video_play_count": 4080,
      "top_comments": [
        {
          "avatar": "https://scontent-atl3-3.cdninstagram.com/v/t51.2885-19/393981808_832592148654287_1960908302402060583_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43MjAuYzIifQ&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=N_kA__8Fo5wQ7kNvwFS6Ger&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfwkK1Yv4wY0i8oerxqGDvXaONq8-9om9I2Z-yDsAH6DCQ&oe=69BE5B3D&_nc_sid=d885a2",
          "comment": "Muy lindo. Las zapatillas también.",
          "date_of_comment": "2025-04-14T15:10:42.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "bonaviaveronica"
        },
        {
          "avatar": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/500977030_18047146628618941_2751835955884791848_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=sV0auIHjCWsQ7kNvwH_cdH2&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzwL5BtKXDZwJm0ZT7X9FBn5oSmAh2nsfJ77cnvenymxw&oe=69BE5B0A&_nc_sid=d885a2",
          "comment": "Marca ?",
          "date_of_comment": "2025-04-03T17:16:13.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "sildiazperxes1907"
        },
        {
          "avatar": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-19/271473593_643386380192898_2112725622111954980_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NjAuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=wrE6O4hs60oQ7kNvwHBe6eU&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxsNB2qldAzzK1-ksczsJBCwlZlZGpknDcrkiyrMZodrg&oe=69BE5317&_nc_sid=d885a2",
          "comment": "Precio?",
          "date_of_comment": "2025-04-03T16:41:45.000Z",
          "likes": null,
          "num_replies": 1,
          "replies": [
            {
              "date_of_comment": "2025-04-03T17:23:50.000Z",
              "likes": 0,
              "reply": "@riosjuanabeatriz Hola! Este conjunto está $348.000",
              "user_commenting": "abracadabraboutique"
            }
          ],
          "user_commenting": "riosjuanabeatriz"
        }
      ],
      "post_id": "3602722197246084120_1486153738",
      "thumbnail": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/488612825_1867165924020579_4916815125896091111_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4LmRlZmF1bHRfY292ZXJfZnJhbWUuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=RkqxlEWnOyIQ7kNvwFv_VP7&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxcSq1X40zFDMkIhbIx9bweNxizpVgJddTQrWFQTAgGmA&oe=69BE4868&_nc_sid=d885a2",
      "shortcode": "DH_cMAXRIQY",
      "content_id": "3602722197246084120_1486153738_1486153738",
      "product_type": "clips",
      "coauthor_producers": [],
      "tagged_users": [],
      "length": "79.233",
      "video_url": "https://scontent-atl3-1.cdninstagram.com/o1/v/t2/f2/m367/AQP7aYGDohumTP89gcgkkJucB1zmpXBDI3LjFQvlbLwww5fmQdlunmM-s2TyYU77AXScuYUDuz4nexOXZHSsIHloL0OrtqyZIsblTuk.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_ohc=87WnVgH0XycQ7kNvwHaewxU&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6NjExNzc4Mzc4NTI3OTAwLCJhc3NldF9hZ2VfZGF5cyI6MzQ3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NzksInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=cd0c2157c0c0896a&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8wMjQ3QzYxRTA3NTJDRTRFNUM5QTNEQ0U1NDc2QURBQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8yMDE2Nzc5ODAyMTc4MjI1XzE1NzQ5MjY2Nzg1ODE0ODI5MDIubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrjS946YmpYCFQIoAkMzLBdAU9EGJN0vGxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&_nc_ss=8&_nc_zt=28&oh=00_AfxgMJ-f72cLigTUYmJnGOgWUL44sVlMMgqbNbbEWwAwaA&oe=69BE3F57",
      "audio_url": "https://www.instagram.com/reels/audio/620087377687453",
      "posts_count": 2088,
      "followers": 13136,
      "following": null,
      "user_profile_url": "htt***//w***ins*********m/a*********************",
      "is_paid_partnership": false,
      "is_verified": false,
      "profile_image_link": "https://scontent-iad3-1.cdninstagram.com/v/t51.2885-19/68842937_227118391542205_7583241919069683712_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDkuYzIifQ&_nc_ht=scontent-iad3-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QFoakMwk_BffRbxQUziAUQhhh9xn4M_e3jy682uv2MdFhBkjMB2Xvp9Q1YHauIRl6A&_nc_ohc=ETxaEddFQGEQ7kNvwH-RMVe&_nc_gid=RePH33uhj8xbft4ltJmUeg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afx2LTpuEXBvMtLGqvSskEE87byrU1Mg8QS8q6VTeI0mEw&oe=69BE5832&_nc_sid=10d13b"
    }
  ]
  ```
</ResponseExample>


# Scrape Instagram reels by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-reels-collect-by-url

api-reference/sdk-specs/instagram-reels-collect-by-url POST /datasets/v3/scrape
Collect Instagram reel data by reel URL with the Bright Data Scraper API. Send a POST /datasets/v3/scrape request with dataset_id gd_lyclm20il4r5helnj.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm20il4r5helnj` to collect **Reels by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram reels to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {"url":"https://www.instagram.com/reel/C5Rdyj_q7YN/"},
      {"url":"https://www.instagram.com/reel/C85BZjeSHuO"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/DVNLU52gCAP/",
      "user_posted": "lanceoca",
      "description": "clingy naman ng bebe na yan 😂😂",
      "hashtags": null,
      "num_comments": 6,
      "date_posted": "2026-02-26T03:23:20.000Z",
      "likes": 3,
      "views": 388,
      "video_play_count": 1890,
      "top_comments": [
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.2885-19/365460701_613557573974169_4246269411584735337_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NTcuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=1sksn4DLF60Q7kNvwGVdyy-&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfznARNQ0EpZxuYD13_j-z1x5gVSXJzuDNLf27ksGkq9Gg&oe=69BD27FC&_nc_sid=d885a2",
          "comment": "So handsome😍😍😍😍",
          "date_of_comment": "2026-03-05T03:12:12.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "jgmagboo"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/604381380_17846853735621432_1417364464978583437_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zMjAuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=wxn_bgzeNMoQ7kNvwGZZc1t&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzilHku95q5GuC9yL0SW82MZL569Zijwn6C6K-V26ohaA&oe=69BD2DE4&_nc_sid=d885a2",
          "comment": "😢hello handsome",
          "date_of_comment": "2026-03-02T22:51:50.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "mavic6620"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.2885-19/487313612_1015621063797112_1603884341697763156_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=FDBy91MOg4AQ7kNvwFSG43x&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afw_I5Ji5g_FizTfUahhtB2N5dlEHBfF785jDNFXxxLPzw&oe=69BD245E&_nc_sid=d885a2",
          "comment": "Hi there..😍😍🔥",
          "date_of_comment": "2026-02-28T02:47:21.000Z",
          "likes": "1",
          "num_replies": 0,
          "replies": [],
          "user_commenting": "lajas621"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/589404006_17927065818169590_4230007312536318761_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43MjAuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=3cCCnbM9pjkQ7kNvwFuVke7&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfyMahn5ck5AEFFmQUrEH1I7VIWpWjok0AU4EwOZtOwpuw&oe=69BD1C6F&_nc_sid=d885a2",
          "comment": "Wow❤️❤️❤️",
          "date_of_comment": "2026-02-26T08:15:44.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "jennalyn294"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/643610031_18394067647195478_6467437205157259761_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zMjAuYzIifQ&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=R1RL_k362XwQ7kNvwHO8U39&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxLuxMSr1rcvJEsa2UrMoP8Lz-wVzC72xQZ1W3-1byjSA&oe=69BD02EE&_nc_sid=d885a2",
          "comment": "iloveyou ❤️❤️❤️😘",
          "date_of_comment": "2026-02-26T06:42:50.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "mhat.memoracion"
        },
        {
          "avatar": "https://scontent-phl2-1.cdninstagram.com/v/t51.82787-19/611627622_18554417668038304_6341390296922072598_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=AJwRgGMf_coQ7kNvwHWBhko&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afy9MgvDJ_Jv-SVLKAiJVtHaCVrfqmpEtjYOoBCyj_OKjA&oe=69BD0E87&_nc_sid=d885a2",
          "comment": "Kennyyyyy! 😍😍",
          "date_of_comment": "2026-02-26T03:55:43.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "thatsellengayle"
        }
      ],
      "post_id": "3840775872235708431_497234441",
      "thumbnail": "https://scontent-phl2-1.cdninstagram.com/v/t51.71878-15/642489697_931785695971440_3837333144664180149_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4Lm5mcmFtZV9jb3Zlcl9mcmFtZS5jMiJ9&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QH2Km-HWtG_kFjSkWI-wtXI14TUgdgZN3CffFjRE0mZMwRZwsr6ISXIttcetnv45fU&_nc_ohc=ld-onItfzFIQ7kNvwEGAIZT&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afz7i42LKF1TExXZOoZv8OQ6YEd-kZEdzAyk_rUMlaztEw&oe=69BD27F2&_nc_sid=d885a2",
      "shortcode": "DVNLU52gCAP",
      "content_id": "3840775872235708431_497234441_497234441",
      "product_type": "clips",
      "coauthor_producers": [],
      "tagged_users": [],
      "length": "15.033",
      "video_url": "https://scontent-phl2-1.cdninstagram.com/o1/v/t16/f2/m69/AQO1SuMyUcs1QWW58Fau44ndzK-6SmNd445DizWdt8WagvA2o9UAYpZcn6CfH_Wp3E9pH-k4PDImZiE6IJf87aVm.mp4?strext=1&_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-phl2-1.cdninstagram.com&_nc_ohc=fra74Acli5UQ7kNvwG-BbIe&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc5NDkxMzUwMjQxMDE5MjYsImFzc2V0X2FnZV9kYXlzIjoxNywidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=2267dea350fbd465&_nc_vs=HBksFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HSFE0LXlXa1JiMzJYa3dEQU9yaEtYTkZyOHRxYnNwVEFRQUYVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0ZDNENBQjg2Q0VFNTU3RkU5NDZBQUYzNTNGNDFGNkI3X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbM6JiSlaniPxUCKAJDMywXQC4Q5WBBiTcYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=1nVoOKHoCkOl8-av4Iwgkg&_nc_ss=8&_nc_zt=28&oh=00_Afws7Cm4DuKLxHAjheCqUW1fe2al52lZbgUNRHbiXa_H0g&oe=69BD1196",
      "audio_url": "https://www.instagram.com/reels/audio/613780965138542",
      "posts_count": 2319,
      "followers": 94671,
      "following": null,
      "user_profile_url": "htt***//w***ins*********m/l*********",
      "is_paid_partnership": false,
      "is_verified": true,
      "profile_image_link": "https://scontent-mia5-1.cdninstagram.com/v/t51.82787-19/523513088_18520152235018442_1378657946459904137_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-mia5-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QEI4iViNi0YUmtNR4gwjlifNoniCz1nfEs1XGRXQW5VtoNDlwCKdVe_ayxZrKVC3JI&_nc_ohc=jOf5V5nROFYQ7kNvwFvWJah&_nc_gid=2ag63x5Aw5-NL2Fq6v6jhw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afy_XwPZFp_gUapVcrmQwXkvlRmt0xThqroTeB2ERmWtBQ&oe=69BD0AE6&_nc_sid=10d13b"
    }
  ]
  ```
</ResponseExample>


# Discover Instagram reels by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/instagram-reels-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Instagram reels by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyclm20il4r5helnj` to collect **Discover by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<Warning>
  **`start_date` and `end_date` are not supported.** Instagram no longer exposes a reel publish date to the source this scraper reads, so Bright Data removed both fields from the input schema in August 2026. Use `num_of_posts` to cap how many reels a run collects.
</Warning>

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Instagram profile.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect, missing value indicates no limit.
    </ParamField>

    <ParamField type="string[]">
      Post IDs not to include
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {
        "url":"https://www.instagram.com/espn",
        "num_of_posts":20
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.instagram.com/espn","num_of_posts":20}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm20il4r5helnj&notify=false&include_errors=true&type=discover_new&discover_by=url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lyclm20il4r5helnj",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.instagram.com/espn",
                  "num_of_posts": 20,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lyclm20il4r5helnj",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.instagram.com/espn",
          num_of_posts: 20,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.instagram.com/reel/DH_cMAXRIQY/",
      "user_posted": "abracadabraboutique",
      "description": "Conjunto súper cómodo y moderno. Sólo en Abracadabra 😍🔥💣\n\n#indumentariafemenina🛍❤️ #indumentaria #calzado #calzadomujer #nuevosingresos #nuevatemporada #nuevacoleccion",
      "hashtags": [
        "#indumentariafemenina🛍❤️",
        "#indumentaria",
        "#calzado",
        "#calzadomujer",
        "#nuevosingresos",
        "#nuevatemporada",
        "#nuevacoleccion"
      ],
      "num_comments": 4,
      "date_posted": "2025-04-03T16:34:48.000Z",
      "likes": 73,
      "views": 1693,
      "video_play_count": 4080,
      "top_comments": [
        {
          "avatar": "https://scontent-atl3-3.cdninstagram.com/v/t51.2885-19/393981808_832592148654287_1960908302402060583_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43MjAuYzIifQ&_nc_ht=scontent-atl3-3.cdninstagram.com&_nc_cat=111&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=N_kA__8Fo5wQ7kNvwFS6Ger&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfwkK1Yv4wY0i8oerxqGDvXaONq8-9om9I2Z-yDsAH6DCQ&oe=69BE5B3D&_nc_sid=d885a2",
          "comment": "Muy lindo. Las zapatillas también.",
          "date_of_comment": "2025-04-14T15:10:42.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "bonaviaveronica"
        },
        {
          "avatar": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/500977030_18047146628618941_2751835955884791848_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=sV0auIHjCWsQ7kNvwH_cdH2&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfzwL5BtKXDZwJm0ZT7X9FBn5oSmAh2nsfJ77cnvenymxw&oe=69BE5B0A&_nc_sid=d885a2",
          "comment": "Marca ?",
          "date_of_comment": "2025-04-03T17:16:13.000Z",
          "likes": null,
          "num_replies": 0,
          "replies": [],
          "user_commenting": "sildiazperxes1907"
        },
        {
          "avatar": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-19/271473593_643386380192898_2112725622111954980_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NjAuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=wrE6O4hs60oQ7kNvwHBe6eU&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxsNB2qldAzzK1-ksczsJBCwlZlZGpknDcrkiyrMZodrg&oe=69BE5317&_nc_sid=d885a2",
          "comment": "Precio?",
          "date_of_comment": "2025-04-03T16:41:45.000Z",
          "likes": null,
          "num_replies": 1,
          "replies": [
            {
              "date_of_comment": "2025-04-03T17:23:50.000Z",
              "likes": 0,
              "reply": "@riosjuanabeatriz Hola! Este conjunto está $348.000",
              "user_commenting": "abracadabraboutique"
            }
          ],
          "user_commenting": "riosjuanabeatriz"
        }
      ],
      "post_id": "3602722197246084120_1486153738",
      "thumbnail": "https://scontent-atl3-1.cdninstagram.com/v/t51.71878-15/488612825_1867165924020579_4916815125896091111_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42NDB4MTEzNi5zZHIuZjcxODc4LmRlZmF1bHRfY292ZXJfZnJhbWUuYzIifQ&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QF0G7IbSpPio3Hk0geAsBVs2gJ4jQeCifkDkpVXMic-p0t41OMEOyF50VHHXvTi6d4&_nc_ohc=RkqxlEWnOyIQ7kNvwFv_VP7&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfxcSq1X40zFDMkIhbIx9bweNxizpVgJddTQrWFQTAgGmA&oe=69BE4868&_nc_sid=d885a2",
      "shortcode": "DH_cMAXRIQY",
      "content_id": "3602722197246084120_1486153738_1486153738",
      "product_type": "clips",
      "coauthor_producers": [],
      "tagged_users": [],
      "length": "79.233",
      "video_url": "https://scontent-atl3-1.cdninstagram.com/o1/v/t2/f2/m367/AQP7aYGDohumTP89gcgkkJucB1zmpXBDI3LjFQvlbLwww5fmQdlunmM-s2TyYU77AXScuYUDuz4nexOXZHSsIHloL0OrtqyZIsblTuk.mp4?_nc_cat=106&_nc_sid=5e9851&_nc_ht=scontent-atl3-1.cdninstagram.com&_nc_ohc=87WnVgH0XycQ7kNvwHaewxU&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6NjExNzc4Mzc4NTI3OTAwLCJhc3NldF9hZ2VfZGF5cyI6MzQ3LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NzksInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=cd0c2157c0c0896a&_nc_vs=HBksFQIYQGlnX2VwaGVtZXJhbC8wMjQ3QzYxRTA3NTJDRTRFNUM5QTNEQ0U1NDc2QURBQl92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYR2lnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8yMDE2Nzc5ODAyMTc4MjI1XzE1NzQ5MjY2Nzg1ODE0ODI5MDIubXA0FQICyAESACgAGAAbAogHdXNlX29pbAExEnByb2dyZXNzaXZlX3JlY2lwZQExFQAAJrjS946YmpYCFQIoAkMzLBdAU9EGJN0vGxgSZGFzaF9iYXNlbGluZV8xX3YxEQB1_gdl5p0BAA&_nc_gid=pnnR8ImgSAoQzGLidPzdEw&_nc_ss=8&_nc_zt=28&oh=00_AfxgMJ-f72cLigTUYmJnGOgWUL44sVlMMgqbNbbEWwAwaA&oe=69BE3F57",
      "audio_url": "https://www.instagram.com/reels/audio/620087377687453",
      "posts_count": 2088,
      "followers": 13136,
      "following": null,
      "user_profile_url": "htt***//w***ins*********m/a*********************",
      "is_paid_partnership": false,
      "is_verified": false,
      "profile_image_link": "https://scontent-iad3-1.cdninstagram.com/v/t51.2885-19/68842937_227118391542205_7583241919069683712_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDkuYzIifQ&_nc_ht=scontent-iad3-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QFoakMwk_BffRbxQUziAUQhhh9xn4M_e3jy682uv2MdFhBkjMB2Xvp9Q1YHauIRl6A&_nc_ohc=ETxaEddFQGEQ7kNvwH-RMVe&_nc_gid=RePH33uhj8xbft4ltJmUeg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afx2LTpuEXBvMtLGqvSskEE87byrU1Mg8QS8q6VTeI0mEw&oe=69BE5832&_nc_sid=10d13b"
    }
  ]
  ```
</ResponseExample>


# Scrape LinkedIn companies by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url

api-reference/sdk-specs/linkedin-companies-collect-by-url POST /datasets/v3/scrape
Collect structured LinkedIn company data by URL using the Bright Data Scraper API with dataset ID gd_l1vikfnt1wgvvqz95w for company profiles and metadata.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1vikfnt1wgvvqz95w` to collect **Companies Information by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn company to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://il.linkedin.com/company/ibm"},
      {"url":"https://www.linkedin.com/company/figueroa-real-estate/"},
      {"url":"https://www.linkedin.com/organization-guest/company/the-kraft-heinz-company"},
      {"url":"https://il.linkedin.com/company/bright-data"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "zoom",
      "name": "Zoom",
      "country_code": "US,AU,GB,FR,SG,JP,NL",
      "locations": [
        "55 Almaden Blvd., 6th Floor, San Jose, CA 95113 San Jose, CA 95113, US",
        "Level 1, 9 Castlereagh St Sydney, NSW 2000, AU",
        "8000 Avalon Blvd Suite 100, space 216 Alpharetta, Georgia 30008, US",
        "7601 E Technology Way 3rd Floor Denver, Colorado 80237, US",
        "6601 College Blvd Suite 120 Overland Park, Kansas 66211, US",
        "200 E Carrillo St Suite #300 Santa Barbara, California 93101, US",
        "The Place, 4th Floor, 175 High Holborn, London WC1V 7AA, GB",
        "Zoom France, 33 Rue lafayette lafayette, Paris 75009, FR",
        "6 Temasek Boulevard Suntec Tower 5 #17-103 Singapore, SGP 038985, SG",
        "Wework Hibiya park Front 19th floor, 2-1-6 Uchisaiwai-cho Chiyoda-ku, Tokyo 100-0011, JP",
        "Wework 5th floor, Strawinskylaan 4117 Strawinskylaan, Amsterdam 1077 ZX, NL"
      ],
      "followers": 653039,
      "employees_in_linkedin": 12935,
      "about": "Bring teams together, reimagine workspaces, engage new audiences, and delight your customers –– all on the Zoom AI-first work platform you know and love. 💙 Zoomies help people stay connected so they can get more done together. We set out on a mission to make video communications frictionless and secure by building the world’s best video product for the enterprise, but we didn’t stop there. With products like AI Companion, Team Chat, Contact Center, Phone, Events, Rooms, Webinar, Contact Center and more, we bring innovation to a wide variety of customers, from the conference room to the classroom, from doctor’s offices to financial institutions to government agencies, from global brands to small businesses. We do what we do because of our core value of Care: care for our community, our customers, our company, our teammates, and ourselves. Our global employees help our customers meet happier, communicate better, and create meaningful connections the world over. Zoomies are problem-solvers and self-starters, working hard to get results and moving quickly to design solutions with our customers and users in mind. Here, you'll find room to grow with opportunities to stretch your skills and advance your career in a collaborative, growth-focused environment. Learn more about careers at Zoom by visiting our careers site: https://careers.zoom.us/home",
      "specialties": "Mobile Collaboration, Audio Conferencing, Video Conferencing, Online Meetings, Web Conferencing, Cloud Meetings, and Webinar",
      "company_size": "5,001-10,000 employees",
      "organization_type": "Public Company",
      "industries": "IT Services and IT Consulting",
      "website": "https://www.zoom.com/",
      "crunchbase_url": "https://www.crunchbase.com/organization/zoom-video-communications?utm_source=linkedin&utm_medium=referral&utm_campaign=linkedin_companies&utm_content=profile_cta_anon&trk=funding_crunchbase",
      "founded": 2013,
      "company_id": "2532259",
      "employees": [
        {
          "img": "https://media.licdn.com/dms/image/v2/D4D03AQFXMAtpcDdBAw/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1701307779350?e=2147483647&v=beta&t=fuYCbTPZhzeQ1Eegj-0cM4B_rLuBh6Akmmby2iH3oD0",
          "link": "https://www.linkedin.com/in/rossmayfield?trk=org-employees",
          "subtitle": "",
          "title": "Ros***ayf***d"
        },
        {
          "img": "https://media.licdn.com/dms/image/v2/D5603AQFsVNwX0nv_mw/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1680078275810?e=2147483647&v=beta&t=QmztFPLU-r4iis9HsY_26b-8Wz3cnxTAaycwJN9nxr0",
          "link": "https://www.linkedin.com/in/mattocko?trk=org-employees",
          "subtitle": "",
          "title": "Mat***cko***"
        },
        {
          "img": "https://media.licdn.com/dms/image/v2/D5603AQGdYkEt0wfRgw/profile-displayphoto-scale_100_100/B56Zk_fiJLHUAo-/0/1757706861118?e=2147483647&v=beta&t=STHPO2d1uvPkJUlWvtJEv2DuWtuB4jfOJcC7J6kjTTQ",
          "link": "https://www.linkedin.com/in/jscheinman?trk=org-employees",
          "subtitle": "",
          "title": "Jim***hei***n"
        },
        {
          "img": "https://media.licdn.com/dms/image/v2/C5603AQEwqlsQbHGFVQ/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1632693704976?e=2147483647&v=beta&t=ZTB4I2JZMy47qtiZR-p1lG9HE_HBHPrV5BRKUCqBsAI",
          "link": "https://www.linkedin.com/in/shannonmcdole?trk=org-employees",
          "subtitle": "",
          "title": "Sha***n (***d) *********"
        }
      ],
      "headquarters": "San Jose, CA",
      "image": "https://media.licdn.com/dms/image/v2/D563DAQFTYxIYJYwNmw/image-scale_191_1128/B56ZsQFMSLKEAc-/0/1765501357062/zoom_cover?e=2147483647&v=beta&t=hz1TCkzA3Z6tVTSmknd84YeQyij2Q1f5-ooc2_yZ7Co",
      "logo": "https://media.licdn.com/dms/image/v2/D560BAQHdFe3fnAvRmg/company-logo_200_200/company-logo_200_200/0/1711361750580/zoom_video_communications_logo?e=2147483647&v=beta&t=wssg0q9oOBRuuO3kWJQl1RY0c4kNP76u_RELqER9jK8",
      "similar": [
        {
          "Links": "https://www.linkedin.com/company/salesforce?trk=similar-pages",
          "location": "San Francisco, California",
          "subtitle": "Software Development",
          "title": "Salesforce"
        },
        {
          "Links": "https://www.linkedin.com/company/tiny-spec-inc?trk=similar-pages",
          "location": "San Francisco, California",
          "subtitle": "Technology, Information and Internet",
          "title": "Slack"
        },
        {
          "Links": "https://www.linkedin.com/company/google?trk=similar-pages",
          "location": "Mountain View, CA",
          "subtitle": "Software Development",
          "title": "Google"
        },
        {
          "Links": "https://au.linkedin.com/company/atlassian?trk=similar-pages",
          "location": "Sydney, NSW",
          "subtitle": "Software Development",
          "title": "Atlassian"
        },
        {
          "Links": "https://www.linkedin.com/company/microsoft?trk=similar-pages",
          "location": "Redmond, Washington",
          "subtitle": "Software Development",
          "title": "Microsoft"
        },
        {
          "Links": "https://www.linkedin.com/company/airbnb?trk=similar-pages",
          "location": "San Francisco, CA",
          "subtitle": "Software Development",
          "title": "Airbnb"
        },
        {
          "Links": "https://www.linkedin.com/company/netflix?trk=similar-pages",
          "location": "Los Gatos, CA",
          "subtitle": "Entertainment Providers",
          "title": "Netflix"
        },
        {
          "Links": "https://au.linkedin.com/company/canva?trk=similar-pages",
          "location": "Surry Hills, New South Wales",
          "subtitle": "Software Development",
          "title": "Canva"
        },
        {
          "Links": "https://www.linkedin.com/company/hubspot?trk=similar-pages",
          "location": "Cambridge, Massachusetts",
          "subtitle": "Software Development",
          "title": "HubSpot"
        },
        {
          "Links": "https://www.linkedin.com/company/stripe?trk=similar-pages",
          "location": "South San Francisco, California",
          "subtitle": "Technology, Information and Internet",
          "title": "Stripe"
        }
      ],
      "url": "https://www.linkedin.com/company/zoom",
      "updates": [
        {
          "date": "2026-03-16T19:26:02.112Z",
          "likes_count": 14,
          "post_id": "7439391547403530240",
          "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7439391547403530240/",
          "text": "#ZoomPartner Here's everything that went down with Zoom at Enterprise Connect 2026! Zoom is about way more than meetings - there are so many productivity tools within Zoom Workplace that help ease all those work pain points we experience. #ZoomAhead #JoinTheMovement",
          "text_html": "<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoompartner&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomPartner</a> Here&apos;s everything that went down with <a class=\"link\" href=\"https://www.linkedin.com/company/zoom?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Zoom</a>  at Enterprise Connect 2026! Zoom is about way more than meetings - there are so many productivity tools within Zoom Workplace that help ease all those work pain points we experience. <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoomahead&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomAhead</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fjointhemovement&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#JoinTheMovement</a>",
          "time": "3d",
          "title": "William Bowers",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQEJYSUdboIMuQ/mp4-720p-30fp-crf28/B4EZzp1GL3IECI-/0/1773449543327?e=2147483647&v=beta&t=XLOG2RhOkVdK0WCo2csao7InOl9D_o-Up-adbU0cF7E",
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQEJYSUdboIMuQ/mp4-640p-30fp-crf28/B4EZzp1GL3IEBw-/0/1773449542760?e=2147483647&v=beta&t=Eub-gs_Eia8nV9BmB0h-RLC3UKfuWYJxtpbNZ2D-LKY"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-16T16:37:21.224Z",
          "likes_count": 33,
          "post_id": "7439349097322524672",
          "post_url": "https://www.linkedin.com/posts/zoom_zoom-ai-companion-my-notes-activity-7439349097322524672-uOFe",
          "text": "Remember when taking notes felt like a chore? 📝 Let AI Companion My notes do the heavy lifting for you. 💪 Now your notes capture key moments, surface important actions, and help you stay organized — automatically. ✔️ Try it today 🔗 👇",
          "text_html": "Remember when taking notes felt like a chore? &#x1F4DD;\n\nLet AI Companion My notes do the heavy lifting for you. &#x1F4AA;\n\nNow your notes capture key moments, surface important actions, and help you stay organized &#x2014; automatically. &#x2714;&#xFE0F;\n\nTry it today &#x1F517; &#x1F447; ",
          "time": "17h",
          "title": "Zoom",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5610AQFq8-Z6_G0ynA/mp4-720p-30fp-crf28/B56Zz3ghwUJ8CA-/0/1773679031499?e=2147483647&v=beta&t=tpors2KuQeHa6A91xjIZzYYuwDgZ0YTYCDo9qvBnuE8",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQFq8-Z6_G0ynA/mp4-360p-30fp-crf28/B56Zz3ghwUJ8B8-/0/1773679030921?e=2147483647&v=beta&t=wX73ec8ifCfUs71QZ3IaIzJN-vVqeUdP2xJYgY3MwRA",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQFq8-Z6_G0ynA/mp4-640p-30fp-crf28/B56Zz3ghwUJ8Bk-/0/1773679030920?e=2147483647&v=beta&t=6bJS4S1iuCl6PCAS7TMuaOjD68Df4ErjiDwyZbpIysM"
          ]
        },
        {
          "comments_count": 1,
          "date": "2026-03-16T14:01:13.970Z",
          "likes_count": 36,
          "post_id": "7439309808211660800",
          "post_url": "https://www.linkedin.com/posts/zoom_enterpriseconnect-activity-7439309808211660800-sS8s",
          "text": "Missed the Zoom keynote at #EnterpriseConnect ? Here's your chance to get a first look at Zoom’s latest innovations in AI and orchestration. ⚡ Work today is full of complexity: too many tools, back-to-back meetings, and endless tasks that slow meaningful progress. This friction impacts everyone: IT teams struggle to orchestrate workflows, customer-facing teams wrestle with fragmented data, and small and mid-size businesses find it hard to scale efficiently.",
          "text_html": "Missed the Zoom keynote at <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>? Here&apos;s your chance to get a first look at Zoom&#x2019;s latest innovations in AI and orchestration. &#x26A1; \n\nWork today is full of complexity: too many tools, back-to-back meetings, and endless tasks that slow meaningful progress. This friction impacts everyone: IT teams struggle to orchestrate workflows, customer-facing teams wrestle with fragmented data, and small and mid-size businesses find it hard to scale efficiently.",
          "time": "20h",
          "title": "Zoom"
        },
        {
          "date": "2026-03-13T19:00:30.157Z",
          "likes_count": 36,
          "post_id": "7438297958321745920",
          "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7438297958321745920/",
          "text": "#ZoomPartner Mind blown by all the product features Zoom Al Companion has introduced to make work more productive #ZoomAhead #JoinTheMovement",
          "text_html": "<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoompartner&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomPartner</a> Mind blown by all the product features <a class=\"link\" href=\"https://www.linkedin.com/company/zoom?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Zoom</a> Al Companion has introduced to make work more productive <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoomahead&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomAhead</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fjointhemovement&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#JoinTheMovement</a>",
          "time": "4d",
          "title": "Jonjon Perlas",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFX_Y-7gNo6pQ/mp4-640p-30fp-crf28/B56ZzkKvIWKMBw-/0/1773354552092?e=2147483647&v=beta&t=DpI4CxpjD6LPqV-0o8rQc6-wehwrXkLoTARZk6au0D8",
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFX_Y-7gNo6pQ/mp4-720p-30fp-crf28/B56ZzkKvIWKMCI-/0/1773354550978?e=2147483647&v=beta&t=G2Joz_R3qdMHWsIvsiabC6rBn-tce7s_8lc75sfWU9c"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-13T16:13:15.946Z",
          "images": [
            "https://media.licdn.com/dms/image/v2/D5612AQFyetvdvO6pnQ/article-cover_image-shrink_720_1280/B56Zzlo8NsJIAI-/0/1773379247714?e=2147483647&v=beta&t=N8kACz_0w2ni-81Y4JCPGuJYbOoDpjd1bv2LLNWiyrU"
          ],
          "likes_count": 82,
          "post_id": "7438255871790460928",
          "post_url": "https://www.linkedin.com/posts/zoom_turn-lets-follow-up-into-finished-work-activity-7438255871790460928-n4kw",
          "text": "At Enterprise Connect , we unveiled new innovations for Zoom Workplace designed to help teams move from conversation to completion. In our latest newsletter, Leo Boulton , Head of Product, Solutions, and Industry Marketing at Zoom, dives into these innovations and explains what this shift looks like in practice—and how AI can help reduce the friction that slows teams down. He breaks down: 🚀 What a “system of action” means for the future of work ✨ How Zoom AI Companion can help turn discussions into deliverables 💥 Why meeting friction is holding teams back Read the full newsletter below and let us know in the comments which innovation you’re most excited about. 👇 #EnterpriseConnect",
          "text_html": "At <a class=\"link\" href=\"https://uk.linkedin.com/company/enterpriseconnect?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Enterprise Connect</a>, we unveiled new innovations for Zoom Workplace designed to help teams move from conversation to completion.\n\nIn our latest newsletter, <a class=\"link\" href=\"https://www.linkedin.com/in/leoboulton?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Leo Boulton</a>, Head of Product, Solutions, and Industry Marketing at Zoom, dives into these innovations and explains what this shift looks like in practice&#x2014;and how AI can help reduce the friction that slows teams down.\n\nHe breaks down:\n&#x1F680; What a &#x201C;system of action&#x201D; means for the future of work\n&#x2728; How Zoom AI Companion can help turn discussions into deliverables\n&#x1F4A5; Why meeting friction is holding teams back\n\nRead the full newsletter below and let us know in the comments which innovation you&#x2019;re most excited about. &#x1F447;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>",
          "time": "3d",
          "title": "Zoom"
        },
        {
          "date": "2026-03-12T23:20:43.792Z",
          "likes_count": 65,
          "post_id": "7438001058787868672",
          "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7438001058787868672/",
          "text": "#ZoomPartner l'm here at Enterprise Connect to see the latest innovations from the Zoom Booth. Impressed by all the product features Zoom has introduced with Al Companion to help make me more productive. #ZoomAhead #JoinTheMovement",
          "text_html": "<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoompartner&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomPartner</a> l&apos;m here at Enterprise Connect to see the latest innovations from the <a class=\"link\" href=\"https://www.linkedin.com/company/zoom?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Zoom</a>  Booth. Impressed by all the product features Zoom has introduced with Al Companion to help make me more productive. <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fzoomahead&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#ZoomAhead</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fjointhemovement&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#JoinTheMovement</a>",
          "time": "5d",
          "title": "William Bowers",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQGCUmvQ_h-5xg/mp4-720p-30fp-crf28/B4EZzfC3UoHsCM-/0/1773268602681?e=2147483647&v=beta&t=pOf4vR8UU9URucZp8A9-nVehFDURjabY9Z9JyNfBIxk",
            "https://dms.licdn.com/playlist/vid/v2/D4E05AQGCUmvQ_h-5xg/mp4-640p-30fp-crf28/B4EZzfC3UoHsB0-/0/1773268602681?e=2147483647&v=beta&t=ogoGLE1vVNdSjLRgWv-Yk0YA-OAuAmr15hVieHHqKKw"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-12T18:25:13.067Z",
          "likes_count": 22,
          "post_id": "7437926690737049600",
          "post_url": "https://www.linkedin.com/posts/zoom_enterpriseconnect-activity-7437926690737049600-zWRU",
          "repost": {
            "repost_date": "202***3-1***7:1*********",
            "repost_hangtags": [
              "******",
              "******",
              "******",
              "#Ag***ic",
              "******"
            ],
            "repost_id": "743***776***610******",
            "repost_text": "Goo***nou***isn*********nou*********************es ***************************************************************************************************************************************************************************************************************",
            "repost_title": "Dav***ich***",
            "repost_url": "htt***//w***lin*********/fe*********************vit************************",
            "tagged_companies": [
              {
                "link": "htt***//w***lin*********/co*********************zat***************************************",
                "name": "******",
                "type": "company"
              }
            ],
            "tagged_users": [
              {
                "link": "htt***//w***lin*********/in*********************iza***************************************",
                "name": "Leo Boulton",
                "type": "people"
              }
            ],
            "videos": [
              "htt***//d***lic*********ayl*********************sPQ******************************************************************************************************************************",
              "htt***//d***lic*********ayl*********************sPQ******************************************************************************************************************************"
            ]
          },
          "text": "Great discussion from Dave Michels following the Enterprise Connect keynote. 🙌 As Leo Boulton , Head of Product, Solutions, and Industry Marketing at Zoom shared: 💬 “System of action is how we progress from a conversation to completion…the system of action is the framework underneath it. We talked about system of record which is more data centric...AI has been changing that. It's about the action that is performed by AI. When AI needs to capture insights, that conversation layer we're talking about needs to support and substantiate the actions that are performed. We're orchestrating the action of work.\" Check out the full conversation here. 👇 #EnterpriseConnect",
          "text_html": "Great discussion from <a class=\"link\" href=\"https://www.linkedin.com/in/davemichels?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Dave Michels</a> following the <a class=\"link\" href=\"https://uk.linkedin.com/company/enterpriseconnect?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Enterprise Connect</a> keynote. &#x1F64C;\n\nAs <a class=\"link\" href=\"https://www.linkedin.com/in/leoboulton?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Leo Boulton</a>, Head of Product, Solutions, and Industry Marketing at Zoom shared:\n\n&#x1F4AC; &#x201C;System of action is how we progress from a conversation to completion&#x2026;the system of action is the framework underneath it. We talked about system of record which is more data centric...AI has been changing that. It&apos;s about the action that is performed by AI. When AI needs to capture insights, that conversation layer we&apos;re talking about needs to support and substantiate the actions that are performed. We&apos;re orchestrating the action of work.&quot;\n\nCheck out the full conversation here. &#x1F447;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>",
          "time": "4d",
          "title": "Zoom",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFTOsPQPO90LA/mp4-720p-30fp-crf28/B56Zzg50JWKUCM-/0/1773299879942?e=2147483647&v=beta&t=JorMvMOCh-nKPefhc1iYnIbPbmHQIwnshO1At-TqjZs",
            "https://dms.licdn.com/playlist/vid/v2/D5605AQFTOsPQPO90LA/mp4-640p-30fp-crf28/B56Zzg50JWKUB0-/0/1773299859947?e=2147483647&v=beta&t=Nf7fIU7mN3ipy8kFj01jCrjYZnZLXqctn9Xkz5t2Vm8"
          ]
        },
        {
          "comments_count": 1,
          "date": "2026-03-11T18:50:11.079Z",
          "likes_count": 79,
          "post_id": "7437570585989124099",
          "post_url": "https://www.linkedin.com/posts/zoom_conversation-to-completion-activity-7437570585989124099-uYtQ",
          "text": "Meetings don’t slow work down. Endless follow-ups do. 🫠 94% of employees say friction is slowing them down. 🐌 Why? Context gets lost between preparation, discussion, and follow-up. At Zoom, we focused on giving you the tools to drive Conversation ➡️ Completion. With AI Companion, tasks flow naturally, so teams spend less time chasing context and more time driving decisions forward. ✨ #EnterpriseConnect",
          "text_html": "Meetings don&#x2019;t slow work down. Endless follow-ups do. &#x1FAE0;\n\n94% of employees say friction is slowing them down. &#x1F40C;\n\nWhy? Context gets lost between preparation, discussion, and follow-up.\n\nAt Zoom, we focused on giving you the tools to drive Conversation &#x27A1;&#xFE0F; Completion. \n\nWith AI Companion, tasks flow naturally, so teams spend less time chasing context and more time driving decisions forward. &#x2728;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>",
          "time": "5d",
          "title": "Zoom",
          "videos": [
            "https://dms.licdn.com/playlist/vid/v2/D5610AQH5CIOh97Lpww/mp4-720p-30fp-crf28/B56ZzePBSzJkCA-/0/1773255008652?e=2147483647&v=beta&t=xm2AQU192ejkgZQNj4A3C6HVaTVzbcMwuYRUGJPON0I",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQH5CIOh97Lpww/mp4-360p-30fp-crf28/B56ZzePBSzJkB8-/0/1773255008653?e=2147483647&v=beta&t=SA88DFW7pDlf5o34Pg-F4GmjeY_pL3d6ix4Uf57jQNE",
            "https://dms.licdn.com/playlist/vid/v2/D5610AQH5CIOh97Lpww/mp4-640p-30fp-crf28/B56ZzePBSzJkBk-/0/1773255008653?e=2147483647&v=beta&t=GAoyPtRISNkCJVbU_75fIG92tDcFQCoQLRLpzucaVfc"
          ]
        },
        {
          "comments_count": 2,
          "date": "2026-03-10T23:47:39.433Z",
          "images": [
            "https://media.licdn.com/dms/image/v2/D5622AQFNx1LWnmJw6A/feedshare-shrink_1280/B56ZzaJh3zGgAM-/0/1773186457356?e=2147483647&v=beta&t=4SgrmeXNZaO4bui8FQycnxbWxbEXowlnNxVmCpFBsZc",
            "https://media.licdn.com/dms/image/v2/D5622AQF4OfdDTczLIA/feedshare-shrink_800/B56ZzaJh5xHIAc-/0/1773186457499?e=2147483647&v=beta&t=AhvCx0PgZPYRKdWGtWYFIXT-VZLLsW3swwlhAU2VGqo",
            "https://media.licdn.com/dms/image/v2/D5622AQESoAZHI4VUew/feedshare-shrink_1280/B56ZzaJh8xGgAM-/0/1773186457681?e=2147483647&v=beta&t=vN9KpnNBP-9qFc1VaPTbrfUZn7vE-s7M_Mfzvw84ZXo",
            "https://media.licdn.com/dms/image/v2/D5622AQHfoDT_kvNf_w/feedshare-shrink_2048_1536/B56ZzaJh8aGQAg-/0/1773186457654?e=2147483647&v=beta&t=nlP2i-bLo6H36F9u1z8gaELFXHWNgbcLtiloMkR_mJo"
          ],
          "likes_count": 218,
          "post_id": "7437283059546284032",
          "post_url": "https://www.linkedin.com/posts/zoom_enterpriseconnect-activity-7437283059546284032-UFKx",
          "text": "At #EnterpriseConnect , we’re showcasing how Zoom is transforming the way organizations operate—by eliminating friction and connecting every part of work into one seamless system of action. Stop by our booth to experience how our unified platform turns communication into momentum.",
          "text_html": "At <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a>, we&#x2019;re showcasing how Zoom is transforming the way organizations operate&#x2014;by eliminating friction and connecting every part of work into one seamless system of action.\n\nStop by our booth to experience how our unified platform turns communication into momentum.",
          "time": "6d",
          "title": "Zoom"
        },
        {
          "comments_count": 2,
          "date": "2026-03-10T21:00:34.504Z",
          "likes_count": 151,
          "post_id": "7437241011946377216",
          "post_url": "https://www.linkedin.com/posts/zoom_zoom-innovations-from-ec-2026-activity-7437241011946377216-_rC2",
          "text": "We’re announcing major Zoom innovations at Enterprise Connect this week—and you’re getting the first look. 🚀 Swipe through for a sneak peek at what’s coming. Full details in the comments. ✨ Which of these are you most excited about? 💬 #EnterpriseConnect | Enterprise Connect",
          "text_html": "We&#x2019;re announcing major Zoom innovations at Enterprise Connect this week&#x2014;and you&#x2019;re getting the first look. &#x1F680;\n\nSwipe through for a sneak peek at what&#x2019;s coming. Full details in the comments. &#x2728;\n\nWhich of these are you most excited about? &#x1F4AC;\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fenterpriseconnect&amp;trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>#EnterpriseConnect</a> | <a class=\"link\" href=\"https://uk.linkedin.com/company/enterpriseconnect?trk=organization_guest_main-feed-card-text\" target=\"_self\" data-tracking-control-name=\"organization_guest_main-feed-card-text\" data-tracking-will-navigate>Enterprise Connect</a> ",
          "time": "6d",
          "title": "Zoom"
        }
      ],
      "slogan": "AI-First Work Platform for Human Connection ✨",
      "affiliated": [
        {
          "Links": "https://www.linkedin.com/showcase/zoom-ventures/?trk=affiliated-pages",
          "location": "San Jose, California",
          "subtitle": "Venture Capital and Private Equity Principals",
          "title": "Zoom Ventures"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-docs/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Docs"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-revenue-accelerator/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Revenue Accelerator"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-clips/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Clips"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-whiteboard/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Whiteboard"
        },
        {
          "Links": "https://www.linkedin.com/showcase/zoom-scheduler/?trk=affiliated-pages",
          "location": null,
          "subtitle": "IT Services and IT Consulting",
          "title": "Zoom Scheduler"
        }
      ],
      "funding": {
        "last_round_date": "2021-12-04T00:00:00.000Z",
        "last_round_raised": "US$ 130.0M",
        "last_round_type": "Post IPO equity",
        "rounds": 9
      },
      "investors": [
        "ARK Investment Management"
      ],
      "formatted_locations": [
        "55 Almaden Blvd., 6th Floor, San Jose, CA 95113, San Jose, CA 95113, US",
        "Level 1, 9 Castlereagh St, Sydney, NSW 2000, AU",
        "8000 Avalon Blvd, Suite 100, space 216, Alpharetta, Georgia 30008, US",
        "7601 E Technology Way, 3rd Floor, Denver, Colorado 80237, US",
        "6601 College Blvd, Suite 120, Overland Park, Kansas 66211, US",
        "200 E Carrillo St, Suite #300, Santa Barbara, California 93101, US",
        "The Place, 4th Floor, 175 High, Holborn, London WC1V 7AA, GB",
        "Zoom France, 33 Rue lafayette, lafayette, Paris 75009, FR",
        "6 Temasek Boulevard, Suntec Tower 5 #17-103, Singapore, SGP 038985, SG",
        "Wework Hibiya park Front, 19th floor, 2-1-6 Uchisaiwai-cho, Chiyoda-ku, Tokyo 100-0011, JP",
        "Wework 5th floor, Strawinskylaan 4117, Strawinskylaan, Amsterdam 1077 ZX, NL"
      ],
      "stock_info": null,
      "get_directions_url": [
        {
          "directions_url": "https://www.bing.com/maps?where=55+Almaden+Blvd.%2C+6th+Floor%2C+San+Jose%2C+CA+95113+San+Jose+95113+CA+US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Level+1%2C+9+Castlereagh+St+Sydney+2000+NSW+AU&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=8000+Avalon+Blvd++Suite+100%2C+space+216+Alpharetta+30008+Georgia+US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=7601+E+Technology+Way+3rd+Floor+Denver+80237+Colorado++US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=6601+College+Blvd+Suite+120+Overland+Park+66211+Kansas++US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=200+E+Carrillo+St+Suite+%23300+Santa+Barbara+93101+California+US&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=The+Place%2C+4th+Floor%2C+175+High+Holborn+WC1V+7AA+London+GB&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Zoom+France%2C+33+Rue+lafayette+lafayette+75009+Paris++FR&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=6+Temasek+Boulevard+Suntec+Tower+5+%2317-103+Singapore+038985+SGP+SG&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Wework+Hibiya+park+Front+19th+floor%2C+2-1-6+Uchisaiwai-cho+Chiyoda-ku+100-0011+Tokyo+JP&trk=org-locations_url"
        },
        {
          "directions_url": "https://www.bing.com/maps?where=Wework+5th+floor%2C+Strawinskylaan+4117+Strawinskylaan+1077+ZX+Amsterdam++NL&trk=org-locations_url"
        }
      ],
      "description": "Zoom | 653,039 followers on LinkedIn. AI-First Work Platform for Human Connection ✨ | Bring teams together, reimagine workspaces, engage new audiences, and delight your customers –– all on the Zoom AI-first work platform you know and love. 💙\n\nZoomies help people stay connected so they can get more done together. We set out on a mission to make video communications frictionless and secure by building the world’s best video product for the enterprise, but we didn’t stop there. With products like AI Companion, Team Chat, Contact Center, Phone, Events, Rooms, Webinar, Contact Center and more, we bring innovation to a wide variety of customers, from the conference room to the classroom, from doctor’s offices to financial institutions to government agencies, from global brands to small businesses.",
      "additional_information": "Additional jobs info: Zoom (27,487 open jobs). Engineer (555,845 open jobs). Manager (1,880,925 open jobs). Analyst (694,057 open jobs). Account Executive (71,457 open jobs). Project Manager (253,048 open jobs). Account Manager (121,519 open jobs). Associate (1,091,945 open jobs). Marketing Manager (106,879 open jobs). Director (1,220,357 open jobs). Specialist (768,666 open jobs). Enterprise Account Executive (44,389 open jobs). Executive (690,514 open jobs). Developer (258,935 open jobs). Product Designer (45,389 open jobs). Scientist (48,969 open jobs). Intern (71,196 open jobs). Site Reliability Engineer (169,128 open jobs). Software Engineer (300,699 open jobs). Consultant (760,907 open jobs)",
      "country_codes_array": [
        "US",
        "AU",
        "GB",
        "FR",
        "SG",
        "JP",
        "NL"
      ],
      "alumni": null,
      "alumni_information": null,
      "website_simplified": "zoo***om",
      "unformatted_about": "\n              Bring teams together, reimagine workspaces, engage new audiences, and delight your customers –– all on the Zoom AI-first work platform you know and love. 💙\n\nZoomies help people stay connected so they can get more done together. We set out on a mission to make video communications frictionless and secure by building the world’s best video product for the enterprise, but we didn’t stop there. With products like AI Companion, Team Chat, Contact Center, Phone, Events, Rooms, Webinar, Contact Center and more, we bring innovation to a wide variety of customers, from the conference room to the classroom, from doctor’s offices to financial institutions to government agencies, from global brands to small businesses.\n\nWe do what we do because of our core value of Care: care for our community, our customers, our company, our teammates, and ourselves. Our global employees help our customers meet happier, communicate better, and create meaningful connections the world over. Zoomies are problem-solvers and self-starters, working hard to get results and moving quickly to design solutions with our customers and users in mind. Here, you'll find room to grow with opportunities to stretch your skills and advance your career in a collaborative, growth-focused environment.\n\nLearn more about careers at Zoom by visiting our careers site: https://careers.zoom.us/home\n          "
    }
  ]
  ```
</ResponseExample>


# Scrape LinkedIn jobs by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url

api-reference/sdk-specs/linkedin-jobs-collect-by-url POST /datasets/v3/scrape
Collect structured LinkedIn job posting data by URL using the Bright Data Scraper API with dataset ID gd_lpfll7v5hcqtkxl6l for job details and metadata.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lpfll7v5hcqtkxl6l` to collect **Jobs by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn job listing to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/jobs/view/software-engineer-at-epic-3986111804?_l=en"},
      {"url":"https://www.linkedin.com/jobs/view/software-engineer-at-pave-4310512612/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.linkedin.com/jobs/view/pharmacy-technician-at-walmart-4385163817?_l=en",
      "job_posting_id": "4385163817",
      "job_title": "Pharmacy Technician",
      "company_name": "Walmart",
      "company_id": "2646",
      "job_location": "Fayetteville, NC",
      "job_summary": "Hourly Wage: $16 - $29 per/hour The actual hourly rate will equal or exceed the required minimum wage applicable to the job location. Additional Compensation Includes Annual Or Quarterly Performance Incentives. Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met. Employment Type: Part-Time Available shifts: Mid-Shift, Closing Location Walmart Supercenter #3595 7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US Job Overview Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies. Benefits & perks At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more. You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam's Club facilities. Programs range from high school completion to bachelor's degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart. Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com. Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment. Show more Show less",
      "job_seniority_level": "Entry level",
      "job_function": "Health Care Provider",
      "job_employment_type": "Part-time",
      "job_industries": "Retail",
      "job_base_pay_range": "$16.00/hr - $29.00/hr",
      "company_url": "https://www.linkedin.com/company/walmart?trk=public_jobs_topcard-org-name",
      "job_posted_time": "4 days ago",
      "job_num_applicants": 25,
      "discovery_input": {
        "experience_level": null,
        "job_type": null,
        "remote": null,
        "selective_search": null,
        "time_range": null
      },
      "apply_link": null,
      "country_code": "US",
      "title_id": "1062",
      "company_logo": "https://media.licdn.com/dms/image/v2/D560BAQHZkPdlecGssw/company-logo_100_100/company-logo_100_100/0/1736779000209/walmart_logo?e=2147483647&v=beta&t=tWcWIFSyHtICTzTLIPiYeKCp21XucI-HWijZdWwYR-A",
      "job_posted_date": "2026-03-13T09:48:59.171Z",
      "job_poster": {
        "name": null,
        "title": null,
        "url": null
      },
      "application_availability": true,
      "job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"5\">\n        <div class=\"show-more-less-html__markup show-more-less-html__markup--clamp-after-5\n            relative overflow-hidden\">\n          Hourly Wage: <strong>$16 - $29 per/hour<br><br></strong><ul><li>The actual hourly rate will equal or exceed the required minimum wage applicable to the job location.<br><br></li></ul><strong>Additional Compensation Includes Annual Or Quarterly Performance Incentives.<br><br></strong>Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met.<br><br>Employment Type: <strong>Part-Time<br><br></strong>Available shifts: <strong>Mid-Shift, Closing<br><br></strong>Location<br><br><strong>Walmart Supercenter #3595<br><br></strong>7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US<br><br><strong>Job Overview<br><br></strong>Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies.<br><br>Benefits &amp; perks<br><br>At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more.<br><br>You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page<br><br>Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam&apos;s Club facilities. Programs range from high school completion to bachelor&apos;s degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart.<br><br>Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com.<br><br>Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment.\n        </div>\n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--more\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-more-html-btn\" aria-label=\"Show more\" aria-expanded=\"false\">\n<!---->\n        \n            Show more\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/cyolgscd0imw2ldqppkrb84vo\"></icon>\n    </button>\n  \n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--less\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-less-html-btn\" aria-label=\"Show less\" aria-expanded=\"true\">\n<!---->\n        \n            Show less\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/4chtt12k98xwnba1nimld2oyg\"></icon>\n    </button>\n  \n<!---->    </section>",
      "base_salary": {
        "currency": "$",
        "max_amount": 29,
        "min_amount": 16,
        "payment_period": "hr"
      },
      "salary_standards": "This range is provided by Walmart. Your actual pay will be based on your skills and experience — talk with your recruiter to learn more.",
      "is_easy_apply": false
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn jobs by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-jobs-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover LinkedIn Jobs by Keyword. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lpfll7v5hcqtkxl6l` to collect **Discover Jobs by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Collect jobs in a specific location
    </ParamField>

    <ParamField type="string">
      Collect new jobs by keyword search like the job title, for example: Product Manager. Utilize quotation marks around specific words or phrases to ensure an exact match.
    </ParamField>

    <ParamField type="string">
      Use country code with 2 letters like `US` or `FR`
    </ParamField>

    <ParamField type="string">
      Time range of the job posting
    </ParamField>

    <ParamField type="string">
      Collect jobs from specific type like Full-time or Part-time
    </ParamField>

    <ParamField type="string">
      Collect jobs from a specific experience level
    </ParamField>

    <ParamField type="string">
      Specify if you want to collect only "Remote", "On-site" or "Hybrid" jobs
    </ParamField>

    <ParamField type="string">
      Collect jobs from a specific company
    </ParamField>

    <ParamField type="boolean">
      When set to true, the filter will exclude titles that do not contain the specified keywords
    </ParamField>

    <ParamField type="string[]">
      Jobs IDs to exclude
    </ParamField>

    <ParamField type="string" />
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {
        "location":"paris",
        "keyword":"product manager",
        "country":"FR",
        "time_range":"Past month",
        "job_type":"Full-time",
        "experience_level":"Internship",
        "remote":"On-site",
        "company":"",
        "location_radius":""
      },
      {
        "location":"New York",
        "keyword":"\"python developer\"",
        "experience_level":"Executive",
        "country":"",
        "time_range":"",
        "job_type":"",
        "remote":"",
        "company":"",
        "location_radius":""
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"location":"paris","keyword":"product manager","country":"FR","time_range":"Past month","job_type":"Full-time","experience_level":"Internship","remote":"On-site","company":"","location_radius":""},{"location":"New York","keyword":"\"python developer\"","experience_level":"Executive","country":"","time_range":"","job_type":"","remote":"","company":"","location_radius":""}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lpfll7v5hcqtkxl6l&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lpfll7v5hcqtkxl6l",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "location": "paris",
                  "keyword": "product manager",
                  "country": "FR",
                  "time_range": "Past month",
                  "job_type": "Full-time",
                  "experience_level": "Internship",
                  "remote": "On-site",
                  "company": "",
                  "location_radius": "",
              },
              {
                  "location": "New York",
                  "keyword": "\"python developer\"",
                  "experience_level": "Executive",
                  "country": "",
                  "time_range": "",
                  "job_type": "",
                  "remote": "",
                  "company": "",
                  "location_radius": "",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lpfll7v5hcqtkxl6l",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          location: "paris",
          keyword: "product manager",
          country: "FR",
          time_range: "Past month",
          job_type: "Full-time",
          experience_level: "Internship",
          remote: "On-site",
          company: "",
          location_radius: "",
        },
        {
          location: "New York",
          keyword: "\"python developer\"",
          experience_level: "Executive",
          country: "",
          time_range: "",
          job_type: "",
          remote: "",
          company: "",
          location_radius: "",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.linkedin.com/jobs/view/pharmacy-technician-at-walmart-4385163817?_l=en",
      "job_posting_id": "4385163817",
      "job_title": "Pharmacy Technician",
      "company_name": "Walmart",
      "company_id": "2646",
      "job_location": "Fayetteville, NC",
      "job_summary": "Hourly Wage: $16 - $29 per/hour The actual hourly rate will equal or exceed the required minimum wage applicable to the job location. Additional Compensation Includes Annual Or Quarterly Performance Incentives. Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met. Employment Type: Part-Time Available shifts: Mid-Shift, Closing Location Walmart Supercenter #3595 7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US Job Overview Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies. Benefits & perks At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more. You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam's Club facilities. Programs range from high school completion to bachelor's degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart. Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com. Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment. Show more Show less",
      "job_seniority_level": "Entry level",
      "job_function": "Health Care Provider",
      "job_employment_type": "Part-time",
      "job_industries": "Retail",
      "job_base_pay_range": "$16.00/hr - $29.00/hr",
      "company_url": "https://www.linkedin.com/company/walmart?trk=public_jobs_topcard-org-name",
      "job_posted_time": "4 days ago",
      "job_num_applicants": 25,
      "discovery_input": {
        "experience_level": null,
        "job_type": null,
        "remote": null,
        "selective_search": null,
        "time_range": null
      },
      "apply_link": null,
      "country_code": "US",
      "title_id": "1062",
      "company_logo": "https://media.licdn.com/dms/image/v2/D560BAQHZkPdlecGssw/company-logo_100_100/company-logo_100_100/0/1736779000209/walmart_logo?e=2147483647&v=beta&t=tWcWIFSyHtICTzTLIPiYeKCp21XucI-HWijZdWwYR-A",
      "job_posted_date": "2026-03-13T09:48:59.171Z",
      "job_poster": {
        "name": null,
        "title": null,
        "url": null
      },
      "application_availability": true,
      "job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"5\">\n        <div class=\"show-more-less-html__markup show-more-less-html__markup--clamp-after-5\n            relative overflow-hidden\">\n          Hourly Wage: <strong>$16 - $29 per/hour<br><br></strong><ul><li>The actual hourly rate will equal or exceed the required minimum wage applicable to the job location.<br><br></li></ul><strong>Additional Compensation Includes Annual Or Quarterly Performance Incentives.<br><br></strong>Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met.<br><br>Employment Type: <strong>Part-Time<br><br></strong>Available shifts: <strong>Mid-Shift, Closing<br><br></strong>Location<br><br><strong>Walmart Supercenter #3595<br><br></strong>7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US<br><br><strong>Job Overview<br><br></strong>Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies.<br><br>Benefits &amp; perks<br><br>At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more.<br><br>You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page<br><br>Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam&apos;s Club facilities. Programs range from high school completion to bachelor&apos;s degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart.<br><br>Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com.<br><br>Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment.\n        </div>\n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--more\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-more-html-btn\" aria-label=\"Show more\" aria-expanded=\"false\">\n<!---->\n        \n            Show more\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/cyolgscd0imw2ldqppkrb84vo\"></icon>\n    </button>\n  \n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--less\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-less-html-btn\" aria-label=\"Show less\" aria-expanded=\"true\">\n<!---->\n        \n            Show less\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/4chtt12k98xwnba1nimld2oyg\"></icon>\n    </button>\n  \n<!---->    </section>",
      "base_salary": {
        "currency": "$",
        "max_amount": 29,
        "min_amount": 16,
        "payment_period": "hr"
      },
      "salary_standards": "This range is provided by Walmart. Your actual pay will be based on your skills and experience — talk with your recruiter to learn more.",
      "is_easy_apply": false
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn jobs by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-jobs-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover LinkedIn jobs by a search URL using the Bright Data Scraper API with dataset ID gd_lpfll7v5hcqtkxl6l for paginated job listing results.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lpfll7v5hcqtkxl6l` to collect **Discover Jobs by Job Search URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Direct search link on LinkedIn. For example: by company search
    </ParamField>

    <ParamField type="boolean">
      When set to true, the filter will exclude titles that do not contain the specified keywords
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/jobs/search?keywords=Software&location=Tel%20Aviv-Yafo&geoId=101570771&trk=public_jobs_jobs-search-bar_search-submit&position=1&pageNum=0&f_TPR=r3600"},
      {"url":"https://www.linkedin.com/jobs/semrush-jobs?f_C=2821922"},
      {"url":"https://www.linkedin.com/jobs/reddit-inc.-jobs-worldwide?f_C=150573"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.linkedin.com/jobs/search?keywords=Software&location=Tel%20Aviv-Yafo&geoId=101570771&trk=public_jobs_jobs-search-bar_search-submit&position=1&pageNum=0&f_TPR=r3600"},{"url":"https://www.linkedin.com/jobs/semrush-jobs?f_C=2821922"},{"url":"https://www.linkedin.com/jobs/reddit-inc.-jobs-worldwide?f_C=150573"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lpfll7v5hcqtkxl6l&notify=false&include_errors=true&type=discover_new&discover_by=url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lpfll7v5hcqtkxl6l",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.linkedin.com/jobs/search?keywords=Software&location=Tel%20Aviv-Yafo&geoId=101570771&trk=public_jobs_jobs-search-bar_search-submit&position=1&pageNum=0&f_TPR=r3600",
              },
              {
                  "url": "https://www.linkedin.com/jobs/semrush-jobs?f_C=2821922",
              },
              {
                  "url": "https://www.linkedin.com/jobs/reddit-inc.-jobs-worldwide?f_C=150573",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lpfll7v5hcqtkxl6l",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.linkedin.com/jobs/search?keywords=Software&location=Tel%20Aviv-Yafo&geoId=101570771&trk=public_jobs_jobs-search-bar_search-submit&position=1&pageNum=0&f_TPR=r3600",
        },
        {
          url: "https://www.linkedin.com/jobs/semrush-jobs?f_C=2821922",
        },
        {
          url: "https://www.linkedin.com/jobs/reddit-inc.-jobs-worldwide?f_C=150573",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.linkedin.com/jobs/view/pharmacy-technician-at-walmart-4385163817?_l=en",
      "job_posting_id": "4385163817",
      "job_title": "Pharmacy Technician",
      "company_name": "Walmart",
      "company_id": "2646",
      "job_location": "Fayetteville, NC",
      "job_summary": "Hourly Wage: $16 - $29 per/hour The actual hourly rate will equal or exceed the required minimum wage applicable to the job location. Additional Compensation Includes Annual Or Quarterly Performance Incentives. Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met. Employment Type: Part-Time Available shifts: Mid-Shift, Closing Location Walmart Supercenter #3595 7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US Job Overview Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies. Benefits & perks At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more. You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam's Club facilities. Programs range from high school completion to bachelor's degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart. Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com. Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment. Show more Show less",
      "job_seniority_level": "Entry level",
      "job_function": "Health Care Provider",
      "job_employment_type": "Part-time",
      "job_industries": "Retail",
      "job_base_pay_range": "$16.00/hr - $29.00/hr",
      "company_url": "https://www.linkedin.com/company/walmart?trk=public_jobs_topcard-org-name",
      "job_posted_time": "4 days ago",
      "job_num_applicants": 25,
      "discovery_input": {
        "experience_level": null,
        "job_type": null,
        "remote": null,
        "selective_search": null,
        "time_range": null
      },
      "apply_link": null,
      "country_code": "US",
      "title_id": "1062",
      "company_logo": "https://media.licdn.com/dms/image/v2/D560BAQHZkPdlecGssw/company-logo_100_100/company-logo_100_100/0/1736779000209/walmart_logo?e=2147483647&v=beta&t=tWcWIFSyHtICTzTLIPiYeKCp21XucI-HWijZdWwYR-A",
      "job_posted_date": "2026-03-13T09:48:59.171Z",
      "job_poster": {
        "name": null,
        "title": null,
        "url": null
      },
      "application_availability": true,
      "job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"5\">\n        <div class=\"show-more-less-html__markup show-more-less-html__markup--clamp-after-5\n            relative overflow-hidden\">\n          Hourly Wage: <strong>$16 - $29 per/hour<br><br></strong><ul><li>The actual hourly rate will equal or exceed the required minimum wage applicable to the job location.<br><br></li></ul><strong>Additional Compensation Includes Annual Or Quarterly Performance Incentives.<br><br></strong>Additional compensation in the form of premiums may be paid in amounts ranging from $0.35 per hour to $3.00 per hour in specific circumstances. Premiums may be based on schedule, facility, season, or specific work performed. Multiple premiums may apply if applicable criteria are met.<br><br>Employment Type: <strong>Part-Time<br><br></strong>Available shifts: <strong>Mid-Shift, Closing<br><br></strong>Location<br><br><strong>Walmart Supercenter #3595<br><br></strong>7701 S RAEFORD RD, FAYETTEVILLE, NC, 28304, US<br><br><strong>Job Overview<br><br></strong>Pharmacy associates focus on the needs of our customers as they entrust us with their prescriptions and health needs. They are responsible for inputting and processing prescriptions, supporting patients with product information, and providing customer service in our store pharmacies.<br><br>Benefits &amp; perks<br><br>At Walmart, we offer competitive pay as well as performance-based incentive awards and other great benefits for a happier mind, body, and wallet. Health benefits include medical, vision and dental coverage. Financial benefits include 401(k), stock purchase and company-paid life insurance. Paid time off benefits include parental leave, family care leave, bereavement, jury duty, and voting. Other benefits include short-term and long-term disability, company discounts, Military Leave Pay, adoption and surrogacy expense reimbursement, and more.<br><br>You will also receive PTO and/or PPTO that can be used for vacation, sick leave, holidays, or other purposes. The amount you receive depends on your job classification and length of employment. It will meet or exceed the requirements of paid sick leave laws, where applicable. For information about PTO, see Smart Guide page<br><br>Live Better U is a Walmart-paid education benefit program for full-time and part-time associates in Walmart and Sam&apos;s Club facilities. Programs range from high school completion to bachelor&apos;s degrees, including English Language Learning and short-form certificates. Tuition, books, and fees are completely paid for by Walmart.<br><br>Eligibility requirements apply to some benefits and may depend on your job classification and length of employment. Benefits are subject to change and may be subject to a specific plan or program terms. For information about benefits and eligibility, see One.Walmart.com.<br><br>Walmart is committed to maintaining a drug-free workplace and has a no tolerance policy regarding the use of illegal drugs and alcohol on the job. This policy applies to all employees and aims to create a safe and productive work environment.\n        </div>\n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--more\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-more-html-btn\" aria-label=\"Show more\" aria-expanded=\"false\">\n<!---->\n        \n            Show more\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/cyolgscd0imw2ldqppkrb84vo\"></icon>\n    </button>\n  \n\n        \n\n    \n    \n    \n\n    <button class=\"show-more-less-html__button show-more-less-button\n        show-more-less-html__button--less\n        ml-0.5\" data-tracking-control-name=\"public_jobs_show-less-html-btn\" aria-label=\"Show less\" aria-expanded=\"true\">\n<!---->\n        \n            Show less\n          \n\n          <icon class=\"show-more-less-html__button-icon show-more-less-button-icon\" data-delayed-url=\"https://static.licdn.com/aero-v1/sc/h/4chtt12k98xwnba1nimld2oyg\"></icon>\n    </button>\n  \n<!---->    </section>",
      "base_salary": {
        "currency": "$",
        "max_amount": 29,
        "min_amount": 16,
        "payment_period": "hr"
      },
      "salary_standards": "This range is provided by Walmart. Your actual pay will be based on your skills and experience — talk with your recruiter to learn more.",
      "is_easy_apply": false
    }
  ]
  ```
</ResponseExample>


# Discover new LinkedIn profiles
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-people-discover-new-profiles

POST https://api.brightdata.com/datasets/v3/scrape
Discover new LinkedIn profiles by first and last name using the Bright Data Scraper API with dataset ID gd_m8d03he47z8nwb5xc for prospect research.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m8d03he47z8nwb5xc` to collect **Discover New Profiles** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Must be set to `https://www.linkedin.com`.
    </ParamField>

    <ParamField type="string">
      First name to search by
    </ParamField>

    <ParamField type="string">
      Last name to search by
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {
        "url":"https://www.linkedin.com",
        "first_name":"james",
        "last_name":"smith"
      },
      {
        "url":"https://www.linkedin.com",
        "first_name":"Lisa",
        "last_name":"Ledger"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://linkedin.com/in/muge-ozlutiras",
      "name": "Muge O*******s",
      "subtitle": null,
      "location": "Netherlands",
      "experience": null,
      "education": "ETH Zurich",
      "avatar": "htt***//m***a.l*********dms*********************6XV******************************************************************************************************************************************************************"
    }
  ]
  ```
</ResponseExample>


# Scrape LinkedIn posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url

api-reference/sdk-specs/linkedin-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect LinkedIn Posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/pulse/ab-test-optimisation-earlier-decisions-new-readout-de-b%C3%A9naz%C3%A9?trk=public_profile_article_view"},
      {"url":"https://www.linkedin.com/posts/orlenchner_scrapecon-activity-7180537307521769472-oSYN?trk=public_profile"},
      {"url":"https://www.linkedin.com/posts/karin-dodis_web-data-collection-for-businesses-bright-activity-7176601589682434049-Aakz?trk=public_profile"},
      {"url":"https://www.linkedin.com/pulse/getting-value-out-sunburst-guillaume-de-b%C3%A9naz%C3%A9?trk=public_profile_article_view"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn posts by company URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-discover-by-company-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover LinkedIn posts from a company URL using the Bright Data Scraper API with dataset ID gd_lyy3tktm25m4avu764 for company feed monitoring.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Discover Posts by Company URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `company_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      LinkedIn company url
    </ParamField>

    <ParamField type="string">
      The start\_date input should be in ISO format (`YYYY-MM-DDTHH:MM:SS.sssZ`),

      > For example: `2025-02-12T14:37:05.932Z`
    </ParamField>

    <ParamField type="string">
      The end\_date input should be in ISO format (`YYYY-MM-DDTHH:MM:SS.sssZ`),

      > For example: `2025-02-12T14:37:05.932Z`.
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/company/lanieri"},
      {"url":"https://www.linkedin.com/company/effortel"},
      {"url":"https://www.linkedin.com/company/green-philly"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.linkedin.com/company/lanieri"},{"url":"https://www.linkedin.com/company/effortel"},{"url":"https://www.linkedin.com/company/green-philly"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyy3tktm25m4avu764&notify=false&include_errors=true&type=discover_new&discover_by=company_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lyy3tktm25m4avu764",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "company_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.linkedin.com/company/lanieri",
              },
              {
                  "url": "https://www.linkedin.com/company/effortel",
              },
              {
                  "url": "https://www.linkedin.com/company/green-philly",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lyy3tktm25m4avu764",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "company_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        { url: "https://www.linkedin.com/company/lanieri" },
        { url: "https://www.linkedin.com/company/effortel" },
        {
          url: "https://www.linkedin.com/company/green-philly",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn posts by profile URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-discover-by-profile-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover LinkedIn posts from a profile URL using the Bright Data Scraper API with dataset ID gd_lyy3tktm25m4avu764 for individual feed monitoring.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Discover Posts by Profile URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `profile_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      LinkedIn company url
    </ParamField>

    <ParamField type="string">
      `start_date` to filter by, if filled will only collect posts with publish date
    </ParamField>

    <ParamField type="string">
      `end_date` to filter by, if filled will only collect posts with publish date
    </ParamField>

    <ParamField type="boolean">
      Return only posts created by the profile owner
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {
        "url":"https://www.linkedin.com/in/bettywliu",
        "start_date":"2018-04-25T00:00:00.000Z",
        "end_date":"2021-05-25T00:00:00.000Z"  
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.linkedin.com/in/bettywliu","start_date":"2018-04-25T00:00:00.000Z","end_date":"2021-05-25T00:00:00.000Z"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyy3tktm25m4avu764&notify=false&include_errors=true&type=discover_new&discover_by=profile_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lyy3tktm25m4avu764",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "profile_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.linkedin.com/in/bettywliu",
                  "start_date": "2018-04-25T00:00:00.000Z",
                  "end_date": "2021-05-25T00:00:00.000Z",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lyy3tktm25m4avu764",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "profile_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.linkedin.com/in/bettywliu",
          start_date: "2018-04-25T00:00:00.000Z",
          end_date: "2021-05-25T00:00:00.000Z",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Discover LinkedIn posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-posts-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover a LinkedIn user's posts by URL using the Bright Data Scraper API with dataset ID gd_lyy3tktm25m4avu764 for individual feed scraping.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lyy3tktm25m4avu764` to collect **Discover User's posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn job listing to collect.
    </ParamField>

    <ParamField type="number">
      Set the maximum number of posts to collect
    </ParamField>
  </Expandable>

  #### Example

  ```json theme={null}
  {
    "input":[
      {
        "url":"https://www.linkedin.com/today/author/cristianbrunori?trk=public_post_follow-articles",
        "limit":50
      },
      {
        "url":"https://www.linkedin.com/today/author/stevenouri?trk=public_post_follow-articles"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.linkedin.com/today/author/cristianbrunori?trk=public_post_follow-articles","limit":50},{"url":"https://www.linkedin.com/today/author/stevenouri?trk=public_post_follow-articles"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyy3tktm25m4avu764&notify=false&include_errors=true&type=discover_new&discover_by=url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lyy3tktm25m4avu764",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.linkedin.com/today/author/cristianbrunori?trk=public_post_follow-articles",
                  "limit": 50,
              },
              {
                  "url": "https://www.linkedin.com/today/author/stevenouri?trk=public_post_follow-articles",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lyy3tktm25m4avu764",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.linkedin.com/today/author/cristianbrunori?trk=public_post_follow-articles",
          limit: 50,
        },
        {
          url: "https://www.linkedin.com/today/author/stevenouri?trk=public_post_follow-articles",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

## Response

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://de.linkedin.com/posts/bathildisheim_sport-inklusion-sportf%C3%BCralle-activity-7439619065922625537-K5QL",
      "id": "7439619065922625537",
      "user_id": "bat***dis***m",
      "use_url": "https://de.linkedin.com/company/bathildisheim?trk=public_post_feed-actor-image",
      "title": "#sp*** #i***usi*********für*********************weg************************",
      "headline": "Aus***chn*** fü********* Vi******************",
      "post_text": "Auszeichnung für gelebte Vielfalt im #Sport . Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel. Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird. Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen. Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen. Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport. Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen. #Inklusion #SportFürAlle #bathildisheimbewegt Sebastian Gleim",
      "date_posted": "2026-03-17T10:30:06.724Z",
      "hashtags": [
        "#Sport",
        "#Inklusion",
        "#SportFürAlle",
        "#bathildisheimbewegt"
      ],
      "embedded_links": [
        "https://www.linkedin.com/feed/hashtag/sport",
        "https://www.linkedin.com/feed/hashtag/inklusion",
        "https://www.linkedin.com/feed/hashtag/sportfAeSralle",
        "https://www.linkedin.com/feed/hashtag/bathildisheimbewegt",
        "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text"
      ],
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGI_ALONwR9og/feedshare-shrink_800/B4DZz7WHjuKQAg-/0/1773743405596?e=2147483647&v=beta&t=dXPqg2rYvo3UwNHHx-irACA7lQ7GWovL4egJ3smyH3o"
      ],
      "videos": null,
      "num_likes": 2,
      "num_comments": 0,
      "more_articles_by_user": null,
      "more_relevant_posts": null,
      "top_visible_comments": null,
      "user_followers": 412,
      "user_posts": 0,
      "user_articles": 0,
      "post_type": "post",
      "account_type": "Organization",
      "post_text_html": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.<br/>Gewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.<br/><br/>Die Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.<br/><br/>Bei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.<br/>Die Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.<br/>Ein herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.<br/><br/><a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>",
      "repost": null,
      "tagged_companies": [],
      "tagged_people": [
        {
          "link": "https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text",
          "name": "Sebastian G***m",
          "type": "people"
        }
      ],
      "user_title": null,
      "author_profile_pic": "htt***//m***a.l*********dms*********************mzL************************************************************************************************************************************************************",
      "num_connections": null,
      "video_duration": null,
      "external_link_data": null,
      "video_thumbnail": null,
      "document_cover_image": null,
      "document_page_count": null,
      "original_post_text": "Auszeichnung für gelebte Vielfalt im <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fsport&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Sport</a>. Das Projekt Miteinander bewegt ist gemeinsam mit dem VfL Bad Wildungen mit dem Sonderpreis „Ländlicher Raum“ der Demokratie-Verstärker:innen ausgezeichnet worden. Verliehen wurde der Preis im Rahmen der Initiative „Offen für Vielfalt – Geschlossen gegen Ausgrenzung“ im Regierungspräsidium Kassel.\nGewürdigt wurde das gemeinsame Projekt „Boxen ist für alle da“, das seit knapp einem Jahr im Landkreis Waldeck-Frankenberg angeboten wird.\n\nDie Auszeichnung macht sichtbar, was das Projekt in der Praxis zeigt: Sport ist weit mehr als Bewegung. Sport schafft Begegnung, stärkt Selbstvertrauen und verbindet Menschen mit unterschiedlichen Voraussetzungen. Gerade deshalb ist es wichtig, dass sportliche Angebote allen offenstehen.\n\nBei „Boxen ist für alle da“ trainieren Menschen mit und ohne Behinderung gemeinsam. So entstehen nicht nur sportliche Erfahrungen, sondern auch Teilhabe, Zusammenhalt und ein selbstverständliches Miteinander. Dass dieses Engagement nun besonders für den ländlichen Raum gewürdigt wird, ist ein starkes Zeichen.\nDie Freude über den Preis ist groß. Denn er würdigt den gemeinsamen Einsatz für Inklusion, Vielfalt und demokratisches Miteinander im Sport.\nEin herzlicher Dank gilt allen Beteiligten, Unterstützer:innen und natürlich den Teilnehmenden, die dieses Projekt mit Leben füllen.\n\n<a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Finklusion&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#Inklusion</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2FsportfAeSralle&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#SportFürAlle</a> <a class=\"link\" href=\"https://www.linkedin.com/signup/cold-join?session_redirect=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fhashtag%2Fbathildisheimbewegt&amp;trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>#bathildisheimbewegt</a> <a class=\"link\" href=\"https://de.linkedin.com/in/sebastian-gleim-47063430a?trk=public_post-text\" target=\"_self\" data-tracking-control-name=\"public_post-text\" data-tracking-will-navigate>Sebastian Gleim</a>"
    }
  ]
  ```
</ResponseExample>


# Scrape LinkedIn profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url

api-reference/sdk-specs/linkedin-profiles-collect-by-url POST /datasets/v3/scrape
Collect LinkedIn profile data by URL with the Bright Data Scraper API, dataset_id gd_l1viktl72bvl7bjuj0. Position, experience and education are cached.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1viktl72bvl7bjuj0` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the LinkedIn profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input":[
      {"url":"https://www.linkedin.com/in/elad-moshe-05a90413/"},
      {"url":"https://www.linkedin.com/in/jonathan-myrvik-3baa01109"},
      {"url":"https://www.linkedin.com/in/aviv-tal-75b81/"},
      {"url":"https://www.linkedin.com/in/bulentakar/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "bud***eie***d-a*********",
      "name": "Buddemeier **",
      "city": "Marshfield, Wisconsin, United States",
      "country_code": "US",
      "position": null,
      "about": null,
      "posts": null,
      "current_company": {
        "company_id": "marshfield-clinic-health-system",
        "link": "https://www.linkedin.com/company/marshfield-clinic-health-system?trk=public_profile_topcard-current-company",
        "location": null,
        "name": "Marshfield Clinic"
      },
      "experience": [
        {
          "company": "Marshfield Clinic",
          "company_logo_url": "https://media.licdn.com/dms/image/v2/D560BAQG-SexE0os4Kw/company-logo_100_100/company-logo_100_100/0/1726590593493/marshfield_clinic_health_system_logo?e=2147483647&v=beta&t=dHRCitimMYch4pTLvVukWXMZkhkkRszOlpMekvx9FeQ",
          "description_html": null,
          "subtitle": "************** ************",
          "title": "Marshfield Clinic"
        }
      ],
      "url": "htt***//w***lin*********/in*********************6a",
      "people_also_viewed": [
        {
          "about": "Sou***rn ***ica*********",
          "location": "2K followers Tallahassee Metropolitan Area",
          "name": "Bill D***n",
          "profile_link": "htt***//w***lin*********/in*********************"
        },
        {
          "about": "Car***vas***ar *********ts,******",
          "location": "52 followers Columbus, Ohio Metropolitan Area",
          "name": "Mobusher M****d",
          "profile_link": "htt***//w***lin*********/in*********************459***"
        },
        {
          "about": "Mem***al ***man*********Sys******",
          "location": "301 followers Houston, TX",
          "name": "Danny H*****n",
          "profile_link": "htt***//w***lin*********/in*********************78"
        },
        {
          "about": "IU ***lth***rth*********Cen******",
          "location": "232 followers Fishers, IN",
          "name": "Farooq I*****r",
          "profile_link": "htt***//w***lin*********/in*********************610***"
        },
        {
          "about": "Car***log***lin********* An******",
          "location": "216 followers San Antonio, TX",
          "name": "Jorge A*****z",
          "profile_link": "htt***//w***lin*********/in*********************7"
        },
        {
          "about": "Uni***sit***f C*********ori*********************ine***",
          "location": "141 followers United States",
          "name": "Hafiz H*****n",
          "profile_link": "htt***//w***lin*********/in*********************108***"
        },
        {
          "about": "BJC***alt***yst***",
          "location": "2K followers St Louis, MO",
          "name": "Deepak K***, *** F***, F***I",
          "profile_link": "htt***//w***lin*********/in*********************fsc************"
        },
        {
          "about": "Bap***t H***th *********",
          "location": "309 followers Lexington, KY",
          "name": "Michael S***, *** M**, F***, F***I",
          "profile_link": "htt***//w***lin*********/in*********************fac******************"
        },
        {
          "about": "Val*** Vi***Reg*********pit***",
          "location": "69 followers Glenwood Springs, CO",
          "name": "Marcus H****l",
          "profile_link": "htt***//w***lin*********/in*********************92"
        },
        {
          "about": "Dan***y H***ita***",
          "location": "204 followers Danbury, CT",
          "name": "Hal W*******n",
          "profile_link": "htt***//w***lin*********/in*********************2a"
        },
        {
          "about": "Uni***sit***f K*********ica*********",
          "location": "145 followers Leawood, KS",
          "name": "Eric H******d",
          "profile_link": "htt***//w***lin*********/in*********************62"
        },
        {
          "about": "Tuf***Med***l C******",
          "location": "564 followers Greater Boston",
          "name": "Mohamad E******, M**********M",
          "profile_link": "htt***//w***lin*********/in*********************pvi***************"
        },
        {
          "about": "Ore*** He*** Ce*********",
          "location": "93 followers Salem, OR",
          "name": "Kevin T******n",
          "profile_link": "htt***//w***lin*********/in*********************919***"
        },
        {
          "about": "NEA***pti***Cli******",
          "location": "842 followers Jonesboro, AR",
          "name": "Matthew H*******, **",
          "profile_link": "htt***//w***lin*********/in*********************363******"
        },
        {
          "about": "Adv***te ***lth******",
          "location": "56 followers Greater Chicago Area",
          "name": "Raminder S***h **",
          "profile_link": "htt***//w***lin*********/in*********************473******"
        },
        {
          "about": "Ash*** He*** & *********Cen******",
          "location": "573 followers United States",
          "name": "Farah ** K****n",
          "profile_link": "htt***//w***lin*********/in*********************951***"
        },
        {
          "about": "Met***etr*** Ca*********lar************",
          "location": "253 followers Detroit, MI",
          "name": "Nithin G****m",
          "profile_link": "htt***//w***lin*********/in*********************a6"
        },
        {
          "about": "Mai***ide***edi*********r",
          "location": "383 followers Jericho, NY",
          "name": "Bilal M***k",
          "profile_link": "htt***//w***lin*********/in*********************"
        },
        {
          "about": "Jam***a H***ita***",
          "location": "371 followers New York, NY",
          "name": "Aditya M****a",
          "profile_link": "htt***//w***lin*********/in*********************72"
        }
      ],
      "educations_details": null,
      "education": null,
      "recommendations_count": null,
      "avatar": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
      "courses": null,
      "languages": null,
      "certifications": null,
      "recommendations": null,
      "volunteer_experience": null,
      "followers": 42,
      "connections": 41,
      "current_company_company_id": "marshfield-clinic-health-system",
      "current_company_name": "Marshfield Clinic",
      "publications": null,
      "patents": null,
      "projects": null,
      "organizations": null,
      "location": "Marshfield",
      "input_url": "htt***//w***lin*********/in*********************6a",
      "linkedin_id": "bud***eie***d-a*********",
      "activity": null,
      "linkedin_num_id": "245026690",
      "banner_image": "https://static.licdn.com/aero-v1/sc/h/5q92mjc5c51bjlwaj3rs9aa82",
      "honors_and_awards": null,
      "similar_profiles": [],
      "default_avatar": true,
      "memorialized_account": false,
      "bio_links": [],
      "first_name": "Bud***eie***",
      "last_name": "******",
      "influencer": false
    }
  ]
  ```
</ResponseExample>


# Social media scraper APIs
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/overview

Bright Data Social Media Scraper APIs collect profiles, posts and comments from 10 platforms across 68 dedicated endpoints, including Facebook and LinkedIn.

The Bright Data Social Media Scraper APIs collect profiles, posts, reels, jobs, events and comments from 10 social platforms through 67 dedicated endpoints, with one endpoint per data type and input method.

## Supported platforms

<CardGroup>
  <Card title="Facebook" icon="facebook" href="/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url" />

  <Card title="Instagram" icon="instagram" href="/api-reference/scrapers/social-media-apis/instagram-profiles-collect-by-url" />

  <Card title="LinkedIn" icon="linkedin" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url" />

  <Card title="TikTok" icon="tiktok" href="/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url" />

  <Card title="Reddit" icon="reddit" href="/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url" />

  <Card title="X (Twitter)" icon="x-twitter" href="/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url" />

  <Card title="YouTube" icon="youtube" href="/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url" />

  <Card title="Pinterest" icon="pinterest" href="/api-reference/scrapers/social-media-apis/pinterest" />

  <Card title="Quora" icon="quora" href="/api-reference/scrapers/social-media-apis/quora" />

  <Card title="Vimeo" icon="vimeo" href="/api-reference/scrapers/social-media-apis/vimeo" />
</CardGroup>

## How the endpoints are organized

Each Social Media Scraper API endpoint is dedicated to a single data type and a single input method. Endpoint names follow the pattern `{platform}-{object}-{action}-by-{input}`, for example `instagram-posts-collect-by-url` or `reddit-posts-discover-by-keyword`.

Two action types cover every endpoint:

* **Collect by URL**: you pass one or more canonical URLs and receive the structured record for each target (profile, post, video, job, listing). Use this when you already know what you want.
* **Discover by keyword, username, category or hashtag**: you pass a query and the endpoint returns the matching set of URLs and records. Use this when you need to find items before collecting them.

You can chain the two. Run a `discover` endpoint first to build a URL list, then feed that list into the matching `collect-by-url` endpoint on the same platform.

## Endpoint coverage by platform

| Platform | Endpoints | What you can collect |
| - | - | - |
| Facebook | 15 | Pages, posts, comments, profiles, events, reels, marketplace listings, company reviews |
| Instagram | 8 | Profiles, posts, reels, comments |
| LinkedIn | 10 | Profiles, companies, posts, jobs, people discovery |
| TikTok | 12 | Profiles, posts, comments, TikTok Shop products |
| Reddit | 4 | Posts by URL, subreddit or keyword and post comments |
| X (Twitter) | 5 | Posts and profiles by URL, username or profile array |
| YouTube | 10 | Videos, channels and comments by URL, keyword, hashtag or podcast |
| Pinterest | 1 | Profiles and pins |
| Quora | 1 | Posts and answers |
| Vimeo | 1 | Videos and channels |

## Data types each platform exposes

The endpoints map to three data types that are interconnected, so the output of one can be the input to another:

* **Profiles**: user, page, channel or company data, with metrics such as followers, subscribers and post counts.
* **Posts**: individual posts, reels, videos, jobs or listings, with engagement metrics such as likes, views, comments and hashtags.
* **Comments**: replies and reactions attached to a specific post or video.

### Example: end-to-end YouTube collection

1. Call `youtube-channels-discover-by-keyword` with a search term to find channels.
2. Pass the channel URLs to `youtube-channels-collect-by-url` for channel metadata.
3. Pass the same channel URLs to `youtube-videos-collect-by-url` to fetch videos.
4. Pass the resulting video URLs to `youtube-comments-collect-by-url` to fetch comments.

The same chain pattern applies to every other supported platform.

## Next steps

Pick a platform above to see its dedicated endpoints. If you are new to the Scraper API request model, review [Synchronous requests](/api-reference/scrapers/synchronous-requests) and [Asynchronous requests](/api-reference/rest-api/scraper/asynchronous-requests) first.


# Pinterest API scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/pinterest

Use the Bright Data Scraper API for Pinterest. Submit the request and retrieve the data as structured JSON records once the job completes.

## Overview

The Pinterest API Suite offers multiple types of APIs, each designed for specific data collection needs from Pinterest. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup>
  <Card title="Profiles API" icon="user" href="/api-reference/scrapers/social-media-apis/pinterest#profiles-api">
    This API allows users to collect profile details based on a single input: profile URL.

    <br />

    *   **Discovery functionality**:

    *   Discover by Keywords.

    <br />

    *   **Interesting Columns**:

    *   `name`, `following_count`, `website`, `follower_count`.
  </Card>

  <Card title="Posts API" icon="images" href="/api-reference/scrapers/social-media-apis/pinterest#posts-api">
    This API allows users to collect multiple posts based on a single input.

    <br />

    *   **Discovery functionality**:

      *   - Discover by profile URL.

      *   - Discover by Keywords.

    <br />

    *   **Interesting Columns**:

    *   `title`, `content`, `user_name`, `likes`.
  </Card>
</CardGroup>

## Profiles API

### Collect by URL

This API allows users to retrieve detailed Pinterest profile information using the provided profile URL.

**Input Parameters**:

<ParamField type="string">
  The Pinterest profile URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `url`, `profile_picture`, `name`, `nickname`, `website`, `bio`, `country_code`, `profile_id`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0zv93c2m9qdph46z?tab=overview).

* **Engagement & Metrics**:\
  `following_count`, `follower_count`, `boards_num`, `saved`.

* **Additional Information**:\
  `last_updated`, `posts_page_url`, `discovery_input`.

This API allows users to collect detailed insights into a Pinterest profile, including user statistics, engagement metrics, and profile information.

### Discover by Keywords

This API allows users to discover Pinterest profiles based on a specified keyword.

**Input Parameters**:

<ParamField type="string">
  The keyword to search for profiles.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Profile Details**:\
  `url`, `profile_picture`, `name`, `nickname`, `website`, `bio`, `country_code`, `profile_id`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0zv93c2m9qdph46z/keyword?tab=overview).

* **Engagement & Metric**s:\
  `following_count`, `follower_count`, `boards_num`, saved.

* **Additional Information**:\
  `last_updated`, `posts_page_url`, `discovery_input`.

This API enables users to find Pinterest profiles related to a specific keyword, offering insights into user statistics, engagement, and profile details.

## Posts API

### Collect by URL

This API allows users to collect detailed post data from a specific Pinterest post using the provided post URL.

**Input Parameters**:

<ParamField type="string">
  The Pinterest post URL.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `content`, `date_posted`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0sjs4d21kdr7cnlv?tab=overview).

* **User Details**:\
  `user_name`, `user_url`, `user_id`, `followers`.

* **Post Metrics**:\
  `likes`, `comments_num`, `comments`, `categories`.

* **Media & Attachments**:\
  `image_video_url`, `video_length`, `attached_files`.

* **Hashtags & Discovery**:\
  `hashtags`, `discovery_input`.

This API allows users to retrieve detailed insights into a specific Pinterest post, including user engagement, post content, media, and other related information.

### Discover by Profile URL

This API allows users to retrieve posts from a specific Pinterest profile based on the provided profile URL.

**Input Parameters**:

<ParamField type="string">
  The Pinterest profile URL from which to collect posts.
</ParamField>

<ParamField type="number">
  The number of posts to collect. If omitted, there is no limit.
</ParamField>

<ParamField type="array">
  An array of post IDs to exclude from the results.
</ParamField>

<ParamField type="string">
  Start date for filtering posts in `MM-DD-YYYY` format (should be earlier than `end_date`).
</ParamField>

<ParamField type="string">
  End date for filtering posts in `MM-DD-YYYY` format (should be later than `start_date`).
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `content`, `date_posted`, `user_name`, `user_url`, `user_id`, `followers`, `likes`, `categories`, `source`, `attached_files`, `image_video_url`, `video_length`, `hashtags`, `comments_num`, `comments`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0sjs4d21kdr7cnlv/profile_url?tab=overview).

* **Engagement & Metrics**:\
  `followers`, `likes`, `comments_num`.

* **Media & Attachments**:\
  `image_video_url`, `video_length`, `attached_files`.

* **Additional Information**:\
  `discovery_input`.

This API enables users tso collect posts from a specific Pinterest profile, allowing for filtering by date, exclusion of specific posts, and retrieval of detailed post data including media, comments, and engagement metrics.

### Discover by Keywords

This API allows users to discover Pinterest posts based on a specific keyword, enabling efficient content discovery.

**Input Parameters**:

<ParamField type="string">
  The keyword to search for posts, such as "food" or any other relevant term.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `content`, `date_posted`, `user_name`, `user_url`, `user_id`, `followers`, `likes`, `categories`, `source`, `attached_files`, `image_video_url`, `video_length`, `hashtags`, `comments_num`, `comments`, `post_type`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lk0zv93c2m9qdph46z/keyword?tab=overview).

* **Engagement & Metrics**:\
  `followers`, `likes`, `comments_num`.

* **Media & Attachments**:\
  `image_video_url`, `video_length`, `attached_files`.

* **Additional Information**:\
  `discovery_input`.

This API enables users to search for Pinterest posts based on a specific keyword, providing detailed insights into the content, engagement, media, and associated metrics for efficient discovery.


# Quora API scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/quora

Use the Bright Data Scraper API for Quora. Submit the request and retrieve the data as structured JSON records once the job completes.

## Overview

<CardGroup>
  <Card title="Posts API" icon="images" href="/api-reference/scrapers/social-media-apis/quora#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

    *   N/A

    <br />

    *   **Interesting Columns**:

    *   `author_name`, `title`, `over_all_answers`, `shares`.
  </Card>
</CardGroup>

## Posts API

### Collect by URL

This API allows users to collect detailed information about a specific Quora post using the provided post URL.

**Input Parameters**

<ParamField type="string">
  The URL of the Quora post.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Post Details**:\
  `url`, `post_id`, `title`, `post_date`, `originally_answered`, `over_all_answers`, `post_text`, `header`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lvz1rbj81afv3m6n5y?tab=overview).

* **Media & Links**:\
  `pictures_urls`, `videos_urls`, `external_urls`.

* **Engagement & Metrics**:\
  `upvotes`, `shares`, `views`, `author_content_views`.

* **Author Details**:\
  `author_name`, `author_active_spaces`, `author_joined_date`, `author_about`, `author_education`.

* **Top Comments**:\
  `top_comments`.

This API provides detailed insights into a Quora post, including content, media, author information, and engagement metrics, enabling efficient post analysis and content tracking.


# Scrape Reddit comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-comments-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Reddit comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvzdpsdlw09j6t702` to collect **Comments by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Reddit post or comment thread to collect comments from.
    </ParamField>

    <ParamField type="number">
      Limit results to comments published within this number of days.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/", "days_back": 7},
      {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "comment_id": "k5f7a9b",
      "url": "https://www.reddit.com/r/learnpython/comments/1asdf12/comment/k5f7a9b/",
      "user_posted": "helpful_dev",
      "comment": "Start with the official Python tutorial, it covers the basics well.",
      "date_posted": "2026-03-15T08:42:00Z",
      "num_upvotes": 24,
      "num_replies": 3,
      "replies": [],
      "post_url": "https://www.reddit.com/r/learnpython/comments/1asdf12/",
      "post_id": "1asdf12",
      "post_language": "en",
      "post_state": "active",
      "post_type": "text",
      "images": [],
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "community_description": "Subreddit for posting questions and asking for general advice about your Python code.",
      "community_members_num": 1120000,
      "community_rank": null,
      "is_moderator": false,
      "is_pinned": false,
      "has_bot_in_username": false,
      "is_locked": false,
      "is_admin_post": false,
      "is_archived_post": false,
      "is_moderator_post": false,
      "is_quarantined_post": false,
      "is_not_safe_for_work_post": false,
      "is_eligible_for_content_blocking_post": false,
      "is_promoted_post": false
    }
  ]
  ```
</ResponseExample>


# Scrape Reddit posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-posts-collect-by-url

api-reference/sdk-specs/reddit-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect Reddit posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvz8ah06191smkebj4` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Reddit post to retrieve.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/"},
      {"url": "https://www.reddit.com/r/python/comments/1bsdf34/"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "1asdf12",
      "url": "https://www.reddit.com/r/learnpython/comments/1asdf12/how_do_i_start_learning_python/",
      "user_posted": "example_user",
      "title": "How do I start learning Python?",
      "description": "I'm a complete beginner...",
      "num_upvotes": 1240,
      "num_comments": 86,
      "date_posted": "2026-03-14T18:22:00Z",
      "tag": "Tutorial",
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "community_description": "Subreddit for posting questions and asking for general advice about your Python code.",
      "community_members_num": 1120000,
      "community_rank": null,
      "related_posts": [],
      "comments": [],
      "photos": [],
      "videos": []
    }
  ]
  ```
</ResponseExample>


# Discover Reddit posts by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Discover Reddit posts that match a search keyword with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lvz8ah06191smkebj4.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvz8ah06191smkebj4` to collect **Discover by keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The search term to find relevant posts.
    </ParamField>

    <ParamField type="string">
      The date filter to apply to the search.

      One of: `Past hour`, `Past day`, `Past week`, `Past month`, `Past year`, `All time`
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Omit to retrieve all matching posts.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"keyword": "machine learning", "date": "Past week", "num_of_posts": 100},
      {"keyword": "python tips", "date": "Past month", "num_of_posts": 50}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"keyword":"machine learning","date":"Past week","num_of_posts":100},{"keyword":"python tips","date":"Past month","num_of_posts":50}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "keyword": "machine learning",
                  "date": "Past week",
                  "num_of_posts": 100,
              },
              {
                  "keyword": "python tips",
                  "date": "Past month",
                  "num_of_posts": 50,
              },
          ],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lvz8ah06191smkebj4",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          keyword: "machine learning",
          date: "Past week",
          num_of_posts: 100,
        },
        {
          keyword: "python tips",
          date: "Past month",
          num_of_posts: 50,
        },
      ],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "1bsdf34",
      "url": "https://www.reddit.com/r/MachineLearning/comments/1bsdf34/",
      "user_posted": "ml_researcher",
      "title": "New paper on transformer efficiency",
      "description": "Sharing a recent paper...",
      "num_upvotes": 842,
      "num_comments": 54,
      "date_posted": "2026-04-03T09:14:00Z",
      "tag": "Research",
      "community_name": "MachineLearning",
      "community_url": "https://www.reddit.com/r/MachineLearning",
      "community_description": "Beginners to experts.",
      "community_members_num": 2900000,
      "community_rank": null,
      "related_posts": [],
      "comments": [],
      "photos": [],
      "videos": []
    }
  ]
  ```
</ResponseExample>


# Discover Reddit posts by subreddit URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/reddit-posts-discover-by-subreddit-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover Reddit posts from a subreddit by subreddit URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lvz8ah06191smkebj4.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lvz8ah06191smkebj4` to collect **Discover by subreddit URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `subreddit_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the subreddit to collect posts from.
    </ParamField>

    <ParamField type="string">
      The sort order for returned posts.

      Case-sensitive, matching the labels on Reddit, for example `Hot`. Lowercase `hot` is rejected with a validation error.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.reddit.com/r/learnpython/", "sort_by": "Hot"},
      {"url": "https://www.reddit.com/r/datascience/", "sort_by": "top"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.reddit.com/r/learnpython/","sort_by":"Hot"},{"url":"https://www.reddit.com/r/datascience/","sort_by":"top"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvz8ah06191smkebj4&notify=false&include_errors=true&type=discover_new&discover_by=subreddit_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lvz8ah06191smkebj4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "subreddit_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.reddit.com/r/learnpython/",
                  "sort_by": "Hot",
              },
              {
                  "url": "https://www.reddit.com/r/datascience/",
                  "sort_by": "top",
              },
          ],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lvz8ah06191smkebj4",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "subreddit_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.reddit.com/r/learnpython/",
          sort_by: "Hot",
        },
        {
          url: "https://www.reddit.com/r/datascience/",
          sort_by: "top",
        },
      ],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "1csdf56",
      "url": "https://www.reddit.com/r/learnpython/comments/1csdf56/",
      "user_posted": "newbie_dev",
      "title": "Best resources for learning pandas?",
      "description": "I'm about two weeks into Python...",
      "num_upvotes": 312,
      "num_comments": 41,
      "date_posted": "2026-04-05T14:05:00Z",
      "tag": "Help",
      "community_name": "learnpython",
      "community_url": "https://www.reddit.com/r/learnpython",
      "community_description": "Subreddit for posting questions and asking for general advice about your Python code.",
      "community_members_num": 1120000,
      "community_rank": null,
      "related_posts": [],
      "comments": [],
      "photos": [],
      "videos": []
    }
  ]
  ```
</ResponseExample>


# Scrape TikTok comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-comments-collect-by-url

api-reference/sdk-specs/tiktok-comments-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect TikTok comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lkf2st302ap89utw5k` to collect **Comments by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok post to collect comments from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/@mrbeast/video/7553300000000000000"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_url": "https://www.tiktok.com/@examplecreator/video/7553300000000000000",
      "post_id": "7553300000000000000",
      "post_date_created": "2025-01-15T14:30:00.000Z",
      "date_created": "2025-01-15T16:45:00.000Z",
      "comment_text": "This is amazing content!",
      "num_likes": 1250,
      "num_replies": 15,
      "comment_id": "7553400000000000000",
      "comment_url": "https://www.tiktok.com/@examplecreator/video/7553300000000000000?comment=7553400000000000000",
      "commenter_user_name": "viewer123",
      "commenter_id": "456789012",
      "commenter_url": "https://www.tiktok.com/@viewer123"
    }
  ]
  ```
</ResponseExample>


# Scrape TikTok posts by profile Fast API
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-by-profile-fast-api-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect TikTok posts from a profile URL through the Fast API with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_m7n5v2gq296pex2f5m.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m7n5v2gq296pex2f5m` to collect **Posts by Profile Fast API** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok profile to collect posts from.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      Start date filter in `MM-DD-YYYY` format (should be earlier than `end_date`).
    </ParamField>

    <ParamField type="string">
      End date filter in `MM-DD-YYYY` format (should be later than `start_date`).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.tiktok.com/@mrbeast",
        "num_of_posts": 20,
        "start_date": "01-01-2025",
        "end_date": "03-01-2025"
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7553300000000000000",
      "description": "New challenge video is here #challenge #viral",
      "create_time": "2025-02-01T10:00:00.000Z",
      "share_count": 95000,
      "collect_count": 28000,
      "comment_count": 18000,
      "play_count": 42000000,
      "video_duration": 90,
      "hashtags": [
        "#challenge",
        "#viral"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "examplecreator",
      "profile_url": "https://www.tiktok.com/@examplecreator",
      "is_verified": true
    }
  ]
  ```
</ResponseExample>


# Scrape TikTok posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-collect-by-url

api-reference/sdk-specs/tiktok-posts-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect TikTok posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/@mrbeast/video/7553300000000000000"},
      {"url": "https://www.tiktok.com/@bellapoarch/video/7400000000000000000"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7553300000000000000",
      "description": "This is an example post description #fyp #viral",
      "create_time": "2025-01-15T14:30:00.000Z",
      "share_count": 45000,
      "collect_count": 12000,
      "comment_count": 8500,
      "play_count": 15000000,
      "video_duration": 45,
      "hashtags": [
        "#fyp",
        "#viral"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "examplecreator",
      "profile_url": "https://www.tiktok.com/@examplecreator",
      "is_verified": true
    }
  ]
  ```
</ResponseExample>


# Discover TikTok posts by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover TikTok posts by keyword. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Discover by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for TikTok posts.
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      Specifies what data to collect from each post.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "search_keyword": "cooking recipes",
        "num_of_posts": 20
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"search_keyword":"cooking recipes","num_of_posts":20}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lu702nij2f790tmv9h&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lu702nij2f790tmv9h",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "search_keyword": "cooking recipes",
                  "num_of_posts": 20,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lu702nij2f790tmv9h",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          search_keyword: "cooking recipes",
          num_of_posts: 20,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7500000000000000000",
      "description": "Easy pasta recipe you need to try #cooking #recipes #foodtok",
      "create_time": "2025-02-10T09:15:00.000Z",
      "share_count": 3200,
      "collect_count": 8900,
      "comment_count": 1500,
      "play_count": 5200000,
      "video_duration": 60,
      "hashtags": [
        "#cooking",
        "#recipes",
        "#foodtok"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "homechef",
      "profile_url": "https://www.tiktok.com/@homechef",
      "is_verified": false
    }
  ]
  ```
</ResponseExample>


# Discover TikTok posts by profile URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-discover-by-profile-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover TikTok posts from a profile by profile URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lu702nij2f790tmv9h.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Discover by Profile URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `profile_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok profile to discover posts from.
    </ParamField>

    <ParamField type="number">
      The number of recent posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      Start date filter in `MM-DD-YYYY` format (should be earlier than `end_date`).
    </ParamField>

    <ParamField type="string">
      End date filter in `MM-DD-YYYY` format (should be later than `start_date`).
    </ParamField>

    <ParamField type="string[]">
      Post IDs to exclude from the results.
    </ParamField>

    <ParamField type="string">
      Specifies what data to collect from each post.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.tiktok.com/@mrbeast",
        "num_of_posts": 10,
        "start_date": "01-01-2025",
        "end_date": "03-01-2025"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.tiktok.com/@mrbeast","num_of_posts":10,"start_date":"01-01-2025","end_date":"03-01-2025"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lu702nij2f790tmv9h&notify=false&include_errors=true&type=discover_new&discover_by=profile_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lu702nij2f790tmv9h",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "profile_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.tiktok.com/@mrbeast",
                  "num_of_posts": 10,
                  "start_date": "01-01-2025",
                  "end_date": "03-01-2025",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lu702nij2f790tmv9h",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "profile_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.tiktok.com/@mrbeast",
          num_of_posts: 10,
          start_date: "01-01-2025",
          end_date: "03-01-2025",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7553300000000000000",
      "description": "You won't believe what happened next #challenge",
      "create_time": "2025-01-20T18:00:00.000Z",
      "share_count": 120000,
      "collect_count": 45000,
      "comment_count": 32000,
      "play_count": 85000000,
      "video_duration": 120,
      "hashtags": [
        "#challenge"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "examplecreator",
      "profile_url": "https://www.tiktok.com/@examplecreator",
      "is_verified": true
    }
  ]
  ```
</ResponseExample>


# Discover TikTok posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-posts-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover TikTok posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lu702nij2f790tmv9h` to collect **Discover by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The TikTok discover URL to collect posts from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/tag/cooking"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.tiktok.com/tag/cooking"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lu702nij2f790tmv9h&notify=false&include_errors=true&type=discover_new&discover_by=url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lu702nij2f790tmv9h",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"url": "https://www.tiktok.com/tag/cooking"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lu702nij2f790tmv9h",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ url: "https://www.tiktok.com/tag/cooking" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "post_id": "7480000000000000000",
      "description": "5-minute meal prep ideas #cooking #mealprep",
      "create_time": "2025-03-05T12:00:00.000Z",
      "share_count": 8700,
      "collect_count": 15000,
      "comment_count": 2300,
      "play_count": 9800000,
      "video_duration": 55,
      "hashtags": [
        "#cooking",
        "#mealprep"
      ],
      "video_url": "https://v16-webapp-prime.tiktok.com/video/example.mp4",
      "profile_username": "quickmeals",
      "profile_url": "https://www.tiktok.com/@quickmeals",
      "is_verified": false
    }
  ]
  ```
</ResponseExample>


# Scrape TikTok profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-profiles-collect-by-url

api-reference/sdk-specs/tiktok-profiles-collect-by-url POST /datasets/v3/scrape
Use the Bright Data Scraper API to collect TikTok profiles by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1villgoiiidt09ci` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/@mrbeast"},
      {"url": "https://www.tiktok.com/@charlidamelio"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account_id": "123456789",
      "nickname": "Example Creator",
      "biography": "Content creator and storyteller",
      "bio_link": "https://example.com",
      "is_verified": true,
      "followers": 150000000,
      "following": 800,
      "likes": 3200000000,
      "videos_count": 950,
      "create_time": "2018-05-20T00:00:00.000Z",
      "url": "https://www.tiktok.com/@examplecreator",
      "profile_pic_url": "https://p16-sign-sg.tiktokcdn.com/example-avatar~100x100.jpeg",
      "profile_pic_url_hd": "https://p16-sign-sg.tiktokcdn.com/example-avatar~720x720.jpeg",
      "awg_engagement_rate": 0.0432,
      "is_private": false,
      "region": "US"
    }
  ]
  ```
</ResponseExample>


# Discover TikTok profiles by search URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-profiles-discover-by-search-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover TikTok profiles from a search results URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_l1villgoiiidt09ci.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_l1villgoiiidt09ci` to collect **Discover by Search URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `search_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The TikTok search URL to discover profiles from.
    </ParamField>

    <ParamField type="string">
      The country from which to perform the search.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "search_url": "https://www.tiktok.com/search/user?q=cooking",
        "country": "us"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"search_url":"https://www.tiktok.com/search/user?q=cooking","country":"us"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&notify=false&include_errors=true&type=discover_new&discover_by=search_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_l1villgoiiidt09ci",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "search_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "search_url": "https://www.tiktok.com/search/user?q=cooking",
                  "country": "us",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_l1villgoiiidt09ci",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "search_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          search_url: "https://www.tiktok.com/search/user?q=cooking",
          country: "us",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "account_id": "987654321",
      "nickname": "Cooking Daily",
      "biography": "Easy recipes for busy people",
      "bio_link": "https://example.com/recipes",
      "is_verified": false,
      "followers": 2500000,
      "following": 150,
      "likes": 45000000,
      "videos_count": 320,
      "create_time": "2020-03-15T00:00:00.000Z",
      "url": "https://www.tiktok.com/@cookingdaily",
      "profile_pic_url": "https://p16-sign-sg.tiktokcdn.com/example-avatar~100x100.jpeg",
      "profile_pic_url_hd": "https://p16-sign-sg.tiktokcdn.com/example-avatar~720x720.jpeg",
      "awg_engagement_rate": 0.0521,
      "is_private": false,
      "region": "US"
    }
  ]
  ```
</ResponseExample>


# Scrape TikTok Shop products by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect TikTok Shop product data by product URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_m45m1u911dsa4274pi.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Shop by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok Shop product to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.tiktok.com/view/product/1729000000000000000"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1729000000000000000",
      "title": "Wireless Bluetooth Headphones with Noise Cancellation",
      "price": 29.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 1250,
      "seller_name": "TechGadgets Official",
      "seller_url": "https://www.tiktok.com/@techgadgets",
      "description": "High-quality wireless headphones with active noise cancellation and 30-hour battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg",
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-2.jpeg"
      ],
      "category": "Electronics > Audio > Headphones"
    }
  ]
  ```
</ResponseExample>


# Discover TikTok Shop products by category
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-discover-by-category

POST https://api.brightdata.com/datasets/v3/scrape
Discover TikTok Shop products from a category URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_m45m1u911dsa4274pi.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Discover by Category** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `category_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The TikTok Shop category URL to discover products from.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "category_url": "https://www.tiktok.com/browse/electronics",
        "num_of_products": 20
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"category_url":"https://www.tiktok.com/browse/electronics","num_of_products":20}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m45m1u911dsa4274pi&notify=false&include_errors=true&type=discover_new&discover_by=category_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_m45m1u911dsa4274pi",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "category_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "category_url": "https://www.tiktok.com/browse/electronics",
                  "num_of_products": 20,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_m45m1u911dsa4274pi",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "category_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          category_url: "https://www.tiktok.com/browse/electronics",
          num_of_products: 20,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1730000000000000000",
      "title": "Portable Bluetooth Speaker Waterproof",
      "price": 19.99,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 870,
      "seller_name": "AudioShop",
      "seller_url": "https://www.tiktok.com/@audioshop",
      "description": "Compact waterproof Bluetooth speaker with 12-hour battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg"
      ],
      "category": "Electronics > Audio > Speakers"
    }
  ]
  ```
</ResponseExample>


# Discover TikTok Shop products by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Discover TikTok Shop products that match a search keyword with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_m45m1u911dsa4274pi.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Discover by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for TikTok Shop products.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "wireless earbuds",
        "num_of_products": 15
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"keyword":"wireless earbuds","num_of_products":15}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m45m1u911dsa4274pi&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_m45m1u911dsa4274pi",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "keyword": "wireless earbuds",
                  "num_of_products": 15,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_m45m1u911dsa4274pi",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ keyword: "wireless earbuds", num_of_products: 15 }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1731000000000000000",
      "title": "Wireless Earbuds with Charging Case",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.3,
      "reviews_count": 2100,
      "seller_name": "EarTech Store",
      "seller_url": "https://www.tiktok.com/@eartechstore",
      "description": "True wireless earbuds with touch controls and 24-hour total battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg"
      ],
      "category": "Electronics > Audio > Earbuds"
    }
  ]
  ```
</ResponseExample>


# Discover TikTok Shop products by shop
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/tiktok-shop-discover-by-shop

POST https://api.brightdata.com/datasets/v3/scrape
Discover TikTok Shop products sold by a shop URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_m45m1u911dsa4274pi.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m45m1u911dsa4274pi` to collect **Discover by Shop** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `shop_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the TikTok Shop to discover products from.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "shop_url": "https://www.tiktok.com/@techgadgets/shop",
        "num_of_products": 25
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"shop_url":"https://www.tiktok.com/@techgadgets/shop","num_of_products":25}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m45m1u911dsa4274pi&notify=false&include_errors=true&type=discover_new&discover_by=shop_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_m45m1u911dsa4274pi",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "shop_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "shop_url": "https://www.tiktok.com/@techgadgets/shop",
                  "num_of_products": 25,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_m45m1u911dsa4274pi",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "shop_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          shop_url: "https://www.tiktok.com/@techgadgets/shop",
          num_of_products: 25,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.tiktok.com/view/product/1732000000000000000",
      "title": "Smart Watch Fitness Tracker",
      "price": 39.99,
      "currency": "USD",
      "rating": 4.6,
      "reviews_count": 3400,
      "seller_name": "TechGadgets Official",
      "seller_url": "https://www.tiktok.com/@techgadgets",
      "description": "Fitness tracker with heart rate monitor, sleep tracking, and 7-day battery life.",
      "images": [
        "https://p16-oec-ttp.tiktokcdn-us.com/example-product-1.jpeg"
      ],
      "category": "Electronics > Wearables > Smartwatches"
    }
  ]
  ```
</ResponseExample>


# Scrape X (Twitter) posts by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-posts-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect X (Twitter) posts by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxkxvnf1cynvib9co` to collect **Posts by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the X.com post to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://x.com/elonmusk/status/1234567890123456789"},
      {"url": "https://x.com/OpenAI/status/9876543210987654321"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "2039126434510418303",
      "user_posted": "CozHealsSEN",
      "name": "SENQ Breakfast",
      "description": "LISTEN: North Queensland Cowboys front rower Matt Lodge joins Corey Parker and Andrew McCullough to discuss this weekend's match up against the Dragons",
      "date_posted": "2026-03-31T23:43:21.000Z",
      "photos": ["https://pbs.twimg.com/..."],
      "url": "https://x.com/CozHealsSEN/status/2039126434510418303",
      "quoted_post": null,
      "tagged_users": null,
      "replies": 0,
      "reposts": 4,
      "likes": 7,
      "views": 726,
      "external_url": "https://...",
      "hashtags": null,
      "followers": 814,
      "biography": "QLD brekkie show with Corey Parker & Ian Healy.",
      "posts_count": 4862,
      "profile_image_link": "https://pbs.twimg.com/...",
      "following": 430,
      "is_verified": null,
      "quotes": 0,
      "bookmarks": 0,
      "parent_post_details": {
        "date_posted": "2026-03-31T23:43:21.000Z",
        "post_id": "2039126434510418303",
        "profile_id": "889656535722360833",
        "profile_name": "SENQ Breakfast"
      },
      "videos": null,
      "verification_type": null,
      "user_id": "889656535722360833"
    }
  ]
  ```
</ResponseExample>


# Scrape X (Twitter) profiles by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-profiles-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect X (Twitter) profile data by profile URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lwxmeb2u1cniijd7t4.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxmeb2u1cniijd7t4` to collect **Profiles by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the X.com profile to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://x.com/elonmusk"},
      {"url": "https://x.com/OpenAI"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "x_id": "1077446982",
      "url": "https://x.com/RepRWilliams",
      "id": "RepRWilliams",
      "profile_name": "Rep. Roger Williams",
      "biography": "Chairman of @HouseSmallBiz. Conservative fighting for lower taxes, less regulations, and more freedom for Texans.",
      "is_verified": true,
      "profile_image_link": "https://pbs.twimg.com/...",
      "external_link": "https://williams.house.gov/",
      "date_joined": "2013-01-10T19:21:22.000Z",
      "following": 910,
      "followers": 24746,
      "subscriptions": 0,
      "location": "North Texas",
      "birth_date": null,
      "posts_count": 10434,
      "posts": [
        {
          "date_posted": "2026-04-07T19:10:38.000Z",
          "description": "As Chairman of @HouseSmallBiz, I have seen the positive impact the Working Families Tax Cuts have had on small businesses.",
          "likes": 6,
          "post_id": "2041594516373700624",
          "post_url": "https://x.com/RepRWilliams/status/2041594516373700624",
          "replies": 3,
          "reposts": 3,
          "views": 449
        }
      ],
      "is_business_account": false,
      "is_government_account": false,
      "banner_image": "https://pbs.twimg.com/..."
    }
  ]
  ```
</ResponseExample>


# Discover X (Twitter) profiles by username
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/twitter-profiles-discover-by-username

POST https://api.brightdata.com/datasets/v3/scrape
Discover X (Twitter) profile data by account username with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lwxmeb2u1cniijd7t4.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwxmeb2u1cniijd7t4` to collect **Discover by Username** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `user_name`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The username of the X.com profile.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"user_name": "elonmusk"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"user_name":"elonmusk"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwxmeb2u1cniijd7t4&notify=false&include_errors=true&type=discover_new&discover_by=user_name"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lwxmeb2u1cniijd7t4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "user_name",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"user_name": "elonmusk"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lwxmeb2u1cniijd7t4",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "user_name",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ user_name: "elonmusk" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "x_id": "1077446982",
      "url": "https://x.com/RepRWilliams",
      "id": "RepRWilliams",
      "profile_name": "Rep. Roger Williams",
      "biography": "Chairman of @HouseSmallBiz. Conservative fighting for lower taxes, less regulations, and more freedom for Texans.",
      "is_verified": true,
      "profile_image_link": "https://pbs.twimg.com/...",
      "external_link": "https://williams.house.gov/",
      "date_joined": "2013-01-10T19:21:22.000Z",
      "following": 910,
      "followers": 24746,
      "subscriptions": 0,
      "location": "North Texas",
      "birth_date": null,
      "posts_count": 10434,
      "posts": [
        {
          "date_posted": "2026-04-07T19:10:38.000Z",
          "description": "As Chairman of @HouseSmallBiz, I have seen the positive impact the Working Families Tax Cuts have had on small businesses.",
          "likes": 6,
          "post_id": "2041594516373700624",
          "post_url": "https://x.com/RepRWilliams/status/2041594516373700624",
          "replies": 3,
          "reposts": 3,
          "views": 449
        }
      ],
      "is_business_account": false,
      "is_government_account": false,
      "banner_image": "https://pbs.twimg.com/..."
    }
  ]
  ```
</ResponseExample>


# Vimeo API scrapers
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/vimeo

Use the Bright Data Scraper API for Vimeo. Submit the request and retrieve the data as structured JSON records once the job completes.

## Overview

The Vimeo API Suite offers multiple types of APIs, each designed for specific data collection needs from Vimeo. Below is an overview of how these APIs connect and interact, based on the available features:

<CardGroup>
  <Card title="Posts API" icon="images" href="/api-reference/scrapers/social-media-apis/vimeo#posts-api">
    This API allows users to collect multiple posts based on a single input URL.

    <br />

    *   **Discovery functionality**:

    *   Discover by profile URL.

    *   Discover by Keywords and License.

    <br />

    *   **Interesting Columns**:

    *   `title`, `video_length`, `views`, `likes`.
  </Card>
</CardGroup>

## Posts API

### Collect by URL

This API allows users to collect detailed information about a specific Vimeo video using the provided video URL.

**Input Parameters**

<ParamField type="string">
  The URL of the Vimeo video.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**\
  `video_id`, `title`, `url`, `video_url`, `video_length`, `description`, `data_posted`, `transcript`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lxk88z3v1ketji4pn?tab=overview).

* **Engagement & Metrics**\
  `views`, `likes`, `comments`, `collections`.

* **Uploader Details**\
  `uploader`, `uploader_url`, `uploader_id`, `avatar_img_uploader`.

* **Video Media & Content**\
  `preview_image`, `related_videos`, `music_track`.

* **License & Quality**\
  `license`, `license_info`, `video_quality`.

* **Dimensions**\
  `height`, `width`.

This API provides detailed insights into a Vimeo video, including video content, uploader information, media links, engagement metrics, and more, enabling efficient video analysis and content tracking.

### Discover by URL

This API allows users to discover Vimeo videos based on a specific URL and associated keywords, providing detailed video information and insights.

**Input Parameters**

<ParamField type="string">
  The URL of the Vimeo post.
</ParamField>

<ParamField type="string">
  The keyword to search for within the video's content.
</ParamField>

<ParamField type="number">
  The number of pages of results to collect.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**\
  `video_id`, `title`, `url`, `video_url`, `video_length`, `description`, `data_posted`, `transcript`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lxk88z3v1ketji4pn/url?tab=overview).

* **Engagement & Metrics**\
  `views`, `likes`, `comments`, `collections`.

* **Uploader Details**\
  `uploader`, `uploader_url`, `uploader_id`, `avatar_img_uploader`.

* **Video Media & Content**\
  `preview_image`, `related_videos`, `music_track`.

* **License & Quality**\
  `license`, `license_info`, `video_quality`.

* **Dimensions**\
  `height`, `width`.

This API allows users to discover Vimeo videos by URL and keyword, offering detailed insights into video content, uploader information, and engagement metrics.

### Discover by Keywords and License

This API allows users to discover Vimeo videos based on specific keywords and license types, providing detailed video information and insights.

**Input Parameters**

<ParamField type="string">
  The keyword to search for in the video content.
</ParamField>

<ParamField type="string">
  The license type to filter the videos by (e.g., Creative Commons, Standard License).
</ParamField>

<ParamField type="number">
  The number of pages of results to collect.
</ParamField>

**Output Structure**:\
Includes comprehensive data points:

* **Video Details**\
  `video_id`, `title`,`url`, `video_url`, `video_length`, `description`, `data_posted`, `transcript`.

  > For all data points, [click here](https://brightdata.com/cp/scrapers/gd_lxk88z3v1ketji4pn/keyword_and_license?tab=overview).

* **Engagement & Metrics**\
  `views`, `likes`, `comments`, `collections`.

* **Uploader Details**\
  `uploader`, `uploader_url`, `uploader_id`, `avatar_img_uploader`.

* **Video Media & Content**\
  `preview_image`, `related_videos`, `music_track`.

* **License & Quality**\
  `license`, `license_info`, `video_quality`.

* **Dimensions**\
  `height`, `width`.

This API allows users to discover Vimeo videos based on specific keywords and license types, offering detailed insights into video content, uploader information, and engagement metrics.


# Scrape YouTube channels by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-channels-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect YouTube channel data by channel URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lk538t2k2p1k3oos71.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk538t2k2p1k3oos71` to collect **YouTube channels** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube channel URL to collect data from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/@MrBeast"},
      {"url": "https://www.youtube.com/@PewDiePie"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/@channelname",
      "handle": "@channelname",
      "banner_img": "https://...",
      "profile_image": "https://...",
      "name": "Channel Name",
      "subscribers": 299,
      "Description": "Channel description...",
      "videos_count": 21,
      "created_date": "2024-11-25T00:00:00.000Z",
      "views": 98723,
      "Details": {"location": "United States"},
      "Links": ["youtube.com/@channelname"],
      "identifier": "UC...",
      "id": "UC...",
      "has_podcast": false,
      "top_videos": [
        {
          "Image_url": "https://...",
          "posted_time": "3 weeks ago",
          "title": "Video Title",
          "video_url": "https://www.youtube.com/watch?v=abc",
          "views": 11
        }
      ]
    }
  ]
  ```
</ResponseExample>


# Discover YouTube channels by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-channels-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Discover YouTube channels that match a search keyword with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lk538t2k2p1k3oos71.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk538t2k2p1k3oos71` to collect **Discover Channels by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for YouTube channels.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "cooking tutorials"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"keyword":"cooking tutorials"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk538t2k2p1k3oos71",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"keyword": "cooking tutorials"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk538t2k2p1k3oos71",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ keyword: "cooking tutorials" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/@channelname",
      "handle": "@channelname",
      "banner_img": "https://...",
      "profile_image": "https://...",
      "name": "Channel Name",
      "subscribers": 299,
      "Description": "Channel description...",
      "videos_count": 21,
      "created_date": "2024-11-25T00:00:00.000Z",
      "views": 98723,
      "Details": {"location": "United States"},
      "Links": ["youtube.com/@channelname"],
      "identifier": "UC...",
      "id": "UC...",
      "has_podcast": false,
      "top_videos": [
        {
          "Image_url": "https://...",
          "posted_time": "3 weeks ago",
          "title": "Video Title",
          "video_url": "https://www.youtube.com/watch?v=abc",
          "views": 11
        }
      ]
    }
  ]
  ```
</ResponseExample>


# Scrape YouTube comments by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-comments-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect YouTube comments by URL. Calls the POST /datasets/v3/scrape endpoint and returns a snapshot ID.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk9q0ew71spt1mxywf` to collect **YouTube comments** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube video URL to collect comments from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
      {"url": "https://www.youtube.com/watch?v=4L_m0m3bEtE"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "comment_id": "UgxtjoPOlwN1r91t6OF4AaABAg",
      "comment_text": "Great video!",
      "likes": 2,
      "replies": 0,
      "username": "@username",
      "user_channel": "https://www.youtube.com/@username",
      "date": "1 year ago",
      "url": "https://www.youtube.com/watch?v=abc123",
      "video_id": "abc123",
      "user_id": "UCRmKhm9d3FuhiU6SqW4mbDA"
    }
  ]
  ```
</ResponseExample>


# Scrape YouTube videos by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-collect-by-url

api-reference/sdk-specs/youtube-videos-collect-by-url POST /datasets/v3/scrape
Collect YouTube video data by video URL with the Bright Data Scraper API. Send a POST /datasets/v3/scrape request with dataset_id gd_lk56epmy2i5g7lzu0k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **YouTube videos** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube video URL to collect data from.
    </ParamField>

    <ParamField type="string">
      The country to use for the request.
    </ParamField>

    <ParamField type="string">
      The language for video transcription.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
      {"url": "https://www.youtube.com/watch?v=4L_m0m3bEtE"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover YouTube videos from Explore
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-explore

POST https://api.brightdata.com/datasets/v3/scrape
Discover YouTube videos from the Explore feed URL with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lk56epmy2i5g7lzu0k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Explore** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `explore`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube explore page URL to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/feed/explore"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.youtube.com/feed/explore"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&notify=false&include_errors=true&type=discover_new&discover_by=explore"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk56epmy2i5g7lzu0k",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "explore",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"url": "https://www.youtube.com/feed/explore"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk56epmy2i5g7lzu0k",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "explore",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ url: "https://www.youtube.com/feed/explore" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover YouTube videos by hashtag
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-hashtag

POST https://api.brightdata.com/datasets/v3/scrape
Discover YouTube videos tagged with a hashtag with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lk56epmy2i5g7lzu0k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Hashtag** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `hashtag`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The hashtag to discover YouTube videos for.
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="array">
      An array of post URLs to exclude from the results.
    </ParamField>

    <ParamField type="string">
      The start date for filtering results (MM-DD-YYYY).
    </ParamField>

    <ParamField type="string">
      The end date for filtering results (MM-DD-YYYY).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "hashtag": "trend",
        "num_of_posts": 20
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"hashtag":"trend","num_of_posts":20}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&notify=false&include_errors=true&type=discover_new&discover_by=hashtag"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk56epmy2i5g7lzu0k",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "hashtag",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"hashtag": "trend", "num_of_posts": 20}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk56epmy2i5g7lzu0k",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "hashtag",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ hashtag: "trend", num_of_posts: 20 }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover YouTube videos by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Discover YouTube videos that match a search keyword with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_lk56epmy2i5g7lzu0k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Keyword** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for YouTube videos.
    </ParamField>

    <ParamField type="number">
      The number of posts to collect. Missing value indicates no limit.
    </ParamField>

    <ParamField type="string">
      The start date for filtering results.
    </ParamField>

    <ParamField type="string">
      The end date for filtering results.
    </ParamField>

    <ParamField type="string">
      The country to use for the request.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "popular music",
        "num_of_posts": 20
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"keyword":"popular music","num_of_posts":20}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk56epmy2i5g7lzu0k",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"keyword": "popular music", "num_of_posts": 20}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk56epmy2i5g7lzu0k",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ keyword: "popular music", num_of_posts: 20 }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover YouTube videos by podcast URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-podcast-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover YouTube podcast videos by podcast playlist URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lk56epmy2i5g7lzu0k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Podcast URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `podcast_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube podcast URL to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&notify=false&include_errors=true&type=discover_new&discover_by=podcast_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk56epmy2i5g7lzu0k",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "podcast_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk56epmy2i5g7lzu0k",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "podcast_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover YouTube videos by search filters
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-search-filters

POST https://api.brightdata.com/datasets/v3/scrape
Discover YouTube videos from a filtered search results URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lk56epmy2i5g7lzu0k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by Search Filters** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `search_filters`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube search URL with filters to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/results?search_query=cooking&sp=EgIIAg%253D%253D"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.youtube.com/results?search_query=cooking&sp=EgIIAg%253D%253D"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&notify=false&include_errors=true&type=discover_new&discover_by=search_filters"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk56epmy2i5g7lzu0k",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "search_filters",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.youtube.com/results?search_query=cooking&sp=EgIIAg%253D%253D",
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk56epmy2i5g7lzu0k",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "search_filters",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.youtube.com/results?search_query=cooking&sp=EgIIAg%253D%253D",
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Discover YouTube videos by URL
Source: https://docs.brightdata.com/api-reference/scrapers/social-media-apis/youtube-videos-discover-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Discover YouTube videos from a channel by channel URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lk56epmy2i5g7lzu0k.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lk56epmy2i5g7lzu0k` to collect **Discover Videos by URL** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The YouTube channel or playlist URL to discover videos from.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.youtube.com/@MrBeast"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.youtube.com/@MrBeast"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&notify=false&include_errors=true&type=discover_new&discover_by=url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lk56epmy2i5g7lzu0k",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"url": "https://www.youtube.com/@MrBeast"}],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lk56epmy2i5g7lzu0k",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ url: "https://www.youtube.com/@MrBeast" }],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.youtube.com/watch?v=4L_m0m3bEtE",
      "title": "Video Title Here",
      "youtuber": "@channelname",
      "video_url": "https://...",
      "video_length": 96,
      "likes": 18,
      "views": 1648,
      "date_posted": "2025-04-18T05:26:16.000Z",
      "description": "Video description...",
      "num_comments": 0,
      "subscribers": 4810000,
      "video_id": "4L_m0m3bEtE",
      "channel_url": "https://www.youtube.com/@channelname",
      "preview_image": "https://i.ytimg.com/vi/4L_m0m3bEtE/maxresdefault.jpg",
      "shortcode": "4L_m0m3bEtE",
      "verified": true,
      "handle_name": "Channel Name",
      "is_sponsored": false,
      "quality": "hd1080",
      "transcript": "...",
      "tags": ["tag1", "tag2"],
      "is_age_restricted": false
    }
  ]
  ```
</ResponseExample>


# Synchronous requests
Source: https://docs.brightdata.com/api-reference/scrapers/synchronous-requests

api-reference/dca-api POST /datasets/v3/scrape
Send synchronous requests to the Bright Data Scraper API. POST /datasets/v3/scrape returns the scraped data in a single response, with no snapshot polling.

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"user_name":"zoobarcelona"}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1vikfch901nx3by4&notify=false&include_errors=true&type=discover_new&discover_by=user_name"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_l1vikfch901nx3by4",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "user_name",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={"input": [{"user_name": "zoobarcelona"}], "limit_per_input": None},
  )

  print(response.status_code, response.json())
  ```

  ```javascript Node.js (Axios) theme={null}
  import axios from "axios";

  const response = await axios.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    { input: [{ user_name: "zoobarcelona" }], limit_per_input: null },
    {
      params: {
        dataset_id: "gd_l1vikfch901nx3by4",
        notify: false,
        include_errors: true,
        type: "discover_new",
        discover_by: "user_name",
      },
      headers: { Authorization: "Bearer YOUR_API_KEY" },
    }
  );

  console.log(response.status, response.data);
  ```
</RequestExample>

## How It Works

This synchronous API endpoint allows users to send a scraping request and receive the results in real-time directly in the response, at the point of request - such as a terminal or application - without the need for external storage or manual downloads. This approach streamlines the data collection process by eliminating additional steps for retrieving results.

Set the output format with the `format` query parameter. If no format is provided, the response is NDJSON, one record per line. Set `format=json` to get a JSON array.

## Request body

Send the inputs as an object with an `input` array:

```json theme={null}
{
  "input": [{"user_name": "zoobarcelona"}],
  "limit_per_input": null
}
```

| Field | Type | Description |
| :- | :- | :- |
| `input` | array of objects, required | The inputs to scrape. The fields depend on the scraper, for example `url` or `user_name` |
| `limit_per_input` | integer or `null` | Maximum records returned per input, or `null` |
| `custom_output_fields` | string | Output fields to keep, separated by `\|`, for example `title\|final_price\|url` |

`limit_per_input` matters for discovery requests, whose result count is open-ended. This request discovers posts in a subreddit and stops at three:

```json theme={null}
{
  "input": [{"url": "https://www.reddit.com/r/learnpython/"}],
  "limit_per_input": 3
}
```

Send it with `type=discover_new&discover_by=subreddit_url` on the query string. Put `limit_per_input` in the body, next to `input`. A `limit_per_input` query parameter also caps the results (verified September 30, 2026), but the body is the recommended place.

A bare JSON array of input objects is also accepted and returns the same records. It cannot carry `limit_per_input` or `custom_output_fields`:

```json theme={null}
[{"url": "https://www.amazon.com/dp/B0FQFB8FMG"}]
```

`POST /datasets/v3/trigger` takes the same object body. On that endpoint the object is also where a `deliver` block goes. See [Asynchronous requests](/api-reference/rest-api/scraper/asynchronous-requests).

## Timeout Limit

Please note that this synchronous request is subject to a 1 minute timeout limit. If the data retrieval process exceeds this limit, the API will return an HTTP 202 response, indicating that the request is still being processed. In such cases, you will receive a snapshot ID to monitor and retrieve the results asynchronously via the Monitor Snapshot and Download Snapshot endpoints. The 202 response carries a `retry-after` header (10 seconds at the time of writing) telling you how long to wait before polling.

Example response on timeout:

```JSON 202 theme={null}
{
  "snapshot_id": "sd_m1a2b3c4d5e6f7g8h",
  "message": "Your request is still in progress and cannot be retrieved in this call. Use the provided Snapshot ID to track progress via the Monitor Snapshot endpoint and download it once ready via the Download Snapshot endpoint."
}
```

## How to handle a 202 response

A `/scrape` request that runs past 1 minute answers HTTP 202 with a `snapshot_id` instead of records, and the job continues. Branch on the status code, then poll [Monitor progress](/api-reference/scrapers/management-apis/monitor-progress) and fetch the records with [Download snapshot](/api-reference/scrapers/delivery-apis/download-snapshot). The polling loop is in [How to scrape in bulk with async requests](/products/scrapers/scrapers-library/async-requests#step-2-monitor-progress).

```python Python theme={null}
import requests

response = requests.post(
    "https://api.brightdata.com/datasets/v3/scrape",
    params={"dataset_id": "gd_l7q7dkf244hwjntr0", "format": "json"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"input": [{"url": "https://www.amazon.com/dp/B0FQFB8FMG"}]},
)

if response.status_code == 200:
    print(f"Got {len(response.json())} results")
elif response.status_code == 202:
    print(f"Job running. Snapshot ID: {response.json()['snapshot_id']}")
else:
    response.raise_for_status()
```

A 200 carries the records; a 202 carries the snapshot ID. Any other status is an error, listed under Response below. The fix for each error is on [Scraper API error codes](/products/scrapers/error-codes).

## Custom inputs

You can add custom fields to the input schema. Whatever you send in those fields is returned in the results for each record. Use this to:

* Keep a unified output structure across different scrapers and datasets.
* Pass an `id`, `row_index` or any internal key so you can match results back to your original input rows.


# Terminology
Source: https://docs.brightdata.com/api-reference/terminology

Reference for Bright Data documentation terminology in 2026: API keys, proxies and product names used across the developer docs and thousands of scrapers.

## Zones

Zones are the foundation for how you configure and manage Bright Data products. Each zone represents a specific product or setup, such as Residential, Mobile, Datacenter, or Web Unlocker API. Access your zones [here](https://brightdata.com/cp/zones).

<img alt="bright-data-zones.png" />

### What is a zone?

A zone is a logical container that defines how a Bright Data product behaves. When you enable a product, a corresponding zone is created. Each zone includes its own configuration settings, such as:

* Targeting rules (e.g., country, city, ASN)
* Output format
* Headers and request behavior
* Access permissions

### Using zones in your workflow

You can create multiple zones for the same product to support different use cases, targets, or operational needs. This gives you more control and flexibility when managing traffic.

Example use cases:

* `zone_1` for targeting example.com
* `zone_2` for targeting anotherexample.com

By separating traffic into different zones, you can:

* Apply unique settings per target or workflow
* Monitor usage and performance independently
* Simplify debugging and optimization
* Maintain cleaner, more organized configurations

<Tip>
  You can rename your zones at any time to better reflect their purpose or target.
</Tip>

## Snapshot

Snapshot in Bright Data represent saved state of data collection at the time of trigger. It is used to track, manage, and retrieve the exact data that was collected during a specific run of a dataset.

### What is Snapshot?

A snapshot is a record of a single data collection event. Each time a dataset is triggered, whether manually or via API, a snapshot is created to store the results and the inputs used for that specific run.

Snapshots are especially useful when:

* You need to retrieve historical data from previous runs
* You want to verify what inputs were used to trigger a collection
* You are delivering data in batches and need to track how many parts were generated

### Example Scenarios

* You’ve triggered a dataset to collect product listings from an e-commerce site. A snapshot is automatically created, capturing the results and the inputs (e.g., URL, filters, headers).
* You’ve requested the data to be delivered in batches. You can use the snapshot to check how many parts were generated and ensure the delivery settings match your request.

### Snapshot ID

A Snapshot ID is a unique identifier assigned to a specific data [snapshot](#Snapshot).
Example: `s_manlyn268d2p9hdmx`

## Dataset

A [dataset](https://brightdata.com/products/datasets) in the context of Bright Data refers to a structured collection of data that has been gathered and organized for specific use cases, such as eCommerce, social media, real estate, etc. These datasets are available in the Dataset Marketplace.

### Dataset ID

A Dataset ID is a unique identifier assigned to each [dataset](#dataset) in the Dataset Marketplace. It helps in identifying and accessing specific datasets for data retrieval and management.

You can find all Dataset IDs of all Scraper APIs, you can use the [dataset lists API endpoint](/api-reference/marketplace-dataset-api/get-dataset-list) to retrieve a list of available datasets.


# Bright Data CLI command reference
Source: https://docs.brightdata.com/products/cli/commands

Reference for every Bright Data CLI command across 4 areas (scrape, search, pipelines and config), with flags, global options and copy-paste examples.

## Global options

These flags work with any command:

| Flag | Description |
| - | - |
| `-k, --api-key <key>` | Override API key for this request |
| `--timing` | Show request timing info |
| `-v, --version` | Show CLI version |

***

## `brightdata login`

Authenticate with Bright Data. Opens the browser for OAuth by default.

| Flag | Description |
| - | - |
| `-k, --api-key <key>` | Use API key directly (skips browser) |
| `-c, --customer-id <id>` | Bright Data account ID (optional) |
| `-d, --device` | Use device flow for SSH/headless environments |
| `-g, --github` | Authenticate using the GitHub CLI token (`gh auth token`) |

```bash theme={null}
brightdata login                        # Browser OAuth (recommended)
brightdata login --device               # Headless/SSH environments
brightdata login --api-key <key>        # Direct API key
brightdata login --github               # Reuse the GitHub CLI token
```

<Tip>
  On first login, the CLI automatically creates `cli_unlocker` and `cli_browser` proxy zones and sets sensible defaults.
</Tip>

***

## `brightdata logout`

Clear stored credentials.

```bash theme={null}
brightdata logout
```

***

## `brightdata scrape <url>`

Scrape any URL using Bright Data's Web Unlocker. Handles CAPTCHAs, JavaScript rendering, and anti-bot protections automatically.

| Flag | Description |
| - | - |
| `-f, --format <fmt>` | `markdown` (default), `html`, `screenshot`, `json` |
| `--country <code>` | ISO country code for geo-targeting (e.g. `us`, `de`, `jp`) |
| `--zone <name>` | Web Unlocker zone name |
| `--mobile` | Use a mobile user agent |
| `--async` | Submit async, return a snapshot ID |
| `-o, --output <path>` | Write output to file |
| `--json` | Force JSON output |
| `--pretty` | Pretty-print JSON output |

<CodeGroup>
  ```bash Markdown (default) theme={null}
  brightdata scrape https://news.ycombinator.com
  ```

  ```bash HTML theme={null}
  brightdata scrape https://example.com -f html
  ```

  ```bash JSON with geo-targeting theme={null}
  brightdata scrape https://amazon.com -f json --country us -o product.json
  ```

  ```bash Screenshot theme={null}
  brightdata scrape https://example.com -f screenshot -o page.png
  ```

  ```bash Async mode theme={null}
  brightdata scrape https://example.com --async
  ```

  ```bash Pipe to markdown reader theme={null}
  brightdata scrape https://docs.github.com | glow -
  ```
</CodeGroup>

***

## `brightdata search <query>`

Search Google, Bing, or Yandex via Bright Data's SERP API. Google returns structured JSON with organic results, ads, People Also Ask, and related searches. Bing and Yandex return markdown by default.

| Flag | Description |
| - | - |
| `--engine <name>` | `google` (default), `bing`, `yandex` |
| `--country <code>` | Localized results (e.g. `us`, `de`) |
| `--language <code>` | Language code (e.g. `en`, `fr`) |
| `--page <n>` | Page number, 0-indexed (default: `0`) |
| `--type <type>` | `web` (default), `news`, `images`, `shopping` |
| `--device <type>` | `desktop`, `mobile` |
| `--zone <name>` | SERP zone name |
| `-o, --output <path>` | Write output to file |
| `--json` | Force JSON output |
| `--pretty` | Pretty-print JSON output |

<CodeGroup>
  ```bash Basic search theme={null}
  brightdata search "typescript best practices"
  ```

  ```bash Localized search theme={null}
  brightdata search "restaurants berlin" --country de --language de
  ```

  ```bash News search theme={null}
  brightdata search "AI regulation" --type news
  ```

  ```bash Pagination theme={null}
  brightdata search "web scraping" --page 1
  ```

  ```bash Extract URLs with jq theme={null}
  brightdata search "open source scraping" --json | jq -r '.organic[].link'
  ```

  ```bash Bing search theme={null}
  brightdata search "bright data pricing" --engine bing
  ```
</CodeGroup>

***

## `brightdata pipelines <type> [params...] [options]`

Extract structured data from 40+ platforms. Triggers an async collection job, polls until results are ready, and returns the data.

| Flag | Description |
| - | - |
| `--format <fmt>` | `json` (default), `csv`, `ndjson`, `jsonl` |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `-o, --output <path>` | Write output to file |
| `--json` | Force JSON output |
| `--pretty` | Pretty-print JSON output |

```bash theme={null}
# List all available pipeline types
brightdata pipelines list
```

<CodeGroup>
  ```bash LinkedIn profile theme={null}
  brightdata pipelines linkedin_person_profile "https://linkedin.com/in/username"
  ```

  ```bash Amazon product theme={null}
  brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB"
  ```

  ```bash Amazon search theme={null}
  brightdata pipelines amazon_product_search "laptop" "https://amazon.com"
  ```

  ```bash Instagram profile theme={null}
  brightdata pipelines instagram_profiles "https://instagram.com/username"
  ```

  ```bash YouTube comments theme={null}
  brightdata pipelines youtube_comments "https://youtube.com/watch?v=..." 50
  ```

  ```bash CSV export theme={null}
  brightdata pipelines amazon_product "https://amazon.com/dp/..." --format csv -o product.csv
  ```
</CodeGroup>

### Supported platforms

<AccordionGroup>
  <Accordion title="E-Commerce" icon="cart-shopping">
    | Type | Platform | Parameters |
    | - | - | - |
    | `amazon_product` | Amazon product page | `<url>` |
    | `amazon_product_reviews` | Amazon reviews | `<url>` |
    | `amazon_product_search` | Amazon search results | `<keyword> <domain_url>` |
    | `walmart_product` | Walmart product page | `<url>` |
    | `walmart_seller` | Walmart seller profile | `<url>` |
    | `ebay_product` | eBay listing | `<url>` |
    | `bestbuy_products` | Best Buy | `<url>` |
    | `etsy_products` | Etsy | `<url>` |
    | `homedepot_products` | Home Depot | `<url>` |
    | `zara_products` | Zara | `<url>` |
    | `google_shopping` | Google Shopping | `<url>` |
  </Accordion>

  <Accordion title="Professional Networks" icon="briefcase">
    | Type | Platform | Parameters |
    | - | - | - |
    | `linkedin_person_profile` | LinkedIn person | `<url>` |
    | `linkedin_company_profile` | LinkedIn company | `<url>` |
    | `linkedin_job_listings` | LinkedIn jobs | `<url>` |
    | `linkedin_posts` | LinkedIn posts | `<url>` |
    | `linkedin_people_search` | LinkedIn people search | `<url> <first_name> <last_name>` |
    | `crunchbase_company` | Crunchbase | `<url>` |
    | `zoominfo_company_profile` | ZoomInfo | `<url>` |
  </Accordion>

  <Accordion title="Social Media" icon="hashtag">
    | Type | Platform | Parameters |
    | - | - | - |
    | `instagram_profiles` | Instagram profiles | `<url>` |
    | `instagram_posts` | Instagram posts | `<url>` |
    | `instagram_reels` | Instagram reels | `<url>` |
    | `instagram_comments` | Instagram comments | `<url>` |
    | `facebook_posts` | Facebook posts | `<url>` |
    | `facebook_marketplace_listings` | Facebook Marketplace | `<url>` |
    | `facebook_company_reviews` | Facebook reviews | `<url> [num_reviews]` |
    | `facebook_events` | Facebook events | `<url>` |
    | `tiktok_profiles` | TikTok profiles | `<url>` |
    | `tiktok_posts` | TikTok posts | `<url>` |
    | `tiktok_shop` | TikTok shop | `<url>` |
    | `tiktok_comments` | TikTok comments | `<url>` |
    | `x_posts` | X (Twitter) posts | `<url>` |
    | `youtube_profiles` | YouTube channels | `<url>` |
    | `youtube_videos` | YouTube videos | `<url>` |
    | `youtube_comments` | YouTube comments | `<url> [num_comments]` |
    | `reddit_posts` | Reddit posts | `<url>` |
  </Accordion>

  <Accordion title="Maps, Reviews & Other" icon="map-location-dot">
    | Type | Platform | Parameters |
    | - | - | - |
    | `google_maps_reviews` | Google Maps reviews | `<url> [days_limit]` |
    | `google_play_store` | Google Play | `<url>` |
    | `apple_app_store` | Apple App Store | `<url>` |
    | `github_repository_file` | GitHub repository files | `<url>` |
    | `yahoo_finance_business` | Yahoo Finance | `<url>` |
    | `zillow_properties_listing` | Zillow | `<url>` |
    | `booking_hotel_listings` | Booking.com | `<url>` |
  </Accordion>
</AccordionGroup>

<Tip>
  Run `brightdata pipelines list` in your terminal to see all available types at any time.
</Tip>

***

## `brightdata scraper`

Build, run, and maintain custom [Bright Data Scraper Studio](/products/scraper-studio/build-with-the-cli) scrapers from the terminal. Each scraper is identified by a Collector ID (a `c_*` string) that stays stable across runs and self-healing.

### `brightdata scraper create <url> <description>`

Build a scraper from a natural-language description using Bright Data's AI Agent. Returns a Collector ID.

AI generation typically takes 5 to 15 minutes and can run up to 25 minutes on complex targets.

| Flag | Description |
| - | - |
| `--name <name>` | Scraper template name (default: `cli-scraper-<timestamp>`) |
| `--deliver-webhook <url>` | Webhook URL for the deliver stub (default: `https://example.com/webhook`) |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `--max-retries <n>` | Max retries on the AI-Flow concurrent-job 429 cap (default: `4`) |
| `--no-retry` | Fail immediately on 429 instead of waiting through the cap. Same as `--max-retries 0` |
| `--legacy-output` | Emit the bare AI-progress payload used before v0.3 instead of the envelope below |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output (raw / indented) |
| `--timing` | Show request timing |

```bash theme={null}
# Minimal: a URL plus a description of the data you want
brightdata scraper create https://news.ycombinator.com \
  "Extract top stories: title, url, points, author, comment count"

# Named scraper, with the JSON envelope saved for inspection
brightdata scraper create https://www.ycombinator.com/companies?batch=W26 \
  "For each company card, extract name, vertical, tagline, link" \
  --name yc-w26 --pretty -o create.json
```

#### JSON output from `scraper create`

With `--json`, `--pretty`, `-o` or any non-TTY stream, `scraper create` returns an envelope instead of the human summary:

| Field | Description |
| - | - |
| `collector_id` | Collector ID of the new scraper |
| `name` | Scraper template name |
| `status` | Job status when the response was written |
| `completed_steps` | AI generation steps finished so far |
| `view_url` | Scraper Studio URL for the new collector |
| `created_at` | Creation timestamp, when the API returns one |
| `error` | Failure reason, present only on failure |

`--legacy-output` replaces the envelope with the bare AI-progress payload used before v0.3. Use it only while migrating a script to the envelope.

#### Concurrent job cap on `scraper create`

Bright Data's AI Flow caps how many generation jobs run at once. When your account is at the cap, the API returns HTTP 429 and the CLI waits and retries, four times by default. Each wait grows exponentially with jitter, up to about four minutes between attempts. Raise or lower the count with `--max-retries`, or fail on the first 429 with `--no-retry`.

### `brightdata scraper run <collector_id> [url]`

Run a scraper on one or more URLs and return the data. The CLI tries real-time mode first and falls back to batch mode automatically when a run exceeds the real-time page-load limit.

| Flag | Description |
| - | - |
| `--urls <list>` | Comma-separated list of URLs, sent to `/dca/trigger` as a single batch |
| `--input-file <path>` | File of URLs: one per line, or a JSON array of strings, or a JSON array of `{"url": "..."}` objects. Blank lines and `#` comments are skipped |
| `--sync` | Use the synchronous `/dca/crawl` endpoint, which has a server-side 25 to 50 second cap. Single URL only |
| `--sync-timeout <seconds>` | Sync-mode server timeout, 25 to 50 (default: `50`) |
| `--timeout <seconds>` | Polling timeout in async mode (default: `600`; batch mode: `3600`) |
| `--name <name>` | Human-readable job name |
| `--version <version>` | Scraper version, for example `dev` |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output (raw / indented) |
| `--timing` | Show request timing |

Pass the URL as an argument for a single page, or use `--urls` or `--input-file` to run a batch. Omit the URL argument when you use either batch flag.

```bash theme={null}
# One URL
brightdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --pretty

# Several URLs as one batch job
brightdata scraper run c_mpohus372o5tmid1jk \
  --urls https://news.ycombinator.com,https://news.ycombinator.com/newest

# URLs from a file, one per line
brightdata scraper run c_mpohus372o5tmid1jk --input-file urls.txt

# Sync mode for a small, fast page
brightdata scraper run c_mpohus372o5tmid1jk https://news.ycombinator.com --sync
```

<Note>
  `--sync` cannot be combined with `--urls` or `--input-file`. The `/dca/crawl` endpoint accepts one URL at a time, so drop `--sync` to run a batch.
</Note>

### `brightdata scraper heal <collector_id> <prompt>`

Fix an existing scraper in place via AI self-healing. The Collector ID does not change. By default, `heal` stops at an approval gate and returns `status: "awaiting_approval"` with a `preview_result`.

| Flag | Description |
| - | - |
| `--url <url>` | Verify target woven into the next-step hint. Not sent to the heal call |
| `--auto-approve` | Approve automatically at the gate and poll through to `done` |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `--max-retries <n>` | Max retries on the AI-Flow concurrent-job 429 cap (default: `4`) |
| `--no-retry` | Fail immediately on 429 instead of waiting through the cap |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output (raw / indented) |

```bash theme={null}
brightdata scraper heal c_mpohus372o5tmid1jk \
  "The price field returns null since the redesign. Re-capture price and currency." \
  --url https://example.com/product/1
```

### `brightdata scraper approve <collector_id>`

Commit a heal that is awaiting approval, or reject it with `--reject`.

| Flag | Description |
| - | - |
| `--reject` | Reject the proposed fix instead of approving it |
| `--url <url>` | Verify target woven into the next-step hint on success |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output |

```bash theme={null}
brightdata scraper approve c_mpohus372o5tmid1jk --url https://example.com/product/1
brightdata scraper approve c_mpohus372o5tmid1jk --reject
```

<Warning>
  **Approving is not the same as saving.** A successful `approve` can return exit code 0 and a success message while the healed template is still a development draft, so the next live run serves the pre-heal version. Confirm the fix reached production before you rely on it: re-run the collector and check that the healed field is present in the output, or open the scraper in the Scraper Studio IDE and check it shows **Active** or **Ready** rather than **Draft**. See [Initiate collection and delivery](/products/scraper-studio/initiate-collection-and-delivery-options#how-do-i-save-a-scraper-to-production).
</Warning>

### Heal statuses

`heal` and `approve` report the job through these statuses. Poll until you reach `done` or `error`.

| Status | Meaning | What to do |
| - | - | - |
| `awaiting_approval` | The fix is generated and previewed, waiting on you | Inspect `preview_result`, then run `approve` |
| `pending_answer` | The job is parked on a human decision and the collector keeps serving the old template | Same as `awaiting_approval`: approve or reject. The job does not advance on its own |
| `done` | The heal completed | Verify a live run returns the healed field |
| `error` | The heal failed | Read the failure reason and retry with a more specific prompt |

<Note>
  A heal that reaches `done` confirms a value came back, not that it is the right value. Check the healed field against the live page before trusting it downstream.
</Note>

<Tip>
  The self-healing flow is run, inspect, `heal`, `approve`, re-run. See the [Scraper Studio CLI quickstart](/products/scraper-studio/build-with-the-cli) for a full walkthrough. `scraper heal` and `scraper approve` were added in CLI v0.3.1.
</Tip>

***

## `brightdata status <job-id>`

Check the status of an async snapshot job (from `--async` scrapes or pipeline collections).

| Flag | Description |
| - | - |
| `--wait` | Poll until the job completes |
| `--timeout <seconds>` | Polling timeout (default: `600`) |
| `-o, --output <path>` | Write output to file |
| `--json` / `--pretty` | JSON output |

```bash theme={null}
brightdata status s_abc123xyz
brightdata status s_abc123xyz --wait --pretty
brightdata status s_abc123xyz --wait --timeout 300
```

***

## `brightdata browser`

Control a real browser session powered by Bright Data's [Scraping Browser](/products/scraping-browser/introduction). A lightweight local daemon holds the browser connection open between commands, giving you persistent state without reconnecting on every call.

```bash theme={null}
brightdata browser <subcommand> [options]
```

### Global flags

These flags work with every `browser` subcommand:

| Flag | Description |
| - | - |
| `--session <name>` | Session name for running multiple isolated sessions in parallel (default: `default`) |
| `--country <code>` | Geo-target by ISO country code. On `open`, changing country reconnects the browser |
| `--zone <name>` | Scraping Browser zone (default: `cli_browser`) |
| `--timeout <ms>` | IPC command timeout in milliseconds (default: `30000`) |
| `--idle-timeout <ms>` | Daemon auto-shutdown after idle (default: `600000` / 10 min) |
| `--json` / `--pretty` | JSON output |
| `-o, --output <path>` | Write output to file |

### Subcommands

<AccordionGroup>
  <Accordion title="browser open" icon="globe">
    Navigate to a URL. Starts the daemon and browser session automatically if not already running.

    ```bash theme={null}
    brightdata browser open <url>
    brightdata browser open https://amazon.com --country us --session shop
    ```

    | Flag | Description |
    | - | - |
    | `--country <code>` | Geo-targeting. Reconnects the browser if the country changes on an existing session |
    | `--zone <name>` | Browser zone name |
    | `--idle-timeout <ms>` | Daemon idle timeout for this session |
  </Accordion>

  <Accordion title="browser snapshot" icon="camera">
    Capture the page as a text accessibility tree. This is the primary way AI agents read page content - far more token-efficient than raw HTML.

    Each interactive element gets a `ref` (e.g. `e1`, `e2`) that you pass to `click`, `type`, `fill`, and other interaction commands.

    ```bash theme={null}
    brightdata browser snapshot
    brightdata browser snapshot --compact          # Interactive elements + ancestors only
    brightdata browser snapshot --interactive      # Interactive elements as a flat list
    brightdata browser snapshot --depth 3          # Limit tree depth
    brightdata browser snapshot --selector "main"  # Scope to a CSS subtree
    ```

    **Example output:**

    ```text theme={null}
    Page: Example Domain
    URL: https://example.com

    - heading "Example Domain" [level=1]
    - paragraph "This domain is for use in illustrative examples."
    - link "More information..." [ref=e1]
    ```

    | Flag | Description |
    | - | - |
    | `--compact` | Only interactive elements and their ancestors (70-90% fewer tokens) |
    | `--interactive` | Only interactive elements, as a flat list |
    | `--depth <n>` | Limit tree depth |
    | `--selector <sel>` | Scope snapshot to elements matching a CSS selector |
    | `--wrap` | Wrap output in content boundaries (useful for AI agent prompt injection safety) |
  </Accordion>

  <Accordion title="browser screenshot" icon="image">
    Capture a PNG screenshot of the current viewport.

    ```bash theme={null}
    brightdata browser screenshot
    brightdata browser screenshot ./result.png
    brightdata browser screenshot --full-page -o page.png
    brightdata browser screenshot --base64
    ```

    | Flag | Description |
    | - | - |
    | `[path]` | Where to save the PNG (default: temp directory) |
    | `--full-page` | Capture the full scrollable page, not just the viewport |
    | `--base64` | Output base64-encoded PNG data instead of saving to a file |
  </Accordion>

  <Accordion title="browser click / type / fill" icon="hand-pointer">
    Interact with elements using their snapshot `ref` values.

    ```bash theme={null}
    # Click an element
    brightdata browser click e3

    # Type text into a field (clears first by default)
    brightdata browser type e5 "search query"
    brightdata browser type e5 " more text" --append    # Append to existing value
    brightdata browser type e5 "search query" --submit  # Press Enter after typing

    # Fill a form field directly (no keyboard simulation)
    brightdata browser fill e2 "user@example.com"

    # Select a dropdown option by visible label
    brightdata browser select e4 "United States"

    # Check / uncheck a checkbox or radio button
    brightdata browser check e7
    brightdata browser uncheck e7

    # Hover over an element
    brightdata browser hover e2
    ```

    | Flag (for `type`) | Description |
    | - | - |
    | `--append` | Append to existing value using key-by-key simulation |
    | `--submit` | Press Enter after typing |
  </Accordion>

  <Accordion title="browser scroll" icon="arrows-up-down">
    Scroll the viewport or scroll an element into view.

    ```bash theme={null}
    brightdata browser scroll                          # Scroll down 300px (default)
    brightdata browser scroll --direction up
    brightdata browser scroll --direction down --distance 600
    brightdata browser scroll --ref e10                # Scroll element into view
    ```

    | Flag | Description |
    | - | - |
    | `--direction <dir>` | `up`, `down`, `left`, `right` (default: `down`) |
    | `--distance <px>` | Pixels to scroll (default: `300`) |
    | `--ref <ref>` | Scroll this element into view instead of the viewport |
  </Accordion>

  <Accordion title="browser get text / get html" icon="code">
    Get text or HTML content from the page or a specific element.

    ```bash theme={null}
    # Text content
    brightdata browser get text            # Full page text
    brightdata browser get text "h1"       # Text of the first h1
    brightdata browser get text "#price"   # Text inside #price

    # HTML content
    brightdata browser get html              # Full page outer HTML
    brightdata browser get html ".product"   # innerHTML of .product
    ```
  </Accordion>

  <Accordion title="browser network / cookies / status" icon="network-wired">
    Inspect session state.

    ```bash theme={null}
    # HTTP requests captured since last navigation
    brightdata browser network

    # Cookies for the active session
    brightdata browser cookies

    # Current session state
    brightdata browser status
    brightdata browser status --session shop --pretty

    # List all active sessions
    brightdata browser sessions
    ```
  </Accordion>

  <Accordion title="browser back / forward / reload" icon="rotate">
    Navigation controls.

    ```bash theme={null}
    brightdata browser back
    brightdata browser forward
    brightdata browser reload
    ```
  </Accordion>

  <Accordion title="browser close" icon="xmark">
    Close a session and stop its daemon.

    ```bash theme={null}
    brightdata browser close                    # Close the default session
    brightdata browser close --session shop     # Close a named session
    brightdata browser close --all              # Close all active sessions
    ```
  </Accordion>
</AccordionGroup>

<Note>
  Element `ref` values (e.g. `e1`, `e3`) are re-assigned on every `snapshot` call. After navigating or clicking, take a fresh snapshot before using refs again.
</Note>

***

## `brightdata zones`

List and inspect Bright Data proxy zones.

```bash theme={null}
brightdata zones                        # List all active zones
brightdata zones info <name>            # Full details for a zone
brightdata zones --json -o zones.json   # Export as JSON
brightdata zones info my_zone --pretty  # Pretty-print zone info
```

***

## `brightdata budget`

View account balance and per-zone cost/bandwidth. Read-only.

| Subcommand | Description |
| - | - |
| *(none)* | Quick account balance |
| `balance` | Balance + pending charges |
| `zones` | Cost & bandwidth table for all zones |
| `zone <name>` | Detailed cost & bandwidth for one zone |

| Flag | Description |
| - | - |
| `--from <datetime>` | Start of date range (e.g. `2024-01-01T00:00:00`) |
| `--to <datetime>` | End of date range |
| `--json` / `--pretty` | JSON output |

```bash theme={null}
brightdata budget
brightdata budget balance
brightdata budget zones
brightdata budget zone my_zone
brightdata budget zones --from 2024-01-01T00:00:00 --to 2024-02-01T00:00:00
```

***

## `brightdata config`

View and manage CLI configuration.

| Subcommand | Description |
| - | - |
| *(none)* | Show all config |
| `get <key>` | Get a single value |
| `set <key> <value>` | Set a value |

| Config Key | Description |
| - | - |
| `default_zone_unlocker` | Default zone for `scrape` and `search` |
| `default_zone_serp` | Override zone for `search` only |
| `default_format` | Default output format: `markdown` or `json` |
| `api_url` | Override API base URL |

```bash theme={null}
brightdata config
brightdata config set default_zone_unlocker my_zone
brightdata config set default_format json
brightdata config get default_zone_unlocker
```

***

## `brightdata init`

Interactive setup wizard. Walks through authentication, zone selection, and default configuration.

| Flag | Description |
| - | - |
| `--skip-auth` | Skip the authentication step |
| `-k, --api-key <key>` | Provide API key directly |

```bash theme={null}
brightdata init
```

***

## `brightdata skill`

Install Bright Data AI agent skills into coding agents (Claude Code, Cursor, Copilot, etc.).

| Subcommand | Description |
| - | - |
| `add` | Interactive picker - choose skills + target agents |
| `add <name>` | Install a specific skill directly |
| `list` | List all available skills |

Available skills: `search`, `scrape`, `data-feeds`, `bright-data-mcp`, `bright-data-best-practices`

```bash theme={null}
brightdata skill add              # Interactive picker
brightdata skill add scrape       # Direct install
brightdata skill list             # See what's available
```

***

## `brightdata add mcp`

Add the Bright Data MCP server to Claude Code, Cursor, or Codex. Uses the API key stored by `brightdata login`.

```bash theme={null}
brightdata add mcp                               # Interactive agent + scope prompts
brightdata add mcp --agent claude-code --global
brightdata add mcp --agent claude-code,cursor --project
brightdata add mcp --agent codex --global
```

| Flag | Description |
| - | - |
| `--agent <agents>` | Comma-separated targets: `claude-code`, `cursor`, `codex` |
| `--global` | Install to the agent's global config file |
| `--project` | Install to the current project's config file |

### Config file locations

| Agent | Global path | Project path |
| - | - | - |
| Claude Code | `~/.claude.json` | `.claude/settings.json` |
| Cursor | `~/.cursor/mcp.json` | `.cursor/mcp.json` |
| Codex | `$CODEX_HOME/mcp.json` or `~/.codex/mcp.json` | Not supported |

The command writes the MCP server entry under `mcpServers["bright-data"]`. Existing config is preserved - only the `bright-data` key is added or replaced.

<Warning>
  `brightdata add mcp` uses the API key stored by `brightdata login`. It does not read `BRIGHTDATA_API_KEY` or the `--api-key` flag, so run `brightdata login` first.
</Warning>


# Usage examples
Source: https://docs.brightdata.com/products/cli/examples

Real-world workflows and recipes for the Bright Data CLI, from 1-line scrapes returning clean markdown to scheduled pipelines feeding LLMs.

## How to scrape with the CLI

### Get clean content from any website

```bash theme={null}
# Clean markdown - great for reading or feeding to LLMs
brightdata scrape https://news.ycombinator.com

# Save to file
brightdata scrape https://docs.python.org/3/tutorial/ -o python-tutorial.md

# Get raw HTML for parsing
brightdata scrape https://example.com -f html -o page.html
```

### How to scrape with geo-targeting

```bash theme={null}
# See Amazon prices as a US customer
brightdata scrape https://amazon.com/dp/B09V3KXJPB --country us

# Scrape a German news site from Germany
brightdata scrape https://spiegel.de --country de

# Mobile user agent for mobile-optimized pages
brightdata scrape https://example.com --mobile
```

### How to take screenshots

```bash theme={null}
# Full-page screenshot
brightdata scrape https://example.com -f screenshot -o homepage.png

# Screenshot from a specific country
brightdata scrape https://amazon.co.uk -f screenshot --country gb -o uk-amazon.png
```

***

## How to run search workflows

### Basic web search

```bash theme={null}
# Google search with formatted table output
brightdata search "best web scraping tools 2025"

# Get raw JSON for processing
brightdata search "typescript best practices" --json

# Pretty-print for inspection
brightdata search "AI startups" --pretty
```

### Localized and specialized search

```bash theme={null}
# Local restaurant search from Germany, in German
brightdata search "restaurants berlin" --country de --language de

# News-only results
brightdata search "AI regulation 2025" --type news

# Shopping results
brightdata search "wireless headphones" --type shopping

# Image search
brightdata search "mountain landscape wallpaper" --type images
```

### Pagination

```bash theme={null}
# First page (default)
brightdata search "web scraping tutorials"

# Second page
brightdata search "web scraping tutorials" --page 1

# Third page
brightdata search "web scraping tutorials" --page 2
```

***

## How to run browser workflows

### Navigate and read pages

```bash theme={null}
# Open a page and read its content
brightdata browser open https://example.com
brightdata browser snapshot

# Compact snapshot for AI agents (70-90% fewer tokens)
brightdata browser snapshot --compact

# Scope to a specific section
brightdata browser snapshot --selector "main"
```

### Interact with pages

```bash theme={null}
# Open a page
brightdata browser open https://example.com

# Read the page structure
brightdata browser snapshot --compact

# Click, type, and submit using refs from the snapshot
brightdata browser click e3
brightdata browser type e5 "search query" --submit

# Get updated snapshot after interaction
brightdata browser snapshot --compact

# Take a screenshot for visual verification
brightdata browser screenshot ./result.png

# Clean up
brightdata browser close
```

### How to compare multiple sessions

```bash theme={null}
# Open the same page from different countries
brightdata browser open https://amazon.com --session us --country us
brightdata browser open https://amazon.com --session de --country de

# Capture both snapshots
brightdata browser snapshot --session us --json > us.json
brightdata browser snapshot --session de --json > de.json

# Close all sessions
brightdata browser close --all
```

### Extract content from dynamic pages

```bash theme={null}
# Navigate to a page that requires JavaScript
brightdata browser open https://example.com/dashboard

# Get text content from specific elements
brightdata browser get text "#total-revenue"
brightdata browser get text ".summary-table"

# Get HTML for parsing
brightdata browser get html ".product-grid"

# Check network requests
brightdata browser network
```

***

## Structured data extraction

### How to extract e-commerce data

```bash theme={null}
# Amazon product details
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB"

# Amazon product reviews
brightdata pipelines amazon_product_reviews "https://amazon.com/dp/B09V3KXJPB"

# Amazon search - requires keyword + domain
brightdata pipelines amazon_product_search "wireless headphones" "https://amazon.com"

# Walmart product
brightdata pipelines walmart_product "https://walmart.com/ip/123456"

# Export as CSV
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format csv -o product.csv
```

### Social media profiles

```bash theme={null}
# LinkedIn person
brightdata pipelines linkedin_person_profile "https://linkedin.com/in/username"

# LinkedIn company
brightdata pipelines linkedin_company_profile "https://linkedin.com/company/bright-data"

# Instagram profile
brightdata pipelines instagram_profiles "https://instagram.com/username"

# TikTok profile
brightdata pipelines tiktok_profiles "https://tiktok.com/@username"
```

### Reviews and comments

```bash theme={null}
# Google Maps reviews - last 7 days
brightdata pipelines google_maps_reviews "https://maps.google.com/maps/place/..." 7

# YouTube comments - top 50
brightdata pipelines youtube_comments "https://youtube.com/watch?v=dQw4w9WgXcQ" 50

# Facebook company reviews - 25 reviews
brightdata pipelines facebook_company_reviews "https://facebook.com/company" 25

# Instagram comments
brightdata pipelines instagram_comments "https://instagram.com/p/ABC123"
```

***

## Piping and automation

The CLI is designed to be pipe-friendly. When stdout is not a TTY, colors and spinners are automatically disabled.

### Chain search → scrape

```bash theme={null}
# Search Google, extract the first URL, then scrape it
brightdata search "best python frameworks 2025" --json \
  | jq -r '.organic[0].link' \
  | xargs brightdata scrape
```

### Scrape and read in terminal

```bash theme={null}
# Pipe markdown output to a terminal reader
brightdata scrape https://docs.github.com | glow -

# Or use less
brightdata scrape https://docs.github.com | less
```

### Export to CSV for analysis

```bash theme={null}
# Amazon product data to CSV
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format csv > product.csv

# LinkedIn jobs to CSV
brightdata pipelines linkedin_job_listings "https://linkedin.com/jobs/view/123" --format csv -o jobs.csv
```

### Extract specific fields with jq

```bash theme={null}
# Get just the titles and prices from Amazon search
brightdata pipelines amazon_product_search "laptop" "https://amazon.com" \
  | jq '[.[] | {title, price: .final_price}]'

# Get just organic result URLs from search
brightdata search "web scraping" --json | jq -r '.organic[].link'
```

### Async jobs for heavy workloads

```bash theme={null}
# Submit an async scrape
JOB_ID=$(brightdata scrape https://heavy-page.com --async --json | jq -r '.snapshot_id')

# Do other work...

# Check back later
brightdata status $JOB_ID --wait --pretty
```

***

## How to manage your account

### Monitor costs

```bash theme={null}
# Quick balance check
brightdata budget

# Detailed balance with pending charges
brightdata budget balance

# Cost breakdown by zone
brightdata budget zones

# Specific zone in a date range
brightdata budget zone cli_unlocker --from 2024-01-01T00:00:00 --to 2024-02-01T00:00:00
```

### Manage configuration

```bash theme={null}
# View current config
brightdata config

# Set default output to JSON
brightdata config set default_format json

# Use a custom zone for scraping
brightdata config set default_zone_unlocker my_custom_zone

# Override SERP zone
brightdata config set default_zone_serp my_serp_zone
```

***

## AI agent integration

### Add the MCP server to your coding agent

```bash theme={null}
# Interactive - choose agent and scope
brightdata add mcp

# Add to Claude Code globally
brightdata add mcp --agent claude-code --global

# Add to multiple agents at once
brightdata add mcp --agent claude-code,cursor --project

# Add to Codex
brightdata add mcp --agent codex --global
```

### Install skills into coding agents

```bash theme={null}
# Interactive picker - choose skills and target agents
brightdata skill add

# Install the scraping skill into your agent
brightdata skill add scrape

# Install search capabilities
brightdata skill add search

# See all available skills
brightdata skill list
```

<Tip>
  Skills are pre-packaged bundles of prompts and configuration that teach AI coding agents how to use Bright Data effectively. See [For your coding agent](/quickstart-coding-agent) and [github.com/brightdata/skills](https://github.com/brightdata/skills) for more details.
</Tip>

***

## Supported environment variables

Override any stored configuration with environment variables:

| Variable | Purpose |
| - | - |
| `BRIGHTDATA_API_KEY` | API key (skips login entirely) |
| `BRIGHTDATA_UNLOCKER_ZONE` | Default Web Unlocker zone |
| `BRIGHTDATA_SERP_ZONE` | Default SERP zone |
| `BRIGHTDATA_POLLING_TIMEOUT` | Polling timeout in seconds |
| `BRIGHTDATA_BROWSER_ZONE` | Default Scraping Browser zone (default: `cli_browser`) |
| `BRIGHTDATA_DAEMON_DIR` | Directory for the browser daemon socket and state. Defaults to the CLI config directory for your OS |

```bash theme={null}
# Use in CI/CD without login
BRIGHTDATA_API_KEY=your_key brightdata scrape https://example.com

# Override timeout for large pipeline jobs
BRIGHTDATA_POLLING_TIMEOUT=1200 brightdata pipelines amazon_product "https://amazon.com/dp/..."
```


# Bright Data CLI FAQs
Source: https://docs.brightdata.com/products/cli/faqs

FAQs and troubleshooting for the Bright Data CLI: brightdata and bdata aliases, authentication, installation issues and common errors.

## Frequently asked general questions

<AccordionGroup>
  <Accordion title="What is the difference between `brightdata` and `bdata`?">
    They are identical - `bdata` is a shorthand alias installed alongside `brightdata`. Use whichever you prefer.
  </Accordion>

  <Accordion title="Do I need a Bright Data account to use the CLI?">
    Yes. The CLI connects to Bright Data's infrastructure to handle web requests. You can [sign up for free](https://brightdata.com/?hs_signup=1\&utm_source=docs) and get started with the free tier.
  </Accordion>

  <Accordion title="What platforms can I extract data from?">
    The CLI supports 40+ platforms through the `pipelines` command, including Amazon, LinkedIn, Instagram, TikTok, YouTube, Facebook, Reddit, Google Maps, Walmart, eBay, and many more. Run `brightdata pipelines list` to see the full list.
  </Accordion>

  <Accordion title="What output formats are supported?">
    * **Scrape:** `markdown` (default), `html`, `json`, `screenshot`
    * **Search:** Formatted table (default), `json`, `pretty`
    * **Pipelines:** `json` (default), `csv`, `ndjson`, `jsonl`

    All commands support `-o <path>` to write output to a file.
  </Accordion>

  <Accordion title="Can I use the CLI in scripts and CI/CD pipelines?">
    Yes. The CLI is fully pipe-friendly. When stdout is not a TTY, colors and spinners are automatically disabled. Use `--json` for machine-readable output and `BRIGHTDATA_API_KEY` environment variable for non-interactive authentication.
  </Accordion>
</AccordionGroup>

## Authentication

<AccordionGroup>
  <Accordion title="Where are my credentials stored?">
    Credentials are stored locally on your machine:

    | OS | Path |
    | - | - |
    | macOS | `~/Library/Application Support/brightdata-cli/credentials.json` |
    | Linux | `~/.config/brightdata-cli/credentials.json` |
    | Windows | `%APPDATA%\brightdata-cli\credentials.json` |

    The file is set to mode `0o600` (owner read/write only).
  </Accordion>

  <Accordion title="How do I log in on a remote server without a browser?">
    Use the device flow:

    ```bash theme={null}
    brightdata login --device
    ```

    This prints a URL and a verification code. Open the URL on any device with a browser, enter the code, and authentication completes on the server.
  </Accordion>

  <Accordion title="How do I switch between Bright Data accounts?">
    Run `brightdata logout` followed by `brightdata login` with the new account. Or pass a different API key directly:

    ```bash theme={null}
    brightdata login --api-key <new_key>
    ```
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;No Web Unlocker zone specified&#x22;">
    This means no default zone is configured. Fix it by either:

    ```bash theme={null}
    # Re-run login (auto-creates zones)
    brightdata login

    # Or set a zone manually
    brightdata config set default_zone_unlocker <zone_name>
    ```
  </Accordion>

  <Accordion title="&#x22;Invalid or expired API key&#x22;">
    Your stored API key is no longer valid. Re-authenticate:

    ```bash theme={null}
    brightdata login
    ```
  </Accordion>

  <Accordion title="&#x22;Access denied&#x22;">
    Your API key does not have permission for the requested zone or operation. Check zone permissions in the [Bright Data control panel](https://brightdata.com/cp).
  </Accordion>

  <Accordion title="&#x22;Rate limit exceeded&#x22;">
    You've hit the rate limit for your zone. Options:

    * Wait a moment and retry
    * Use `--async` for large jobs to avoid blocking
    * Contact your account manager to increase limits
  </Accordion>

  <Accordion title="Pipeline job timed out">
    The default polling timeout is 600 seconds (10 minutes). For large datasets, increase it:

    ```bash theme={null}
    # Per-command
    brightdata pipelines amazon_product "<url>" --timeout 1200

    # Via environment variable
    export BRIGHTDATA_POLLING_TIMEOUT=1200
    ```
  </Accordion>

  <Accordion title="Colors or spinners look broken in my terminal">
    The CLI auto-detects TTY support. If detection fails, pipe through `cat` to force plain output:

    ```bash theme={null}
    brightdata scrape https://example.com | cat
    ```

    Or use `--json` for clean, parseable output.
  </Accordion>
</AccordionGroup>

## Frequently asked configuration questions

<AccordionGroup>
  <Accordion title="How do I change the default output format?">
    ```bash theme={null}
    brightdata config set default_format json
    ```

    Valid values: `markdown`, `json`.
  </Accordion>

  <Accordion title="What is the configuration priority order?">
    Settings are resolved in this order (highest priority first):

    1. **CLI flags** - e.g., `--zone my_zone`
    2. **Environment variables** - e.g., `BRIGHTDATA_UNLOCKER_ZONE`
    3. **config.json** - e.g., `default_zone_unlocker`
    4. **Defaults** - built-in fallbacks
  </Accordion>

  <Accordion title="How do I reset all configuration?">
    Delete the configuration directory:

    ```bash theme={null}
    # Linux
    rm -rf ~/.config/brightdata-cli/

    # macOS
    rm -rf ~/Library/Application\ Support/brightdata-cli/
    ```

    Then run `brightdata login` to start fresh.
  </Accordion>
</AccordionGroup>


# Install the Bright Data CLI
Source: https://docs.brightdata.com/products/cli/installation

Install the Bright Data CLI via npm or curl and authenticate your account with an API key in 1 minute. Includes setup verification commands.

## Install the CLI

The fastest way to run the Bright Data CLI is `npx`, which executes the latest version with no global install:

```bash theme={null}
npx -p @brightdata/cli brightdata --version
```

Prefix any command in these docs with `npx -p @brightdata/cli` to run it the same way, with no global dependency to maintain. The Bright Data CLI requires Node.js 20 or later.

For a persistent `brightdata` command and faster startup, install the CLI globally instead:

<CodeGroup>
  ```bash npm (recommended) theme={null}
  npm install -g @brightdata/cli
  ```

  ```bash yarn theme={null}
  yarn global add @brightdata/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @brightdata/cli
  ```
</CodeGroup>

On macOS and Linux, an install script does the same global install and then starts the login flow:

```bash theme={null}
curl -fsSL cli.brightdata.com/install.sh | sh
```

The script checks for Node.js 20 or later, runs `npm install -g @brightdata/cli`, then calls `brightdata login`. It needs npm on your PATH, so it is a shortcut rather than a Node-free install.

Verify a global install:

```bash theme={null}
brightdata --version
```

<Tip>
  The shorthand alias `bdata` is also available, both with `npx -p @brightdata/cli bdata` and after a global install - use whichever you prefer.
</Tip>

## Windows

Running the CLI through `npx` authenticates your session but does not put a `brightdata` or `bdata` binary on your PATH. Install globally if you want a persistent command:

```bash theme={null}
npm install -g @brightdata/cli
```

Calling the CLI from a Python subprocess on Windows fails with `[WinError 2] The system cannot find the file specified`, or `[WinError 193]`, because npm installs a `.cmd` shim that Python cannot execute directly. Three ways round it:

```python theme={null}
import subprocess

# 1. Call the .cmd shim by name
subprocess.run(["bdata.cmd", "scraper", "run", "c_YOUR_COLLECTOR_ID"])

# 2. Route through the shell
subprocess.run("bdata scraper run c_YOUR_COLLECTOR_ID", shell=True)

# 3. Go through cmd /c
subprocess.run(["cmd", "/c", "bdata", "scraper", "run", "c_YOUR_COLLECTOR_ID"])
```

Two more Windows notes:

* PowerShell blocks the npm shim under the default execution policy. Run `Get-ExecutionPolicy` and, if it returns `Restricted`, allow local scripts with `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`.
* The default console code page is cp1252, which raises `UnicodeEncodeError` when scraped pages contain UTF-8. Set `PYTHONUTF8=1`, or run `chcp 65001` before the command.

## Update the CLI

Upgrade to the latest version with the same package manager you installed with:

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @brightdata/cli@latest
  ```

  ```bash yarn theme={null}
  yarn global add @brightdata/cli@latest
  ```

  ```bash pnpm theme={null}
  pnpm add -g @brightdata/cli@latest
  ```
</CodeGroup>

Check your installed version against the latest published version:

```bash theme={null}
brightdata --version           # your installed version
npm view @brightdata/cli version   # latest version on npm
```

<Tip>
  New commands ship in CLI releases. For example, `scraper heal` and `scraper approve` were added in v0.3.1. Run the update command above to pick them up. See the [release notes](https://github.com/brightdata/cli/releases) for what changed in each version.
</Tip>

## Authenticate

Run the login command to connect your Bright Data account:

```bash theme={null}
brightdata login
```

This opens your browser for secure OAuth authentication. Once complete, the CLI:

1. Validates and stores your API key locally
2. Auto-creates required proxy zones (`cli_unlocker`, `cli_browser`)
3. Sets sensible defaults so you can start immediately

<Check>
  You only need to log in **once**. All subsequent commands authenticate automatically.
</Check>

### Alternative authentication methods

<AccordionGroup>
  <Accordion title="Headless / SSH environments" icon="server">
    When no browser is available, use the device flow:

    ```bash theme={null}
    brightdata login --device
    ```

    This prints a URL and a code. Open the URL on any device, enter the code, and the CLI completes authentication.
  </Accordion>

  <Accordion title="Direct API key" icon="key">
    For CI/CD pipelines or non-interactive environments, pass your API key directly:

    ```bash theme={null}
    brightdata login --api-key YOUR_API_KEY
    ```

    You can find your API key in the [Bright Data control panel](https://brightdata.com/cp/setting).
  </Accordion>

  <Accordion title="Environment variable" icon="leaf">
    Set the `BRIGHTDATA_API_KEY` environment variable to skip login entirely:

    ```bash theme={null}
    export BRIGHTDATA_API_KEY=YOUR_API_KEY
    ```

    This is useful for Docker containers, GitHub Actions, and other automated environments.

    <Note>
      The [Bright Data Python SDK](/api-reference/SDK) 2.5.0 and later also reads `BRIGHTDATA_API_KEY`, so one export covers the CLI and the SDK. Older SDK versions read only `BRIGHTDATA_API_TOKEN`.
    </Note>
  </Accordion>
</AccordionGroup>

## Interactive setup wizard

For a guided first-time experience, use the init command:

```bash theme={null}
brightdata init
```

This walks you through authentication, zone selection, and default configuration step by step.

| Flag | Description |
| - | - |
| `--skip-auth` | Skip the authentication step (if already logged in) |
| `-k, --api-key <key>` | Provide API key directly |

## Verify your setup

After logging in, confirm everything is working:

```bash theme={null}
# Check your configuration
brightdata config

# Verify API connectivity
brightdata budget

# Try a quick scrape
brightdata scrape https://example.com
```

## Where configuration is stored

The CLI stores credentials and configuration locally:

| OS | Path |
| - | - |
| macOS | `~/Library/Application Support/brightdata-cli/` |
| Linux | `~/.config/brightdata-cli/` |
| Windows | `%APPDATA%\brightdata-cli\` |

Two files are created:

| File | Purpose | Permissions |
| - | - | - |
| `credentials.json` | API key | `0o600` (owner-only) |
| `config.json` | Zones, output format, preferences | Standard |

<Tip>
  **Priority order for configuration:** CLI flags → Environment variables → `config.json` → Defaults. You can always override any setting on a per-command basis.
</Tip>

## Next steps

<CardGroup>
  <Card title="Commands" icon="code" href="/products/cli/commands">
    Explore the full command reference.
  </Card>

  <Card title="Usage Examples" icon="book-open" href="/products/cli/examples">
    Jump into real-world workflows and recipes.
  </Card>
</CardGroup>


# Bright Data CLI
Source: https://docs.brightdata.com/products/cli/overview

Scrape websites, search the web, extract structured data from 40+ platforms, and manage your Bright Data account from the terminal.

<Card title="Get started in 60 seconds" icon="rocket" href="/products/cli/installation">
  Install the CLI, log in once, and start scraping - CAPTCHAs, anti-bot protections, and JavaScript rendering are handled automatically.
</Card>

## What can you do with the CLI?

<CardGroup>
  <Card title="Scrape any website" icon="globe">
    Get clean markdown, HTML, JSON, or screenshots from any URL - anti-bot bypass and JS rendering included.
  </Card>

  <Card title="Search the web" icon="magnifying-glass">
    Query Google, Bing, or Yandex and get structured results with organic listings, ads, and People Also Ask.
  </Card>

  <Card title="Extract structured data" icon="table">
    Pull product details, profiles, reviews, and more from 40+ platforms like Amazon, LinkedIn, Instagram, and TikTok.
  </Card>

  <Card title="Control a browser" icon="window-maximize">
    Navigate, click, type, screenshot, and read pages using a real remote browser session with persistent state.
  </Card>

  <Card title="Power up AI agents" icon="robot">
    Install skills or add the Bright Data MCP server into Claude Code, Cursor, Codex, and other AI coding agents.
  </Card>

  <Card title="Manage zones & budget" icon="gauge">
    List proxy zones, inspect configurations, and monitor account balance and per-zone costs.
  </Card>

  <Card title="Automate with pipes" icon="pipe-section">
    JSON output, file export, and pipe-friendly design make it easy to chain commands and build workflows.
  </Card>
</CardGroup>

## What the CLI looks like

```bash theme={null}
# Scrape a page as clean markdown
brightdata scrape https://news.ycombinator.com

# Search Google and get structured results
brightdata search "best web scraping tools 2025"


# Extract an Amazon product as JSON
brightdata pipelines amazon_product "https://amazon.com/dp/B09V3KXJPB" --format json

# Control a remote browser session
brightdata browser open https://example.com
brightdata browser snapshot --compact

# Add Bright Data MCP server to your coding agent
brightdata add mcp
```

<Tip>
  The CLI alias `bdata` is available as a shorthand - e.g., `bdata scrape https://example.com`.
</Tip>

## How it works

The Bright Data CLI wraps the full Bright Data web data platform into simple terminal commands. Under the hood, it:

1. **Authenticates once** via OAuth, device flow, or API key - credentials are stored locally and never need to be entered again
2. **Auto-provisions zones** (`cli_unlocker`, `cli_browser`) on first login so you can start immediately
3. **Routes requests** through Bright Data's infrastructure, handling CAPTCHAs, bot detection, IP rotation, and JavaScript rendering
4. **Returns clean output** - formatted tables in the terminal, or structured JSON/CSV/markdown for automation

## Explore CLI resources

<CardGroup>
  <Card title="Installation" icon="download" href="/products/cli/installation">
    Install the CLI and authenticate with Bright Data.
  </Card>

  <Card title="Commands" icon="code" href="/products/cli/commands">
    Full reference for every command, flag, and option.
  </Card>

  <Card title="Usage Examples" icon="book-open" href="/products/cli/examples">
    Real-world workflows and recipes for common tasks.
  </Card>

  <Card title="FAQs" icon="question" href="/products/cli/faqs">
    Answers to common questions and troubleshooting tips.
  </Card>
</CardGroup>

<Check>
  **Zero configuration required.** After a one-time `brightdata login`, every command works out of the box - no tokens to manage, no zones to create, no proxies to configure.
</Check>


# Get browser session
Source: https://docs.brightdata.com/api-reference/browser-api/get-session

GET /browser_sessions/{session_id}
Use the Bright Data Browser API to get a Browser Session. GET /browser_sessions/{session_id} returns 200 OK with session metadata as JSON.



# List browser session
Source: https://docs.brightdata.com/api-reference/browser-api/get-sessions

GET /browser_sessions
Use the Bright Data Browser API to list Browser Sessions. GET /browser_sessions returns 200 OK with active or historical session metadata as JSON.

<Accordion title="Example Usage URLs">
  ```txt Default: last 50 sessions sorted by timestamp desc theme={null}
  https://api.brightdata.com/browser_sessions
  ```

  ```txt Get first 25 finished sessions wrap theme={null}
  https://api.brightdata.com/browser_sessions?limit=25&status=finished
  ```

  ```txt Get all running sessions wrap theme={null}
  https://api.brightdata.com/browser_sessions?status=running
  ```

  ```txt Get all failed sessions wrap theme={null}
  https://api.brightdata.com/browser_sessions?status=failed
  ```

  ```txt Get sessions from a specific API zone wrap theme={null}
  https://api.brightdata.com/browser_sessions?api_name=scraping_browser1
  ```

  ```txt Sessions from a specific date range wrap theme={null}
  https://api.brightdata.com/browser_sessions?start_date=2025-12-01T00:00:00Z&end_date=2025-12-16T23:59:59Z
  ```

  ```txt Sessions for a specific target URL sorted by bandwidth wrap theme={null}
  https://api.brightdata.com/browser_sessions?target_url=example.com&sort=bandwidth&order=desc
  ```

  ```txt All sessions for a specific target URL wrap theme={null}
  https://api.brightdata.com/browser_sessions?target_url=amazon.com
  ```

  ```txt Failed sessions for a specific target URL wrap theme={null}
  https://api.brightdata.com/browser_sessions?target_url=linkedin.com&status=failed
  ```

  ```txt Sessions sorted by highest bandwidth wrap theme={null}
  https://api.brightdata.com/browser_sessions?sort=bandwidth&order=desc
  ```

  ```txt Sessions sorted by longest duration wrap theme={null}
  https://api.brightdata.com/browser_sessions?sort=duration&order=desc
  ```

  ```txt First page (100 sessions) wrap theme={null}
  https://api.brightdata.com/browser_sessions?limit=100&offset=0
  ```

  ```txt Second page (next 100 sessions) wrap theme={null}
  https://api.brightdata.com/browser_sessions?limit=100&offset=100
  ```
</Accordion>


# Bulk update view delivery settings
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/bulk-update-view-delivery-settings

api-reference/dca-api PUT /datasets/views/delivery_settings/bulk
Apply one delivery configuration to multiple Bright Data dataset views in a single request. Spans 250+ domains in the Bright Data marketplace.

Updates the delivery configuration for every view in the `views` array. All listed views receive the same `deliver`, `filename`, `tar`, `compress` and `batch_size` values, so use this endpoint when you want several views to deliver to the same destination with identical packaging rules.

<Note>
  To update a single view, use [Update view delivery settings](/api-reference/marketplace-dataset-api/update-view-delivery-settings) instead.
</Note>

The `deliver` object must match the schema returned by [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) for the destination you select. The response returns `view_ids`, the full list of views that were updated.


# Deliver snapshot
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/deliver-snapshot

api-reference/dca-api POST /datasets/snapshots/{id}/deliver
Use the Bright Data Marketplace Dataset API to deliver a Snapshot. POST /datasets/snapshots/{id}/deliver returns 200 OK with metadata as JSON.

<AccordionGroup>
  <Accordion title="Before you begin" icon="circle-info">
    You need a **Snapshot ID** to use this endpoint. A Snapshot ID (e.g., `snap_m2bxug4e2o352v1jv1`) is a unique identifier created each time a data collection is triggered or a dataset is filtered.

    ### Where do Snapshot IDs come from?

    | Source | Endpoint | What it returns |
    | :- | :- | :- |
    | [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files) | `POST` `/datasets/filter` | `snapshot_id` in the response body |
    | [Trigger Collection](/api-reference/rest-api/scraper/asynchronous-requests) | `POST` `/datasets/v3/trigger` | `snapshot_id` in the response body |
    | Dataset Subscription | Automatic delivery schedule | Snapshot IDs are generated per scheduled run |
    | [Snapshot List](/api-reference/scrapers/management-apis/get-snapshots) | `GET` `/datasets/v3/snapshots` | List of all snapshots with their IDs |

    <Tip>
      If you don't have a Snapshot ID yet, start by filtering a dataset [Filter Dataset](/api-reference/marketplace-dataset-api/filter-dataset) or [triggering a collection](/api-reference/rest-api/scraper/asynchronous-requests) first. The response will include the `snapshot_id` you need.
    </Tip>

    You can check snapshot status before delivering:

    ```sh theme={null}
    curl "https://api.brightdata.com/datasets/snapshots/snap_m2bxug4e2o352v1jv1" \
      -H "Authorization: Bearer YOUR_API_KEY"
    ```

    The snapshot must be in `ready` status before delivery.

    > See [Get Snapshot Metadata](/api-reference/marketplace-dataset-api/get-snapshot-meta) for full documentation.
  </Accordion>

  <Accordion title="Tracking delivery status" icon="clock">
    The `id` returned in the response is a **delivery job ID**. Use it to monitor whether your delivery has completed, failed, or been canceled.

    <CodeGroup>
      ```sh Endpoint theme={null}
      GET https://api.brightdata.com/datasets/v3/delivery/{delivery_id}
      ```

      ```sh Example theme={null}
      curl "https://api.brightdata.com/datasets/v3/delivery/del_abc123xyz" \
        -H "Authorization: Bearer YOUR_API_KEY"
      ```

      ```json Response theme={null}
      {
        "id": "del_abc123xyz",
        "status": "done",
        "delivery_files": [
          {
            "filename": "my-data.json",
            "delivery_ts": 1709000000
          }
        ]
      }
      ```
    </CodeGroup>

    | Field | Type | Description |
    | - | - | - |
    | `id` | string | The delivery job ID |
    | `status` | string | Delivery status: done, canceled, or failed |
    | `delivery_files` | array | List of delivered files with filename and delivery timestamp |

    <Tip>
      Poll this endpoint until status is "done". For large snapshots with `batch_size` set, `delivery_files` will contain multiple entries, one per batch file.
    </Tip>

    > See [Monitor Delivery](/api-reference/scrapers/management-apis/monitor-delivery) for full documentation.
  </Accordion>

  <Accordion title="End-to-end workflow" icon="arrows-left-right">
    Here's the complete flow from triggering a collection to receiving your data:

    <Steps>
      <Step title="Trigger a collection or filter a dataset">
        This creates a snapshot and returns a `snapshot_id`.

        <CodeGroup>
          ```sh Request theme={null}
          curl -X POST "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l1viktl72bvl7bjuj0" \
            -H "Authorization: Bearer YOUR_API_KEY" \
            -H "Content-Type: application/json" \
            -d '[{"url": "https://example.com/product/123"}]'
          ```

          ```Response theme={null}
          {"snapshot_id": "snap_m2bxug4e2o352v1jv1"}
          ```
        </CodeGroup>
      </Step>

      <Step title="Wait for the snapshot to be ready">
        Poll the snapshot metadata endpoint until status is "ready".

        <CodeGroup>
          ```sh Request theme={null}
          curl "https://api.brightdata.com/datasets/snapshots/snap_m2bxug4e2o352v1jv1" \
            -H "Authorization: Bearer YOUR_API_KEY"
          ```

          ```json Response theme={null}
          {
            "status": "ready",
            "dataset_size": 50000,
            "file_size": 250000000
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Deliver the snapshot">
        Call this endpoint with the snapshot ID and your delivery configuration.

        <CodeGroup>
          ```sh Request theme={null}
          curl -X POST "https://api.brightdata.com/datasets/snapshots/snap_m2bxug4e2o352v1jv1/deliver" \
            -H "Authorization: Bearer YOUR_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{
                "deliver": {
                  "type": "webhook",
                  "filename": {"template": "my-data", "extension": "json"},
                  "endpoint": "https://example.com/webhook"
                }
            }'
          ```

          ```json Response theme={null}
          {
            "id": "del_abc123xyz"
          }
          ```
        </CodeGroup>
      </Step>

      <Step title="Track the delivery">
        Use the delivery job ID to monitor progress.

        <CodeGroup>
          ```sh Request theme={null}
          curl "https://api.brightdata.com/datasets/v3/delivery/del_abc123xyz" \
            -H "Authorization: Bearer YOUR_API_KEY"
          ```

          ```json Response theme={null}
          {
            "id": "del_abc123xyz",
            "status": "done",
            "delivery_files": [...]
          }
          ```
        </CodeGroup>
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>


# Snapshot content
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/download-the-file-by-snapshot_id

api-reference/dca-api GET /datasets/snapshots/{id}/download
Use the Bright Data Marketplace Dataset API to download Snapshot Content. GET /datasets/snapshots/{id}/download returns 200 OK with metadata as JSON.



# Filter dataset (BETA)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-dataset

api-reference/dca-api POST /datasets/filter
Run async filter jobs on 250+ Bright Data Marketplace datasets. Returns a snapshot_id to download, with CSV/JSON uploads up to 200 MiB.

The Filter endpoint of the Bright Data Marketplace Dataset API runs a large or file-based filter job against any of 250+ Marketplace datasets and returns a `snapshot_id` you can download once the job completes.

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## When should I use Filter?

Use Filter for bulk or file-driven jobs where asynchronous processing is acceptable:

* Bulk exports of more than 1,000 records.
* Filtering against large value lists from CSV or JSON files, such as excluding 100k+ company IDs.
* Datasets not yet supported by Search.
* Scheduled or background pipelines where async is fine.

For sub-second real-time lookups on supported datasets, use [Search](/api-reference/marketplace-dataset-api/search-dataset) instead.

## How does Filter work?

* A call to the Filter endpoint starts an async job and creates a snapshot of the filtered data in your account.
* The maximum job time is 5 minutes. Jobs that run longer are cancelled.
* Charges apply per record in the snapshot, at the standard Marketplace rate of \$2.5 CPM.
* Filter works on all 250+ Marketplace datasets.
* Filter groups support a maximum nesting depth of 3 levels.

## How do I authenticate?

Filter uses Bearer token authentication. Pass your API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Get your key from [account settings](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).

## Limits

| Limit | Value | Description |
| - | - | - |
| **Max rows per file** | 10,000 | Each uploaded CSV/JSON file can contain up to 10,000 data rows. The header row is not counted. |
| **Max files per request** | No limit | Attach as many files as needed in one multipart request, as long as the total stays within the 200 MiB cap. |
| **Max request size** | 200 MiB | Total size of all uploaded files and form data combined. Requests over 200 MiB are rejected. |
| **Job timeout** | 5 minutes | If filtering does not complete within 5 minutes the job is cancelled. |
| **Filter nesting depth** | 3 levels | Maximum depth for nested filter groups using `and`/`or`. |
| **Max parallel jobs** | 100 per dataset | Up to 100 Filter jobs can run at once per dataset. |
| **Rate limit** | 120 requests/hour | Maximum number of Filter API calls per hour. |

## How do I call Filter?

Filter has two modes: JSON for plain filters and multipart for file uploads.

### JSON mode (no file uploads)

Send all parameters (`dataset_id`, `records_limit` and `filter`) in the JSON body. Set `Content-Type` to `application/json`:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/filter" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dataset_id": "gd_l1viktl72bvl7bjuj0",
    "records_limit": 100,
    "filter": {
      "name": "name",
      "operator": "=",
      "value": "John"
    }
  }'
```

Filter returns a `snapshot_id`:

```json theme={null}
{ "snapshot_id": "s_abc123..." }
```

### Multipart mode (file uploads)

Send `dataset_id` and `records_limit` as query parameters, and send `filter` and the uploaded files in the form-data body. Set `Content-Type` to `multipart/form-data`:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije&records_limit=100" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F 'filter={"operator":"and","filters":[{"name":"industries:value","operator":"includes","value":"industries.csv"}]}' \
  -F 'files[]=@/path/to/industries.csv'
```

To exclude 100k+ values, split them into files of up to 10,000 rows each and attach them all in a single request:

```bash theme={null}
curl -X POST "https://api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije&records_limit=5000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F 'filter={"operator":"and","filters":[{"name":"company_id","operator":"not_in","value":"exclude1.csv"},{"name":"company_id","operator":"not_in","value":"exclude2.csv"},{"name":"company_id","operator":"not_in","value":"exclude3.csv"}]}' \
  -F 'files[]=@exclude1.csv' \
  -F 'files[]=@exclude2.csv' \
  -F 'files[]=@exclude3.csv'
```

For CSV and JSON file format rules, file references and upload troubleshooting, see [Filter dataset with CSV/JSON files](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files).

## What does Filter return?

Filter returns a `snapshot_id`. Use it to download the filtered records via the snapshot API once the job completes:

* [Get snapshot metadata](/api-reference/marketplace-dataset-api/get-snapshot-meta)
* [Download the file by snapshot\_id](/api-reference/marketplace-dataset-api/download-the-file-by-snapshot_id)

## How much does Filter cost?

Filter costs \$2.5 CPM (per 1,000 records returned), the same rate as the Marketplace. There is no charge when the filter returns 0 records.

## What errors can Filter return?

| Status | Meaning | What to do |
| - | - | - |
| `400` | Bad filter or params | Check field names with [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata). |
| `401` | Bad or missing API key | Check your Bearer token. |
| `402` | Not enough funds | Top up your balance or reduce `records_limit`. |
| `404` | Unknown `dataset_id` | Confirm the dataset ID. |
| `422` | Filter matched 0 records | Loosen your filter or check field values. |
| `429` | Too many parallel jobs (max 100 per dataset) or rate limit hit (120 requests/hour) | Back off and retry. |

## Filter syntax

The `filter` object, its operators, filter groups and nesting rules are shared with the [Search endpoint](/api-reference/marketplace-dataset-api/search-dataset) and documented in one place. See the [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax) for the full operator list, filter groups, up to three levels of nesting and CSV/JSON file references.

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Search dataset (sync)](/api-reference/marketplace-dataset-api/search-dataset)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Filter dataset with CSV/JSON files](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files)
* [Get dataset metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Filter dataset (JSON or file uploads)
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files

api-reference/filter-csv-json POST /datasets/filter
Use the Bright Data Marketplace Dataset API to filter Dataset (JSON or File Uploads). Spans 250+ domains in the Bright Data marketplace.

The Filter endpoint of the Bright Data Marketplace Dataset API can filter a dataset against thousands of values stored in a CSV or JSON file. Upload one or more files in multipart mode and reference each filename in your filter.

<Tip>
  Paste your API key into the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## How does file-based filtering work?

Use file uploads when you need to filter against large value lists, such as including or excluding 100k+ company IDs:

* Upload CSV or JSON files in `multipart/form-data` mode and reference each filename in your filter.
* Each file holds up to 10,000 data rows, and the whole request can be up to 200 MiB.
* The Filter job runs asynchronously and returns a `snapshot_id` to download once it completes.

For the async job flow, limits, pricing and error codes, see [Filter dataset (async)](/api-reference/marketplace-dataset-api/filter-dataset).

## How do I format the CSV or JSON file?

<Tabs>
  <Tab title="CSV">
    * First line must be a header matching the field name in your filter.
    * Each following line contains a single value.

    ```csv Example: industries.csv theme={null}
    industries:value
    Accounting
    Ad Network
    Advertising
    ```
  </Tab>

  <Tab title="JSON">
    * Must be an array of objects, each with a key matching the field name in your filter.

    ```json Example industries.json theme={null}
    [
      {"industries:value": "Accounting"},
      {"industries:value": "Ad Network"},
      {"industries:value": "Advertising"}
    ]
    ```
  </Tab>
</Tabs>

***

## How do I reference a file in the filter?

When using file uploads, set the filter's `value` field to the filename:

```json Example theme={null}
{
  "operator": "and",
  "filters": [
    {
      "name": "industries:value",
      "operator": "includes",
      "value": "industries.csv"
    }
  ]
}
```

File references work only with the operators `in`, `not_in`, `includes`, `not_includes`, `array_includes` and `not_array_includes`. For the full operator table and field types, see the [filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax#which-operators-read-csv-or-json-files%3F).

***

## Filter with multiple files

```bash theme={null}
curl \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "files[]=@/path/to/industries.csv" \
  -F "files[]=@/path/to/regions.csv" \
  -F "filter={\"operator\":\"and\",\"filters\":[{\"name\":\"industries:value\",\"operator\":\"includes\",\"value\":\"industries.csv\"},{\"name\":\"region\",\"operator\":\"in\",\"value\":\"regions.csv\"}]}" \
  "https://api.brightdata.com/datasets/filter?dataset_id=gd_l1vijqt9jfj7olije"
```

## Troubleshoot file uploads

| Issue | Possible Solution |
| :- | :- |
| **"File not found"** | Make sure the filename in your filter exactly matches the uploaded file name. |
| **"Invalid file format"** | Check CSV header matches the filter field name, or ensure JSON is an array of objects. |
| **"Field not found"** | Verify field exists in dataset. Use [Get Dataset Metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata). |

## Related

* [Dataset API overview](/api-reference/marketplace-dataset-api/overview)
* [Filter dataset (async)](/api-reference/marketplace-dataset-api/filter-dataset)
* [Filter syntax reference](/api-reference/marketplace-dataset-api/filter-syntax)
* [Get Dataset List](/api-reference/marketplace-dataset-api/get-dataset-list)
* [Get Dataset Metadata](/api-reference/marketplace-dataset-api/get-dataset-metadata)


# Dataset list
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-list

api-reference/dca-api GET /datasets/list
List every Bright Data dataset ID for all Web Scraper APIs available on your account. Spans 250+ domains in the Bright Data marketplace.



# Get dataset metadata
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-metadata

api-reference/dca-api GET /datasets/{dataset_id}/metadata
Use the Bright Data Marketplace Dataset API to get Dataset Metadata. GET /datasets/{dataset_id}/metadata returns 200 OK with snapshot metadata as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## General Description

* This endpoint retrieves detailed metadata for a specific dataset.
* Metadata includes available fields, data types, and descriptions.
* Use this endpoint to understand the structure of a dataset before querying or downloading it.

## Request

### **Endpoint**

```http theme={null}
GET https://api.brightdata.com/datasets/{dataset_id}/metadata
```

### **Path Parameters**

| Parameter | Type | Description |
| - | - | - |
| `dataset_id` | `string` | The unique identifier of the dataset |

### **Headers**

| Header | Type | Description |
| - | - | - |
| `Authorization` | string | Your API key for authentication |

## Response

### **Response Example**

```json theme={null}
{
    "id": "gd_l1vijqt9jfj7olije",
    "fields": {
        "name": {
            "type": "text",
            "active": true,
            "description": "The name of the company"
        },
        "url": {
            "type": "url",
            "required": true,
            "description": "The URL or web address associated with the company"
        },
        "cb_rank": {
            "type": "number",
            "description": "Crunchbase rank assigned to the company"
        }
    }
}
```

### **Response Fields**

| Field | Type | Description |
| - | - | - |
| `id` | `string` | Unique identifier for the dataset |
| `fields` | `object` | Contains metadata about each field in the dataset |

### **Field Metadata**

Each field in the `fields` object contains the following attributes:

| Attribute | Type | Description |
| - | - | - |
| `type` | `string` | Data type of the field (e.g., `text`, `number`, `url`) |
| `active` | `boolean` | Indicates if the field is currently active |
| `required` | `boolean` | Indicates if the field is mandatory (if applicable) |
| `description` | `string` | Brief description of the field |

## Example Use Case

### **Fetching Dataset Metadata**

To retrieve metadata for the "Crunchbase companies information" dataset:

#### **Request**

```http theme={null}
GET https://api.brightdata.com/datasets/gd_l1vijqt9jfj7olije/metadata
```

#### **Response**

```json theme={null}
{
    "id": "gd_l1vijqt9jfj7olije",
    "fields": {
        "name": {
            "type": "text",
            "active": true,
            "description": "The name of the company"
        },
        "url": {
            "type": "url",
            "required": true,
            "description": "The URL or web address associated with the company"
        },
        "cb_rank": {
            "type": "number",
            "description": "Crunchbase rank assigned to the company"
        }
    }
}
```

## Troubleshooting & FAQs

### **Issue: "Unauthorized" response**

**Solution**: Ensure you have included a valid API key in the request header.

### **Issue: "Dataset not found"**

**Solution**: Verify that the `dataset_id` is correct and exists in the dataset list.

### **Issue: "Field missing in metadata"**

**Solution**: Some fields may be inactive or unavailable for certain datasets.

## Related Documentation

* [Get Dataset List](/api-reference/marketplace-dataset-api/get-dataset-list)
* [Dataset Filtering API](/api-reference/marketplace-dataset-api/filter-dataset-with-csv-json-files)


# Get dataset views
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-dataset-views

api-reference/dca-api GET /datasets/views
List your dataset views with IDs, names and underlying dataset across 250+ domains so you can configure or update delivery settings for each subscription.

A dataset view is a saved, filtered subscription to a Bright Data marketplace dataset that delivers fresh records to your destination on a recurring schedule. Each view has a unique `id` (for example `v_id1`) which you pass to the view delivery settings endpoints.

Use the `id` returned here with:

* [Get view delivery settings](/api-reference/marketplace-dataset-api/get-view-delivery-settings) to inspect the current configuration.
* [Update view delivery settings](/api-reference/marketplace-dataset-api/update-view-delivery-settings) to change it.
* [Bulk update view delivery settings](/api-reference/marketplace-dataset-api/bulk-update-view-delivery-settings) to apply one configuration to many views at once.


# Get delivery options
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-delivery-options

api-reference/dca-api GET /datasets/delivery_settings/options
List the supported delivery destinations, filename templates and batch settings you can use when configuring delivery for a dataset view. Covers 250+ domains.

Use this endpoint before configuring a dataset view delivery to discover which destination types are supported and which fields the filename and batch parameters accept. The response is the canonical source of truth. Supported destinations currently include `api_pull`, `webhook`, `email`, `gcs`, `gcp_pubsub`, `s3`, `snowflake`, `ali_oss`, `sftp` and `azure`.

Call [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) next to retrieve the required fields for the specific destination you want to use.


# Get destination type schema
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-destination-type-schema

api-reference/dca-api GET /datasets/delivery_settings/{destination_type}/schema
Retrieve the exact fields and credentials required to configure a specific delivery destination type such as s3, sftp, gcs or webhook.

Each delivery destination supported by Bright Data has its own field set. For example, `s3` requires a `bucket` and either an access key/secret pair or an IAM role ARN plus external ID, while `sftp` requires host and credential fields. Call this endpoint with the destination type you plan to use, then supply the returned fields in the `deliver` object when you call [Update view delivery settings](/api-reference/marketplace-dataset-api/update-view-delivery-settings).

<Tip>
  Use [Get delivery options](/api-reference/marketplace-dataset-api/get-delivery-options) first to list the valid values you can pass as `destination_type`.
</Tip>

## Example credential payloads and permissions

The values shown below are sample values. Replace them with your real credentials before sending a request.

Use [Get delivery options](/api-reference/marketplace-dataset-api/get-delivery-options) to list the supported `destination_type` values. Then call this endpoint with the selected `destination_type` and pass the required fields in the `deliver` object.

For cloud storage destinations, Bright Data may validate that delivered files are readable after upload. Make sure the credentials include the provider-specific upload and read permissions listed below. If read permission is missing, delivery upload may succeed, but read-after-upload validation can fail.

### Amazon S3

```json theme={null}
"credentials": {
  "aws-access-key": "<AWS_ACCESS_KEY_ID>",
  "aws-secret-key": "<AWS_SECRET_ACCESS_KEY>"
}
```

Required permissions:

* `s3:PutObject`
* `s3:GetObject`

For restrictive multipart upload policies, multipart-related permissions may also be required, such as `s3:AbortMultipartUpload` and `s3:ListMultipartUploadParts`.

### Amazon S3 with IAM role

```json theme={null}
"credentials": {
  "role_arn": "<AWS_ROLE_ARN>",
  "external_id": "<EXTERNAL_ID>"
}
```

Required permissions:

* `s3:PutObject`
* `s3:GetObject`

For restrictive multipart upload policies, multipart-related permissions may also be required, such as `s3:AbortMultipartUpload` and `s3:ListMultipartUploadParts`.

The IAM role trust policy must allow Bright Data’s delivery role to assume the customer role using the provided external ID.

### Azure Blob Storage

```json theme={null}
{
  "container": "customer-container",
  "credentials": {
    "account": "<storage-account-name>",
    "key": "<storage-account-key>"
  }
}
```

Required permissions:

* blob create/write permission for upload
* blob read permission for read-after-upload validation

### Azure Blob Storage with SAS token

```json theme={null}
{
  "container": "customer-container",
  "credentials": {
    "account": "<storage-account-name>",
    "sas_token": "<sas-token>"
  }
}
```

Required SAS permissions:

* `r`, read, required for read-after-upload validation
* `c`, create, required for creating new blobs
* `w`, write, required for uploading blob content

### Google Cloud Storage

```json theme={null}
{
  "bucket": "customer-bucket",
  "credentials": {
    "client_email": "<service-account>@<project>.iam.gserviceaccount.com",
    "private_key": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n"
  }
}
```

Required permissions:

* `storage.objects.create`
* `storage.objects.get`

### Ali OSS

```json theme={null}
{
  "bucket": "customer-bucket",
  "region": "oss-us-east-1",
  "credentials": {
    "access_key_id": "<ALI_OSS_ACCESS_KEY_ID>",
    "access_key_secret": "<ALI_OSS_ACCESS_KEY_SECRET>"
  }
}
```

Required permissions:

* `oss:PutObject`
* `oss:GetObject`

For restrictive multipart upload policies, multipart-related permissions may also be required.

### Webhook

```json theme={null}
{
  "endpoint": "https://example.com/webhook",
  "auth_header": "Bearer <TOKEN>",
  "compress": true
}
```

Requirements:

* the endpoint must accept `POST` requests
* the endpoint must return a `2xx` response after receiving the payload
* for webhook payloads larger than `10 MB`, use cloud storage delivery instead of webhook


# Get snapshot metadata
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-snapshot-meta

api-reference/dca-api GET /datasets/snapshots/{id}
Use the Bright Data Marketplace Dataset API to get Snapshot Metadata. Spans 250+ domains in the Bright Data marketplace.



# Get snapshot parts
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-snapshot-parts

api-reference/dca-api GET /datasets/snapshots/{id}/parts
Use the Bright Data Marketplace Dataset API to get Snapshot Parts. GET /datasets/snapshots/{id}/parts returns 200 OK with snapshot metadata as JSON.



# Get view delivery settings
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/get-view-delivery-settings

api-reference/dca-api GET /datasets/views/{view_id}/delivery_settings
Retrieve the current delivery configuration for a Bright Data dataset view (250+ domains): destination, credentials, filename, compression and batch size.

Returns the full delivery configuration stored for the given dataset view. The `deliver` object contains the destination-specific fields (for example `bucket`, `credentials`, `region` for an S3 destination), and the top-level `tar`, `compress`, `batch_size` and `filename` fields describe how the output files are packaged.

<Tip>
  Find the `view_id` by calling [Get dataset views](/api-reference/marketplace-dataset-api/get-dataset-views).
</Tip>


# Update view delivery settings
Source: https://docs.brightdata.com/api-reference/marketplace-dataset-api/update-view-delivery-settings

api-reference/dca-api PUT /datasets/views/{view_id}/delivery_settings
Set the delivery destination, credentials, filename template and batch options for a single dataset view. Returns the updated view id. Covers 250+ domains.

Replaces the delivery configuration for a dataset view. The `deliver.type` field selects the destination and the remaining fields inside `deliver` must match the schema returned by [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) for that destination.

## How to update a view

1. Call [Get delivery options](/api-reference/marketplace-dataset-api/get-delivery-options) to confirm the destination type is supported.
2. Call [Get destination type schema](/api-reference/marketplace-dataset-api/get-destination-type-schema) with that destination type to get the required fields.
3. Send the `PUT` request documented on this page with the `deliver` object populated.

<Note>
  Setting `tar: true` bundles all output files into a single TAR archive. Setting `compress: true` gzips each delivered file. Both can be combined.
</Note>

<Note>
  `batch_size` is the maximum number of records per output file. Use it to split large deliveries into smaller files. The maximum per-batch size is 5 GB.
</Note>

To apply the same configuration to many views at once, use [Bulk update view delivery settings](/api-reference/marketplace-dataset-api/bulk-update-view-delivery-settings) instead.


# SERP async response
Source: https://docs.brightdata.com/api-reference/rest-api/serp/get-results

async-api-reference GET /serp/get_result
Use the Bright Data SERP API async endpoint (31 languages). GET /serp/get_result submits or retrieves a queued SERP request and returns 200 OK as JSON.

<Tip>
  The sample 200 response has been abbreviated for brevity.
</Tip>


# SERP async request
Source: https://docs.brightdata.com/api-reference/rest-api/serp/request

async-api-reference POST /serp/req
Use the Bright Data SERP API async endpoint (31 languages). POST /serp/req submits or retrieves a queued SERP request and returns 200 OK as JSON.



# SERP API
Source: https://docs.brightdata.com/api-reference/rest-api/serp/serp-api

api-reference/serp-rest-api POST /request
Use the Bright Data SERP API to extract structured results from Google, Bing, Yandex and DuckDuckGo with organic listings, ads and shopping data.

Related guide: [SERP API Introduction](/products/serp-api/introduction)

<Card title="Bright Data Python SDK" icon="python" href="/api-reference/SDK">
  For an easy start using our tools check out our new Python SDK.
</Card>


# Unlocker async response
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/get-results

async-api-reference GET /unblocker/get_result
Use the Bright Data Web Unlocker API (98% success rate) async endpoint. GET /unblocker/get_result retrieves the result of a queued unlock request as JSON.



# Web Unlocker API success rate
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/get-success-rate

api-reference/unlocker-rest-api GET /unblocker/success_rate/{domain}
Use the Bright Data Web Unlocker API success rate endpoint. GET /unblocker/success_rate/{domain} returns per-domain success rates by date range and URL.

The Bright Data Web Unlocker API success rate endpoint returns the share of requests that succeeded against a domain, as a number between 0 and 1. By default the reporting window is the past 7 days.

Pass a single domain such as `example.com` to get one figure. Pass a wildcard such as `example.*` to get one figure for every monitored top-level domain of that name.

## How do I filter success rates by date range or URL?

Add the optional `from_datetime`, `to_datetime` and `url_pattern` query parameters. Each one works on its own or combined with the others:

* `from_datetime` and `to_datetime` set the reporting window. Both accept an ISO 8601 UTC date such as `2026-09-20` or a date-time such as `2026-09-20T00:00:00Z`.
* `url_pattern` keeps only requests whose URL contains the string. The match is a case-insensitive substring match and works with wildcard domains.

The following request returns the success rate for `example.com` requests whose URL contains `/ip/`, between September 20 and September 24, 2026:

```bash theme={null}
curl -G "https://api.brightdata.com/unblocker/success_rate/example.com" \
  --data-urlencode "from_datetime=2026-09-20" \
  --data-urlencode "to_datetime=2026-09-24" \
  --data-urlencode "url_pattern=/ip/" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

The request fails when `from_datetime` is later than `to_datetime` or when a date cannot be parsed.

Related guide: [Web Unlocker API features](/products/web-unlocker/features#get-success-rate-statistics-per-domain)


# Unlocker async request
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/request

async-api-reference POST /unblocker/req
Use the Bright Data Web Unlocker API (98% success rate) async endpoint. POST /unblocker/req submits an unlock request and returns a response_id as JSON.



# Web Unlocker API
Source: https://docs.brightdata.com/api-reference/rest-api/unlocker/unlock-website

api-reference/unlocker-rest-api POST /request
Use the Bright Data Web Unlocker API (98% success rate) to test and unlock websites in real time, bypassing anti-bot protections, proxies and CAPTCHAs.

Related guide: [Web Unlocker API Introduction](/products/web-unlocker/introduction)

<Card title="Bright Data Python SDK" icon="python" href="/api-reference/SDK">
  For an easy start using our tools check out our new Python SDK.
</Card>


# Receive batch data
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Receive_batch_data

api-reference/web-scraper-ide-rest-api GET /dca/dataset
Use GET /dca/dataset?id=<collection_id> to fetch results of an async Scraper Studio batch job. Returns a status object while running, a JSON array when ready.

Use `GET /dca/dataset?id=<collection_id>` to retrieve the results of an asynchronous Bright Data Scraper Studio batch collection. While the collection is still running, the endpoint returns a status object. When the collection is ready, it returns a JSON array of records.

For the full trigger, poll and parse walkthrough in cURL, Python and Node.js, see the [Quickstart](./Getting_started_with_the_API).

<Note>
  Use the `collection_id` returned by [POST /dca/trigger](./Trigger_a_scraper_for_batch_collection_method) as the `id` query parameter in this endpoint.
</Note>

<Note>
  Batch collection results are available for download for 16 days after collection. To avoid expiration, download the data within 16 days or configure a [push delivery method](./Choose_a_delivery_type_on_request_level) to send it to your storage automatically.
</Note>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/dataset?id=$COLLECTION_ID" \
    -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
  ```

  ```python Python theme={null}
  response = requests.get(
      "https://api.brightdata.com/dca/dataset",
      params={"id": collection_id},
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/dataset?id=${collectionId}`,
    { headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}` } }
  );
  ```
</CodeGroup>

## Response

While the collection is still building (HTTP 202):

```json theme={null}
{
  "status": "building",
  "message": "Dataset is not ready yet, try again in XXs"
}
```

When the collection is ready (HTTP 200):

```json theme={null}
[
  {
    "url": "https://www.dm.de/p/d/3133774/babylove-teller-silikon-mit-trennschale-regenbogen-orange-creme",
    "title": "babylove Teller Silikon mit Trennschale Regenbogen orange/creme",
    "price": 8.45,
    "availability": "in stock",
    "input": {
      "url": "https://www.dm.de/p/d/3133774/babylove-teller-silikon-mit-trennschale-regenbogen-orange-creme"
    }
  }
]
```

The exact field set depends on the output schema you defined when you built the collector. One row per successful input by default.

## Retrieving results

While the collection is still running, the endpoint returns `202 Accepted` with a status object. When the collection is ready, it returns `200 OK` with a JSON array of records.

For long-running collections, which can take minutes or hours, avoid frequent polling. Use one of these options instead:

* Check the collection status periodically with longer intervals.
* Configure a [push delivery method](./Choose_a_delivery_type_on_request_level), such as webhook, Amazon S3, Google Cloud Storage, Azure Blob Storage, SFTP/FTP or email.
* Use the [dashboard](https://brightdata.com/cp/scrapers) to monitor run progress.

Batch collection results are retained for 16 days. Download the data within the retention window or configure push delivery to store results automatically.

The [Node.js](https://github.com/brightdata/bright-data-scraper-studio-nodejs-project/blob/main/index.js) and [Python](https://github.com/brightdata/bright-data-scraper-studio-python-project/blob/main/index.py) starters implement status checks with exponential-backoff retry on transient errors.

## Errors

| Status | Cause | Fix |
| - | - | - |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `404 Not Found` | Collection ID does not exist, was deleted or has expired (16 days) | Re-trigger the collector if the data is still needed |
| `[]` (empty array) | Collection completed but produced no rows | Check the input URLs and the collector's output schema |
| `5xx` | Transient Bright Data API error | Retry with exponential backoff, for example 1s, 2s, 4s |

## Related

* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates the collection
* [Job data](./job-data): job-level metadata (status, page counts, error counts)
* [Get errors for a job](./get-errors-for-job): per-input error details
* [Choose a delivery type](./Choose_a_delivery_type_on_request_level): alternative to polling (webhook, S3, GCS, etc.)


# Receive data from real-time work scraper
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Receive_data_from_real_time_work_scraper

api-reference/web-scraper-ide-rest-api GET /dca/get_result
Use the Bright Data Scraper Studio API to receive data from a real-time scraper. Triggers a custom collector job; returns 200 OK with JSON results.

<Tip>
  **Recommended:** We strongly recommend using the `timeout` parameter on polling requests to reduce unnecessary API calls and help avoid rate limits.
</Tip>

<Note>
  Result data is available for download for 7 days after collection. To avoid expiration, make sure to download the data within 7 days or configure a delivery method to get it automatically to your storage.
</Note>

## Rate limits

* 165,000 requests per minute


# Trigger async batch collection
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method

api-reference/web-scraper-ide-rest-api POST /dca/trigger
Use POST /dca/trigger to start an async batch collection for a Scraper Studio collector. Send a JSON array of inputs; returns a collection_id to fetch results.

Use `POST /dca/trigger` to start an asynchronous batch collection for a published Bright Data Scraper Studio collector. The request body is a JSON array of input objects, and each object must match the collector's input schema.

The endpoint returns a `collection_id` immediately. Use that ID with the [Receive batch data](./Receive_batch_data) endpoint (`GET /dca/dataset`) to retrieve the results when the collection is complete.

For the full happy-path walkthrough (auth, trigger, poll, parse) in cURL, Python and Node.js, see the [Quickstart](./Getting_started_with_the_API). This page is the parameter and error reference.

## Request

The request body is a JSON array of input objects. Each object must match the input schema defined for the collector in [Scraper Studio](https://brightdata.com/cp/scrapers). A URL-based collector may require a `url` field, while other collectors may require fields such as `keyword`, `location`, `country` or custom input fields.

The body must be a JSON array. For a single input, send an array with one object.

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.brightdata.com/dca/trigger?collector=YOUR_COLLECTOR_ID&queue_next=1' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '[
      { "url": "https://example.com/product/1" },
      { "url": "https://example.com/product/2" }
    ]'
  ```

  ```python Python theme={null}
  import os, requests

  response = requests.post(
      "https://api.brightdata.com/dca/trigger",
      params={"collector": os.environ["BRIGHT_DATA_COLLECTOR_ID"], "queue_next": 1},
      headers={
          "Authorization": f"Bearer {os.environ['BRIGHTDATA_API_KEY']}",
          "Content-Type": "application/json",
      },
      json=[
          {"url": "https://example.com/product/1"},
          {"url": "https://example.com/product/2"},
      ],
  )
  collection_id = response.json()["collection_id"]
  ```

  ```js Node.js theme={null}
  const url = new URL("https://api.brightdata.com/dca/trigger");
  url.searchParams.set("collector", process.env.BRIGHT_DATA_COLLECTOR_ID);
  url.searchParams.set("queue_next", "1");

  const response = await fetch(url, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      { url: "https://example.com/product/1" },
      { url: "https://example.com/product/2" },
    ]),
  });
  const { collection_id } = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "collection_id": "j_abc123def456",
  "start_eta": "2026-05-22T13:26:22.702Z"
}
```

The `collection_id` identifies this collection run. Use it as the `id` value when calling `GET /dca/dataset` to retrieve the results.

```bash theme={null}
curl --request GET \
  --url 'https://api.brightdata.com/dca/dataset?id=j_abc123def456' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

| Field | Type | Description |
| - | - | - |
| `collection_id` | string | ID of the collection run. Use this value to retrieve results from `GET /dca/dataset`. |
| `start_eta` | string | Estimated start time for the collection, in ISO 8601 format. |

See the [Quickstart](./Getting_started_with_the_API#what-do-the-ids-mean) for how the IDs relate to one another.

## Send a notification when a collection finishes

Use the `notify` query parameter to send a webhook or email notification when a batch collection finishes. The parameter accepts a JSON object passed as a URL query parameter, so the value must be URL-encoded. When `notify` is used without `deliver`, the notification is sent when the collection job completes.

The following cURL example triggers a batch collection and sends a webhook notification when the job completes. The `--url-query` option, available since curl 7.87.0, URL-encodes the JSON value for you:

```bash theme={null}
curl --request POST "https://api.brightdata.com/dca/trigger" \
  --url-query "collector=YOUR_COLLECTOR_ID" \
  --url-query 'notify={"type":"webhook","endpoint":"https://example.com/webhook"}' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '[{ "url": "https://example.com/product/1" }]'
```

The response is the standard `collection_id` response shown above. When the collection job completes, Bright Data sends the notification to the configured endpoint.

The `notify` object has the following fields:

| Field | Type | Required | Description |
| - | - | - | - |
| `type` | string | Yes | Notification type: `webhook` or `email`. |
| `endpoint` | string | Required for `webhook` | Webhook URL that receives the notification. |

## Override delivery settings for one request

Use the `deliver` query parameter to override the scraper's default delivery settings for a specific request. This delivers the collection result to a destination different from the one configured under **Delivery preferences** in the control panel, without changing the scraper configuration. Like `notify`, the parameter accepts a JSON object passed as a URL-encoded query parameter.

The following example triggers a batch collection, delivers the result to Amazon S3 and sends a webhook notification after delivery completes:

```bash theme={null}
COLLECTOR=YOUR_COLLECTOR_ID

DELIVER='{
  "type": "s3",
  "bucket": "YOUR_BUCKET",
  "credentials": {
    "aws-access-key": "YOUR_AWS_ACCESS_KEY",
    "aws-secret-key": "YOUR_AWS_SECRET_KEY"
  },
  "region": "YOUR_REGION",
  "directory": "brightdata/YOUR_DIRECTORY",
  "filename": {
    "template": "results_{[datetime]}",
    "extension": "json"
  },
  "delivery_type": "deliver_results"
}'

NOTIFY='{
  "type": "webhook",
  "endpoint": "https://example.com/webhook"
}'

curl --request POST "https://api.brightdata.com/dca/trigger" \
  --url-query "collector=$COLLECTOR" \
  --url-query "deliver=$DELIVER" \
  --url-query "notify=$NOTIFY" \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '[{ "url": "https://example.com/product/1" }]'
```

The `deliver` object supports the same destination types as **Delivery preferences**, including `s3`, `gcs`, `azure`, `sftp`, `webhook`, `snowflake` and `email`.

## How notify and deliver interact

| Configuration | Behavior |
| - | - |
| Neither `notify` nor `deliver` | Uses the scraper's default delivery settings. No request-level notification is sent. |
| `notify` only | Sends a notification when the collection job completes. |
| `deliver` only | Delivers the result using the request-level delivery configuration. |
| `deliver` and `notify` | Delivers the result using the request-level delivery configuration, then sends a notification when delivery completes. |

## When to use batch collection

Use batch collection (`POST /dca/trigger`) when:

* You need to process multiple inputs in one run.
* You can wait until the collection finishes before receiving results.
* You want to retrieve results later by `collection_id`.
* You are building a dataset or a scheduled collection workflow.

Use [real-time collection](./initiate-a-realtime-job/sync-realtime-job) when you need a result for a single input immediately or within a short request window.

## Errors

| Status | Cause | Fix |
| - | - | - |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `404 Not Found` | Collector ID does not exist or your account does not have access | Open the collector in [Scraper Studio](https://brightdata.com/cp/scrapers) and re-copy the ID |
| `422 Unprocessable Entity` | The objects in your request body do not match the collector's input schema | Confirm field names against the **Inputs** tab of your collector |
| `5xx` | Transient Bright Data API error | Retry with exponential backoff, for example 1s, 2s, 4s |

## Retry behavior

Re-triggering the same inputs creates a new collection with a new `collection_id`. The endpoint is not idempotent and does not deduplicate inputs across runs. To retry only the failed inputs, use [Get errors for a job](./get-errors-for-job) to identify the failed inputs from the run, then trigger a new collection with only those inputs.

## Related

* [Quickstart](./Getting_started_with_the_API): full trigger, poll and parse walkthrough in cURL, Python and Node.js
* [Receive batch data](./Receive_batch_data): poll for the dataset
* [Choose a delivery type on request level](./Choose_a_delivery_type_on_request_level): collection modes and delivery preference compatibility
* [Node.js starter](https://github.com/brightdata/bright-data-scraper-studio-nodejs-project): production-grade client that calls this endpoint
* [Python starter](https://github.com/brightdata/bright-data-scraper-studio-python-project): same, in Python


# AI job progress
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/ai-job-progress

api-reference/web-scraper-ide-rest-api GET /dca/collectors/{collector_id}/automate_template/progress
Use the Bright Data Scraper Studio AI Flow API to get AI job progress. Returns 200 OK with AI scraper template or job progress data as JSON.



# Create scraper template
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/create-scraper-template

api-reference/web-scraper-ide-rest-api POST /dca/collector
Use the Bright Data Scraper Studio AI Flow API to create a scraper template. POST /dca/collector returns 200 OK with AI scraper template or job status as JSON.



# Enable Auto Self-Healing
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/enable-auto-self-healing

api-reference/web-scraper-ide-rest-api POST /dca/auto_self_healing/create
Use the Bright Data Scraper Studio AI Flow API to enable Auto Self-Healing on a scraper and set its success rate, frequency, cooldown and daily job limits.

Call this endpoint once per scraper. It returns the ID of the saved settings, such as `ash_lz3k9qw1`, not the settings themselves.

<Warning>
  Auto Self-Healing settings are created once and cannot be changed through the AI Flow API. A second call for the same scraper returns HTTP 409, and there is no endpoint to read, update, delete or disable them. Edit or turn off Auto Self-Healing in the **Auto Self-Healing** tab of Bright Data Scraper Studio. See [Scraper Studio Auto Self-Healing](/products/scraper-studio/auto-self-healing).
</Warning>

Four rules decide whether a request is accepted:

* Send `collector`, `enabled`, `sr_threshold` and `trigger_frequency` on every request. Add `min_inputs_threshold` when `trigger_frequency` is `per_job`.
* Send whole numbers. Decimals are rejected.
* The scraper must be active. An inactive one returns HTTP 400 with `Collector must be active`.
* Every address in `notification_emails` must belong to a user on the scraper's account.

Set `notification_emails` when `auto_save` is `false`. The healing job runs but does not save its code, and the notification email is the only way a person sees the suggested fix.


# Resume Self-Healing Job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/resume-self-healing-job

api-reference/web-scraper-ide-rest-api POST /dca/collectors/{collector_id}/resume_automation_job
Use the Bright Data Scraper Studio AI Flow API to approve or reject a Self-Healing job paused at pending_answer. Returns 200 OK with no body.



# Self-Healing Job Progress
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/self-healing-job-progress

api-reference/web-scraper-ide-rest-api GET /dca/collectors/{collector_id}/refactor_template/progress
Use the Bright Data Scraper Studio AI Flow API to get self-healing job progress. Returns 200 OK with AI scraper template or job progress data as JSON.



# Trigger AI Flow
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/trigger-ai-flow

api-reference/web-scraper-ide-rest-api POST /dca/collectors/{collector_id}/automate_template
Use the Bright Data Scraper Studio AI Flow API to trigger AI Flow. Returns 200 OK with AI scraper template or job progress data as JSON.



# Trigger Self-Healing
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/ai-flow/trigger-self-healing

api-reference/web-scraper-ide-rest-api POST /dca/collectors/{collector_id}/refactor_template
Use the Bright Data Scraper Studio AI Flow API to trigger self-healing. Returns 200 OK with AI scraper template or job progress data as JSON.



# Cancel a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/cancel-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/cancel
POST /dca/jobs/{job_id}/cancel permanently stops a Bright Data Scraper Studio job. The job moves to canceled and cannot be resumed afterward.

Permanently stop a Bright Data Scraper Studio job. The job moves to `canceled` and stops processing its remaining inputs.

This endpoint takes no request body and returns the plain text body `OK` on success, not JSON. Read the response as text rather than calling a JSON parser on it.

<Warning>
  Canceling is permanent. A canceled job cannot be resumed. Data already collected may still be available, depending on the run status and delivery settings. To stop a job temporarily instead, use [Pause a Scraper Studio job](./pause-job).
</Warning>

## Job state behavior

| Action | Use when | Result |
| - | - | - |
| Pause | You want to temporarily stop a running job | Job moves to `paused` |
| Resume | You want to continue a paused job | Job moves back to `running` |
| Cancel | You want to stop a job permanently | Job moves to `canceled` |

Completed jobs cannot be paused, resumed or canceled.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to cancel:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Stop a job triggered with the wrong input set instead of paying for the full run
* Cancel a runaway job generating far more child pages than expected, rather than waiting for a `too_many_pages` error
* Clear a stuck job before triggering a corrected run of the same scraper

Pages that were still queued when the job was canceled report the `aborted_page` error code. See [Scraper Studio error codes](/products/scraper-studio/error-codes) for the full catalog.

## Related

* [Pause a Scraper Studio job](./pause-job): stop a job temporarily instead of permanently
* [Resume a Scraper Studio job](./resume-job): restart a paused job, which is not possible after canceling
* [Get job metadata](./job-data): confirm the job status after canceling
* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): start a corrected run


# Delete a Scraper Studio scraper
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/delete-scraper

api-reference/web-scraper-ide-rest-api DELETE /dca/collector/{scraper_id}
DELETE /dca/collector/{scraper_id} removes a Scraper Studio scraper from your Bright Data account, taking it out of My Scrapers and preventing future runs.

Use `DELETE /dca/collector/{scraper_id}` to delete a Bright Data Scraper Studio scraper from your account. Deleting a scraper removes it from My Scrapers and prevents new manual, scheduled or API-triggered runs.

This endpoint takes no request body and returns the plain text body `OK` on success, not JSON. Read the response as text rather than calling a JSON parser on it.

<Warning>
  Deleting a scraper cannot be undone. Use this endpoint only when the scraper is no longer needed.
</Warning>

## How to find a scraper ID

Use the scrapers list endpoint to find the ID of the scraper you want to delete:

```bash theme={null}
curl "https://api.brightdata.com/dca/collectors_list" \
  -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
```

Use the returned `id` value as the `scraper_id` path parameter. In API parameters, this ID may also be referred to as `collector_id`. See [List Scraper Studio scrapers](./list-scrapers) for the full parameter list.

## Record a deletion reason

Pass the optional `reason` query parameter to record why the scraper was deleted, for tracking or audit purposes:

```bash theme={null}
curl -X DELETE "https://api.brightdata.com/dca/collector/c_mnvdqy7w1fyaku0uep?reason=no_longer_needed" \
  -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
```

Omit `reason` to delete the scraper without recording one.

## When to use this endpoint

* Remove a scraper you no longer run, so it stops appearing in My Scrapers
* Clean up test or duplicate scrapers created while developing in Scraper Studio
* Decommission a scraper after migrating its workload to another scraper

## Related

* [List Scraper Studio scrapers](./list-scrapers): find the `scraper_id` before deleting
* [List Scraper Studio jobs](./list-jobs): review the jobs a scraper has run
* [Cancel a Scraper Studio job](./cancel-job): stop a single job without deleting the scraper


# Get errors for a job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/get-errors-for-job

api-reference/web-scraper-ide-rest-api GET /dca/jobs/{job_id}/hp_errors
GET /dca/jobs/{job_id}/hp_errors returns per-input error details for a Bright Data Scraper Studio batch job. Identify which inputs failed and why.

Retrieve per-input error details for a Bright Data Scraper Studio batch job. Use this endpoint to identify which inputs in a batch failed, what the error code was and how to remediate.

<Note>
  Per the OpenAPI spec, the `job_id` for this endpoint is the one returned by the `/dca/trigger_hp` (high-priority) endpoint. Jobs created via the regular `/dca/trigger` endpoint may use a different error-retrieval path. If the response is empty for a regular trigger job, contact [Bright Data support](https://brightdata.com/contact-us) to confirm the right endpoint for your workflow.
</Note>

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/jobs/$JOB_ID/hp_errors" \
    -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
  ```

  ```python Python theme={null}
  response = requests.get(
      f"https://api.brightdata.com/dca/jobs/{job_id}/hp_errors",
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  errors = response.json()
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/jobs/${jobId}/hp_errors`,
    { headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}` } }
  );
  const errors = await response.json();
  ```
</CodeGroup>

### Query parameters

| Name | Type | Required | Description |
| - | - | - | - |
| `skip_normalize` | boolean | No | When `true`, returns full non-normalized error details. Default returns normalized errors. |

## Errors

| Status | Cause | Fix |
| - | - | - |
| `400 Bad Request` | Invalid job ID format | Verify the job ID matches the `j_` prefix returned by the trigger endpoint |
| `404 Not Found` | Job does not exist or your account does not have access | Confirm the job ID is current and from a job you triggered |
| `500` | Internal server error | Retry with exponential backoff, for example 1s, 2s, 4s |

## When to use this endpoint

* Build a re-trigger workflow that retries only the failed inputs from a previous batch
* Surface user-actionable error messages in a UI or admin console
* Track failure trends over time (which collectors fail most often, which input shapes cause 422s)

## Related

* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates the job
* [Job data](./job-data): job-level metadata (status, fails count, etc.)
* [Receive batch data](./Receive_batch_data): download the successful records


# Trigger async real-time scrape
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job

api-reference/web-scraper-ide-rest-api POST /dca/trigger_immediate
Trigger an async real-time Scraper Studio scrape. POST /dca/trigger_immediate returns a response_id to fetch the result from the Real-time data endpoint.

<Note>
  This endpoint does not return the scrape data. It returns a `response_id`. Use that `response_id` with the [Realtime Data endpoint](/api-reference/scraper-studio-api/Receive_data_from_real_time_work_scraper) to retrieve the result when the scrape is complete.
</Note>


# Trigger sync real-time scrape
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/initiate-a-realtime-job/sync-realtime-job

api-reference/web-scraper-ide-rest-api POST /dca/crawl
Trigger a synchronous real-time Scraper Studio scrape. POST /dca/crawl holds the request open until the scraper finishes or times out, then returns JSON.

The synchronous real-time endpoint keeps the HTTP request open until the scraper finishes or the `timeout` is reached, then returns the collected data directly as JSON. This is the difference from the [async real-time endpoint](/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job), which returns a `response_id` immediately.

<Warning>
  You can trigger only **single-input** APIs. Make sure the payload is **an object, not an array of objects**.
</Warning>

## Timeout behavior

The `timeout` query parameter must be between `25s` and `50s`.

* If the scraper finishes within the timeout, the response returns `200 OK` with the collected data.
* If the scraper is still running when the timeout is reached, the response returns `202 Accepted` with a `response_id`. Use that `response_id` with the [Realtime Data endpoint](/api-reference/scraper-studio-api/Receive_data_from_real_time_work_scraper) to retrieve the result asynchronously.

## When to use synchronous real-time

Use **synchronous real-time** (`POST /dca/crawl`) when:

* You need the result in the same HTTP request.
* You are sending a single input.
* Your client can keep the request open until the scrape finishes.
* The scrape normally completes within the configured timeout.

Use [**async real-time**](/api-reference/scraper-studio-api/initiate-a-realtime-job/async-realtime-job) (`POST /dca/trigger_immediate`) when:

* You want to trigger the scrape and retrieve the result later.
* You do not want to keep the HTTP request open.

Use [**batch collection**](/api-reference/scraper-studio-api/Trigger_a_scraper_for_batch_collection_method) when:

* You need to process multiple inputs in one run.


# Get job metadata
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/job-data

api-reference/web-scraper-ide-rest-api GET /dca/log/{job_id}
GET /dca/log/{job_id} returns metadata for a Bright Data Scraper Studio job: status, input counts, output line counts, failures and run timestamps.

Retrieve metadata for a [triggered](./Trigger_a_scraper_for_batch_collection_method) Bright Data Scraper Studio job: status, input counts, success and failure counts, page counts and run timestamps. Use this endpoint when you need observability into a job, for example to track how many inputs succeeded, how many failed or how long the job took.

This endpoint returns metadata only. To download the actual scraped data, use [Receive batch data](./Receive_batch_data).

## Request

The `job_id` is the `collection_id` returned by [POST /dca/trigger](./Trigger_a_scraper_for_batch_collection_method).

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/log/$JOB_ID" \
    -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
  ```

  ```python Python theme={null}
  response = requests.get(
      f"https://api.brightdata.com/dca/log/{job_id}",
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  metadata = response.json()
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/log/${jobId}`,
    { headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}` } }
  );
  const metadata = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "id": "j_ma13y9ay1piehrso8r",
  "status": "done",
  "collector": "c_m9im5n7v82p2y35la",
  "template": "t_m9jty150kxgwtzcgi.3",
  "inputs": 1,
  "dup_inputs": 0,
  "lines": 60,
  "fails": 0,
  "pages": 1,
  "pages_left": 0,
  "success": 1,
  "navigations": 2,
  "created": "2025-04-28T13:22:16.857Z",
  "started": "2025-04-28T13:22:17.502Z",
  "finished": "2025-04-28T13:23:28.961Z",
  "trigger": "user@example.com",
  "success_rate": 1,
  "job_time": 71459,
  "queue_time": 645
}
```

Common `status` values: `building`, `running`, `done`, `failed`, `cancelled`.

## When to use this endpoint

* Track job progress for a dashboard or monitor
* Read the success rate directly from `success_rate`
* Identify which jobs deduplicated inputs (`dup_inputs > 0`)
* Read job duration directly from `job_time` (milliseconds), and queue wait from `queue_time`

For the actual scraped records, see [Receive batch data](./Receive_batch_data). For per-input error details, see [Get errors for a job](./get-errors-for-job).

## Errors

| Status | Cause | Fix |
| - | - | - |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `404 Not Found` | Job ID does not exist or has expired | Confirm the ID matches a recent `collection_id` from `/dca/trigger` |
| `5xx` | Transient Bright Data API error | Retry with exponential backoff, for example 1s, 2s, 4s |

## Related

* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates the job
* [Receive batch data](./Receive_batch_data): download the dataset itself, not metadata
* [Get errors for a job](./get-errors-for-job): per-input error details for debugging


# List Scraper Studio jobs
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/list-jobs

api-reference/web-scraper-ide-rest-api GET /dca/collector/jobs
GET /dca/collector/jobs returns the Scraper Studio jobs in your account. Filter by scraper ID and date range, and paginate with offset and limit.

Use `GET /dca/collector/jobs` to retrieve the Bright Data Scraper Studio jobs in your account. Filter the list by scraper ID and date range, and control pagination with `offset` and `limit`.

`from_date` and `to_date` are required. Use a narrower date range for faster responses and easier pagination.

<Note>
  Pass a scraper ID as the `collector` parameter to return only that scraper's jobs. Get scraper IDs from [List Scrapers](./list-scrapers).
</Note>

## Filter, paginate and sort

* **Filter by scraper.** Pass a scraper ID as the `collector` parameter to return only that scraper's jobs. Get IDs from [List Scrapers](./list-scrapers).
* **Paginate.** Use `offset` and `limit` to page through jobs. To retrieve the next page, increase `offset` by the previous `limit`, for example `offset=0&limit=100`, then `offset=100&limit=100`. `limit` must be between 0 and 500.
* **Sort.** Use `sort_asc=1` for ascending order or `sort_asc=-1` for descending order. The default is `-1`.

## When to use this endpoint

* Build a dashboard that lists recent jobs for a scraper across a date range
* Audit job history and compute success rates from `inputs`, `data_lines` and `failed_pages`
* Look up job IDs, then fetch per-job metadata with [Job data](./job-data)
* Spot scrapers that need attention by watching `failed_pages`

## Errors

| Status | Cause | Fix |
| - | - | - |
| `400 Bad Request` | Missing or malformed `from_date` or `to_date` | Send both dates in `YYYY-MM-DD` format |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `5xx` | Transient Bright Data API error | Retry with exponential backoff, for example 1s, 2s, 4s |

## Related

* [List Scrapers](./list-scrapers): find the scraper `id` to pass as the `collector` parameter
* [Job data](./job-data): job-level metadata for a single job
* [Receive batch data](./Receive_batch_data): download the records a job produced
* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): the endpoint that creates jobs


# List Scraper Studio scrapers
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/list-scrapers

api-reference/web-scraper-ide-rest-api GET /dca/collectors_list
GET /dca/collectors_list returns the Scraper Studio scrapers in your account, with each scraper's ID, name, active status, delivery config and output schema.

Use `GET /dca/collectors_list` to retrieve the Bright Data Scraper Studio scrapers available in your account. The response includes scraper IDs, names, active status, delivery configuration, last run time and the output schema when available.

<Note>
  Use this endpoint to discover the scraper `id` values in your account, then pass an `id` as the `collector` parameter when you [trigger a scraper](./Trigger_a_scraper_for_batch_collection_method).
</Note>

## Search scrapers

Use the `search` query parameter to return only scrapers whose name matches a search term, for example `?search=amazon`. Omit `search` to return every scraper in the account.

## When to use this endpoint

* Look up the `id` of a scraper before triggering a batch or real-time job
* Build a picker that lists every scraper in your account
* Audit which scrapers are `active` and which have run before (`last_run`)
* Read the `output_schema` to map returned fields before parsing records

## Errors

| Status | Cause | Fix |
| - | - | - |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `5xx` | Transient Bright Data API error | Retry with exponential backoff, for example 1s, 2s, 4s |

## Related

* [List Jobs](./list-jobs): list the jobs a scraper has run
* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): pass the scraper `id` as the `collector` parameter
* [Job data](./job-data): job-level metadata for a triggered scraper
* [Receive batch data](./Receive_batch_data): download the records a scraper produced


# Pause a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/pause-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/pause
POST /dca/jobs/{job_id}/pause temporarily stops a running Bright Data Scraper Studio job. The job moves to paused and returns the plain text response OK.

Temporarily stop a running Bright Data Scraper Studio job. The job stops processing new inputs and moves to `paused`, and you can restart it later with [Resume a Scraper Studio job](./resume-job).

This endpoint takes no request body and returns the plain text body `OK` on success, not JSON. Read the response as text rather than calling a JSON parser on it.

## Job state behavior

| Action | Use when | Result |
| - | - | - |
| Pause | You want to temporarily stop a running job | Job moves to `paused` |
| Resume | You want to continue a paused job | Job moves back to `running` |
| Cancel | You want to stop a job permanently | Job moves to `canceled` |

Completed jobs cannot be paused, resumed or canceled.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to pause:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Hold a large batch during a target site incident, then resume once the site recovers
* Free concurrency for higher-priority work during a maintenance window
* Stop a job that is returning a high rate of `blocked` or `detect_block` errors while you adjust country, session or rate settings

To stop a job permanently instead, use [Cancel a Scraper Studio job](./cancel-job).

## Related

* [Resume a Scraper Studio job](./resume-job): restart a job paused with this endpoint
* [Cancel a Scraper Studio job](./cancel-job): stop a job permanently instead of temporarily
* [List Scraper Studio jobs](./list-jobs): find the `job_id` to pass to this endpoint
* [Get job metadata](./job-data): confirm the job status after pausing


# Rerun a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/rerun-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/rerun
POST /dca/jobs/{job_id}/rerun starts a new run from an existing Bright Data Scraper Studio job. Rerun everything, or send failed_only to retry failures.

Start a new run from an existing Bright Data Scraper Studio job. Send no request body to rerun the full job from the beginning, or send `failed_only: 1` to rerun only the steps that failed.

A successful request starts a **new** job and returns its `collection_id`. The original job is left untouched.

<Warning>
  Only jobs whose data has not expired can be rerun. Check the job's `expired` timestamp in [List Scraper Studio jobs](./list-jobs) or [Get job metadata](./job-data) before calling this endpoint. If the data has expired, the rerun fails and you must trigger a new job with the original inputs.

  Scraper Studio retains batch collection results for 16 days and real-time results for 7 days. See [Scraper Studio specifications](/products/scraper-studio/specifications).
</Warning>

## Rerun behavior

| Request body | Behavior | Use when |
| - | - | - |
| No body | Reruns the full job from the beginning | You want to collect all inputs again |
| `{ "failed_only": 1 }` | Reruns only the failed steps from the selected job | The job completed with failures and you want to retry just those parts |

## Request

Send the request without a body to rerun everything:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.brightdata.com/dca/jobs/$JOB_ID/rerun" \
    -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
  ```

  ```python Python theme={null}
  response = requests.post(
      f"https://api.brightdata.com/dca/jobs/{job_id}/rerun",
      headers={"Authorization": f"Bearer {API_TOKEN}"},
  )
  rerun = response.json()
  print(rerun["collection_id"])
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/jobs/${jobId}/rerun`,
    {
      method: 'POST',
      headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}` },
    }
  );
  const rerun = await response.json();
  console.log(rerun.collection_id);
  ```
</CodeGroup>

Add `failed_only: 1` to retry only the failed steps:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.brightdata.com/dca/jobs/$JOB_ID/rerun" \
    -H "Authorization: Bearer $BRIGHTDATA_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"failed_only": 1}'
  ```

  ```python Python theme={null}
  response = requests.post(
      f"https://api.brightdata.com/dca/jobs/{job_id}/rerun",
      headers={
          "Authorization": f"Bearer {API_TOKEN}",
          "Content-Type": "application/json",
      },
      json={"failed_only": 1},
  )
  rerun = response.json()
  ```

  ```js Node.js theme={null}
  const response = await fetch(
    `https://api.brightdata.com/dca/jobs/${jobId}/rerun`,
    {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ failed_only: 1 }),
    }
  );
  const rerun = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "collection_id": "j_mdb7x2kq93nfytra1",
  "start_eta": "2026-07-20T12:10:12.301Z"
}
```

Use the returned `collection_id` as the `job_id` for [Get job metadata](./job-data) and [Receive batch data](./Receive_batch_data). It identifies the new rerun job, not the original one.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to rerun:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Retry the failed inputs from a batch after fixing a selector or parser, without recollecting the inputs that already succeeded
* Recollect a full job on a schedule to refresh data that changes over time
* Rerun after a target site incident that caused a burst of `blocked` or `detect_block` errors

To see which inputs failed and why before deciding between a full rerun and `failed_only`, use [Get errors for a job](./get-errors-for-job).

## Related

* [Get errors for a job](./get-errors-for-job): identify which inputs failed before rerunning
* [Get job metadata](./job-data): check the `expired` timestamp and failure count of the original job
* [List Scraper Studio jobs](./list-jobs): find the `job_id` to pass to this endpoint
* [Cancel a Scraper Studio job](./cancel-job): stop a rerun that was started by mistake


# Resume a Scraper Studio job
Source: https://docs.brightdata.com/api-reference/scraper-studio-api/resume-job

api-reference/web-scraper-ide-rest-api POST /dca/jobs/{job_id}/resume
POST /dca/jobs/{job_id}/resume restarts a paused Bright Data Scraper Studio job. The job moves back to running and returns the plain text response OK.

Restart a paused Bright Data Scraper Studio job. The job continues processing its remaining inputs and moves back to `running`.

This endpoint takes no request body and returns the plain text body `OK` on success, not JSON. Read the response as text rather than calling a JSON parser on it.

<Note>
  Resume works only on a job in the `paused` state, which means a job stopped with [Pause a Scraper Studio job](./pause-job). A canceled job cannot be resumed, and neither can a completed one.
</Note>

## Job state behavior

| Action | Use when | Result |
| - | - | - |
| Pause | You want to temporarily stop a running job | Job moves to `paused` |
| Resume | You want to continue a paused job | Job moves back to `running` |
| Cancel | You want to stop a job permanently | Job moves to `canceled` |

Completed jobs cannot be paused, resumed or canceled.

## How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to resume:

```bash theme={null}
curl "https://api.brightdata.com/dca/collector/jobs?from_date=2026-06-01&to_date=2026-07-13" \
  -H "Authorization: Bearer $BRIGHTDATA_API_KEY"
```

Use the returned `id` value as the `job_id` path parameter. See [List Scraper Studio jobs](./list-jobs) for the full parameter list.

## When to use this endpoint

* Continue a batch you paused during a target site incident, once the site is stable again
* Restart paused jobs at the end of a maintenance window
* Resume after adjusting country, session or concurrency settings in response to blocking

## Related

* [Pause a Scraper Studio job](./pause-job): the endpoint that puts a job into the `paused` state
* [Cancel a Scraper Studio job](./cancel-job): stop a paused job permanently instead of resuming it
* [List Scraper Studio jobs](./list-jobs): find the `job_id` to pass to this endpoint
* [Get job metadata](./job-data): confirm the job returned to `running`


# ChatGPT search by prompt
Source: https://docs.brightdata.com/api-reference/scrapers/ai-search-apis/chatgpt-search-by-prompt

api-reference/sdk-specs/chatgpt-search-by-prompt POST /datasets/v3/scrape
Collect ChatGPT answers and cited sources by prompt with the Bright Data Scraper API. Send POST /datasets/v3/scrape with dataset_id gd_m7aof0k82r803d5bjm.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m7aof0k82r803d5bjm` to collect **ChatGPT Search - Search by Prompt** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The ChatGPT page URL. Must be set to `https://chatgpt.com/`.
    </ParamField>

    <ParamField type="string">
      The search prompt. Each prompt triggers a separate ChatGPT search query. Maximum 4,096 characters.
    </ParamField>

    <ParamField type="string">
      Country from which to perform the search.
    </ParamField>

    <ParamField type="number">
      Unique ID for tracking each crawl request.
    </ParamField>

    <ParamField type="boolean">
      If set to `true` and sources are not found in the page, an error message is returned instead of the record.
    </ParamField>

    <ParamField type="string">
      A follow-up input sent after receiving the first answer, aiming to clarify, expand, or refine the initial response. The result is returned as `additional_answer_text`.
    </ParamField>

    <ParamField type="boolean">
      Permission to run an external web search during the run. If set to `true` (default), the Web Search button is enabled and the model may click it. If `false`, the button is never clicked and the model will not trigger a web search. This field is a **permission, not a guarantee**: setting `true` does not mean a search will happen. Read `web_search_triggered` in the response to know whether a search actually ran. See [Query fan-out and web search control](/products/scrapers/concepts/query-fan-out).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://chatgpt.com/", "prompt": "Top hotels in New York", "country": "us", "web_search": true},
      {"url": "https://chatgpt.com/", "prompt": "What are the biggest business trends to watch in the next five years?"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
      "prompt": "Top hotels in New York",
      "answer_text": "Here are some of the top-rated hotels in New York City...",
      "answer_text_markdown": "## Top Hotels in New York City\n\n1. **The Plaza** - Iconic luxury...",
      "answer_html": "<div>...</div>",
      "model": "gpt-4o",
      "web_search_triggered": true,
      "citations": [
        {
          "title": "Best Hotels in NYC 2024",
          "url": "https://www.travelandleisure.com/best-hotels-nyc",
          "position": 1
        }
      ],
      "search_sources": [
        {
          "url": "https://www.travelandleisure.com/best-hotels-nyc",
          "title": "Best Hotels in NYC",
          "favicon": "https://www.travelandleisure.com/favicon.ico"
        }
      ],
      "links_attached": [
        {
          "url": "https://www.theplazany.com",
          "text": "The Plaza",
          "position": 0
        }
      ],
      "recommendations": [],
      "references": [],
      "country": "us",
      "is_map": true,
      "shopping_visible": false,
      "prompt_sent_at": "2024-12-15T10:30:00.000Z",
      "index": null
    }
  ]
  ```
</ResponseExample>


# Discover Amazon global by keywords
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-keywords

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon global products that match search keywords with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lwhideng15g8jg63s7.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Keywords** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for products.
    </ParamField>

    <ParamField type="string">
      The Amazon domain to search on (e.g. [https://www.amazon.com](https://www.amazon.com)).
    </ParamField>

    <ParamField type="number">
      The number of search result pages to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "laptop stand",
        "url": "https://www.amazon.com",
        "pages_to_search": 3
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"keyword":"laptop stand","url":"https://www.amazon.com","pages_to_search":3}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lwhideng15g8jg63s7",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "keyword": "laptop stand",
                  "url": "https://www.amazon.com",
                  "pages_to_search": 3,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lwhideng15g8jg63s7",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          keyword: "laptop stand",
          url: "https://www.amazon.com",
          pages_to_search: 3,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Adjustable Laptop Stand for Desk",
      "url": "https://www.amazon.com/dp/B0B77889EF",
      "asin": "B0B77889EF",
      "price": 34.99,
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 15200,
      "seller_name": "DeskPro Accessories",
      "brand": "DeskPro",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-stand.jpg",
      "description": "Ergonomic aluminum laptop stand with adjustable height and angle.",
      "category": "Office Products > Desk Accessories > Laptop Stands",
      "country_domain": "amazon.com"
    }
  ]
  ```
</ResponseExample>


# Discover Amazon global by seller
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-global-discover-by-seller

POST https://api.brightdata.com/datasets/v3/scrape
Discover Amazon global products listed by a seller URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lwhideng15g8jg63s7.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwhideng15g8jg63s7` to collect **Discover by Seller** data.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `seller`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The URL of the Amazon seller page.
    </ParamField>

    <ParamField type="number">
      The number of products to collect. Missing value indicates no limit.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "seller_url": "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7",
        "num_of_products": 30
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"seller_url":"https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7","num_of_products":30}],"limit_per_input":null}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&notify=false&include_errors=true&type=discover_new&discover_by=seller"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_lwhideng15g8jg63s7",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "seller",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "seller_url": "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7",
                  "num_of_products": 30,
              },
          ],
          "limit_per_input": None,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_lwhideng15g8jg63s7",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "seller",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          seller_url: "https://www.amazon.com/sp?ie=UTF8&seller=A2FE2Y3KEQLBV7",
          num_of_products: 30,
        },
      ],
      limit_per_input: null,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Wireless Charging Pad 15W Fast Charge",
      "url": "https://www.amazon.com/dp/B0C99887GH",
      "asin": "B0C99887GH",
      "price": 18.99,
      "currency": "USD",
      "rating": 4.4,
      "reviews_count": 7300,
      "seller_name": "Electronics Hub",
      "brand": "ChargeFast",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-charger.jpg",
      "description": "Slim wireless charging pad compatible with all Qi-enabled devices.",
      "category": "Electronics > Accessories > Chargers",
      "country_domain": "amazon.com"
    }
  ]
  ```
</ResponseExample>


# Scrape Amazon product search by URL
Source: https://docs.brightdata.com/api-reference/scrapers/e-commerce-apis/amazon-products-search-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Collect Amazon search results by keyword and domain URL with the Bright Data Scraper API: POST /datasets/v3/scrape, dataset_id gd_lwdb4vjm1ehb499uxs.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_lwdb4vjm1ehb499uxs` to collect **Products Search by URL** data.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The keyword to search for products.
    </ParamField>

    <ParamField type="string">
      The Amazon domain to search on (e.g. [https://www.amazon.com](https://www.amazon.com)).
    </ParamField>

    <ParamField type="number">
      The number of search result pages to collect.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "keyword": "X-box",
        "url": "https://www.amazon.com",
        "pages_to_search": 2
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "title": "Wireless Gaming Controller for Console",
      "url": "https://www.amazon.com/dp/B0D22334IJ",
      "asin": "B0D22334IJ",
      "price": 59.99,
      "currency": "USD",
      "rating": 4.6,
      "reviews_count": 28400,
      "seller_name": "GameTech Store",
      "brand": "GameTech",
      "availability": "In Stock",
      "main_image": "https://m.media-amazon.com/images/I/example-controller.jpg",
      "description": "Ergonomic wireless controller with custom button mapping and vibration feedback.",
      "category": "Video Games > Accessories > Controllers"
    }
  ]
  ```
</ResponseExample>


# Scrape Google AI Mode search by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-ai-mode-search-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Google AI Mode search answers and citations by URL. POST /datasets/v3/scrape returns records as JSON.

<Note>
  Some Google AI Mode requests run longer than the 1-minute `/scrape` window. When that happens, the response is HTTP `202` with a `snapshot_id` instead of records, and collection continues. Branch on the status code as shown in [How to handle a 202 response](/api-reference/scrapers/synchronous-requests#how-to-handle-a-202-response), or send many prompts at once with the async [`/trigger`](/products/scrapers/scrapers-library/async-requests) endpoint.
</Note>

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mcswdt6z2elth3zqr2` to collect **Google AI Mode Search by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Google AI Mode Search URL to scrape (includes the `udm=50` parameter).
    </ParamField>

    <ParamField type="string">
      The prompt used in the AI Mode Search query.
    </ParamField>

    <ParamField type="string">
      ISO 3166-1 alpha-2 country code for localized results.
    </ParamField>

    <ParamField type="string">
      Google interface language code, such as `en`, `de` or `fr`. Sets the language of the AI Mode answer, independent of the prompt language. For example, an English prompt with `"hl": "de"` returns the answer in German.
    </ParamField>

    <ParamField type="number">
      A number you assign to each input to track it. The same value is returned in the `index` field of the output record.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.google.com/search?udm=50&q=how+to+train+for+a+marathon",
        "prompt": "how to train for a marathon",
        "country": "US",
        "hl": "en",
        "index": 1
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "url": "https://www.google.com/search?q=how+to+train+for+a+marathon&oq=how+to+train+for+a+marathon&hl=en&gl=US&udm=50&...",
      "prompt": "how to train for a marathon",
      "answer_html": "<html itemscope itemtype=\"http://schema.org/SearchResultsPage\" lang=\"en\" ...>...</html>",
      "answer_text": "To train for a marathon, you must commit to a structured 12- to 20-week training block that builds endurance, strengthens muscles, and trains your digestive system...",
      "answer_text_markdown": "To train for a marathon, you must commit to a structured  **12- to 20-week training block**  that builds endurance...",
      "answer_text_raw": "To train for a marathon, you must \n\ncommit to a structured \n\n12- to 20-week training block\n\n...",
      "links_attached": [
        {
          "url": "https://www.rei.com/",
          "text": "REI +2",
          "position": 1
        },
        {
          "url": "https://everywomansmarathon.com/",
          "text": "Every Woman's Marathon +1",
          "position": 2
        }
      ],
      "citations": [
        {
          "url": "https://www.rei.com/",
          "title": "Training For a Marathon: How To Prepare | REI Expert Advice",
          "description": null,
          "icon": null,
          "domain": "https://www.rei.com",
          "cited": true
        },
        {
          "url": "https://www.halhigdon.com/training/marathon-training/",
          "title": "Marathon Training for All Skill Levels | Hal Higdon",
          "description": null,
          "icon": null,
          "domain": "https://www.halhigdon.com",
          "cited": true
        }
      ],
      "shopping": [],
      "ads": null,
      "index": 1,
      "country": "US",
      "timestamp": "2026-10-02T00:23:44.475Z",
      "input": {
        "url": "https://www.google.com/search?udm=50&q=how+to+train+for+a+marathon",
        "prompt": "how to train for a marathon",
        "index": 1,
        "country": "US",
        "hl": "en"
      }
    }
  ]
  ```
</ResponseExample>


# Scrape Google Flights by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-flights-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Google Flights listings by URL. POST /datasets/v3/scrape returns structured flight records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mhng7wen1rw0a3gvpf` to collect **Google Flights by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The full Google Flights URL to scrape.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.google.com/travel/flights?tfs=..."}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "origin": "JFK",
      "destination": "LAX",
      "departure_date": "2026-06-15",
      "return_date": "2026-06-22",
      "flights": [
        {
          "airline": "Delta",
          "flight_number": "DL 1234",
          "departure_time": "08:15",
          "arrival_time": "11:45",
          "duration_minutes": 390,
          "stops": 0,
          "price": "328.00",
          "currency": "USD"
        }
      ]
    }
  ]
  ```
</ResponseExample>


# Discover Google Flights by Input Filters
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-flights-discover-by-input-filters

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Google Flights listings by input filters. POST /datasets/v3/scrape returns flight records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mhng7wen1rw0a3gvpf` to discover **Google Flights by input filters**.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `input_filters`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      Origin airport IATA code (e.g., `JFK`).
    </ParamField>

    <ParamField type="string">
      Destination airport IATA code (e.g., `LAX`).
    </ParamField>

    <ParamField type="string">
      Departure date in `YYYY-MM-DD` format.
    </ParamField>

    <ParamField type="string">
      Return date in `YYYY-MM-DD` format. Omit for one-way trips.
    </ParamField>

    <ParamField type="string">
      One of: `one_way`, `round_trip`, `multi_city`.
    </ParamField>

    <ParamField type="number">
      Number of adult passengers.
    </ParamField>

    <ParamField type="number">
      Number of child passengers.
    </ParamField>

    <ParamField type="number">
      Number of infants in their own seat.
    </ParamField>

    <ParamField type="number">
      Number of infants on lap.
    </ParamField>

    <ParamField type="string">
      Cabin class. One of: `economy`, `premium_economy`, `business`, `first`.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "origin": "JFK",
        "destination": "LAX",
        "departure": "2026-06-15",
        "return": "2026-06-22",
        "trip_type": "round_trip",
        "adults": 1,
        "children": 0,
        "infants_in_seat": 0,
        "infants_on_lap": 0,
        "cabin": "economy"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"origin":"JFK","destination":"LAX","departure":"2026-06-15","return":"2026-06-22","trip_type":"round_trip","adults":1,"children":0,"infants_in_seat":0,"infants_on_lap":0,"cabin":"economy"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mhng7wen1rw0a3gvpf&notify=false&include_errors=true&type=discover_new&discover_by=input_filters"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_mhng7wen1rw0a3gvpf",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "input_filters",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "origin": "JFK",
                  "destination": "LAX",
                  "departure": "2026-06-15",
                  "return": "2026-06-22",
                  "trip_type": "round_trip",
                  "adults": 1,
                  "children": 0,
                  "infants_in_seat": 0,
                  "infants_on_lap": 0,
                  "cabin": "economy",
              },
          ],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_mhng7wen1rw0a3gvpf",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "input_filters",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          origin: "JFK",
          destination: "LAX",
          departure: "2026-06-15",
          return: "2026-06-22",
          trip_type: "round_trip",
          adults: 1,
          children: 0,
          infants_in_seat: 0,
          infants_on_lap: 0,
          cabin: "economy",
        },
      ],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "origin": "JFK",
      "destination": "LAX",
      "departure_date": "2026-06-15",
      "return_date": "2026-06-22",
      "cabin": "economy",
      "flights": [
        {
          "airline": "Delta",
          "flight_number": "DL 1234",
          "duration_minutes": 390,
          "stops": 0,
          "price": "328.00",
          "currency": "USD"
        }
      ]
    }
  ]
  ```
</ResponseExample>


# Scrape Google Hotels by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-hotel-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Google Hotels listings by URL. POST /datasets/v3/scrape returns structured hotel records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mg3gjfmg12tc2n5d4d` to collect **Google Hotels by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The full Google Hotels listing URL to scrape.
    </ParamField>

    <ParamField type="string">
      ISO 3166-1 alpha-2 country code for localized pricing.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.google.com/travel/hotels/entity/...", "country": "US"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "hotel_id": "CgoI_example",
      "name": "The Plaza",
      "address": "768 5th Ave, New York, NY 10019",
      "rating": 4.5,
      "reviews_count": 8200,
      "price_per_night": "795.00",
      "currency": "USD",
      "amenities": ["Pool", "Spa", "Free Wi-Fi"],
      "latitude": 40.7644,
      "longitude": -73.9745
    }
  ]
  ```
</ResponseExample>


# Discover Google Hotels by filter URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-filter-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Google Hotels listings by filter URL. POST /datasets/v3/scrape returns hotel records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mg3gjfmg12tc2n5d4d` to discover **Google Hotels by filter URL**.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `filter_url`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The full Google Hotels filter URL to scrape.
    </ParamField>

    <ParamField type="string">
      ISO 3166-1 alpha-2 country code for localized results.
    </ParamField>

    <ParamField type="string">
      ISO 4217 currency code (e.g., `USD`, `EUR`, `GBP`).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.google.com/travel/hotels/New+York?...",
        "country": "US",
        "currency": "USD"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"url":"https://www.google.com/travel/hotels/New+York?...","country":"US","currency":"USD"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&notify=false&include_errors=true&type=discover_new&discover_by=filter_url"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_mg3gjfmg12tc2n5d4d",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "filter_url",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "url": "https://www.google.com/travel/hotels/New+York?...",
                  "country": "US",
                  "currency": "USD",
              },
          ],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_mg3gjfmg12tc2n5d4d",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "filter_url",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          url: "https://www.google.com/travel/hotels/New+York?...",
          country: "US",
          currency: "USD",
        },
      ],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "hotel_id": "CgoI_example",
      "name": "The Plaza",
      "address": "768 5th Ave, New York, NY 10019",
      "rating": 4.5,
      "reviews_count": 8200,
      "price_per_night": "795.00",
      "currency": "USD"
    }
  ]
  ```
</ResponseExample>


# Discover Google Hotels by Search
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-hotel-discover-by-search

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Google Hotels listings by search parameters. POST /datasets/v3/scrape returns hotel records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mg3gjfmg12tc2n5d4d` to discover **Google Hotels by search**.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `search`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The destination or location to search (e.g., `New York`, `Tokyo`).
    </ParamField>

    <ParamField type="string">
      Check-in date in `YYYY-MM-DD` format.
    </ParamField>

    <ParamField type="string">
      Check-out date in `YYYY-MM-DD` format.
    </ParamField>

    <ParamField type="number">
      Number of guests.
    </ParamField>

    <ParamField type="string">
      ISO 3166-1 alpha-2 country code for localized results.
    </ParamField>

    <ParamField type="string">
      ISO 4217 currency code (e.g., `USD`, `EUR`).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "search_term": "New York",
        "check_in_date": "2026-06-15",
        "check_out_date": "2026-06-18",
        "guest_number": 2,
        "country": "US",
        "currency": "USD"
      }
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"search_term":"New York","check_in_date":"2026-06-15","check_out_date":"2026-06-18","guest_number":2,"country":"US","currency":"USD"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mg3gjfmg12tc2n5d4d&notify=false&include_errors=true&type=discover_new&discover_by=search"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_mg3gjfmg12tc2n5d4d",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "search",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "search_term": "New York",
                  "check_in_date": "2026-06-15",
                  "check_out_date": "2026-06-18",
                  "guest_number": 2,
                  "country": "US",
                  "currency": "USD",
              },
          ],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_mg3gjfmg12tc2n5d4d",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "search",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          search_term: "New York",
          check_in_date: "2026-06-15",
          check_out_date: "2026-06-18",
          guest_number: 2,
          country: "US",
          currency: "USD",
        },
      ],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "hotel_id": "CgoI_example",
      "name": "The Plaza",
      "address": "768 5th Ave, New York, NY 10019",
      "rating": 4.5,
      "reviews_count": 8200,
      "price_per_night": "795.00",
      "total_price": "2385.00",
      "currency": "USD",
      "check_in_date": "2026-06-15",
      "check_out_date": "2026-06-18"
    }
  ]
  ```
</ResponseExample>


# Scrape Google Maps places by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Google Maps places by URL. POST /datasets/v3/scrape returns structured place records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m8ebnr0q2qlklc02fz` to collect **Google Maps places by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The full URL of the Google Maps place to scrape.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.google.com/maps/place/Empire+State+Building"},
      {"url": "https://www.google.com/maps/place/Central+Park"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
      "name": "Empire State Building",
      "address": "20 W 34th St., New York, NY 10001",
      "category": "Observation deck",
      "rating": 4.7,
      "reviews_count": 98500,
      "phone": "+1 212-736-3100",
      "website": "https://www.esbnyc.com/",
      "latitude": 40.7484405,
      "longitude": -73.9856644,
      "open_hours": {},
      "photos": [],
      "url": "https://www.google.com/maps/place/Empire+State+Building"
    }
  ]
  ```
</ResponseExample>


# Discover Google Maps Places by CID
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-discover-by-cid

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Google Maps places by CID. POST /datasets/v3/scrape returns structured place records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m8ebnr0q2qlklc02fz` to discover **Google Maps places by CID**.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `cid`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Google Maps Customer ID (CID) for the place.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"CID": "14408248692727049506"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"CID":"14408248692727049506"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&notify=false&include_errors=true&type=discover_new&discover_by=cid"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_m8ebnr0q2qlklc02fz",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "cid",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"CID": "14408248692727049506"}],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_m8ebnr0q2qlklc02fz",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "cid",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ CID: "14408248692727049506" }],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
      "name": "Empire State Building",
      "address": "20 W 34th St., New York, NY 10001",
      "rating": 4.7,
      "reviews_count": 98500,
      "latitude": 40.7484405,
      "longitude": -73.9856644,
      "url": "https://www.google.com/maps/place/?q=place_id:ChIJaXQRs6lZwokRY6EFpJnhNNE"
    }
  ]
  ```
</ResponseExample>


# Discover Google Maps Places by Location
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-discover-by-location

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Google Maps places by geographic location. POST /datasets/v3/scrape returns place records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m8ebnr0q2qlklc02fz` to discover **Google Maps places by location**.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `location`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      ISO 3166-1 alpha-2 country code (e.g., `US`, `GB`, `DE`).
    </ParamField>

    <ParamField type="number">
      Latitude of the search center.
    </ParamField>

    <ParamField type="number">
      Longitude of the search center.
    </ParamField>

    <ParamField type="number">
      Google Maps zoom level (typically 10 to 18).
    </ParamField>

    <ParamField type="string">
      Search term to find nearby places (e.g., `coffee shop`, `pharmacy`).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"country": "US", "lat": 40.7484, "long": -73.9857, "zoom_level": 14, "keyword": "coffee shop"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"country":"US","lat":40.7484,"long":-73.9857,"zoom_level":14,"keyword":"coffee shop"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&notify=false&include_errors=true&type=discover_new&discover_by=location"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_m8ebnr0q2qlklc02fz",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "location",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "country": "US",
                  "lat": 40.7484,
                  "long": -73.9857,
                  "zoom_level": 14,
                  "keyword": "coffee shop",
              },
          ],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_m8ebnr0q2qlklc02fz",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "location",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [
        {
          country: "US",
          lat: 40.7484,
          long: -73.9857,
          zoom_level: 14,
          keyword: "coffee shop",
        },
      ],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "place_id": "ChIJExample123",
      "name": "Blue Bottle Coffee",
      "address": "54 W 40th St., New York, NY 10018",
      "rating": 4.4,
      "reviews_count": 520,
      "category": "Coffee shop",
      "latitude": 40.7525,
      "longitude": -73.984
    }
  ]
  ```
</ResponseExample>


# Discover Google Maps Places by place_id
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-discover-by-place-id

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Google Maps places by place_id. POST /datasets/v3/scrape returns structured place records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m8ebnr0q2qlklc02fz` to discover **Google Maps places by place\_id**.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `place_id`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Google Maps place ID for the location.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"place_id":"ChIJS5WVcqWh9YgRHU08rJqLNsQ"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m8ebnr0q2qlklc02fz&notify=false&include_errors=true&type=discover_new&discover_by=place_id"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_m8ebnr0q2qlklc02fz",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "place_id",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [{"place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ"}],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_m8ebnr0q2qlklc02fz",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "place_id",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ place_id: "ChIJS5WVcqWh9YgRHU08rJqLNsQ" }],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "place_id": "ChIJS5WVcqWh9YgRHU08rJqLNsQ",
      "name": "Example Place",
      "address": "123 Example St., New York, NY",
      "rating": 4.5,
      "reviews_count": 1200,
      "latitude": 40.7128,
      "longitude": -74.006
    }
  ]
  ```
</ResponseExample>


# Scrape Google Maps reviews by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-maps-reviews-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Google Maps reviews by URL. POST /datasets/v3/scrape returns structured review records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_luzfs1dn2oa0teb81` to collect **Google Maps reviews by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The full URL of the Google Maps place whose reviews you want to scrape.
    </ParamField>

    <ParamField type="number">
      Only return reviews posted within the last N days. Omit to retrieve all reviews.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.google.com/maps/place/Empire+State+Building", "days_limit": 30}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
      "place_name": "Empire State Building",
      "review_id": "ChZDSUhNMG9nS0VJQ0FnSURleDdtVURBEAE",
      "reviewer_name": "Jane Doe",
      "reviewer_url": "https://www.google.com/maps/contrib/123456789",
      "rating": 5,
      "review_text": "Great view of the city.",
      "review_date": "2026-03-28T14:12:00Z",
      "likes": 12,
      "photos": []
    }
  ]
  ```
</ResponseExample>


# Scrape Google SERP 100 results by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-serp-100-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect up to 100 organic Google search results per query. POST /datasets/v3/scrape returns results as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_mfz5x93lmsjjjylob` to collect **Google SERP 100 results by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Google Search URL to scrape.
    </ParamField>

    <ParamField type="string">
      The search keyword used in the query.
    </ParamField>

    <ParamField type="string">
      Google `tbm` (to-be-matched) parameter. Leave empty for web results, or set to `isch` for images, `nws` for news, etc.
    </ParamField>

    <ParamField type="string">
      Language code (e.g., `en`, `es`, `de`).
    </ParamField>

    <ParamField type="string">
      UULE parameter for geographic targeting.
    </ParamField>

    <ParamField type="string">
      Device targeting. Leave empty for desktop, set to `1` for mobile.
    </ParamField>

    <ParamField type="string">
      Google `tbs` parameter for time-based filtering (e.g., `qdr:d` for past day).
    </ParamField>

    <ParamField type="string">
      Set to `1` to disable Google's auto-correct.
    </ParamField>

    <ParamField type="string">
      Result index / starting position.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {
        "url": "https://www.google.com/search?q=best+coffee+nyc",
        "keyword": "best coffee nyc",
        "tbm": "",
        "language": "en",
        "uule": "",
        "brd_mobile": "",
        "tbs": "",
        "nfpr": "",
        "index": ""
      }
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "keyword": "best coffee nyc",
      "results": [
        {
          "position": 1,
          "title": "The 38 Best Coffee Shops in NYC",
          "link": "https://example.com/best-coffee-nyc",
          "display_link": "example.com",
          "description": "Our picks for the top coffee shops in New York City."
        }
      ],
      "total_results": 100
    }
  ]
  ```
</ResponseExample>


# Scrape Google Shopping products by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-shopping-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect Google Shopping products by URL. POST /datasets/v3/scrape returns structured product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_ltppk50q18kdw67omz` to collect **Google Shopping products by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The full URL of the Google Shopping product page.
    </ParamField>

    <ParamField type="string">
      ISO 3166-1 alpha-2 country code for localized pricing and availability.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.google.com/shopping/product/12345", "country": "US"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "product_id": "12345",
      "title": "Wireless Noise-Cancelling Headphones",
      "brand": "Acme",
      "rating": 4.5,
      "reviews_count": 1240,
      "price": "249.99",
      "currency": "USD",
      "sellers": [],
      "specifications": {},
      "url": "https://www.google.com/shopping/product/12345"
    }
  ]
  ```
</ResponseExample>


# Discover Google Shopping by keyword
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-shopping-discover-by-keyword

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to discover Google Shopping products by keyword. POST /datasets/v3/scrape returns product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_ltppk50q18kdw67omz` to discover **Google Shopping products by keyword**.
  </Warning>
</ParamField>

<ParamField type="string">
  Must be set to `discover_new`.
</ParamField>

<ParamField type="string">
  Must be set to `keyword`.
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The search term to find matching Google Shopping products.
    </ParamField>

    <ParamField type="string">
      ISO 3166-1 alpha-2 country code for localized results.
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"keyword": "wireless headphones", "country": "US"}
    ]
  }
  ```
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"input":[{"keyword":"wireless headphones","country":"US"}],"limit_per_input":10}' \
    "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_ltppk50q18kdw67omz&notify=false&include_errors=true&type=discover_new&discover_by=keyword"
  ```

  ```python Python (requests) theme={null}
  import requests

  response = requests.post(
      "https://api.brightdata.com/datasets/v3/scrape",
      params={
          "dataset_id": "gd_ltppk50q18kdw67omz",
          "notify": "false",
          "include_errors": "true",
          "type": "discover_new",
          "discover_by": "keyword",
      },
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "input": [
              {
                  "keyword": "wireless headphones",
                  "country": "US",
              },
          ],
          "limit_per_input": 10,
      },
  )

  print(response.text)
  ```

  ```javascript Node.js (fetch) theme={null}
  const params = new URLSearchParams({
    dataset_id: "gd_ltppk50q18kdw67omz",
    notify: "false",
    include_errors: "true",
    type: "discover_new",
    discover_by: "keyword",
  });

  const response = await fetch(`https://api.brightdata.com/datasets/v3/scrape?${params}`, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: [{ keyword: "wireless headphones", country: "US" }],
      limit_per_input: 10,
    }),
  });

  console.log(await response.text());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "product_id": "54321",
      "title": "Sony WH-1000XM5 Wireless Headphones",
      "brand": "Sony",
      "rating": 4.7,
      "reviews_count": 8400,
      "price": "349.99",
      "currency": "USD",
      "url": "https://www.google.com/shopping/product/54321"
    }
  ]
  ```
</ResponseExample>


# Scrape Google Shopping search (US) by URL
Source: https://docs.brightdata.com/api-reference/scrapers/search-engines-apis/google-shopping-products-search-us-collect-by-url

POST https://api.brightdata.com/datasets/v3/scrape
Use the Bright Data Scraper API to collect US Google Shopping search results by URL. POST /datasets/v3/scrape returns product records as JSON.

## Query Parameters

<ParamField type="string">
  The dataset ID used for this request.

  <Warning>
    Must be set to `gd_m31f2k0d2m1bah4f3b` to collect **Google Shopping Products Search US by URL**.
  </Warning>
</ParamField>

<ParamField type="boolean">
  Whether to send notifications when the request is completed.
</ParamField>

<ParamField type="boolean">
  Whether to include errors in the response.
</ParamField>

## Request Body

<ParamField type="object[]">
  An array of input objects.

  <Expandable title="properties">
    <ParamField type="string">
      The Google Shopping search URL to scrape (e.g., `https://www.google.com/search?tbm=shop&q=...`).
    </ParamField>
  </Expandable>

  #### Example

  ```json wrap theme={null}
  {
    "input": [
      {"url": "https://www.google.com/search?tbm=shop&q=wireless+headphones"}
    ]
  }
  ```
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "query": "wireless headphones",
      "position": 1,
      "title": "Sony WH-1000XM5 Wireless Headphones",
      "merchant": "Best Buy",
      "price": "349.99",
      "currency": "USD",
      "rating": 4.7,
      "reviews_count": 1820,
      "product_url": "https://www.google.com/shopping/product/54321"
    }
  ]
  ```
</ResponseExample>


# Google Maps async request
Source: https://docs.brightdata.com/api-reference/serp/google-maps/async

Use the Bright Data Google Maps async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Coordinates
Source: https://docs.brightdata.com/api-reference/serp/google-maps/coordinates

Configure the Bright Data Google Maps Coordinates parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Parameters defining GPS coordinates of a search location. It should be constucted the following way: `@ + latitude + , + longitude + , + zoom`.

  > Example:
  >
  > `@47.30227,1.67458,14.00z`

  ```txt wrap theme={null}
  https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/@47.30227,1.67458,14.00z",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/@47.30227,1.67458,14.00z',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/@47.30227,1.67458,14.00z',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Filtering
Source: https://docs.brightdata.com/api-reference/serp/google-maps/filtering

Configure the Bright Data Google Maps Filtering parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Accomodation type: Hotels or Vacation Rentals.

  > **Examples:**\
  > `brd_accommodation_type=hotels` (default) - search for Hotels \
  > `brd_accommodation_type=vacation_rentals` - search for Vacation Rentals

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/?brd_accommodation_type=vacation_rentals',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps localization
Source: https://docs.brightdata.com/api-reference/serp/google-maps/localization

Configure the Bright Data Google Maps Google Maps localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?gl=us
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?hl=en
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/&gl=us&hl=en',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps pagination
Source: https://docs.brightdata.com/api-reference/serp/google-maps/pagination

Configure the Bright Data Google Maps Google Maps pagination parameter to refine queries and return matching results as JSON or HTML. On port 44445.

<Danger>
  **Pagination parameters deprecated on December, 15th 2025.**
</Danger>

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/?start=20
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Define the result offset - results to start from the selected value. Used for managing pagination.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?start=20
  ```
</ParamField>

<ParamField type="string">
  <Warning>
    **Deprecated As of September 11, 2025 by Google**

    * The Number of results to return is usually 10, results' set size may vary.
    * The `start` parameters can be used to paginate within results' set. 
    * To get top 100 results, Bright Data offes a Web Scraping API. Read more here: [Get top google 100 results in one API call](/products/serp-api/get-top-100-google-results)
  </Warning>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/?start=20",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/?start=20"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/?start=20',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/?start=20',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-maps/parsed-json

Configure the Bright Data Google Maps Google Maps parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york/?brd_json=json
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?brd_json=json
  ```

  | value | description |
  | - | - |
  | `html` (default) | Returns the standard HTML response from Google Maps. |
  | `json` | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york/?brd_json=json",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york/?brd_json=json"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york/?brd_json=json',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york/?brd_json=json',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Place details
Source: https://docs.brightdata.com/api-reference/serp/google-maps/place-details

Configure the Bright Data Google Maps Place Details parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.
</ParamField>

<ParamField type="string">
  Get the results of a Google Maps Place by `fid`.

  ```txt wrap theme={null}
  http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Maps text search
Source: https://docs.brightdata.com/api-reference/serp/google-maps/text-search

Configure the Bright Data Google Maps Google Maps text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/maps/search/hotels+new+york
```

## Parameters

<ParamField type="string">
  The search path parameter. Specifies the keyword or phrase you want to search for on Google Maps.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/maps/search/hotels+new+york",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/maps/search/hotels+new+york"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/maps/search/hotels+new+york',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/maps/search/hotels+new+york',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Google Reviews localization
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/localization

Configure the Bright Data Google Reviews Google Reviews localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  Preferred language, two-letter language code

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&hl=de',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xOT2RtRlllRFJKYTBnMWFrWnhhRnBtWkVGdmFuYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjV5gtd6dYV7Lvhu20tzKXYYwMuI09-X0aFVeeZHhGHlQc15qxCD=s120-c-rp-mo-ba4-br100",
          "display_name": "N. D.",
          "link": "https://www.google.com/maps/contrib/106942246120347351039?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xOT2RtRlllRFJKYTBnMWFrWnhhRnBtWkVGdmFuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlNOdmFYeDRJa0g1akZxaFpmZEFvanc%7C0d8Sijb1Tmu%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "vor 3 Monaten",
        "date": "2025-11-25",
        "comment": "Hilton, wie man es kennt. Auch in seiner Preisklasse. Günstig und gut geht wo anders auch. Die Lage ist top! Zimmer leider ohne Kaffeemaschine. Im Zuge einer mehrtägigen Veranstaltung kam klar zum Vorschein, dass sich der Aufzug zu einer zeitlichen Herausforderung gestaltet...um nicht zu sagen, eine Katastrophe ist. Ein Grund, warum vereinzelt Teilnehmer ein Hotel gegenüber gebucht haben.\nGrundsätzlich ein freundlicher Empfang.\nWovon wir klar Abstand genommen haben, war der hausinterne \"Markt\". Da sind Apothekenpreise noch harmlos. Hier haben wir zwei Straßen weiter einen genialen Supermarkt entdeckt, der keine Wünsche offen läßt, um die Minibar zu füllen, welche übrigens total leer war...zu unserer leichten Enttäuschung.\nAlles in allem sieht mich NYC definiv wieder. Stadtverliebt...",
        "review_reply": "Thank you for being our guest and sharing your experience. We’re glad to hear the fantastic location and the friendliness of the team stood out during your visit. At the same time, we understand that not everything met your expectations. Your notes are helpful as we continue looking for ways to enhance comfort and ease for our guests. We appreciate your perspective and hope that on your next trip to New York, we can offer a stay that feels more in line with what you were hoping for.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 2 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvpZEDxYyKaTlHOKBSsxcgHubulSh0cH-6nZfs15bae6xs3C3nylcZDXqbo-selkWUd24v0uv4V4qtZF2al3U5D8fM323pCe1TdaJW99h9w-ew5ySoGuxFl027PwBdygbM4NArzr6YRuE4D",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puhfI4e--YHFvELu8JP1DuD0bysmpmf6sKVqIHHe9XRFda3sIUCqSSrMuseUSuCPCuk9mDwxjHpmMFCsCEVUyl2GQ7H3vtELTMz5SXnGbMhrOkUkPKBhh7b52J9m1FBJ4bp28TPEQ2jy-o8",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psL1uA4fh-0XpvIIgXgvbrfyfu8ZZFcKbLoxFH5eLfgKqQuJMwjvvTfvCFcbqjHKxvNkJWxQ4kf55NNHl2Gvg3Q3p9xPk2dyX-Q_B-OWARWyiA0ozlLXPKG8z2Go_xWaU622o_i39eeI5xx",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psB_6iJsBELQK1zS5xbnZ_LPMMPONHzb4C1ghMv0faDDWbrjmlUUkp5SiMcIKsXhn05Go0ufdZfSz77mlhLDGL3WYCiLBv8Y-FJK1dLACGANd0162Icgf3-I-DV-EHaN8tG4QwzFMASc5mr",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psWWyPJKenSWHpuhSiMDwL7YO30Zo-EhP7XUmi_ItNtoxH-cdoBC8JozSG1I0wmDFXkkqUYR29DlC1i7MRk5gldyoO1SatJi1qH6XTz92jZ9NYxPjLbgekethhpv_Jz4thE5pbcavCKbKIp",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptrEZAHF1Otczr7nZfe28InIQxJJbGJcu2_I-I36vCKuJmmy0P1LOK_wHTMF9XYtZN1ncD-98tqqajaERqMWRXNyyonDuqRY0pYhBrQbRj9FBbm42-GQzoeomcCD1H3Lg18Aby4alDGdx8o",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psE3NHBwTsHFja_pvrFIise1G49AdT_SZKL1O8hqbBcZi_7z-yZSNmVn-TDtGnWeN9dHf7hDv7lGImfQ8aI0Q3cpqB4zgN_BQxbWAhU_rLSlQkKjY8l8zLlJOGf96gWX8fPGtpV0GM7eC0",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptS7vepoKIIouTw3QI1YljuGIxlDRT9dB6KDP_XUAB3U_ZpyFAN3GxnuCAi8r8v8wkD_iP6FeGT8AA9MlHhxQjOyn-HbHHCAWXXVrS_1hCrHXA86pJISBhq9b9c2wpvVkLqftyvu9teOsk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptplZxq6BJfuS0lHOrT1KPoqOJaVCJq4sYwmgCnmGoR_xNGtex9qchVOK1uWYOLavuGWsFnT2MWDT4jdPuzNZVJpFo0Ei20pEcikIx2HaUMeey1L-IvFQm3LLQc1__8TX17YL6N4GYaZ414",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptFFXdZjlLLduDMpWuEihSoiqDFMUCuf2C9Cra4cIfcccC8vf_YjLiZkWSKsNwj1n6YOp3E8DAAyc4bFcHNfojavHR2KUn2ZUJS613mtqvCip-QHipfMlo7iPHTS4jbXOo4_sLsds_rHeY",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvhl2Wh1brqS8bDEx4NP965YmveHI8P5Nwt3iBNbswIr3Sg5mVs32ZJWad8J3bZU10iY5hseYLpmVpfMdjgsqU_sDirBdAOGqMes7ozc3sR9orLJxFgNATJTbAr2ey6_IGyBS0OEy4mIEEG",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puVR5Y3LtcLgO0wnmgmMgqBywKUyE42S0Lpt1k8qxFdCyn6sxloTpf0YcSeM6VHxaDDLu2j13neeGsLuTbdj-odZcKbfrYIiTyXF6gK06T7Jea_yYe2Itg_Sx6-Qgtvm2Zvn3oC9J2kyLw",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ps7T-wnjBv5_slqJoxIozJaSbwMC_Sd4ISGZGA10sTsy_RWu-xk7Kl3XdAzpgxQ1vb8HhAbIC9rez74UVQ-2MK5sXeQdDS29KV8HcOhpJGOO8niRxVDbXov8FKqyY4FvcUV9v_vqOsz2ko",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puus1ZsNNi3ZCr2AE_65NRdF0vO3ryUBsNH2qORCYCA3kmXhvEZJ1pznvkIA-e-TzZwNb6EOSyzo9OOVCyAwML49PFWzYb6gDAzgC5YoZ6utY5nV6wuj8adcGSaniqTKdidhyv--3-lsF8",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvs8LdtDTe_iOCcTBcLg8H6HjLBaUghNhqm5gOBQGcTT4kHz2J4Gk1H_QExDBw_1jzuZdMBJmNbw2-KvNzWb0gMsala8N56-W2V3w378yGmx88Q2tQd05xE8JfJlzciHLXBHfsX1apJnlGj",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psclG3styp6D8_5YEskDQUVXvsPgXx81MRK05-fW-xwKohAQManSe7_c0ZBMqHcpWbs5Sca7I28Gh1QYyix31JvmwzSh12cemXFpOwcADJBqvFh9NvfY0aD0Ut7JaTBg0X2rke3vbph0NI",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvPOYSp6GVL5G-itJhCw3L_8-QOumiHAW4F_w6dYCJL0Ejmz8Rpc-akxPGIsN_HxNspYTRt1liMjI4gSpK6l43i94wb9kVVBWyeqMmv-Fi4-4scmRRUEzTLsKqJfhekfOpY5l8_CpPx-Z_b",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pubaRCKu5RRi6mU2GvpU2cB3H-Zq3uVg7hVN1wLO-IX-69mqg-xZm61P6D3e9lAr6IfGX9MucrVT_stsDGNemajfPOOcMErEt8dpjDvTPZxNlO3wRjhQeFx8CYQe9DNGfj-2iB9fTEw_MhJ",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvTiwRW5gBdU8FcfXATTeRg5S8yhXp-OewD2S_rPpViX_9DvP0ZKSXh_CDXIFDvdQlRfg3KRid2Zpk7aePImG1LIXA8xO04gPOBUh30v_4kBgCtcLZB79Yw0hGeYS95FrgX4k7ctTFpJT-Q"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Freunde",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 5,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25sWU5uTllSRlpUZVdneU0xcGtYMnd0U1hjME5tYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUjlW4WZmDBdrEBK7d5iYy8JHcticI0r09r7TcMWUWh3H-Lak_I=s120-c-rp-mo-ba3-br100",
          "display_name": "Ismail S.",
          "link": "https://www.google.com/maps/contrib/100086937401926490816?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25sWU5uTllSRlpUZVdneU0xcGtYMnd0U1hjME5tYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnlYNnNYRFZTeWgyM1pkX2wtSXc0Nmc%7C0cm1N412Eoc%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Bearbeitet: vor 5 Monaten",
        "comment": "Die Einrichtung im Zimmer sind leider sehr alt. Keine Steckdosen neben dem Bett. Lampe und Fön funktionieren nicht.\nPro: gute Lage zum Central Park, Times Square und Rockerfella Center.\nServicekräfte des Hotels sehr nett.",
        "review_reply": "Thank you very much for sharing your feedback with us. We’re glad to hear you enjoyed our central location near Central Park, Times Square, and Rockefeller Center, as well as the friendliness of our service team.\n\nWe’re sorry to learn that the furnishings and in-room amenities did not meet your expectations, and we appreciate you bringing the lamp and hair dryer issues to our attention. Your comments will help us make improvements to ensure a more comfortable stay for our future guests.\n\nWe hope to have the opportunity to welcome you back again and provide an even better experience.",
        "review_reply_created": "vor 5 Monaten",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 2,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 4,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25VMFYzQmZjblZHU2xOa2JISnZibGRyVEMxaldrRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjWV7TMK61cNjegRN1_oXpJNL31nlzqzW6d1iTTC-UsyAAozVfs=s120-c-rp-mo-ba5-br100",
          "display_name": "Sonja Dürr",
          "link": "https://www.google.com/maps/contrib/102283591874141539400?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25VMFYzQmZjblZHU2xOa2JISnZibGRyVEMxaldrRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnU0V3BfcnVGSlNkbHJvbldrTC1jWkE%7C0d7MTqp5WU7%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "vor 3 Monaten",
        "date": "2025-11-22",
        "comment": "Zimmer für NY wirklich gross, die Lage ist gut.\nDie Zimmer, Einrichtung sind allerdings sehr abgenutzt.\nDie Preise im Restaurantbereich sind happig, aber Starbucks ist direkt um die Ecke.",
        "review_reply": "Dear Sonja,\nThank you for choosing New York Hilton Midtown and for sharing your valuable feedback. While we are sorry your stay wasn't quite perfect, we are happy you enjoyed our fantastic location and spacious accommodations. We are continually working to improve, and your comments help us know where to focus our efforts. We look forward to being your \"go-to\" place to stay on future trips to NYC.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 3 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pux295aI8VAKS3CWZVuHHg2iJwXdvcM3Z-Bq7QsebDsJif_XY0fBaPaGjHt649a5HPmguobH70SyvUw0ZK-FX7g5AN9rXYsGqBDoVHpTf1bSRnbibmVBKI0YGUynqe-1wDkKkcAY9J6mQJI"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 5,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKNmx3dGZHdE5tM3JnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdCjMUwIiBikRhCLHgN_0vyGAo1GvT8DEukiKQb1ujC_eFsFjYrQ0OvLoSxPtqmCdgvFA=s120-c-br100",
          "display_name": "K4274CPbenjaminm",
          "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r1022439626?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de"
        },
        "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r1022439626?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "1/5",
        "created": "vor 6 Monaten",
        "comment": "Hotel in schlechtem Zustand, Renovierung überfällig: musste zweimal das Zimmer wechseln, im ersten hat es furchtbar moderig gerochen, im zweiten war die Dusche defekt, es hat über eine Stunde gedauert bis ich letztlich ein drittes bekommen habe mit verschimmelten Fugen in der Dusche und altem Duschvorhang, alles in schlechtem Zustand. Hier kommt hinzu dass der Service absolut schlecht ist und sich noch nicht mal für meine Beschwerde entschuldigt hatte. Einzig die Lage ist positiv hervorzuheben. Alles in allem sportlicher Preis für ein schlechtes Hotel, das dem Markennamen Hilton absolut nicht gerecht wird."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tSUVZsUnhaWGxvYlVWaldtTkRWQzFEYUhoNlFXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJpSWnm_TLvPgWnG_WtYabL505Nx9JyMHMbeJn0yzk8ycarrQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Katharina H.",
          "link": "https://www.google.com/maps/contrib/107438252515681568592?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSUVZsUnhaWGxvYlVWaldtTkRWQzFEYUhoNlFXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkRQVlRxZXlobUVjWmNDVC1DaHh6QWc%7C0cxt0oRBBtx%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "vor 4 Monaten",
        "comment": "Wir hatten ein ruhiges Zimmer. Für drei Personen groß genug. Die Zimmerbeleuchtung war ungenügend und die Fahrstuhlwartezeiten lang.\nOptimaler Ausgangspunkt für Besichtigungen in Manhatten.",
        "review_reply": "Dear Katharina,\nThank you for sharing your thoughts with us. We are glad you appreciated our spacious accommodations and peaceful environment in the city. It was a pleasure having you as a guest, and we look forward to welcoming you back for an even more exceptional visit in the future.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 4 Monaten",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 4,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tGalowOUdYMmxXUjI1aVh6aExPRkpRTVY5Sk9GRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjVmtAB8AXA5ZvOm6ghmukAtEDbWPKD_ZXaenKTdm1xxzhvEN7Ti=s120-c-rp-mo-ba5-br100",
          "display_name": "Claudia „CW“ Winter",
          "link": "https://www.google.com/maps/contrib/101770904039323526520?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tGalowOUdYMmxXUjI1aVh6aExPRkpRTVY5Sk9GRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkFjZ09GX2lWR25iXzhLOFJQMV9JOFE%7C0cnJVHEw1wA%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "vor 5 Monaten",
        "comment": "Der perfekte Hotel für New York Sightseeing! Direkt am MoMA und parallel zur 5th und Broadway. Subway in allen Richtungen in der Nähe! Central Park um die Ecke. Passt.\nDas Hotel ist okay, aber top Service, sauber und ordentlich!\nGeräuschabsorbierende Fenster wären allerdings toll!!!",
        "review_reply": "Dear Claudia,\nThank you so much for your recent stay at New York Hilton Midtown. We’re delighted to have been a small part of your amazing trip. It’s wonderful to hear that our central location made it easy for you to explore the city. We know how much convenience matters when traveling. We also appreciate your kind words about our staff. Our team takes great pride in going above and beyond to provide every guest with exceptional service. With the hotel located in the heart of Manhattan, the city’s energy and vibrancy can sometimes bring extra noise, and we sincerely apologize for any inconvenience this may have caused. Thank you again for your thoughtful review, and we look forward to welcoming you back on your next visit to New York City.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 5 Monaten",
        "details": [
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Familie",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 4,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Zimmer",
            "value": "Okay, zu dritt machbar!\nAn Ausstattung fehlt nichts!",
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Aktivitäten in der Nähe",
            "value": "MoMA, Broadway, Central Park, 5 the Avenue",
            "description": "Aktivitäten in der Nähe"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Sicherheit",
            "value": "Sehr sicher!",
            "description": "Sicherheit"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Fußläufigkeit",
            "value": "Vieles s. Stadtplan",
            "description": "Fußläufigkeit"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_FOOD_AND_DRINKS",
            "name": "Speisen und Getränke",
            "value": "Ist gesorgt.",
            "description": "Speisen und Getränke"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Highlights des Hotels",
            "value": "Gutes Preis-Leistungs-Verhält.",
            "description": "Wie würdest du das Hotel beschreiben?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21aSldraGtWVmhJVmxsNFZHVnlVa1kyZVZKa1JtYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIDHdg1hHG__X5gKEg30yEArZkJfh3U0QDEfAzBCqCWsecZcQ=s120-c-rp-mo-ba2-br100",
          "display_name": "Susanne Weber",
          "link": "https://www.google.com/maps/contrib/100391510259633012665?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21aSldraGtWVmhJVmxsNFZHVnlVa1kyZVZKa1JtYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmZJWkhkVVhIVll4VGVyUkY2eVJkRmc%7C0ckBmsSzIH4%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "vor 5 Monaten",
        "comment": "Das Zimmer ist etwas älter und herabgekommen. Der Service allerdings top.\nDie Lage ist super viele Essens Möglichkeiten und zum Times Square braucht man zu Fuß ca. 10 Minuten.",
        "review_reply": "Thank you for sharing your feedback with us. We’re happy to hear you enjoyed our convenient location with many dining options nearby and just a short walk to Times Square. We’re also especially pleased that our service team made a positive impression during your stay.\n\nWe appreciate your comments regarding the condition of the room and will certainly keep them in mind as we continue to make improvements. Your input is very valuable to us.\n\nWe hope to have the pleasure of welcoming you again on your next visit to New York.",
        "review_reply_created": "vor 5 Monaten",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 2,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 4,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21aTlFXTk9kMFZOWmxwMVUxaHpNRlYwYURORlEyYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjW5NjVfqYWafONdXqb_FIJQrKBgmu0EYM4mDa_Y2ajFVoGE5IQ=s120-c-rp-mo-br100",
          "display_name": "K W",
          "link": "https://www.google.com/maps/contrib/114251727041856868421?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21aTlFXTk9kMFZOWmxwMVUxaHpNRlYwYURORlEyYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmZNQWNOd0VNZlp1U1hzMFV0aDNFQ2c%7C0d4bRMrp-ze%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "vor 3 Monaten",
        "date": "2025-11-14",
        "comment": "Business-Hotel in Superlage in Midtown, leider komplett abgenutzt, abgewetzte, durchgesessene Stühle in Restaurants, abgebatzte Tische, eines Hilton-Hotels nicht würdig, altes, spartanisch ausgestattetes Zimmer, weit von Hilton-Standard entfernt, freundliches Personal in Restaurants, extrem lange Wartezeiten am Lift, für einen angeblichen early Check-in ( Ankunft ca.15.00 Uhr ?!) wurden kommentarlos 62 $ liquidiert, eine Frechheit, schlechte Preis-Leistungsrelation, absolut enttäuschend, wir sind noch nie in einem derart heruntergekommenen Hilton-Hotel zu solch stolzen Preisen untergekommen,",
        "review_reply": "Thank you for sharing your feedback with us. While we are glad that our team made a positive impression with their friendliness, we are sorry that your stay did not meet your expectations. The comfort and satisfaction of our guests are extremely important to us, and we regret that the condition of the room and restaurant furnishings, as well as the elevator wait times, left you disappointed. Please be assured that your comments have been shared with our team as we strive to make improvements for the benefit of our guests. Regarding the charge you mentioned, we would like to clarify that a Daily Mandatory Destination Charge is added to the room rate. This fee includes premium guest internet access, a daily food and beverage credit for use at our hotel restaurant, bar, and lounge, and local, toll-free, and domestic long-distance phone calls. We apologize if this was not clearly communicated at check-in. We truly appreciate your feedback and hope you will consider giving us another opportunity to provide you with a significantly improved experience in the future. \n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "vor 3 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psD99uhp4c6bAv0MfdVqwaMtWuBIYiDtTfsPsKEdWxseOANkyYEm8whJuoagC4sG3tzDoBaLWp8yZo-3skl7lMThHTpzJlb8DHdPqM1Y9kkEvbk122E1vgzZgT6YvieRLA9v3VoQZjDspM",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psrUoxUdtiMo4y87m0yMYNV7BwN-aKu-qfYQ61clp_ekR3ErP24zGyyvhKcK0-goSwuz6m5Acw6fGo0N5CndB7LDjD8azcs7gLXB7AjnAU7twQJ7dJQrGWWVIQ1PCWqueoS6ZjlTOX86hA"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 2,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 5,
            "description": "Standort"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Zimmer",
            "value": "Einfach ausgestattet und verwohnt, wenig und schwaches Licht",
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_FOOD_AND_DRINKS",
            "name": "Speisen und Getränke",
            "value": "Hochpreisige Selfservicetheke, einfache Speisekarte, insgesamt recht rustikales Ambiente, völlig durchgesessene, altes Sitzmobiliar",
            "description": "Speisen und Getränke"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Highlights des Hotels",
            "value": "Schöne Aussicht",
            "description": "Wie würdest du das Hotel beschreiben?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKa1FVTlZRekJxYkVwMmNVRnBSRk5OZEhNMFMxRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxgJM--MNqq2CXCjp564UgKU-0MM9ep-nva-7-XQFvAqJUWw=s120-c-rp-mo-br100",
          "display_name": "Nadina Diermann",
          "link": "https://www.google.com/maps/contrib/110667864867690310032?hl=de"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKa1FVTlZRekJxYkVwMmNVRnBSRk5OZEhNMFMxRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJkQUNVQzBqbEp2cUFpRFNNdHM0S1E%7C0cUxAXdB9a7%7C?hl=de",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "vor 7 Monaten",
        "date": "2025-07-22",
        "comment": "Auf gar keinen Fall dieses Hotel buchen!!\nWir hatten uns dafür entschieden, weil es sehr zentral liegt (fußläufig zum Times Square und Central Park) und auf den Bildern recht großzügig geschnittene Zimmer hatte. In dieser Lage sind alle Hotels ähnlich teuer, daher dachten wir, mit einem Hilton Hotel können wir nicht viel falsch machen.\n\nOh doch. Die Zimmer sind in der Tat groß und die Klimaanlage funktionierte gut, das ist aber auch schon das einzig positive, was man über dieses Haus sagen kann.\n\nZimmer:\nDas Zimmer war nicht geputzt und wurde während der Woche, die wir da waren auch nicht geputzt, fingerdicker Staub auf den Oberflächen, fleckige Lampenschirme & Rollos, Fettflecken auf dem Fenster, ein Krümel, der mir am ersten Tag herunterfiel lag 7 Tage später immer noch auf dem Teppich. Handtücher gab es zwar täglich neu, jedoch meist in zufällig gewählter Anzahl (mal 4, mal 3 mal 5) und ALLE hatten immer schwarze Flecken, die nicht von uns kamen (siehe Fotos). Auch auf den Bettlaken fanden sich diese. Die Minibar war leer und blieb leer, der Safe ging nur auf, wenn man die Tür der Kommode mit komplett ausgerissenem Scharnier in einem bestimmten Winkel geöffnet hat (siehe Foto). Ein klebriger Föhn wird bereitgestellt, Klobürste gibt es nicht und die Wände sind so dünn, dass man die Gäste im Nachbarzimmer schnarchen hört.\n\nAb 8:30 klopft der Roomservice, ob man schon fertig sei, was wir als Urlaubsgäste schon sehr früh fanden, zumal ja offenbar nichts geputzt wurde.\n\nRestliche Räumlichkeiten:\nAuch im restlichen Hotel ist alles in die Jahre gekommen und sehr lieblos. Die Lobby hat mehr von einer Bahnhofshalle, es schieben sich ständig Massen hindurch (Tagungsgäste, Schulklassen, Einzelreisende etc.) und um einen Rezeptionisten zu sprechen muss man sich wie im Freizeitpark in ein Warteschlangen-Leitsystem aus Gurten einfädeln. Um mit dem passenden Aufzug zu unserem Zimmer zu fahren mussten wir teilweise 10-15 Minuten anstehen und warten. Die Bar im Erdgeschoss wirkt eher wie eine Sportsbar, Wellnessbereich gibt es keinen und in den Fluren hat man die abblätternde Tapete mit Klebeband geklebt (siehe Foto).\n\nPreise:\nBeim Check in wurde uns mitgeteilt, dass es erforderlich sei, eine Kaution zu hinterlegen. Soweit nicht unüblich. Aber der Mitarbeiter wollte 100$ pro Nacht! Wir waren eine Woche dort und somit wurden direkt 700$ auf der Kreditkarte belastet! Das wurde bei der Buchung mit keiner Silbe erwähnt, und wir fanden das wirklich einen unverschämten Betrag, erst recht, nachdem wir das Zimmer gesehen hatten. Sowas müssen sich Leute ggf. in ihr Reisebudget einplanen, für 14 Tage wären direkt 1.400$ belastet worden, in den ersten 10 Minuten des Aufenthalts. Nachdem die Minibar ja leer war und es zwar einen Eisspender gibt, dies aber eins der wenigen Hotels in New York zu sein scheint, das keinen Wasserspender anbietet, wollten wir im Hotel-Kiosk eine Flasche Wasser kaufen. Die günstigste 1 Liter Plastik-Flasche Wasser kostete sage und schreibe 10,30$ (!) Für Wasser. Das es in den meisten anderen Hotels gratis gibt. Eine bodenlose Unverschämtheit.\n\nAm letzten Tag waren wir auf die Gepäckaufbewahrung angewiesen, da unser Flug erst Abends ging. Kostete 5 $ pro Gepäckstück. Wir hatten jeder einen Rucksack und einen Koffer, also nochmal 20$. Und man wird nochmal freundlich darauf hingewiesen, dass trotzdem keine Haftung besteht, wenn das Gepäck am Ende weg oder beschädigt ist (siehe Foto).\nIch habe in meinem Leben noch nie als Gast für Gepäckaufbewahrung im eigenen Hotel bezahlt, schon gar nicht in einem Hilton.\n\nDer ganze Aufenthalt war wirklich eine bodenlose Unverschämtheit, schmutzige Zimmer, völlig überfüllt, Zero Service und man versucht wo es nur geht dem Gast noch weitere Hundert Dollar aus der Tasche zu ziehen, für Leistungen die eigentlich selbstverständlich sind. Ohne Worte. Und alles zu einem stolzen Preis.\n\nBitte, bitte suchen Sie sich für das gleiche Geld ein ordentliches Hotel in der Nachbarschaft mit ggf. kleineren Zimmern, das Hotel ist sein Geld absolut nicht wert!!",
        "review_reply": "Thank you for taking the time to share such detailed feedback. I am truly sorry to hear about your disappointing experience during your stay with us.\n\nPlease accept our sincerest apologies for the cleanliness issues you encountered in your room, as well as for the overall condition and upkeep that fell far short of expectations. What you described is not reflective of the standards we strive to uphold, and I regret that we did not provide the quality and comfort you rightfully anticipated from a Hilton property.\n\nWe understand how frustrating these matters must have been and are committed to addressing them to prevent recurrence.\n\nWhile we realize this does not change your experience, I do hope you will give us an opportunity to restore your confidence in the future.\n\nSincerely,",
        "review_reply_created": "vor 7 Monaten",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pv9nlsgzWSFYx5qgh248fZn_NdZ0PblXCfkvu6LJw11KEU-w67Qul8TW4ZY7nkabkwR6fWAj7co6ZXL2OzmgTGSXFLZpt4WmV4YbVG04XiHHOYsPF-1LgCbOdvlL0iKWmhZ94NyefalVpxC",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puGFHIu940jqX0WVQb_LBLN_3HZptDZm9BtZ6yHn8CO2NgZHVbeYvbNqt_Oz6avzl9Hgzbm2KVBhSFl4TycSITq4Gmf9iEejSWh6LeA7epSVwGYFZURz4URM2SzkFBBLK6gE7tN99Jzw8E",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puDhUeyGlou3_1X-o69to-J56T18QHMw9ypdvPuze9H6GxBxZ97MulCDendHg9wZmfUvVLhm-QNiROlJesv4lk34fYlbw9QlKPHOU8lWIjGpsAhZWlAAfB_azRppjXFMstUaSPgV9iP80V0",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psyO0JBwHt8RN46oAZKM-L8KrylDSikVI3vPO6e5WrFreOG0XyyZ2n1m434xlT62kE6rvgKxKffAhrpokPDBcQoPUluGQWlw1BZOm3Bjj4U_9dMRRrtUzZdxm3UF6AGUP46-kPym_38zDgF",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptsosofwJjA-HqFhvsj94P3blZzq6GLLFKceT-o0R_TgHUkdCESNDir43DuNFC12SyLyZcx8vQbKlzBejQLOWNc8JdP_p5ZDN3T-_cAb5zizA6cBzTN_urdXLqBFfAFrz_wQnRQLgaI-AhI",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvpUH4L15r1729ydJPdoIbfie5oNq3EkL4eQXsQN-QVsvymF-FK6sWEdGldDsiNpCZspinezSelNwrQvap6WGc8Ob2tPHTvLT0MU4uLLDUWr97zGsZ5tmYb2at-z577OOioutRRMh849mtu",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9puFDADRqWtwqr2KSjqJJZV6HHujO14Sddj6i-M-GxkB8PVHQQLpnKIj_n-QubZ7WJGSnlHRaKIa4unBCt6e87rTx2xqE1PMUXh9iPlMfCf9jioxn09N33M6BMecdR0jE97XpcquyKnqxBBf"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Art der Reise",
            "value": "Urlaub",
            "description": "Welche Art von Reise hast du unternommen?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Reisegruppe",
            "value": "Paar",
            "description": "Mit wem bist du gereist?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Zimmer",
            "value": 1,
            "description": "Zimmer"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Standort",
            "value": 3,
            "description": "Standort"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnTURvNy1hYzRBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QewvQXK08PhtQgCu1fT7TcdWcgcaXdOmFk48xW5xlmLo-Eqy0UOp2YqveGvl0etYz5BzA=s120-c-br100",
          "display_name": "Vo10",
          "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r971507489?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de"
        },
        "link": "https://www.tripadvisor.de/ShowUserReviews-g60763-d611947-r971507489?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=PH&supul=de",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "vor einem Jahr",
        "comment": "Das Hotel liegt zentral in Midtown und ist mit der U-Bahn gut zu erreichen. |Das Personal an der Rezeption war freundlich und es gab zum Glück keine lange Wartezeit. |Zimmer und Bad waren sauber und es gab genügend Handtücher. Das Zimmer war zweckmäßig eingerichtet.|Hatte das Zimmer ohne Frühstück gebucht da es genügend Möglichkeiten zum Frühstücken in der Nähe gibt."
      }
    ]
  }
  ```
</ResponseExample>


# Sort (newest)
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/sort-newest

Configure the Bright Data Google Reviews Sort (Newest) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  The way reviews are sorted.

  | value | description |
  | - | - |
  | `sort=qualityScore` | most relevant first (`default`) |
  | `sort=newestFirst` | newest first |
  | `sort=ratingHigh` | highest rating first |
  | `sort=ratingLow` | lowest rating first |

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=newestFirst',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChZDSUhNMG9nS0VMbUVrYktvcXRqRlBREAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QeYuXGoFc9HnT35lAJ46cKDIsHY7nNIKUKz_f8yINNlqyrU48jCx-4ctPzihRKgde030w=s120-c-br100",
          "display_name": "Curiosity572892",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046632270?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046632270?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "a month ago",
        "comment": "Hotel is getting very dated. Overall staff was mediocre however I need to give a shout out to Jesus at the front desk. He was super helpful in finding a room that was ready. He really cared about getting my family and I a room after we were waiting a long time. He had a joyful attitude and was even great interacting with my kids while he worked on our problem. He was amazing! Thanks Jesus!"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VLLUVvZFgtdXFEeXVnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QchZeuqqdsc2mxTzAL46o1Zp-eQpx0fXItgIlFx_-eADsDQzpyjY9GuirM6XH9EgCdepg=s120-c-br100",
          "display_name": "dennisdel",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046213388?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046213388?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Mei at the front desk was the friendliest, most helpful person I’ve ever met who works at a Hilton Hotel!"
      },
      {
        "review_id": "ChZDSUhNMG9nS0VPYS16UFdEX0liYmZ3EAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdHDxxyBDO6igPA51sqxYAI1TTeuGvapT1sWSCJfPSgzOZltNlMhWmUDpj2A3v7zAw89g=s120-c-br100",
          "display_name": "GlobalCitizen426",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046073220?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1046073220?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "2/5",
        "created": "a month ago",
        "comment": "We've been visiting the city every year for 25 years for a conference. |In the past 5 years since we've all come back to our lives post Covid pandemic, it's just got worse at this property.||We travel extensively and while other properties around the country seem to be making improvements this property just gets worse.||Hey, Hilton - it's time for a renovation and you should get after it!  |You have the finances, so you should not delay this another year.||The housekeeping and customer service staff were 5 star!||This year we were not able to control our room thermostat - to run the AC, b/c wen we arrived it was sweltering hot in parts of the hotel b/c the outside temps were not that cold. We heard others complaining about the same.|The room thermostat stayed at 72-73 the entire time - with the windows cracked, which I've appreciated this feature at this hotel.|72 or 73 may work for some ppl in their homes,  but not in a high rise hotel.||The elevator system was new and completely inefficient - we were riding the service elevator most of the time.||If you're reading this Hilton, room 2737 needs a new bathroom door - there was obviously a water issue in the bathroom and the wood composite was buckling and coming through on the bottom of the door. The wallpaper was peeling and the tub and sink were both very old and worn, there black mold on the shower and sink."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKNndnb3FIa3N5d3J3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdCjMUwIiBikRhCLHgN_0vyGAo1GvT8DEukiKQb1ujC_eFsFjYrQ0OvLoSxPtqmCdgvFA=s120-c-br100",
          "display_name": "KimmyStephenson",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045867123?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045867123?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "a month ago",
        "comment": "Hgv owners reception not helpful and rooms not ready for 2hours after check in time  and a 35 minute wait for elevator at busy times"
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKUHY3SWZTeWUtQll3EAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "Drinehart",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045764208?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045764208?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Check-in was easy and staff were friendly. They were very accommodating, clean rooms and the location was perfect. We had a great trip."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VPTEVnZi1EbnI2VW5RRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qc_hSEOVyYt90T8jEI1lbdGPaVqSrwdtGLOma43xF2tT-AGCQEDWJCQ3qq81gsm_HjiWg=s120-c-br100",
          "display_name": "Y2952BWaprilg",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045763042?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045763042?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Hanna and Jesús were great- appreciate their humanity and gracious attitudes when I needed help pushing past a bureaucratic bottleneck"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
          "display_name": "LisaO964",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "a month ago",
        "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
      },
      {
        "review_id": "ChZDSUhNMG9nS0VPM084Tl9JazlHa0J3EAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfzjVLsS8e-67WTk0n2dtmoLvjFzQd1pnSZl8AzVxF0EXF41tQWWb2Gu3UnsT1rmBrWdQ=s120-c-br100",
          "display_name": "paultW1290QF",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045304354?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045304354?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=EG&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Luis M was the best person ever!|He took care of us like we were family!|He made our special trip. Fantastic!|My wife and I came into the city for the holiday weekend! Luis was able to navigate and inform us with what to do.|He made the accommodations just perfect!"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQZkNuSlc0X3ZMdDRBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfP3vr22Hqep_LgQRKpenb6hspMso2yBvcYnK0_hQDygjr_RJAumA99e80czV94otF4IDs=s120-c-br100",
          "display_name": "\"\"",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "7/10",
        "created": "a month ago",
        "comment": "Positive: Convenient location. Negative: The elevator wait times/ lines could be very long. The room was cold and we couldn’t control the temperature which is particularly difficult to come back to after a day outside in the winter."
      }
    ]
  }
  ```
</ResponseExample>


# Google Reviews text search
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/text-search

Configure the Bright Data Google Reviews Google Reviews text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXfHOWf_k3xFLr7N87GuvjsQHzsDSZb3FW1zjSl6LV32uKV4qI=s120-c-rp-mo-ba4-br100",
          "display_name": "Brian Ash",
          "link": "https://www.google.com/maps/contrib/109749787540014073287?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkQ4TU9uTTNuazJUWGoyZWtyN3Rrdnc%7C0dK0Oisp5f4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "a month ago",
        "date": "2025-12-30",
        "comment": "The staff here were friendly and helpful. Everyone was cheerful and considerate. The staff here made our experience pleasant and memorable. The rooms were nice, but the location is perfect if you want to be in thick of the hustle and bustle of the city. Conveniently located, great facilities and a room rate that won’t break the bank. I wouldn’t hesitate to book again.",
        "review_reply": "Dear Brian,\nThank you for the wonderful review. We are glad to hear our team’s friendliness and positive energy helped make your stay pleasant and memorable. It is great to know you enjoyed the room, facilities, and our convenient location, along with a rate that added value to your visit. We truly appreciate your recommendation and look forward to welcoming you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psEgneI8FIdEeGP0U0DKFzwPjUbeMcfWkr7I6LvoCMXzPz_f8qvhEnl6IrGg73jlvLo1xOLrtjDLM7BY9doDWY9GddvM4JckW6EY8Bi5-GN7IzokII2PtHT99mWEr3bEWjh0RBhA7KKeVk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psP7Yx2Swd3UOEIevzruzpKAerYUdMJPXETQJt-A3SrKXcnHP4Cy0TLirJExW50cQ_kzoUUnZLHzfu-tUwtz_Kp_4yUSeqjo4Tm-BK1z9D6CmokJrkvo9QCtYAG7hjERaHOzibyBzSLaHlz",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pun-0zZPPEzWSkW_XUq8eHQSze3imSI7iMEq9_29WwJJdM82HBq3LwycenRdrTRIt70jyr3jPd4kiIABo-GdwhMJ6jd3QbOjrBuq4xfzs9OPPW_DEu52MrDQK0MnY8vgRQG8wfId5sLZtau",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvs0bS1DXsAMv1l2rUc2o5O3r07JiEVr2mXuo8_HxN-e47l0YqBxSfHQCGATeYbu059C-Gh9Om5nIuuoXGKbx-VqSFcovQuuboYcXxg9r4AOkj8y_1Atv5LieCvzZNjKt2lP_EIFUmpNIzv",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvGyxLHYBHrq2Xjc1_XkBMitY3PltgQXVrpUHliY22qm1juTnbcQM9Dppxgbb-YeCgQjzlWuEHfe22uXMf2LyAtWpiNnKrN62zNG5SeDhCZiGYwMDpp6TLNTVPWGcJgeTH7ozM12r70coMx",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptnOwAnTti7y3hrhxJ7TVOyrr9FmaGP1YvVDgo5ca-Mokl4thE-Ds1t9oaM_v6ofHs6MheZ1g02rNAsUlQqc0dRArJXKwYp8JAwhFQPOz0Cel9gu645rgw4O26EzLm1PkYHwzci7D_Wewdf",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu4U-BFG3nJCIUa3yMRZFr2NWas-3A1PUlCsROljZC05rtJhDHjDqd50W5ucTMpu8ywsM7yFNZLywcjhgKaXWqWsIHQtWJdOhAnQlsaq30fmt-3NNu3FISJ1wB1p-TvteQ-A3kcyAVZlkHb",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu8TqvQu_MO3rNMEH_5qVZ5fUYMHgVnS4PWsnKI2EVxPvBBiRZuwVhJLUZfKGxS6mnZMMKRfJB5KYlk2T7eZ1fNk6wqqGENrmoaYnGdqMcQm3CaV2OKSbYMAEcZRGstJI13u37JVn6_dsjI"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Diana Nichols",
          "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
        "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Solo",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "My room was perfect and bigger than I expected for NYC.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Lots of police officers around! Felt extremely safe.",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
          "display_name": "Natiesha Wray Henry",
          "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
        "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Cozy and comfortable",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Times Square is walkable from here",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "10 out of 10",
            "description": "Walkability"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Parking and traffic is a nightmare.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
          "display_name": "R471LZalext",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "2 months ago",
        "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxAYr7LFV6ZMNckj3q8VKiPdMIZXgCzt920CSu2v1nYG3GzQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Elia Alejandra",
          "link": "https://www.google.com/maps/contrib/107082141027365570078?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJvNEtuLUo1N1hOc3R2ejd2WHRNN0E%7C0d6T99EL24S%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "2/5",
        "created": "3 months ago",
        "comment": "Room had a nice view. Staff was friendly.\nRoom was dirty when we walked in. There were hairs in the bathtub, and sink wasn’t very clean. Restrooms and rooms along with furniture are very old! Bedsheets had some hairs and not very clean. Room was cleaned once out of 4 days so it’s not daily. They do give you a 35$ voucher for the cafe they have and 25$ for their services. Luggage hold is free if you get there early but they charge 5$ a piece if you need to check out of your room but still have time before the airport. Elevators are nice they have a system that makes it run smoother.\nHotel seems very central so that’s a good thing. Lots of things around but that’s just New York.\nOver all because of how old rooms seems and how dirty it was 2/5. Wouldn’t stay here again .",
        "review_reply": "Dear Elia,\nThank you for taking the time to share such detailed feedback. We’re glad to hear you enjoyed the wonderful view, the fantastic location, and the friendliness of the team, but we’re truly sorry to learn that the room did not meet expectations during your stay. Your comments about cleanliness, upkeep, and service frequency are important, and they’ll be shared with the appropriate teams so we can take a closer look. We appreciate you noting the helpful amenities like the café credit, services credit, luggage storage, and elevator system as well. We’re grateful for your perspective and hope the rest of your time in New York City was wonderful.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
          "display_name": "Amanda Garcia",
          "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
        "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
          "display_name": "LisaO964",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "a month ago",
        "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VNT3NySlBUc01UbTZRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qdvd3mFTmnQslJajBtyC7hGXBv5KKEN_7z5ZnXByEfDkAAFDmgEV3HW1P9_iXApXyf1XA=s120-c-br100",
          "display_name": "bobrobb",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "2/5",
        "created": "a month ago",
        "comment": "On a positive, the location is excellent and the room was big enough for a family which I think is a rarity for such a location.  We visited from 30th Dec to 6th Jan and in all honesty the hotel is just not set up to be running at capacity.  There were queues for everything, check in, check out, restrooms, bars and the lifts.  The lifts deserve a special mention - if on a lower floor you might have to wait for 5 to 6 lifts to get one that had any capacity if heading down at a busy time.  The service at check in and check out was pretty non- existent, the $35 “destination charge” is to encourage you to spend in their bar.  If lucky enough to actually get served in the lobby bar 2 x beers is more than the $35 - it just leaves a bad taste.  There are no tea and coffee facilities in room (a given in UK), but on a positive note towels were changed daily.  When checking out this morning nobody asked us how our stay was, totally impersonal, then we got hit with the $5 per item holding fee, to hold our baggage from 12 noon to 2 pm - as we had 7 items (hand luggage also counts as a separate item) we got a $35 charge after checking out.  If anyone genuinely cared about customer experience, that would have been taken out of your destination charge, but of course that isn’t possible.    It is a shame really, a once grand hotel, living off the Hilton brand, in need of a refurb with a clear focus on revenue creation as opposed to customer experience.  The location just isn’t enough to make up for the lack of experience I’m afraid - there are much better out there."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJQgX50KQ8oURrMb8SgiRyqOysMS1rNXBa0wHN1BoF7o8ORvQ=s120-c-rp-mo-br100",
          "display_name": "Olaoluwa Ajilore",
          "link": "https://www.google.com/maps/contrib/115992020596208851571?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNlbnpfNnNsMm53R3Axdk80RFhrV3c%7C0d3TryOnoQy%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I rarely write reviews, but I felt compelled to share my experience—especially because of the outstanding room service I’ve received. I’m currently staying here, and everything has been fantastic so far. What truly sets this place apart is the incredible housekeeping team on the 34th floor.\n\nThey are, without a doubt, the most attentive and genuinely kind crew I’ve encountered in any hotel across the country. Always cheerful, always ready to help—even when I’ve had the “Do Not Disturb” sign up, they’ve gone out of their way to check in if they see me in the hallway, just to make sure I don’t need anything. That level of care and consistency is rare, and it deserves to be celebrated.\n\nThey’re simply the best.",
        "review_reply": "Dear Olaoluwa,\nThank you for taking the time to share this, especially since you mentioned you rarely write reviews. It means even more to know you felt moved to speak about your stay while you’re still here with us. We're truly thrilled to hear how well everything has been going, and your kind words about our housekeeping team on the 34th floor mean the world. They take such pride in caring for our guests with thoughtfulness and genuine warmth, and it’s wonderful to know that their efforts have made such an impression. We'll be sure to share your message with them. I know it will brighten their day and remind them just how meaningful their care is. Thank you again for recognizing their hard work and spirit. We’re grateful to have you with us here at New York Hilton Midtown and are here for anything you may need for the rest of your visit. We hope the rest of your time with us continues to feel relaxing, comfortable, and well cared for!\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_GM@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "perfect, nice view, great ambiance",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Alot of activities",
            "description": "Nearby activities"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# AI overview
Source: https://docs.brightdata.com/api-reference/serp/google-search/ai-overview

Configure the Bright Data Google Search AI Overview parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Setting `brd_ai_overview=2` will **increase** the likelihood of receiving Google's Generative AI Overviews in your SERP responses, typically appearing in \~15-20%+ of results.

  ```http theme={null}
  https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2
  ```

  <Note>
    * Expect an extra \~5-10 seconds of latency in SERP API’s response time with this query parameter, as it launches a browser to capture the entire AI Overview content.
    * To better trigger an AI Overview, your SERP keywords must be relevant to topics that Google considers suitable for generative responses.
  </Note>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={398-530} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "what makes the best pizza",
      "results_cnt": 701000000,
      "search_time": 0.38,
      "language": "en",
      "location": "Unknown",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "what makes the best pizza - Google Search",
      "timestamp": "2026-02-25T09:22:55.293Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=what+makes+the+best+pizza&brd_ai_overview=2&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&aep=1&ntc=1&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q2J8OegQIExAE"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Qs6gLegQIFhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Qs6gLegQIFxAB"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QtKgLegQIGBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QtKgLegQIFRAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=what+makes+the+best+pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q0pQJegQIehAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=what+makes+the+best+pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&q=what+makes+the+best+pizza&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Qs6gLegQIfBAB"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=what+makes+the+best+pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpFZYo9qIX3pM4_jubAu4b8O2J-l05bwPYHG24xCsQH1w8cvTO1NaOffwF4OfCYdQK0BdR_E7UxHc6fNpvQbyybHrDNK0mjL-uF67YhlI3z2rBnM7wvMGu_iF6p4hNJJhStr69YlW2Oj1OAOgdrMAYd4OOAVozEDRKsKFFa3-i1j7aQIzwDIZtEBmkB_W0Pu-qat6qdg&sa=X&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q0pQJegQIfRAB"
      }
    ],
    "organic": [
      {
        "link": "https://www.thekitchn.com/types-of-pizza-23665322",
        "source": "The Kitchn",
        "display_link": "https://www.thekitchn.com › ... › Main Dishes › Pizza",
        "title": "12 Best Types of Pizza Everyone Needs to Know About",
        "description": "New York-style dough frequently has sugar and oil in the recipe, which adds flavor, helps the crust brown, and makes it easier to stretch. The ...Read more",
        "snippet_highlighted_words": [
          "New York-style dough frequently has sugar and oil in the recipe"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Jun 25, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.bonappetit.com/story/best-homemade-pizza?srsltid=AfmBOoq3vbzR7ZqTK7r8PLxxSkJ0NcgOp_mhKFlgxr8mvrPvIHzsyklg",
        "source": "Bon Appétit",
        "display_link": "https://www.bonappetit.com › Cooking › Pizza",
        "title": "9 Rules for the Best Homemade Pizza OF YOUR LIFE",
        "description": "1. Store-bought Pizza Dough Is Totally Cool—If You Handle It Right · 2. You Need Two Kinds of Mozzarella · 3. Know When to Top · 4. Simple Sauce Is ...Read more",
        "snippet_highlighted_words": [
          "Store-bought Pizza Dough Is Totally Cool—If You Handle It Right"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Mar 28, 2017",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 21
      },
      {
        "link": "https://www.tastingtable.com/1552373/pizza-styles-ranked-worst-best/",
        "source": "Tasting Table",
        "display_link": "https://www.tastingtable.com › Exclusives › Opinion",
        "title": "14 Pizza Styles, Ranked Worst To Best",
        "description": "The perfect pizza is crisp, not soggy, and can be eaten in a variety of settings. Above all, I want a pizza that will taste the same whether I ...Read more",
        "snippet_highlighted_words": [
          "crisp, not soggy, and can be eaten in a variety of settings"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Apr 2, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 22
      },
      {
        "link": "https://www.reddit.com/r/Chattanooga/comments/1fcsux7/what_makes_a_best_pizza_the_best/",
        "source": "Reddit · r/Chattanooga",
        "display_link": "20+ comments · 1 year ago",
        "title": "What makes a “best” pizza the “best”? : r/Chattanooga",
        "description": "A good crust, thin, crispy but not too crispy, on the bottom with a good amount of air pockets on the outside ring. A savory sauce with good ...Read more",
        "snippet_highlighted_words": [
          "A good crust, thin, crispy but not too crispy, on the bottom"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 26
      },
      {
        "link": "https://thefoodcharlatan.com/homemade-pizza-recipe/",
        "source": "The Food Charlatan",
        "display_link": "https://thefoodcharlatan.com › Recipes for Dinner",
        "title": "Best Homemade Pizza Recipe (1 Hour or Overnight)",
        "description": "I'll give you lots of tips, tricks, and ideas to get the best homemade pizza to ever come out of your wimpy, not-wood-fired oven!Read more",
        "snippet_highlighted_words": [
          "best homemade pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 85,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 27
      },
      {
        "link": "https://www.seriouseats.com/essential-tips-for-better-pizza-how-to-make-pizza-at-home",
        "source": "Serious Eats",
        "display_link": "https://www.seriouseats.com › ... › Baking Guides",
        "title": "11 Essential Tips for Better Pizza | The Food Lab",
        "description": "#1: Use a Scale! · #2: Learn How to Use the Metric System and Baker's Percentages · #3: Choose the Right Flour · #4: Pick a Style · #5: No Stand Mixer? No Problem.Read more",
        "snippet_highlighted_words": [
          "Use a Scale"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 28
      },
      {
        "link": "https://www.youtube.com/watch?v=Lyh94fDNCr4",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "20.4K+ views · 5 months ago",
        "title": "What Makes the Pizza, The Best!?",
        "description": "This video is about to see all the differences between pizza and pizza because they are totally different products.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTbAdDLC62143Qi4sj_7Y61QvHPxjMSXzzKoko5lCNmh8sEjTCvT54pVA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTbAdDLC62143Qi4sj_7Y61QvHPxjMSXzzKoko5lCNmh8sEjTCvT54pVA&s",
        "duration": "16:29",
        "duration_sec": 989,
        "rank": 7,
        "global_rank": 29
      },
      {
        "link": "https://www.pizzauniversity.org/how-to-identify-good-pizza-in-8-easy-steps/",
        "source": "Pizza University & Culinary Arts Center",
        "display_link": "https://www.pizzauniversity.org › how-to-identify-good...",
        "title": "How to Identify Good Pizza in 8 Easy Steps",
        "description": "First look at the crust and the border of the pizza. If it contains a lot of air – it will be light, crisp and good.Read more",
        "snippet_highlighted_words": [
          "light, crisp and good"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Oct 25, 2019",
            "rank": 1
          }
        ],
        "icon": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 30
      }
    ],
    "perspectives": [
      {
        "title": "The 18 best pizzas in the world, ranked",
        "author": "Liv Kelly · Time Out Worldwide",
        "source": "Travel writer for Time Out",
        "date": "3 weeks ago",
        "link": "https://www.timeout.com/restaurants/worlds-best-pizzas",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
      },
      {
        "title": "The Secret To Authentic Neapolitan Pizza",
        "author": "Nick's Kitchen · YouTube",
        "source": "American chef and internet personality",
        "date": "538.8K+ views · 3 weeks ago",
        "link": "https://www.youtube.com/watch?v=dsQGMhsvIYY",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
      },
      {
        "title": "These 13 pizzerias are Pittsburgh’s best, and reflect Western Pa.’s position as a rising pizza powerhouse",
        "author": "Hal B. Klein · Pittsburgh Post-Gazette",
        "source": "Pittsburgh-based food & drinks writer",
        "date": "1 day ago",
        "link": "https://www.post-gazette.com/life/dining/2026/02/24/best-pizza-pittsburgh-1/stories/202602160047",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
      },
      {
        "title": "Best Pizza in Phoenix Popular comment · Cibo is my favorite patio + pizza date night spot",
        "author": "r/phoenix",
        "source": "Reddit",
        "date": "260+ comments · 2 weeks ago",
        "link": "https://www.reddit.com/r/phoenix/comments/1r12hok/best_pizza_in_phoenix/"
      },
      {
        "title": "Best Pizza in Sonoma County: 16 Editor-Approved Spots for Tasty PiesBest Pizza in Sonoma County: 16 Editor-Approved Spots for Tasty Pies",
        "author": "Heather Irwin · Sonoma MagazineHeather Irwin · Sonoma Magazine",
        "source": "Sonoma County dining writerSonoma County dining writer",
        "date": "3 weeks ago3 weeks ago",
        "link": "https://www.sonomamag.com/best-pizza-in-sonoma-county-favorite-restaurants-for-tasty-pies/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s"
      },
      {
        "title": "Top Pizza in the Bay AreaTop Pizza in the Bay Area",
        "author": "Cesar Hernandez, Soleil HoCesar Hernandez, Soleil Ho",
        "source": "San Francisco ChronicleSan Francisco Chronicle",
        "date": "3 weeks ago3 weeks ago",
        "link": "https://www.sfchronicle.com/projects/2023/best-pizza-sf-bay-area/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s"
      },
      {
        "title": "The 10 Best Pizza Chains in the USA Which pizza chain is your favorite?",
        "author": "ViralNova · Facebook",
        "source": "Curation site for clickbait",
        "date": "3 days ago",
        "link": "https://www.facebook.com/ViralNova/posts/the-10-best-pizza-chains-in-the-usawhich-pizza-chain-is-your-favorite/1241527424749017/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR0vgx83wQhgnudtPZ1S_caEzWEMf60_Bzx41Laou9ab1ZBtfh1CQkNjUO4zQ&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR0vgx83wQhgnudtPZ1S_caEzWEMf60_Bzx41Laou9ab1ZBtfh1CQkNjUO4zQ&usqp=CAI&s"
      },
      {
        "title": "Where is the best pizza in DC? Popular comment · I mean it’s subjective, but in my opinion it’s Vace (kind of their own style), Andy’s (nyc style), 2Amy’s (Neapolitan style), and Mama Lucia (kind of nyc-ish but it’s nostalgic for me and I think it’s still very good).",
        "author": "r/washingtondc",
        "source": "Reddit",
        "date": "440+ comments · 1 month ago",
        "link": "https://www.reddit.com/r/washingtondc/comments/1qfkcxp/where_is_the_best_pizza_in_dc/"
      },
      {
        "title": "I Finally Made the Perfect Pizza (After Years of Practice)I Finally Made the Perfect Pizza (After Years of Practice)",
        "author": "Wilsons BBQ · YouTubeWilsons BBQ · YouTube",
        "source": "American BBQ in the UKAmerican BBQ in the UK",
        "date": "26.3K+ views · 2 weeks ago26.3K+ views · 2 weeks ago",
        "link": "https://www.youtube.com/watch?v=g5IoSPd4Cgg",
        "image": "https://img.youtube.com/vi/g5IoSPd4Cgg/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/g5IoSPd4Cgg/hqdefault.jpg"
      },
      {
        "title": "The Best New York Style Pizza at Home 🍕The Best New York Style Pizza at Home 🍕",
        "author": "Dylan Nobert · YouTubeDylan Nobert · YouTube",
        "source": "Cooking content creatorCooking content creator",
        "date": "59.5K+ views · 3 weeks ago59.5K+ views · 3 weeks ago",
        "link": "https://www.youtube.com/shorts/bndZw1mXa7w",
        "image": "https://img.youtube.com/vi/bndZw1mXa7w/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/bndZw1mXa7w/hqdefault.jpg"
      },
      {
        "title": "Best pizza in San Jose Popular comment · It depends what you like. Slice of Homage is Detroit style. A rectangular pie with intentionally burned edges and small, but thick slices. Bibo's and Slice of New York are New York-style. A large, thin pie with an extra cooked, crispy crust.",
        "author": "r/SanJose",
        "source": "Reddit",
        "date": "220+ comments · 1 month ago",
        "link": "https://www.reddit.com/r/SanJose/comments/1qfl93o/best_pizza_in_san_jose/"
      },
      {
        "title": "We Baked 100+ Pizzas to Make 1 Perfect RecipeWe Baked 100+ Pizzas to Make 1 Perfect Recipe",
        "author": "King Arthur Baking Company · YouTubeKing Arthur Baking Company · YouTube",
        "source": "Baking products & recipe providerBaking products & recipe provider",
        "date": "154.1K+ views · 1 month ago154.1K+ views · 1 month ago",
        "link": "https://www.youtube.com/watch?v=EdZ7IO8w69o",
        "image": "https://img.youtube.com/vi/EdZ7IO8w69o/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/EdZ7IO8w69o/hqdefault.jpg"
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=10&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=20&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=30&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAI"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=what+makes+the+best+pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=XL-eaf7LFY76wPAPwMDU8QU&start=10&sa=N&sstk=Af77f_eat-RcaJ38aKFQ2gKZ3ozXL83am_zqevXTsQauRtBUChpa7vRLEpNGFj0NQ9y_zo-1csD5TJvjHaeJp-wF6YtpzlfIWaWjsQ&ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4Q8tMDegQIERAE"
    },
    "related": [
      {
        "text": "What is the 3 8 rule for pizza? AI Overview The 3/8 pizza ... - FacebookJan 23, 2026 — OCR: What is the 3 8 rule for pizza? AI Overview The 3/8 pizza rule is a simple guideline for ordering pizza, suggesti...Facebook · Pizzaholics",
        "link": "https://www.facebook.com/groups/742034912983989/posts/2399634517224012/#:~:text=OCR:%20What%20is%20the%203,average%20person%20eats%203%20slices.",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXkm_xZBvefVGSTakfu7jK7ZbURiVQhVW8QzLQ1Rfwn-TRsIS0UkqbRs7iLA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXkm_xZBvefVGSTakfu7jK7ZbURiVQhVW8QzLQ1Rfwn-TRsIS0UkqbRs7iLA&s",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 3
      },
      {
        "text": "How Many Pizzas Do You Need to Order? | Factors to ConsiderJan 29, 2025Green Lantern Pizza",
        "link": "https://greenlanternpizza.com/blog/how-many-pizzas-do-you-need/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSjYc__HNk2lhZK2rIW38z1fFrOdU2MpkaueFpaJPnXsKbxR-xYsBmi21PWXg&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSjYc__HNk2lhZK2rIW38z1fFrOdU2MpkaueFpaJPnXsKbxR-xYsBmi21PWXg&s",
        "rank": 2,
        "global_rank": 4
      },
      {
        "text": "How To Host The Perfect Pizza Party - Papa JohnsSep 23, 2025 — Each of your guests will eat 3 slices of pizza. A standard pizza has approximately 8 slices. As an example, if you had...Papa JohnsHow To Host The Perfect Pizza Party - Papa JohnsSep 23, 2025 — Each of your guests will eat 3 slices of pizza. A standard pizza has approximately 8 slices. As an example, if you had...Papa Johns",
        "link": "https://www.papajohns.co.uk/blog/how-to-host-the-perfect-pizza-party#:~:text=Each%20of%20your%20guests%20will,you%20don't%20order%20sides!",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT-y5_Vke6_uqYEq7uFaDV93MAiYYTgxHocRyuFRU_2Dmoih26s6dGERYIh2A&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT-y5_Vke6_uqYEq7uFaDV93MAiYYTgxHocRyuFRU_2Dmoih26s6dGERYIh2A&s",
        "rank": 3,
        "global_rank": 5
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the secret to making the best pizza?",
        "question_link": "https://www.freethepizza.com/blog/the-secret-pro-tip-for-great-homemade-pizza-unleashing-the-beast-in-your-home-oven#:~:text=The%20secret%20to%20great%20pizza%20is%20high%20heat%20and%20thermal%20mass.&text=You%20turn%20the%20oven%20up,all%20into%20a%20crispy%20crust.",
        "question_type": "featured",
        "answer_html": "<div id=\"XL-eaf7LFY76wPAPwMDU8QU__32\"><div class=\"wDYxhc\" data-md=\"61\" style=\"clear:none\"><div class=\"LGOjhe\" data-attrid=\"wa:/description\" data-hveid=\"CC0QAA\"><span class=\"ILfuVd\" lang=\"en\"><span class=\"hgKElc pOOWX\">The secret to great pizza is <b>high heat and thermal mass</b>.<br><br> You turn the oven up high, you heat the stone or steel, and your oven begins to behave more like a commercial pizza oven. That high-heat stone or steel makes the raw pizza dough pop up, makes the water evaporate quickly, and turns it all into a crispy crust.</span></span><span class=\"kX21rb ZYHQ7e\">Feb 1, 2025</span></div></div></div><div id=\"XL-eaf7LFY76wPAPwMDU8QU__33\"><div class=\"Y6JuXb\"><div data-hveid=\"CCcQAA\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFSgAegQIJxAA\"><div style=\"position:relative\" class=\"tF2Cxc\"><div class=\"yuRUbf\"><div class=\"b8lM7\"><span class=\"V9tjod\" jsaction=\"trigger.mLt3mc\"><a jsname=\"UWckNb\" class=\"zReHs\" href=\"https://www.freethepizza.com/blog/the-secret-pro-tip-for-great-homemade-pizza-unleashing-the-beast-in-your-home-oven#:~:text=The%20secret%20to%20great%20pizza%20is%20high%20heat%20and%20thermal%20mass.&amp;text=You%20turn%20the%20oven%20up,all%20into%20a%20crispy%20crust.\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCcQAw\" ping=\"/url?sa=t&amp;source=web&amp;rct=j&amp;opi=89978449&amp;url=https://www.freethepizza.com/blog/the-secret-pro-tip-for-great-homemade-pizza-unleashing-the-beast-in-your-home-oven%23:~:text%3DThe%2520secret%2520to%2520great%2520pizza%2520is%2520high%2520heat%2520and%2520thermal%2520mass.%26text%3DYou%2520turn%2520the%2520oven%2520up,all%2520into%2520a%2520crispy%2520crust.&amp;ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCcQAw\"><h3 class=\"LC20lb MBeuO DKV0Md\" id=\"_XL-eaf7LFY76wPAPwMDU8QU_61\">For great homemade pizza, unleash the beast in your home oven...</h3><br><div class=\"notranslate ESMNde HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd Vwoesf\" aria-hidden=\"true\"><img class=\"XNo5Ab\" src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAAz1BMVEWTzPmWz/6Y1f98uN1QiKdAZnpCY3k9X3ZHe5Nro8OW0f+X0/9YkLJHQTuhdUnjrXb9vou+i2BpVypDaYWMyPGDuOBLRz/Ekmr/xpWmiGVZFANqSDjXrH29l26OclHYp3BvVCdgh6Z8r9V3TB9CRyeTAA3yJymZAAvbHB3SExt/AAGJakdDTVopW2fWCw/RIyMABgTDICDrJyjpJid2AACeGh0zDQ5GEQl3FA1XEA1WAACSGh+wAACgAABDBgQAIiQAFhojS1gWO0nwGxlsmbj0bsWQAAAAqElEQVR4AVTFQQsBQRgG4Pf9NmJmxGHd5TCkWM0kWRD+vT+gXLi6qt2EGi2B5/IQ4AdygNAsAEFI5jmbfLmXeCuTJ7afI2Q1Fg5yVA1RShmjtbqHXUbErXOd5JXAbR9lgK4M/GSceO9siidJrbXeJ9OZUSjQzBPn3XCxFAAChBAxALhsA15YHY6c664Eb7K23vZifDDq2EFF40v6mxR/4oUhfqnHXGAaAOuvJMmNnImSAAAAAElFTkSuQmCC\" style=\"height:18px;width:18px\" alt=\"\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Free The Pizza</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://www.freethepizza.com<span class=\"ylgVCe ob9lvb\" role=\"text\"> › blog › the-secret-pro-tip-...</span></cite></div></div></div></div></a></span><div class=\"B6fmyf byrV5b Mg1HEd\"><div class=\"HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd\" style=\"height:18px;width:18px\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Free The Pizza</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://www.freethepizza.com<span class=\"ylgVCe ob9lvb\" role=\"text\"> › blog › the-secret-pro-tip-...</span></cite></div></div></div></div></div></div></div></div></div></div></div>",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "The secret to great pizza is high heat and thermal mass. You turn the oven up high, you heat the stone or steel, and your oven begins to behave more like a commercial pizza oven. That high-heat stone or steel makes the raw pizza dough pop up, makes the water evaporate quickly, and turns it all into a crispy crust.Feb 1, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 2
      },
      {
        "question": "What makes a pizza taste best?",
        "question_link": "https://feastandfield.net/read/bread-and-pasta/why-does-pizza-taste-so-good-we-investigate/article_e61d704e-7fca-11ec-8873-8b24d05c9b9f.html#:~:text=from%20the%201800s.-,Cheese%20and%20tomatoes%20have%20some%20of%20the%20highest%20natural%20levels,delicious%20char%20on%20pizza%20crust.",
        "question_type": "featured",
        "answer_html": "<div id=\"XL-eaf7LFY76wPAPwMDU8QU__41\"><div class=\"wDYxhc\" data-md=\"61\" style=\"clear:none\"><div class=\"LGOjhe\" data-attrid=\"wa:/description\" data-hveid=\"CCwQAA\"><span class=\"ILfuVd\" lang=\"en\"><span class=\"hgKElc pOOWX\">Cheese and tomatoes have some of the highest natural levels of glutamate. <b>Lactic acid developed as dough rises gives pizza a tang that complements its fattiness</b>. The Maillard reaction creates a delicious char on pizza crust.</span></span><span class=\"kX21rb ZYHQ7e\">Feb 7, 2022</span></div></div></div><div id=\"XL-eaf7LFY76wPAPwMDU8QU__42\"><div class=\"Y6JuXb\"><div data-hveid=\"CCUQAA\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFSgAegQIJRAA\"><div style=\"position:relative\" class=\"tF2Cxc\"><div class=\"yuRUbf\"><div class=\"b8lM7\"><span class=\"V9tjod\" jsaction=\"trigger.mLt3mc\"><a jsname=\"UWckNb\" class=\"zReHs\" href=\"https://feastandfield.net/read/bread-and-pasta/why-does-pizza-taste-so-good-we-investigate/article_e61d704e-7fca-11ec-8873-8b24d05c9b9f.html#:~:text=from%20the%201800s.-,Cheese%20and%20tomatoes%20have%20some%20of%20the%20highest%20natural%20levels,delicious%20char%20on%20pizza%20crust.\" data-ved=\"2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCUQAw\" ping=\"/url?sa=t&amp;source=web&amp;rct=j&amp;opi=89978449&amp;url=https://feastandfield.net/read/bread-and-pasta/why-does-pizza-taste-so-good-we-investigate/article_e61d704e-7fca-11ec-8873-8b24d05c9b9f.html%23:~:text%3Dfrom%2520the%25201800s.-,Cheese%2520and%2520tomatoes%2520have%2520some%2520of%2520the%2520highest%2520natural%2520levels,delicious%2520char%2520on%2520pizza%2520crust.&amp;ved=2ahUKEwj-6bvbqPSSAxUOPRAIHUAgNV4QFnoECCUQAw\"><h3 class=\"LC20lb MBeuO DKV0Md\" id=\"_XL-eaf7LFY76wPAPwMDU8QU_60\">Why does pizza taste so good? We investigate | Bread &amp; Pasta</h3><br><div class=\"notranslate ESMNde HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd Vwoesf\" aria-hidden=\"true\"><img class=\"XNo5Ab\" src=\"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgBBgkIBwEKAQkLDRYPDQEMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tJTU3Ojo6JSs/RD84Qy05OjcBCgoKDQENGg8PDjclHyU3Nzc3Nzc3LTctNzc3NzU3Kzc3NzUrLSs3NzcsLS03NTArNys1LTcrNys3NzUrLTU1Nf/AABEIABAAEAMBEQACEQEDEQH/xAAXAAADAQAAAAAAAAAAAAAAAAACAwcA/8QAJhAAAQIEBAcBAAAAAAAAAAAAAQMRAgQGBwAIEjEFIUJhkdHwIv/EABcBAAMBAAAAAAAAAAAAAAAAAAECBQD/xAAnEQABAwIEBQUAAAAAAAAAAAABAgMRAGEEByFxEhdBUeEiMYHR8f/aAAwDAQACEQMRAD8AoPFV5q/ysQQu+jSKI2pPWxP6ZziDinHM3lEIdAHmJNV8O2jLcAqbk+J0pfDl5rLaqIlLxp1Qh1UjqJcOBy78x8+Ew7juSyvU7Ke3zGl6Z5DeaY0bhXf7rT8qMtyisKtnoripKqaoaqdmG4APl8bENDJNRlriSddrT0rMuc1gIXBAje9BJojMtEEkbLGiAYoddxSXAhHvAZRztPClqBpJsOm5/aLq+VIkuz7wL1//2Q==\" style=\"height:18px;width:18px\" alt=\"\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Feast and Field</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://feastandfield.net<span class=\"ylgVCe ob9lvb\" role=\"text\"> › read › why-does-pizza-taste-so-...</span></cite></div></div></div></div></a></span><div class=\"B6fmyf byrV5b Mg1HEd\"><div class=\"HGLrXd ojE3Fb\"><div class=\"q0vns\"><span class=\"H9lube\"><div class=\"eqA2re NjwKYd\" style=\"height:18px;width:18px\"></div></span><div class=\"CA5RN\"><div><span class=\"VuuXrf\">Feast and Field</span></div><div class=\"byrV5b\"><cite class=\"qLRx3b tjvcx GvPZzd cHaqb\" role=\"text\">https://feastandfield.net<span class=\"ylgVCe ob9lvb\" role=\"text\"> › read › why-does-pizza-taste-so-...</span></cite></div></div></div></div></div></div></div></div></div></div></div>",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Cheese and tomatoes have some of the highest natural levels of glutamate. Lactic acid developed as dough rises gives pizza a tang that complements its fattiness. The Maillard reaction creates a delicious char on pizza crust.Feb 7, 2022"
            },
            "rank": 1
          }
        ],
        "rank": 2,
        "global_rank": 20
      }
    ],
    "ai_overview": {
      "texts": [
        {
          "type": "paragraph",
          "snippet": "A good pizza is defined by a perfectly balanced, crispy-yet-chewy crust, flavorful sauce, and high-quality cheese, all cooked at high temperatures. Key factors include proper dough fermentation, a, structural balance of toppings to avoid a soggy mess, and a slightly charred crust, creating a harmonious blend of textures and fresh ingredients. Facebook +4",
          "reference_indexes": [
            0,
            1,
            2,
            3,
            8
          ],
          "image": {
            "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
            "image_alt": "The F&W Guide to Homemade Pizza",
            "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
          }
        },
        {
          "type": "paragraph",
          "snippet": "Here are the key components of a good pizza:"
        },
        {
          "type": "list",
          "title": "Crust (The Foundation): A great pizza has a light, airy crust that is neither overcooked (burnt/dry) nor undercooked (soggy). It should have a slightly chewy, airy interior and a crisp, charred exterior.",
          "list": [
            {
              "type": "paragraph",
              "snippet": "Crust (The Foundation): A great pizza has a light, airy crust that is neither overcooked (burnt/dry) nor undercooked (soggy). It should have a slightly chewy, airy interior and a crisp, charred exterior."
            },
            {
              "type": "paragraph",
              "snippet": "Sauce (The Flavor): High-quality, balanced sauce—not too sweet or acidic—is crucial. A simple, fresh sauce allows the flavors of the cheese and dough to shine."
            },
            {
              "type": "paragraph",
              "snippet": "Cheese and Toppings (The Balance): The cheese should be melted, stretchy, and high-quality, not just added in excess. Ingredients should be fresh, and toppings must be balanced with the sauce and cheese to prevent a soggy, unmanageable slice."
            },
            {
              "type": "paragraph",
              "snippet": "Cooking Method: The best pizzas are baked at high temperatures, such as in a wood-fired oven, which provides a fast, intense bake that creates a delicious, slightly charred flavor (the Maillard reaction)."
            },
            {
              "type": "paragraph",
              "snippet": "Structure: A good pizza is not too heavy; it holds its shape when lifted. Pizza University & Culinary Arts Center +6",
              "reference_indexes": [
                0,
                1,
                2,
                3,
                4,
                6,
                7
              ],
              "image": {
                "image": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.pizzauniversity.org&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
                "image_alt": "Pizza University & Culinary Arts Center",
                "image_url": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.pizzauniversity.org&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
              }
            }
          ]
        },
        {
          "type": "paragraph",
          "snippet": "Key Takeaway: A great pizza balances fresh, high-quality ingredients on a perfectly baked, light, and airy dough. YouTube +1",
          "reference_indexes": [
            0,
            5
          ],
          "image": {
            "image": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.youtube.com&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
            "image_alt": "YouTube",
            "image_url": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.youtube.com&client=AIM&size=128&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
          }
        }
      ],
      "references": [
        {
          "href": "https://www.doreenspizzeria.com/doreens-pizzeria-7-qualities-of-a-perfect-pizza-slice/",
          "title": "Doreen's Pizzeria - 7 Qualities of a Perfect Pizza Slice. Opens in new tab.",
          "source": "Doreen's Pizza",
          "index": 0
        },
        {
          "href": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/",
          "title": "What makes a great pizza? - Facebook. Opens in new tab.",
          "source": "Facebook",
          "index": 1
        },
        {
          "href": "https://www.popuppizzalv.com/the-elements-of-what-makes-pizza-taste-great/#:~:text=There%20are%20three%20fundamental%20elements%20that%20make,adds%20to%20the%20texture%20of%20the%20crust.",
          "title": "The Elements of What Makes Pizza Taste Great. Opens in new tab.",
          "source": "Pop Up Pizza",
          "index": 2
        },
        {
          "href": "https://www.doreenspizzeria.com/discover-the-top-qualities-of-the-perfect-pizza-pie/#:~:text=A%20perfect%20pizza%20is%20a%20combination%20of,a%20hot%20oven%2C%20ideally%20a%20wood%2Dfired%20oven",
          "title": "Discover the Top Qualities of the Perfect Pizza Pie - Doreen's Pizzeria. Opens in new tab.",
          "source": "Doreen's Pizza",
          "index": 3
        },
        {
          "href": "https://www.pizzauniversity.org/how-to-identify-good-pizza-in-8-easy-steps/",
          "title": "How to Identify Good Pizza in 8 Easy Steps. Opens in new tab.",
          "source": "Pizza University & Culinary Arts Center",
          "index": 4
        },
        {
          "href": "https://www.youtube.com/watch?v=mRx_odAj-XQ&t=407",
          "title": "The Best Pizza You'll Ever Make | Epicurious 101. Opens in new tab.",
          "source": "YouTube",
          "index": 5
        },
        {
          "href": "https://www.youtube.com/watch?v=9k3Ky2nn6MY&t=285",
          "title": "How to Make Restaurant Style Pizza At Home | Full Tutorial!. Opens in new tab.",
          "source": "YouTube",
          "index": 6
        },
        {
          "href": "https://thepizzapress.com/blog/pizzeria/what-makes-pizza-delicious/#:~:text=The%20Maillard%20Reaction%2C%20or%20browning%20reaction%2C%20refers,give%20foods%20like%20pizza%20a%20distinct%20flavor.",
          "title": "What Makes Pizza Delicious? - Pizzeria - The Pizza Press. Opens in new tab.",
          "source": "The Pizza Press",
          "index": 7
        },
        {
          "href": "https://www.pmq.com/doughs-and-donts-three-pizza-chefs-share-their-tips-for-achieving-a-delicious-crust/#:~:text=Fermentation%20is%20one%20of%20the%20most%20crucial,shape%2C%20texture%20and%20digestion%20of%20the%20pizza.",
          "title": "Doughs and Don'ts: Three Pizza Chefs Share Their Tips for Achieving a Delicious Crust. Opens in new tab.",
          "source": "PMQ Pizza",
          "index": 8
        }
      ]
    },
    "forums": {
      "items": [
        {
          "title": "How do you get the best pizza?How do you get the best pizza?",
          "source": "Quora",
          "subtitles": [
            "5 answers",
            "5 months ago"
          ],
          "link": "https://www.quora.com/How-do-you-get-the-best-pizza",
          "answers": [
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743849516045",
              "extra": [
                "Top answer",
                "18 votes",
                "11 months ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743884716841",
              "extra": [
                "13 votes",
                "5 months ago"
              ]
            },
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743884280104",
              "extra": [
                "12 votes",
                "5 months ago"
              ]
            },
            {
              "link": "https://www.quora.com/How-do-you-get-the-best-pizza?top_ans=1477743884280104",
              "extra": [
                "12 votes",
                "5 months ago"
              ]
            }
          ],
          "rank": 1,
          "global_rank": 23
        },
        {
          "title": "What makes a great pizza?What makes a great pizza?",
          "source": "Facebook",
          "subtitles": [
            "Pizzaholics",
            "260+ comments",
            "1 year ago"
          ],
          "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/",
          "answers": [
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885276641993138",
              "extra": [
                "Top answer",
                "15 votes",
                "a year ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885330211987781",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885278108659658",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885278108659658",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885276641993138",
              "extra": [
                "Top answer",
                "15 votes",
                "a year ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.facebook.com/groups/742034912983989/posts/1885228215331314/?comment_id=1885330211987781",
              "extra": [
                "12 votes",
                "a year ago"
              ]
            }
          ],
          "rank": 2,
          "global_rank": 24
        },
        {
          "title": "What is the secret to the best pizza?What is the secret to the best pizza?",
          "source": "Quora",
          "subtitles": [
            "2 answers",
            "11 months ago"
          ],
          "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza",
          "answers": [
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=96565224",
              "extra": [
                "Top answer",
                "136 votes",
                "7 years ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=1477743734124602",
              "extra": [
                "62 votes",
                "2 years ago"
              ]
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=87669523",
              "extra": [
                "27 votes",
                "7 years ago"
              ]
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=87669523",
              "extra": [
                "27 votes",
                "7 years ago"
              ]
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=96565224",
              "extra": [
                "Top answer",
                "136 votes",
                "7 years ago"
              ],
              "is_top_answer": true
            },
            {
              "link": "https://www.quora.com/What-is-the-secret-to-the-best-pizza?top_ans=1477743734124602",
              "extra": [
                "62 votes",
                "2 years ago"
              ]
            }
          ],
          "rank": 3,
          "global_rank": 25
        }
      ]
    },
    "oragnic": [
      {
        "link": "https://www.thekitchn.com/types-of-pizza-23665322",
        "source": "The Kitchn",
        "display_link": "https://www.thekitchn.com › ... › Main Dishes › Pizza",
        "title": "12 Best Types of Pizza Everyone Needs to Know About",
        "description": "New York-style dough frequently has sugar and oil in the recipe, which adds flavor, helps the crust brown, and makes it easier to stretch. The ...Read more",
        "snippet_highlighted_words": [
          "New York-style dough frequently has sugar and oil in the recipe"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Jun 25, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.bonappetit.com/story/best-homemade-pizza?srsltid=AfmBOoq3vbzR7ZqTK7r8PLxxSkJ0NcgOp_mhKFlgxr8mvrPvIHzsyklg",
        "source": "Bon Appétit",
        "display_link": "https://www.bonappetit.com › Cooking › Pizza",
        "title": "9 Rules for the Best Homemade Pizza OF YOUR LIFE",
        "description": "1. Store-bought Pizza Dough Is Totally Cool—If You Handle It Right · 2. You Need Two Kinds of Mozzarella · 3. Know When to Top · 4. Simple Sauce Is ...Read more",
        "snippet_highlighted_words": [
          "Store-bought Pizza Dough Is Totally Cool—If You Handle It Right"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Mar 28, 2017",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 21
      },
      {
        "link": "https://www.tastingtable.com/1552373/pizza-styles-ranked-worst-best/",
        "source": "Tasting Table",
        "display_link": "https://www.tastingtable.com › Exclusives › Opinion",
        "title": "14 Pizza Styles, Ranked Worst To Best",
        "description": "The perfect pizza is crisp, not soggy, and can be eaten in a variety of settings. Above all, I want a pizza that will taste the same whether I ...Read more",
        "snippet_highlighted_words": [
          "crisp, not soggy, and can be eaten in a variety of settings"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Apr 2, 2024",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 22
      }
    ]
  }
  ```
</ResponseExample>


# Asynchronous requests
Source: https://docs.brightdata.com/api-reference/serp/google-search/async





# Browser type
Source: https://docs.brightdata.com/api-reference/serp/google-search/browser

Configure the Bright Data Google Search Browser type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&brd_browser=chrome
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define what browser to be represented in user-agent. Default will provide random browser.

  | | |
  | - | - |
  | `chrome` | Google Chrome |
  | `safari` | Apple Safari |
  | `firefox` | Mozilla Firefox (not compatible with `brd_mobile=1`) |

  ```http theme={null}
  https://www.google.com/search?q=pizza&brd_browser=chrome
  ```

  <Tip>
    Can be combined with `brd_mobile` to get according mobile browser except for **Firefox**, which is not compatible with `brd_mobile=1`.
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_browser=chrome",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_browser=chrome"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_browser=chrome',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_browser=chrome',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={16} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1200000000,
      "search_time": 0.6,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T09:17:19.170Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_browser=chrome&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&aep=1&ntc=1&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q2J8OegQIChAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QtKgLegQIHRAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QtKgLegQIGhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qs6gLegQIFxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q0pQJegUI0wEQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qs6gLegUI1AEQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qs6gLegUI2QEQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q0pQJegUI2gEQAQ"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t4NPsly-1JiYt9S6VsSRnLf-sxULmbNLebMKQgkhwHc2FSfFXQ&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Qkc0JKAB6BAgMEAE&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.papajohns.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      },
      {
        "link": "https://www.reddit.com/r/Pizza/",
        "source": "Reddit · r/Pizza",
        "display_link": "1.9M+ followers",
        "title": "r/Pizza",
        "description": "r/Pizza: The home of pizza on reddit. An educational community devoted to the art of pizza making.",
        "snippet_highlighted_words": [
          "The home of pizza on reddit"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQVF0IXZrsCdj1QZVGBDDYpj5kdwZyQKWtJo2GHJC8AUge29yskSxpE&usqp=CAE&s",
        "image_alt": "pizza from www.reddit.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQVF0IXZrsCdj1QZVGBDDYpj5kdwZyQKWtJo2GHJC8AUge29yskSxpE&usqp=CAE&s",
        "rank": 4,
        "global_rank": 11
      },
      {
        "link": "https://www.marcos.com/",
        "source": "Marco's Pizza",
        "display_link": "https://www.marcos.com",
        "title": "Marco's Pizza Online Ordering",
        "description": "Marco's Pizza Online Ordering is designed for ease-of-use. It's quick and easy to create an order, purchase, and schedule for delivery. Create an order now!",
        "snippet_highlighted_words": [
          "Marco's Pizza Online Ordering"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 5,
        "global_rank": 12
      },
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "source": "YouTube · Andy Cooks",
        "display_link": "283.1K+ views · 5 days ago",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "description": "Today I'm going to show you how to recreate at least my childhood memories of delicious bad pizza it's easily done at home.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "duration": "13:55",
        "duration_sec": 835,
        "rank": 6,
        "global_rank": 13
      },
      {
        "link": "https://appizzashop.com/",
        "source": "AP Pizza Shop",
        "display_link": "https://appizzashop.com",
        "title": "Purpose Pizzeria DC — AP Pizza Shop Bethesda MD 20814",
        "description": "Discover AP Pizza in Bethesda, MD – where authentic Italian flavors meet hand-crafted pizzas, fresh ingredients, and a welcoming atmosphere.",
        "snippet_highlighted_words": [
          "authentic Italian flavors meet hand-crafted pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQDSwmOfaPtVZng_x8RcQXSNWy_tA1obBbBi_z8sjzvJtoA94Awbfk&usqp=CAE&s",
        "image_alt": "pizza from appizzashop.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQDSwmOfaPtVZng_x8RcQXSNWy_tA1obBbBi_z8sjzvJtoA94Awbfk&usqp=CAE&s",
        "rank": 7,
        "global_rank": 14
      },
      {
        "link": "https://www.thekitchn.com/trader-joes-pizza-trick-podcast-23768950",
        "source": "The Kitchn",
        "display_link": "https://www.thekitchn.com › Groceries › Trader Joes",
        "title": "The Rule-Breaking Tip That Makes Frozen Pizza Taste 10x ...",
        "description": "Why You Should Thaw Your Pizza Before Heating It in the Oven. That's right. The key to making frozen pizzas taste like they just came out of a wood-fired oven ...Read more",
        "snippet_highlighted_words": [
          "Why You Should Thaw Your Pizza Before Heating It in the Oven"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 15
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "10.3K+ views · 3 days ago",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "We got frozen bases and we made this lovely pizza in 5 minutes and a home oven. It's soft it's crunchy it's lovely.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQryZRNTdJCwsZlTiwg7DSFnDrbhpcsQg8yQzkCfnp0U444Br-92t0sQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQQryZRNTdJCwsZlTiwg7DSFnDrbhpcsQg8yQzkCfnp0U444Br-92t0sQ&s",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 9,
        "global_rank": 16
      }
    ],
    "perspectives": [
      {
        "title": "Barstool Pizza Review - Casey's Pizza (San Francisco, CA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "58.9K+ views · 10 hours ago",
        "link": "https://www.youtube.com/watch?v=wj4vtZ0FR1Y",
        "image": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg"
      },
      {
        "title": "Costco: Where to find most perfect slice of cheap cheese pizza. 🍕🙏🤤",
        "author": "r/Costco",
        "source": "Reddit",
        "date": "230+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s"
      },
      {
        "title": "Barstool Pizza Review - Casey’s Pizza (San Francisco, CA)",
        "author": "stoolpresidente · Instagram",
        "source": "American businessman",
        "date": "2K+ likes · 9 hours ago",
        "link": "https://www.instagram.com/reel/DVKIeZTlJCR/?hl=en",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10"
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA...",
          "image_alt": "Image of Pizza Dough Recipe",
          "image_base64": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA..."
        },
        {
          "image": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg...",
          "image_alt": "Image of Salami, Red Onion and Oregano Pizza - Tillamook",
          "image_base64": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg..."
        },
        {
          "image": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QmxN6BAgWEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "285 Calories",
        "portion": "1 slice (107 g)"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=1&lsack=Hb6eacG_JP6qhbIP4aKt-QQ&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08QtgN6BAgvEAM"
    },
    "snack_pack": [
      {
        "cid": "11325640445402842264",
        "name": "PizzaForno",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"",
        "address": "Columbia, SC",
        "rank": 1,
        "global_rank": 1
      },
      {
        "cid": "2036127367591792815",
        "name": "Hunt Brothers Pizza",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 1,
        "type": "Pizza",
        "price": "$",
        "work_status": "Pit stop for pizza & chicken wings",
        "address": "Hollister, MO",
        "rank": 2,
        "global_rank": 2
      },
      {
        "cid": "8168786693047694084",
        "name": "Oggi's Pizza & Brewing Co",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "Closed",
        "work_status_details": "Opens 11 AM",
        "address": "Garden Grove, CA",
        "rank": 3,
        "global_rank": 3
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=10&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=20&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=30&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAI"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=Hb6eacG_JP6qhbIP4aKt-QQ&start=10&sa=N&sstk=Af77f_fXDWinljh6N1MnT00YW7jFvYxOvFYGWISqzWpzHqImhmauvql47HKcreo0qrAmg9l8zq551x8DlM54zwN2G0HzwZ3jFgb4KQ&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q8tMDegQICRAE"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q1QJ6BAhgEAE",
        "rank": 1,
        "global_rank": 17
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q1QJ6BAh4EAE",
        "rank": 2,
        "global_rank": 18
      },
      {
        "text": "Pizza open",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+open&sa=X&ved=2ahUKEwiBwrzDp_SSAxV-VUEAHWFRK08Q1QJ6BAh2EAE",
        "rank": 3,
        "global_rank": 19
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_source": "Curry Pizza House",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com › how-long-does-pizza-lasthttps://currypizzahouse.com › how-long-does-pizza-last",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 7
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.papajohns.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      }
    ]
  }
  ```
</ResponseExample>


# Device (platform)
Source: https://docs.brightdata.com/api-reference/serp/google-search/device-ios

Configure the Bright Data Google Search Device (Platform) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&brd_mobile=ios
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define what device type to be represented in user-agent.

  For specific mobile platform provide one of the following values:

  | Value | Description | Usage |
  | - | - | - |
  | `ios` | iPhone user-agent | `brd_mobile=ios` <br /> (alias `brd_mobile=iphone`) |
  | `ipad` | iPad user-agent | `brd_mobile=ipad` <br /> (alias `brd_mobile=ios_tablet`) |
  | `android` | Android phone | `brd_mobile=android` |
  | `android_tablet` | Android tablet | `brd_mobile=android_tablet` |

  ```http theme={null}
  https://www.google.com/search?q=pizza&brd_mobile=ios
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_mobile=ios",
      "format": "raw"
    }'
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_mobile=ios',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_mobile=ios"
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_mobile=ios',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={7} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "location": "United States",
      "mobile": true,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T09:13:58.036Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_mobile=ios&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&aep=1&ntc=1&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q2J8OegQIBBAX"
      },
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&aep=1&ntc=1&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q2J8OegQIDhAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4QtKgLegQIFBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4QtKgLegQIERAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Qs6gLegQIEBAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q0pQJegUInAIQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Qs6gLegUImwIQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Qs6gLegUIqQIQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q0pQJegUIqgIQAQ"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&ved=1t:200715&ictx=111"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q0pQJegUIpwIQAQ"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 5
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 6
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      },
      {
        "link": "https://www.pizzamyheart.com/",
        "title": "Pizza My Heart for pizza by the slice or whole pie",
        "description": "Pizza by the slice or whole pie with a focus on natural locally grown ingredients from California farms. Fresh salads, craft beers and a laid-back surf ...",
        "rank": 4,
        "global_rank": 8
      },
      {
        "link": "https://primepizza.com/",
        "title": "Prime Pizza | Authentic New York–Style Pizza in Los Angeles & Orange County",
        "description": "Discover Prime Pizza — serving the best New York–style pizza in Los Angeles and coming soon to Orange County. Fresh ingredients, housemade dough, ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "image_alt": "pizza from primepizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "rank": 5,
        "global_rank": 9
      },
      {
        "link": "https://pagliacci.com/",
        "title": "Pagliacci Pizza: Seattle Area Pizza & Delivery | Pagliacci Pizza",
        "description": "Pagliacci Pizza, serving Seattle's best pizza since 1979. Offering pizza by the slice and pizza delivery service to homes and businesses.",
        "rank": 6,
        "global_rank": 13
      },
      {
        "link": "https://www.jetspizza.com/",
        "title": "Jet's Pizza: Pizza, Wings, and Salads",
        "description": "Jet's makes pizza, wings and salads using quality ingredients and has hundreds of locations in 20 states.",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTldmM9Lc9i5UCyD0dDl73aevUz-TXbunV1fmfWC1aYLW9uUzdjli5hOfU&usqp=CAE&s",
        "image_alt": "pizza from www.jetspizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTldmM9Lc9i5UCyD0dDl73aevUz-TXbunV1fmfWC1aYLW9uUzdjli5hOfU&usqp=CAE&s",
        "rank": 7,
        "global_rank": 14
      },
      {
        "link": "https://www.spinatospizzeria.com/",
        "title": "Spinato's Pizzeria: Best Restaurant Near Me - Spinato's Pizzeria",
        "description": "Savor classic Italian flavors at Spinato's Pizzeria, the best restaurant near me. Family-owned, offering delicious pizzas, pastas, and more!",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "image_alt": "pizza from www.spinatospizzeria.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "rank": 8,
        "global_rank": 15
      }
    ],
    "videos": [
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "author": "5 days ago",
        "rank": 1,
        "global_rank": 10
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "author": "3 days ago",
        "rank": 2,
        "global_rank": 11
      },
      {
        "link": "https://www.youtube.com/watch?v=TB5JPppUZpY",
        "title": "LEFTOVER PIZZA WILL NEVER BE THE SAME...",
        "author": "1 day ago",
        "rank": 3,
        "global_rank": 12
      }
    ],
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&prmd=misvn&ei=VL2eafRS38fQ8Q_QwabxAw&start=10&sa=N"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q1QJ6BQisARAB",
        "rank": 1,
        "global_rank": 16
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q1QJ6BQjRARAB",
        "rank": 2,
        "global_rank": 17
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwj0zKzjpvSSAxXfIzQIHdCgKT4Q1QJ6BQjNARAB",
        "rank": 3,
        "global_rank": 18
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 1
      },
      {
        "question": "Who has the $4.99 pizza deal?",
        "question_type": "ai_overview",
        "answers": [
          {
            "texts": [
              {
                "type": "paragraph",
                "snippet": "Little Caesars frequently offers $4.99 pizza deals, often for two large one-topping pizzas or their Detroit-Style Slices-N-Stix combo, available for limited times with online codes like \"PIZZAPIZZA,\" so check their deals page or app for current offers.",
                "snippet_highlighted_words": "Little Caesars"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "Check Little Caesars' Website/App: Look for limited-time offers and deals sections."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Look for Codes: They often use codes like \"PIZZAPIZZA\" for online orders."
                  },
                  {
                    "type": "list",
                    "title": "Specific Promotions: Recent examples include:",
                    "list": [
                      {
                        "type": "paragraph",
                        "snippet": "2 Large 1-Topping Pizzas: for $4.99 each (online deal)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Detroit-Style Slices-N-Stix Combo: (2 pepperoni slices + Crazy Bread) for $4.99 (lunch special)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Sicilian Style Pizza: for $4.99."
                      }
                    ]
                  }
                ],
                "title": "How to find current deals:"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "These are often limited-time offers and prices can vary by location."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Some deals require online ordering or specific promo codes."
                  }
                ],
                "title": "Keep in mind:"
              }
            ],
            "references": [
              {
                "href": "https://littlecaesars.com/en-us/deals/#:~:text=Little%20Caesars%C2%AE,Limited%2DTime%20Pizza%20Deals",
                "title": "Little Caesars®| Limited-Time Pizza Deals",
                "subtitle": "Little Caesars® | Limited-Time Pizza Deals.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 0
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/get-2-large-pizzas-for-499-each-online-only-with-promo-code-pizzapizza/1187325250106928/#:~:text=get%202%20large%20pizzas%20for%204.99%20each%20online%20only%20with%20promo%20code%20PIZZAPIZZA",
                "title": "get 2 large pizzas for 4.99 each online only with promo code ...",
                "subtitle": "Aug 26, 2025 — get 2 large pizzas for 4.99 each online only with promo code PIZZAPIZZA.",
                "source": "Facebookhttps://www.facebook.com",
                "index": 1
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302966938542758/#:~:text=2%20pizzas%20for%20$4.99%20each%20from%20Little%20Caesars%20Code:%20PIZZAPIZZA",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — 2 pizzas for $4.99 each from Little Caesars Code: PIZZAPIZZA.",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 2
              },
              {
                "href": "https://littlecaesars.com/en-us/deals/8389/#:~:text=Little%20Caesars%C2%AE%20%7C%20Limited%2DTime%20Pizza%20Promos",
                "title": "search for local deals! - Little Caesars® Pizza",
                "subtitle": "Little Caesars® | Limited-Time Pizza Promos.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 3
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1286902870149165/",
                "title": "Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza!Pizza! Deal!",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 4
              },
              {
                "href": "https://www.youtube.com/watch?v=eKx39t79o2I&t=7",
                "title": "NEW Little Caesars $4.99 Detroit-Style Slices-N-Stix Review!",
                "subtitle": "Jan 14, 2026 — you a little butt cheek laughter y'all was like \"Damn when you going to stop playing games. and pull up on that newoo at Little C's. are they even a...",
                "source": "YouTube · Daym Dropshttps://www.youtube.com",
                "index": 5
              },
              {
                "href": "https://www.instagram.com/reel/DTOGL8bgSLa/#:~:text=OCR,to%20be%20split%20half%20&%20half%20.",
                "title": "$10 will get you 2 LARGE 1-topping pizzas at Little Caesar's ... - Instagram",
                "subtitle": "Jan 7, 2026 — OCR. 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . Get 2 large 1-topping pizzas for $4.99 each online until 1/18 with c...",
                "source": "Instagram · tayloreatsnychttps://www.instagram.com",
                "index": 6
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/videos/new-sicilian-style-pizza-only-499/647195651659750/#:~:text=For%20only%20$4.99?!,4",
                "title": "For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars",
                "subtitle": "Oct 29, 2025 — For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars | Facebook. Video. 󱡘 Little Caesars. Oct 29, 2025󰞋󱘚 New! Sicilian Style Pizza,",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 7
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302965878542864/#:~:text=Double%20the%20pizzas%2C%20twice%20the,Deal!",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza! Pizza! Deal!",
                "source": "Facebookhttps://www.facebook.com",
                "index": 8
              }
            ]
          }
        ],
        "rank": 2,
        "global_rank": 2
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 5
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 6
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      }
    ]
  }
  ```
</ResponseExample>


# Device (mobile/desktop)
Source: https://docs.brightdata.com/api-reference/serp/google-search/device-mobile

Configure the Bright Data Google Search Device (Mobile/Desktop) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&brd_mobile=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define what device type to be represented in user-agent.

  | Value | Description | Usage |
  | :- | :- | :- |
  | `0` | Random desktop user agent (`Default`) | `brd_mobile=0` |
  | `1` | Random mobile user agent | `brd_mobile=1` |

  ```http theme={null}
  https://www.google.com/search?q=pizza&brd_mobile=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_mobile=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_mobile=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_mobile=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_mobile=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={7} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "location": "United States",
      "mobile": true,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T09:08:20.763Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_mobile=1&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&aep=1&ntc=1&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ2J8OegQIBBAX"
      },
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&aep=1&ntc=1&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ2J8OegQIDRAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQtKgLegQIExAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQtKgLegQIEBAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQs6gLegQIDxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ0pQJegUIzwIQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQs6gLegUI0AIQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&q=pizza&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQs6gLegUI7AIQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ0pQJegUI6AIQAQ"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&ved=1t:200715&ictx=111"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-bZnt6jMmErT-KRarIgXyuyEbgLVbVrL19D752u5Zq1JxsknUc6k2WnAYdF3IRSWkTH3pdQosATZjd3_wJT0jcn1ZGvea0l_Pe81RHnOCa9zKvy8rYGCOaVH6HKJ-v0Fbf3M4pWfq-1w08PlFYboBjESgVjCWuPSKS93yTwhvPbs5RLCAIhZYAj5yDun18lG7HGkbSgcdz0s_2rVuotT_RFlq9E6vh4gSWXTpD9fiMHs21DAcw&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ0pQJegUI5AIQAQ"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      },
      {
        "link": "https://www.pizzamyheart.com/",
        "title": "Pizza My Heart for pizza by the slice or whole pie",
        "description": "Pizza by the slice or whole pie with a focus on natural locally grown ingredients from California farms. Fresh salads, craft beers and a laid-back surf ...",
        "rank": 4,
        "global_rank": 8
      },
      {
        "link": "https://www.spinatospizzeria.com/",
        "title": "Spinato's Pizzeria: Best Restaurant Near Me - Spinato's Pizzeria",
        "description": "Savor classic Italian flavors at Spinato's Pizzeria, the best restaurant near me. Family-owned, offering delicious pizzas, pastas, and more!",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "image_alt": "pizza from www.spinatospizzeria.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRGnCOkZk6SizIss5cuiBfaISZqSMGuq_6Yb-XzMxkxS9g9gMXnrRI2jHk&usqp=CAE&s",
        "rank": 5,
        "global_rank": 19
      },
      {
        "link": "https://www.thekitchn.com/trader-joes-pizza-trick-podcast-23768950",
        "title": "The Rule-Breaking Tip That Makes Frozen Pizza Taste 10x Better",
        "description": "Why You Should Thaw Your Pizza Before Heating It in the Oven. That's right. The key to making frozen pizzas taste like they just came out of a wood-fired oven ...",
        "rank": 6,
        "global_rank": 20
      },
      {
        "link": "https://primepizza.com/",
        "title": "Prime Pizza | Authentic New York–Style Pizza in Los Angeles & Orange County",
        "description": "Discover Prime Pizza — serving the best New York–style pizza in Los Angeles and coming soon to Orange County. Fresh ingredients, housemade dough, ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "image_alt": "pizza from primepizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc78x5sSE2Dq_n5R8zvr0QJw2AWoxBLBQFLnXxUtPUhb0C_asv7_Xv-WE&usqp=CAE&s",
        "rank": 7,
        "global_rank": 21
      }
    ],
    "videos": [
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "author": "5 days ago",
        "rank": 1,
        "global_rank": 15
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "author": "3 days ago",
        "rank": 2,
        "global_rank": 16
      },
      {
        "link": "https://www.youtube.com/watch?v=jO3oFY_oxOA",
        "title": "I make these mini pizza almost daily! Delicious, inexpensive, and hardly anyone knows about it!",
        "author": "1 day ago",
        "rank": 3,
        "global_rank": 17
      },
      {
        "link": "https://www.youtube.com/watch?v=TB5JPppUZpY",
        "title": "LEFTOVER PIZZA WILL NEVER BE THE SAME...",
        "author": "1 day ago",
        "rank": 4,
        "global_rank": 18
      }
    ],
    "perspectives": [
      {
        "title": "Barstool Pizza Review - Casey's Pizza (San Francisco, CA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "58.9K+ views · 10 hours ago",
        "link": "https://www.youtube.com/watch?v=wj4vtZ0FR1Y",
        "image": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg"
      },
      {
        "title": "Costco: Where to find most perfect slice of cheap cheese pizza. 🍕🙏🤤",
        "author": "r/Costco",
        "source": "Reddit",
        "date": "230+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS-1N_u02vK54QYnMTrSSw2WUdR7skvRIYksS2HIZTJHxF7UxHkOK_roqVZhA&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS-1N_u02vK54QYnMTrSSw2WUdR7skvRIYksS2HIZTJHxF7UxHkOK_roqVZhA&usqp=CAI&s"
      }
    ],
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&prmd=misvn&ei=vrueaZ-OCZXl0PEP7ciciAY&start=10&sa=N"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ1QJ6BQiyAhAB",
        "rank": 1,
        "global_rank": 9
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ1QJ6BQi4AhAB",
        "rank": 2,
        "global_rank": 10
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwif5eihpfSSAxWVMjQIHW0kB2EQ1QJ6BQi-AhAB",
        "rank": 3,
        "global_rank": 11
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 3
      },
      {
        "question": "Who has the $4.99 pizza deal?",
        "question_type": "ai_overview",
        "answers": [
          {
            "texts": [
              {
                "type": "paragraph",
                "snippet": "Little Caesars frequently offers $4.99 pizza deals, often for two large one-topping pizzas or their Detroit-Style Slices-N-Stix combo, available for limited times with online codes like \"PIZZAPIZZA,\" so check their deals page or app for current offers.",
                "snippet_highlighted_words": "Little Caesars"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "Check Little Caesars' Website/App: Look for limited-time offers and deals sections."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Look for Codes: They often use codes like \"PIZZAPIZZA\" for online orders."
                  },
                  {
                    "type": "list",
                    "title": "Specific Promotions: Recent examples include:",
                    "list": [
                      {
                        "type": "paragraph",
                        "snippet": "2 Large 1-Topping Pizzas: for $4.99 each (online deal)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Detroit-Style Slices-N-Stix Combo: (2 pepperoni slices + Crazy Bread) for $4.99 (lunch special)."
                      },
                      {
                        "type": "paragraph",
                        "snippet": "Sicilian Style Pizza: for $4.99."
                      }
                    ]
                  }
                ],
                "title": "How to find current deals:"
              },
              {
                "type": "list",
                "list": [
                  {
                    "type": "paragraph",
                    "snippet": "These are often limited-time offers and prices can vary by location."
                  },
                  {
                    "type": "paragraph",
                    "snippet": "Some deals require online ordering or specific promo codes."
                  }
                ],
                "title": "Keep in mind:"
              }
            ],
            "references": [
              {
                "href": "https://littlecaesars.com/en-us/deals/#:~:text=Little%20Caesars%C2%AE,Limited%2DTime%20Pizza%20Deals",
                "title": "Little Caesars®| Limited-Time Pizza Deals",
                "subtitle": "Little Caesars® | Limited-Time Pizza Deals.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 0
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/get-2-large-pizzas-for-499-each-online-only-with-promo-code-pizzapizza/1187325250106928/#:~:text=get%202%20large%20pizzas%20for%204.99%20each%20online%20only%20with%20promo%20code%20PIZZAPIZZA",
                "title": "get 2 large pizzas for 4.99 each online only with promo code ...",
                "subtitle": "Aug 26, 2025 — get 2 large pizzas for 4.99 each online only with promo code PIZZAPIZZA.",
                "source": "Facebookhttps://www.facebook.com",
                "index": 1
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302966938542758/#:~:text=2%20pizzas%20for%20$4.99%20each%20from%20Little%20Caesars%20Code:%20PIZZAPIZZA",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — 2 pizzas for $4.99 each from Little Caesars Code: PIZZAPIZZA.",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 2
              },
              {
                "href": "https://littlecaesars.com/en-us/deals/8389/#:~:text=Little%20Caesars%C2%AE%20%7C%20Limited%2DTime%20Pizza%20Promos",
                "title": "search for local deals! - Little Caesars® Pizza",
                "subtitle": "Little Caesars® | Limited-Time Pizza Promos.",
                "source": "Little Caesarshttps://littlecaesars.com",
                "index": 3
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1286902870149165/",
                "title": "Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza!Pizza! Deal!",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 4
              },
              {
                "href": "https://www.youtube.com/watch?v=eKx39t79o2I&t=7",
                "title": "NEW Little Caesars $4.99 Detroit-Style Slices-N-Stix Review!",
                "subtitle": "Jan 14, 2026 — you a little butt cheek laughter y'all was like \"Damn when you going to stop playing games. and pull up on that newoo at Little C's. are they even a...",
                "source": "YouTube · Daym Dropshttps://www.youtube.com",
                "index": 5
              },
              {
                "href": "https://www.instagram.com/reel/DTOGL8bgSLa/#:~:text=OCR,to%20be%20split%20half%20&%20half%20.",
                "title": "$10 will get you 2 LARGE 1-topping pizzas at Little Caesar's ... - Instagram",
                "subtitle": "Jan 7, 2026 — OCR. 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . 2 PIZZAS FOR $10 AT LITTLE CAESAR'S . Get 2 large 1-topping pizzas for $4.99 each online until 1/18 with c...",
                "source": "Instagram · tayloreatsnychttps://www.instagram.com",
                "index": 6
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/videos/new-sicilian-style-pizza-only-499/647195651659750/#:~:text=For%20only%20$4.99?!,4",
                "title": "For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars",
                "subtitle": "Oct 29, 2025 — For only $4.99?! Check out the Sicilian Style Pizza | Little Caesars | Facebook. Video. 󱡘 Little Caesars. Oct 29, 2025󰞋󱘚 New! Sicilian Style Pizza,",
                "source": "Facebook · Little Caesarshttps://www.facebook.com",
                "index": 7
              },
              {
                "href": "https://www.facebook.com/LittleCaesars/posts/double-the-pizzas-twice-the-yum-get-2-large-1-topping-pizzas-for-just-499-little/1302965878542864/#:~:text=Double%20the%20pizzas%2C%20twice%20the,Deal!",
                "title": "Little Caesars - Facebook",
                "subtitle": "Jan 13, 2026 — Double the pizzas, twice the yum! Get 2 large 1-topping pizzas for just $4.99 Little Caesars® limited time Pizza! Pizza! Deal!",
                "source": "Facebookhttps://www.facebook.com",
                "index": 8
              }
            ]
          }
        ],
        "rank": 2,
        "global_rank": 4
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.dominos.com/",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBMgmhIihdzXKJSaNX2FtUC1cunqgi_Yg-BMi2gscWl4SHC4Zx2-NXdro&usqp=CAE&s",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.papajohns.com/",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza, Sides & More",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...",
        "rank": 3,
        "global_rank": 7
      }
    ]
  }
  ```
</ResponseExample>


# Geo-location
Source: https://docs.brightdata.com/api-reference/serp/google-search/geo-location

Configure the Bright Data Google Search Geo-Location parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Stands for the encoded location you want to use for your search and will be used to change geo-location.

  ```http theme={null}
  https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
  ```

  <Tip>
    A CSV with all available `uule` values can be [downloaded here](https://developers.google.com/adwords/api/docs/appendix/geotargeting).

    The value of column **Canonical Name** from the CSV can be used as a raw string to the API

    > **Example**: `&uule=New+York,New+York,United+States`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={8} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1200000000,
      "search_time": 0.46,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:55:57.015Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&aep=1&ntc=1&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ2J8OegQIBxAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQtKgLegQIGxAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQtKgLegQIERAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQs6gLegQIDxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ0pQJegUI0QEQAQ"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQs6gLegUI0AEQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQs6gLegUI3QEQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ0pQJegUI0gEQAQ"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t4NPsly-1JiYt9S6VsSRnLf-sxULmbNLebMKQgkhwHc2FSfFXQ&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQkc0JKAB6BAgQEAE&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 10
      },
      {
        "link": "https://www.pizzamyheart.com/",
        "source": "Pizza My Heart",
        "display_link": "https://www.pizzamyheart.com",
        "title": "Pizza My Heart for pizza by the slice or whole pie",
        "description": "Pizza by the slice or whole pie with a focus on natural locally grown ingredients from California farms. Fresh salads, craft beers and a laid-back surf ...",
        "snippet_highlighted_words": [
          "Pizza by the slice or whole pie"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 11
      },
      {
        "link": "https://primepizza.com/",
        "source": "Prime Pizza",
        "display_link": "https://primepizza.com",
        "title": "Prime Pizza | Authentic New York–Style Pizza in Los Angeles ...",
        "description": "Discover Prime Pizza — serving the best New York–style pizza in Los Angeles and coming soon to Orange County. Fresh ingredients, housemade dough, ...",
        "snippet_highlighted_words": [
          "serving the best New York–style pizza in Los Angeles"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 12
      },
      {
        "link": "https://pagliacci.com/",
        "source": "Pagliacci Pizza",
        "display_link": "https://pagliacci.com",
        "title": "Pagliacci Pizza: Seattle Area Pizza & Delivery | Pagliacci Pizza",
        "description": "Pagliacci Pizza, serving Seattle's best pizza since 1979. Offering pizza by the slice and pizza delivery service to homes and businesses.",
        "snippet_highlighted_words": [
          "Seattle's best pizza since 1979"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 13
      },
      {
        "link": "https://littlecaesars.com/",
        "source": "Little Caesars",
        "display_link": "https://littlecaesars.com",
        "title": "Little Caesars® Pizza | Best Value Delivery & Carryout",
        "description": "Order HOT-N-READY® pizzas, Crazy Bread®, and more from Little Caesars® online for delivery or carryout.",
        "snippet_highlighted_words": [
          "Order HOT-N-READY® pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 7,
        "global_rank": 14
      },
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "source": "YouTube · Andy Cooks",
        "display_link": "283.1K+ views · 5 days ago",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "description": "Today I'm going to show you how to recreate at least my childhood memories of delicious bad pizza it's easily done at home.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQawToEk5MRMKlzdRutYRvfJGXtRpWQfVqXSJ2z8EdrkapJcXFUS00qnQ&s",
        "duration": "13:55",
        "duration_sec": 835,
        "rank": 8,
        "global_rank": 15
      },
      {
        "link": "https://www.extremepizza.com/",
        "source": "Extreme Pizza",
        "display_link": "https://www.extremepizza.com",
        "title": "Extreme Pizza | Freshly Made Gourmet Pizza | Pizza Delivery",
        "description": "Extreme Pizza is your go-to store for fresh gourmet pizzas that will satisfy your cravings. Explore our menu for our exciting flavors.",
        "snippet_highlighted_words": [
          "fresh gourmet pizzas that will satisfy your cravings"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 16
      }
    ],
    "perspectives": [
      {
        "title": "Barstool Pizza Review - Casey's Pizza (San Francisco, CA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "58.9K+ views · 10 hours ago",
        "link": "https://www.youtube.com/watch?v=wj4vtZ0FR1Y",
        "image": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/wj4vtZ0FR1Y/hqdefault.jpg"
      },
      {
        "title": "Costco: Where to find most perfect slice of cheap cheese pizza. 🍕🙏🤤",
        "author": "r/Costco",
        "source": "Reddit",
        "date": "230+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR56LIOT4XXriPnI8lkdNLieh_vVTIR2bkveJMrspN70Vc83Hvb7BHycWsG_g&usqp=CAI&s"
      },
      {
        "title": "Barstool Pizza Review - Casey’s Pizza (San Francisco, CA)",
        "author": "stoolpresidente · Instagram",
        "source": "American businessman",
        "date": "2K+ likes · 8 hours ago",
        "link": "https://www.instagram.com/reel/DVKIeZTlJCR/?hl=en",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQX9LeRL2aFzRhGOpiS2hlaI-MmNlAgUW_rPSWXklkzgSsmzx7R_pbGqtuCPQ&usqp=CAI&s=10"
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA...",
          "image_alt": "Image of Pizza Dough Recipe",
          "image_base64": "data:image/webp;base64,UklGRrYOAABXRUJQVlA4IKoOAACQVA..."
        },
        {
          "image": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg...",
          "image_alt": "Image of Salami, Red Onion and Oregano Pizza - Tillamook",
          "image_base64": "data:image/webp;base64,UklGRk4KAABXRUJQVlA4IEIKAACQNg..."
        },
        {
          "image": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/webp;base64,UklGRmgIAABXRUJQVlA4IFwIAACwMg..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQmxN6BAgNEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "285 Calories",
        "portion": "1 slice (107 g)"
      }
    },
    "overview": {
      "title": "Popular Toppings",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=1&lsack=G7meadq9Asmxi-gPrO7dKA&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQtgN6BAg-EAM"
    },
    "snack_pack": [
      {
        "cid": "13570545686572397234",
        "name": "Sicilian Pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 3,
        "type": "Pizza",
        "work_status": "\"Pizza was prepared quickly, the products were all of high quality and fresh.\"\"Pizza was prepared quickly, the products were all of high quality and fresh.\"",
        "address": "Nashville, TN",
        "rank": 1,
        "global_rank": 1
      },
      {
        "cid": "14742264573553154910",
        "name": "327 Pizza Company",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 3,
        "type": "Pizza",
        "work_status": "\"Ordered a gluten free, and a regular Hawaiian pizza- flavour is fantastic!\"\"Ordered a gluten free, and a regular Hawaiian pizza- flavour is fantastic!\"",
        "address": "Nashville, TN",
        "rank": 2,
        "global_rank": 2
      },
      {
        "cid": "11325640445402842264",
        "name": "PizzaForno",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"\"It's a fully robotic pizza machine that will bake your pizza in 4 minutes!\"",
        "address": "Columbia, SC",
        "rank": 3,
        "global_rank": 3
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=10&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=20&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=30&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAI"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=G7meadq9Asmxi-gPrO7dKA&start=10&sa=N&sstk=Af77f_fJ7Wgh6eItfEwoCb_2t0G8CuvwOrSZ6TONEKuDyawmmNMPWUUVHKH1zLB6ENb15HPlr67qq80L4RkoL1jJrvuFJT9BhMhFdg&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ8tMDegQIFxAE"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ1QJ6BAhiEAE",
        "rank": 1,
        "global_rank": 17
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ1QJ6BAhnEAE",
        "rank": 2,
        "global_rank": 18
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwiat_PfovSSAxXJ2AIHHSx3FwUQ1QJ6BAhmEAE",
        "rank": 3,
        "global_rank": 19
      }
    ],
    "people_also_ask": [
      {
        "question": "What's the 2 hour rule for pizza?",
        "question_type": "featured",
        "answer_source": "Curry Pizza House",
        "answer_link": "https://currypizzahouse.com/georgiadoubleupsocial-com/how-long-does-pizza-last/#:~:text=Pizza%20should%20NEVER%20be%20left,to%20prevent%20rapid%20bacteria%20growth.",
        "answer_display_link": "https://currypizzahouse.com › how-long-does-pizza-lasthttps://currypizzahouse.com › how-long-does-pizza-last",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Pizza should NEVER be left out for more than 2 hours (and just 1 hour if the room is above 90°F/32°C). Hot/Outdoor Events: When it's really warm, the safe window shrinks—refrigerate or ice your pizza within 20–60 minutes to prevent rapid bacteria growth.Jun 29, 2025"
            },
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 6
      }
    ],
    "oragnic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu, find locations, track orders. Sign up for Domino's email ...",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.dominos.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza ...",
        "description": "Deals · Pizza · Papadias · Papa Bites · Wings · Sides · Papa Bowls · Desserts · Drinks · Dipping Sauces · Extras. Earn Papa Dough® faster than ever, and redeem ...Read more",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 10
      }
    ]
  }
  ```
</ResponseExample>


# Hotel
Source: https://docs.brightdata.com/api-reference/serp/google-search/hotel

Reference for the Bright Data Google Search Hotel parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&hotel_occupancy=4
```

<Tip>
  See `brd_occupancy` parameter of [Hotels](/api-reference/serp/google-hotels/occupancy) which provides more flexibility.
</Tip>

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Number of guests to book a room for (maximum 6 guests)

  > **Examples:**\
  > `brd_occupancy=1` - look for a room for 1 person \
  > `brd_occupancy=2` - for 2 persons (`default`)  \
  > `brd_occupancy=3` - for 3 persons, etc.

  ```txt wrap theme={null}
  https://www.google.com/search?q=pizza&hotel_occupancy=4
  ```
</ParamField>

<ParamField type="string">
  Check-in date and check-out date, separated by comma.

  > **Format**: `YYYY-MM-DD,YYYY-MM-DD`\
  > **Example**: `2026-04-03,2026-04-10`

  ```txt wrap theme={null}
  https://www.google.com/search?q=pizza&hotel_dates=2023-05-01%2C2023-05-03
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&hotel_occupancy=4",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&hotel_occupancy=4"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&hotel_occupancy=4',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&hotel_occupancy=4',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={13} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-03-06T18:52:27.595Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&hotel_occupancy=4",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&aep=1&ntc=1&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q2J8OegQIDhAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4QtKgLegQIFBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4QtKgLegQIEhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qs6gLegQIERAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qs6gLegUI0gEQAQ"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q0pQJegUI0wEQAQ"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&q=pizza&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qs6gLegUI2QEQAQ"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_nEWDW6jSORACXpMnd172rhLzUI8cHh7a3WdrUa4STZi6DJP1PQVlodXI5fi6VycfM2fw28lhfWz323yxTcZ-fbjC5Yh0xzt6OfmbOYOjs4XIa7mEA&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q0pQJegUI1wEQAQ"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t4NPsly-1JiYt9S6VsSRnLf-sxULmbNLebMKQgkhwHc2FSfFXQ&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Qkc0JKAB6BAgVEAE&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.pizzahut.com/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.com",
        "title": "Pizza Hut | Delivery & Carryout - No One OutPizzas The Hut!",
        "description": "$10 any pizza. Price includes Original Pan, Hand Tossed, Thin 'N Crispy. $10 ANY Large Pizza​. Up to 5 ...Read more",
        "snippet_highlighted_words": [
          "10 any pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from www.pizzahut.com",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "link": "https://en.wikipedia.org/wiki/Pizza",
        "source": "Wikipedia",
        "display_link": "https://en.wikipedia.org › wiki › Pizza",
        "title": "Pizza",
        "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a ...Read more",
        "snippet_highlighted_words": [
          "an Italian dish typically consisting of a flat base of leavened wheat-based dough"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from en.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "link": "https://www.dominos.com/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.com",
        "title": "Domino's: Pizza Delivery & Carryout, Pasta, Wings & More",
        "description": "Order pizza, pasta, sandwiches & more online for carryout or delivery from Domino's. View menu ... Any pizza. Any toppings. $9.99 each. Choose your crust ...Read more",
        "snippet_highlighted_words": [
          "Order pizza, pasta, sandwiches & more online for carryout or delivery"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "rank": 3,
        "global_rank": 6
      },
      {
        "link": "https://www.papajohns.com/",
        "source": "Papa John's",
        "display_link": "https://www.papajohns.com",
        "title": "Papa Johns Pizza Delivery & Carryout - Best Deals on Pizza ...",
        "description": "Enjoy the ease of ordering delicious pizza for delivery or carryout from a Papa Johns near you. Start tracking the speed of your delivery and earn rewards ...",
        "snippet_highlighted_words": [
          "Enjoy the ease of ordering delicious pizza for delivery or carryout"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 4,
        "global_rank": 7
      },
      {
        "link": "https://www.hellopizza.com/",
        "source": "Hello Pizza",
        "display_link": "https://www.hellopizza.com",
        "title": "Home | Hello Pizza in Edina, MN",
        "description": "Hello Pizza in Minneapolis offers dine in, takeaway and delivery.",
        "snippet_highlighted_words": [
          "Hello Pizza in Minneapolis"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2K0fe4r_e0X_q3ijPJKuQWN-LaKhDS1ZS3q8z-c-YBKR5jV6GYSLB&usqp=CAE&s",
        "image_alt": "pizza from www.hellopizza.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2K0fe4r_e0X_q3ijPJKuQWN-LaKhDS1ZS3q8z-c-YBKR5jV6GYSLB&usqp=CAE&s",
        "rank": 5,
        "global_rank": 8
      },
      {
        "link": "https://www.facebook.com/stoolpresidente/videos/i-found-great-chicago-style-pizza-in-atlanta-with-an-incredible-story-too/925930907057728/",
        "source": "Facebook · David Portnoy - El Presidente",
        "display_link": "350+ reactions · 1 hour ago",
        "title": "I Found GREAT Chicago Style Pizza In Atlanta With An ...",
        "description": "Alberta Lozi's Pizzeria. Chicago style. I already forgot. It's named after his mother. It's a tribute to my mom who passed away from cancer so ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR5c2hDx_iSKy6EZsP9xZs8QiiWeJTFvLCieUWpTGrisX2C_ftYCYejdA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR5c2hDx_iSKy6EZsP9xZs8QiiWeJTFvLCieUWpTGrisX2C_ftYCYejdA&s",
        "duration": "1:02",
        "duration_sec": 62,
        "rank": 6,
        "global_rank": 9
      },
      {
        "link": "https://www.nytimes.com/2026/03/03/dining/pizza-hut.html",
        "source": "The New York Times",
        "display_link": "https://www.nytimes.com › 2026/03/03 › dining › pizz...",
        "title": "Pizza Hut Take Fans on a Trip to the Past",
        "description": "The deep-dish pan pizza dates back to the beginning of Pizza Hut. The deep-dish pan pizza has been a Pizza Hut signature from the beginning.Read more",
        "snippet_highlighted_words": [
          "deep-dish pan pizza"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "3 days ago",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 7,
        "global_rank": 10
      },
      {
        "link": "https://littlecaesars.com/",
        "source": "Little Caesars",
        "display_link": "https://littlecaesars.com",
        "title": "Little Caesars® Pizza | Best Value Delivery & Carryout",
        "description": "Order HOT-N-READY® pizzas, Crazy Bread®, and more from Little Caesars® online for delivery or carryout.",
        "snippet_highlighted_words": [
          "Order HOT-N-READY® pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 8,
        "global_rank": 11
      },
      {
        "link": "https://www.reddit.com/r/AskLosAngeles/comments/1rm1wui/who_has_the_best_pizza_in_la/",
        "source": "Reddit · r/AskLosAngeles",
        "display_link": "350+ comments · 16 hours ago",
        "title": "Who has the best pizza in LA? : r/AskLosAngeles",
        "description": "Desano is good, but there is better Neapolitan pizza around (Pizzeria Sei is probably the gold standard in LA). Quarter Sheets is fantastic ...Read more",
        "snippet_highlighted_words": [
          "pizza",
          "Pizzeria"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 12
      }
    ],
    "perspectives": [
      {
        "title": "Who has the best pizza in LA? Popular comment · Pizzeria Sei for Neapolitan. Then Bianco, Pizzana.",
        "author": "r/AskLosAngeles",
        "source": "Reddit",
        "date": "350+ comments · 16 hours ago",
        "link": "https://www.reddit.com/r/AskLosAngeles/comments/1rm1wui/who_has_the_best_pizza_in_la/"
      },
      {
        "title": "I Ate In America's Pizza Capital To Find The Best Pizza",
        "author": "sir yacht · YouTube",
        "source": "TikTok star & Food Network contestant",
        "date": "275.7K+ views · 4 days ago",
        "link": "https://www.youtube.com/watch?v=gCalAS4SlaM",
        "image": "https://img.youtube.com/vi/gCalAS4SlaM/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/gCalAS4SlaM/hqdefault.jpg"
      },
      {
        "title": "I Found GREAT Chicago Style Pizza In Atlanta With An Incredible Story Too",
        "author": "stoolpresidente · Facebook",
        "source": "American businessman",
        "date": "350+ reactions · 2 hours ago",
        "link": "https://www.facebook.com/stoolpresidente/videos/i-found-great-chicago-style-pizza-in-atlanta-with-an-incredible-story-too/925930907057728/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSlVOtYpEd8y0JpkiNMhy51ybHS8Vt_dBgXfZOghf-HYebs5Io7KC1EQIa8CQ&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSlVOtYpEd8y0JpkiNMhy51ybHS8Vt_dBgXfZOghf-HYebs5Io7KC1EQIa8CQ&usqp=CAI&s=10"
      },
      {
        "title": "Barstool Pizza Review - Glide Pizza (Decatur, GA)",
        "author": "One Bite Pizza Reviews · YouTube",
        "source": "Pizza reviews & rankings",
        "date": "96.8K+ views · 3 days ago",
        "link": "https://www.youtube.com/watch?v=5IVjXnV15cE",
        "image": "https://img.youtube.com/vi/5IVjXnV15cE/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/5IVjXnV15cE/hqdefault.jpg"
      },
      {
        "title": "Where can I find a pizza like this?",
        "author": "r/SanJose",
        "source": "Reddit",
        "date": "60+ comments · 19 hours ago",
        "link": "https://www.reddit.com/r/SanJose/comments/1rlxx81/where_can_i_find_a_pizza_like_this/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOgiaOW0FYTVRHJqNFtVAhux6nSpnvNr6w1epX8AvZykRiZR5ZGLpje07b_g&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOgiaOW0FYTVRHJqNFtVAhux6nSpnvNr6w1epX8AvZykRiZR5ZGLpje07b_g&usqp=CAI&s"
      },
      {
        "title": "Easy Homemade Pizza That Beats Takeout",
        "author": "In The Kitchen With Gina Young · YouTube",
        "source": "Cooking channel",
        "date": "490+ views · 20 hours ago",
        "link": "https://www.youtube.com/watch?v=CVFKdARKonI",
        "image": "https://img.youtube.com/vi/CVFKdARKonI/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/CVFKdARKonI/hqdefault.jpg"
      },
      {
        "title": "Best pizza in Port St Lucie Fla?",
        "author": "Pizzaholics · Facebook",
        "source": "Pizza enthusiast",
        "date": "29 minutes ago",
        "link": "https://www.facebook.com/groups/742034912983989/posts/2439433803244083/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAPzkwKJX8rct5LhEtAN6p-ypb5UjDiHn0aZ8e9S6nS8tPmROY_1E2gFxXeus&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAPzkwKJX8rct5LhEtAN6p-ypb5UjDiHn0aZ8e9S6nS8tPmROY_1E2gFxXeus&usqp=CAI&s"
      },
      {
        "title": "Friday pizza night",
        "author": "r/80s",
        "source": "Reddit",
        "date": "300+ comments · 7 hours ago",
        "link": "https://www.reddit.com/r/80s/comments/1rmbv8y/friday_pizza_night/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOjE6TPBJKWHgNAjhsCCUJcO1rt2p_P-UcmzHUdys7bLeSQdacHm3Zs-7FIQ&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOjE6TPBJKWHgNAjhsCCUJcO1rt2p_P-UcmzHUdys7bLeSQdacHm3Zs-7FIQ&usqp=CAI&s"
      },
      {
        "title": "Only the best at Krispy Pizza! 🍕💯 #KRISPYPIZZA",
        "author": "krispypizza · Instagram",
        "source": "Brooklyn-based pizza parlor",
        "date": "1.1K+ likes · 3 hours ago",
        "link": "https://www.instagram.com/reel/DVjJxy-Dt4U/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSurMetfUkGZYejKARlaFBojMWqZxMT-oU92H8yOzKMaTVd2dQdaohonHumBw&usqp=CAI&s=10",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSurMetfUkGZYejKARlaFBojMWqZxMT-oU92H8yOzKMaTVd2dQdaohonHumBw&usqp=CAI&s=10"
      },
      {
        "title": "Homemade Pepperoni Pizza Rolls That Are Ridiculously Easy",
        "author": "allthingsbbq · YouTube",
        "source": "BBQ store",
        "date": "4.8K+ views · 1 day ago",
        "link": "https://www.youtube.com/watch?v=u5cOPjwKobM",
        "image": "https://img.youtube.com/vi/u5cOPjwKobM/hqdefault.jpg",
        "image_url": "https://img.youtube.com/vi/u5cOPjwKobM/hqdefault.jpg"
      },
      {
        "title": "Top Pizza in the Bay Area",
        "author": "Cesar Hernandez, Soleil Ho",
        "source": "San Francisco Chronicle",
        "date": "1 month ago",
        "link": "https://www.sfchronicle.com/projects/2023/best-pizza-sf-bay-area/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPGyTJpaRNE8ruXgkLdHkPFLVu5T7ykcJezvyYa07SUmrk7T0XaSntO19GBw&usqp=CAI&s"
      },
      {
        "title": "Best Pizza in Sonoma County: 16 Editor-Approved Spots for Tasty Pies",
        "author": "Heather Irwin · Sonoma Magazine",
        "source": "Sonoma County dining writer",
        "date": "1 month ago",
        "link": "https://www.sonomamag.com/best-pizza-in-sonoma-county-favorite-restaurants-for-tasty-pies/",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRKzKYqmgbflEzazf8g_Fnp6r4J6ZIO3t95YB0TFq11OXOKFQ8kMf2TeeEzww&usqp=CAI&s"
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "285 Calories",
        "portion": "1 slice (107 g)"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&udm=1&lsack=aSKraZ7iJK3Xxc8Pqo2U8AI&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4QtgN6BAgaEAM"
    },
    "snack_pack": [
      {
        "cid": "17310745698520163861",
        "name": "Vito Lucco Pizza Co.",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 5,
        "type": "Pizza Takeout",
        "work_status": "Takeout·Takeout·No-contact deliveryNo-contact delivery",
        "address": "Fridley, MN",
        "rank": 1,
        "global_rank": 1
      },
      {
        "cid": "6845281105756624082",
        "name": "Market Street Pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "Opens soon",
        "work_status_details": "11 AM",
        "address": "Spokane, WA",
        "rank": 2,
        "global_rank": 2
      },
      {
        "cid": "12478441968863339846",
        "name": "Best Pizza & Brew",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "reviews_cnt": 4,
        "type": "Pizza",
        "work_status": "Opens soon",
        "work_status_details": "11 AM",
        "address": "Oceanside, CA",
        "rank": 3,
        "global_rank": 3
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=10&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=20&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=30&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAI"
        },
        {
          "page": 5,
          "start": 40,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=40&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAK"
        },
        {
          "page": 6,
          "start": 50,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=50&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAM"
        },
        {
          "page": 7,
          "start": 60,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=60&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAO"
        },
        {
          "page": 8,
          "start": 70,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=70&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAQ"
        },
        {
          "page": 9,
          "start": 80,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=80&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAS"
        },
        {
          "page": 10,
          "start": 90,
          "link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=90&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAU"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&ei=aSKraZ7iJK3Xxc8Pqo2U8AI&start=10&sa=N&sstk=Af77f_e5v5TopL795qiozhhU5eJn4iwBi5glMnBqhjrpgSsD85n-Zjv1OCUpsxqxJjRLcAjTe6I5pFI3UdNBkjvPwf4WrFeN_AE87g&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q8tMDegQIChAE"
    },
    "related": [
      {
        "text": "Pizza wiki",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+wiki&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjHARAB",
        "rank": 1,
        "global_rank": 13
      },
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjNARAB",
        "rank": 2,
        "global_rank": 14
      },
      {
        "text": "Pizza open",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+open&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjPARAB",
        "rank": 3,
        "global_rank": 15
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjIARAB",
        "rank": 4,
        "global_rank": 16
      },
      {
        "text": "Pizza drawing",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+drawing&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjLARAB",
        "rank": 5,
        "global_rank": 17
      },
      {
        "text": "Pizza picture",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+picture&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjJARAB",
        "rank": 6,
        "global_rank": 18
      },
      {
        "text": "Pizza Movie",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+Movie&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjKARAB",
        "rank": 7,
        "global_rank": 19
      },
      {
        "text": "Pizza recipe",
        "link": "https://www.google.com/search?sca_esv=173855d81f8ceba4&hotel_occupancy=4&gl=us&hl=en&q=Pizza+recipe&sa=X&ved=2ahUKEwjeut_u-IuTAxWta_EDHaoGBS4Q1QJ6BQjOARAB",
        "rank": 8,
        "global_rank": 20
      }
    ]
  }
  ```
</ResponseExample>


# Image search
Source: https://docs.brightdata.com/api-reference/serp/google-search/images

Configure the Bright Data Google Search Image Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=isch
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For Image search, set `tbm` value to `isch`

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=isch
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=isch",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=isch"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=isch',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=isch',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={14} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 656000000,
      "search_time": 0.28,
      "language": "en-CO",
      "country": "Colombia",
      "country_code": "CO",
      "location": "United States",
      "gl": "CO",
      "mobile": false,
      "basic_view": false,
      "search_type": "image_output",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-24T20:28:05.271Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=isch&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&aep=1&ntc=1&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQ2J8OegQICRAD"
      },
      {
        "title": "All",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQ0pQJegQICxAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=62b03b7345eac9c6&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&q=pizza&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQtKgLegQIDxAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFmzd3PgOqQPiZGQbkKtfgZKjRVM-fWbSp27mOZd-VNrvsbfJifTcov-iKLq_qwKGsmICHQsDRnG2LrYhoqkYhIypqPFo4FOivgbAwMhEGvaBpiHBPZ7uoGgmnRvbGb63LsPIFEs5NpsiXI1a_RIDq28fxm4tQ&sa=X&ved=2ahUKEwi9pfzK-_KSAxVOe_UHHXz3CLAQ0pQJegQIDhAB"
      }
    ],
    "images": [
      {
        "link": "https://www.tasteofhome.com/recipes/homemade-pizza/",
        "original_image": "https://www.tasteofhome.com/wp-content/uploads/2018/01/Homemade-Pizza_EXPS_FT23_376_EC_120123_3.jpg",
        "title": "Homemade Pizza Recipe: How to Make It",
        "source": "Taste of Home",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Homemade Pizza Recipe: How to Make It",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://en.wikipedia.org/wiki/Pizza",
        "original_image": "https://upload.wikimedia.org/wikipedia/commons/9/91/Pizza-3007395.jpg",
        "title": "Pizza - Wikipedia",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Pizza - Wikipedia",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.tillamook.com/recipes/salami-red-onion-and-oregano-pizza",
        "original_image": "https://images.ctfassets.net/j8tkpy1gjhi5/5OvVmigx6VIUsyoKz1EHUs/b8173b7dcfbd6da341ce11bcebfa86ea/Salami-pizza-hero.jpg",
        "title": "Red Onion and Oregano Pizza - Tillamook",
        "source": "Tillamook",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Red Onion and Oregano Pizza - Tillamook",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.sortirambnens.com/es/recetas/que-hacemos-en-casa/cocinar-con-ninos/segundos-platos/la-receta-de-la-pizza-de-pepperoni/",
        "original_image": "https://www.sortirambnens.com/wp-content/uploads/2019/02/pizza-de-peperoni.jpg",
        "title": "LA RECETA DE LA PIZZA DE PEPPERONI ...",
        "source": "Sortir amb nens",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "LA RECETA DE LA PIZZA DE PEPPERONI ...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.surlatable.com/recipe/perfect-pizza-dough/REC-283110?srsltid=AfmBOoqF1hpSQid6DabYdImjWsYMX5hG3GgUcdnDPSK7X0qP9Wtu-c7y",
        "original_image": "https://assets.surlatable.com/m/15a89c2d9c6c1345/72_dpi_webp-REC-283110_Pizza-jpg",
        "title": "Perfect Pizza Dough | Sur La Table",
        "source": "Sur La table",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Perfect Pizza Dough | Sur La Table",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      }
    ],
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&hl=en&udm=2&ei=0gmeab30Gc721e8P_O6jgAs&start=10&sa=N"
    }
  }
  ```
</ResponseExample>


# Job search
Source: https://docs.brightdata.com/api-reference/serp/google-search/jobs

Configure the Bright Data Google Search Job Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&ibp=htl%3Bjobs
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Use the `ibp` parameter for Jobs search type. i.e. `ibp=htl;jobs`

  ```http theme={null}
  https://www.google.com/search?q=pizza&ibp=htl%3Bjobs
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&ibp=htl%3Bjobs',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&ibp=htl%3Bjobs',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 0,
      "search_time": 0.31,
      "language": "en",
      "location": "Montgomery County, Texas",
      "mobile": false,
      "basic_view": false,
      "search_type": "jobs",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:43:34.614Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&aep=1&ntc=1&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQ2J8OegQICxAD"
      },
      {
        "title": "All",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQ0pQJegQIDBAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQtKgLegQIDxAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQ0pQJegQIERAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQtKgLegQIJxAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQs6gLegQIJRAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQs6gLegQIKBAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWFbKVVilxndHi5Wmmk7zyv03Mys_YyBP4ugQ98ij9I0KKsP0Cu165bWlMKbYdlbOsIY961jqcRx3YqPBajY3XBKmZnjo68pJ_p3Acf3Ma5IASVQq8A&q=pizza&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQs6gLegQIJhAB"
      },
      {
        "title": "Remote",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+remote&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YV-lRKgxbXFUKPzYPZyKeILNvm73fF0fEZBdNGAU-CIo-G2v151xiOXgGNzzbT8u0ut-v67slmYRTRP9OMBvE6aLADbcd5B0FzMBs3wPbXiTQ9cGYyEEe3yA_qDdNJCOx4BWAA&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAB6BAgSEAE&ictx=0"
      },
      {
        "title": "No degree",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+no+degree&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-T4emPHvteFlrAH19mCmukosX52MC87I2751Bq-nSNFe7KZu5GoL88oPZl2yYAEhJ5Ut6RNtgvVIk39OnIMwpuh_fG1KeQuQxDw35P9FvGPNubTFpsIhiLd_WkNV_t83o5qdj4CrIjGYdMFylvoWcqY5aT_Q&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAF6BAgUEAE&ictx=0"
      },
      {
        "title": "Remote",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+remote&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YV-lRKgxbXFUKPzYPZyKeILNvm73fF0fEZBdNGAU-CIo-G2v151xiOXgGNzzbT8u0ut-v67slmYRTRP9OMBvE6aLADbcd5B0FzMBs3wPbXiTQ9cGYyEEe3yA_qDdNJCOx4BWAA&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAJ6BAgWEAE&ictx=0"
      },
      {
        "title": "No degree",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+no+degree&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-T4emPHvteFlrAH19mCmukosX52MC87I2751Bq-nSNFe7KZu5GoL88oPZl2yYAEhJ5Ut6RNtgvVIk39OnIMwpuh_fG1KeQuQxDw35P9FvGPNubTFpsIhiLd_WkNV_t83o5qdj4CrIjGYdMFylvoWcqY5aT_Q&udm=8&sa=X&ved=2ahUKEwiWusv4n_SSAxWR4skDHfyGN7UQxKsJKAN6BAgTEAE&ictx=0"
      }
    ],
    "jobs": {
      "items": [
        {
          "title": "Cook",
          "company": "Pizza Hut",
          "location": "Splendora, TX",
          "source": "via Pizza Hut",
          "link": "https://www.google.com/search?ibp=htl;jobs&q=pizza&htidocid=6_16nT4f27lf3OouAAAAAA%3D%3D&hl=en-US&shem=epsd1&shndl=37&shmd=H4sIAAAAAAAA_xXEsQrCMBAA0L2fUJebRRMRXHR0UJwEHdzKJR5JasyF3CmlXy--4XXfbnFkfsEaLuxACJuPwAVOzCFTf4iqVfbWimQTRFGTN57flgs5nuzITv4NErFRzag0bHebydQSlv01zTPC-aOQCtxqpvLkhiu4P36bVsuPeAAAAA&shmds=v1_ATWGeeNVkvz2LAq4sD_AMOtS0LznF37q0WDx9Hcs2z8KYOPDOQ&source=sh/x/job/li/m1/1#fpstate=tldetail&htivrt=jobs&htiq=pizza&htidocid=6_16nT4f27lf3OouAAAAAA%3D%3D",
          "postings": [
            {
              "link": "https://jobs.pizzahut.com/job/cook/splendora-TX/9ed4898e-f0bc-4748-83c7-a5f700204a97-s1/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "source": "Pizza Hut"
            },
            {
              "link": "https://www.indeed.com/viewjob?jk=ecd1a619eee2659b&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "indeed.com",
              "source": "Indeed"
            },
            {
              "link": "https://careers.sonicdrivein.com/cook/job/01789E60CB4B75CC3271CD641023DC6D?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "sonicdrivein.com",
              "source": "Sonic Careers"
            },
            {
              "link": "https://www.breakroom.cc/en-us/jobs/listing/2967571-sonic-drive-in-cook-14685-us-59-splendora-texas-77372-united?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "breakroom.cc",
              "source": "Breakroom"
            },
            {
              "link": "https://www.simplyhired.com/job/g_EzjTnQ7_MlIl5f1_sMb0Q7lqcWzZth-2Po_Xgbx0waxxOq5RQ1-Q?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "simplyhired.com",
              "source": "SimplyHired"
            },
            {
              "link": "https://earnbetter.com/app/job/01K1YHEFHJCCV87HTJ0BVTSBQN/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "earnbetter.com",
              "source": "EarnBetter"
            },
            {
              "link": "https://us.bebee.com/job/fbf20584e76c867fed8c9a86abc0838a?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "bebee.com",
              "source": "BeBee"
            },
            {
              "link": "https://www.learn4good.com/jobs/texas/restaurant_and_food_service/4885221513/e/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "learn4good.com",
              "source": "Learn4Good"
            }
          ],
          "original_image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwnb5TyY9xtYb1GAz0Dl7oSudGQ00CkPqAgHOr&s=0",
          "date": "2 days ago",
          "employment_type": "Full-time",
          "description": "Under daily supervision of the General Manager, the position of the Cook/Dishwasher is responsible for preparing all food items in an expedient manner to specifications; and cleaning dishes, pots. pans, and public areas of the building. He/she is also responsible for keeping the floor dry and free of debris.\n\nEssential Functions:\n1. Prepare: food in accordance lo specifications.\n\n2. Keep station. stocked before, during and after shifts.\n\n3. Set up stations\n\n4. Keep floors at work area free of debris and spills.\n\nS. Maintain cleanliness in the work station.\n\n6. Wash dishes and take trash out to the dumpster.\n\n7. Prep dough and other products for upcoming shifts.\n\nRequirements\n\nPhysical Requirements:\nl. Have constant need (66%- 100% of time) to stand without the benefit of support while cooking and cleaning.\n\n2. Haw frequent need (33%-66% of time) to walk around the kitchen.\n\n3. Have frequent need (33%-66% of time) to bend/stop/squat while taking items off bottom shelves;\ncleaning floors and walls; and lading shelves.\n\n4. Have frequent need (33%-66t% of time) to push and pull equipment while performing cleaning duties.\n\n5. Have frequent need (33%-66% of time) to reach above shoulders when reaching for items stored above\nthe shoulder level and while changing light bulbs.\n\n6. Have frequent need (33%-66% of time) to grasp/grip glasses, serving plates, trays, and utensils; and while\npreparing food.\n\n7. Have frequent need (33%-66% of time) for finger dexterity for such things as writing, gripping, cleaning,\nand turning off and on lights.\n\n8. Have occasional need (1%\n• 33% of time) to operate dishwasher.\n\n9. Have occasional need (1%- 33% of time) to lift/carry object weighing between 75 and 51 pounds and\nfrequent need (33%- 66% of time) to handle objects weighing 50 pounds or less.\n\nVision Requirements:\nl . Rave frequent need (33%-66% of time) to be able to see detail while cooking and preparing food; and\nwhile cleaning dishes.\n\nl. Have constant Need (66%-100% of time) to be able to see beyond arms length in order to see personnel\nand cleaning area.\n\nHearing Requirements:\n1. Have constant need (66%\n• 100% of time) to be able to hear other personnel in order to communicate\neffectively.\n\nSpeaking Requirements:\nl. Have constant need (66%-100% of time) to be able to speak with other personnel in order to\ncommunicate effectively.",
          "highlights": [
            {
              "name": "Qualifications",
              "list": [
                "Have constant need (66%- 100% of time) to stand without the benefit of support while cooking and cleaning",
                "Have occasional need (1%",
                "frequent need (33%- 66% of time) to handle objects weighing 50 pounds or less",
                "Rave frequent need (33%-66% of time) to be able to see detail while cooking and preparing food; and",
                "Have constant Need (66%-100% of time) to be able to see beyond arms length in order to see personnel",
                "Have constant need (66%",
                "100% of time) to be able to hear other personnel in order to communicate",
                "Have constant need (66%-100% of time) to be able to speak with other personnel in order to",
                "communicate effectively"
              ]
            },
            {
              "name": "Benefits",
              "list": [
                "Set up stations"
              ]
            },
            {
              "name": "Responsibilities",
              "list": [
                "Under daily supervision of the General Manager, the position of the Cook/Dishwasher is responsible for preparing all food items in an expedient manner to specifications; and cleaning dishes, pots",
                "pans, and public areas of the building",
                "He/she is also responsible for keeping the floor dry and free of debris",
                "Prepare: food in accordance lo specifications",
                "Keep station",
                "stocked before, during and after shifts",
                "Keep floors at work area free of debris and spills",
                "Maintain cleanliness in the work station",
                "Wash dishes and take trash out to the dumpster",
                "Prep dough and other products for upcoming shifts",
                "Haw frequent need (33%-66% of time) to walk around the kitchen",
                "Have frequent need (33%-66% of time) to bend/stop/squat while taking items off bottom shelves;",
                "cleaning floors and walls; and lading shelves",
                "Have frequent need (33%-66t% of time) to push and pull equipment while performing cleaning duties",
                "Have frequent need (33%-66% of time) to reach above shoulders when reaching for items stored above",
                "the shoulder level and while changing light bulbs",
                "Have frequent need (33%-66% of time) to grasp/grip glasses, serving plates, trays, and utensils; and while",
                "preparing food",
                "Have frequent need (33%-66% of time) for finger dexterity for such things as writing, gripping, cleaning,",
                "and turning off and on lights",
                "33% of time) to operate dishwasher",
                "Have occasional need (1%- 33% of time) to lift/carry object weighing between 75 and 51 pounds and"
              ]
            }
          ],
          "tags": [
            {
              "name": "Posted",
              "value": "2 days ago"
            },
            {
              "name": "Employment Type",
              "value": "Full-time"
            },
            {
              "name": "Qualification",
              "value": "No degree mentioned"
            }
          ],
          "rank": 1,
          "global_rank": 1
        },
        {
          "title": "Pizza Crew Member",
          "company": "Marco's Pizza",
          "location": "Spring, TX",
          "source": "via Indeed",
          "link": "https://www.google.com/search?ibp=htl;jobs&q=pizza&htidocid=iaF8mrghlWO4rIUZAAAAAA%3D%3D&hl=en-US&shem=epsd1&shndl=37&shmd=H4sIAAAAAAAA_yXNsQrCMBCAYVz7CLrcpogmIrjU0UEQCoIObiUJRxJJc-EuYOnsg6u4_OP3N-9Zs7rGaTJwYnxBh4NFhi1cyIKgYReAMpyJfML5MdRapNVaJCkv1dTolKNBU0ZLo36SlV96CYaxJFOx3x92oyrZrxfdV6OlwH8XM9wKx-w3cH98AOUDRe6HAAAA&shmds=v1_ATWGeePt9xuCWrUfWX5IQQKOF5SjzMvMdpiQrvexRSN54JOBfg&source=sh/x/job/li/m1/1#fpstate=tldetail&htivrt=jobs&htiq=pizza&htidocid=iaF8mrghlWO4rIUZAAAAAA%3D%3D",
          "postings": [
            {
              "link": "https://www.indeed.com/viewjob?jk=d900ec075453de28&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "source": "Indeed"
            },
            {
              "link": "https://www.ziprecruiter.com/c/Marcos-Pizza/Job/Pizza-Crew-Member/-in-Spring,TX?jid=1368cf35ed2a0cef&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "ziprecruiter.com",
              "source": "ZipRecruiter"
            },
            {
              "link": "https://www.glassdoor.com/job-listing/pizza-crew-member-marco-s-pizza-JV_IC1140222_KO0,17_KE18,31.htm?jl=1009785317988&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "glassdoor.com",
              "source": "Glassdoor"
            },
            {
              "link": "https://www.snagajob.com/jobs/831020036?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "snagajob.com",
              "source": "Snagajob"
            },
            {
              "link": "https://www.simplyhired.com/job/aOMTcyJItD5qv5C3tmyq-Nlf19s0LADGFB387R6o4Oj8KF44Y5WkGA?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "simplyhired.com",
              "source": "SimplyHired"
            },
            {
              "link": "https://www.career.com/job/sizemore-organization/pizza-crew-member/j202211141724175481797?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "career.com",
              "source": "Career.com"
            },
            {
              "link": "https://www.learn4good.com/jobs/spring/texas/restaurant_and_food_service/4848557952/e/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "learn4good.com",
              "source": "Learn4Good"
            }
          ],
          "original_image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSyN2IgTP8Y9A9OPucp18Spzc6bketz_KYnU8SS&s=0",
          "employment_type": "Part-time",
          "description": "Positions inside the store include:\n\nPizza Maker: In a recent poll customers stated the top three reasons they love Marco’s is quality, great taste, and great pizza. Trained by the best, you could be slapping dough and joining the best pizza makers in the business in no time. As a pizza maker you will learn how to make and stretch fresh dough, generously sauce and cheese each pizza, and add only the best, freshest possible ingredients to your great pizzas.\n\nCut Table: A key position in all Marco’s stores, the cut table keeps the whole pizza process moving with the crew counting on you. You’ll be the one to take pizzas from the oven to the cut table, slice and box them, and make sure each order gets it’s important sides and salads.\n\nCounter: As the first impression of Marco’s to walk-in and phone customers, excellent customer service delivered with a smiling attitude is key for the counter position.\n\nPrep: Because Marco’s offers only the freshest, best ingredients, we need prep employees who take pride in setting up the whole system for success. You will be trained on best practices for making fresh dough, slicing fresh, crispy veggies, and the most efficient way to stock product. Prep work sets up the store to handle “the rush” which is crucial.\n\nWhether you are looking for part-time add a little money to the budget job, or to start a career, apply now and see if you and Marco’s are a good match.\n\nThriving in fast-paced “rush” periods with an attitude of accountability are great qualities to have on at Marco’s, whether you are interested in part-time work or a career. Apply now and find out if you and Marco’s are a good match.\n\nBrand: Marco's Pizza\nAddress: 21630 Kuykendahl Rd. Suite 430 Spring, TX - 77388\nProperty Description: 1-21630 Kuykendahl Rd. Spring, TX\nProperty Number: 5136",
          "highlights": [
            {
              "name": "Qualifications",
              "list": [
                "Trained by the best, you could be slapping dough and joining the best pizza makers in the business in no time",
                "As a pizza maker you will learn how to make and stretch fresh dough, generously sauce and cheese each pizza, and add only the best, freshest possible ingredients to your great pizzas",
                "Thriving in fast-paced “rush” periods with an attitude of accountability are great qualities to have on at Marco’s, whether you are interested in part-time work or a career"
              ]
            },
            {
              "name": "Benefits"
            },
            {
              "name": "Responsibilities",
              "list": [
                "Cut Table: A key position in all Marco’s stores, the cut table keeps the whole pizza process moving with the crew counting on you",
                "You’ll be the one to take pizzas from the oven to the cut table, slice and box them, and make sure each order gets it’s important sides and salads",
                "Counter: As the first impression of Marco’s to walk-in and phone customers, excellent customer service delivered with a smiling attitude is key for the counter position",
                "You will be trained on best practices for making fresh dough, slicing fresh, crispy veggies, and the most efficient way to stock product",
                "Prep work sets up the store to handle “the rush” which is crucial"
              ]
            }
          ],
          "tags": [
            {
              "name": "Employment Type",
              "value": "Part-time"
            },
            {
              "name": "Qualification",
              "value": "No degree mentioned"
            }
          ],
          "rank": 2,
          "global_rank": 2
        },
        {
          "title": "Driver",
          "company": "Pizza Hut",
          "location": "Conroe, TX",
          "source": "via Pizza Hut",
          "link": "https://www.google.com/search?ibp=htl;jobs&q=pizza&htidocid=41Pgt-dTdcKNgdXaAAAAAA%3D%3D&hl=en-US&shem=epsd1&shndl=37&shmd=H4sIAAAAAAAA_xXEsQrCMBAA0L0_IAjCzWITEVx0VKg4OTi4lSQcSSTehdxVSr9efMPrpm5zbfmLDXq4swdB10ICJhiYY8H1OalWOVkrUkwUdZqDCfyxTOh5tm_28m-U5BrW4hTHw3E_m0pxu3rkZXFwmxQywYWpMe7g-foBKmxJ6XcAAAA&shmds=v1_ATWGeeOr095xwTHlZaGNHK27qHwwOzKgkq09Mk3fjAidMqci9g&source=sh/x/job/li/m1/1#fpstate=tldetail&htivrt=jobs&htiq=pizza&htidocid=41Pgt-dTdcKNgdXaAAAAAA%3D%3D",
          "postings": [
            {
              "link": "https://jobs.pizzahut.com/job/driver/conroe-TX/a27d3d1a-d936-4723-af1d-a5ee00cd45f6-s1/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "source": "Pizza Hut"
            },
            {
              "link": "https://www.indeed.com/viewjob?jk=65df9c4c0181032a&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "indeed.com",
              "source": "Indeed"
            },
            {
              "link": "https://careers.staffing-texas.com/jb/Driver-Jobs-in-Conroe-TX/13689519?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "staffing-texas.com",
              "source": "Staffing Texas, LLC"
            },
            {
              "link": "https://www.ziprecruiter.com/c/Four-PZ-Pizza,-Inc./Job/Driver/-in-Conroe,TX?jid=962e2c563fcb65ab&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "ziprecruiter.com",
              "source": "ZipRecruiter"
            },
            {
              "link": "https://www.glassdoor.com/job-listing/driver-frontier-waste-solutions-JV_IC1140144_KO0,6_KE7,31.htm?jl=1010020427521&utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "glassdoor.com",
              "source": "Glassdoor"
            },
            {
              "link": "https://www.simplyhired.com/job/EFVGrw1yWYOKztBggb46CEoX5y1AYN5EICu-J4t8bUqr6MLANZ6icQ?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "simplyhired.com",
              "source": "SimplyHired"
            },
            {
              "link": "https://hertzrentacar.betterteam.com/driver-%2837692%29?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "betterteam.com",
              "source": "Hertz Careers"
            },
            {
              "link": "https://us.bebee.com/job/2dac24fce7790f56df6017b7ba9782f6?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
              "site": "bebee.com",
              "source": "BeBee"
            }
          ],
          "original_image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwnb5TyY9xtYb1GAz0Dl7oSudGQ00CkPqAgHOr&s=0",
          "date": "12 days ago",
          "employment_type": "Full-time",
          "description": "Job Brief:\nUnder daily supervision of the Manager: To be hired as a Pizza Hut delivery driver in Texas, you must be at least 18 years old, have a valid driver's license, and possess a clean driving record with at least two years of driving experience. You also need a reliable vehicle, proof of insurance (where you are a listed driver), a keen sense of direction, and a friendly attitude, the position of the Driver is responsible for the safe and prompt delivery of pizzas to customers in their homes or business, must follow all traffic laws (DO NOT SPEED). He/she is also responsible for assisting in pizza preparation and clean up and taking phone orders.\n\nEssential Functions:\n1. Deliver pizza to customer and collect monies.\n\n2. Take phone orders.\n\n3. Prepare pizzas.\n\n4. Perform closing duties involving cleaning duties, e.g. washing dishes.\n\n5. Empty trash end clean the parking lot.",
          "highlights": [
            {
              "name": "Qualifications",
              "list": [
                "Under daily supervision of the Manager: To be hired as a Pizza Hut delivery driver in Texas, you must be at least 18 years old, have a valid driver's license, and possess a clean driving record with at least two years of driving experience",
                "You also need a reliable vehicle, proof of insurance (where you are a listed driver), a keen sense of direction, and a friendly attitude, the position of the Driver is responsible for the safe and prompt delivery of pizzas to customers in their homes or business, must follow all traffic laws (DO NOT SPEED)"
              ]
            },
            {
              "name": "Benefits"
            },
            {
              "name": "Responsibilities",
              "list": [
                "He/she is also responsible for assisting in pizza preparation and clean up and taking phone orders",
                "Deliver pizza to customer and collect monies",
                "Take phone orders",
                "Prepare pizzas",
                "Perform closing duties involving cleaning duties, e.g. washing dishes",
                "Empty trash end clean the parking lot"
              ]
            }
          ],
          "tags": [
            {
              "name": "Posted",
              "value": "12 days ago"
            },
            {
              "name": "Employment Type",
              "value": "Full-time"
            },
            {
              "name": "Qualification",
              "value": "No degree mentioned"
            }
          ],
          "rank": 3,
          "global_rank": 3
        }
      ]
    }
  }
  ```
</ResponseExample>


# Google Search localization
Source: https://docs.brightdata.com/api-reference/serp/google-search/localization

Configure the Bright Data Google Search Google Search localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&gl=fr&hl=fr
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```http theme={null}
  https://www.google.com/search?q=pizza&gl=fr
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```http theme={null}
  https://www.google.com/search?q=pizza&hl=fr
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&gl=fr&hl=fr",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&gl=fr&hl=fr"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&gl=fr&hl=fr',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&gl=fr&hl=fr',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={7, 8} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 973000000,
      "search_time": 0.41,
      "language": "fr",
      "country": "France",
      "country_code": "FR",
      "location": "France",
      "gl": "FR",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Recherche Google",
      "timestamp": "2026-02-24T20:23:18.752Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1&gl=fr&hl=fr",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=2&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQtKgLegQIFhAB"
      },
      {
        "title": "Vidéos",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=7&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQtKgLegQIGBAB"
      },
      {
        "title": "Vidéos courtes",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=39&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegQIERAB"
      },
      {
        "title": "Lieux",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=1&lsack=tAieafGYHf-c1sQP7tzSkA4&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegQIExAB"
      },
      {
        "title": "Sites de lieux",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=11&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegQIEBAB"
      },
      {
        "title": "Actualités",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ0pQJegQIDhAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&udm=web&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&q=pizza&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQs6gLegUIhgEQAQ"
      },
      {
        "title": "Livres",
        "href": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&q=pizza&udm=36&source=lnms&fbs=ADc_l-bpk8W4E-qsVlOvbGJcDwpnHC5OJXXTJvmMu2n9YYx-G8xzgQk24aW1N_FyIND5zVDd4bb14119C8nZHL5l4Fe3xClku41MXRAvxO93q4ubY1l9Hk1FiCr1bfzSXqh4O7o8B1sqrSvZ-w516qcDYmxC9v7HcBaL83oJPMyLdm5H5rNhNEUKI9qKs2vP6Ws5dn2NWKQ4EexSa_t63AI4j321NjMYlQ&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ0pQJegUIhwEQAQ"
      }
    ],
    "organic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pizza",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement d'huile ...",
        "snippet_highlighted_words": [
          "une recette de cuisine traditionnelle de la cuisine italienne"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "image_alt": "pizza sur fr.wikipedia.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "rank": 1,
        "global_rank": 18
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › ... › pizza",
        "title": "Recette de Pizza maison",
        "description": "Préparation de la pizza. Mettez votre four à préchauffer à 220°C. Sur votre plan de travail, étalez un peu de farine afin que la boule de colle pas.",
        "snippet_highlighted_words": [
          "Mettez votre four à préchauffer à 220°C"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "image_alt": "pizza sur www.marmiton.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "rank": 2,
        "global_rank": 19
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "Commandez vos pizzas en ligne en livraison ou à emporter"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza sur www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 3,
        "global_rank": 20
      },
      {
        "link": "https://www.youtube.com/watch?v=WVrdUC-92-w",
        "source": "YouTube · Julie Andrieu - Chaîne officielle",
        "display_link": "Plus de 60 k vues · il y a 2 ans",
        "title": "Pizza maison - 10 leçons pour la réussir",
        "description": "00:00 - Introduction 00:30 - Leçon 1 : Choisir les bons ingrédients : farine, eau, levure fraîche 01:57 - Leçon 2 : Préparez un levain ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTSNUtVRdhbjy1RctOwPWDoIcBixJcr0uIZ585eJyl0lkTLyhUXGt7gXA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTSNUtVRdhbjy1RctOwPWDoIcBixJcr0uIZ585eJyl0lkTLyhUXGt7gXA&s",
        "duration": "8:51",
        "duration_sec": 531,
        "rank": 4,
        "global_rank": 24
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › recette-pizza",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.",
        "snippet_highlighted_words": [
          "Pizza : Meilleures recettes"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 25
      },
      {
        "link": "https://www.pizzahut.fr/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.fr",
        "title": "Pizza Hut Livraison, vente à emporter | Commande en ligne ...",
        "description": "Pizza Hut Livraison, vente à emporter | Commande en ligne | Coupons, Promos.",
        "snippet_highlighted_words": [
          "Pizza Hut Livraison, vente à emporter"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 26
      },
      {
        "link": "https://www.youtube.com/@lafrenchpizza",
        "source": "YouTube · La French Pizza",
        "display_link": "Plus de 39,6 k abonnés",
        "title": "La French Pizza",
        "description": "Recette · HOW TO MAKE NEAPOLITAN PIZZA DOUGH? | Special for beginners and without equipment · HOW TO ROLL OUT PIZZA DOUGH? By hand, without a rolling pin!",
        "snippet_highlighted_words": [
          "HOW TO MAKE NEAPOLITAN PIZZA DOUGH"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "rank": 7,
        "global_rank": 27
      },
      {
        "link": "https://www.picard.fr/rayons/pizzas-et-tartes",
        "source": "Picard",
        "display_link": "https://www.picard.fr › rayons › pizzas-et-tartes",
        "title": "Pizzas et tartes",
        "description": "Picard vous propose un assortiment de pizzas et de tartes salées pour toute la famille. Elles se déclinent en formats ronds, carrés, individuels ou à partager.",
        "snippet_highlighted_words": [
          "Picard vous propose un assortiment de pizzas et de tartes salées pour toute la famille"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 28
      },
      {
        "link": "https://www.la-bella-pizza.fr/",
        "source": "LA BELLA PIZZA MARSEILLE",
        "display_link": "https://www.la-bella-pizza.fr",
        "title": "LA BELLA PIZZA MARSEILLE",
        "description": "26, PLACE NOTRE-DAME-DU-MONT MARSEILLE 6E ... C'EST LE GOÛT AUTHENTIQUE DE LA PIZZA AU FEU DE BOIS D'ANTAN, À LA TOMATE FRAÎCHE AU HACHOIR, À L'AIL ET À L'ORIGAN.",
        "snippet_highlighted_words": [
          "26, PLACE NOTRE-DAME-DU-MONT MARSEILLE 6E"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTld-I-7kBDNQ_svH12luxlkSyqHjYidZJcEsTO9qcE3nFKWsFZU9vS&usqp=CAE&s",
        "image_alt": "pizza sur www.la-bella-pizza.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTld-I-7kBDNQ_svH12luxlkSyqHjYidZJcEsTO9qcE3nFKWsFZU9vS&usqp=CAE&s",
        "rank": 9,
        "global_rank": 29
      },
      {
        "link": "https://www.hervecuisine.com/recette/recette-de-pizzas-facile/",
        "source": "Hervé Cuisine",
        "display_link": "https://www.hervecuisine.com › Recettes",
        "title": "Recette de pizza italienne maison facile en vidéo",
        "description": "Liste des ingrédients · 2 Oignons · 2 gousses d'ail · 300 ml de passata ou coulis de tomate · 1 cuil. à café d'herbes de Provence (thym, origan, ...",
        "snippet_highlighted_words": [
          "Liste des ingrédients"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "24 mars 2020",
            "rank": 1
          },
          {
            "type": "rating",
            "rating": 4.5,
            "reviews_cnt": 122,
            "rank": 2
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTgPFVxX3bZycyrJXnGa-6STq-fY-jdqukKprM7EZCuJgEIq1Cm7CvS&usqp=CAE&s",
        "image_alt": "pizza sur www.hervecuisine.com",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTgPFVxX3bZycyrJXnGa-6STq-fY-jdqukKprM7EZCuJgEIq1Cm7CvS&usqp=CAE&s",
        "rank": 10,
        "global_rank": 30
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Pain",
      "subtitle": "Pain",
      "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement d'huile d'olive, de sauce tomate, de mozzarella et d'autres ingrédients et cuite au four.",
      "description_source": "Wikipédia",
      "description_link": "https://fr.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/webp;base64,UklGRuQWAABXRUJQVlA4INgWAACwag...",
          "image_alt": "Image de Pizza maison à la friteuse à air – Parfaitement ...",
          "image_base64": "data:image/webp;base64,UklGRuQWAABXRUJQVlA4INgWAACwag..."
        },
        {
          "image": "data:image/webp;base64,UklGRkAIAABXRUJQVlA4IDQIAAAwLw...",
          "image_alt": "Image de Pizza Parma",
          "image_base64": "data:image/webp;base64,UklGRkAIAABXRUJQVlA4IDQIAAAwLw..."
        },
        {
          "image": "data:image/webp;base64,UklGRgoKAABXRUJQVlA4IP4JAADwNg...",
          "image_alt": "Image de Pizza Piccante | Oil & Vinegar",
          "image_base64": "data:image/webp;base64,UklGRgoKAABXRUJQVlA4IP4JAADwNg..."
        }
      ],
      "facts": [
        {
          "key": "Origine",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italie",
              "link": "https://www.google.com/search?sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&q=Italie&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRh4OGAJvOSklPiUalZSIgao4QqW76hqPIFuzQ7v7azf6k5fxmXNe-rtMqCs_t8NhvbAYJTVcpsAfehVTA_xRncYUE2DOj4YepnYp33la15xAXe361JXX31pqgLu0p6tOh_lc4hCW414ZieHhjAACQXtdol9-&sa=X&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQmxN6BAgbEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 36 cm, pâte moyenne",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "266 Calories",
        "portion": "100 grammes"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "snack_pack_map": {
      "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA...",
      "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAowAAA..."
    },
    "snack_pack": [
      {
        "name": "Pizza Time® Amiens",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFoAAA...",
        "reviews_cnt": 45,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Livraison sans contact ⋅ Site Web",
        "tags": [
          "Amiens"
        ],
        "site": "https://pizzatime.fr/",
        "rank": 1,
        "global_rank": 1
      },
      {
        "name": "La Maison des Pizzas",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "reviews_cnt": 44,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Pas de livraison ⋅ Site Web",
        "tags": [
          "Saint-Florent"
        ],
        "site": "https://webshop.fulleapps.io/s/maison-des-pizzas/mja1ntcyxzy2ngm",
        "rank": 2,
        "global_rank": 2
      },
      {
        "name": "Allo Pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4Q...",
        "reviews_cnt": 47,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Livraison ⋅ Site Web",
        "tags": [
          "Gannat"
        ],
        "site": "https://allo-pizza-gannat.fr/",
        "rank": 3,
        "global_rank": 3
      },
      {
        "name": "La Casa Del Pizz 🍕",
        "image": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepv8l9gqqDsx5bJ1Yk4RjzllN-XMC5FlN5EV88fS4WI1lp9VQwuWKl9lNNWy-UOv8ui5DMS7t3klKtc1yiEUrIcny1EJ-sv1CFKZhQczZEW8AelbUOs3w8frO5pTKzZ_PMZCUFTndzLsC0=w92-h92-n-k-no",
        "image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepv8l9gqqDsx5bJ1Yk4RjzllN-XMC5FlN5EV88fS4WI1lp9VQwuWKl9lNNWy-UOv8ui5DMS7t3klKtc1yiEUrIcny1EJ-sv1CFKZhQczZEW8AelbUOs3w8frO5pTKzZ_PMZCUFTndzLsC0=w92-h92-n-k-no",
        "reviews_cnt": 50,
        "type": "Pizza",
        "work_status": "Ferme bientôt",
        "work_status_details": "21:30",
        "address": "Saint-Julien-le-Pèlerin",
        "rank": 4,
        "global_rank": 21
      },
      {
        "name": "Pizzeria \"The Giorgi's\"",
        "image": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwerlK7DGPIKCqOf0elgQc9JiIsxJeCtJVaFt-gOZ2zSlfivqjQAcszTvwu6XgBo88huXlmG9tfzAE69IA2ENFTjT0hGzZzd51EAGe7xqa6E9PrmPohuS10jw_e1_iSPkBbYBdss=w92-h92-n-k-no",
        "image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwerlK7DGPIKCqOf0elgQc9JiIsxJeCtJVaFt-gOZ2zSlfivqjQAcszTvwu6XgBo88huXlmG9tfzAE69IA2ENFTjT0hGzZzd51EAGe7xqa6E9PrmPohuS10jw_e1_iSPkBbYBdss=w92-h92-n-k-no",
        "reviews_cnt": 49,
        "type": "Pizza",
        "work_status": "Ferme bientôt",
        "work_status_details": "22:00",
        "address": "La Bourboule, Repas sur place ⋅ Vente à emporter ⋅ Pas de livraison ⋅ Site Web",
        "site": "https://m.facebook.com/p/The-Giorgis-100079622973292/",
        "rank": 5,
        "global_rank": 22
      },
      {
        "name": "Mister Pizza -Nice Barla",
        "image": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepbbc8H391PfVftgmxxarUE5zevNpL3rBmT7PR1qqdlj9SS51tirt2LfZ-m6_kWnFxPOL81twrspJ1to64UUyv5FrofE4qFT20rXLa3VjH8IIgfJ_ej9LHxF4JYfNM4n9ESf9Q=w92-h92-n-k-no",
        "image_url": "https://lh3.googleusercontent.com/gps-cs-s/AHVAwepbbc8H391PfVftgmxxarUE5zevNpL3rBmT7PR1qqdlj9SS51tirt2LfZ-m6_kWnFxPOL81twrspJ1to64UUyv5FrofE4qFT20rXLa3VjH8IIgfJ_ej9LHxF4JYfNM4n9ESf9Q=w92-h92-n-k-no",
        "reviews_cnt": 40,
        "type": "Pizza",
        "address": "Repas sur place ⋅ Vente à emporter ⋅ Livraison ⋅ Site Web",
        "tags": [
          "Nice"
        ],
        "site": "http://www.mister-pizza.com/",
        "rank": 6,
        "global_rank": 23
      }
    ],
    "pagination": [
      {
        "page": 2,
        "start": 10,
        "link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&ei=tAieafGYHf-c1sQP7tzSkA4&start=10&sa=N&sstk=Af77f_cmD63hekmmnSSJPoXn1kdGehHJb1HbjLnOhIejeXAmILfZ4CiNxm-7n1A1lx7ZmrOJOMny3zsTqoN1okjJiF0_OWJ7ioddcg&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ8tMDegQICRAE"
      },
      {
        "page": 3,
        "start": 20,
        "link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&ei=tAieafGYHf-c1sQP7tzSkA4&start=20&sa=N&sstk=Af77f_cmD63hekmmnSSJPoXn1kdGehHJb1HbjLnOhIejeXAmILfZ4CiNxm-7n1A1lx7ZmrOJOMny3zsTqoN1okjJiF0_OWJ7ioddcg&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ8tMDegQICRAG"
      },
      {
        "page": 4,
        "start": 30,
        "link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=fr&hl=fr&ei=tAieafGYHf-c1sQP7tzSkA4&start=30&sa=N&sstk=Af77f_cmD63hekmmnSSJPoXn1kdGehHJb1HbjLnOhIejeXAmILfZ4CiNxm-7n1A1lx7ZmrOJOMny3zsTqoN1okjJiF0_OWJ7ioddcg&ved=2ahUKEwjxws_C-vKSAxV_jpUCHW6uFOIQ8tMDegQICRAI"
      }
    ],
    "related": [
      {
        "text": "Pizzas : Pizzas, Quiches et Tartes pas cher en Livraison et Drive",
        "link": "https://www.carrefour.fr/r/surgeles/pizzas-quiches-tartes/pizzas",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 4
      },
      {
        "text": "Super Recettes. . Pizza maison aux petits pains : recette facile pour ne plus en acheter",
        "link": "https://www.facebook.com/superrecettess/videos/pizza-maison-aux-petits-pains-recette-facile-pour-ne-plus-en-acheter/919698497110327/",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "text": "Pizzas à Emporter et en Livraison à Domicile à Saint-Étienne",
        "link": "https://www.ubereats.com/fr/category/saint-%C3%A9tienne-ara/pizza",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      }
    ],
    "people_also_ask": [
      {
        "question": "Quel ingrédient mettre sur une pizza ?",
        "question_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "question_type": "featured",
        "answer_source": "JeSuisGastronome.fr",
        "answer_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "answer_display_link": "https://www.jesuisgastronome.fr › actu › la-liste-des-quin...https://www.jesuisgastronome.fr › actu › la-liste-des-quin...",
        "answers": [
          {
            "type": "unordered_list",
            "title": "La liste des quinze meilleurs ingrédients pour une pizza",
            "items": [
              {
                "value": "- Le mozzarella fondant.",
                "rank": 1
              },
              {
                "value": "- La fraîcheur du basilic.",
                "rank": 2
              },
              {
                "value": "- L'authentique jambon de Parme.",
                "rank": 3
              },
              {
                "value": "- Le piquant des olives noires.",
                "rank": 4
              },
              {
                "value": "- Apprécier l'anchois salé",
                "rank": 5
              },
              {
                "value": "- Déguster les champignons frais.",
                "rank": 6
              },
              {
                "value": "- Aimer la roquette croquante.",
                "rank": 7
              },
              {
                "value": "- Savourer le saucisson épicé",
                "rank": 8
              }
            ],
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 14
      },
      {
        "question": "Quelle est la pizza la plus digeste ?",
        "question_type": "featured",
        "answer_source": "Ducreux",
        "answer_link": "https://www.ducreux-cfi.com/quest-ce-que-la-pinsa-romana/#:~:text=Pourquoi%20la%20pinsa%20est%2Delle,rendant%20la%20p%C3%A2te%20plus%20tol%C3%A9rable.",
        "answer_display_link": "https://www.ducreux-cfi.com › quest-ce-que-la-pinsa-ro...https://www.ducreux-cfi.com › quest-ce-que-la-pinsa-ro...",
        "answers": [
          {
            "type": "exact_answer",
            "title": "pinsa",
            "rank": 1
          },
          {
            "type": "answer",
            "value": {
              "text": "Pourquoi la pinsa est-elle plus digeste que la pizza traditionnelle ? La haute digestibilité de la pinsa repose sur plusieurs facteurs : La fermentation longue permet de prédigérer les sucres complexes, rendant la pâte plus tolérable."
            },
            "rank": 2
          }
        ],
        "rank": 2,
        "global_rank": 15
      },
      {
        "question": "Quel ordre pour garnir une pizza ?",
        "question_type": "featured",
        "answer_source": "Envie de Bien Manger",
        "answer_link": "https://www.enviedebienmanger.fr/conseils-cuisine/comment-faire-les-pizzas-maison-de-la-pate-a-la-cuisson-de-la-pizza#:~:text=Quelques%20conseils%20pour%20garnir%20votre%20pizza%20%3A&text=Prenez%20%C3%A9galement%20soin%20de%20respecter,et%20ensuite%20les%20autres%20ingr%C3%A9dients.",
        "answer_display_link": "https://www.enviedebienmanger.fr › conseils-cuisine › c...https://www.enviedebienmanger.fr › conseils-cuisine › c...",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "Quelques conseils pour garnir votre pizza : Prenez également soin de respecter l'ordre des ingrédients : d'abord la base (coulis de tomates, crème fraiche, ou huile d'olive) puis la mozzarella (de vache) ou du provolone, et ensuite les autres ingrédients."
            },
            "rank": 1
          }
        ],
        "rank": 3,
        "global_rank": 16
      },
      {
        "question": "Quelle est la meilleure pâte pour faire une pizza ?",
        "question_type": "featured",
        "answer_source": "Pizza Papa",
        "answer_link": "https://www.pizzapapa.fr/blog/quelle-pate-a-pizza-choisir/#:~:text=La%20p%C3%A2te%20feuillet%C3%A9e%20pour%20innover,pizzas%20pour%20un%20ap%C3%A9ritif%20dinatoire.",
        "answer_display_link": "https://www.pizzapapa.fr › blog › quelle-pate-a-pizza-ch...https://www.pizzapapa.fr › blog › quelle-pate-a-pizza-ch...",
        "answers": [
          {
            "type": "answer",
            "value": {
              "text": "La pâte feuilletée pour innover La pâte feuilletée est idéale pour réaliser une pizza plus originale. Elle apporte une touche de légèreté et croustille bien. Elle est recommandée si vous préparez des pizzas pour un apéritif dinatoire.11 juil. 2025"
            },
            "rank": 1
          }
        ],
        "rank": 4,
        "global_rank": 17
      }
    ],
    "oragnic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pizza",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement d'huile ...",
        "snippet_highlighted_words": [
          "une recette de cuisine traditionnelle de la cuisine italienne"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "image_alt": "pizza sur fr.wikipedia.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT3LHIkhBM9Js037FoYdKk9hSCK8Lz1EB0RxeyS6EExOQjLb9qLPsZ3&usqp=CAE&s",
        "rank": 1,
        "global_rank": 18
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › ... › pizza",
        "title": "Recette de Pizza maison",
        "description": "Préparation de la pizza. Mettez votre four à préchauffer à 220°C. Sur votre plan de travail, étalez un peu de farine afin que la boule de colle pas.",
        "snippet_highlighted_words": [
          "Mettez votre four à préchauffer à 220°C"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "image_alt": "pizza sur www.marmiton.org",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGNL56si-nVFxs_zeTO6q7XwUjiet_MAnn7sKNYYmjYzDOYxYm7WIc&usqp=CAE&s",
        "rank": 2,
        "global_rank": 19
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "Commandez vos pizzas en ligne en livraison ou à emporter"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza sur www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 3,
        "global_rank": 20
      }
    ]
  }
  ```
</ResponseExample>


# Multiple requests
Source: https://docs.brightdata.com/api-reference/serp/google-search/multiple-requests

Configure the Bright Data Google Search multiple requests parameter (31 languages) to refine queries and return matching results as JSON or HTML.

```json theme={null}
"multi":[
  {
    "query":{"q":"pizza","num":20}},
    {"query":{"q":"pizza","num":100}
  }
]
```

<Note>
  Please note that parallel requests work only with async mode.
</Note>

## Parameters

<ParamField type="string">
  Make parallel requests through our API server using POST request.

  Parallel requests will be using the same peer and session and can be used for comparison tests, i.e. making an identical pair of requests with 2 different values for a selected parameter

  <CodeGroup>
    ```js Same Keywords with different num theme={null}
    multi=[
      {"query":{"q":"pizza","num":20}},
      {"query":{"q":"pizza","num":100}}
    ]
    ```

    ```js Different Keywords theme={null}
    multi=[
      {"query":{"q":"pizza"}},
      {"query":{"q":"burger"}}
    ]
    ```
  </CodeGroup>
</ParamField>

<RequestExample>
  ```shell cURL highlight={5} theme={null}
  curl --request POST \
    --url https://api.brightdata.com/serp/req?zone=serp_api1 \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{"country": "US","multi":[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]}'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","multi":[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={10} theme={null}
  const options = {
    method: 'POST',
    headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
    body: JSON.stringify({
      query: {q: 'pizza', gl: 'au', hl: 'en', start: 20},
      country: 'US',
      multi: [{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]
    })
  };

  fetch('https://api.brightdata.com/serp/req?zone=serp_api1', options)
    .then(res => res.json())
    .then(res => console.log(res))
    .catch(err => console.error(err));
  ```

  ```python Python highlight={11} theme={null}
  import requests

  url = "https://api.brightdata.com/serp/req?zone=serp_api1"

  payload = {
      "multi": [{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}],
      "country": "US",
      "brd_json": "json"
  }

  headers = {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
  }

  response = requests.post(url, json=payload, headers=headers)

  print(response.text)
  ```
</RequestExample>


# News search
Source: https://docs.brightdata.com/api-reference/serp/google-search/news

Configure the Bright Data Google Search News Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=nws
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For News search, set `tbm` value to `nws`.

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=nws
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=nws",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=nws"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=nws',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=nws',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1110000,
      "search_time": 0.25,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "news",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:21:53.400Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=nws&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "All",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&source=lnms&sa=X&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ0pQJegQIAhAE"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&source=lnms&sa=X&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ0pQJegQIAhAG"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&source=lnms&sa=X&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ0pQJegQIAhAI"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&source=lnms&ved=1t:200715&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?q=pizza&gl=US&hl=en&um=1&ie=UTF-8&ved=1t:200715&ictx=111"
      }
    ],
    "news": [
      {
        "title": "Hegseth says he’ll order random pizzas to throw off monitoring app",
        "link": "https://thehill.com/policy/defense/5750716-pentagon-pizza-report-hegseth/",
        "source": "The Hill",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Pentagon Pizza Index ties pizza spikes to military action",
        "link": "https://www.jpost.com/international/article-887543",
        "source": "The Jerusalem Post",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "date": "2 days ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "Domino's Pizza® Announces Fourth Quarter and Fiscal 2025 Financial Results",
        "link": "https://ir.dominos.com/news-releases/news-release-details/dominos-pizzar-announces-fourth-quarter-and-fiscal-2025",
        "source": "Domino's Pizza",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "Global retail sales growth (excluding foreign currency impact) of 4.9% for the fourth quarter; 5.4% growth for fiscal 2025.",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "How Domino's is trying to double its business during a rough patch for big pizza rivals",
        "link": "https://www.cnbc.com/2026/02/23/dominos-ceo-i-think-we-can-double-this-business.html",
        "source": "CNBC",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "On the heels of a better-than-expected quarter, Domino's Pizza shares rose on Monday. CEO Russell Weiner told CNBC in an interview Monday...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "These 13 pizzerias are Pittsburgh’s best, and reflect Western Pa.’s position as a rising pizza powerhouse",
        "link": "https://www.post-gazette.com/life/dining/2026/02/24/best-pizza-pittsburgh-1/stories/202602160047",
        "source": "Pittsburgh Post-Gazette",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "Pittsburgh is in the midst of its most consequential pizza boom since the mass market expansion of the now all-American staple in the...",
        "date": "23 hours ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Domino's Responds After US Family Orders Pizza At Airport Terminal To Save Money",
        "link": "https://www.ndtv.com/offbeat/dominos-responds-after-us-family-orders-pizza-at-airport-terminal-to-save-money-11132755",
        "source": "NDTV",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "The video of the family receiving their Domino's order at the airport sparked debate on bringing food to the flight.",
        "date": "6 hours ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Savvy Sliders, Fat Boy’s Pizza co-branded restaurant set to open this week",
        "link": "https://www.21alivenews.com/2026/02/24/savvy-sliders-fat-boys-pizza-co-branded-restaurant-set-open-this-week/",
        "source": "WPTA | 21Alive | Fort Wayne, IN",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "A new co-branded restaurant, featuring Savvy Sliders and Fat Boy's Pizza, is coming to Fort Wayne soon.",
        "date": "9 hours ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "Tasting Table names top 15 pizzerias in Connecticut. Seven of them are in New Haven.",
        "link": "https://www.ctinsider.com/food/article/tasting-table-connecticut-pizza-new-haven-21849051.php",
        "source": "CT Insider",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "Frank Pepe's, Zuppardi's Apizza, Sally's Apizza, Modern Apizza and The Little Rendezvous all made Tasting Table's list of the top 15 pizza...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Lakewood pizza shop closes for good",
        "link": "https://fox8.com/news/lakewood-pizza-shop-closes-for-good/",
        "source": "FOX 8 News",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "LAKEWOOD, Ohio (WJW) – Another Lakewood restaurant has closed shop. Roman Fountain Pizza announced they had served up customers' last slice...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Big Oven Pizza restaurant in Kearny Mesa shot up three times in one week",
        "link": "https://www.10news.com/news/local-news/big-oven-pizza-shot-up-three-times-in-one-week",
        "source": "10News.com",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "description": "SAN DIEGO (KGTV) — Two doors at the front of Big Oven Pizza are boarded up and conspicuous duct tape patches are stuck over bullet holes in...",
        "date": "1 day ago",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 11
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=10&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAE"
        },
        {
          "page": 3,
          "start": 20,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=20&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAG"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=30&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAI"
        },
        {
          "page": 5,
          "start": 40,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=40&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAK"
        },
        {
          "page": 6,
          "start": 50,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=50&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAM"
        },
        {
          "page": 7,
          "start": 60,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=60&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAO"
        },
        {
          "page": 8,
          "start": 70,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=70&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAQ"
        },
        {
          "page": 9,
          "start": 80,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=80&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAS"
        },
        {
          "page": 10,
          "start": 90,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=90&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAU"
        }
      ],
      "current_page": 1,
      "next_page": 2,
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&tbm=nws&ei=ELGeab2oNPqq1sQPupiliQs&start=10&sa=N&ved=2ahUKEwi98L2Km_SSAxV6lZUCHTpMKbEQ8tMDegQIBRAE"
    }
  }
  ```
</ResponseExample>


# Google Search pagination
Source: https://docs.brightdata.com/api-reference/serp/google-search/pagination

Configure the Bright Data Google Search Google Search pagination parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/search?q=pizza&start=20
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define the result offset - results to start from the selected value. Used for managing pagination.

  ```http theme={null}
  https://www.google.com/search?q=pizza&start=20
  ```
</ParamField>

<ParamField type="string">
  <Warning>
    **Deprecated As of September 11, 2025 by Google**

    * The Number of results to return is usually 10, results' set size may vary.
    * The `start` parameters can be used to paginate within results' set. 
    * To get top 100 results, Bright Data offes a Web Scraping API. Read more here: [Get top google 100 results in one API call](/products/serp-api/get-top-100-google-results)
  </Warning>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&start=20",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&start=20"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&start=20',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&start=20',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={16} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 1190000000,
      "search_time": 0.44,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:51:55.402Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&start=20&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&aep=1&ntc=1&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDYnw56BAgJEAQ"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBC0qAt6BAgLEAE"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBC0qAt6BAgQEAE"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCzqAt6BAgOEAE"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDSlAl6BAg_EAE"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCzqAt6BAg-EAE"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&q=pizza&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCzqAt6BAhJEAE"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3o6iwGk6Iv1tRbZIBNIVs-4Dki9dynYvfwBVZUSUkihwf6Po1X8vgm-4XqAkWV_U_mSmFfDrYQ3JJnT9pFVWyBg4AncR4kUgE3P9Dn8YQ2qpg4mGYZH3cN0xQoqqXY3iPBHuF6UXBhWnU9Lvfw4ijII1Eq0jCo7w_teMvuVi1Ne_ekoSug&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDSlAl6BAhKEAE"
      },
      {
        "title": "Pizza",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Restaurant&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-YkRxG3oIOwBP9pqV8A9knLvLZuH8Ewms8PAcf7ea3t7vBPQw4wVHVJjcROFSOKtHXRR2H_BfQe33fsQJwZ7aPDC6-ok&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBCRzQkoAHoECCYQAQ&ictx=0"
      },
      {
        "title": "Open now",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza+open+now&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-ECkonaxdRgZHsQ3XflvCSBiBCh_HbnzwOVJT-6OwuTvkFnr4XZJ6m8RkC2Fm5NGv2sorw8NbG_kFTWumCMT5jNTI_TVBcLXVF_mk39-SWhfTOYHMWr9FknOPOs0q-crIBxIW9i8mduwjXgtuXbqR1QMCgDOg&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoAHoECBkQAQ&ictx=0"
      },
      {
        "title": "Top rated",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=top+rated+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-FC0ik9p7W40OH-Q3jP-vf-5Mtff03iEnPSzoqB-QNRky0asQGe19T-rLo3j4dKwg9K03-l4Y0aGnO5tf1a_6vVc4NodbwRxARhOPxmdDeRSTUQeoqj_oWiIGPXSF5xIVnZgbShI3syWAnARvf5cPjQCB4EzA&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoAXoECBoQAQ&ictx=0"
      },
      {
        "title": "Cheap",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=cheap+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-FwR7YC2iiNfesR7EhVUJV4xMiq-wqZuzQNTXo-ei19eUztSjfyDI5PzqsPvQFzzonTDVZ-bd4RknDhFOA54OC2GPMi_GEtlOI7zpzC12JGNdw2XWsoCTtJOYv0RTO-jC4snE34&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoAnoECB0QAQ&ictx=0"
      },
      {
        "title": "Upscale",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=upscale+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-GyVBFHuURJ5r9dsjmlxShj9gOY566k6M_Z8ryTQ2ujcSQU4pktDVdWE_wWsXLjwuvZZ8TWpZWz2H8h3MebldMJbySKoSw54dGEJ1i9mqukLXDANGElFaJbH8b4tFukAHLOpOGZjycO5ZBmhnbyEiUxIH9eqw&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoA3oECCUQAQ&ictx=0"
      },
      {
        "title": "Beer",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=beer+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-GvIbMixB_SE227_SwtA5frifagUSkZ0lE6Js6dSDDrQTmZhal5fHlZ1KJQ-Mp1q-L4mcOVynCgmIxX1fMQA9L4RmDQ8bsKHxOYOmHoM4hZveKOVn6PPiwDEUaV7aVpawvkplCMkqhe4z9Yzjko4u_mzkySyvO0VyUpykyhmgMk2t4r7aOjg94bn4YtOsJvg8NW3_Zb&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoBHoECCIQAQ&ictx=0"
      },
      {
        "title": "Wine",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=wine+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-Et6sGWmPCsL1NN9TXZF-w4uoXfsF7BGyzoGjhtHxEjJ4rXzxPV3_hCOKn2gcAgKmc_ErzdSBd0areMK5vdiDTt66NSCYOVInN9iNM_T0WxY-J6lQ78Inc5bxYMwpY-xfsdrGuy-BxJc0GPHDESJONClZg0qOkkmSh3jLXVu2QrbUdkyoizZd-qhlWfr2WhaPQtq9yr&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoBXoECEgQAQ&ictx=0"
      },
      {
        "title": "Recently opened",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=recently+opened+pizza&uds=ALYpb_ncDc7jTlmw6Mmq7NjuX5c-wuWIuHbR2VDKv6da3f4aDvN8AZxA4LGRgSO9dgIm2PykXMFDjhzUYFwURhZ_B2a58YFCPUHvqd_5dUYo1wRb0NtooGKtRpGUYuY9zpbRZ-GJ7jIxfTxsLLGw6QUgqkQg1iOvOgLdeSbCK8T9BCWkfYPhP7j3SncII5eeAhM_kso9Q4KSoodhFrjRhpUF01tWJi3v4rElzOAjlMX6CiXuc4UaAvR2BDnWaiT0WsBCdl1PaZc3cX1O_HgkpAqTviw7NVj_aQ&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDEqwkoBnoECEQQAQ&ictx=0"
      }
    ],
    "organic": [
      {
        "link": "https://www.reddit.com/r/Pizza/comments/1rbx2ud/day_97_of_making_pizza_every_day/",
        "source": "Reddit · r/Pizza",
        "display_link": "90+ comments · 2 days ago",
        "title": "Day 97 of making pizza every day. : r/Pizza",
        "description": "The home of pizza on reddit. An educational community devoted to the art of pizza making. 173K Weekly visitors 4.6K ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "0:40",
        "duration_sec": 40,
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "10.3K+ views · 3 days ago",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "We got frozen bases and we made this lovely pizza in 5 minutes and a home oven. It's soft it's crunchy it's lovely.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://deweyspizza.com/",
        "source": "Dewey's Pizza",
        "display_link": "https://deweyspizza.com",
        "title": "Dewey's Pizza: Home",
        "description": "Bobby Boucher. Cajun Red Sauce, Mozzarella, Caramelized Red Onions, Diced Green Bell Peppers, Andouille Sausage, Blackened Chicken, Celery, Cajun Seasoning, and ...Read more",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.instagram.com/reel/DVJmnFYke-i/",
        "source": "Instagram · calebwsimpson",
        "display_link": "54K+ likes · 1 hour ago",
        "title": "Pizza Review #39 @iansomerhalder",
        "description": "And favorite pizza in New York? I'm going to happier grocery. It is ridiculous. Oh yeah? Could I buy you a slice right now?",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "2:04",
        "duration_sec": 124,
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.reddit.com/r/Costco/comments/1rdzzri/costco_where_to_find_most_perfect_slice_of_cheap/",
        "source": "Reddit · r/Costco",
        "display_link": "230+ comments · 6 hours ago",
        "title": "Costco: Where to find most perfect slice of cheap cheese ...",
        "description": "$1.99 slice of Costco pepperoni pizza is my go-to guilty pleasure lunch. Usually shared with my kids.Read more",
        "snippet_highlighted_words": [
          "Costco pepperoni pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "link": "https://businessinthornton.com/best-of/pizza-restaurants/",
        "source": "businessinthornton.com",
        "display_link": "https://businessinthornton.com › Best of Thornton",
        "title": "Where to get good pizza in Thornton",
        "description": "Whether you're looking for NY-style pizza to go, personalized pan pizzas or specialty pizza with a beer in a pub setting, Thornton has enough variety to let ...Read more",
        "snippet_highlighted_words": [
          "NY-style pizza to go, personalized pan pizzas or specialty pizza with a beer in a pub setting"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "Nov 19, 2019",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "link": "https://pizzaluce.com/",
        "source": "Pizza Luce",
        "display_link": "https://pizzaluce.com",
        "title": "Pizza Luce: Minnesota's Best Pizza",
        "description": "Handmade gourmet pizza made from fresh ingredients. Vegan, Vegetarian and Gluten Free options. Free Pizza luce delivery, curbside pickup and online ordering ...",
        "snippet_highlighted_words": [
          "Handmade gourmet pizza made from fresh ingredients"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "link": "https://professorpizza.com/",
        "source": "Professor Pizza",
        "display_link": "https://professorpizza.com",
        "title": "Professor Pizza | Chicago's Award Winning Pizza",
        "description": "Professor Pizza brings authentic, chef-crafted Chicago Pizza to life with bold flavors, creative toppings, and classic styles you'll love.",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "link": "https://pizzarocklasvegas.com/",
        "source": "Pizza Rock Las Vegas",
        "display_link": "https://pizzarocklasvegas.com",
        "title": "Pizza Rock Las Vegas – Gourmet pizzas, hand-crafted artisan ...",
        "description": "Pizza Rock Las Vegas restaurant pairs delicious gourmet pizzas with specialty cocktails from our full-service bar, and an extensive beer & wine menu to ...",
        "snippet_highlighted_words": [
          "Pizza Rock Las Vegas restaurant"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "rank": 9,
        "global_rank": 9
      }
    ],
    "images": [
      {
        "original_image": "https://cdn.jwplayer.com/v2/media/1znN8BBx/thumbnails/WmRQ08C1.jpg?width=1280",
        "link": "https://www.allrecipes.com/recipe/20171/quick-and-easy-pizza-crust/",
        "title": "Easy Homemade Pizza Dough",
        "source": "Allrecipes",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAA...",
        "recipe": {
          "rating": 4.7,
          "reviews_cnt": 4141,
          "title": "Easy Homemade Pizza Dough",
          "ingredients": [
            "1 cup warm water (110 degrees F/45 degrees C)",
            "1 (.25 ounce) package active dry yeast",
            "1 teaspoon white sugar",
            "2.5 cups bread flour",
            "2 tablespoons olive oil"
          ],
          "summary": "An easy pizza crust recipe that will hold all your favorite toppings is  simple to make with basic ...",
          "duration": "45 min",
          "duration_sec": 2700,
          "volume": "8"
        },
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Easy Homemade Pizza Dough",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 10
      },
      {
        "original_image": "https://www.recipetineats.com/tachyon/2023/05/Garlic-cheese-pizza_9.jpg",
        "link": "https://www.recipetineats.com/garlic-cheese-pizza/",
        "title": "Garlic cheese pizza",
        "source": "RecipeTin Eats",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAA...",
        "recipe": {
          "rating": 5,
          "reviews_cnt": 10,
          "title": "Garlic cheese pizza",
          "ingredients": [
            "1 classic pizza dough ((wood-fired Italian style))",
            "1 fast no-yeast pizza dough ((this is excellent!))",
            "1 Store bought",
            "2 tbsp extra virgin olive oil",
            "2 tsp garlic ((2 - 3 large cloves), crushed using garlic press or make  paste using side of knife - Note 2))"
          ],
          "summary": "Recipe video above. No visit to your favourite pizzeria start without  garlic cheese pizza! My best ...",
          "duration": "18 min",
          "duration_sec": 1080,
          "volume": "1"
        },
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Garlic cheese pizza",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 11
      },
      {
        "original_image": "https://i1.wp.com/colorfulrecipes.com/wp-content/uploads/2020/08/best-pepperoni-pizza-recipe-10.jpg?fit=1200%2C1800&ssl=1",
        "link": "https://colorfulrecipes.com/classic-pepperoni-pizza-recipe/",
        "title": "Classic Pepperoni Pizza Recipe",
        "source": "Colorful Recipes",
        "source_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "recipe": {
          "title": "Classic Pepperoni Pizza Recipe",
          "ingredients": [
            "Pizza dough",
            "Pizza sauce, 1/2 cup",
            "Mozzarella cheese, 2/3 cup",
            "Dried basil, 1 tsp",
            "Dried oregano, 1 tsp"
          ],
          "summary": "We made this classic pepperoni pizza recipe for the first time a couple of  days ago. Everyone loved ...",
          "duration": "19 min",
          "duration_sec": 1140,
          "volume": "8"
        },
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "Classic Pepperoni Pizza Recipe",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 12
      }
    ],
    "pagination": {
      "pages": [
        {
          "page": 1,
          "start": 0,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=0&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAQ"
        },
        {
          "page": 2,
          "start": 10,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=10&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAY"
        },
        {
          "page": 4,
          "start": 30,
          "link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=30&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAk"
        }
      ],
      "current_page": 3,
      "next_page": 4,
      "next_page_start": 30,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&ei=KrieaYrdEcXMp84P0cSbyQw&start=30&sa=N&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDy0wN6BAgMEAk"
    },
    "related": [
      {
        "text": "Pizza Hut near me",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+near+me&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDEQAQ",
        "rank": 1,
        "global_rank": 13
      },
      {
        "text": "Pizza Hut menu",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Hut+menu&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDYQAQ",
        "rank": 2,
        "global_rank": 14
      },
      {
        "text": "Pizza definition",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+definition&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDUQAQ",
        "rank": 3,
        "global_rank": 15
      },
      {
        "text": "Pizza open",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+open&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDAQAQ",
        "rank": 4,
        "global_rank": 16
      },
      {
        "text": "Pizza Boys",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Boys&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDQQAQ",
        "rank": 5,
        "global_rank": 17
      },
      {
        "text": "Pizza delivery",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+delivery&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDIQAQ",
        "rank": 6,
        "global_rank": 18
      },
      {
        "text": "Pizza Papa Johns",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Papa+Johns&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECDMQAQ",
        "rank": 7,
        "global_rank": 19
      },
      {
        "text": "Pizza Marco's",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=Pizza+Marco%27s&sa=X&ved=2ahUKEwiKmo3tofSSAxVF5skDHVHiJsk4FBDVAnoECC8QAQ",
        "rank": 8,
        "global_rank": 20
      }
    ],
    "oragnic": [
      {
        "link": "https://www.reddit.com/r/Pizza/comments/1rbx2ud/day_97_of_making_pizza_every_day/",
        "source": "Reddit · r/Pizza",
        "display_link": "90+ comments · 2 days ago",
        "title": "Day 97 of making pizza every day. : r/Pizza",
        "description": "The home of pizza on reddit. An educational community devoted to the art of pizza making. 173K Weekly visitors 4.6K ...",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "0:40",
        "duration_sec": 40,
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "YouTube · Vito Iacopelli",
        "display_link": "10.3K+ views · 3 days ago",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "We got frozen bases and we made this lovely pizza in 5 minutes and a home oven. It's soft it's crunchy it's lovely.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://deweyspizza.com/",
        "source": "Dewey's Pizza",
        "display_link": "https://deweyspizza.com",
        "title": "Dewey's Pizza: Home",
        "description": "Bobby Boucher. Cajun Red Sauce, Mozzarella, Caramelized Red Onions, Diced Green Bell Peppers, Andouille Sausage, Blackened Chicken, Celery, Cajun Seasoning, and ...Read more",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 3,
        "global_rank": 3
      }
    ]
  }
  ```
</ResponseExample>


# Google Search parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-search/parsed-json

Configure the Bright Data Google Search Google Search parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/search?q=pizza&brd_json=json
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://www.google.com/search?q=pizza&brd_json=json
  ```

  | value | description |
  | - | - |
  | `html` (default) | Returns the standard HTML response from Google Maps. |
  | `json` | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&brd_json=json",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&brd_json=json"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&brd_json=json',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&brd_json=json',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={4} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 973000000,
      "search_time": 0.46,
      "language": "en-FR",
      "country": "France",
      "country_code": "FR",
      "location": "United States",
      "gl": "FR",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-24T20:05:07.171Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHxAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIGhAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIGBAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIFxAB"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIFhAB"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=016f34706b28a015&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIexAB"
      }
    ],
    "organic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.pizzahut.fr/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.fr",
        "title": "Pizza Hut Livraison, vente à emporter | Commande en ligne ...",
        "description": "Pizza Hut Livraison, vente à emporter | Commande en ligne | Coupons, Promos.",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzeria"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 5,
        "global_rank": 9
      },
      {
        "link": "https://www.galbani.fr/recettes/pizza",
        "source": "Galbani",
        "display_link": "https://www.galbani.fr › recettes",
        "title": "Recettes de Pizza à l'italienne et revisitées",
        "description": "Choisissez parmi nos nombreuses recettes de pizza vos préférées et savourez en famille ou entre amis de délicieux plat à l'italienne. Simple, rapide et bon ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 10
      },
      {
        "link": "https://www.pizzapapa.fr/blog/origine-pizza/",
        "source": "pizzapapa.fr",
        "display_link": "https://www.pizzapapa.fr › blog",
        "title": "Qui a inventé la pizza ? Histoire & origine de la pizza",
        "description": "Actuellement, la pizza est une recette emblématique de la cuisine italienne qui s'est internationalisée avec l'immigration.Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "26 Sept 2025",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 7,
        "global_rank": 11
      },
      {
        "link": "https://lacuisinedannie.20minutes.fr/recette-pate-a-pizza-234.html",
        "source": "La Cuisine d'Annie",
        "display_link": "https://lacuisinedannie.20minutes.fr › ...",
        "title": "Recette Pâte à pizza",
        "description": "Recette Pâte à pizza. Recette de Pains et pâtes de base, Pâtes de base pour 6 personnes. Le temps de préparation est de 15 min. La Cuisine d'Annie regroupe ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 381,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 12
      },
      {
        "link": "https://www.picard.fr/rayons/pizzas-et-tartes/pizzas",
        "source": "Picard",
        "display_link": "https://www.picard.fr › rayons › p...",
        "title": "Livraison de Pizzas surgelées à domicile",
        "description": "Découvrez toutes nos pizzas surgelées Picard : les pizzas traditionnelles, bio ou végétariennes sont disponibles dans tous les magasins Picard, ...",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 13
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Pizza maison à la friteuse à air – Parfaitement ...",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Tomato and Mozzarella Pizza Recipe",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQmxN6BAgQEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "266 Calories",
        "portion": "100 grams"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": [
      {
        "page": 2,
        "start": 10,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=10&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAE"
      },
      {
        "page": 3,
        "start": 20,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=20&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAG"
      },
      {
        "page": 4,
        "start": 30,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=30&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAI"
      }
    ],
    "related": [
      {
        "text": "Pizza recette",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+recette&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhLEAE",
        "rank": 1,
        "global_rank": 14
      },
      {
        "text": "Pizza Hut",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Hut&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhhEAE",
        "rank": 2,
        "global_rank": 15
      },
      {
        "text": "Pizza Yolo",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Yolo&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhgEAE",
        "rank": 3,
        "global_rank": 16
      }
    ],
    "people_also_ask": [
      {
        "question": "Quel ingrédient mettre sur une pizza ?",
        "question_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "question_type": "featured",
        "answer_source": "JeSuisGastronome.fr",
        "answer_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "answer_display_link": "https://www.jesuisgastronome.fr › actu › la-liste-des-quin...https://www.jesuisgastronome.fr › actu › la-liste-des-quin...",
        "answers": [
          {
            "type": "unordered_list",
            "title": "La liste des quinze meilleurs ingrédients pour une pizza",
            "items": [
              {
                "value": "- Le mozzarella fondant.",
                "rank": 1
              },
              {
                "value": "- La fraîcheur du basilic.",
                "rank": 2
              },
              {
                "value": "- L'authentique jambon de Parme.",
                "rank": 3
              },
              {
                "value": "- Le piquant des olives noires.",
                "rank": 4
              },
              {
                "value": "- Apprécier l'anchois salé",
                "rank": 5
              },
              {
                "value": "- Déguster les champignons frais.",
                "rank": 6
              },
              {
                "value": "- Aimer la roquette croquante.",
                "rank": 7
              },
              {
                "value": "- Savourer le saucisson épicé",
                "rank": 8
              }
            ],
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 5
      }
    ],
    "oragnic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      }
    ]
  }
  ```
</ResponseExample>


# Search by image
Source: https://docs.brightdata.com/api-reference/serp/google-search/search-by-image

Configure the Bright Data Google Search Search by Image parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1
```

## Parameters

<ParamField type="string">
  The URL of the image to use for the reverse image search.

  ```txt wrap theme={null}
  https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg
  ```
</ParamField>

<ParamField type="string">
  Download image on the proxy side and post it to google using POST request

  > **Default behavior:** download-and-post if google isn't able to download the image

  | Value | Description |
  | - | - |
  | `download=1` | Force download-and-post image |
  | `download=0` | Use regular GET request with image URL |

  ```txt wrap theme={null}
  https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>


# Shopping search
Source: https://docs.brightdata.com/api-reference/serp/google-search/shopping

Configure the Bright Data Google Search Shopping Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=shop
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For Shopping search, set `tbm` value to `shop`.

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=shop
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=shop",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=shop"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=shop',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=shop',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={9} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "shopping",
      "page_title": "pizza - Google Shopping",
      "timestamp": "2026-02-24T20:34:04.313Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=shop&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Nearby",
        "href": "https://www.google.com/search?q=pizza+nearby&gl=US&hl=en&udm=28&shoprs=CAEYAyoFcGl6emEyDAgDEgZOZWFyYnkYAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEAQ"
      },
      {
        "title": "On sale",
        "href": "https://www.google.com/search?q=pizza+sale&gl=US&hl=en&udm=28&shoprs=CAESBEoCGAEYBioFcGl6emEyEwgGEgdPbiBzYWxlGAIiBEoCGAFYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEAU"
      },
      {
        "title": "Get it fast",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESDZoBCgoIEAM4AUAFSAEYFCoFcGl6emEyJAgUEgtHZXQgaXQgZmFzdCINmgEKCggQAzgBQAVIASoEEAEYAWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEAY"
      },
      {
        "title": "Small business",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESAmoAGBYqBXBpenphMhwIFhIOU21hbGwgYnVzaW5lc3MiAmoAKgQQARgBYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEAc"
      },
      {
        "title": "Bread & Pastry Dough",
        "href": "https://www.google.com/search?q=bread+%26+pastry+dough+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyGAgJEhRCcmVhZCAmIFBhc3RyeSBEb3VnaGAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEAs"
      },
      {
        "title": "Pizza Sauce",
        "href": "https://www.google.com/search?q=pizza+sauce+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyDwgJEgtQaXp6YSBTYXVjZWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEAw"
      },
      {
        "title": "Cheese",
        "href": "https://www.google.com/search?q=cheese+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyCggJEgZDaGVlc2VgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEA0"
      },
      {
        "title": "Pizza Pans & Stones",
        "href": "https://www.google.com/search?q=pizza+pans+%26+stones+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFwgJEhNQaXp6YSBQYW5zICYgU3RvbmVzYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEA4"
      },
      {
        "title": "Pizza Crust Mixes",
        "href": "https://www.google.com/search?q=pizza+crust+mixes+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFQgJEhFQaXp6YSBDcnVzdCBNaXhlc2AC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAR6BAgXEA8"
      },
      {
        "title": "4 and up",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESBWIDCJADGB4qBXBpenphMhUIHhIINCBhbmQgdXAiBWIDCJADQARgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEBM"
      },
      {
        "title": "Chicken",
        "href": "https://www.google.com/search?q=chicken+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdDaGlja2VuOgwImM-mAhCaz6YCMAJYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEBg"
      },
      {
        "title": "Turkey",
        "href": "https://www.google.com/search?q=turkey+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZUdXJrZXk6DAiYz6YCEJ_PpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEBk"
      },
      {
        "title": "Fish",
        "href": "https://www.google.com/search?q=fish+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFggBEgRGaXNoOgwImM-mAhCbz6YCMAJYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEBo"
      },
      {
        "title": "Vegetable Protein",
        "href": "https://www.google.com/search?q=vegetable+protein+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyIwgBEhFWZWdldGFibGUgUHJvdGVpbjoMCJjPpgIQoM-mAjACWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEBs"
      },
      {
        "title": "Walmart",
        "href": "https://www.google.com/search?q=walmart+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyCwgCEgdXYWxtYXJ0WLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEB8"
      },
      {
        "title": "Target",
        "href": "https://www.google.com/search?q=target+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyCggCEgZUYXJnZXRYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXECA"
      },
      {
        "title": "Home Depot",
        "href": "https://www.google.com/search?q=home+depot+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyDggCEgpIb21lIERlcG90WLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXECE"
      },
      {
        "title": "Food Depot",
        "href": "https://www.google.com/search?q=food+depot+pizza&gl=US&hl=en&udm=28&shoprs=CAEYAioFcGl6emEyDggCEgpGb29kIERlcG90WLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXECI"
      },
      {
        "title": "Under $5",
        "href": "https://www.google.com/search?q=pizza+under+$5&gl=US&hl=en&udm=28&shoprs=CAESDRILEQAAAADQElNBGAEYBSoFcGl6emEyIQgFEghVbmRlciAkNRgCIg0SCxEAAAAA0BJTQRgBKgIYAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXECg"
      },
      {
        "title": "$5 - $9",
        "href": "https://www.google.com/search?q=pizza+between+$5+and+$9&gl=US&hl=en&udm=28&shoprs=CAESFhIUCQAAAADQElNBEQAAAACIKmFBGAEYBSoFcGl6emEyKQgFEgckNSAtICQ5GAIiFhIUCQAAAADQElNBEQAAAACIKmFBGAEqAhgBWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXECk"
      },
      {
        "title": "$9 - $20",
        "href": "https://www.google.com/search?q=pizza+between+$9+and+$20&gl=US&hl=en&udm=28&shoprs=CAESFhIUCQAAAACIKmFBEQAAAADQEnNBGAEYBSoFcGl6emEyKggFEggkOSAtICQyMBgCIhYSFAkAAAAAiCphQREAAAAA0BJzQRgBKgIYAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXECo"
      },
      {
        "title": "Over $20",
        "href": "https://www.google.com/search?q=pizza+over+$20&gl=US&hl=en&udm=28&shoprs=CAESDRILCQAAAADQEnNBGAEYBSoFcGl6emEyIQgFEghPdmVyICQyMBgCIg0SCwkAAAAA0BJzQRgBKgIYAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXECs"
      },
      {
        "title": "Lunch",
        "href": "https://www.google.com/search?q=lunch+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVMdW5jaDoMCI3PpgIQj8-mAjACWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEDI"
      },
      {
        "title": "Breakfast",
        "href": "https://www.google.com/search?q=breakfast+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglCcmVha2Zhc3Q6DAiNz6YCEI7PpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEDM"
      },
      {
        "title": "Entree",
        "href": "https://www.google.com/search?q=entree+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZFbnRyZWU6DAiJz6YCEIvPpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEDc"
      },
      {
        "title": "Appetizer",
        "href": "https://www.google.com/search?q=appetizer+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglBcHBldGl6ZXI6DAiJz6YCEIrPpgIwAli7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEDg"
      },
      {
        "title": "Kosher",
        "href": "https://www.google.com/search?q=kosher+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZLb3NoZXI6DAjx34cBEPLfhwEwA1i7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEDw"
      },
      {
        "title": "Organic",
        "href": "https://www.google.com/search?q=organic+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdPcmdhbmljOgwIvvmHARC_-YcBMANYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXED0"
      },
      {
        "title": "Low Carb",
        "href": "https://www.google.com/search?q=low+carb+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGggBEghMb3cgQ2FyYjoMCLr4hwEQu_iHATADWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXED4"
      },
      {
        "title": "Pasta",
        "href": "https://www.google.com/search?q=pasta+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVQYXN0YToMCPWzxAIQ9rPEAjAAWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEEI"
      },
      {
        "title": "Rice",
        "href": "https://www.google.com/search?q=rice+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFggBEgRSaWNlOgwI9bPEAhDrrMYCMABYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEEM"
      },
      {
        "title": "Free shipping",
        "href": "https://www.google.com/search?q=pizza+free+shipping&gl=US&hl=en&udm=28&shoprs=CAESBFICEAEYGSoFcGl6emEyFwgZEg1GcmVlIHNoaXBwaW5nIgRSAhABYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEEc"
      },
      {
        "title": "DiGiorno",
        "href": "https://www.google.com/search?q=digiorno+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEghEaUdpb3JubzoKCIPzPBDS5UgwAVi7miFgAg&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAB6BAgXEEs"
      },
      {
        "title": "Red Baron",
        "href": "https://www.google.com/search?q=red+baron+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEglSZWQgQmFyb246CgiD8zwQ1uJIMAFYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAF6BAgXEEw"
      },
      {
        "title": "Jack's",
        "href": "https://www.google.com/search?q=jack's+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgZKYWNrJ3M6CwiD8zwQmp6YAjABWLuaIWAC&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAJ6BAgXEE0"
      },
      {
        "title": "TombStone",
        "href": "https://www.google.com/search?q=tombstone+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEglUb21iU3RvbmU6CgiD8zwQ0eZIMAFYu5ohYAI&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQ268JKAN6BAgXEE4"
      },
      {
        "title": "Nearby",
        "href": "https://www.google.com/search?q=pizza+nearby&gl=US&hl=en&udm=28&shoprs=CAEYAyoFcGl6emEyDAgDEgZOZWFyYnkYAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAJ6BAgXEFc"
      },
      {
        "title": "Bread & Pastry Dough",
        "href": "https://www.google.com/search?q=bread+%26+pastry+dough+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyGAgJEhRCcmVhZCAmIFBhc3RyeSBEb3VnaGAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAR6BAgXEFk"
      },
      {
        "title": "School",
        "href": "https://www.google.com/search?q=school+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCggSEgZTY2hvb2xgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAZ6BAgXEFs"
      },
      {
        "title": "Chicken",
        "href": "https://www.google.com/search?q=chicken+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdDaGlja2VuOgwImM-mAhCaz6YCMAJYu5ohYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAh6BAgXEF0"
      },
      {
        "title": "On sale",
        "href": "https://www.google.com/search?q=pizza+sale&gl=US&hl=en&udm=28&shoprs=CAESBEoCGAEYBioFcGl6emEyEwgGEgdPbiBzYWxlGAIiBEoCGAFYu5ohYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAp6BAgXEF8"
      },
      {
        "title": "Pizza Sauce",
        "href": "https://www.google.com/search?q=pizza+sauce+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyDwgJEgtQaXp6YSBTYXVjZWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKAx6BAgXEGE"
      },
      {
        "title": "Get it fast",
        "href": "https://www.google.com/search?q=pizza&gl=US&hl=en&udm=28&shoprs=CAESDZoBCgoIEAM4AUAFSAEYFCoFcGl6emEyJAgUEgtHZXQgaXQgZmFzdCINmgEKCggQAzgBQAVIASoEEAEYAWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKA56BAgXEGM"
      },
      {
        "title": "Cheese",
        "href": "https://www.google.com/search?q=cheese+pizza&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyCggJEgZDaGVlc2VgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBB6BAgXEGU"
      },
      {
        "title": "Frozen",
        "href": "https://www.google.com/search?q=frozen+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCggSEgZGcm96ZW5gAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBR6BAgXEGo"
      },
      {
        "title": "Under $5",
        "href": "https://www.google.com/search?q=pizza+under+$5&gl=US&hl=en&udm=28&shoprs=CAESDRILEQAAAADQElNBGAEYBSoFcGl6emEyIQgFEghVbmRlciAkNRgCIg0SCxEAAAAA0BJTQRgBKgIYAVi7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBZ6BAgXEGw"
      },
      {
        "title": "Pizza Crust",
        "href": "https://www.google.com/search?q=pizza+crust+&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEgtQaXp6YSBDcnVzdDoKCIXhORCM4TkwAFi7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBh6BAgXEG4"
      },
      {
        "title": "Pizza Pans & Stones",
        "href": "https://www.google.com/search?q=pizza+pans+%26+stones+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFwgJEhNQaXp6YSBQYW5zICYgU3RvbmVzYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBp6BAgXEHA"
      },
      {
        "title": "Lunch",
        "href": "https://www.google.com/search?q=lunch+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVMdW5jaDoMCI3PpgIQj8-mAjACWLuaIWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKBx6BAgXEHI"
      },
      {
        "title": "Entree",
        "href": "https://www.google.com/search?q=entree+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZFbnRyZWU6DAiJz6YCEIvPpgIwAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKB56BAgXEHQ"
      },
      {
        "title": "Pizza Crust Mixes",
        "href": "https://www.google.com/search?q=pizza+crust+mixes+&gl=US&hl=en&udm=28&shoprs=CAEYCSoFcGl6emEyFQgJEhFQaXp6YSBDcnVzdCBNaXhlc2AB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCJ6BAgXEHk"
      },
      {
        "title": "Small",
        "href": "https://www.google.com/search?q=small+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCQgSEgVTbWFsbGAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCR6BAgXEHs"
      },
      {
        "title": "Large",
        "href": "https://www.google.com/search?q=large+pizza&gl=US&hl=en&udm=28&shoprs=CAEYEioFcGl6emEyCQgSEgVMYXJnZWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCZ6BAgXEH0"
      },
      {
        "title": "Breakfast",
        "href": "https://www.google.com/search?q=breakfast+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglCcmVha2Zhc3Q6DAiNz6YCEI7PpgIwAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCh6BAgXEH8"
      },
      {
        "title": "Fresh",
        "href": "https://www.google.com/search?q=fresh+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVGcmVzaDoMCNCTiAEQ0ZOIATACWLuaIWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKCx6BQgXEIQB"
      },
      {
        "title": "Kosher",
        "href": "https://www.google.com/search?q=kosher+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGAgBEgZLb3NoZXI6DAjx34cBEPLfhwEwA1i7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKC56BQgXEIYB"
      },
      {
        "title": "Pasta",
        "href": "https://www.google.com/search?q=pasta+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyFwgBEgVQYXN0YToMCPWzxAIQ9rPEAjAAWLuaIWAB&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKDB6BQgXEIgB"
      },
      {
        "title": "Appetizer",
        "href": "https://www.google.com/search?q=appetizer+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGwgBEglBcHBldGl6ZXI6DAiJz6YCEIrPpgIwAli7miFgAQ&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKDJ6BQgXEIoB"
      },
      {
        "title": "Organic",
        "href": "https://www.google.com/search?q=organic+pizza&gl=US&hl=en&udm=28&shoprs=CAEYASoFcGl6emEyGQgBEgdPcmdhbmljOgwIvvmHARC_-YcBMANYu5ohYAE&sa=X&ved=2ahUKEwjF6IXp_PKSAxU6GLkGHan3NQgQip4GKDR6BQgXEIwB"
      }
    ],
    "shopping": [
      {
        "title": "Red Baron Classic Crust Pepperoni Pizza",
        "price": "$6.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "walgreens.com",
        "rating": 4.5,
        "reviews_cnt": 2100,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Screamin' Sicilian Supremus Maximus Supreme Pizza",
        "price": "$5.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Giant Food",
        "shipping": "Free delivery by Sat",
        "rating": 4.4,
        "reviews_cnt": 548,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "DiGiorno Original Rising Crust Pizza",
        "price": "$7.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "CVS Pharmacy",
        "shipping": "Free delivery on $35+",
        "rating": 4.4,
        "reviews_cnt": 9800,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "Giordano's Stuffed Chicago Deep Dish Frozen Pizza 10",
        "price": "$84.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Walmart - Giordanos",
        "shipping": "Free delivery",
        "rating": 1,
        "reviews_cnt": 3,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Jack's Original Thin Crust Pepperoni Pizza",
        "price": "$3.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "walgreens.com",
        "rating": 4.3,
        "reviews_cnt": 3400,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Totino's Party Pepperoni Pizza",
        "price": "$2.14",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Food Depot",
        "rating": 4.4,
        "reviews_cnt": 5700,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Red Baron Pepperoni Deep Dish Personal Pizza",
        "price": "$42.99",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "WebstaurantStore.com",
        "rating": 4.6,
        "reviews_cnt": 1400,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "Red Baron Deep Dish Pepperoni Pizza",
        "price": "$4.29",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "shop": "Busch's Fresh Food Market",
        "rating": 4.3,
        "reviews_cnt": 1000,
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Capone Foods Pepperino Pizza",
        "price": "$8.95",
        "shop_logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn%3AANd9GcRDy4dgbuTUCJn7ipuj_V6Dxf3kw1R4G9oH29ofpdUzcdMld70VNTNuTPBV8ifFe8Wo1B-xiXMT8nCw1lqGZJRSEkjm-ONXbVg",
        "shop": "Capone Foods",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Tombstone Original Crust Pizza",
        "price": "$2.00",
        "shop_logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAA...",
        "shop": "Food Rite",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      }
    ],
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=62b03b7345eac9c6&gl=US&hl=en&udm=28&prmd=ivnsmb&ei=HQueaYXmOLqw5OUPqe_XQQ&start=10&sa=N"
    }
  }
  ```
</ResponseExample>


# Short videos
Source: https://docs.brightdata.com/api-reference/serp/google-search/short-videos

Configure the Bright Data Google Search Short Videos parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&udm=39
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  For searching short videos, use `udm=39` to get results.

  ```http theme={null}
  https://www.google.com/search?q=pizza&udm=39
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&udm=39",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&udm=39"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&udm=39',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&udm=39',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 142000000,
      "search_time": 0.26,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "short_videos",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:40:29.129Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&udm=39&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "AI Mode",
        "href": "https://www.google.com/search?q=pizza&num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=50&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&aep=1&ntc=1&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQ2J8OegQIERAD"
      },
      {
        "title": "All",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQ0pQJegQIFxAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQtKgLegQIGxAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQ0pQJegQIGRAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQtKgLegQIHRAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQs6gLegQIHxAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjS7Nmjn_SSAxUyQ_EDHVIbGwEQs6gLegQIHhAB"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?num=12&sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&ved=1t:200715&ictx=111"
      }
    ],
    "short_videos": [
      {
        "link": "https://www.youtube.com/shorts/kuqbckh8dxo",
        "title": "PIZZA RECIPE WITH BIGA🍕🔥 #pizza #adv",
        "source": "YouTube · Malati di Pizza",
        "duration": "2:26",
        "duration_sec": 146,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/shorts/cpW38_oZG3Q",
        "title": "Taco Bell Mexican Pizza Hack",
        "source": "YouTube · Allrecipes",
        "duration": "0:41",
        "duration_sec": 41,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.instagram.com/reel/DVKP3BMDUjt/",
        "title": "Rita🍝 | Let’s make pizza with potatoes and rosemary!",
        "source": "Instagram · Rita🍝",
        "duration": "2:57",
        "duration_sec": 177,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.facebook.com/chefjackiebakula/videos/i-first-had-chicken-parm-pizza-qualityitalian-in-nyc-it-was-fantastic-i-learned-/851228973898172/",
        "title": "I first had chicken parm pizza @qualityitalian in NYC. It was ...",
        "source": "Facebook · Jackie Bakula",
        "duration": "1:20",
        "duration_sec": 80,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.youtube.com/shorts/-A7SldGQ6vU",
        "title": "Trader Joe's NY Style Pizza",
        "source": "YouTube · Dough Guy",
        "duration": "1:30",
        "duration_sec": 90,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "link": "https://www.tiktok.com/@williamhansonetiquette/video/7601586210062093590",
        "title": "The Joy of Eating Pizza Without Utensils",
        "source": "TikTok · williamhansonetiquette",
        "duration": "0:14",
        "duration_sec": 14,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "link": "https://www.instagram.com/reel/DVHjUeNkfXT/",
        "title": "Roasted Garlic Butter Pizza Bread",
        "source": "Instagram · Sam Schnur",
        "duration": "0:36",
        "duration_sec": 36,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "link": "https://www.youtube.com/shorts/0y8KHv40K9s",
        "title": "Nothing Beats Nonna's Homemade Pizza!",
        "source": "YouTube · The Spicy Nonna",
        "duration": "2:43",
        "duration_sec": 163,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "link": "https://www.youtube.com/shorts/xTj8l8Vi7rg",
        "title": "Rating and Ranking Thin and Crispy Frozen Pizzas #Pizza ...",
        "source": "YouTube · Diff Family Reviews",
        "duration": "2:28",
        "duration_sec": 148,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "link": "https://www.youtube.com/shorts/F7MK8uqFVF8",
        "title": "NYCS BEST PIZZA",
        "source": "YouTube · CALEB SIMPSON",
        "duration": "2:05",
        "duration_sec": 125,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "link": "https://www.youtube.com/shorts/bndZw1mXa7w",
        "title": "The Best New York Style Pizza at Home",
        "source": "YouTube · Dylan Nobert",
        "duration": "0:45",
        "duration_sec": 45,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "link": "https://www.youtube.com/shorts/CCawQUAJ-6Y",
        "title": "The Best Detroit Pizza is in NYC?!",
        "source": "YouTube · Jeremy Jacobowitz",
        "duration": "1:35",
        "duration_sec": 95,
        "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 12,
        "global_rank": 12
      }
    ],
    "pagination": {
      "next_page_start": 12,
      "next_page_link": "https://www.google.com/search?q=pizza&num=12&sca_esv=206cd4dd954885db&udm=39&gl=US&hl=en&ei=d7WeaZLVHbKGxc8P0rbsCA&start=12&sa=N"
    }
  }
  ```
</ResponseExample>


# Google Search text search
Source: https://docs.brightdata.com/api-reference/serp/google-search/text-search

Configure the Bright Data Google Search Google Search text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```Example theme={null}
https://www.google.com/search?q=pizza
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```Example theme={null}
  https://www.google.com/search?q=pizza
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={4} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 973000000,
      "search_time": 0.46,
      "language": "en-FR",
      "country": "France",
      "country_code": "FR",
      "location": "United States",
      "gl": "FR",
      "mobile": false,
      "basic_view": false,
      "search_type": "text",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-24T20:05:07.171Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHxAB"
      },
      {
        "title": "Videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=7&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQtKgLegQIHhAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIGhAB"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIGBAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&q=pizza&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQs6gLegQIFxAB"
      },
      {
        "title": "Books",
        "href": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=pizza&udm=36&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIFhAB"
      },
      {
        "title": "Finance",
        "href": "https://www.google.com/finance?sca_esv=016f34706b28a015&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpaEWjvZ2Py1XXV8d8KvlI3vWUtYx0DZdicpfE1faGYenqWn-q4MFiFFtvJjTKeAVxZj_-zzAfU38gMel7zJW-zoNwHG-ArsO6TrTEJcFsob0pdGO2ABo8o_HC5yJWwFB_-GDw4ME9hn952oqoD4-m1e6t3rE&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ0pQJegQIexAB"
      }
    ],
    "organic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.pizzahut.fr/",
        "source": "Pizza Hut",
        "display_link": "https://www.pizzahut.fr",
        "title": "Pizza Hut Livraison, vente à emporter | Commande en ligne ...",
        "description": "Pizza Hut Livraison, vente à emporter | Commande en ligne | Coupons, Promos.",
        "snippet_highlighted_words": [
          "Pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.dominos.fr/",
        "source": "Domino's Pizza",
        "display_link": "https://www.dominos.fr",
        "title": "Domino's Pizza, livraison et à emporter, commande en ligne",
        "description": "Commandez vos pizzas en ligne en livraison ou à emporter dans votre pizzeria Domino's la plus proche et dégustez-les en famille ou avec vos amis.",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzeria"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "image_alt": "pizza from www.dominos.fr",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCf5qNZRvb7AOasK4bkZVf43P-y-6lDa_eBaxgXGw3BuqKmU5ictBb&usqp=CAE&s",
        "rank": 5,
        "global_rank": 9
      },
      {
        "link": "https://www.galbani.fr/recettes/pizza",
        "source": "Galbani",
        "display_link": "https://www.galbani.fr › recettes",
        "title": "Recettes de Pizza à l'italienne et revisitées",
        "description": "Choisissez parmi nos nombreuses recettes de pizza vos préférées et savourez en famille ou entre amis de délicieux plat à l'italienne. Simple, rapide et bon ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 6,
        "global_rank": 10
      },
      {
        "link": "https://www.pizzapapa.fr/blog/origine-pizza/",
        "source": "pizzapapa.fr",
        "display_link": "https://www.pizzapapa.fr › blog",
        "title": "Qui a inventé la pizza ? Histoire & origine de la pizza",
        "description": "Actuellement, la pizza est une recette emblématique de la cuisine italienne qui s'est internationalisée avec l'immigration.Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "26 Sept 2025",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "rank": 7,
        "global_rank": 11
      },
      {
        "link": "https://lacuisinedannie.20minutes.fr/recette-pate-a-pizza-234.html",
        "source": "La Cuisine d'Annie",
        "display_link": "https://lacuisinedannie.20minutes.fr › ...",
        "title": "Recette Pâte à pizza",
        "description": "Recette Pâte à pizza. Recette de Pains et pâtes de base, Pâtes de base pour 6 personnes. Le temps de préparation est de 15 min. La Cuisine d'Annie regroupe ...",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 381,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 8,
        "global_rank": 12
      },
      {
        "link": "https://www.picard.fr/rayons/pizzas-et-tartes/pizzas",
        "source": "Picard",
        "display_link": "https://www.picard.fr › rayons › p...",
        "title": "Livraison de Pizzas surgelées à domicile",
        "description": "Découvrez toutes nos pizzas surgelées Picard : les pizzas traditionnelles, bio ou végétariennes sont disponibles dans tous les magasins Picard, ...",
        "snippet_highlighted_words": [
          "pizzas",
          "pizzas"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 9,
        "global_rank": 13
      }
    ],
    "knowledge": {
      "name": "Pizza",
      "summary": "Dish",
      "subtitle": "Dish",
      "description": "Pizza is an Italian dish typically consisting of a flat base of leavened wheat-based dough topped with tomato, cheese, and other ingredients, baked at a high temperature, traditionally in a wood-fired oven.",
      "description_source": "Wikipedia",
      "description_link": "https://en.wikipedia.org/wiki/Pizza",
      "images": [
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Homemade Pizza Recipe: How to Make It",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Pizza maison à la friteuse à air – Parfaitement ...",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        },
        {
          "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
          "image_alt": "Image of Tomato and Mozzarella Pizza Recipe",
          "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w..."
        }
      ],
      "facts": [
        {
          "key": "Origin",
          "predicate": "hw:/collection/dishes:origin",
          "value": [
            {
              "text": "Italy",
              "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Italy&si=AL3DRZHmwLjWhgnaPB3UTu10R6S5qNLXiQiKMeezfKyB1FMsRgvMc15_a-XCDquvg02EcLVCDOBlFWcyGM1h_GEvApLCUHB4TbGV9DLLN_L5HXDRSM_AM0JjmkKGPEEkyRjAEOMkP_wbp9U4-YKGn63yz0_QGqKXGf1bKFT4vVVVz2XMsjUuOZt4AnSHQk-nDBQE0oBKvh4m&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQmxN6BAgQEAI"
            }
          ]
        }
      ],
      "nutrition_facts": {
        "product": "Pizza, 14\" regular crust",
        "source": "USDA",
        "source_link": "https://fdc.nal.usda.gov/food-details/173292/nutrients",
        "calories": "266 Calories",
        "portion": "100 grams"
      }
    },
    "overview": {
      "title": "Pizza",
      "kgmid": "/m/0663v"
    },
    "pagination": [
      {
        "page": 2,
        "start": 10,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=10&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAE"
      },
      {
        "page": 3,
        "start": 20,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=20&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAG"
      },
      {
        "page": 4,
        "start": 30,
        "link": "https://www.google.com/search?q=pizza&sca_esv=016f34706b28a015&hl=en&ei=bgSeaeHvJ_jYkdUP3e2DiAs&start=30&sa=N&sstk=Af77f_f_V2-MUys3284KigNlKSrRMuK2FycXBqPmoWealtPGblbQ6fG6nmOOnuTsIXX5La3IjQVKZgmp72693C-TVdrhH0fPkJks7A&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ8tMDegQICBAI"
      }
    ],
    "related": [
      {
        "text": "Pizza recette",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+recette&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhLEAE",
        "rank": 1,
        "global_rank": 14
      },
      {
        "text": "Pizza Hut",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Hut&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhhEAE",
        "rank": 2,
        "global_rank": 15
      },
      {
        "text": "Pizza Yolo",
        "link": "https://www.google.com/search?sca_esv=016f34706b28a015&hl=en&q=Pizza+Yolo&sa=X&ved=2ahUKEwjh3oW59vKSAxV4bKQEHd32ALEQ1QJ6BAhgEAE",
        "rank": 3,
        "global_rank": 16
      }
    ],
    "people_also_ask": [
      {
        "question": "Quel ingrédient mettre sur une pizza ?",
        "question_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "question_type": "featured",
        "answer_source": "JeSuisGastronome.fr",
        "answer_link": "https://www.jesuisgastronome.fr/actu/273/la-liste-des-quinze-meilleurs-ingredients-pour-une-pizza",
        "answer_display_link": "https://www.jesuisgastronome.fr › actu › la-liste-des-quin...https://www.jesuisgastronome.fr › actu › la-liste-des-quin...",
        "answers": [
          {
            "type": "unordered_list",
            "title": "La liste des quinze meilleurs ingrédients pour une pizza",
            "items": [
              {
                "value": "- Le mozzarella fondant.",
                "rank": 1
              },
              {
                "value": "- La fraîcheur du basilic.",
                "rank": 2
              },
              {
                "value": "- L'authentique jambon de Parme.",
                "rank": 3
              },
              {
                "value": "- Le piquant des olives noires.",
                "rank": 4
              },
              {
                "value": "- Apprécier l'anchois salé",
                "rank": 5
              },
              {
                "value": "- Déguster les champignons frais.",
                "rank": 6
              },
              {
                "value": "- Aimer la roquette croquante.",
                "rank": 7
              },
              {
                "value": "- Savourer le saucisson épicé",
                "rank": 8
              }
            ],
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 5
      }
    ],
    "oragnic": [
      {
        "link": "https://fr.wikipedia.org/wiki/Pizza",
        "source": "Wikipédia",
        "display_link": "https://fr.wikipedia.org › wiki › Pi...",
        "title": "Pizza",
        "description": "La pizza est une recette de cuisine traditionnelle de la cuisine italienne, originaire de Naples à base de galette de pâte à pain, garnie principalement ...Read more",
        "snippet_highlighted_words": [
          "pizza"
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_alt": "pizza from fr.wikipedia.org",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.marmiton.org/recettes/recette_pizza-maison_313213.aspx",
        "source": "Marmiton",
        "display_link": "https://www.marmiton.org › recettes",
        "title": "Recette de Pizza maison",
        "description": "Partager la recette · Étape 1. Dans un saladier, placez les 300 g de farine, puis la levure, puis le bicarbonate de soude, la pincée de sel et celle de poivre.Read more",
        "extensions": [
          {
            "type": "rating",
            "rating": 5,
            "reviews_cnt": 23,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://cuisine.journaldesfemmes.fr/recette-pizza",
        "source": "Journal des Femmes",
        "display_link": "https://cuisine.journaldesfemmes.fr › ...",
        "title": "Pizza maison : recettes faciles et savoureuses",
        "description": "Pizza : Meilleures recettes · Pizza chèvre, figues, pistaches et miel · Pizza blanche au saumon fumé et à la cancoillotte · Pizza au salami de Milano et chorizo.Read more",
        "snippet_highlighted_words": [
          "Pizza",
          "Pizza",
          "Pizza",
          "Pizza"
        ],
        "extensions": [
          {
            "type": "rating",
            "rating": 4.3,
            "reviews_cnt": 96,
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "rank": 3,
        "global_rank": 3
      }
    ]
  }
  ```
</ResponseExample>


# Video search
Source: https://docs.brightdata.com/api-reference/serp/google-search/videos

Configure the Bright Data Google Search Video Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```http theme={null}
https://www.google.com/search?q=pizza&tbm=vid
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define search type. For Video search, set `tbm` value to `vid`.

  ```http theme={null}
  https://www.google.com/search?q=pizza&tbm=vid
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/search?q=pizza&tbm=vid",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/search?q=pizza&tbm=vid"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/search?q=pizza&tbm=vid',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/search?q=pizza&tbm=vid',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={11} theme={null}
  {
    "general": {
      "search_engine": "google",
      "query": "pizza",
      "results_cnt": 275000000,
      "search_time": 0.2,
      "language": "en",
      "location": "United States",
      "mobile": false,
      "basic_view": false,
      "search_type": "videos",
      "page_title": "pizza - Google Search",
      "timestamp": "2026-02-25T08:37:05.282Z"
    },
    "input": {
      "original_url": "https://www.google.com/search?q=pizza&tbm=vid&brd_json=1",
      "request_id": "hl_xxxxxxxxxxxxxxx"
    },
    "navigation": [
      {
        "title": "All",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ0pQJegQIChAB"
      },
      {
        "title": "Maps",
        "href": "https://maps.google.com/maps?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&entry=mc&ved=1t:200715&ictx=111"
      },
      {
        "title": "Images",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=2&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQtKgLegQIDBAB"
      },
      {
        "title": "Shopping",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=28&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&ved=1t:220175&ictx=111"
      },
      {
        "title": "News",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&q=pizza&tbm=nws&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ0pQJegQIDxAB"
      },
      {
        "title": "Forums",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=18&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQs6gLegQICxAB"
      },
      {
        "title": "Short videos",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=39&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQs6gLegQIJhAB"
      },
      {
        "title": "Web",
        "href": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=web&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&q=pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQs6gLegQIJxAB"
      },
      {
        "title": "Flights",
        "href": "https://www.google.com/travel/flights?sca_esv=206cd4dd954885db&gl=US&hl=en&output=search&q=pizza&source=lnms&fbs=ADc_l-aN0CWEZBOHjofHoaMMDiKpUrv6YeyJhXfuYqj4Fj6c1Tg5t_ufWNUvD2V-uX26AFlqeVA_8cCiKkQH-MFQemrtPKh5DXjDm8xDum7A4wYDWJgscQ2OVXNkKTqqlx9HCssMrDWQeoEQBO4dwrtGUJY4Oy-Z14dRBjPQpDok7I-4oduRsCNHRrO_G3ovy1C5_HZK3cFUgyvFUoxX8cqnfGbb7mjGvQ&ved=1t:200715&ictx=111"
      }
    ],
    "organic": [
      {
        "link": "https://www.youtube.com/watch?v=h3qO7Jii3BE",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "How To Make Frozen Pizza Bases Ready Anytime at Home",
        "description": "SUBSCRIBE https://www.youtube.com/user/maestrovitoiacopelli MY MASTER CLASS PIZZA: https://www.master-class.pizza/ Check out ,my new brand ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "10:42",
        "duration_sec": 642,
        "rank": 1,
        "global_rank": 1
      },
      {
        "link": "https://www.youtube.com/watch?v=Bz6tlSbN_GA",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Recreating The Takeaway Pizza Of My Childhood",
        "description": "Do you think pizzas have shrunk? The takeaway pizza of my childhood was 100% better than it is now. But we have no proof!",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "13:55",
        "duration_sec": 835,
        "rank": 2,
        "global_rank": 2
      },
      {
        "link": "https://www.youtube.com/shorts/cpW38_oZG3Q",
        "source": "www.youtube.com › shorts",
        "display_link": "www.youtube.com › shorts",
        "title": "Taco Bell Mexican Pizza Hack",
        "description": "Level up your Taco Tuesdays with this Taco Bell Mexican Pizza! The trick here is to use this simple tortilla hack: fold the tortilla halves ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "0:41",
        "duration_sec": 41,
        "rank": 3,
        "global_rank": 3
      },
      {
        "link": "https://www.youtube.com/watch?v=dsQGMhsvIYY",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "The Secret To Authentic Neapolitan Pizza",
        "description": "Melt-in-your mouth pizza with fresh, flavorful toppings: this is Neapolitan pizza like an Italian chef would make it. COOK the full recipe ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "12:56",
        "duration_sec": 776,
        "rank": 4,
        "global_rank": 4
      },
      {
        "link": "https://www.youtube.com/watch?v=pT7WRxzK_Og",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Family Pizza Night at Its Most Crispy & Cheesy",
        "description": "I made this twice in the last 3 weeks. I have the Lodge 10.25\" cast iron from Amazon that I'll put on a baking steel for 18 minutes. Take the ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "11:51",
        "duration_sec": 711,
        "rank": 5,
        "global_rank": 5
      },
      {
        "link": "https://www.youtube.com/watch?v=m2Uezalybwg",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Puff Pastry Pizza Poppers | Crispy One-Bite Party Pizza | Food ...",
        "description": "These easy-to-make, bite-sized puff pastry pizza poppers are the best way (probably the only way?) to enjoy a proper puff pastry pizza.",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "8:03",
        "duration_sec": 483,
        "rank": 6,
        "global_rank": 6
      },
      {
        "link": "https://www.youtube.com/watch?v=7iWWdSsTI0I",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Barstool Pizza Review - Flour + Water Pizzeria (San Francisco ...",
        "description": "Dave tries a pizza place with the rare exception of him like the Neapolitan more than the cheese. Download The One Bite App to see more and ...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "duration": "4:07",
        "duration_sec": 247,
        "rank": 7,
        "global_rank": 7
      },
      {
        "link": "https://www.youtube.com/watch?v=_5sYXU4QZEU",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Barstool Pizza Review - Hi Hat (San Francisco, CA) Bonus ...",
        "description": "Dave tries the highly recommended Hi Hat, and runs into an accidental chocolate chip cookie review that blows his mind.",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwKpcn5tEt_rbLcahdOAKkvcZFqHlaiZ1BCA5GytAUSt09nwmQpabnKQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwKpcn5tEt_rbLcahdOAKkvcZFqHlaiZ1BCA5GytAUSt09nwmQpabnKQ&s",
        "duration": "6:58",
        "duration_sec": 418,
        "rank": 8,
        "global_rank": 8
      },
      {
        "link": "https://www.youtube.com/watch?v=wZRdDG2K_mg",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "School Cafeteria Pizza For Grown-Ups",
        "description": "Thank you Helix Sleep for sponsoring! Visit https://helixsleep.com/emmymade to take advantage of their New Year Final Hours Sale and get 20% ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQe5ownYLe3x_j74iBFfxZA2PgliRpMe2l3zyGhZhTkWGN-HEKmPjZRTw&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQe5ownYLe3x_j74iBFfxZA2PgliRpMe2l3zyGhZhTkWGN-HEKmPjZRTw&s",
        "duration": "19:18",
        "duration_sec": 1158,
        "rank": 9,
        "global_rank": 9
      },
      {
        "link": "https://www.youtube.com/watch?v=zS18jl621yk",
        "source": "www.youtube.com › watch",
        "display_link": "www.youtube.com › watch",
        "title": "Tracy Morgan, Daniel Radcliffe and Erika Alexander: The ...",
        "description": "Welcome back to The Pizza Interview, a series from The New York Times Cooking where the Q&A has a catch: Our guests have to make pizza while ...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYvH9JlfVXjhw-Wvd3Lh346VtdK1Az8xHEP9gcKRU8owmDuzplX243PA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYvH9JlfVXjhw-Wvd3Lh346VtdK1Az8xHEP9gcKRU8owmDuzplX243PA&s",
        "duration": "12:41",
        "duration_sec": 761,
        "rank": 10,
        "global_rank": 10
      }
    ],
    "pagination": {
      "next_page_start": 10,
      "next_page_link": "https://www.google.com/search?q=pizza&sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&ei=sLSeaeyoGZOEp84PpOPgiQk&start=10&sa=N"
    },
    "related": [
      {
        "text": "youtube pizza",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Youtube+Pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgdEAE",
        "rank": 1,
        "global_rank": 11
      },
      {
        "text": "pizza dough youtube",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Pizza+dough+youtube&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgeEAE",
        "rank": 2,
        "global_rank": 12
      },
      {
        "text": "nick's kitchen pizza",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Nick%27s+Kitchen+pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAggEAE",
        "rank": 3,
        "global_rank": 13
      },
      {
        "text": "how you make pizza",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=How+you+make+pizza&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAghEAE",
        "rank": 4,
        "global_rank": 14
      },
      {
        "text": "new york pizza youtube",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=New+York+pizza+youtube&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgjEAE",
        "rank": 5,
        "global_rank": 15
      },
      {
        "text": "neapolitan pizza dough recipe",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Neapolitan+pizza+dough+recipe&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgiEAE",
        "rank": 6,
        "global_rank": 16
      },
      {
        "text": "nick's kitchen videos",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=Nick%27s+Kitchen+videos&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgfEAE",
        "rank": 7,
        "global_rank": 17
      },
      {
        "text": "more nick youtube",
        "link": "https://www.google.com/search?sca_esv=206cd4dd954885db&gl=US&hl=en&udm=7&q=More+nick+youtube&sa=X&ved=2ahUKEwjswOPEnvSSAxUTwskDHaQxOJEQ1QJ6BAgcEAE",
        "rank": 8,
        "global_rank": 18
      }
    ]
  }
  ```
</ResponseExample>


# Google Trends async request
Source: https://docs.brightdata.com/api-reference/serp/google-trends/async

Use the Bright Data Google Trends async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

<Warning>
  Trends supports parsed results only i.e. `brd_json=1`
</Warning>

<Warning>
  We support only the “Trending now” tab within Google Trends. Other tabs (e.g. "Explore", "Home") are not supported as they require login access for full functionality.
</Warning>

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```Example theme={null}
  https://trends.google.com/trends/explore?q=pizza
  ```
</ParamField>

<ParamField type="string">
  To display specific widget data within your Google Trends results, use one of the following widget parameters:

  * `timeseries`: Retrieves the time series widget data.
  * `geo_map`: Retrieves the geo map widget data.

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
  ```

  <Tip>
    **For multiple widgets:** Separate them with a comma. e.g. `timeseries,geo_map`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  68
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "68"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "IE",
                "geoName": "Ireland",
                "value": [
                  89
                ],
                "formattedValue": [
                  "89"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "MF",
                "geoName": "St. Martin",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Canada",
                "value": [
                  78
                ],
                "formattedValue": [
                  "78"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US",
                "geoName": "United States",
                "value": [
                  73
                ],
                "formattedValue": [
                  "73"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua & Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 85,
                    "formattedValue": "85",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 30,
                    "formattedValue": "30",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza dough",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=today+12-m"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 15,
                    "formattedValue": "15",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=today+12-m"
                  },
                  {
                    "query": "city pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=city+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza house",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "crust pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza place",
                    "value": 10,
                    "formattedValue": "10",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+place&date=today+12-m"
                  },
                  {
                    "query": "express pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=express+pizza&date=today+12-m"
                  },
                  {
                    "query": "new york pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=new+york+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza places",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+places&date=today+12-m"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=today+12-m"
                  },
                  {
                    "query": "boston pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=boston+pizza&date=today+12-m"
                  },
                  {
                    "query": "papa johns pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=papa+johns+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza sauce",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+sauce&date=today+12-m"
                  },
                  {
                    "query": "pizza shop",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+shop&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pentagon pizza index",
                    "value": 2650,
                    "formattedValue": "+2,650%",
                    "link": "/trends/explore?q=pentagon+pizza+index&date=today+12-m"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 2600,
                    "formattedValue": "+2,600%",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=today+12-m"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 2450,
                    "formattedValue": "+2,450%",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=today+12-m"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 1800,
                    "formattedValue": "+1,800%",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 1750,
                    "formattedValue": "+1,750%",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=today+12-m"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=today+12-m"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=today+12-m"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 1000,
                    "formattedValue": "+1,000%",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=today+12-m"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 900,
                    "formattedValue": "+900%",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 350,
                    "formattedValue": "+350%",
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza delivered",
                    "value": 250,
                    "formattedValue": "+250%",
                    "link": "/trends/explore?q=pizza+delivered&date=today+12-m"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 160,
                    "formattedValue": "+160%",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=today+12-m"
                  },
                  {
                    "query": "order pizza near me",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=order+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "pizza takeaway",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+takeaway&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza deals near me",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pizza+deals+near+me&date=today+12-m"
                  },
                  {
                    "query": "order pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=order+pizza&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Category
Source: https://docs.brightdata.com/api-reference/serp/google-trends/category

Configure the Bright Data Google Trends Category parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Category to search within. By default, search within all categories.\
  You can find list of all categories [here](https://trends.google.com/trends/api/explore/pickers/category?lang=en-US\&tz=240).

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  72
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "72"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  74
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "74"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  78
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "78"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  77
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "77"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  77
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "77"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "AS",
                "geoName": "American Samoa",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GF",
                "geoName": "French Guiana",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GP",
                "geoName": "Guadeloupe",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua & Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "SK",
                "geoName": "Slovakia",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "YT",
                "geoName": "Mayotte",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BM",
                "geoName": "Bermuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "SM",
                "geoName": "San Marino",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Geo
Source: https://docs.brightdata.com/api-reference/serp/google-trends/geo

Reference for the Bright Data Google Trends Geo parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Location of interest, two-letter country code

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  80
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "80"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  75
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "75"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  83
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "83"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  81
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "81"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  76
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "76"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  79
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "79"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  76
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "76"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  77
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "77"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "US-RI",
                "geoName": "Rhode Island",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-CT",
                "geoName": "Connecticut",
                "value": [
                  99
                ],
                "formattedValue": [
                  "99"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-DE",
                "geoName": "Delaware",
                "value": [
                  99
                ],
                "formattedValue": [
                  "99"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-PA",
                "geoName": "Pennsylvania",
                "value": [
                  96
                ],
                "formattedValue": [
                  "96"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-MA",
                "geoName": "Massachusetts",
                "value": [
                  93
                ],
                "formattedValue": [
                  "93"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-OH",
                "geoName": "Ohio",
                "value": [
                  91
                ],
                "formattedValue": [
                  "91"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-NH",
                "geoName": "New Hampshire",
                "value": [
                  91
                ],
                "formattedValue": [
                  "91"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-MI",
                "geoName": "Michigan",
                "value": [
                  84
                ],
                "formattedValue": [
                  "84"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-IN",
                "geoName": "Indiana",
                "value": [
                  82
                ],
                "formattedValue": [
                  "82"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US-WV",
                "geoName": "West Virginia",
                "value": [
                  79
                ],
                "formattedValue": [
                  "79"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by subregion"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": []
              },
              {
                "rankedKeyword": []
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Google Trends localization
Source: https://docs.brightdata.com/api-reference/serp/google-trends/localization

Configure the Bright Data Google Trends Google Trends localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "23. Feb. – 1. März 2025",
                "formattedAxisTime": "23.02.2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "2.–8. März 2025",
                "formattedAxisTime": "02.03.2025",
                "value": [
                  68
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "68"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "9.–15. März 2025",
                "formattedAxisTime": "09.03.2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "16.–22. März 2025",
                "formattedAxisTime": "16.03.2025",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "23.–29. März 2025",
                "formattedAxisTime": "23.03.2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "30. März – 5. Apr. 2025",
                "formattedAxisTime": "30.03.2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "6.–12. Apr. 2025",
                "formattedAxisTime": "06.04.2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "13.–19. Apr. 2025",
                "formattedAxisTime": "13.04.2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "20.–26. Apr. 2025",
                "formattedAxisTime": "20.04.2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "27. Apr. – 3. Mai 2025",
                "formattedAxisTime": "27.04.2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interesse im zeitlichen Verlauf"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "IE",
                "geoName": "Irland",
                "value": [
                  89
                ],
                "formattedValue": [
                  "89"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "MF",
                "geoName": "St. Martin",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "Amerikanische Jungferninseln",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Kanada",
                "value": [
                  78
                ],
                "formattedValue": [
                  "78"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US",
                "geoName": "Vereinigte Staaten",
                "value": [
                  73
                ],
                "formattedValue": [
                  "73"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua und Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interesse nach Region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 85,
                    "formattedValue": "85",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza pizza near me",
                    "value": 78,
                    "formattedValue": "78",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 30,
                    "formattedValue": "30",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza dough",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=today+12-m"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 15,
                    "formattedValue": "15",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=today+12-m"
                  },
                  {
                    "query": "city pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=city+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza house",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=today+12-m"
                  },
                  {
                    "query": "crust pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza place",
                    "value": 10,
                    "formattedValue": "10",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+place&date=today+12-m"
                  },
                  {
                    "query": "express pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=express+pizza&date=today+12-m"
                  },
                  {
                    "query": "new york pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=new+york+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza places",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+places&date=today+12-m"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=today+12-m"
                  },
                  {
                    "query": "boston pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=boston+pizza&date=today+12-m"
                  },
                  {
                    "query": "papa johns pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=papa+johns+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza sauce",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+sauce&date=today+12-m"
                  },
                  {
                    "query": "pizza shop",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+shop&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pentagon pizza index",
                    "value": 2650,
                    "formattedValue": "+ 2.650 %",
                    "link": "/trends/explore?q=pentagon+pizza+index&date=today+12-m"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 2550,
                    "formattedValue": "+ 2.550 %",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=today+12-m"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 2400,
                    "formattedValue": "+ 2.400 %",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=today+12-m"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 1800,
                    "formattedValue": "+ 1.800 %",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 1700,
                    "formattedValue": "+ 1.700 %",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=today+12-m"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 1400,
                    "formattedValue": "+ 1.400 %",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=today+12-m"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 1400,
                    "formattedValue": "+ 1.400 %",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=today+12-m"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 950,
                    "formattedValue": "+ 950 %",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=today+12-m"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 900,
                    "formattedValue": "+ 900 %",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 350,
                    "formattedValue": "+ 350 %",
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza delivered",
                    "value": 250,
                    "formattedValue": "+ 250 %",
                    "link": "/trends/explore?q=pizza+delivered&date=today+12-m"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 150,
                    "formattedValue": "+ 150 %",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 60,
                    "formattedValue": "+ 60 %",
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 50,
                    "formattedValue": "+ 50 %",
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "pizza takeaway",
                    "value": 40,
                    "formattedValue": "+ 40 %",
                    "link": "/trends/explore?q=pizza+takeaway&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 40,
                    "formattedValue": "+ 40 %",
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "order pizza",
                    "value": 40,
                    "formattedValue": "+ 40 %",
                    "link": "/trends/explore?q=order+pizza&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Ähnliche Suchanfragen"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Suchbegriff"
      }
    ]
  }
  ```
</ResponseExample>


# Search type
Source: https://docs.brightdata.com/api-reference/serp/google-trends/search-type

Configure the Bright Data Google Trends Search Type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Google property to filter on. Defaults to web search.\\

  Possible values are: `images`, `news`, `froogle` (for Google Shopping), `youtube`

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  54
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "54"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  54
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "54"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  48
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "48"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  47
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "47"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  56
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "56"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  62
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "62"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  54
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "54"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  55
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "55"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  60
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "60"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  48
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "48"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PK",
                "geoName": "Pakistan",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  84
                ],
                "formattedValue": [
                  "84"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "JE",
                "geoName": "Jersey",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GP",
                "geoName": "Guadeloupe",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MP",
                "geoName": "Northern Mariana Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MT",
                "geoName": "Malta",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "KM",
                "geoName": "Comoros",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza cheese",
                    "value": 50,
                    "formattedValue": "50",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+cheese&date=today+12-m"
                  },
                  {
                    "query": "chicken pizza",
                    "value": 38,
                    "formattedValue": "38",
                    "hasData": true,
                    "link": "/trends/explore?q=chicken+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza dominos",
                    "value": 36,
                    "formattedValue": "36",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dominos&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 35,
                    "formattedValue": "35",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "food",
                    "value": 32,
                    "formattedValue": "32",
                    "hasData": true,
                    "link": "/trends/explore?q=food&date=today+12-m"
                  },
                  {
                    "query": "pizza logo",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+logo&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 29,
                    "formattedValue": "29",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "burger",
                    "value": 27,
                    "formattedValue": "27",
                    "hasData": true,
                    "link": "/trends/explore?q=burger&date=today+12-m"
                  },
                  {
                    "query": "pizza burger",
                    "value": 26,
                    "formattedValue": "26",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+burger&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza png",
                    "value": 23,
                    "formattedValue": "23",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+png&date=today+12-m"
                  },
                  {
                    "query": "pizza tower",
                    "value": 22,
                    "formattedValue": "22",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+tower&date=today+12-m"
                  },
                  {
                    "query": "pepperoni",
                    "value": 22,
                    "formattedValue": "22",
                    "hasData": true,
                    "link": "/trends/explore?q=pepperoni&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 21,
                    "formattedValue": "21",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza box",
                    "value": 20,
                    "formattedValue": "20",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+box&date=today+12-m"
                  },
                  {
                    "query": "pasta",
                    "value": 19,
                    "formattedValue": "19",
                    "hasData": true,
                    "link": "/trends/explore?q=pasta&date=today+12-m"
                  },
                  {
                    "query": "pizza slice",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+slice&date=today+12-m"
                  },
                  {
                    "query": "italian pizza",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=italian+pizza&date=today+12-m"
                  },
                  {
                    "query": "margherita pizza",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=margherita+pizza&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  },
                  {
                    "query": "little caesars",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars&date=today+12-m"
                  },
                  {
                    "query": "pizza drawing",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+drawing&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 14,
                    "formattedValue": "14",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza roblox",
                    "value": 13,
                    "formattedValue": "13",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+roblox&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "work at a pizza place",
                    "value": 200,
                    "formattedValue": "+200%",
                    "link": "/trends/explore?q=work+at+a+pizza+place&date=today+12-m"
                  },
                  {
                    "query": "halloween pizza",
                    "value": 140,
                    "formattedValue": "+140%",
                    "link": "/trends/explore?q=halloween+pizza&date=today+12-m"
                  },
                  {
                    "query": "marco's pizza",
                    "value": 120,
                    "formattedValue": "+120%",
                    "link": "/trends/explore?q=marco's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 120,
                    "formattedValue": "+120%",
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza roblox",
                    "value": 110,
                    "formattedValue": "+110%",
                    "link": "/trends/explore?q=pizza+roblox&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 90,
                    "formattedValue": "+90%",
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "angel's pizza",
                    "value": 80,
                    "formattedValue": "+80%",
                    "link": "/trends/explore?q=angel's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza tarifi",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=pizza+tarifi&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  },
                  {
                    "query": "little caesars",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=little+caesars&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Google Trends text search
Source: https://docs.brightdata.com/api-reference/serp/google-trends/text-search

Configure the Bright Data Google Trends Google Trends text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
```

<Warning>
  Trends supports parsed results only i.e. `brd_json=1`
</Warning>

<Warning>
  We support only the “Trending now” tab within Google Trends. Other tabs (e.g. "Explore", "Home") are not supported as they require login access for full functionality.
</Warning>

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```Example theme={null}
  https://trends.google.com/trends/explore?q=pizza
  ```
</ParamField>

<ParamField type="string">
  To display specific widget data within your Google Trends results, use one of the following widget parameters:

  * `timeseries`: Retrieves the time series widget data.
  * `geo_map`: Retrieves the geo map widget data.

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1
  ```

  <Tip>
    **For multiple widgets:** Separate them with a comma. e.g. `timeseries,geo_map`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1740268800",
                "formattedTime": "Feb 23 – Mar 1, 2025",
                "formattedAxisTime": "Feb 23, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1740873600",
                "formattedTime": "Mar 2 – 8, 2025",
                "formattedAxisTime": "Mar 2, 2025",
                "value": [
                  68
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "68"
                ]
              },
              {
                "time": "1741478400",
                "formattedTime": "Mar 9 – 15, 2025",
                "formattedAxisTime": "Mar 9, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1742083200",
                "formattedTime": "Mar 16 – 22, 2025",
                "formattedAxisTime": "Mar 16, 2025",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              },
              {
                "time": "1742688000",
                "formattedTime": "Mar 23 – 29, 2025",
                "formattedAxisTime": "Mar 23, 2025",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1743292800",
                "formattedTime": "Mar 30 – Apr 5, 2025",
                "formattedAxisTime": "Mar 30, 2025",
                "value": [
                  73
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "73"
                ]
              },
              {
                "time": "1743897600",
                "formattedTime": "Apr 6 – 12, 2025",
                "formattedAxisTime": "Apr 6, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              },
              {
                "time": "1744502400",
                "formattedTime": "Apr 13 – 19, 2025",
                "formattedAxisTime": "Apr 13, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745107200",
                "formattedTime": "Apr 20 – 26, 2025",
                "formattedAxisTime": "Apr 20, 2025",
                "value": [
                  71
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "71"
                ]
              },
              {
                "time": "1745712000",
                "formattedTime": "Apr 27 – May 3, 2025",
                "formattedAxisTime": "Apr 27, 2025",
                "value": [
                  67
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "67"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "IE",
                "geoName": "Ireland",
                "value": [
                  89
                ],
                "formattedValue": [
                  "89"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "MF",
                "geoName": "St. Martin",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Canada",
                "value": [
                  78
                ],
                "formattedValue": [
                  "78"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "US",
                "geoName": "United States",
                "value": [
                  73
                ],
                "formattedValue": [
                  "73"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "SX",
                "geoName": "Sint Maarten",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "AG",
                "geoName": "Antigua & Barbuda",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "MQ",
                "geoName": "Martinique",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=today+12-m"
                  },
                  {
                    "query": "pizza near me",
                    "value": 85,
                    "formattedValue": "85",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 31,
                    "formattedValue": "31",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=today+12-m"
                  },
                  {
                    "query": "dominos",
                    "value": 30,
                    "formattedValue": "30",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=today+12-m"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 24,
                    "formattedValue": "24",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza oven",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=today+12-m"
                  },
                  {
                    "query": "pizza dough",
                    "value": 17,
                    "formattedValue": "17",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=today+12-m"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 15,
                    "formattedValue": "15",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=today+12-m"
                  },
                  {
                    "query": "city pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=city+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza house",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "crust pizza",
                    "value": 12,
                    "formattedValue": "12",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza place",
                    "value": 10,
                    "formattedValue": "10",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+place&date=today+12-m"
                  },
                  {
                    "query": "express pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=express+pizza&date=today+12-m"
                  },
                  {
                    "query": "new york pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=new+york+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza places",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+places&date=today+12-m"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=today+12-m"
                  },
                  {
                    "query": "boston pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=boston+pizza&date=today+12-m"
                  },
                  {
                    "query": "papa johns pizza",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=papa+johns+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza hut near me",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza sauce",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+sauce&date=today+12-m"
                  },
                  {
                    "query": "pizza shop",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+shop&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "little caesars pizza",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=little+caesars+pizza&date=today+12-m"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pentagon pizza index",
                    "value": 2650,
                    "formattedValue": "+2,650%",
                    "link": "/trends/explore?q=pentagon+pizza+index&date=today+12-m"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 2600,
                    "formattedValue": "+2,600%",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=today+12-m"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 2450,
                    "formattedValue": "+2,450%",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=today+12-m"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 1800,
                    "formattedValue": "+1,800%",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 1750,
                    "formattedValue": "+1,750%",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=today+12-m"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=today+12-m"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 1450,
                    "formattedValue": "+1,450%",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=today+12-m"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 1000,
                    "formattedValue": "+1,000%",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=today+12-m"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 900,
                    "formattedValue": "+900%",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=today+12-m"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 350,
                    "formattedValue": "+350%",
                    "link": "/trends/explore?q=best+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza delivered",
                    "value": 250,
                    "formattedValue": "+250%",
                    "link": "/trends/explore?q=pizza+delivered&date=today+12-m"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 160,
                    "formattedValue": "+160%",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=today+12-m"
                  },
                  {
                    "query": "order pizza near me",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=order+pizza+near+me&date=today+12-m"
                  },
                  {
                    "query": "pizza time",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=pizza+time&date=today+12-m"
                  },
                  {
                    "query": "pizza company",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+company&date=today+12-m"
                  },
                  {
                    "query": "pizza takeaway",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+takeaway&date=today+12-m"
                  },
                  {
                    "query": "pepperoni pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pepperoni+pizza&date=today+12-m"
                  },
                  {
                    "query": "pizza deals near me",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=pizza+deals+near+me&date=today+12-m"
                  },
                  {
                    "query": "order pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=order+pizza&date=today+12-m"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Time range
Source: https://docs.brightdata.com/api-reference/serp/google-trends/time-range

Configure the Bright Data Google Trends Time Range parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1
```

## Parameters

<ParamField type="string">
  Time range to search.

  > **Available values are:**\
  > `now 1-H` - Past hour\
  > `now 4-H` - Past 4 hours\
  > `now 1-d` - Past day\
  > `now 7-d` - Past 7 days\
  > `today 1-m` - Past 30 days\
  > `today 3-m` - Past 90 days\
  > `today 12-m` (default) - Past 12 months\
  > `today 5-y` - Past 5 years\
  > `2020-07-01 2020-12-31` - custom date range

  ```txt wrap theme={null}
  https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "widgets": [
      {
        "data": {
          "default": {
            "timelineData": [
              {
                "time": "1771948800",
                "formattedTime": "Feb 24, 2026 at 11:00 AM",
                "formattedAxisTime": "Feb 24 at 11:00 AM",
                "value": [
                  59
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "59"
                ]
              },
              {
                "time": "1771949280",
                "formattedTime": "Feb 24, 2026 at 11:08 AM",
                "formattedAxisTime": "Feb 24 at 11:08 AM",
                "value": [
                  63
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "63"
                ]
              },
              {
                "time": "1771949760",
                "formattedTime": "Feb 24, 2026 at 11:16 AM",
                "formattedAxisTime": "Feb 24 at 11:16 AM",
                "value": [
                  61
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "61"
                ]
              },
              {
                "time": "1771950240",
                "formattedTime": "Feb 24, 2026 at 11:24 AM",
                "formattedAxisTime": "Feb 24 at 11:24 AM",
                "value": [
                  62
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "62"
                ]
              },
              {
                "time": "1771950720",
                "formattedTime": "Feb 24, 2026 at 11:32 AM",
                "formattedAxisTime": "Feb 24 at 11:32 AM",
                "value": [
                  62
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "62"
                ]
              },
              {
                "time": "1771951200",
                "formattedTime": "Feb 24, 2026 at 11:40 AM",
                "formattedAxisTime": "Feb 24 at 11:40 AM",
                "value": [
                  65
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "65"
                ]
              },
              {
                "time": "1771951680",
                "formattedTime": "Feb 24, 2026 at 11:48 AM",
                "formattedAxisTime": "Feb 24 at 11:48 AM",
                "value": [
                  69
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "69"
                ]
              },
              {
                "time": "1771952160",
                "formattedTime": "Feb 24, 2026 at 11:56 AM",
                "formattedAxisTime": "Feb 24 at 11:56 AM",
                "value": [
                  64
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "64"
                ]
              },
              {
                "time": "1771952640",
                "formattedTime": "Feb 24, 2026 at 12:04 PM",
                "formattedAxisTime": "Feb 24 at 12:04 PM",
                "value": [
                  86
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "86"
                ]
              },
              {
                "time": "1771953120",
                "formattedTime": "Feb 24, 2026 at 12:12 PM",
                "formattedAxisTime": "Feb 24 at 12:12 PM",
                "value": [
                  70
                ],
                "hasData": [
                  true
                ],
                "formattedValue": [
                  "70"
                ]
              }
            ],
            "averages": []
          }
        },
        "id": "TIMESERIES",
        "type": "fe_line_chart",
        "title": "Interest over time"
      },
      {
        "data": {
          "default": {
            "geoMapData": [
              {
                "geoCode": "KP",
                "geoName": "North Korea",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "BL",
                "geoName": "St. Barthélemy",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "PR",
                "geoName": "Puerto Rico",
                "value": [
                  100
                ],
                "formattedValue": [
                  "100"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "CK",
                "geoName": "Cook Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "GU",
                "geoName": "Guam",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "VI",
                "geoName": "U.S. Virgin Islands",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "US",
                "geoName": "United States",
                "value": [
                  81
                ],
                "formattedValue": [
                  "81"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "CA",
                "geoName": "Canada",
                "value": [
                  80
                ],
                "formattedValue": [
                  "80"
                ],
                "maxValueIndex": 0,
                "hasData": [
                  true
                ]
              },
              {
                "geoCode": "AL",
                "geoName": "Albania",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              },
              {
                "geoCode": "XK",
                "geoName": "Kosovo",
                "value": [
                  0
                ],
                "formattedValue": [
                  ""
                ],
                "maxValueIndex": 0,
                "hasData": [
                  false
                ]
              }
            ]
          }
        },
        "id": "GEO_MAP",
        "type": "fe_geo_chart_explore",
        "title": "Interest by region"
      },
      {
        "data": {
          "default": {
            "rankedList": [
              {
                "rankedKeyword": [
                  {
                    "query": "pizza near me",
                    "value": 100,
                    "formattedValue": "100",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+near+me&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 40,
                    "formattedValue": "40",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me&date=now+1-d"
                  },
                  {
                    "query": "pizza hut",
                    "value": 40,
                    "formattedValue": "40",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+hut&date=now+1-d"
                  },
                  {
                    "query": "dominos",
                    "value": 18,
                    "formattedValue": "18",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos&date=now+1-d"
                  },
                  {
                    "query": "dominos pizza",
                    "value": 18,
                    "formattedValue": "18",
                    "hasData": true,
                    "link": "/trends/explore?q=dominos+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza dough",
                    "value": 11,
                    "formattedValue": "11",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+dough&date=now+1-d"
                  },
                  {
                    "query": "crust pizza",
                    "value": 9,
                    "formattedValue": "9",
                    "hasData": true,
                    "link": "/trends/explore?q=crust+pizza&date=now+1-d"
                  },
                  {
                    "query": "domino's pizza",
                    "value": 8,
                    "formattedValue": "8",
                    "hasData": true,
                    "link": "/trends/explore?q=domino's+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza oven",
                    "value": 7,
                    "formattedValue": "7",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+oven&date=now+1-d"
                  },
                  {
                    "query": "chicago pizza",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=chicago+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza margherita",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+margherita&date=now+1-d"
                  },
                  {
                    "query": "pizza delivery",
                    "value": 6,
                    "formattedValue": "6",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+delivery&date=now+1-d"
                  },
                  {
                    "query": "deep dish pizza",
                    "value": 5,
                    "formattedValue": "5",
                    "hasData": true,
                    "link": "/trends/explore?q=deep+dish+pizza&date=now+1-d"
                  },
                  {
                    "query": "pizza house",
                    "value": 5,
                    "formattedValue": "5",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+house&date=now+1-d"
                  },
                  {
                    "query": "pizza time",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+time&date=now+1-d"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=now+1-d"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=now+1-d"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=now+1-d"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=now+1-d"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=now+1-d"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=now+1-d"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=now+1-d"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 4,
                    "formattedValue": "4",
                    "hasData": true,
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=now+1-d"
                  },
                  {
                    "query": "debonairs pizza",
                    "value": 1,
                    "formattedValue": "1",
                    "hasData": true,
                    "link": "/trends/explore?q=debonairs+pizza&date=now+1-d"
                  }
                ]
              },
              {
                "rankedKeyword": [
                  {
                    "query": "pizza hut all you can eat",
                    "value": 250,
                    "formattedValue": "+250%",
                    "link": "/trends/explore?q=pizza+hut+all+you+can+eat&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me open now",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=best+pizza+near+me+open+now&date=now+1-d"
                  },
                  {
                    "query": "best pizza near me",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=best+pizza+near+me&date=now+1-d"
                  },
                  {
                    "query": "how to make pizza dough at home",
                    "value": 60,
                    "formattedValue": "+60%",
                    "link": "/trends/explore?q=how+to+make+pizza+dough+at+home&date=now+1-d"
                  },
                  {
                    "query": "what is a pizza stone",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=what+is+a+pizza+stone&date=now+1-d"
                  },
                  {
                    "query": "pizza calzone near me",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+calzone+near+me&date=now+1-d"
                  },
                  {
                    "query": "gluten free pizza crust recipe",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=gluten+free+pizza+crust+recipe&date=now+1-d"
                  },
                  {
                    "query": "pizza margherita near me",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+margherita+near+me&date=now+1-d"
                  },
                  {
                    "query": "best deep dish pizza in chicago",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=best+deep+dish+pizza+in+chicago&date=now+1-d"
                  },
                  {
                    "query": "pizza napoletana near me",
                    "value": 50,
                    "formattedValue": "+50%",
                    "link": "/trends/explore?q=pizza+napoletana+near+me&date=now+1-d"
                  },
                  {
                    "query": "how to reheat pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=how+to+reheat+pizza&date=now+1-d"
                  },
                  {
                    "query": "licorice pizza",
                    "value": 40,
                    "formattedValue": "+40%",
                    "link": "/trends/explore?q=licorice+pizza&date=now+1-d"
                  }
                ]
              }
            ]
          }
        },
        "id": "RELATED_QUERIES",
        "type": "fe_related_searches",
        "title": "Related queries"
      }
    ],
    "keywords": [
      {
        "keyword": "pizza",
        "name": "pizza",
        "type": "Search term"
      }
    ]
  }
  ```
</ResponseExample>


# Add a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Add_a_Zone

api-reference/openapi POST /zone
Use the Bright Data Account Management API to add a Zone. POST /zone returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning>This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

## ISP proxy zone examples

Creating an ISP zone requires specific parameter combinations. The fields below are not optional. Omitting them will silently create the wrong zone type or billing plan.

<Warning>
  Setting `zone.type` to `ISP` alone will create a **Datacenter zone**, not an ISP zone. You must also set `plan.pool_ip_type` to `static_res`. Country codes must be **lowercase** (e.g. `us`, `gb`). Uppercase codes return a misleading "no IPs available" error.
</Warning>

### Shared ISP (pay-per-GB)

```json theme={null}
{
  "zone": { "name": "my_isp_zone", "type": "ISP" },
  "plan": {
    "type": "static",
    "pool_ip_type": "static_res",
    "ips_type": "shared",
    "bandwidth": "bandwidth",
    "country": "us"
  }
}
```

### Shared ISP (unlimited bandwidth)

Setting `bandwidth: unlimited` alone **does not** activate unlimited billing. You must also include `unl_bw_tiers: std`.

```json theme={null}
{
  "zone": { "name": "my_isp_zone", "type": "ISP" },
  "plan": {
    "type": "static",
    "pool_ip_type": "static_res",
    "ips_type": "shared",
    "bandwidth": "unlimited",
    "unl_bw_tiers": "std",
    "country": "us"
  }
}
```

### Dedicated ISP (unlimited bandwidth)

```json theme={null}
{
  "zone": { "name": "my_isp_zone", "type": "ISP" },
  "plan": {
    "type": "static",
    "pool_ip_type": "static_res",
    "ips_type": "dedicated",
    "bandwidth": "unlimited",
    "unl_bw_tiers": "std",
    "country": "us",
    "ips": 10
  }
}
```

## Residential proxy zone

<Warning>
  **New Residential zones require KYC approval.** For Residential zones created after July 7, 2026, adding a zone is available only to KYC-verified companies. A request from an account that has not completed KYC is blocked and returns HTTP 403 with a compliance error. Residential zones created on or before July 7, 2026 are unaffected and continue to work as expected. Start at [KYC verification](https://brightdata.com/cp/kyc) and see the [Residential network access policy](/products/residential/network-access).
</Warning>

Creating any Residential proxy type (shared rotating, IPv6 or dedicated) after July 7, 2026 requires KYC approval by the Bright Data compliance team. There is no automatic or no-KYC path for these new zones. Without KYC, create an [ISP](/products/isp/introduction) or [Datacenter](/products/data-center/introduction) zone instead.

### Dedicated Residential (gIP) zone

A dedicated Residential zone allocates a gIP (group of IPs) that is exclusive to a fixed list of target domains. Create one by setting `vips_type: "domain"` and including `domain_whitelist`.

<Warning>
  Dedicated Residential gIPs are **domain-restricted**. You must set `vips_type: "domain"` and include `domain_whitelist` (a space-separated list of target domains). `vip_country` applies only to dedicated zones. For a shared zone, set the country with the `-country` username flag instead. Country codes must be **lowercase** (e.g. `us`, `gb`).
</Warning>

The following payload creates a dedicated Residential zone with one US gIP scoped to `example.com`. This payload was verified working on July 9, 2026.

```json theme={null}
{
  "zone": { "name": "my_dedicated_resi_zone", "type": "resident" },
  "plan": {
    "type": "resident",
    "vips_type": "domain",
    "vips": 1,
    "vip_country": "us",
    "domain_whitelist": "example.com"
  }
}
```

The allocated gIP is exclusive to the domains listed in `domain_whitelist`. Requests to any other domain are routed through Bright Data's shared Datacenter proxies.

### Shared Residential country targeting

For shared Residential zones, country is not set with `vip_country`. Target countries at request level with the `-country-<code>` flag in the proxy username (for example `-country-us`), or set default countries in the control panel. See [How to configure your Residential proxy](/products/residential/configure-your-proxy).

### Dedicated Residential gIP errors

An invalid dedicated Residential (gIP) payload returns one of the following errors.

| Error | Cause | How to fix |
| :- | :- | :- |
| `Can't allocate required amount of gIPs. Dedicated gIPs are only supported with "vips_type": "domain" together with a "domain_whitelist"` | Wrong `vips_type` value | Set `vips_type: "domain"` |
| `Can't allocate required amount of gIPs. Target domains ("domain_whitelist") are required to allocate dedicated gIPs` | Missing `domain_whitelist` | Add `domain_whitelist` with your target domain(s) |

### Residential 403 compliance errors

For Residential zones created after July 7, 2026, an Add-a-Zone request from an account that is not eligible returns HTTP 403 with one of the following compliance errors. Zones created on or before July 7, 2026 are not affected. See the [proxy errors catalog](/proxy-networks/errorCatalog#http-error-403) for the full catalog.

| Error code | When it fires | How to fix |
| :- | :- | :- |
| `kyc_required` | A company-email account that has not completed KYC. | Start [KYC verification](https://brightdata.com/cp/kyc). A human compliance reviewer approves Residential access. |
| `business_account_required` | A personal-email account (not a verified company). | Use a corporate email and contact the Bright Data team to establish business eligibility. Personal-email accounts are not eligible for Residential. |

Each error returns a structured JSON body so integrations can branch on the stable `code` value. A company-email account without KYC receives `kyc_required`:

```json theme={null}
{
  "error": {
    "code": "kyc_required",
    "message": "Residential proxies are available to verified companies only, after KYC review, in accordance with Bright Data's compliance policy.",
    "action": "Start verification at brightdata.com/cp/kyc. Applications are reviewed by our compliance team.",
    "alternatives": [
      { "product": "ISP proxy", "plan": { "type": "static", "pool_ip_type": "static_res", "ips_type": "shared" } },
      { "product": "Web Unlocker API", "plan": { "type": "unblocker" } }
    ],
    "docs": "https://docs.brightdata.com/compliance/kyc"
  }
}
```

A personal-email account receives `business_account_required`, which does not offer KYC because personal accounts are not eligible:

```json theme={null}
{
  "error": {
    "code": "business_account_required",
    "message": "Residential proxies are available to verified companies only. Eligibility requires a corporate email and full verification with the Bright Data team.",
    "action": "Contact the Bright Data team with a corporate email to determine business eligibility for Residential access.",
    "alternatives": [
      { "product": "ISP proxy", "plan": { "type": "static", "pool_ip_type": "static_res", "ips_type": "shared" } },
      { "product": "Web Unlocker API", "plan": { "type": "unblocker" } }
    ],
    "docs": "https://docs.brightdata.com/compliance/kyc"
  }
}
```

Both bodies include an `alternatives` array with the exact `plan` objects to create a no-KYC [ISP](/products/isp/introduction) or [Web Unlocker API](/products/web-unlocker/introduction) zone instead. To create the ISP zone, send `POST /zone` with that `plan` object in place of the Residential one.


# Change account status
Source: https://docs.brightdata.com/api-reference/account-management-api/Change_account_status

api-reference/openapi PUT /status
Use the Bright Data Account Management API to change Account Status. PUT /status returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Cost breakdown export
Source: https://docs.brightdata.com/api-reference/account-management-api/Export_cost_breakdown

api-reference/openapi POST /costs/export/json
Export account cost data by dimension (products, APIs, datasets, Web Scraper APIs). Same source as Cost Explorer. JSON or CSV per-day, 200 OK on success.

This endpoint exports the same per-day, per-resource cost breakdown that the Control Panel's Cost Explorer displays, in JSON or CSV, grouped by the dimension you pick (products, zones, datasets, Web Scraper APIs, collectors, domains, dataset snapshots, or WSA snapshots).

<Warning>
  **The `to` parameter is exclusive.** The day specified in `to` is **not** included in the result. To match a calendar month shown in the Control Panel or on your invoice, set `to` to the first day of the **following** month. For example, `from=2026-04-01&to=2026-05-01` returns all of April 2026.
</Warning>

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## When to use this endpoint

Use this endpoint when you need cost data that `GET /zone/cost` cannot return. The `/zone/cost` endpoint is scoped to a single zone, which means it cannot break down Web Scraper API costs (those are keyed by `dataset_id`, not by zone name) and it cannot answer questions like "What did I spend on datacenter and unlocker proxies combined last month?".

This endpoint accepts a `dimension` parameter that groups costs by the same buckets the Control Panel Cost Explorer uses.

| Dimension | Groups costs by |
| - | - |
| `products` | Product family (datacenter, residential, ISP, mobile, unlocker, SERP API, Browser API, and so on) |
| `types` | Network or charge type |
| `zones` | Individual zones in your account |
| `datasets` | Dataset Marketplace dataset purchases |
| `web_apis` | Web Scraper API `dataset_id`s |
| `collectors` | Scraper Studio collectors |
| `domains` | Target domains |
| `ws_api_snaps` | Web Scraper API snapshots |
| `snapshots` | Dataset snapshots |

The dimensions match what you see in the Cost Explorer UI, so the simplest way to discover what each dimension returns is to open Cost Explorer in the Control Panel and switch the grouping.

## Reproduce your monthly invoice for a dimension

To retrieve the full monthly cost broken down by Web Scraper API datasets for April 2026:

```bash theme={null}
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dimension": "web_apis",
    "filters": {},
    "from": "2026-04-01",
    "to": "2026-05-01"
  }' \
  "https://api.brightdata.com/costs/export/json"
```

Response shape (one entry per day; each day maps resource ID to billed USD):

```json theme={null}
{
  "2026-04-01": {
    "gd_l1viktl72bvl7bjuj0": 45.20,
    "gd_l1vikfnt1wgvvqz95w": 12.80
  },
  "2026-04-02": {
    "gd_l1viktl72bvl7bjuj0": 38.10
  }
}
```

For the same data as CSV, call `POST /costs/export/csv` with the identical request body. The CSV pivots the response into one row per day with one column per resource ID that appears in the date range, so column count varies with the data:

```csv theme={null}
Day,gd_l1viktl72bvl7bjuj0,gd_l1vikfnt1wgvvqz95w
2026-04-01,45.20,12.80
2026-04-02,38.10,0
```

## Using the `filters` field

The `filters` object uses Bright Data's internal charges-structure notation, the same notation used by Cost Explorer. Building a filter from scratch requires knowledge of that structure. Most callers leave `filters` empty (`{}`) and rely on the `dimension` parameter to scope the response.

One working example, restricting the result to datacenter and Web Unlocker products:

```json theme={null}
{
  "props": {
    "product": {
      "whitelist": ["dc", "unblocker"]
    }
  }
}
```

If you need a filter that the dimension alone cannot express, contact Bright Data support with the question you are trying to answer. We do not currently publish a complete filter grammar; support can build the filter you need or confirm that no filter is required.

## Rate limits

* 1,000 requests per minute
* 5,000 requests per hour

The endpoint accepts any API key with cost-data access. There is no separate billing-admin scope.

## Reconciling with raw request logs

The values returned by this endpoint are the source of truth for billing. They match the Control Panel's Cost Explorer and Usage Overview, and they roll up into your invoice. If you compare these values against raw request logs you collect yourself (for example, access logs forwarded to Logz or CloudWatch), expect differences of a few percent. Raw logs may capture requests that were never committed to the billing database because of async aggregation timing or transient network issues. Your invoice always reflects the values returned by this endpoint.

## Related endpoints

* [Total cost & bandwidth for a zone](/api-reference/account-management-api/Get_the_total_cost_and_bandwidth_stats_for_a_Zone). Single-zone cost and bandwidth over a date range. Cannot return Web Scraper API or Scraper Studio cost.
* [Bandwidth stats for a zone](/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone). Bandwidth only, no cost.
* [Bandwidth stats for all your Zones](/api-reference/account-management-api/Get_the_bandwidth_stats_for_all_your_Zones). Aggregate bandwidth across zones.
* [Get pricing plans](/api-reference/account-management-api/Get_pricing_plans). Your current pricing plan and available plans, with per-product prices.


# Zone info
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_info

api-reference/openapi GET /zone
Use the Bright Data Account Management API to zone info. GET /zone returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Zone permission
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_permissions

api-reference/openapi GET /zone/permissions
Use the Bright Data Account Management API to zone Permission. GET /zone/permissions returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Zone status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_status

api-reference/openapi GET /zone/status
Use the Bright Data Account Management API to zone status. GET /zone/status returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Account status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_account_status

api-reference/openapi GET /status
Use the Bright Data Account Management API to account status. GET /status returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Active zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_active_Zones

api-reference/openapi GET /zone/get_active_zones
Use the Bright Data Account Management API to active Zones. GET /zone/get_active_zones returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Get current service status
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_current_service_status

api-reference/openapi GET /network_status/{NETWORK_TYPE}
Use the Bright Data Account Management API to get current service status via GET /network_status/{NETWORK_TYPE}, returning a 200 OK JSON response.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Get pricing plans
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_pricing_plans

api-reference/openapi GET /pricing_plans
Use GET /pricing_plans in the Bright Data Account Management API to list current and available pricing plans with per-product prices. Returns 200 OK as JSON.

The `GET /pricing_plans` endpoint returns your account's current pricing plan and the other plans available to your account, with the per-product prices of each plan. All prices are in USD.

<Tip>
  Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## Which API key permission does this endpoint need?

`GET /pricing_plans` requires the `billing.read` permission. API keys with the **Admin** or **Finance** [permission level](/api-reference/authentication#what-permissions-level-does-an-api-key-have) have it. Keys with the Ops, Limit or User permission level cannot call this endpoint.

## How do I get my current pricing plan?

Call `GET /pricing_plans` with an Admin or Finance API key. The endpoint takes no parameters:

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.brightdata.com/pricing_plans"
```

The response contains a `plans` array. Your current plan is the entry where `is_current` is `true`. To print only that plan, filter the response with [jq](https://jqlang.org/):

```bash theme={null}
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.brightdata.com/pricing_plans" \
  | jq '.plans[] | select(.is_current)'
```

## How is the response structured?

Each entry in the `plans` array describes one plan:

| Field | Type | Description |
| - | - | - |
| `id` | string | Plan identifier |
| `name` | string | Plan name |
| `precommit` | number | Monthly pre-commitment of the plan, in USD |
| `is_current` | boolean | `true` for the plan your account is on now, `false` for the other available plans |
| `product_prices` | object | Prices of the plan, keyed by internal product key |

The keys of `product_prices` are the same internal product keys that the [cost breakdown export](/api-reference/account-management-api/Export_cost_breakdown) uses in its filters, such as `dc` (Datacenter proxies) and `res_static` (ISP proxies). Each value holds a product `name` and a `price_groups` array. Each price group has a `name`, a `prices` object and, for some products, an `unlim_ip_tier_prices` object.

## How do I read the prices object?

Each key in `prices` is a billing unit and each value is the price in USD for one unit. For example, `"prices": {"gb": 8}` means \$8 per GB.

| Key | Billing unit |
| - | - |
| `gb` | 1 GB of traffic |
| `req` | 1,000 requests (CPM), not a single request |

The other possible keys are `compute_hour`, `record`, `total`, `files_archive`, `files_cache`, `req_content`, `block` and `page_load`. Which keys appear depends on the product.

## Which products return unlim\_ip\_tier\_prices?

Only Datacenter proxies (`dc`) and ISP proxies (`res_static`) return `unlim_ip_tier_prices`. The object maps each IP tier size to its price in USD.

## Does the endpoint have rate limits or specific errors?

No. `GET /pricing_plans` has no endpoint-specific rate limit and no endpoint-specific error codes.

## Related endpoints

* [Cost breakdown export](/api-reference/account-management-api/Export_cost_breakdown). Per-day account cost by product, zone, dataset or scraper.
* [Total balance](/api-reference/account-management-api/Get_total_balance_through_API). Account balance, free credits, prepayment and pending usage costs.


# Total balance
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_total_balance_through_API

api-reference/openapi GET /customer/balance
Use GET /customer/balance in the Bright Data Account Management API to get your account balance, free credits, prepayment and pending usage costs.

The `GET /customer/balance` endpoint returns your Bright Data account balance information: `balance`, `credit`, `prepayment` and `pending_costs`.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

## FAQ

### Is there an API endpoint for free-tier credit status?

No. No Account Management API endpoint returns your free-tier credit allowance, credits used, credits remaining or renewal date. To track free credits, check the Free credits card on the [Billing overview](https://brightdata.com/cp/billing/overview) page in the Control Panel, as described in [How do I monitor my free credit usage?](/general/account/billing-and-pricing/free-tier#how-do-i-monitor-my-free-credit-usage). To pull usage data through the API, use the [Cost breakdown export](/api-reference/account-management-api/Export_cost_breakdown) endpoint.

### Is there an API endpoint for auto-recharge status?

No. No Account Management API endpoint returns whether auto-recharge is enabled. Check and configure auto-recharge in [Billing settings](https://brightdata.com/cp/billing/settings) in the Control Panel. Auto-recharge requires a verified payment method on the account.


# Remove a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_Zone

api-reference/openapi DELETE /zone
Use the Bright Data Account Management API to remove a Zone. DELETE /zone returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Switch automatic failover
Source: https://docs.brightdata.com/api-reference/account-management-api/Switch_100_uptime_ON_OFF_in_a_Static_zone

api-reference/openapi POST /zone/switch_100uptime
Use the Bright Data Account Management API to switch Automatic Failover. POST /zone/switch_100uptime returns the requested zone or account configuration data.

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges. </Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# All zones
Source: https://docs.brightdata.com/api-reference/account-management-api/get-all-zones

api-reference/openapi GET /zone/get_all_zones
Use the Bright Data Account Management API to all Zones. GET /zone/get_all_zones returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Deliver snapshot to S3, Azure Blob or GCP
Source: https://docs.brightdata.com/api-reference/archive-api/deliver-to-cloud

api-reference/web-archive-api POST /webarchive/dump
Deliver a Bright Data Archive API snapshot to Amazon S3, Azure Blob Storage, Google Cloud Storage or a webhook. POST /webarchive/dump returns a dump_id.

`POST /webarchive/dump` delivers the snapshot from a completed search to Amazon S3, Azure Blob Storage, Google Cloud Storage or a webhook, and returns a `dump_id`.

<Note>
  To use S3 storage delivery, you will first need to do the following:

  * Create an [AWS role](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html) which gives Bright Data access to your system.
    * During this setup, you will be asked by Amazon for an “external ID” that is used with the role.
    * Your external ID for S3 is your Bright Data **Account ID** that can be found within [Account Settings](https://brightdata.com/cp/setting/customer_details)
  * Once a role is created, you will need to allow the Bright Data delivery role to `AssumeRole` that role.
    * The Bright Data delivery role is: `arn:aws:iam::422310177405:role/brd.ec2.zs-dca-delivery`
</Note>

<Note>
  To use Google Cloud Storage delivery, create a bucket and provide the required GCP delivery settings.
</Note>

<Warning>
  The **webhook** delivery strategy is **not suitable for large dumps** unless you
  are hosting the webhook on your own infrastructure. Third-party inspection
  tools such as [webhook.site](https://webhook.site) impose strict request body
  size limits and will fail to receive payloads that can reach up to **1 GB** in
  size. For large deliveries, use **Amazon S3**,  **Azure Blob Storage**
  or **Google Cloud Storage** instead.
</Warning>

<Note>
  **Common dump parameters:**

  * `search_id` (required): The search ID from a completed search
  * `max_entries` (optional): Limit the number of files to include in the dump
  * `delivery` (required): Delivery configuration (S3, Azure, GCP, or webhook)
</Note>

<Tip>
  If you’re running a linux/macos machine, you can simulate one of our delivery webhooks with the code on [this page](/products/archive/webhook-test).
</Tip>

## What causes a 400 response

`POST /webarchive/dump` returns HTTP 400 when the request body fails validation. The response carries an `error` summary and a `details` array naming each field that failed. Common causes:

* `search_id` is missing.
* `delivery` is missing.
* The `delivery.settings` block does not match the chosen `delivery.strategy`. Each strategy has its own required settings: `bucket` plus `assume_role` for Amazon S3, `bucket` for Google Cloud Storage, `container` plus `credentials` for Azure Blob Storage and `url` for a webhook.

Fix the field named in `details[].path` and resend the request.


# Get all search statuses
Source: https://docs.brightdata.com/api-reference/archive-api/get-all-search-statuses

api-reference/web-archive-api GET /webarchive/searches
Use the Bright Data Marketplace Archive API to get All Search Statuses. GET /webarchive/searches manages web archive snapshots; returns 200 OK with JSON status.

<Info>
  Starting **March 26, 2026**, the hot storage retention period changed from 48 hours to 24 hours.
</Info>


# Get the statuses of all data snapshots
Source: https://docs.brightdata.com/api-reference/archive-api/get-all-snapshots-statuses

api-reference/web-archive-api GET /webarchive/dumps
Use the Bright Data Marketplace Archive API to get statuses of all Data Snapshots. Manages web archive snapshots; returns 200 OK with JSON job status.



# Get search status
Source: https://docs.brightdata.com/api-reference/archive-api/get-search-status

api-reference/web-archive-api GET /webarchive/search/{search_id}
Use the Bright Data Marketplace Archive API to get Search Status. GET /webarchive/search/{search_id} returns 200 OK with archive search status JSON.

When successful it will retrieve:

* The number of entries for your query
* The estimated size and cost of the full Data Snapshot

<Note>
  **Pricing & size:** `estimate_batch_size` is measured in bytes. `dump_cost_usd` is an estimated total cost based on `files_count` and your current cache/archive pricing tier. The `cost_breakdown` object shows separate costs for cache vs archive pages.
</Note>


# Get status of data snapshot
Source: https://docs.brightdata.com/api-reference/archive-api/get-snapshot-status

api-reference/web-archive-api GET /webarchive/dump/{dump_id}
Use the Bright Data Marketplace Archive API to get Status of a Data Snapshot. Manages web archive snapshots; returns 200 OK with JSON job status.



# Run a search
Source: https://docs.brightdata.com/api-reference/archive-api/run-a-search

api-reference/web-archive-api POST /webarchive/search
Use the Bright Data Marketplace Archive API to run a Search. POST /webarchive/search manages web archive snapshots; returns 200 OK with JSON status.

`POST /webarchive/search` searches the Bright Data Archive and returns either the full search result object or a `search_id` you poll for status.

<Danger>
  **Every search needs a time range.** The `filters` object is required, and it must carry either `max_age`, or both `min_date` and `max_date`. A request with no `filters` object returns HTTP 400 with `"filters" is required`.
</Danger>

## How to set the search time range

Use `max_age` for a window relative to now. Write it as a number followed by a unit:

| Unit | Meaning | Example |
| - | - | - |
| `h` | Hours | `24h` |
| `d` | Days | `7d` |
| `mo` | Months | `3mo` |
| `y` | Years | `1y` |

Bright Data recommends `max_age` of `24h` for a first search, because recent data is delivered fastest.

```bash theme={null}
curl -X POST https://api.brightdata.com/webarchive/search \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "max_age": "24h",
      "domain_whitelist": ["example.com"]
    }
  }'
```

Use `min_date` and `max_date` for a fixed calendar range. Both dates use `YYYY-MM-DD` format and both must be sent together.

```bash theme={null}
curl -X POST https://api.brightdata.com/webarchive/search \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "min_date": "2026-08-01",
      "max_date": "2026-08-08",
      "domain_whitelist": ["example.com"]
    }
  }'
```

<Warning>
  Send one form or the other, never both. `max_age` combined with `min_date` and `max_date` in the same request is a conflict, and the results are undefined.
</Warning>

For date ranges older than 24 hours, use `min_date` and `max_date` rather than `max_age`. See [Data range vs delivery time](/products/archive/data-range-vs-delivery-time) for how the requested range affects delivery speed.

<Note>
  If the search takes longer than 30 seconds, the response returns only a `search_id` and you should poll the status asynchronously. If the search completes within 30 seconds, the response returns the full search result object (same as `GET /webarchive/search/<search_id>`).
</Note>

<Note>
  You can run up to 100 searches per day without triggering a dump.
  Once you trigger a dump, that search no longer counts against your limit.
</Note>

<Accordion title="LIKE vs Regex Filters">
  * Use LIKE filters (`domain_like_*`, `url_like_*`) for simple pattern matching with `%` (any sequence) and `_` (single character).
  * LIKE patterns are case-insensitive and often faster than regex for simple prefix/suffix matching like `%.com` or `amazon%`.
  * Use regex filters (`domain_regex_*`, `url_regex_*`) for complex patterns requiring full regex syntax. LIKE patterns use backslash escaping: `\%` for literal `%`, `\_` for literal `_`.
</Accordion>


# Business Search API: search companies
Source: https://docs.brightdata.com/api-reference/business-search/search-company

api-reference/business-search/business-search-api POST /search/company
Search companies with the Business Search API. The endpoint queries linkedin_company in 3 modes and returns up to 100 records per page.

`POST /search/company` returns company records that match your conditions.

Related: [Company search](/products/business-search/company-search) for worked examples and company field guidance, [Business Search query syntax](/products/business-search/query-syntax) for the structured query operators and [Business Search field views](/products/business-search/select-fields) for the fields each `view` value returns.


# Business Search API: search people
Source: https://docs.brightdata.com/api-reference/business-search/search-people

api-reference/business-search/business-search-api POST /search/people
Search profiles with the Business Search API. The endpoint queries linkedin_people in 3 modes and returns up to 100 records per page.

`POST /search/people` returns professional profile records that match your conditions.

Related: [People search](/products/business-search/people-search) for worked examples and people field guidance, [Business Search query syntax](/products/business-search/query-syntax) for the structured query operators and [Business Search field views](/products/business-search/select-fields) for the fields each `view` value returns.


# Add a user
Source: https://docs.brightdata.com/api-reference/proxy-manager/add_a_user

Use the Bright Data Proxy Manager API to add a User. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

**API endpoint:** `POST` `/api/lpm_user`

## `POST` body

<ParamField type="string">
  User email address to add
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/lpm_user" -H "Content-Type: application/json" -d '{"email":"test@example.com"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node
  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/lpm_user', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'email':'test@example.com'}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;
  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
   public static void main(String[] args) throws Exception {

   String body = "{\"email\":\"test@example.com\"}";

   String res = Executor.newInstance()
   .execute(Request.Post("http://127.0.0.1:22999/api/lpm_user")
   .bodyString(body, ContentType.APPLICATION_JSON))
   .returnContent().asString();
   
   System.out.println(res)

   }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
   public static async Task Main() {

   var client = new HttpClient();

   var requestMessage = new HttpRequestMessage {

   Method = HttpMethod.Post,

   RequestUri = new Uri("http://127.0.0.1:22999/api/lpm_user"),

   Content = new StringContent(JsonConvert.SerializeObject(new {

   email = "test@example.com"

   }), Encoding.UTF8, "application/json")

   };

   var response = await client.SendAsync(requestMessage);

   var responseString = await response.Content.ReadAsStringAsync();

   Console.WriteLine(responseString);

   }

  }

  ```

  ```python Python theme={null}
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json

  data = {'email':'test@example.com'}
  r = requests.post('http://127.0.0.1:22999/api/lpm_user', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Allowlist IPs
Source: https://docs.brightdata.com/api-reference/proxy-manager/allowlist-ips

Use the Bright Data Proxy Manager API to allowlist IPs. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

**API endpoint:** `PUT` `/api/wip`

<ParamField type="string">
  API key
  <Tip>API key should be generated using [Generate API key](/api-reference/proxy-manager/generate_token_for_token_based_authentication)</Tip>
</ParamField>

## `PUT` body

<ParamField type="string">
  IP to allowlist. e.g, `ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/wip" -H "Authorization: API key" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/wip', {
      method: 'PUT',
      headers: { 'Authorization': 'API key', 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2'}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;

  public class Example {
    public static void main(String[] args) throws Exception {
      String body = "{\"ip\":\"1.2.1.2\"}";
      String res =Executor.newInstance()
        .addHeader("Authorization", "API key")
        .execute(Request.Put("http://127.0.0.1:22999/api/wip")
        .bodyString(body, ContentType.APPLICATION_JSON))
        .returnContent()
        .asString();

      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Put,
        RequestUri = new Uri("http://127.0.0.1:22999/api/wip"),
        Headers = {{"Authorization", "API key"}},
        Content = new StringContent(JsonConvert.SerializeObject(new {
          ip = "1.2.1.2"
        }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import json
  import requests


  data = {'ip':'1.2.1.2'}
  headers = {'Authorization': 'API key'}

  r = requests.put(
    'http://127.0.0.1:22999/api/wip',
    data=json.dumps(data),
    headers=headers
  )

  print(r.content)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  Successful response
  ```

  ```json 400 theme={null}
  Bad request. No IP was passed
  ```

  ```json 403 theme={null}
  Forbidden. No authentication provided
  ```

  ```json 422 theme={null}
  Unprocessable entity. Invalid IP was passed
  ```
</ResponseExample>


# Ban an IP (all ports)
Source: https://docs.brightdata.com/api-reference/proxy-manager/ban_an_ip_for_all_ports

Use the Bright Data Proxy Manager API to ban an IP (All Ports). Calls POST /api/banip on the local Proxy Manager port 22999.

API endpoint: `POST` `/api/banip`

## `POST` body

<ParamField type="string">
  IP to ban. e.g. `1.2.1.2`
</ParamField>

<ParamField type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/banip" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2","domain":"example.com","ms":60000}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/banip', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2','domain':'example.com','ms':60000}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

   public static void main(String[] args) throws Exception {

    String body = "{\"ip\":\"1.2.1.2\",\"domain\":\"example.com\",\"ms\":60000}";

    String res = Executor.newInstance()

     .execute(Request.Post("http://127.0.0.1:22999/api/banip")

     .bodyString(body, ContentType.APPLICATION_JSON))

     .returnContent().asString();

   

    System.out.println(res)

   }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

   public static async Task Main() {

    var client = new HttpClient();

    var requestMessage = new HttpRequestMessage {

     Method = HttpMethod.Post,

     RequestUri = new Uri("http://127.0.0.1:22999/api/banip"),

     Content = new StringContent(JsonConvert.SerializeObject(new {

      ip = "1.2.1.2",

      domain = "example.com",

      ms = 60000

     }), Encoding.UTF8, "application/json")

    };

    var response = await client.SendAsync(requestMessage);

    var responseString = await response.Content.ReadAsStringAsync();

    Console.WriteLine(responseString);

   }

  }

  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json


  data = {'ip':'1.2.1.2','domain':'example.com','ms':60000}
  r = requests.post('http://127.0.0.1:22999/api/banip', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Ban an IP
Source: https://docs.brightdata.com/api-reference/proxy-manager/ban_an_ip_single_

Use the Bright Data Proxy Manager API to ban an IP. Calls POST /api/proxies/{PORT}/banip on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/banip`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField type="string">
  IP to ban. e.g. `1.2.1.2`
</ParamField>

<ParamField type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/banip" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2","domain":"example.com","ms":60000}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/banip', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2','domain':'example.com','ms':60000}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
     String body = "{\"ip\":\"1.2.1.2\",\"domain\":\"example.com\",\"ms\":60000}";
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/banip")
       .bodyString(body, ContentType.APPLICATION_JSON))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/banip"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         ip = "1.2.1.2",
         domain = "example.com",
         ms = 60000
       }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
  import requests
  import json


  data = {'ip':'1.2.1.2','domain':'example.com','ms':60000}
  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/banip', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Ban multiple IPs (array)
Source: https://docs.brightdata.com/api-reference/proxy-manager/ban_ips_array_

Use the Bright Data Proxy Manager API to ban multiple IPs (array). Endpoint: POST /api/proxies/{PORT}/banips on port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/banips`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField type="array">
  IPs to ban. e.g. \["10.0.0.1","20.0.0.1"]
</ParamField>

<ParamField type="string">
  Ban the IP for sending requests to the specified domain
</ParamField>

<ParamField type="integer">
  Ban the IP for specified milliseconds
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/banips" -H "Content-Type: application/json" -d '{"ips":["10.0.0.1","20.0.0.1"],"domain":"example.com","ms":60000}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node
  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/banips', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ips':['10.0.0.1','20.0.0.1'],'domain':'example.com','ms':60000}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String body = "{\"ips\":[\"10.0.0.1\",\"20.0.0.1\"],\"domain\":\"example.com\",\"ms\":60000}";
      String res = Executor.newInstance()
          .execute(Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/banips")
          .bodyString(body, ContentType.APPLICATION_JSON))
          .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/banips"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         ips = [ "10.0.0.1","20.0.0.1" ],
         domain = "example.com",
         ms = 60000
       }), Encoding.UTF8, "application/json")
      };
      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseString);

    }
  }

   
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json


  data = {'ips':['10.0.0.1','20.0.0.1'],'domain':'example.com','ms':60000}
  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/banips', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Create new proxy port
Source: https://docs.brightdata.com/api-reference/proxy-manager/create_a_new_proxy_port

Use the Bright Data Proxy Manager API to create new Proxy Port. Calls POST /api/proxies on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/proxies`

## `POST` body

<ParamField type="User Object">
  <Expandable title="properties">
    <ParamField type="integer">
      Port for the HTTP proxy
    </ParamField>

    <ParamField type="string">
      Set to `persist` to save proxy into the configuration file.
    </ParamField>

    <ParamField type="integer">
      Multiply the port definition given number of times
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="array">
      List of `user`s `[string]`. This option has to be used along with `multiply_users`
    </ParamField>

    <ParamField type="boolean">
      Enable SSL analyzing
    </ParamField>

    <ParamField type="string">
      Choose the SSL library

      | value | description |
      | - | - |
      | `open_ssl` | Open SSL Library |
      | `flex_tls` | Flex TLS Library |
    </ParamField>

    <ParamField type="string">
      Interface or IP to listen on
    </ParamField>

    <ParamField type="string">
      Customer name
    </ParamField>

    <ParamField type="string">
      Zone name
    </ParamField>

    <ParamField type="string">
      Zone password
    </ParamField>

    <ParamField type="string">
      Hostname or IP of super proxy
    </ParamField>

    <ParamField type="integer">
      Super proxy port
    </ParamField>

    <ParamField type="string">
      Determines what kind of connection will be used between Proxy Manager and Super Proxy

      | | |
      | - | - |
      | `http` | |
      | `https` | |
      | `socks` | |
    </ParamField>

    <ParamField type="integer">
      Automatically retry on super proxy failure
    </ParamField>

    <ParamField type="boolean">
      Enable SSL connection/analyzing to insecure hosts
    </ParamField>

    <ParamField type="string">
      Country
    </ParamField>

    <ParamField type="string">
      State
    </ParamField>

    <ParamField type="string">
      City
    </ParamField>

    <ParamField type="string">
      ASN
    </ParamField>

    <ParamField type="string">
      Data Center IP
    </ParamField>

    <ParamField type="integer">
      gIP
    </ParamField>

    <ParamField type="array">
      A list of proxies from external vendors. Format: \[username:password@]ip\[:port]

      * proxy\[string]
    </ParamField>

    <ParamField type="string">
      Default username for external vendor ips
    </ParamField>

    <ParamField type="string">
      Default password for external vendor ips
    </ParamField>

    <ParamField type="integer">
      Default port for external vendor ips
    </ParamField>

    <ParamField type="string">
      DNS resolving

      | | |
      | - | - |
      | `local` | |
      | `remote` | |
    </ParamField>

    <ParamField type="boolean">
      Process reverse lookup via DNS
    </ParamField>

    <ParamField type="string">
      Process reverse lookup via file
    </ParamField>

    <ParamField type="array">
      Process reverse lookup via value
    </ParamField>

    <ParamField type="string">
      Session for all proxy requests
    </ParamField>

    <ParamField type="boolean">
      Use session per requesting host to maintain IP per host
    </ParamField>

    <ParamField type="integer" />

    <ParamField type="boolean">
      Session pool size
    </ParamField>

    <ParamField type="integer">
      Throttle requests above given number
    </ParamField>

    <ParamField type="array">
      Proxy request rules
    </ParamField>

    <ParamField type="string">
      Block or allow requests to be automatically sent through super proxy on error
    </ParamField>

    <ParamField type="array" />

    <ParamField type="string" />

    <ParamField type="string">
      Operating System of the Peer IP
    </ParamField>

    <ParamField type="array">
      Request headers
    </ParamField>

    * name\[string]
    * value\[string]

    <ParamField type="string">
      Request debug info

      | | |
      | - | - |
      | `full` | |
      | `none` | |
    </ParamField>

    <ParamField type="string">
      x-lpm-authorization header
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="boolean" />

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="string" />

    <ParamField type="boolean">
      Unblocker Mobile UA
    </ParamField>

    <ParamField type="string">
      Timezone ID to be used by the browser
    </ParamField>

    <ParamField type="string">
      Browser screen size
    </ParamField>

    <ParamField type="string">
      WebRTC plugin behavior in the browser
    </ParamField>

    <ParamField type="object">
      BW limit params

      * days \[integer]
      * bytes \[integer]
      * renewable\[boolean] - Renew limit of bytes each period or use single period and stop usage once last day of period is reached. Default is true
    </ParamField>
  </Expandable>
</ParamField>

<ParamField type="boolean" />

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
  	"port":24000,
  	"zone":"zone_name",
  	"proxy_type":"persist",
  	"customer":"customer_id",
  	"password":"password",
  	"whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies" -H "Content-Type: application/json" -d '{"proxy":{"port":24000,"zone":"ZONE","proxy_type":"persist","customer":"CUSTOMER","password":"password","whitelist_ips":[]}}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
     String body = "{\"proxy\":{\"port\":24000,\"zone\":\"ZONE\",\"proxy_type\":\"persist\",\"customer\":\"CUSTOMER\",\"password\":\"password\",\"whitelist_ips\":[]}}";
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/proxies")
       .bodyString(body, ContentType.APPLICATION_JSON))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```
</RequestExample>


# Delete a proxy port
Source: https://docs.brightdata.com/api-reference/proxy-manager/delete_a_proxy_port

Use the Bright Data Proxy Manager API to delete a Proxy Port. Calls DELETE /api/proxies/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `DELETE` `/api/proxies/{PORT}`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl -X DELETE "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}', {
      method: 'DELETE',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Delete("http://127.0.0.1:22999/api/proxies/{PORT}"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Delete,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.delete('http://127.0.0.1:22999/api/proxies/{PORT}')

  print(r.content)

  ```
</RequestExample>


# Delete proxy ports (multiple)
Source: https://docs.brightdata.com/api-reference/proxy-manager/delete_proxy_ports

Bright Data Proxy Manager API endpoint to delete Proxy Ports (multiple). Endpoint: POST /api/proxies/delete on port 22999.

**API endpoint:** `POST /api/proxies/delete`

## `POST` body

<ParamField type="array">
  Array of ports
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/delete" -H "Content-Type: application/json" -d '{"ports":[24000,24001]}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/delete', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'ports':[24000,24001]}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"ports\":[24000,24001]}";

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/proxies/delete")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/delete"),

       Content = new StringContent(JsonConvert.SerializeObject(new {

         ports = [ 24000, 24001 ]

       }), Encoding.UTF8, "application/json")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json


  data = {'ports':[24000,24001]}

  r = requests.post('http://127.0.0.1:22999/api/proxies/delete', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Enable SSL analyzing (all ports)
Source: https://docs.brightdata.com/api-reference/proxy-manager/enable_ssl_analyzing_on_all_proxy_ports

Bright Data Proxy Manager API endpoint to enable SSL Analyzing (All Ports). Endpoint: POST /api/enable_ssl on port 22999.

**API endpoint:** `POST` `/api/enable_ssl`

<RequestExample>
  ```sh theme={null}
  curl -X POST "http://127.0.0.1:22999/api/enable_ssl"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/enable_ssl', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/enable_ssl"))
       .returnContent().asString();
      System.out.println(res)
    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/enable_ssl")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.post('http://127.0.0.1:22999/api/enable_ssl')

  print(r.content)
  ```
</RequestExample>


# Generate API key
Source: https://docs.brightdata.com/api-reference/proxy-manager/generate_token_for_token_based_authentication

Generate a Bright Data Proxy Manager API key for token-based authentication. Endpoint: GET /api/gen_token on port 22999.

**API endpoint:** `GET` `/api/gen_token`

<ResponseExample>
  ```json Sample Response theme={null}
  {
      "token": "RZD9vaQQaL6En7"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/gen_token"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/gen_token');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/gen_token"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {

          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/gen_token")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();

          Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/gen_token')

  print(r.content)
  ```
</RequestExample>


# Get all users
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_all_users

Use the Bright Data Proxy Manager API to get all users. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

**API endpoint:** `GET` `/api/lpm_users`

<ResponseExample>
  ```JSON Sample Response theme={null}
  [
      {
          "email": "test@example.com",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/lpm_users"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/lpm_users');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
      public static void main(String[] args) throws Exception {
      String res = Executor.newInstance().execute(
          Request.Get("http://127.0.0.1:22999/api/lpm_users")
      ).returnContent().asString();

      System.out.println(res)
  }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {

          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/lpm_users")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();

          Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/lpm_users')

  print(r.content)
  ```
</RequestExample>


# Get allocated gIPs in a zone
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_allocated_gips_in_zone

Bright Data Proxy Manager API endpoint to get allocated gIPs in a zone. Endpoint: GET /api/allocated_vips on port 22999.

**API endpoint:** `GET` `/api/allocated_vips`

## Query Parameter

<ParamField type="string">
  Residential/Mobile exclusive zone name
</ParamField>

<ResponseExample>
  ```json Sample Response theme={null}
  {
      "ips": [
          "gIP_1",
          "gIP_2"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/allocated_vips?zone=ZONE"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/allocated_vips?zone=ZONE');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/allocated_vips?zone=ZONE"))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Get,
       RequestUri = new Uri("http://127.0.0.1:22999/api/allocated_vips?zone=ZONE")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/allocated_vips?zone=ZONE')

  print(r.content)
  ```
</RequestExample>


# Get allocated IPs in a zone
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_allocated_ips_in_zone

Use the Bright Data Proxy Manager API to get allocated IPs in a zone. Calls GET /api/allocated_ips on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/allocated_ips`

## Query Parameter

<ParamField type="string">
  Static (Datacenter/ISP) zone name
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "ips": [
          "10.0.0.1",
          "20.0.0.1"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/allocated_ips?zone=ZONE"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/allocated_ips?zone=ZONE');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/allocated_ips?zone=ZONE"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/allocated_ips?zone=ZONE")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }

  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/allocated_ips?zone=ZONE')

  print(r.content)
  ```
</RequestExample>


# Get banned IPs
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_banned_ips

Use the Bright Data Proxy Manager API to get Banned IPs. Calls GET /api/banlist/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/banlist/{PORT}`

<ParamField type="boolean">
  `full=true` parameter is optional and can be used to provide additional details about each entry in the ban-list
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "ips": [
          "10.20.30.40",
          "50.60.70.80|example.com"
      ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/banlist/{PORT}?full=true"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/banlist/{PORT}?full=true');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/banlist/{PORT}?full=true"))
       .returnContent().asString();
      System.out.println(res)
    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/banlist/{PORT}?full=true")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/banlist/{PORT}?full=true')

  print(r.content)
  ```
</RequestExample>


# Get current NodeJS version
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_currently_running_nodejs_version

Use the Bright Data Proxy Manager API to get current NodeJS version. Calls GET /api/node_version on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/node_version`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "current": {
          "options": {
              "loose": false,
              "includePrerelease":false
          },
          "loose": false,
          "raw":"v12.16.1\n",
          "major":12,
          "minor":16,
          "patch":1,
          "prerelease":[],
          "build":[],
          "version":"12.16.1"
      },
      "satisfied": true,
      "recommended": ">=10.0"
  }
  ```
</ResponseExample>


# Get effective config of running proxies
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_effective_configuration_for_all_running_proxies

Bright Data Proxy Manager API endpoint to get effective config of running proxies. Endpoint: GET /api/proxies_running on port 22999.

**API endpoint:** `GET` `/api/proxies_running`

<ResponseExample>
  ```JSON Sample Response theme={null}
  [
      {
          "port": 24000,
          "zone": "ZONE",
          "proxy_type": "persist",
          "customer": "CUSTOMER",
          "password": "password",
          "whitelist_ips":[]
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies_running"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies_running');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/proxies_running"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Get,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies_running")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/proxies_running')

  print(r.content)
  ```
</RequestExample>


# Get enabled zone's configuration
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_enabled_zones_configuration

Bright Data Proxy Manager API endpoint to get enabled Zone's configuration. Calls GET /api/zones on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/zones`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "name": "ZONE",
      "perm": "country ip route_all route_dedicated",
      "plan": {},
      "password":"password"
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/zones"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/zones');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/zones"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {
          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/zones")
          };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python


  import requests


  r = requests.get('http://127.0.0.1:22999/api/zones')

  print(r.content)
  ```
</RequestExample>


# Get explicit config of proxies
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_explicit_configuration_of_all_or_specified_proxies

Bright Data Proxy Manager API endpoint to get explicit config of proxies. Endpoint: GET /api/proxies/{PORT} on port 22999.

**API endpoint:** `GET` `/api/proxies/{PORT}`

<ParamField type="string">
  PORT parameter is optional. You can skip it to fetch all the proxies\*
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  [
      {"port": 24000,
      "zone": "ZONE",
      "proxy_type": "persist",
      "customer": "CUSTOMER",
      "password": "password",
      "whitelist_ips": []
      },
      {
          "port": 44445,
          "zone": "ZONE",
          "listen_port": 44445,
          "customer": "CUSTOMER",
          "password":"password"
      }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/proxies/{PORT}"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/proxies/{PORT}')

  print(r.content)
  ```
</RequestExample>


# Get general settings
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_general_settings

Use the Bright Data Proxy Manager API to get general settings. Calls GET /api/settings on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/settings`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "customer": "CUSTOMER",
      "zone": "ZONE",
      "password": "password",
      "www_whitelist_ips": [],
      "whitelist_ips": [],
      "fixed_whitelist_ips": [],
      "read_only": false,
      "config": "/home/user/proxy_manager/.luminati.json",
      "test_url":"http://brdtest.com/myip.json",
      "logs":1000,
      "log":"notice",
      "har_limit": 1024,
      "request_stats": true,
      "dropin": true,
      "pending_ips": [],
      "pending_www_ips": [],
      "zagent": false,
      "sync_config": true
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/settings"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/settings');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;
   

  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/settings"))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/settings")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/settings')

  print(r.content)
  ```
</RequestExample>


# Get HAR logs
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_har_logs

Use the Bright Data Proxy Manager API to get HAR Logs. Updates the local Proxy Manager (default port 22999) configuration and returns a JSON status.

API endpoint: `GET` `/api/logs`

<ParamField type="integar">
  Number of logs to get from tail
</ParamField>

<ParamField type="integar">
  Number of logs to get from tail
</ParamField>

<ParamField type="integar">
  Maximum number of requests to be fetched
</ParamField>

<ParamField type="string">
  regex search query for the URL
</ParamField>

<ParamField type="string">
  lower bound for port number
</ParamField>

<ParamField type="string">
  upper bound for port number
</ParamField>

<ParamField type="string">
  filter requests by status code
</ParamField>

<ParamField type="string">
  parameter to be sorted by
</ParamField>

<ParamField type="boolean">
  is descending sorting direction
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/logs"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/logs');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
    public static void main(String[] args) throws Exception {
      String res = Executor.newInstance()
       .execute(Request.Get("http://127.0.0.1:22999/api/logs"))
       .returnContent().asString();
      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/logs")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

   

  r = requests.get('http://127.0.0.1:22999/api/logs')

  print(r.content)
  ```
</RequestExample>


# Get Proxy Manager version
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_proxy_manager_version

Use the Bright Data Proxy Manager API to get Proxy Manager version. Calls GET /api/version on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/version`

<ResponseExample>
  ```json Sample Response theme={null}
  {
    "version":"1.280.385",
    "argv":""
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/version"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/version');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   
  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/version"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C#  theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/version")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.get('http://127.0.0.1:22999/api/version')

  print(r.content)
  ```
</RequestExample>


# Get proxy port status
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_proxy_port_status

Use the Bright Data Proxy Manager API to get Proxy Port Status. Calls GET /api/proxy_status/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/proxy_status/{PORT}`

<ParamField type="string">
  Existing proxy port number
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "status":"ok",
      "status_details":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxy_status/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxy_status/{PORT}');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
      public static void main(String[] args) throws Exception {

          String res = Executor.newInstance().execute(
              Request.Get("http://127.0.0.1:22999/api/proxy_status/{PORT}")
          ).returnContent().asString();

          System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {

          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/proxy_status/{PORT}")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();

          Console.WriteLine(responseString);

      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.get('http://127.0.0.1:22999/api/proxy_status/{PORT}')

  print(r.content)
  ```
</RequestExample>


# Get recent status
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_recent_stats

Use the Bright Data Proxy Manager API to get Recent Status. Calls GET /api/recent_stats on the local Proxy Manager port 22999.

**API endpoint:** `GET /api/recent_stats`

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "ports": {},
      "status_code": [],
      "hostname": [],
      "protocol": [],
      "total": 0,
      "success": 0,
      "ssl_enable":true}
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/recent_stats"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/recent_stats');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {
      public static void main(String[] args) throws Exception {

          String res = Executor.newInstance().execute(
              Request.Get("http://127.0.0.1:22999/api/recent_stats")
          ).returnContent().asString();

          System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
      public static async Task Main() {
          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
              Method = HttpMethod.Get,
              RequestUri = new Uri("http://127.0.0.1:22999/api/recent_stats")
          };

          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();
          Console.WriteLine(responseString);
      }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/recent_stats')

  print(r.content)
  ```
</RequestExample>


# Get tail from the log file
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_tail_from_the_log_file

Use the Bright Data Proxy Manager API to get tail from the Log file. Calls GET /api/general_logs on the local Proxy Manager port 22999.

**API endpoint:** `GET` `/api/general_logs`

<ParamField type="integer">
  Number of logs to get from tail
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/general_logs?limit=5"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/general_logs?limit=5');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/general_logs?limit=5"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;



  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/general_logs?limit=5")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.get('http://127.0.0.1:22999/api/general_logs?limit=5')

  print(r.content)
  ```
</RequestExample>


# Get the latest Proxy Manager (PM) version
Source: https://docs.brightdata.com/api-reference/proxy-manager/get_the_latest_proxy_manager_versions

Use the Bright Data Proxy Manager API to get the latest Proxy Manager (PM) version. Endpoint: GET /api/last_version on port 22999.

**API endpoint:** `GET` `/api/last_version`

<ResponseExample>
  ```json Sample Response theme={null}
  {
    "version": "1.280.385",
    "newer": false,
    "versions": [
      {
        "ver": "1.280.385",
        "type": "stable",
        "changes": [
          {
            "type": "star",
            "text": "Add render option for unblocker and serp zones"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/last_version"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node  
    
  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/last_version');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;  
    
  import org.apache.http.HttpHost;    
  import org.apache.http.client.fluent.*;  
    
    
    
    
  public class Example {  
    
    public static void main(String[] args) throws Exception {  
    
      String res = Executor.newInstance()  
    
       .execute(Request.Get("http://127.0.0.1:22999/api/last_version"))  
    
       .returnContent().asString();  
    
      System.out.println(res)  
    
    }  
    
  }
  ```

  ```cs C# theme={null}
  using System;  
  using System.Net;  
  using System.Net.Http;  
  using System.Net.Http.Headers;  
    

  public class Program {  
    
    public static async Task Main() {  
    
      var client = new HttpClient();  
    
      var requestMessage = new HttpRequestMessage {  
    
        Method = HttpMethod.Get,  
    
       RequestUri = new Uri("http://127.0.0.1:22999/api/last_version")  
    
      };  
    
      var response = await client.SendAsync(requestMessage);  
    
      var responseString = await response.Content.ReadAsStringAsync();  
    
      Console.WriteLine(responseString);  
    
    }  
    
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python  
    
  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');  
    
  import requests  

  r = requests.get('http://127.0.0.1:22999/api/last_version')  

  print(r.content)
  ```
</RequestExample>


# Refresh IP/gIP in a zone
Source: https://docs.brightdata.com/api-reference/proxy-manager/refresh_ips_or_gips_in_zone

Use the Bright Data Proxy Manager API to refresh IP/gIP in a zone. Calls POST /api/refresh_ips on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/refresh_ips`

## `POST` body

<ParamField type="string">
  Zone name
</ParamField>

<ParamField type="array">
  Static IPs. e.g. `ips=["ip1","ip2"]`
</ParamField>

<ParamField type="array">
  gIPs. e.g. `vips=["gip1","gip2"] [array]`
</ParamField>

<ResponseExample>
  ```json Sample Response theme={null}
  {
    "ips": [
  	{
  	  "ip":"10.0.0.1",
  	  "maxmind":"us"
  	},
  	{
  	  "ip":"20.0.0.1",
  	  "maxmind":"us"
  	}
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/refresh_ips" -H "Content-Type: application/json" -d '{"zone":"ZONE","ips":["10.0.0.1"]}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/refresh_ips', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'zone':'ZONE','ips':['10.0.0.1']}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
    public static void main(String[] args) throws Exception {
     String body = "{\"zone\":\"ZONE\",\"ips\":[\"10.0.0.1\"]}";
      String res = Executor.newInstance()
       .execute(Request.Post("http://127.0.0.1:22999/api/refresh_ips")
       .bodyString(body, ContentType.APPLICATION_JSON))
       .returnContent().asString();


      System.out.println(res)
    }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {

    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/refresh_ips"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         zone = "ZONE",
         ips = ["10.0.0.1"]
       }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import requests
  import json

  data = {'zone':'ZONE','ips':['10.0.0.1']}

  r = requests.post('http://127.0.0.1:22999/api/refresh_ips', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Refresh Proxy Manager port session
Source: https://docs.brightdata.com/api-reference/proxy-manager/refresh_proxy_manager_port_sessions

Bright Data Proxy Manager API endpoint to refresh Proxy Manager Port Session. Endpoint: GET /api/refresh_sessions/{PORT} on port 22999.

**API endpoint:** `GET` `/api/refresh_sessions/{PORT}`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/refresh_sessions/{PORT}"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/refresh_sessions/{PORT}');
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Get("http://127.0.0.1:22999/api/refresh_sessions/{PORT}"))

       .returnContent().asString();

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Get,

       RequestUri = new Uri("http://127.0.0.1:22999/api/refresh_sessions/{PORT}")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python


  import requests



  r = requests.get('http://127.0.0.1:22999/api/refresh_sessions/{PORT}')

  print(r.content)
  ```
</RequestExample>


# Restart Proxy Manager
Source: https://docs.brightdata.com/api-reference/proxy-manager/restart_proxy_manager

Use the Bright Data Proxy Manager API to restart Proxy Manager. Calls POST /api/restart on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/restart`

<RequestExample>
  ```sh Shell theme={null}
  curl -X POST "http://127.0.0.1:22999/api/restart"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/restart', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   
  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/restart"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/restart")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.post('http://127.0.0.1:22999/api/restart')

  print(r.content)
  ```
</RequestExample>


# Shutdown Proxy Manager
Source: https://docs.brightdata.com/api-reference/proxy-manager/shutdown_proxy_manager

Use the Bright Data Proxy Manager API to shutdown Proxy Manager. Calls POST /api/shutdown on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/shutdown`

<RequestExample>
  ```sh Shell theme={null}
  curl -X POST "http://127.0.0.1:22999/api/shutdown"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/shutdown', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/shutdown"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/shutdown")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python


  import requests



  r = requests.post('http://127.0.0.1:22999/api/shutdown')

  print(r.content)
  ```
</RequestExample>


# Allowlist IPs to access UI
Source: https://docs.brightdata.com/api-reference/proxy-manager/ui-allowlist-ips

Use the Bright Data Proxy Manager API to allowlist IPs to Access UI. Calls PUT /api/add_whitelist_ip on the local Proxy Manager port 22999.

**API endpoint:** `PUT` `/api/add_whitelist_ip`

<ParamField type="string">
  API key
  <Tip>API Key should be generated using [Generate API Key](/api-reference/proxy-manager/generate_token_for_token_based_authentication)</Tip>
</ParamField>

## `PUT` body

<ParamField type="string">
  IP to allowlist e.g. `ip="1.2.1.2"`
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/add_whitelist_ip" -H "Authorization: API key" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/add_whitelist_ip', {
      method: 'PUT',
      headers: { 'Authorization': 'API key', 'Content-Type': 'application/json' },
      body: JSON.stringify({'ip':'1.2.1.2'}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.\*;


  public class Example {
      public static void main(String[] args) throws Exception {
      String body = "{\"ip\":\"1.2.1.2\"}";
      String res = Executor.newInstance()
        .addHeader("Authorization", "API key")
        .execute(Request.Put("http://127.0.0.1:22999/api/add_whitelist_ip")
        .bodyString(body, ContentType.APPLICATION_JSON))
        .returnContent()
        .asString();
      
      System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;


  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Put,
        RequestUri = new Uri("http://127.0.0.1:22999/api/add_whitelist_ip"),
        Headers = {{"Authorization", "API key"}},
        Content = new StringContent(JsonConvert.SerializeObject(new {
          ip = "1.2.1.2"
        }), Encoding.UTF8, "application/json")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import json
  import requests


  data = {'ip':'1.2.1.2'}
  headers = {'Authorization': 'API key'}

  r = requests.put(
      'http://127.0.0.1:22999/api/add_whitelist_ip',
      data=json.dumps(data),
      headers=headers
  )

  print(r.content)
  ```
</RequestExample>


# Unban an IP
Source: https://docs.brightdata.com/api-reference/proxy-manager/unban_an_ip

Use the Bright Data Proxy Manager API to unban an IP. Calls POST /api/proxies/{PORT}/unbanip on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/unbanip`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `POST` body

<ParamField type="string">
  IP to unban. e.g. `ip="1.2.1.2"`
</ParamField>

<ParamField type="string">
  Unban the IP for sending requests to the specified domain.
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/unbanip" -H "Content-Type: application/json" -d '{"ip":"1.2.1.2","domain":"example.com"}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/unbanip', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
            'ip': '1.2.1.2',
            'domain': 'example.com'
        }),

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.\*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"ip\":\"1.2.1.2\",\"domain\":\"example.com\"}";

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/unbanip")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/unbanip"),

       Content = new StringContent(JsonConvert.SerializeObject(new {

         ip = "1.2.1.2",

         domain = "example.com"

       }), Encoding.UTF8, "application/json")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json

   

  data = {'ip':'1.2.1.2','domain':'example.com'}

  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/unbanip', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Unban IPs (multiple)
Source: https://docs.brightdata.com/api-reference/proxy-manager/unban_ips

Use the Bright Data Proxy Manager API to unban IPs (multiple). Endpoint: POST /api/proxies/{PORT}/unbanips on port 22999.

**API endpoint:** `POST` `/api/proxies/{PORT}/unbanips`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

<RequestExample>
  ```sh Shell theme={null}
  curl "http://127.0.0.1:22999/api/proxies/{PORT}/unbanips"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}/unbanips', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {
      public static void main(String[] args) throws Exception {
          String res = Executor.newInstance().execute(
              Request.Post("http://127.0.0.1:22999/api/proxies/{PORT}/unbanips"
          )).returnContent().asString();

          System.out.println(res)
      }
  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Post,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}/unbanips")
      };

      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests

  r = requests.post('http://127.0.0.1:22999/api/proxies/{PORT}/unbanips')

  print(r.content)
  ```
</RequestExample>


# Update a proxy port
Source: https://docs.brightdata.com/api-reference/proxy-manager/update_a_proxy_port

Use the Bright Data Proxy Manager API to update a Proxy Port. Calls PUT /api/proxies/{PORT} on the local Proxy Manager port 22999.

**API endpoint:** `PUT` `/api/proxies/{PORT}`

## Path Parameter

<ParamField type="string">
  Existing proxy port number
</ParamField>

## `PUT` body

<ParamField type="User Object">
  <Expandable title="properties">
    <ParamField type="integer">
      Port for the HTTP proxy
    </ParamField>

    <ParamField type="string">
      Set to `persist` to save proxy into the configuration file.
    </ParamField>

    <ParamField type="integer">
      Multiply the port definition given number of times
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="array">
      List of `user`s `[string]`. This option has to be used along with `multiply_users`
    </ParamField>

    <ParamField type="boolean">
      Enable SSL analyzing
    </ParamField>

    <ParamField type="string">
      Choose the SSL library

      | value | description |
      | - | - |
      | `open_ssl` | Open SSL Library |
      | `flex_tls` | Flex TLS Library |
    </ParamField>

    <ParamField type="string">
      Interface or IP to listen on
    </ParamField>

    <ParamField type="string">
      Customer name
    </ParamField>

    <ParamField type="string">
      Zone name
    </ParamField>

    <ParamField type="string">
      Zone password
    </ParamField>

    <ParamField type="string">
      Hostname or IP of super proxy
    </ParamField>

    <ParamField type="integer">
      Super proxy port
    </ParamField>

    <ParamField type="string">
      Determines what kind of connection will be used between Proxy Manager and Super Proxy

      | | |
      | - | - |
      | `http` | |
      | `https` | |
      | `socks` | |
    </ParamField>

    <ParamField type="integer">
      Automatically retry on super proxy failure
    </ParamField>

    <ParamField type="boolean">
      Enable SSL connection/analyzing to insecure hosts
    </ParamField>

    <ParamField type="string">
      Country
    </ParamField>

    <ParamField type="string">
      State
    </ParamField>

    <ParamField type="string">
      City
    </ParamField>

    <ParamField type="string">
      ASN
    </ParamField>

    <ParamField type="string">
      Data Center IP
    </ParamField>

    <ParamField type="integer">
      gIP
    </ParamField>

    <ParamField type="array">
      A list of proxies from external vendors. Format: \[username:password@]ip\[:port]

      * proxy\[string]
    </ParamField>

    <ParamField type="string">
      Default username for external vendor ips
    </ParamField>

    <ParamField type="string">
      Default password for external vendor ips
    </ParamField>

    <ParamField type="integer">
      Default port for external vendor ips
    </ParamField>

    <ParamField type="string">
      DNS resolving

      | | |
      | - | - |
      | `local` | |
      | `remote` | |
    </ParamField>

    <ParamField type="boolean">
      Process reverse lookup via DNS
    </ParamField>

    <ParamField type="string">
      Process reverse lookup via file
    </ParamField>

    <ParamField type="array">
      Process reverse lookup via value
    </ParamField>

    <ParamField type="string">
      Session for all proxy requests
    </ParamField>

    <ParamField type="boolean">
      Use session per requesting host to maintain IP per host
    </ParamField>

    <ParamField type="integer" />

    <ParamField type="boolean">
      Session pool size
    </ParamField>

    <ParamField type="integer">
      Throttle requests above given number
    </ParamField>

    <ParamField type="array">
      Proxy request rules
    </ParamField>

    <ParamField type="string">
      Block or allow requests to be automatically sent through super proxy on error
    </ParamField>

    <ParamField type="array" />

    <ParamField type="string" />

    <ParamField type="string">
      Operating System of the Peer IP
    </ParamField>

    <ParamField type="array">
      Request headers
    </ParamField>

    * name\[string]
    * value\[string]

    <ParamField type="string">
      Request debug info

      | | |
      | - | - |
      | `full` | |
      | `none` | |
    </ParamField>

    <ParamField type="string">
      x-lpm-authorization header
    </ParamField>

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="boolean" />

    <ParamField type="boolean" />

    <ParamField type="integer" />

    <ParamField type="string" />

    <ParamField type="boolean">
      Unblocker Mobile UA
    </ParamField>

    <ParamField type="string">
      Timezone ID to be used by the browser
    </ParamField>

    <ParamField type="string">
      Browser screen size
    </ParamField>

    <ParamField type="string">
      WebRTC plugin behavior in the browser
    </ParamField>

    <ParamField type="object">
      BW limit params

      * days \[integer]
      * bytes \[integer]
      * renewable\[boolean] - Renew limit of bytes each period or use single period and stop usage once last day of period is reached. Default is true
    </ParamField>
  </Expandable>
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "port":24000,
      "zone":"ZONE",
      "proxy_type":"persist",
      "customer":"CUSTOMER",
      "password":"password",
      "whitelist_ips":[]
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/proxies/{PORT}" -H "Content-Type: application/json" -d '{"proxy":{"port":24000,"zone":"ZONE","proxy_type":"persist","customer":"CUSTOMER","password":"password","whitelist_ips":[]}}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/proxies/{PORT}', {
      method: 'PUT',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

   

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

   

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"proxy\":{\"port\":24000,\"zone\":\"ZONE\",\"proxy_type\":\"persist\",\"customer\":\"CUSTOMER\",\"password\":\"password\",\"whitelist_ips\":[]}}";

      String res = Executor.newInstance()

       .execute(Request.Put("http://127.0.0.1:22999/api/proxies/{PORT}")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;
   

  public class Program {
    public static async Task Main() {
      var client = new HttpClient();
      var requestMessage = new HttpRequestMessage {
        Method = HttpMethod.Put,
       RequestUri = new Uri("http://127.0.0.1:22999/api/proxies/{PORT}"),
       Content = new StringContent(JsonConvert.SerializeObject(new {
         proxy = new {
           port = 24000, zone = "ZONE", proxy_type = "persist", customer = "CUSTOMER", password = "password", whitelist_ips = []
         }
       }), Encoding.UTF8, "application/json")
      };
      var response = await client.SendAsync(requestMessage);
      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);
    }
  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  import requests
  import json


  data = {'proxy':{'port':24000,'zone': 'ZONE','proxy_type':'persist','customer':'CUSTOMER','password':'password','whitelist_ips':[]}}

  r = requests.put('http://127.0.0.1:22999/api/proxies/{PORT}', data=json.dumps(data))

  print(r.content)
  ```
</RequestExample>


# Update general setting
Source: https://docs.brightdata.com/api-reference/proxy-manager/update_general_settings

Use the Bright Data Proxy Manager API to update General Setting. Calls PUT /api/settings on the local Proxy Manager port 22999.

**API Endpoint:** `PUT` `/api/settings`

## `PUT` Body:

<ParamField type="string">
  Default zone
</ParamField>

<ParamField type="array">
  Allowlist ip list for granting access to browser admin UI
</ParamField>

<ParamField type="array">
  Default for all proxies allowlist ip list for granting access to them
</ParamField>

<ParamField type="integer">
  Number of request logs to store
</ParamField>

<ParamField type="boolean">
  Enable requests statistics
</ParamField>

<ResponseExample>
  ```JSON Sample Response theme={null}
  {
      "customer":"CUSTOMER",
      "zone":"ZONE",
      "password":"password",
      "www_whitelist_ips":[],
      "whitelist_ips":[],
      "fixed_whitelist_ips":[],
      "read_only":false,
      "config":"/home/user/proxy_manager/.luminati.json",
      "test_url":"http://brdtest.com/myip.json",
      "logs":1000,
      "log":"notice",
      "har_limit":1024,
      "request_stats":true,
      "dropin":true,
      "pending_ips":[],
      "pending_www_ips":[],
      "zagent":false,
      "sync_config":true
  }
  ```
</ResponseExample>

<RequestExample>
  ```sh Shell theme={null}
  curl -X PUT "http://127.0.0.1:22999/api/settings" -H "Content-Type: application/json" -d '{"zone":"ZONE","www_whitelist_ips":[],"whitelist_ips":[],"logs":1000,"request_stats":true}'
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/settings', {
      method: 'PUT',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({'zone': 'ZONE','www_whitelist_ips':[],'whitelist_ips':[],'logs':1000,'request_stats':true}),
    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;

  import org.apache.http.client.fluent.*;

  public class Example {

    public static void main(String[] args) throws Exception {

     String body = "{\"zone\":\"ZONE\",\"www_whitelist_ips\":[],\"whitelist_ips\":[],\"logs\":1000,\"request_stats\":true}";

      String res = Executor.newInstance()

       .execute(Request.Put("http://127.0.0.1:22999/api/settings")

       .bodyString(body, ContentType.APPLICATION_JSON))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;

  using System.Net;

  using System.Net.Http;

  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Put,

       RequestUri = new Uri("http://127.0.0.1:22999/api/settings"),

       Content = new StringContent(JsonConvert.SerializeObject(new {

           zone = "ZONE", www_whitelist_ips = [], whitelist_ips = [], logs = 1000, request_stats = true

       }), Encoding.UTF8, "application/json")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests
  import json

   

  data = {'zone': 'ZONE','www_whitelist_ips':[],'whitelist_ips':[],'logs':1000,'request_stats':True}

  r = requests.put('http://127.0.0.1:22999/api/settings', data=json.dumps(data))

  print(r.content)

  ```
</RequestExample>


# Upgrade Proxy Manager
Source: https://docs.brightdata.com/api-reference/proxy-manager/upgrade_proxy_manager

Use the Bright Data Proxy Manager API to upgrade Proxy Manager. Calls POST /api/upgrade on the local Proxy Manager port 22999.

**API endpoint:** `POST` `/api/upgrade`

<RequestExample>
  ```sh Shell theme={null}
  curl -X POST "http://127.0.0.1:22999/api/upgrade"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  (async () => {
    const response = await fetch('http://127.0.0.1:22999/api/upgrade', {
      method: 'POST',

    });
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```java Java theme={null}
  package example;


  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;


  public class Example {

    public static void main(String[] args) throws Exception {

      String res = Executor.newInstance()

       .execute(Request.Post("http://127.0.0.1:22999/api/upgrade"))

       .returnContent().asString();

   

      System.out.println(res)

    }

  }
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;
  using System.Net.Http;
  using System.Net.Http.Headers;

   

  public class Program {

    public static async Task Main() {

      var client = new HttpClient();

      var requestMessage = new HttpRequestMessage {

        Method = HttpMethod.Post,

       RequestUri = new Uri("http://127.0.0.1:22999/api/upgrade")

      };

      var response = await client.SendAsync(requestMessage);

      var responseString = await response.Content.ReadAsStringAsync();

      Console.WriteLine(responseString);

    }

  }
  ```

  ```python Python theme={null}
  #!/usr/bin/env python

  print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');

  import requests


  r = requests.post('http://127.0.0.1:22999/api/upgrade')

  print(r.content)
  ```
</RequestExample>


# Request and response C-Tag
Source: https://docs.brightdata.com/api-reference/proxy/c-tag

Configure the Bright Data Proxy REST API Request and Response C-Tag to control request behavior on port 44445, with reference for parameters and fields.

When you're dealing with a massive volume of requests, keeping track of individual responses can be challenging. Enter C-Tag, a simple yet powerful solution that improves request tracking.

With C-Tag, users include a unique `c_tag` flag in their requests. In response, businesses echo back the same tag in the header. This seamless exchange ensures that each response is bound to its corresponding request, eliminating confusion and streamlining data management.

Add any C-Tag text in your request and get the identical sting in your response header:

<CodeGroup>
  ```sh Sample Request theme={null}
  curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-c_tag-<C_TAG_VALUE>:<zone_password>
  ```

  ```js Output headers theme={null}
  x-brd-c_tag: <C_TAG_VALUE>
  ```
</CodeGroup>


# Configuring DNS resolution
Source: https://docs.brightdata.com/api-reference/proxy/configuring_dns_resolution

Configure DNS resolution on the Bright Data Proxy REST API (port 44445) to control request behavior, with reference for parameters and response fields.

It is possible to direct Bright Data proxy network to use either remote or local DNS resolution.

This is useful if your target has more than two IPs (depending on where the DNS query is made) and would like to target a specific IP of the target site.

All requests to Bright Data start with a connection to a Super Proxy (brd.superproxy.io). The Super Proxy then send the request to local servers in different countries, who can send the request if needed to Residental proxies ("peers").

When using `local` DNS resolution, domain names are resolved and cached by Bright Data Super Proxy network server, the resolved IP is used the real request by the proxy in the actual country.

When requests are made using `remote` they initially received by a Super Proxy (brd.superproxy.io). The Super Proxy does a preliminary DNS resolution locally, only to check if domain is valid. If the domain is valid, the request is sent to a Bright Data server that is closest to the country where the proxy is located.

* If the Bright Data server is in the same country as the proxy, DNS is performed on the server, the resolved IP is used the real request. This DNS resolution is usually faster than DNS resolution by the proxy.
* If the Bright Data server is in a different country, DNS is performed on actual proxy.

<CodeGroup>
  ```sh DNS (Local) theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-dns-local:<zone_password>
  ```

  ```sh DNS (Remote) theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-dns-remote:<zone_password>
  ```
</CodeGroup>

<Note>
  When using remote DNS resolution you may see some performance degradation due to local DNS resolution lag.
</Note>


# Proxy geolocation targeting
Source: https://docs.brightdata.com/api-reference/proxy/geolocation-targeting

Target Bright Data proxy exits across 195 countries by Country, City, State, ASN or ZIP code using proxy username parameters or the brd-exit-country header.

## Country Targeting

You can target a specific country in one of two ways:

* **Username parameter**: add a country code to your username, like `username-country-country_code`.
* **Proxy header**: send the `brd-exit-country` header with the country code, like `brd-exit-country: country_code`, and keep your username unchanged.

In both cases, use only two-letter country codes in lowercase.

<CodeGroup>
  ```sh Username parameter theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us:<zone_password>
  ```

  ```sh Proxy header theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> --proxy-header "brd-exit-country:gb"
  ```
</CodeGroup>

<Note>
  The `brd-exit-country` value is sent with `--proxy-header`, so it goes to the proxy only and is not forwarded to the target website.
</Note>

### Default countries' selection

In all Bright Data shared pool proxies: Datacenter, ISP, Residential and Mobile share pools (also known as "Rotating proxies") we offer a default country selection during zone configuration. When a country(s) is selected, Bright Data will attempt to allocate a peer from the selected default countries. The allocation sequence is as follows:

If there are default countries configured:

1. Select a random country from the **default countries** list.

2. Attempt to allocate a peer in that country

3. If peer found: route request to the peer

4. If peer not found: fail the request and reply with error

In case there are **no default countries selected,** Bright Data will allocate a random proxy peer from the pool and route the request through it.

### EU Countries targeting

Bright Data proxy networks as well as our Web Unlocker API allow random peer selection specifically from **EU-member countries** via the use of the `-country-eu` flag. When needing to target EU peers, this will improve success rates over targeting from just one EU country, while still keeping the peer within the EU.

## City Targeting

<Note>City targeting works best with Residential. City targeting for Datacenter and ISP proxies has been deprecated and is no longer available.</Note>

You can target a specific city within a country by adding a city name to the username, like `username-country-country_code-city-city_code`, or by sending the `brd-exit-country` and `brd-exit-city` headers. The city\_code must be in lowercase only and have no spaces, for example `-city-sanfrancisco` or `brd-exit-city:sanfrancisco`.

<CodeGroup>
  ```sh Username parameter theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-city-sanfrancisco:<zone_password>
  ```

  ```sh Proxy header theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> --proxy-header "brd-exit-country:us" --proxy-header "brd-exit-city:sanfrancisco"
  ```
</CodeGroup>

## State Targeting

<Note>Residential proxies only</Note>

You can target a specific region or subdivision by adding the parameter `-state-<state_code>` to your username string, or by sending the `brd-exit-country` and `brd-exit-state` headers.

We utilize the **ISO 3166-2** standard for state targeting. While this includes standard 2-letter codes (e.g., US states), we also support **3-letter** and **numeric** codes as defined by the standard for other regions.

<Tip>
  Always verify the correct subdivision code using the [ISO 3166-2 standard](https://en.wikipedia.org/wiki/ISO_3166-2). Ensure the code is entered in **lowercase**.
</Tip>

<CodeGroup>
  ```sh Country: USA (2-letter) theme={null}
  # Targeting New York (ny)
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-us-state-ny:<zone_password> 
  ```

  ```sh Country: England (3-letter) theme={null}
  # Targeting England (eng)
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-gb-state-eng:<zone_password>
  ```

  ```sh Country: Japan (Numeric) theme={null}
  # Targeting Okinawa (47)
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-country-jp-state-47:<zone_password>
  ```

  ```sh Proxy header theme={null}
  # Targeting New York (ny)
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> --proxy-header "brd-exit-country:us" --proxy-header "brd-exit-state:ny"
  ```
</CodeGroup>

## ASN Targeting

<Note>Residential proxies only</Note>

You can target a specific ASN from the [list of ASNs](http://bgp.potaroo.net/cidr/autnums.html). Choosing an ASN is done by adding `-asn-ASN_NUMBER` to the username, or by sending the `brd-exit-asn` header.

<CodeGroup>
  ```sh Username parameter theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-asn-56386:<zone_password>
  ```

  ```sh Proxy header theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> --proxy-header "brd-exit-asn:56386"
  ```
</CodeGroup>

## ZIP Code Targeting

<Note>Residential proxies only</Note>

You can target proxy peers by a ZIP code of a specific area. Use the `-zip-<zip_code>` username parameter or the `brd-exit-zipcode` header. Here is an example of targeting an IP from Memphis, US and zip code 12345:

<CodeGroup>
  ```sh Username parameter theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-city-memphis-zip-12345:<zone_password>
  ```

  ```sh Proxy header theme={null}
  curl "https://example.com" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> --proxy-header "brd-exit-city:memphis" --proxy-header "brd-exit-zipcode:12345"
  ```
</CodeGroup>


# Disable peer rotation
Source: https://docs.brightdata.com/api-reference/proxy/keep_same_peer_in_session

Configure the Bright Data Proxy to disable peer rotation on port 44445 and pin sessions to proxy, with reference for parameters and response fields.

This article refers to use cases requiring you to both:

1. Use the same proxy IP along a subsequent flow of requests
2. Do not allow failover to a different IP in case the first assigned becomes unavailable

This setup can be useful for Residential proxies, which consist of real PCs and mobile devices that may go offline, and you do not wish to switch to another IP in the middle of the workflow to avoid block or detection.

To avoid assigning a new peer to the session in case the peer used in the session went offline, use the `const` parameter, relayed over the proxy username, in conjunction with the `session` parameter.

Note: for this feature to work **both parameters** are necessary.

Example, using session: `mystring12345` and `const` together to fix the IP and not allow failover, add `-session-mystring12345-const` to the proxy username:

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```

When using these combined options parameters, if Bright Data cannot assign the previously used proxy IP, you will get a `502` `HTTP` error code in response, with error message:

```sh Error Message theme={null}
502 Proxy Error: server_error Failed to establish connection with peer
```


# OS targeting
Source: https://docs.brightdata.com/api-reference/proxy/os_targeting

Configure the Bright Data Proxy REST API OS Targeting to control request behavior, with reference for parameters and response fields. Connects via port 44445.

Bright Data allows targeting the following **Operating Systems**:

<CodeGroup>
  ```sh Windows theme={null}
  curl "https://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-windows:<password>
  ```

  ```sh macOS theme={null}
  curl "https://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-osx:<password>
  ```

  ```sh Android theme={null}
  curl "https://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-os-android:<password>
  ```
</CodeGroup>


# Request error handling
Source: https://docs.brightdata.com/api-reference/proxy/request_error_handling

Configure request error handling on the Bright Data Proxy REST API (port 44445) to control request behavior, with reference for parameters and fields.

| value | description |
| - | - |
| `pass_dyn` | if a request can't pass via proxy peer, automatically pass it via the Super Proxy |
| `block` | if a request can't pass via proxy peer, block it and don't send via Super Proxy |

<CodeGroup>
  ```sh pass_dyn theme={null}
  curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-pass_dyn:<zone_password>
  ```

  ```sh block theme={null}
  curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-route_err-block:<zone_password>
  ```
</CodeGroup>


# Proxy and IP rotation control
Source: https://docs.brightdata.com/api-reference/proxy/rotate_ips

How Bright Data proxy IP rotation works across 4 networks (Datacenter, ISP, Residential, Mobile) and how to control rotation with session parameters.

## Default proxy IP rotation in Shared Pool

Shared pool proxies, also known as "Rotating Proxies" are available in all Bright Data proxy networks: Datacenter, ISP, Residential & Mobile.

By default, Bright Data assigns a random proxy from the available proxies in the zone, according to your configuration.

For example: if you chose to target a specific country, for example Canada, using the `-country=ca` parameter, we will randomly assign a proxy in Canada out of all the proxies located in Canada that we have in the pool.

The next request, will be directed to a different proxy, and so on, selected randomly from our pool. Executing requests in high rate or by multiple calling agents may result in reuse of the same proxy IPs.

## Default proxy IP rotation in dedicated proxy zone

When you configure a set of dedicated proxies dedicated proxies are assigned to your exclusive use in the following manner:

1. In Datacenter and ISP network: proxies are exclusively yours for all domains.
2. In Residential and Mobile networks: are exclusively yours towards **specific domains**.

In dedicated proxy zones we will rotate to next available proxy to serve the next request.

### What are "Static residential" proxies?

"Static residential proxies" are datacenter hosted proxies registered as owned by Internet Service Providers (ISP) and enable have a fixed, static IP address. In Bright Data we name these proxies: "ISP Proxies" and not "Static residential".

### Rotation in dedicated residential proxies

Since residential proxies vary in their availability, we group together a number of proxies to a group which we call `gIP`.  This `gIP` gets a unique identifier, and peers assigned to it (members of the group) are selected according to configuration you specify. For example: if you require 3 dedicated residential ips towards target [http://example.com](http://example.com) ; we will provide 3 `gIPs` which we rotate over to serve your requests.

## Using explicit proxy for multiple requests: `ip`

To explicitly target a request to a specific proxy, use the `-ip` parameter in your proxy zone username request. This is when you issue a set of requests on a different connection (like a sequence of `curl` requests).

## Using the same proxy for multiple requests: `session`

To keep the same proxy IP address for multiple requests, use the `-session` parameter with a session identifier you create and control. Each request, carrying the same `-session` value will be forwarded to the **same proxy IP**.

The `-session` parameter value is generated by you and controlled by you, yet its format should include alphanumeric characters only. Using special characters like `-` or `*` will result in errors.

If you work with native proxy access (within code libraries or 3rd party tools which take proxy ip:port and credentials) then you embed the session parameter in the user name parameter as shown below for session identified `mystring12345`.  If you are using our proxy REST API, then the `session` parameter in request `body` shall carry the session identified value.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345:<zone_password>
```

## Disable proxy rotation in case of unavailable peer

Our default behavior is to direct your request to another peer in case the peer is unavailable to allow fluent operations. In case you would like to prevent this, and only use a single peer for a session, and fail the request in case the peer is unavailable, add the `-const `option to the `session `parameter.

When using the `-const` option, in case peer is unavailable you will get a `HTTP 502` Error.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```

## Losing session context

The following describes scenarios where session context can be lost, and consequent requests will be executed by **different** proxies.

### Session Idle Time

Session idle time is 5 minutes. In case there are more than 5 minutes idle time between two consequent requests, the second request, although carrying the same `session` parameter as the first, will use a randomly selected proxy from the pool.

### Session origin must be from same global region

In order to keep the same session, you must ensure your calling process issuing the request is not switching between global regions. We recognize 3 global regions:

1. AMER: North, central and south America
2. EMEA: Europe, Middle East and Africa
3. APAC: Asia and Pacific

Example: If you issue 2 consequent requests, one from **your company** server in Canada (in AMER region) and one from **your company server** in France, even if both requests will carry the same `session` parameter, they will be executed by different proxy peers.

### Other parameters must be identical

In case 2 consequent requests carry different country, city or any other parameter: session context will be lost , even if they carry the same `session` parameter.

### Error on lost session

By default, if session is lost or reset, Bright Data will randomly assign a proxy to your request. If you wish to avoid this default assignment, and error instead, use the `-const` parameter in your request. If the same peer is not available from any reason to 2 consequent requests, the second request will result in `HTTP Error 502`

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-session-mystring12345-const:<zone_password>
```

## Keeping track of requests and their responses (C-Tag)

We've implemented an optional feature that can greatly help tracking and linking requests with their corresponding responses, see the following article for more information: [more info on C-Tag](/api-reference/proxy/c-tag)


# Select a specific gIP
Source: https://docs.brightdata.com/api-reference/proxy/select_a_specific_gip

Configure the Bright Data Proxy REST API to select a specific gIP on port 44445, with reference for parameters and response fields.

Option available only for Residential or Mobile zones with multiple IPs allocated. To target a specific `gIP` allocated to your zone, use `-gip-gip_name` request parameter.

```sh theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-gip-us_7922_fl_hollywood_0:<zone_password>
```


# Select a specific IP
Source: https://docs.brightdata.com/api-reference/proxy/select_a_specific_ip

Configure the Bright Data Proxy REST API to select a specific IP on port 44445, with reference for parameters and response fields.

Option available only for zones with multiple IPs allocated. To target a specific IP allocated to your zone, use -ip-ip\_address request parameter.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-ip-1.2.3.4:<zone_password>
```


# Select super proxy by country
Source: https://docs.brightdata.com/api-reference/proxy/select_super_proxy_in_specific_country

Configure a Bright Data super proxy in a specific country using the -country flag in shared zones or via dedicated zone settings. Connects via port 44445.

Important note: This article is relevant ONLY for choosing a 'super proxy', which is rarely needed. In order to select a specific standard proxy (for example, Residential Proxy, Datacenter proxy or ISP proxy)

* In **Shared proxy zones**, you can add the '-country' flag (and also '-city') to your proxy username like this: username-country-country\_code-city-city\_code. Country codes are standard 2-character codes. The city\_code must be in lowercase only and have no spaces, for example -city-sanfrancisco.

* In **Dedicated proxy zones**, you can select the countries and cities in your zone configuration page by following these steps:

  1. Add a new proxy zone and set the IP type to 'Dedicated'

  2. Choose the domains you would like to target with this zone.

  3. Select the number of dedicated proxies you want to allocate to your zone

  4. Select the countries you want to target

  5. Optional - After selecting the countries you want, click 'Add city' next to each country you want to target in city resolution

  6. Add the chosen cities for each country and save the zone.

  7. Your new Dedicated proxy zone will allocate the number of grproxies you requested evenly between the countries and cities you selected.

If you actualy require our load balancer to provide a super proxy in a specific country:

<Note>
  If no specific server country is selected, Bright Data will automatically choose the optimal load-balancing server for speed. If speed is your primary concern, use this feature with caution, as it may negatively impact performance over time.
</Note>

Choosing the super proxy country can be done like this: `servercountry-{country}`.brd.superproxy.io. E.g. `servercountry-gb.brd.superproxy.io`

```sh Shell theme={null}
curl "https://example.com" --proxy servercountry-gb.brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password>
```


# Send requests directly from super proxy
Source: https://docs.brightdata.com/api-reference/proxy/send_requests_directly_from_super_proxy

Configure the Bright Data Proxy REST API to send requests directly from Super Proxy on port 44445, with reference for parameters and response fields.

You can choose to perform the request from the super proxy directly instead of the IP of the peer. In that case, the IP of the request will be the one of the Super Proxy by adding `-direct` to your request authorization string.

```sh Shell theme={null}
curl "http://target.site" --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>-direct:<zone_password>
```


# Google Flights async request
Source: https://docs.brightdata.com/api-reference/serp/google-flights/async

Use the Bright Data Google Flights async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  String representing flight search parameters

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "script-src 'report-sample' 'nonce-rG9xWwDHOfDPrr2gBY9D3w' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self', require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:16:08 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwVz3tUVVUeB_CrfM_dqLhEExFtRoulCArCVUCNuwlf0xQgcOGee87ZO0SRxBDioQ5oYstoShQCRyZLyEiMh4KQNZZpIY9EYFS0wtGZ0hTS1IAaVhDS_OaPz9q_vdfvtcc3T_LycDL5kGCy5P_x-Bmm8HkzTD8GzTUFBs81FZA9PWGmzDnLTQt2PmuyuIebmGe4Kd473BQwaQ16lCjcSIhCxo4ovHo_Ct9lRyO-MBprSfTFaPg8ikYQueQdg8leNmRH2DAvwYaunTZ8n0txiQ0jx2yoa7chzDkWK8hKcoDAPxYiMhbPk7ZtsWgnHSTllViEusfhqkccBubGob8zDqFj7LjraceMMDv-EmXHi3F2PNhox-QMO35-2Y6j79ixqtyO-k47dvTYUTpqx0pXFU1uKnI8VbzpreKejwoRpmI92RShwhStYnaKio5sFUauiuE8FTcLVDRUqzhfq-LTOhWDZ1SEnFMR3KTiiSsqFtxWMf6-ii9JQ7-KoOkO-Hg4kO_lwPilDuxc7kBvkgOluxx4qdiB_UccmF7hQMhRB3qIrcGBRR86cKmF8rscKPqJaoYceGashqZxGspcNHxBkqdoWDxVg2WahlyycI4GvwUaxvlpOE5qSUGghm-Xaqh_WsPKKA1RqoalGzTEvqihbbOGdakaXNI1HMzScKVIw6PDGn74gN6rNCSSjeTXGg2bP9Mw7XMNvU0aQjo19FyhmHR9peHafzTc66M-f9CR_qSOZZ46niK1wTp8Y3TMNnR8uVnH6m06VFKWq-O7fB25JTqeqNBR1apj_nkd7e06Okhqhw7tho6QmzrcBnXcG9Lh52RAJc-TookGtJkG4r0N3CUJAQZaLAbeWGbgQIiBEvLBKgOBqw0kRhrwtBnYl2RgwmYD1aQxzcA5MivLwMQtBqa-YSBurwGnQgPr6gwUnqaeZwwYZw08aKU5nQairxmY02dg3O8G6pjAQy-BPuKxUKAjQKB7kUD1CoEacpycIp-Q0-QMOUum_FlgSbjAUrKMhBAvh0CUIZAYL2B-QWDFJoFDWwWOZgt45wj4klRSniew9a8Cg2SYNBYLtJI7hwSGSgVGDgt0vSeQ_r7A-gqBSVUCe2sFbtQJ9H4k4PKxwMEvBErJ9kYBrUmgv1ngwQWK2wV-I-UXaS7BZYH3vhK4_bVA5TcC07sF6kg9ufwvgeLrNPeGQNtNgbg7Av_oFVh-X6C2T8C5X2DbLwKTBwVGRwTyRwUeGyOxBhLVzhLHyE-kZYLEqItEzFSJhJkSWY9LPPqjxJJZEiFkO1nrKZFMhskn8yXsC6mWpAdIHCT9Fgn_pyQGSA2XqCP7QyXywyRiV0qcDqecGIkLmsQOXeIkcRMSf18vUZ8oMZQkMbhR4nKyRHCaxL50iZEM2otUZUl05kik5knMel3iHBF7JB4rkKgslviUnCXHSiV-I43vSpyokjhSI_HzqbeUb3PLlE27ypQDr5UpBe-XKUNtZcrE3jIl79o_lf1kS_lFZTfZQ94iAbO7lFCSMf2qsovcqryq1M3-RhnI6VZct3crscuvK7OmjTVnEq_Hx5q_bnIy3yH9ZJj8TkzNTubBzAgzsiLMt_8WaR4gc1uizIvJw_xoc3y7lflctLLTt6zscxL7vZWF91pZxA9W5nbXyjxI6I9W9hzx67Oyol-trIS0mTj7UOHsJGkmLaRuEmcfuXL2MTlFzhHnqZzpMznbSWLmcea-gLNpizhrDeTsnSDOSsnMYM7crJzNI3tDOdtHGldw5rqKs19Wc9b2J86ukKJnOKsn18neZzkrJC6RnE1Yw1kwWUNqiLuNs2LytMZZiUH1CZwpiZx1pNDsNM6yt3A2sJWzbdmcfUYu5NCeOzgbRyYQN-JOPMgMUkDuvsJZ9W7OGkh3Hme9ZJiMEtNr1PN1zl4muWRkH2eZhZz5vsnZ26SMjCnibO3bnP23lP7wLuUfoX0rOHuumrNIsq6Gsw0k8xhnh05wVt7AWSWpItEn6d7C2RGyuJWzh-c5O9xGJ1ncQf_qpLxLnNWSFjL_35xV3OJsiovz-ebdnWbXE5XHW8c-6bsuLT0-KyNh64YU36SMtNSsDamJvkkpyS9szMr03ZIcb_G3BPlbLIF-_pb4l_z_BxaAqwI\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.tw/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Complex search
Source: https://docs.brightdata.com/api-reference/serp/google-flights/complex-search

Configure the Bright Data Google Flights Complex Search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA
```

## Parameters

<ParamField type="string">
  String representing flight search parameters

  <Tip>
    You can perform a Complex search by adding filters (bags, stops, times, prices) on [Google Flights](https://www.google.com/travel/flights) and the `tfs` string will automatically update. You can then copy this updated `tfs` to reproduce the filtered search programmatically.
  </Tip>

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhoxEgoyMDI2LTAzLTEwKAAyAkJBagsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsmgEBAUABSAFg-ApqBBABGABwAYIBCwj___________8BmAEC&tfu=EgYIABAAGAA',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "script-src 'report-sample' 'nonce-uGMnXxsGvj8gSKK09fkpOQ' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self', require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:40:12 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwVzntYVVUaBvCjvOcsLzRe8oY2o8aTiIniUSSMs5Q0pwsqcODss_deKySV1BAEUUMN7HFovJM0mjbCGHlFg7DLWKaphIbAoGim5eQ1CNNCanjSUOftj9_zfXt9a73f7rKyW0hQgGMYRf5Ru_R3TB7a3_Hj2CGOiMghjvVU2zzBsboxxjE89zmHu2-sQwTHOpJDYx2juk1DozMOF1PikLUsDn-7GYfLOfFILojHdPLWx2PYvXiMpVOhCegR4kXOFC-GpnjRkOvFtTz2m7xo3-dFeY0XlymmUyIm0iTaSAhPhJqaiBeoenEiaqiW0l5LxPi-STgblITWIUm4XZeE8R18aA72oX-MD6_E-fBykg-3ZvvQI8uHX171Yec_fXi6xIeKOh-WNfpQdN-HSd0NVPY2sCTYwBuhBm4MM6BiDMyguVMMOOINDEozUJtjwM4zcDffwJX1BvaXGviyzMCn5QbaDhmIPmYgstLA4DMGhl830OWmgRM0tp8fw4L8WBPiR5coP3Kf8qMp1Y-i5X7ML_Tjze1-9NvhR_ROPxrJu9-P0R_4caqK9xt4_44fz3Q0UdnZRHGgiSM0p6eJMb1MuPuYyKMRw010HmHiPSqj9REmLkWZqJhgYlKciTjDRNQsE4kvm6ieZ-LFdBOBmSa2ZJs4s8HEvW0mftjF8z0mZtJs-m2viXmfmejzuYmmShPRdSYaz7Cnhq9MXPjOxI0W5vzZQuajFsYFW3iSyiIthCVYGGRbODHPwuTFFgwqzrNweY2FvE0WBu-wsOe4hce_tFBTY6GW0mstmBctRF-x0LvNwo07FkYE2DDoBdrwkA1zgI3kUBvNlDLKRpXbxqpxNjZG29hEu562ETHZxsypNoK9Ntal2ug6z0YpHc2wcYwGZtt4aKGNXqtsJK21EVBgo-Ag8w7ZsA_buHWcO-psxF-w8ViLjc4PbJQLhZ9CFFooaKTC-dEKpRMV9tJ7dIA-oYN0iA5Tz2cVnohViKJxFE3zkxRC_ApxtsLyZAXXSwoT5ypsXaSwM0chdIlCGKVTSb7Cor8rtNFdOlqocJy-36pwp0ihfZtCwzsKme8qzNih0G2PwsVyhaaPFAI_VthyRKGIlh5VMCsVbn-hcOsk-xqF36mknjsJpxXe-Urh-jmF3V8r9DuvUE4VdPobhcJvufOiQvUVhX83KTx1U6GsRaHTbYXFvyr0aFO4366w5r7Cwx00noXGNCrtpLGPfqaqrhoPAjUSemmkDNB45RGNe3_ReGKgRjQtpajBGtODNe7SJ49r-EbyLWWO0thCt90a4U9qtNJeqVFOb43XWBOjcTCW8wSNk6bGh5ZGb8XZDI2KmRp3UjXaZmucnqMRmaHRTOsyNdqzNO7TnmyNuiUa6fkaA1dqHCO1WuPh9Rq7CzU-pcO0s0jjdzr6L43tezW-fV_jO7pErQc2Oy_lFTvnLi92rn-32Jl_4T_ON2lhSb1zBa2mzTRqUINzPGX1O-tcTld3n3WWD_ra2brkvLP70vPOtD4dXSGPdHSdqwxwfU8tdJfuU9uCKS5kT3Fd_8dUVysNqYpzjaGf18S7cjfGu5JrPGJYvUd0uOIRu-jgVY_4nBKueURsE-sPHtG72SOCSP7oEc_TiBaP2PCbR2yiaocUXzilqKLyblJ81F2Kj-kAHaPA_lL8ibpTD7IGSJFLCUOl6DtcitVuKT6gPqOZESFFb48Ua8dLsY6OTJTi18lS1P1VirO04RkpKugbWvucFAXUdZoUkTSN9lKQV4pCmmBK8ZZNyVK8Pp3_mCKFc6YUtWnclSFFzkIpWhex5kjxGZ1cwu-lUvxC_6MH1GGZFAEEKqDm16QoXSHFfmrKZ87rfL9SilcpjzJWSdG-jmcFUoS9IcXbVExXC6W4RtPfZnYR59ulWLBPisZyKba-L8X2_VLEfyhFSRV7GnNcip-qWWulGHlKinBy02jaQ2V0gob-V4odV6XoGdjpZv2KOlf35ec2b-v4aNiLGZnJ2Vkpi2alhaVmZaRnz0qfGZaaNuel2dkLwhbOSXaHu8eGu90RI8LdyfPD_w9O0pwX\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.au/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Google Flights currency
Source: https://docs.brightdata.com/api-reference/serp/google-flights/currency

Configure the Bright Data Google Flights Google Flights currency parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD
```

## Parameters

<ParamField type="string">
  String representing flight search parameters
</ParamField>

<ParamField type="string">
  Defines the currency of returned prices

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&curr=USD',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport, script-src 'report-sample' 'nonce-1mGlhJJcMK5-5ZqCNTUFvw' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self'",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:45:15 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwV0XtUVlUaBvBPfb5vI9rykqhgpclShIQABcJgk9exBpXrd75zzj4iigQGGIgX1MTGYY2GgmBhVjBlolwKwm4maSqBEZCKVFpOZqmkyQzSDCtNmXnmj99az3r3e9797nXcq0b4eA6x-VEYhf8_u3vZ5k_zsv0aOtUWEjbVVkRrpsyxTd_yjC14XLRNeEfbknyjbUEjluC6PQaXkmOQszkGf70Vgx_zYpFUHItl5DwTC7_7sQils75xGOUTj7xF8ZiWHI_OLfH4OZ-5LB733olHfVs8ZrslYC7No1cIgQlQixOwlFrXJ6CN2injxQREjUtEl2ci-qYm4nZHIqIGOXHD2wmv2U5siHHiuUQnetKcGJXjxG8vOHHwdSfm73eiocOJzdedKB9wYt5IDU0eGjZ6a9jtq-Gmn4YVszWsWqTBFqthUoaG9jwNZr6GuwUarhRpOFyj4Ys6DUfrNfQf0xBxSkNYk4ZHz2uYflWD-y0Npyl0vAt-ni4U-rjgHu7CljkudKe6UL7VhedLXdhzwIXxlS5EHHThOsUfdmHG-y6cbWZ_J_vvuLBwsI6moToqhus4QemjdcwcoyN4rI58CpiuY2iAjnepjopCdFwO19HwlI55MTpiNB3hK3UkPKejNVPH8iwdw7N17MvVcb5Ex_03dfxyiPVqHSmURr_X6sj8VMfYz3R0N-mI6NBx_TwzdX6t4-IPOm72cs7DBrInG5jlbeBJqgsz4B9nYJJp4HSmgQXrDWhUkW_gx0ID-WUGHq00UN1i4LEvDLS1GWinrHYD-iUDEVcMePQbuHnHQMAQExotpZIHTOgTTCT5mrhByUEmmoNN7Jhl4pUIE2V0aL6JkAUmUhab8I43sSvVxLBMEzV0crWJUzQx18QDa02M2WEicaeJIcUmihs575gJ87iJnhbe0WEi9qKJKb0mhv7XRL1Q-KePQi95Pq5wOUjhwgyFmrkKtfQuHaFPqJGO0XEa_bTCE9EK4TSLIsjHpRBjKqQkKTieVZi7SuGNdQoH8xR8Nyr4UxbtL1BY9zeFfrpLJ0sVWuhOucK9NxU631LIflthRaXCiGqFS_UK3R8qDP9IYd8JhXLadFJBb1K4_blCz5fMbQp_0P4zvI9wTuGtrxWufqNQ9a3C-AsK9dRA575TKP1e4dolhdYrCh93K8y5pVDXq-B2W2H9vxVG9SsM3FMoHFB4cJCFp2FhCdW4WXiH_kXNwyzEjbGQPMHChocs3H_EwhMTLUTQJlrmbSGd7tInj1nQHud3lB1kYR_NC7awkG5T4JMW-mhvlIXC2RYao1mPs9CqW9hsWPiAPBTPV1hoSLFwJ9VCf5qFc-kWwlZb6KZd2Rbu5VgYoOpcCx0bLWQVWJi43cIpUi9ZeLDIQlWphaN0nP4ot3Dy7xYO1Fr47cir9sv5FfZVWyvsRW9X2OOuVtjt3RX2gotf2fdQ7v4z9r_QS_QqBU3qtEdRzvgu-1b6uarLXjfpW3vfxgv2kZsu2CeOHeyY8tBgx_tNQxzf0DW6SwPUv2aRA7mLHFdfXuzoo6nNMY6Z1FMY60huixR-ZyJF40-R4jOK7o4Ucb9ECo8bkcKT0kj-Gin-TAG9kaLk90hRRq02KY7apWikNmqn-hFSfDhSio_oCJ0iu5cUgoaSOxkTpIibJsW46VKMnSFFS4gU10KleDhMCo9IKXZGSbGLTsyVouNPUnRRyUIpGuh72vmMFMU0bIkUYbSEaskzXopScuhSPEV7TSm2L5Pi82TWUrhfhhTOTCl61kjRRwtypchby7xOiuD1UmzIk-JTctvMXWkYedA48iQvKqIbL0pRs02Kw9RdwBnbpXiB8ilrB99XKIVJFi2lZbScVtC9XewvlsJ_txSvUQUNKmHPa1L8p5w7HJBicq0Ub7wnxYHDUlRRNcV-IMUjx3hGDU1SVDZLcYhmtkix57QUL1MZ7aX7rVLkfCnFjHYpPu7gPzjLvbqk2EfT_iFF6A9ShFPlT1KMHu72eue2DsfI3e9tqx402X_56uyk3JzkdSsz_FNzVmflrsxK8U_NSH82LXeN_9r0pODA4NDA4OCQgMDgpOcD_wfAZJtV\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.sa/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Google Flights localization
Source: https://docs.brightdata.com/api-reference/serp/google-flights/localization

Configure the Bright Data Google Flights Google Flights localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en
```

## Parameters

<ParamField type="string">
  String representing flight search parameters
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page language

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&hl=en
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ&gl=us&hl=en',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport, script-src 'report-sample' 'nonce-oXtL4fMYR0uYTvsCGxZ-rQ' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self'",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:24:51 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwV0HtUVVUeB_CrfO_dgrZ8JCrajBYrERTloZLG3YiaUw0qcOGee87ZRwSR1BCU8AGa2DJWPiFxYrIGJknN10g41TSZD0BIBAYBn-WkpoKaFuIMK0xpvvPHZ-3f-e29v7-zts-p_gF-XrYgivj_6jPcFjdmuO3HyaNtkyJG2wqo8c402-a2aNu4da_awobG2IR_jC0pMMYW2n8u2uyxuJIci6y1sXj7Xiyu5cQhqTAO88nVFIegJ3GYTGcD4zEwwIWc2S6MSXahZZ0LN_JYF7vw-JAL5fUuRPdJwAyaSe8RQhKg5iRgHtWtSkA9NVD6WwmIGpqIc36J6BydiAeNiYjq5cYdfzeGR7uxOtaN1xPduL_IjYFZbjx80429H7rxUpkbFY1urG1zo6THjZkDNFT7asj11_BuoIa7QRqCwzUsiNawZLYGW5yGUekaGnI0mHkaHuVruF6g4cgBDacPa_iqXEPXMQ2RVRoiqjU826ph3E0NPvc0fEOTh3kQ5OfBlgAPfKZ4sG66B-1pHpSs92BZkQc7dnswbI8HkXs9aCPXEQ_C_-7B2Rqeb-H5bg9e7q2j2ltHaT8dJ2nxIB0TB-sIG6Ijj8aP0-E9Xsff6DAVTNJxdYqOimk6ZsbqiNV0TFmoI-F1HXVLdaRk6Oi3XMfObB2t23U8-UjH7U_Y368jlRbRLwd1LP1ax5ATOtqrdUQ26mhrZU0t53Vc_l7H3Q7m_M7A8ucMTPU38CIdjjAQHG9glGngm6UGZq0yoFFpnoFrWwzkFRt4do-B_bUGxp42UF9voIEyGgzoVwxEXjfg22XgbreB8V4mNJpH258yoY8wkRRo4g4lh5qoCTOxaaqJ9yJNFNMnL5mYNMtE6hwT_i4T29JM9F1q4gBVZpqoopHZJp5aYWLwJhOJW014FZpIKTdReJSZx0yYx03cr-WcRhNxl00832HC-zcT5ULhpwCFDvKboHA1VOFSuELVDIVqqqGz1EytdJ4u0KBXFF6IUZhCUymSAjwKsabC-iQFx2sKM5Yo_GWlwt4chcBchWDKoLJ8hZXvKHTRI6osUqil7hKFxx8ptOxSWP6xwoI9Cv33K1wpV2j_XKHfFwo7TyqU0JpKBb1a4cEphftnWNcr_EplTZxHaFbYdV7h5gWFfRcVhl1SKKcKav5Woeg7hVtXFOquK7huKfyjXWH6PYXDHQp9Hiis-o_CwC6FnscKW3oUnu5lYS4sHOhj4RD9TDV9LcQPtpA8wsLqZyw8-b2FF0ZaiKQ1NN_fQiY9on-OteCewHu0LNTCTnoQZiHkRQudtCPKwpZoC0djLJyM5x7V6RbWGhY-I19l4c8LLBSkWqig7jQLXYssNC-2EJFpYdtyC4-zLPTQ_mwLjbkWMvItjNxooYrUZgtPF1jYV2ThKzpOv5ZYqPyrhd0HLXz3qYXv6So9_PJ9-9W8UvuS9aX2go9L7fvqSu09baX2_Mv_su-gFWVN9g20md6n0FEt9ijKGnbOvp5u7DtnLx910d6Ze8k-YM0le61vb8fzz_R2XKj2ctyiDnpEPdTrlJej643ZDmTPdtz80xxHJ42uiXVMpKR6pwhqcoqjPzjFCUq44RSvtDtF_G2n8L3jFH6USvJHp_gjje9wiu2_OEUx1dmkOGaX4jhVUhWdpjoq7y_F5wOk-IK-pCryHiyFfbgUgrzJh4wRUsSPkaKZho6T4hoNCZeidpIUkRFS-DqlCKCtUVJso_vTOWuGFD_PkqLxD1Kco-0vS1FBF2nrq1IUUr85UjjmShFBc-kgJcZJ4SYP6WSSRfPIzyVFETl0KaZRsSnFxvlSnEqW4p0U9lOlOJrO_8mUYla2FDkrpOhcKcWh1VKszpHiazqTy94aKR7Sf-k36rVWCi8CFdKdt6Q4sEGKI9Sez5yNUrxJeZSxSYrH29grlCL4XSk-oFLaVSTF_A-YWcK93VJ07ZUi5aAUC-lmuRQffirF7iNSxH3Gtz4hRVkNv2lirRQ_1Ukx-YwU4Q1STGiSIpSqzvL-RWZ_K8XYf0ux5wcpBvXt03p6Q6NjwO3K7iXPBadkLk_KzkpeuTA9OC0rMyN7YUZqcFr64tcWZb8RvGJxUlhI2OSQsLBJ40PCkpaF_A9iZKs7\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.es/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-bar-st..."
  }
  ```
</ResponseExample>


# Google Flights text search
Source: https://docs.brightdata.com/api-reference/serp/google-flights/text-search

Configure the Bright Data Google Flights Google Flights text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
```

## Parameters

<ParamField type="string">
  String representing flight search parameters

  ```txt wrap theme={null}
  https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ",
      "format": "json"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
        format: 'json'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/flights/search?tfs=CBwQAhonEgoyMDI2LTAzLTE2agsIAhIHL20vMGszcHIMCAISCC9tLzA0anBsGicSCjIwMjYtMDMtMjRqDAgCEggvbS8wNGpwbHILCAISBy9tLzBrM3BAAUgBcAGCAQsI____________AZgBAQ',
      'format': 'json'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={27} theme={null}
  {
    "status_code": 200,
    "headers": {
      "accept-ch": "Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version",
      "alt-svc": "h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000",
      "cache-control": "no-cache, no-store, max-age=0, must-revalidate",
      "content-security-policy": "script-src 'report-sample' 'nonce-rG9xWwDHOfDPrr2gBY9D3w' 'unsafe-inline';object-src 'none';base-uri 'self';report-uri /_/FlightsFrontendUi/cspreport;worker-src 'self' blob:, script-src 'unsafe-inline' 'unsafe-eval' blob: data: 'self' https://apis.google.com https://ssl.gstatic.com https://www.google.com https://www.googletagmanager.com https://www.gstatic.com https://www.google-analytics.com https://maps.googleapis.com https://maps.googleapis.com/maps/ https://maps.googleapis.com/maps-api-v3/ https://adservice.google.com/ https://www.googleadservices.com/pagead/conversion_async.js https://www.googleadservices.com https://www.google.com/tools/feedback/ https://www.gstatic.com/feedback/js/ https://www.gstatic.com/inproduct_help/ https://www.gstatic.com/support/content/ https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://support.google.com/inapp/;report-uri /_/FlightsFrontendUi/cspreport/allowlist;worker-src blob: 'self', require-trusted-types-for 'script';report-uri /_/FlightsFrontendUi/cspreport",
      "content-security-policy-report-only": "script-src 'unsafe-inline' 'unsafe-eval' blob: data: https://www.gstatic.com/external_hosted/d3/v5/d3.min.js https://translate.google.com/translate_a/element.js https://www.gstatic.com/_/mss/boq-one-google/_/ https://www.gstatic.com/og/_/js/ https://apis.google.com/js/api.js https://apis.google.com/js/client.js https://maps.googleapis.com/maps/api/js https://www.google.com/tools/feedback/chat_load.js https://www.google.com/tools/feedback/help_api.js https://www.google.com/tools/feedback/load.js https://www.google.com/tools/feedback/open.js https://www.google.com/tools/feedback/open_to_help_guide_lazy.js https://www.gstatic.com/feedback/js/ https://www.gstatic.com/feedback/js/help/prod/service/lazy.min.js https://www.gstatic.com/inproduct_help/api/main.min.js https://www.gstatic.com/inproduct_help/chatsupport/chatsupport_button_v2.js https://www.gstatic.com/inproduct_help/service/lazy.min.js https://www.gstatic.com/uservoice/feedback/client/web/live/ https://www.gstatic.com/uservoice/surveys/resources/prod/js/survey/ https://www.googletagmanager.com/gtag/js https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/destination https://www.gstatic.com/_/mss/boq-travel/_/js/k=boq-travel.FlightsFrontendUi_desktop_ms.en.2AgMd3uDtdI.2021.O/ https://apis.google.com/_/scs/abc-static/_/js/ https://maps.googleapis.com/maps-api-v3/api/js/ https://maps.googleapis.com/maps/vt https://maps.googleapis.com/maps/api/js/ https://maps.googleapis.com/maps/api/place/js/ https://translate.googleapis.com/_/translate_http/_/js/;report-uri /_/FlightsFrontendUi/cspreport/fine-allowlist",
      "content-type": "text/html; charset=utf-8",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-site",
      "date": "Fri, 27 Feb 2026 00:16:08 GMT",
      "expires": "Mon, 01 Jan 1990 00:00:00 GMT",
      "p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
      "permissions-policy": "ch-ua-arch=*, ch-ua-bitness=*, ch-ua-full-version=*, ch-ua-full-version-list=*, ch-ua-model=*, ch-ua-wow64=*, ch-ua-form-factors=*, ch-ua-platform=*, ch-ua-platform-version=*",
      "pragma": "no-cache",
      "reporting-endpoints": "default=\"/_/FlightsFrontendUi/web-reports?context=eJwVz3tUVVUeB_CrfM_dqLhEExFtRoulCArCVUCNuwlf0xQgcOGee87ZO0SRxBDioQ5oYstoShQCRyZLyEiMh4KQNZZpIY9EYFS0wtGZ0hTS1IAaVhDS_OaPz9q_vdfvtcc3T_LycDL5kGCy5P_x-Bmm8HkzTD8GzTUFBs81FZA9PWGmzDnLTQt2PmuyuIebmGe4Kd473BQwaQ16lCjcSIhCxo4ovHo_Ct9lRyO-MBprSfTFaPg8ikYQueQdg8leNmRH2DAvwYaunTZ8n0txiQ0jx2yoa7chzDkWK8hKcoDAPxYiMhbPk7ZtsWgnHSTllViEusfhqkccBubGob8zDqFj7LjraceMMDv-EmXHi3F2PNhox-QMO35-2Y6j79ixqtyO-k47dvTYUTpqx0pXFU1uKnI8VbzpreKejwoRpmI92RShwhStYnaKio5sFUauiuE8FTcLVDRUqzhfq-LTOhWDZ1SEnFMR3KTiiSsqFtxWMf6-ii9JQ7-KoOkO-Hg4kO_lwPilDuxc7kBvkgOluxx4qdiB_UccmF7hQMhRB3qIrcGBRR86cKmF8rscKPqJaoYceGashqZxGspcNHxBkqdoWDxVg2WahlyycI4GvwUaxvlpOE5qSUGghm-Xaqh_WsPKKA1RqoalGzTEvqihbbOGdakaXNI1HMzScKVIw6PDGn74gN6rNCSSjeTXGg2bP9Mw7XMNvU0aQjo19FyhmHR9peHafzTc66M-f9CR_qSOZZ46niK1wTp8Y3TMNnR8uVnH6m06VFKWq-O7fB25JTqeqNBR1apj_nkd7e06Okhqhw7tho6QmzrcBnXcG9Lh52RAJc-TookGtJkG4r0N3CUJAQZaLAbeWGbgQIiBEvLBKgOBqw0kRhrwtBnYl2RgwmYD1aQxzcA5MivLwMQtBqa-YSBurwGnQgPr6gwUnqaeZwwYZw08aKU5nQairxmY02dg3O8G6pjAQy-BPuKxUKAjQKB7kUD1CoEacpycIp-Q0-QMOUum_FlgSbjAUrKMhBAvh0CUIZAYL2B-QWDFJoFDWwWOZgt45wj4klRSniew9a8Cg2SYNBYLtJI7hwSGSgVGDgt0vSeQ_r7A-gqBSVUCe2sFbtQJ9H4k4PKxwMEvBErJ9kYBrUmgv1ngwQWK2wV-I-UXaS7BZYH3vhK4_bVA5TcC07sF6kg9ufwvgeLrNPeGQNtNgbg7Av_oFVh-X6C2T8C5X2DbLwKTBwVGRwTyRwUeGyOxBhLVzhLHyE-kZYLEqItEzFSJhJkSWY9LPPqjxJJZEiFkO1nrKZFMhskn8yXsC6mWpAdIHCT9Fgn_pyQGSA2XqCP7QyXywyRiV0qcDqecGIkLmsQOXeIkcRMSf18vUZ8oMZQkMbhR4nKyRHCaxL50iZEM2otUZUl05kik5knMel3iHBF7JB4rkKgslviUnCXHSiV-I43vSpyokjhSI_HzqbeUb3PLlE27ypQDr5UpBe-XKUNtZcrE3jIl79o_lf1kS_lFZTfZQ94iAbO7lFCSMf2qsovcqryq1M3-RhnI6VZct3crscuvK7OmjTVnEq_Hx5q_bnIy3yH9ZJj8TkzNTubBzAgzsiLMt_8WaR4gc1uizIvJw_xoc3y7lflctLLTt6zscxL7vZWF91pZxA9W5nbXyjxI6I9W9hzx67Oyol-trIS0mTj7UOHsJGkmLaRuEmcfuXL2MTlFzhHnqZzpMznbSWLmcea-gLNpizhrDeTsnSDOSsnMYM7crJzNI3tDOdtHGldw5rqKs19Wc9b2J86ukKJnOKsn18neZzkrJC6RnE1Yw1kwWUNqiLuNs2LytMZZiUH1CZwpiZx1pNDsNM6yt3A2sJWzbdmcfUYu5NCeOzgbRyYQN-JOPMgMUkDuvsJZ9W7OGkh3Hme9ZJiMEtNr1PN1zl4muWRkH2eZhZz5vsnZ26SMjCnibO3bnP23lP7wLuUfoX0rOHuumrNIsq6Gsw0k8xhnh05wVt7AWSWpItEn6d7C2RGyuJWzh-c5O9xGJ1ncQf_qpLxLnNWSFjL_35xV3OJsiovz-ebdnWbXE5XHW8c-6bsuLT0-KyNh64YU36SMtNSsDamJvkkpyS9szMr03ZIcb_G3BPlbLIF-_pb4l_z_BxaAqwI\"",
      "server": "ESF",
      "vary": "Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site",
      "x-content-type-options": "nosniff",
      "x-frame-options": "SAMEORIGIN",
      "x-ua-compatible": "IE=edge",
      "x-xss-protection": "0",
      "connection": "close",
      "transfer-encoding": "chunked"
    },
    "body": "<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://www.google.com.tw/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"strict-origin-when-cross-origin\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no,interactive-widget=resizes-content\"><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\"><meta name=\"color-scheme\" content=\"light dark\"><meta name=\"google-site-verification\" content=\"sxp7zFOFUzk09RdlFhuH2SoCn5nOkXgomiLeLIQ48p0\"><meta name=\"google-site-verification\" content=\"uceYfkdbu7tdKGywiwSr1p0cIbqdYOwMDkNq5jVFwMA\"><meta name=\"google-site-verification\" content=\"O5G3B9VUIil1GEVlPw3BfdeYn_kZeNd_6rsDolHah5w\"><meta name=\"google-site-verification\" content=\"hU5-JhTB7DyiEACObYa4GcZxXOTY5FykMqegq9lCAqA\"><meta name=\"application-name\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-title\" content=\"Google Flights\"><meta name=\"apple-mobile-web-app-status-ba..."
  }
  ```
</ResponseExample>


# Accommodation type
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/accommodation-type

Configure the Bright Data Google Hotels Accommodation Type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Accommodation type: Hotels or Vacation Rentals.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals
  ```

  | Parameter | Description |
  | - | - |
  | `brd_accommodation_type=hotels` | search for Hotels |
  | `brd_accommodation_type=vacation_rentals` | search for Vacation Rentals |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_accommodation_type=vacation_rentals',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Expedia.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.expedia.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&MDPCID=US.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID..RRID.bex_us_desktop&mctc=10&ct=hotel&mpg=USD&mpf=1260.01&mpj=165.01&mpr=0.00&mpl=USD&exp_pg=google&langid=en&ad=2&tp=&utm_source=google&utm_medium=cpc&utm_term=15438428&utm_content=localuniversal&utm_campaign=HotelAds&langid=1033&adults=2&children=&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "LateRooms.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/10344278261224262221.png",
        "link": "https://www.laterooms.com/en-us/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772145112009&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMTUxMiwiaWF0IjoxNzcyMTQ1MTEyfQ.pVyEg6L6lCxv6cPRFyjNpfB0TUyXhF3nMKxMFpl5Fi4",
        "price": {
          "value": 1091,
          "currency": "USD"
        },
        "cost": {
          "value": 1091,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1255,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1255,
          "currency": "USD"
        }
      },
      {
        "title": "trivago DEALS",
        "logo": "https://www.gstatic.com/travel-hotels/branding/8670591202796644526.png",
        "link": "https://www.trivago.deals/hotels/united-states_ny_new-york/555839_four-seasons-hotel-new-york-downtown?checkIn=2026-02-27&checkOut=2026-02-28&placeId=H555839&campaignName=TrivagoDeals_Google_US&currencyCode=USD&dealKey=CAIQjQYiDAiHlIPNBhCwn6r6AipMDQBgn0QVAKCURCWkcCNDLQAAYEAwATiBA0UAYJ9ESgwI_5ODzQYQvN3ZmwFiClN0YW5kYXJkIEtoAoIBAI0BpFifRKABp7sPqAHIBjCNBji_9iFAg_EPSAFSCMmhSmr8dVChWMgG&countryCode=US&languageCode=en&rule=Google_US&site=localuniversal&ads=&origin=31&priceDisplayedTotal=1275.00&priceDisplayedTax=166.94&device=desktop&adults=2&children=0",
        "price": {
          "value": 1108,
          "currency": "USD"
        },
        "cost": {
          "value": 1108,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1275,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1275,
          "currency": "USD"
        }
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C35500803_localuniversal_1%7C20260227%7Cdesktop%7Cuserdate|public|||1%7C2%7C0|0|EN&hotelid=35500803&checkin=20260227&checkout=20260228&rooms=1&currency=USD&displayedCurr=USD&POSCountryCode=US&taxDisplayMode=BP&cityID=3000016152&adults=2&land=L&metaid=d2XxBXAt9Q75gh58g80rgqUAp7eGbPmm2lOGeL-B98Cv9eZIJL71vRkCXUhToMuWAq02eP_0wolJcn74idh9EMoMIWERkOcRirTP5N-25r3ng__yZHMGbcm8uGrcCO4rPomRx4Z8cAUu28Fm_xUCfKHpSj8kHnrkYafIS6jaKpASCgi_93tPRnCurgskNwx-KGXwRa9wFWj9UK5rKrGL-6GSRrTGxJ8QJfvC0c6_eXAx8ncHeGDHyVDixNXfc_s2O1nJn3VV5qz-nsmBeP7NYnHYgrLgnvZsvnDE3qQSvyANAjC0wjOue-ukzYsCOxsknyyZS4FBSxlxvTedFkWTGNhXiR1XwE2VGKAessLp0nRGlGlF57PIXmXHPdtwxkuMbPSNG2Fj2tsTJPU2IFDyAu5dJq0w8PzZDKqo_zz2aXQ&dblcnt=true&user_num_adults=2&hc=1&pdtax=165.01&pdf=0.00&pdt=1260.01&locale=en-us&ad-src=&numChild=0",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=2&req_adults=2&show_room=59953503_336303630_2_0_0&lang=en&selected_currency=USD&exrt=1.00000000&ext_price_total=1260.01&ext_price_tax=165.01&xfc=USD&hca=m&group_children=0&req_children=0&&no_rooms=1&ts=1772147439&edgtid=HLaytVu3Rg63ysJnMVZ89w&efpc=EJWwChJgsBov&utm_source=metagha&utm_medium=localuniversal&utm_campaign=US&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-&aid=2127486&label=metagha-link-LUUS-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "KAYAK.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/6417d44c-c676-4b16-8ae9-f3bbeaa51899.png",
        "link": "https://www.kayak.com/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=165.01&pdtotal=1260.01&rpid=&uc=US&ucuc=USD&d=desktop&lc=en&v=false&rrid=kayak-us&k_pc=~UFJJQ0VMSU5FQ09SRQ&k_rt=&k_sid=xfCEJfSxh5&k_kct=1772134021&k_gct=1772138420&g=2&r=1&ac=2&k_cc=us&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.hotels.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&mdpcid=HCOM-US.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID.&adults=2&children=&mctc=10&mpf=1260.01&mpg=USD&mpl=USD&mpj=165.01&mpr=0.00&rffrid=sem.hcom.US.156.024.localuniversal.02.desktop-1.kwrd=GGMETA.15438428USen-20260227-N-ABW=1-camp=-aud=-N&rateplanid=208165427&mpm=24&mpn=201555591&mpo=EC&mpp=1&locale=en_US&siteid=300000001",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.tripadvisor.com/HotelHighlight?detail=10330604&m=66081&staydates=2026_02_27_2026_02_28&uguests=1_2_&supdv=desktop&supbl=localuniversal&supkl=selected&supuc=US&supul=en&supia=0&supip=0&supmb=6aNrQeoh_veGDR9dX-f0aOEdsUcZj5Q31Gw5clDcK_Fu4zF1GeGsOnOVJa9e7MR_KnfX3rKGSDeQQsmT6Fu24cI9HaGubkQHqyQ0E5ehxrVFNKk63aAjbUoCsSiqKx6927xbPPtjoyb17qFU0y7ZxcLIQ_DpkCq7fiwPuBC2ZCnZQGdlf9Q_0IvFHiZiWy&supmc=QxYxCBdEk5a3XPSaGFmqSaju7Qf6jOvQob64PgAfaVyE13Gv5RVlpLlVDuFBbHA&supts=&supey=m|108054|PL_GL_query&supcd=&suptp=XprnE0vplRKDYp2kABEBIznuo2xyToGgGWYdsvwlhP4Smi0WuliuoLoThxTL3JqLtbSyQJxLA1QMxUUTBEch6GHC8ZqA-6dtv2-0Ub-jrkdYi5y3MyZjBa2fp-IguJyBi3oewy-9R6Z0QXZlRw3BPYs4hJ-LOpTRGSB8haN2V8S4n4MCnSKxUYA50BFGm9&supas=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Best Hotel Deals",
        "logo": "https://www.gstatic.com/travel-hotels/branding/49083cad-a022-48f3-965c-36ee20bf8352.png",
        "link": "https://besthoteldealsglobal.com/property/417372?rooms=1&currency=USD&withTaxes=&startDate=27-02-2026&endDate=28-02-2026&occupancies=[]&utm_source=google&utm_medium=HAC&utm_content=27_02_2026_1_localuniversal_417372_US_desktop_selected___2&tp=1260.01&tt=165.01&sup=36&flow=%2B4WN5O7WD7WSgzbceYIoHHX0MI7VpgxqzhbmS%2BUBYlr3dUCPq366Mn0XfkpUkrMGy6LtvIVnpJcu4oBD0QX3pQ179e1tOfEWy%2FY2hFcpGs2YITpjv2TJ8AWVYwdU72H6CHcpzR%2BsP7shBgVtu7N%2BkniytT2WXwtJfej30gGk9LdTWyBml2lBBvgxR%2BNbXllBO%2B8etQNuhz5oCCOikyFkG3EIj7FXCjYGVo3xyy5GM%2BcLvNYiW2U1ypi7jaG4%2FDky&room=M72TrTcF-z0",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Brek",
        "logo": "https://www.gstatic.com/travel-hotels/branding/5560284514445840289.png",
        "link": "https://www.brek.com/search?lat=40.713038&lng=-74.008777&checkin=2026-02-27&checkout=2026-02-28&pinned=6473b44aa1d24283bbe42fcf&utm_source=gha&ep=7f51dcbc8ed03f8df50a8a49eb0402650a92a1a8ba5dbe12a0f87c1c4f5501fd4419ca8e2e4156d66771f793703a654de6447d9afa684dd9aaf23720365ab52b&user_currency=USD&user_country=US&user_language=en&user_displayed_total=1260.01&user_displayed_tax=165.01",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "My Luxury Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/11153979922261788882.png",
        "link": "https://www.myluxuryhotel.com/en-us/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772145095008&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMTQ5NSwiaWF0IjoxNzcyMTQ1MDk1fQ.eaf9u-R2X_MoqA1wS2497dtIF5aENREAaAwjbyctIe0",
        "price": {
          "value": 1091,
          "currency": "USD"
        },
        "cost": {
          "value": 1091,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1255,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1255,
          "currency": "USD"
        }
      },
      {
        "title": "dealbase.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1776272071000195501.png",
        "link": "https://deals.dealbase.com/?sig=d24b78db5ff27b2a7633c125e8c1eb65fcdd29bfbe8d2468da3702f8e475011131373338383435313339&turl=https%3A%2F%2Fwww.dealbase.com%2FHotel%2FSearch%3FcheckIn%3D2026-02-27%26checkOut%3D2026-02-28%26currency%3DUSD%26forceCurrencyChange%3D1%26lang%3Den%26forceLanguageChange%3D1%26rooms%3D2%3A%26utm_source%3Dgha%26utm_medium%3Dcpc%26hotelId%3D3021724%26userCountry%3DUS%26profile%3Dr2d2m73kn8%26preferredRate%3D1260.01%26label%3Dsrc%253Dgha%2526cltype%253Dhotel%2526datype%253Dselected%2526gsite%253Dlocaluniversal%2526vf%253D0%2526ucountry%253DUS%2526udevice%253Ddesktop%2526hotel%253D3021724%2526day%253D27%2526month%253D02%2526year%253D2026%2526los%253D1%2526price%253D1260.01%2526currency%253DUSD%2526cid%253D%2526listid%253D%2526rateid%253DUS_D%2526closerateid%253D%2526promo%253D0%2526isPrivateRate%253D0%2526isAudienceUser%253D0%2526isPaidClick%253D0%2526%26cp%3DyUWhQl3bpMkCgtkZC13ZklnMDRMZximlIPNBiACOLm-9_EKQhgIhtD7-c7_5MGzARC81wYg9YABKgNVU0Q",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Travelocity.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_185.png",
        "link": "https://www.travelocity.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&MDPCID=travelocity-US.META.HPA.ORGANIC.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID..localuniversal&exp_curr=USD&exp_dp=1260.01&exp_tx=165.01&mctc=10&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Clicktrip.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/3461ae67-c427-4ecf-a48f-524b530be084.png",
        "link": "https://clicktrip.com/hotels/details/eKzWHKZDZDDlDDnIV9pF8qNnAbhMcxfrOmM00LuP-WamvbZ1-jtu49IoKCbxw3Y8vVFyXMqWN5K9IYDBKxI2Jw82Ggv8qorO0tVTqMNJXoPqay9LOI44T3WIx6C5hvreAqaPxrm-U0O_6uD9w-WmOQ2?locale=en&currency=USD&pos=US&date_type=selected&taf=4VuIiZxdMhc_k7eO7eQG044Ux2a0jvNQY-a16ZfgBOwo9Q-yTXiyQYIDPE2yG5xO0&verification=false&clk_src=",
        "price": {
          "value": 1093,
          "currency": "USD"
        },
        "cost": {
          "value": 1093,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1258,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1258,
          "currency": "USD"
        }
      },
      {
        "title": "Bookhotel.direct",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15717022029370921658.png",
        "link": "https://always.bookhotel.direct/119578/?checkin=2026-02-27&checkout=2026-02-28&nb_adult=2&nb_child=0&campaign=localuniversal&tracker_id=&device=desktop&currency_code=USD",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Hotwire.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_112.png",
        "link": "http://www.hotwire.com/hotel/details/direct-retail-details?startDate=02/27/2026&endDate=02/28/2026&selectedExpediaHotelId=15438428&numAdults=2&numChildren=0&sid=S537&bid=B381549&rpid=RPE15438428&mctc=10",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Halalbooking",
        "logo": "https://www.gstatic.com/travel-hotels/branding/12381662496648659742.png",
        "link": "https://halalbooking.com/en-us/p/83701?checkin=2026-02-27&checkout=2026-02-28&groups%5B%5D=2&currency=USD&US&localuniversal&&adType=0",
        "price": {
          "value": 1260,
          "currency": "USD"
        },
        "cost": {
          "value": 1260,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Orbitz.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_100640403.png",
        "link": "https://www.orbitz.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&MDPCID=ORBITZ-US.META.HPA.ORGANIC-desktop.HOTEL&MDPDTL=htl.15438428.20260227.20260228.DDF.1.CID..AUDID..localuniversal&exp_curr=USD&exp_dp=1260.01&exp_tx=165.01&mpr=0.00&mctc=10&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Hotelscombined.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b73f8d82-aa66-4ac5-861d-52bce84c9ae5.png",
        "link": "https://www.hotelscombined.com/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=165.01&pdtotal=1260.01&rpid=&uc=US&ucuc=USD&d=desktop&lc=en&v=false&rrid=kayak-us&k_pc=~UFJJQ0VMSU5FQ09SRQ&k_rt=&k_sid=xfAER-M11F&k_kct=1772134021&k_gct=1772138413&g=2&r=1&ac=2&k_cc=us&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Bluepillow.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.bluepillow.com/search/594397817c00cb0e643c3237?begin=2026-02-27&end=2026-02-28&block_id=-b,8Uf4rkAjzDRsZGMlbZ2L3P6MncHRCisqAlmPM2fDVh-MWFeydaDGybaxsDOk5RRq,-bkng-Hotel&adults=2&childs=0&infants=0&childrens=0&country=US&currency=USD&language=en&source=localuniversal&utm_campaign=hotel&prid=",
        "price": {
          "value": 1260,
          "currency": "USD"
        },
        "cost": {
          "value": 1260,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "müv AI",
        "logo": "https://www.gstatic.com/travel-hotels/branding/2710211444546704077.png",
        "link": "https://muvtravel.com/xp-hotel?hotelID=116119126&checkinDay=27&checkinMonth=02&checkinYear=2026&nights=1&num-guests=2&checkoutDay=28&checkoutMonth=02&checkoutYear=2026&PROMO-CODE=98010",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1917614&CkInDay=27&CkInMonth=02&CkInYear=2026&CkOutDay=28&campaignid=&CkOutMonth=02&CkOutYear=2026&SearchDateType=selected&NumberOfAdults=2&LT=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=206039&RoomID=11135628&masterRoomId=8697863&PriceTax=165.01&PriceTotal=1260.01&RatePlan=11c82d85-6e23-a66f-2295-8189e6e0d078&UserCountry=US&Currency=USD&UserDevice=desktop&Verif=false&rr=row_desktop&audience_list=&mcid=3038&booking_source=cpc&adType=0&mpt=RW00d0FIT1Q4ZnUzUGxyZWszcEUwZGNrOGsvL0hjN1BDK3hPT0owUXpDdndMdHM4dzZqOSt4Mis5emNGcisvOHo2SHl5QW5zQ0xkVQ&original_rr=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Closest Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15292798194442829381.png",
        "link": "https://closesthotel.com/googleRedirMainSearch.php?checkInYear=2026&checkInMonth=02&checkInDay=27&checkOutYear=2026&checkOutMonth=02&checkOutDay=28&numberOfNights=1&numberOfAdults=2&numberOfChildren=0&numberOfGuests=2&hotelID=15438428&roomID=201555590&currency=USD&deviceType=desktop",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "AsiaYo",
        "logo": "https://www.gstatic.com/travel-hotels/branding/42906b93-548c-4f41-b994-b55cb3ff88e8.png",
        "link": "https://asiayo.com/en-US/v/80171/?check_in_date=2026-02-27&check_out_date=2026-02-28&adult=2&currency=TWD&aff_id=269&utm_source=google_hotelads&utm_medium=cpc&utm_campaign=&click_source=freelinks",
        "price": {
          "value": 1096,
          "currency": "USD"
        },
        "cost": {
          "value": 1096,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1261,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1261,
          "currency": "USD"
        }
      },
      {
        "title": "BusinessHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7e9b18f5-dcd9-46e2-8bed-33a004b33995.png",
        "link": "https://www.businesshotels.com/reservation.php?hotel-id=701383248&checkin-date=2026-02-27&checkout-date=2026-02-28&language=en&USER-CURRENCY=USD&USER-COUNTRY=US&NUM-ADULTS=2&NUM-CHILDREN=0&prid=",
        "price": {
          "value": 1099,
          "currency": "USD"
        },
        "cost": {
          "value": 1099,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "CheapTickets.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/736aa480-c3ae-4b4d-ac2a-1c658f70d17a_%5BUngrouped%5D.png",
        "link": "https://www.cheaptickets.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&MDPCID=CHEAPTICKETS-US.META.HPA.ORGANIC-desktop.HOTEL&langid=1033&adults=2&children=&MDPDTL=htl.15438428.20260227.20260228.DDF.1.CID..AUDID..localuniversal&exp_curr=USD&exp_dp=1260.01&exp_tx=165.01&mctc=10&rateplanid=208165426&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "ZenHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/4183134106872331441.png",
        "link": "https://www.zenhotels.com/go/rooms/8022177/?dates=27.02.2026-28.02.2026&cur=USD&lang=en&utm_source=google_hotelads&utm_medium=cpc-metasearch&partner_slug=google&guests=2&from=four_seasons_new_york_downtown.1260.USD.sr-019c9be3-1284-70eb-84e0-ed0617379557&utm_campaign=en-US&price=one&scroll=prices&partner_data=2Vk7OQ5B-Ei-a0Sd2W9UqkGcmNL7gxYoYqOF-VyfRlt7SiWA6WgSgo2l02c-potPklIapUCMvDPqPKn04VtVXU2pz-Kq0Is3J7XukRTz7QLYS1iT-EV2B5JW5SX2DCD3h7uYOw7h_OVPZnnGubJP74tO3AsP-RZJpv80eX6KeNWALHMf&utm_content=GoogleCPC&utm_term=gacid_.bw_1.los_1.dow_Friday.dtype_selected.hid_8022177.rid_109.aud_.d_desktop.ad_0.ctype_hotel.promo_0.apireqtype_deals=disabled&showed_price=1260.01&showed_taxes=0.00&member_deals=true",
        "price": {
          "value": 1260,
          "currency": "USD"
        },
        "cost": {
          "value": 1260,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "eDreams",
        "logo": "https://www.gstatic.com/travel-hotels/branding/05208793-cd83-4e8b-b76c-7ff346e093e3.png",
        "link": "https://accommodation.edreams.net/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&mpf=1260.01&cur=USD&mpj=165.01&wapb3=|c.506950|l.en_US|t.meta|s.ghs&MDPCID=eDreams-US.DPS.Edreams.MetaSearch-GHA.HOTEL&mpl=USD&numberOfRooms=1&locale=en_US&rffrid=h4p.hcom.US.ghaodigeo.000.000.kwrd=&pos=EDREAMS_US&rateplanid=208165427&mctc=10&utm_medium=metasearch&utm_campaign=495029696&utm_term=hotel&utm_source=FREEBOOKING",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Amimir.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/11504568723871247728.png",
        "link": "https://www.amimir.com/en/book/?start=27%2F02%2F2026&end=28%2F02%2F2026&hotelId=84085&highlightHotel=true&hab1=2&ehab1=&metasearch&utm_content=84085&checkV=false&totalPrice=1258.07&userCountry=US&utm_source=googleMetasearch&utm_medium=organic&currency=USD",
        "price": {
          "value": 1093,
          "currency": "USD"
        },
        "cost": {
          "value": 1093,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1258,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1258,
          "currency": "USD"
        }
      },
      {
        "title": "momondo.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_970163321.png",
        "link": "https://www.momondo.com/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=165.01&pdtotal=1260.01&rpid=&uc=US&ucuc=USD&d=desktop&lc=en&v=false&rrid=kayak-us&k_pc=~UFJJQ0VMSU5FQ09SRQ&k_rt=&k_sid=xfCEA4qdZ8&k_kct=1772134021&k_gct=1772138449&g=2&r=1&ac=2&k_cc=us&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Despegar",
        "logo": "https://www.gstatic.com/travel-hotels/branding/dab7f37a-3d20-4722-9e39-5eaf50330388.png",
        "link": "https://www.trackeame.com/sem-tracker-web/track?kw=2099025_201555590_localuniversal_US_en_USD_1.00000000_2026_02_27_1_1260.01_false&clt_c=HPA-US&clt_n=gh&d=c&cm=HPA_US&pr=H&campaignid=&targetid=aud-&hpa_dd=selected&hpa_ppa=0&clk_src=&u=https%3A%2F%2Fwww.us.despegar.com%2Faccommodations%2Fresults%2FCIT_5227%2F2026-02-27%2F2026-02-28%2F2%3Fchosen_accommodation%3D2099025&google_site=localuniversal&displayed_price=1260.01&country=US&lang=en&crawler=false&partner=4&hotprv=cHc6RVhQ&utm_source=HPA&utm_medium=referral&utm_term=2099025_201555590_localuniversal_US_en_USD_1.00000000_2026_02_27_1_1260.01_165.01_false&utm_content=US&utm_campaign=&cc=US&key=UT81AK9JAFEGJ4D69OVO6J673E&selected_room_pack=321060990",
        "price": {
          "value": 1095,
          "currency": "USD"
        },
        "cost": {
          "value": 1095,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1260,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1260,
          "currency": "USD"
        }
      },
      {
        "title": "Traveloka.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/cc46874d-c374-4a99-83c7-b6f79d0b19d3.png",
        "link": "https://www.traveloka.com/en-en/hotel/search?spec=27-02-2026.28-02-2026.1.1.HOTEL_GEO.4005128638.New%20York%20State.2&hotelId=1000000601517&contexts=%7B%22accessCode%22:%2290975GHAD1305desktop%22%2C%22metasearchRequestId%22%3A%22cb5f2e56-846c-4e98-ada0-3a1b1aa861ff%22%2C%22plc%22%3A%22Uz%2F51aey53IgPjFiTs8zCqt%2FEzVSVv3B37GI8CihLxgZQ4P2RnJ4vXuEz6mydh0QWSafPGCMr%2FG%2FGO8e%2BT5i%2Fg%3D%3D%22%7D&metasearchId=GoogleHotelAdsUser&metasearchRateId=desktop&metasearchRatekey=sgyUU2M0LrnnpXh1LPwoI&priceDisplay=TOTAL&metasearchRefid=12345678910abcdefghijk@-&adType=0&PPA=0&hotelCampaign=1&cur=USD",
        "price": {
          "value": 1264,
          "currency": "USD"
        },
        "cost": {
          "value": 1264,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1264,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1264,
          "currency": "USD"
        }
      },
      {
        "title": "Traveluro",
        "logo": "https://www.gstatic.com/travel-hotels/branding/aa5293d0-1acc-4289-ab28-fe6381cfbe5a.png",
        "link": "https://www.traveluro.com/hotels/united-states_ny_new-york/555839_four-seasons-hotel-new-york-downtown?checkIn=2026-02-27&checkOut=2026-02-28&placeId=H555839&campaignName=Google_US&currencyCode=USD&dealKey=CAIQqwEiDAj3k4PNBhD48pvoAipMDQBguEQVAKCURCVmJj1DLQAAYEAwATiBA0UAYLhESgwI8JODzQYQpL-FiQJiClN0YW5kYXJkIEtoAoIBAI0BmlG4RKABp7sPqAHIBjCrATi_9iFAg_EPSAFSCJRlQNrVaJT-WMgG&countryCode=US&languageCode=en&rule=Google_US&site=localuniversal&origin=31&ads=&priceDisplayedTotal=1475.00&priceDisplayedTax=192.65&device=desktop&adults=2&children=0",
        "price": {
          "value": 1282,
          "currency": "USD"
        },
        "cost": {
          "value": 1282,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1475,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 1475,
          "currency": "USD"
        }
      },
      {
        "title": "luxuryescapes",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7619586669298897040.png",
        "link": "https://luxuryescapes.com/us/metasearch/dce147fd-8580-435a-a8ad-dffadf3194e1?utm_bp=3&source=metasearch&checkIn=2026-02-27&checkOut=2026-02-28&propertyName=Four%20Seasons%20Hotel%20New%20York%20Downtown&propertyId=bedbank%3Adce147fd-8580-435a-a8ad-dffadf3194e1&roomTypeId=387f93e3-4179-4bab-bbc3-53c89c496ac3&roomRateId=387f93e3-4179-4bab-bbc3-53c89c496ac3_1_pkg&adults=2&children=none&utm_source=google&utm_medium=organic&utm_content=gha-lpp&currency=USD&priceTotal=2937.36&ruleId=B2C&userCountry=US",
        "price": {
          "value": 2555,
          "currency": "USD"
        },
        "cost": {
          "value": 2555,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 2937,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 2937,
          "currency": "USD"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels async request
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/async

Use the Bright Data Google Hotels async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQGRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASABEgKkQPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3WZxVwX7M7SdQk8bv9GVdk2wUCRA&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xnOTripjyZxILxkGgM1cYmQNCrIY1AgC49RisFNimj2Fshwx2QGIQcEqMKtGUPMMgiTEEzO4iBsB7TbE47tH61of_7vI_YBVxRVepXz1HrN4BiNtYi4Ah55Rj-ClCQiYnxdsj2Tpfv5eCDvZZSbZZLfUosmTOb06MxTGypuYoqum1sM7IVOBEd69gXyVDP61aNCFq1_pfxvUA6hH4zIOqsaudDn5pkTw"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAEEgLuCvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0cXRg9LtSvb94BUoXNgy8J04C5QQ&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 27"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAFEgLqhPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1ar70DInUs8eU0WRh2f8RzL1QKww&adurl=",
            "extensions": [
              "Suite 3 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2440,
              "currency": "USD"
            },
            "cost": {
              "value": 2805,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2805,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAGEgKKYfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3Tw83cHkve-fjPnlHEu96gRaGYag&adurl=",
            "extensions": [
              "Suite 4 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2540,
              "currency": "USD"
            },
            "cost": {
              "value": 2920,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2920,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiABEgLFyPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0Uc0x_tn6Dpzw1hNIA3bvO-V8XeQ&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiACEgLJMfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-IaI3Wc2iZiz04F2g0iO4omJcxw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiADEgJLvPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1l9E4tRWWXqZXljR31RIHW1CjIRg&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAEEgL_UvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2kR-kPDdNnb1lcBUNkpM5s-Q_yLw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAFEgKVwPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0ZrJRz7IXgFt5CcI54GIb2V_aOEA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wuMW97qyG0dgi5Gj5Nob9SzWQ170RVssqu5Fios_swsegU93lsHLoiTo_9hPSttkpklB0QBmU3t8wNPCQgylOL-NJIgsqbtdxI9d0gUE0XKG75M-LzpdyK3M_cTzH8nIl8lL0Sg42N7pxz2ygDzoP-qsR7LH3Hj-q4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAGEgLyS_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0iD3vQeRSxwkBcCu0F0NEdbpHPBQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yWbtP4vz4gyFOxx-uO3-5Qz-n7oPrXCYz5CjsOYpGwfd4vSy9B9DmddpQ72H1LjiPhk20d5mt6c1lijronkH7FfBq_eJpzEc5CHGZ7teq5zP3sV-Qv2c7VwXXrPvClVawgmkgAWf80sXLQrVzreBLAZ8lA7k1Ud8YY"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAHEgJD9_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-qvLSoH3qtZl1Jzkpvr6iRQtDug&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1070,
              "currency": "USD"
            },
            "cost": {
              "value": 1231,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1231,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAIEgK2a_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1zUSId1nUwCQq7yh4XLKuB1Ohivg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1135,
              "currency": "USD"
            },
            "cost": {
              "value": 1306,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1306,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAJEgJde_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_22y9VcsfNpoGEERdBgj2VqhrAopg&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1170,
              "currency": "USD"
            },
            "cost": {
              "value": 1346,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1346,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAKEgJvsfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2U0x0rvKUK5FsuuDInhoRPaeosTQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wzZm0OmUCedgu3fTY7PUUPLbLCV5zcQfVDJeHlIBCvk_avmplnbY5FYHLBDZKrSL5xDNRYIn5kBNf-pTzMl2LYIG88MTku07E2_2upUCMIEmY5ZBgeEaPLdgYIcJi5ZTmfLknhkRwQxfF_ZBA8n0mDClKJ3zKe-XUZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiALEgIye_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_34I7FZ_rEBXGJThi3NhYqDuWYI3A&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAMEgIFE_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3ti3aEDih8ZhM7xCfbWZFN0AcKQg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y4BiOX0ESx2hQ7R1AbK80n3kIom2QrPE77qx5wQvFyLUGAipd0VVxl3bzztdN3u3e0coud9niym1jM0s4UhuNUWRzj21SpdUKFbMiimNpy6v_iUqVvWpe-e3YUNId8uEmwiUehwTzNU9zmegcaboD_rrmY0mNts-tK"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiANEgLNU_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0LHnRl4WLtqnzsap0aQqFfKg1BbQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAOEgJKvvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2S_jbXgWlzoU8K7yog2CEpOluqOg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3870,
              "currency": "USD"
            },
            "cost": {
              "value": 4446,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4446,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAPEgKOW_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2C1L5MfDLw9PVpTdVQNSYIu3EKvA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 4070,
              "currency": "USD"
            },
            "cost": {
              "value": 4676,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4676,
              "currency": "USD"
            }
          }
        ]
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels currency
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/currency

Configure the Bright Data Google Hotels Google Hotels currency parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Currency to show prices at (3-letter code).

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR
  ```

  | Parameter | Description |
  | - | - |
  | `brd_currency=USD` | United States Dollars |
  | `brd_currency=EUR` | Euro |
  | `brd_currency=INR` | Indian Rupees |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_currency=EUR',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={12} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "EUR",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "trivago.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1922649917165881388.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQAxoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYASABEgIMmPD_BwE&category=acrcp_v1_48&sig=AOD64_0a1P9Yt88LhcGZJx58EjOh4fTiVQ&adurl=",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQDhoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYAiABEgJjdvD_BwE&category=acrcp_v1_48&sig=AOD64_2x9Ta0FB6YBsRCvcIyd_qLExGNhg&adurl=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Bluepillow.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQARoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYAyABEgLOGfD_BwE&category=acrcp_v1_48&sig=AOD64_215l665ommkn4MPu9h1G6vz_UrQg&adurl=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQBRoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCABEgL5ovD_BwE&category=acrcp_v1_48&sig=AOD64_2-wbT67uRZ3dpG-n84czp3pFidvw&adurl=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ySiIEbCWYVgsWXAcT9P6GEaGc7OIZTLS03_DwOCK8IfvGbD_qIjGfPO3Eqe2ujdp686Jxaub2fQPluNbPelOp1hXNH1wTqhWRTw5yvK3qB_eDVgGDDZjnm-Y8JdMbrXO8mvoFY9XldhKGW0xzs8vHzPlebVX5jVqIXrZZrBft7bw1oadabdwy0BcKwTI-5__z5UG9mhDZhf8RBL3tbtlCP7ltZNmSUmDI"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQBhoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCACEgI7h_D_BwE&category=acrcp_v1_48&sig=AOD64_0rd_VmXo7-De_CV-0ExmLlkshY3w&adurl=",
            "extensions": [
              "1 king bed Suite"
            ],
            "price": {
              "value": 1068,
              "currency": "EUR"
            },
            "cost": {
              "value": 1068,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1068,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQBxoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCADEgJQuvD_BwE&category=acrcp_v1_48&sig=AOD64_06FeYrVdQVj2GCjqiw5cSL3W2EqA&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1068,
              "currency": "EUR"
            },
            "cost": {
              "value": 1068,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1068,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x0k4J54-9hPcjZD7dI7EPSPf0jTgUSjiBzg_tByN6hA54CETEg-NP6EA5YePboKLIbBc9zfFEJI8qMPNEkn_Dg4x6PZmLFAguh18RWhPqnEe7F0MXgyquSdIau9nfZMj1Jp6XO7lXEbcdWhWTf4fBGzfHV-xO01KiviU2RG-oP3o4kVsl08GcV8X6JTEI3qBUCHdelt_CbLOIdsouRqf00MT5QTTiDYw"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQCBoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAEEgJFAfD_BwE&category=acrcp_v1_48&sig=AOD64_3lylte3x_RmGQW44vvQhE6qAvZtg&adurl=",
            "extensions": [
              "2 double beds"
            ],
            "price": {
              "value": 1136,
              "currency": "EUR"
            },
            "cost": {
              "value": 1136,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1136,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQCRoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAFEgL_o_D_BwE&category=acrcp_v1_48&sig=AOD64_3df6i4XI55YVbJvdWR__d5rEYfCg&adurl=",
            "extensions": [
              "Suite 3 guests Suite"
            ],
            "price": {
              "value": 2587,
              "currency": "EUR"
            },
            "cost": {
              "value": 2587,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2587,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQChoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAGEgLXVPD_BwE&category=acrcp_v1_48&sig=AOD64_0dw_Q6x9sTC-35v0n_kmxtedJHvg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2685,
              "currency": "EUR"
            },
            "cost": {
              "value": 2685,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2685,
              "currency": "EUR"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xLdqHwg-K7pMN18a6KDqVtRcOabuwWmRDA9Ri89kjhhMaoUIFccHAFXxdPlbGIrmAFrFEwTYVNMlTko89AmvqhuKF6AzR_Zm2bR3SKvfMn0z3CW6TofCz--cn3CxsVtGwx3SBS_v65LF2ZmOok40URqrq4dSUDR5Am6tvGc80Q_36-CwXtqCle7Spq_JTdhla34xp125Rh6E1uUredhS0dwj-hO6-8yfU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQCxoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAHEgJIjfD_BwE&category=acrcp_v1_48&sig=AOD64_1nBZEah-EtAFDiTpoMosV0xSc5cg&adurl=",
            "extensions": [
              "Suite 3 guests Suite"
            ],
            "price": {
              "value": 3312,
              "currency": "EUR"
            },
            "cost": {
              "value": 3312,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3312,
              "currency": "EUR"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xLdqHwg-K7pMN18a6KDqVtRcOabuwWmRDA9Ri89kjhhMaoUIFccHAFXxdPlbGIrmAFrFEwTYVNMlTko89AmvqhuKF6AzR_Zm2bR3SKvfMn0z3CW6TofCz--cn3CxsVtGwx3SBS_v65LF2ZmOok40URqrq4dSUDR5Am6tvGc80Q_36-CwXtqCle7Spq_JTdhla34xp125Rh6E1uUredhS0dwj-hO6-8yfU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi_sZGVpviSAxVnmFAGHYDeBe8YACICCAEQDBoCZGc&co=1&ase=2&gclid=EAIaIQobChMIv7GRlab4kgMVZ5hQBh2A3gXvEAoYBCAIEgLL8vD_BwE&category=acrcp_v1_48&sig=AOD64_3zx3DbaGC1ciFl6mLJhqLWgWQJQw&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 3409,
              "currency": "EUR"
            },
            "cost": {
              "value": 3409,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3409,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "Super.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/cfa60c4a-13cd-46d3-9354-ec90c89ec855.png",
        "link": "https://www.super.com/travel/transition/?data=price=1017.4%26total_price=1170.89%26request_id=956ec49d-d194-4af5-b758-2a58b74df765%26ps=2178426524%26pp=MgpT26Ar_fcoyoSJr1OvFQ%26pb=J7O9V0FK0H7qVJjJTsKzWF5_O0c5XWr3ek5m89szLIEMFJC5Zxe8VDWcig3FYaBJx82ChZgnnEaEKIED4H1cTPfPJ24SjAKYEXQkaH-YIcnnjpAh23C7mZfjHcN7sssiZPdvWay6qRjU27cO8gpEQVdcujXFJsXAsQsmspk_MWUMq1NtVdg6hHJC6SWR302ZUzvKG4tCBXKzrkXNELop4dLQfw2gxlPp1aF42o5m9tU8pS0LG3dORQDmpQjlUU3vDVda4nVQax6lTNBAULvH-aGSfRQcIcp0ghvVAuCCILpIO4b3lrtg6obiJ9Ukj2r-2JPCoi52ZR0MZWq-wluUI6-p4MpbUEP4XxV5oP4407O-p_XSpzHYPZ0YM2tcjdbpRAvcW6QNh7LdFnKjr7UHnw%253D%253D%26gha_pull_request=True%26rtp=SdTUqdR7wIew8aRS9esAtw%253D%253D%26risk_lk_1=true%26alwd_risk=false%26alwd_rand=false%26gt=1772146882%26sg=1vDpD%26sid=GHA_MD7%26cmab_id=11%26ttl_bkt=none%26all_inclusive=false&utm_source=gha&utm_content=localuniversal&currency=USD&user_country=DE&verification=false&rate_rule_ids=&date_type=selected&rate_rule_id=signedout_desktop&display_currency=EUR&display_all_inclusive_price=992.56&checkin_at=2026-02-27&checkout_at=2026-02-28&provider_hotel_id=10007072903&provider=ean&num_adults=2&children=[]&hotel_campaign=&utm_campaign=&user_locale=en-DE&user_list_id=&utm_medium=organic&utm_id=gha_organic",
        "price": {
          "value": 993,
          "currency": "EUR"
        },
        "cost": {
          "value": 993,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 993,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 993,
          "currency": "EUR"
        }
      },
      {
        "title": "Expedia.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.expedia.de/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&MDPCID=DE.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID..RRID.bex_eu_desktop&adults=2&children=&mctc=10&ct=hotel&mpg=EUR&mpf=1066.47&mpj=139.66&mpr=0.00&mpl=EUR&exp_pg=google&langid=2057&ad=2&tp=&utm_source=google&utm_medium=cpc&utm_term=15438428&utm_content=localuniversal&utm_campaign=HotelAds&rateplanid=208165427&mpm=24&mpn=201555591&mpo=EC&mpp=1",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.tripadvisor.com/HotelHighlight?detail=10330604&m=66081&staydates=2026_02_27_2026_02_28&uguests=1_2_&supdv=desktop&supbl=localuniversal&supkl=selected&supuc=DE&supul=en&supia=0&supip=0&supmb=LawyZOnHWGTi5JureKez05Ux_4uzRfucwiwJO0Ur-EOZAGR2VATUEkIrCrQmFAl6hKCwChiBRN0oO91ccMkG_5Xt3rg_8uf1vJvHQcDHTGAGj6_NTAPi53B-zGoLJ5jYqfI-EEMFqC5i2g8cKPdPK-RErau2lMGv8CDvCDdShYpeP-VlWp3KAopc1dhACy&supmc=nQ4PpqcyHrfWrlYWf-P2yA5Xf3Hy9me7nAbFI2-lfjQWuqBigm4pDvLJVQzDnk3btwQ&supts=&supey=m|110581|PL_PCE_query&supcd=&suptp=5n6zb51uz_KcZX6CABEBIznuo2xyToGgGWYdsvwlhBJQAQy77vvUy3X-i-Eq_4YDS6M7mCE36on5ok897M9AgVDe4FIBYuYhfwBLNsxEfgBPBfBdZd0gDtIPUCyQUdXqBXYdjaelpCzNDb92k-_tAy2dyFs9LQsl7W1iPhYjSz6Bq1KLu6gfsm1AaND5hw&supas=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "trivago DEALS",
        "logo": "https://www.gstatic.com/travel-hotels/branding/8670591202796644526.png",
        "link": "https://www.trivago.deals/hotels/united-states_ny_new-york/555839_four-seasons-hotel-new-york-downtown?checkIn=2026-02-27&checkOut=2026-02-28&placeId=H555839&campaignName=TrivagoDeals_Google_DE&currencyCode=EUR&dealKey=CAIQtwYiDAjToIPNBhDgh_r8AipJDQCAgkQVAMCURCVczwVDLXsUPkAwATiBA0UAgIJESgwIzqCDzQYQyNKakgJiClN0YW5kYXJkIEtoAo0B4YKCRKABp7sPqAHIBjDHBji_9iFAg_EPSAFSCCC2jaeiJp5SWNIH&countryCode=DE&languageCode=en&rule=Google_DE&site=localuniversal&ads=&origin=31&priceDisplayedTotal=1044.00&priceDisplayedTax=136.78&device=desktop&adults=2&children=0",
        "price": {
          "value": 1044,
          "currency": "EUR"
        },
        "cost": {
          "value": 1044,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1044,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1044,
          "currency": "EUR"
        }
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=DE_HP%7C35500803_localuniversal_1%7C20260227%7Cdesktop%7Cuserdate|public|||1%7C2%7C0|0|EN&hotelid=35500803&checkin=20260227&checkout=20260228&rooms=1&currency=USD&displayedCurr=EUR&POSCountryCode=DE&taxDisplayMode=BP&cityID=3000016152&adults=2&land=L&metaid=d2XxBXAt9Q75gh58g80rgqUAp7eGbPmm2lOGeL-B98Cv9eZIJL71vRkCXUhToMuWAq02eP_0wolJcn74idh9EMoMIWERkOcRirTP5N-25r3ng__yZHMGbcm8uGrcCO4rPomRx4Z8cAUu28Fm_xUCfKHpSj8kHnrkYafIS6jaKpASCgi_93tPRnCurgskNwx-KGXwRa9wFWj9UK5rKrGL-6GSRrTGxJ8QJfvC0c6_eXAx8ncHeGDHyVDixNXfc_s2O1nJn3VV5qz-nsmBeP7NYnHYgrLgnvZsvnDE3qQSvyANAjC0wjOue-ukzYsCOxsknyyZS4FBSxlxvTedFkWTGNhXiR1XwE2VGKAessLp0nRGlGlF57PIXmXHPdtwxkuMbPSNG2Fj2tsTJPU2IFDyAu5dJq0w8PzZDKqo_zz2aXQ&dblcnt=true&user_num_adults=2&hc=1&pdtax=139.88&pdf=0.00&pdt=1068.11&locale=en-us&ad-src=&numChild=0",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=2&req_adults=2&show_room=59953503_336303630_2_0_0&lang=en&selected_currency=EUR&exrt=0.84770000&ext_price_total=1068.11&ext_price_tax=139.88&xfc=USD&hca=m&group_children=0&req_children=0&&no_rooms=1&ts=1772146193&edgtid=fdRhqzYPRM2f0oYH7k-AUA&efpc=EJWwChJgsBov&utm_source=metagha&utm_medium=localuniversal&utm_campaign=DE&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-&aid=2127499&label=metagha-link-LUDE-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1917614&CkInDay=27&CkInMonth=02&CkInYear=2026&CkOutDay=28&campaignid=&CkOutMonth=02&CkOutYear=2026&SearchDateType=selected&NumberOfAdults=2&LT=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=206039&RoomID=11135628&masterRoomId=8697863&PriceTax=139.88&PriceTotal=1068.11&RatePlan=11c82d85-6e23-a66f-2295-8189e6e0d078&UserCountry=DE&Currency=EUR&UserDevice=desktop&Verif=false&rr=row_desktop&audience_list=&mcid=3038&booking_source=cpc&adType=0&mpt=TE9pb2F1RGhrNWtaeFZrU2c1M1NzQ2gxZzR0NnZkTnB0VlQ5TVNlWGVzQ25tR0NpY1VFa1dwRzhoOGRJeWFPcGwvWEVvVlZ4dGZSQQ&original_rr=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://de.hotels.com/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&mdpcid=HCOM-DE.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260227.20260228.DDF.1.CID..AUDID.&adults=2&children=&mctc=10&mpf=1066.47&mpg=EUR&mpl=EUR&mpj=139.66&mpr=0.00&rffrid=sem.hcom.DE.156.024.localuniversal.02.desktop-1.kwrd=GGMETA.15438428DEen-20260227-N-ABW=1-camp=-aud=-N&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1&rateplanid=208165426&mpm=24&mpn=201555590&mpo=EC&mpp=1",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "HolidayCheck.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/def67e1e-fba6-4e51-96c0-40a281bca824.png",
        "link": "https://www.holidaycheck.de/ho/angebote-/7767066c-094e-47fe-afc1-439d930a6a84/hotelonly?_offer=adults:2,departureDate:2026-02-27,duration:1,returnDate:2026-02-28,tourOperator:~eec21a06-f64e-3130-9dba-d57216c6e98e,travelkind:hotelonly&utm_source=google_hotel_ads&utm_medium=metasearch&utm_campaign=gha_&utm_content=-&utm_term=uuid_7767066c-094e-47fe-afc1-439d930a6a84_en_DE&trv_dp=1066.00",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Bookhotel.direct",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15717022029370921658.png",
        "link": "https://always.bookhotel.direct/119578/?checkin=2026-02-27&checkout=2026-02-28&nb_adult=2&nb_child=0&campaign=localuniversal&tracker_id=&device=desktop&currency_code=EUR",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Hotwire.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_112.png",
        "link": "http://www.hotwire.com/hotel/details/direct-retail-details?startDate=02/27/2026&endDate=02/28/2026&selectedExpediaHotelId=15438428&numAdults=2&numChildren=0&sid=S537&bid=B381549&rpid=RPE15438428&mctc=10",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "My Luxury Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/11153979922261788882.png",
        "link": "https://www.myluxuryhotel.com/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772146086550&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMjQ4NiwiaWF0IjoxNzcyMTQ2MDg2fQ.dhzFWTAvfp_DtzfgUmMtG8ice2_BZN0gYKpIYb4QzTU",
        "price": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost": {
          "value": 1064,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1064,
          "currency": "EUR"
        }
      },
      {
        "title": "LateRooms.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/10344278261224262221.png",
        "link": "https://www.laterooms.com/hotel/1137278/?ppc=true&isHotel=true&checkin=2026-02-27&checkout=2026-02-28&nights=1&rooms=%5B%7B%22adults%22:2,%22children%22:%5B%5D,%22kidsAge%22:%5B%5D%7D%5D&utm_source=GoogleHC&utm_medium=paid&utm_campaign=&utm_content=localuniversal&utm_term=1137278&pv=1772146675006&sourceToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJib29raW5nX2NvbSIsImV4cCI6MTc3MjIzMzA3NSwiaWF0IjoxNzcyMTQ2Njc1fQ.5tkEiOILQzpUsLdU3JOYYb9XbD8lzYIapq2unhu_S-Q",
        "price": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost": {
          "value": 1064,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1064,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1064,
          "currency": "EUR"
        }
      },
      {
        "title": "BusinessHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7e9b18f5-dcd9-46e2-8bed-33a004b33995.png",
        "link": "https://www.businesshotels.com/reservation.php?hotel-id=701383248&checkin-date=2026-02-27&checkout-date=2026-02-28&language=en&USER-CURRENCY=EUR&USER-COUNTRY=DE&NUM-ADULTS=2&NUM-CHILDREN=0&prid=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Bluepillow.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.bluepillow.de/search/594397817c00cb0e643c3237?begin=2026-02-27&end=2026-02-28&block_id=-b,8Uf4rkAjzDRsZGMlbZ2L3P6MncHRCisqAlmPM2fDVh-MWFeydaDGybaxsDOk5RRq,-bkng-Hotel&adults=2&childs=0&infants=0&childrens=0&country=DE&currency=EUR&language=en&source=localuniversal&utm_campaign=hotel&prid=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "AsiaYo",
        "logo": "https://www.gstatic.com/travel-hotels/branding/42906b93-548c-4f41-b994-b55cb3ff88e8.png",
        "link": "https://asiayo.com/en-DE/v/80171/?check_in_date=2026-02-27&check_out_date=2026-02-28&adult=2&currency=TWD&aff_id=269&utm_source=google_hotelads&utm_medium=cpc&utm_campaign=&click_source=freelinks",
        "price": {
          "value": 1069,
          "currency": "EUR"
        },
        "cost": {
          "value": 1069,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1069,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1069,
          "currency": "EUR"
        }
      },
      {
        "title": "Brek",
        "logo": "https://www.gstatic.com/travel-hotels/branding/5560284514445840289.png",
        "link": "https://www.brek.com/search?lat=40.713038&lng=-74.008777&checkin=2026-02-27&checkout=2026-02-28&pinned=6473b44aa1d24283bbe42fcf&utm_source=gha&ep=7f51dcbc8ed03f8df50a8a49eb0402650a92a1a8ba5dbe12a0f87c1c4f5501fd4419ca8e2e4156d66771f793703a654de6447d9afa684dd9aaf23720365ab52b&user_currency=EUR&user_country=DE&user_language=en&user_displayed_total=1068.11&user_displayed_tax=139.88",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "ZenHotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/4183134106872331441.png",
        "link": "https://www.zenhotels.com/go/rooms/8022177/?dates=27.02.2026-28.02.2026&cur=EUR&lang=en&utm_source=google_hotelads&utm_medium=cpc-metasearch&partner_slug=google&guests=2&from=four_seasons_new_york_downtown.1067.EUR.sr-019c9c2b-d68d-7c78-a6af-a6a06163fcdd&utm_campaign=en-DE&price=one&scroll=prices&partner_data=nZGSckkwDkOfgcLWqWv2vcv-UTDCi5daH71o5pjK7W-OzZMzCZLp3aLSboujat6T5cu61-6i62Ah2ooiUUoZpf65pHtjki-p9YAD_GjgK_nRtZ1HzDTdS08OoMnk7rlBgK9jjkI6KA4aB_pKCqXwzVI2vJ2Kp-nvQyoR1uUIWv7Ymeozew==&utm_content=GoogleCPC&utm_term=gacid_.bw_1.los_1.dow_Friday.dtype_selected.hid_8022177.rid_37368388.aud_.d_desktop.ad_0.ctype_hotel.promo_0.apireqtype_deals=disabled&showed_price=1067.00&showed_taxes=0.00&member_deals=true",
        "price": {
          "value": 1067,
          "currency": "EUR"
        },
        "cost": {
          "value": 1067,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1067,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1067,
          "currency": "EUR"
        }
      },
      {
        "title": "Clicktrip.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/3461ae67-c427-4ecf-a48f-524b530be084.png",
        "link": "https://clicktrip.com/hotels/details/eKzWHKZDZDDlDDnIV9pF8qNnAbhMcxfrOmM00LuP-WZM-OlC0YiY6C3Plhnh2GOzrDGz7YA8Ka7_uXd3G7xRkW1AOKukELWkE81NmUW9dkVer-LVrgdZ43GtxvmQKGMW5svx0yisY_dCqx09i4Xz7g2?locale=en&currency=EUR&pos=DE&date_type=selected&taf=4VuIiZxdMhc_k7eO7eQG044Ux2a0jvNQY-a16ZfgBOwo9Q-yTXiyQYIDPE2yG5xO0&verification=false&clk_src=",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Opodo",
        "logo": "https://www.gstatic.com/travel-hotels/branding/05208793-cd83-4e8b-b76c-7ff346e093e3.png",
        "link": "https://accommodation.opodo.de/Hotel-Search?selected=15438428&startDate=2026-02-27&endDate=2026-02-28&adults=2&children=&mpf=1066.47&cur=EUR&mpj=139.66&wapb3=|c.506940|l.de_DE|t.meta|s.ghs&MDPCID=Opodo-DE.DPS.Opodo.MetaSearch-GHA.HOTEL&mpl=EUR&numberOfRooms=1&locale=de_DE&rffrid=h4p.hcom.DE.ghaodigeo.000.000.kwrd=&pos=OPODO_DE&rateplanid=208165427&mctc=10&utm_medium=metasearch&utm_campaign=495029696&utm_term=hotel&utm_source=FREEBOOKING",
        "price": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost": {
          "value": 1066,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1066,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1066,
          "currency": "EUR"
        }
      },
      {
        "title": "Hotelscombined.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b73f8d82-aa66-4ac5-861d-52bce84c9ae5.png",
        "link": "https://www.hotelscombined.de/semi/ha/hotel_ads/2600131/en.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=139.88&pdtotal=1068.11&rpid=&uc=DE&ucuc=EUR&d=desktop&lc=en&v=false&rrid=&k_pc=~QUdPREFIUEE&k_rt=&k_sid=xfAER-M11F&k_kct=1772137603&k_gct=1772138413&g=2&r=1&ac=2&k_cc=de&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "momondo.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_970163321.png",
        "link": "https://www.momondo.de/semi/ha/hotel_ads/2600131/de.html?utm_source=google&utm_medium=cpc&utm_term=2600131&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-02-27&co=2026-02-28&gs=localuniversal&l=1&pc=USD&rid=&pdtax=139.88&pdtotal=1068.11&rpid=&uc=DE&ucuc=EUR&d=desktop&lc=en&v=false&rrid=&k_pc=~QUdPREFIUEE&k_rt=&k_sid=xfCEA4qdZ8&k_kct=1772137603&k_gct=1772138449&g=2&r=1&ac=2&k_cc=de&dt=selected&cmpid=&cmptrack=",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "müv AI",
        "logo": "https://www.gstatic.com/travel-hotels/branding/2710211444546704077.png",
        "link": "https://muvtravel.com/xp-hotel?hotelID=116119126&checkinDay=27&checkinMonth=02&checkinYear=2026&nights=1&num-guests=2&checkoutDay=28&checkoutMonth=02&checkoutYear=2026&PROMO-CODE=98010",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Closest Hotel",
        "logo": "https://www.gstatic.com/travel-hotels/branding/15292798194442829381.png",
        "link": "https://closesthotel.com/googleRedirMainSearch.php?checkInYear=2026&checkInMonth=02&checkInDay=27&checkOutYear=2026&checkOutMonth=02&checkOutDay=28&numberOfNights=1&numberOfAdults=2&numberOfChildren=0&numberOfGuests=2&hotelID=15438428&roomID=201555590&currency=EUR&deviceType=desktop",
        "price": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost": {
          "value": 1068,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1068,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1068,
          "currency": "EUR"
        }
      },
      {
        "title": "Traveloka.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/cc46874d-c374-4a99-83c7-b6f79d0b19d3.png",
        "link": "https://www.traveloka.com/en-en/hotel/search?spec=27-02-2026.28-02-2026.1.1.HOTEL_GEO.4005128638.New%20York%20State.2&hotelId=1000000601517&contexts=%7B%22accessCode%22:%2290975GHAD1305desktop%22%2C%22metasearchRequestId%22%3A%22cb5f2e56-846c-4e98-ada0-3a1b1aa861ff%22%2C%22plc%22%3A%22Uz%2F51aey53IgPjFiTs8zCqt%2FEzVSVv3B37GI8CihLxgZQ4P2RnJ4vXuEz6mydh0QWSafPGCMr%2FG%2FGO8e%2BT5i%2Fg%3D%3D%22%7D&metasearchId=GoogleHotelAdsUser&metasearchRateId=desktop&metasearchRatekey=sgyUU2M0LrnnpXh1LPwoI&priceDisplay=TOTAL&metasearchRefid=12345678910abcdefghijk@-&adType=0&PPA=0&hotelCampaign=1&cur=EUR",
        "price": {
          "value": 1071,
          "currency": "EUR"
        },
        "cost": {
          "value": 1071,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 1071,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 1071,
          "currency": "EUR"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Dates
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/dates

Reference for the Bright Data Google Hotels Dates parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Check-in date and check-out date, separated by comma.

  > **Format**: `YYYY-MM-DD,YYYY-MM-DD`\
  > **Example**: `2026-04-03,2026-04-10`

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_dates=2026-04-03%2C2026-04-10',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={6, 7} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-04-03",
        "end_date": "2026-04-10",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "trivago.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1922649917165881388.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQYhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYASABEgKs-_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3jDDsBoF49LIv8h7JRGXfK4c5Uww&adurl=",
        "price": {
          "value": 1124,
          "currency": "USD"
        },
        "cost": {
          "value": 1293,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 9050,
          "currency": "USD"
        }
      },
      {
        "title": "Expedia.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQJxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiABEgLxsfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2RzSq4ZRGsbtHfccg0CuwNIFISNA&adurl=",
        "price": {
          "value": 1124,
          "currency": "USD"
        },
        "cost": {
          "value": 1293,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 9050,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiACEgIOq_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2rCy4EYmKS2PUI9JAQ9iBIiHXP_Q&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1124,
              "currency": "USD"
            },
            "cost": {
              "value": 1293,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9050,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiADEgLQIvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_386Mob3v3Ipa3e9j021h28EfMVYQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1249,
              "currency": "USD"
            },
            "cost": {
              "value": 1437,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10059,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAEEgJnmvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0X-AFfOUFcldJAaKV13FPIALqrPQ&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1125,
              "currency": "USD"
            },
            "cost": {
              "value": 1294,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9061,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQKxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAFEgKdmvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2wpGSEisyf_IWUsUFISzSTkwBUzA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1248,
              "currency": "USD"
            },
            "cost": {
              "value": 1435,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10048,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAGEgKYYfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0wS0Svfjeq-MnN6F99D_VI7aOw7A&adurl=",
            "extensions": [
              "2 double beds"
            ],
            "price": {
              "value": 1146,
              "currency": "USD"
            },
            "cost": {
              "value": 1318,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9227,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAHEgKkBvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1oppsT2mirszsp7yZIW9tl8SuNMA&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1274,
              "currency": "USD"
            },
            "cost": {
              "value": 1466,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10260,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAIEgKijfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_37Lkq_ienAtTYTVCGEIS4cPfurNQ&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1187,
              "currency": "USD"
            },
            "cost": {
              "value": 1366,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9560,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQLxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAJEgISofD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1RlcWyNv6LCkw-i5pbb4Ojmfu9cg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1348,
              "currency": "USD"
            },
            "cost": {
              "value": 1550,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10851,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x6Z4f55TyGgXgPaK-luUCFyHuULMAS-fnt2cgI_EjYzlVobLpV_HI_PaCiSXVq4GJt7GYYLs7gCr3Wj__EOYfq-W6hB87lXPWt24y5G_yEfds77WaqbxUytFauHjPoQYygsMPkPfJ2uhm751bN0EKKLGimw0u0n8_t"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAKEgIXxfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3VADlw1bl5GUpQsLgFAPQ2lA_njQ&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1187,
              "currency": "USD"
            },
            "cost": {
              "value": 1366,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 9560,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x6Z4f55TyGgXgPaK-luUCFyHuULMAS-fnt2cgI_EjYzlVobLpV_HI_PaCiSXVq4GJt7GYYLs7gCr3Wj__EOYfq-W6hB87lXPWt24y5G_yEfds77WaqbxUytFauHjPoQYygsMPkPfJ2uhm751bN0EKKLGimw0u0n8_t"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiALEgLmDvD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3PVRjIxlUJRDk-AxBe6ZxGBGA-Uw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1349,
              "currency": "USD"
            },
            "cost": {
              "value": 1552,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10863,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAMEgJYkfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_04kbwDw1x6JmAHL0r4OdUwRUbb8A&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 1261,
              "currency": "USD"
            },
            "cost": {
              "value": 1451,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10157,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQMxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiANEgIGd_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3GCNlPvXpoYzJ6vAMnK3A5zrL9Vw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1449,
              "currency": "USD"
            },
            "cost": {
              "value": 1667,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 11666,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAOEgIWafD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0TzRN_pmTs1r0B3wHg2bQnvTsl6g&adurl=",
            "extensions": [
              "1 double bed"
            ],
            "price": {
              "value": 1300,
              "currency": "USD"
            },
            "cost": {
              "value": 1495,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 10467,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAPEgIV3fD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1bV54iwzggMCJtCAFW9FlAzXCmtQ&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Apr 1"
            ],
            "price": {
              "value": 1494,
              "currency": "USD"
            },
            "cost": {
              "value": 1718,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 12027,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAQEgKVfPD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3PWv0VrClvPzIw_0iDkVeb4Nlp9w&adurl=",
            "extensions": [
              "Suite Suite"
            ],
            "price": {
              "value": 2479,
              "currency": "USD"
            },
            "cost": {
              "value": 2850,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 19948,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQNxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAREgKUgfD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2Rv3GNQFgW0x0r4ahWOX682F_zJw&adurl=",
            "extensions": [
              "Suite Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 2849,
              "currency": "USD"
            },
            "cost": {
              "value": 3274,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 22920,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQOBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiASEgLh3vD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2qKm4LfiTTnR-nRv3y-iZqfa1cdg&adurl=",
            "extensions": [
              "Suite Suite"
            ],
            "price": {
              "value": 3101,
              "currency": "USD"
            },
            "cost": {
              "value": 3564,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 24945,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQORoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiATEgJN-_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1eRD9Eco_DcVHAhPHY_0QfasH2kw&adurl=",
            "extensions": [
              "Suite Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 3564,
              "currency": "USD"
            },
            "cost": {
              "value": 4095,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 28663,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wUo6BPQW7nrkfgpTzJi_nQA8xpSw312DpP20wbOYdpEfOmvds9VLU7L_ibu_895NqpjU5kLib0DfsImWRp7v19NjwaSBrUJ6TUGTFABEDUUB7vOgVyyP0W54B-SH86pi457VRBGPvK7ykAT93UU9whEXLD7fMb9jLf"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQOhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAUEgK5ovD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_0XiU4_Z0oklRKJqzexvctPXFKt-g&adurl=",
            "extensions": [
              "Suite Suite"
            ],
            "price": {
              "value": 3101,
              "currency": "USD"
            },
            "cost": {
              "value": 3564,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 24945,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wUo6BPQW7nrkfgpTzJi_nQA8xpSw312DpP20wbOYdpEfOmvds9VLU7L_ibu_895NqpjU5kLib0DfsImWRp7v19NjwaSBrUJ6TUGTFABEDUUB7vOgVyyP0W54B-SH86pi457VRBGPvK7ykAT93UU9whEXLD7fMb9jLf"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQOxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAVEgLHXPD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3ouuw5q8p31JUMJKilpDV_aSkvRA&adurl=",
            "extensions": [
              "Suite Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 3564,
              "currency": "USD"
            },
            "cost": {
              "value": 4095,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 28663,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPBoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAWEgLvyPD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_2MHQFYAZKUNaBDWT3pjpYRohDeSQ&adurl=",
            "extensions": [
              "1 king bed Suite"
            ],
            "price": {
              "value": 3536,
              "currency": "USD"
            },
            "cost": {
              "value": 4063,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 28439,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPRoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAXEgIs9vD_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1FEr5MAu7-2NzDuwUyCyvJ6M8F9A&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 4064,
              "currency": "USD"
            },
            "cost": {
              "value": 4668,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 32679,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPhoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAYEgLa0_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_1oXpUWuzpVIRL06jaFs0DqEeZibg&adurl=",
            "extensions": [
              "1 king bed Suite"
            ],
            "price": {
              "value": 3926,
              "currency": "USD"
            },
            "cost": {
              "value": 4511,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 31578,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjCoPbrn_iSAxVGUn8AHdd8DsoYACICCAEQPxoCb2E&co=1&ase=2&gclid=EAIaIQobChMIwqD265_4kgMVRlJ_AB3XfA7KEAoYAiAZEgIUV_D_BwE&cid=CAASuwHkaOl2NLS5wDy6GKMRdyxNZjSVEWrmSsf6RKRBnUgVhiZOlox1MbkBncfXuNV2KEaH7m6BCeu7UtSPKhdBVddQpQLWDK60Lm_9zP48inYjhuoy8cCjJRO0fIwJZvWIIwnTsJ5b7XsSgxO1mgLBH1XvNaB5VuZZa-54QO3_3b1xl8jw76lYwiPs0-tRaCQoyvY36jEZOV2oU43o72VaW1uLuKFnrNu4xj1-08RFzgDhK_G9-OqBlzR54CHk&category=acrcp_v1_48&sig=AOD64_3qFKdDJlHKmMAX2OieB_S2hOCXCw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Apr 1 Suite"
            ],
            "price": {
              "value": 4514,
              "currency": "USD"
            },
            "cost": {
              "value": 5185,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 36294,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Long Stay Discounts",
        "logo": "https://www.gstatic.com/travel-hotels/branding/6131123071209883889.png",
        "link": "https://www.longstaydiscounts.com/transition/?data=price=8108.07%26total_price=9331.3%26request_id=5de6faf4-bed6-41a0-a5a8-5ebaf17a5be8%26ps=296306%26pp=vxdXzMnczXSybIIfpW80fQ%26pb=SU5vEhldOC6H9K1kZwIQ4d2JfI1zkfnZXwyokA87-W87qcyTm0x9pLysiqwybwIaoISHLs_aO-FLzJI9HWNwc4Az8Kp362gI5poRjGihPDGa6gyLdZv4SGyT0fDxBpTs0gO6FAaspQv93s-Ff827uDIM8eXlEoPVbEzQ43RDO1ZQvMuXOCNR9FE4gD0yvzTRg8wwIWyBaUgTMNt_J1VoXblRWLTWMg90CtvM02z5E8AVnyZHCfvTbgcmmVzBj7v2MAyFceNkLFXpKcBs1K7ThvCCvlYui8YZp8mNotBGRlNuRZ3OxUhwm8-aMbKCkUXB8Bv8zWi8FoV94w40p7CHx0U__fHEIribv5GxVjCcA-4%253D%26gha_lsd_pull_request=True%26rtp=SdTUqdR7wIew8aRS9esAtw%253D%253D%26risk_lk_1=false%26alwd_risk=false%26alwd_rand=false%26gt=1772137197%26sg=YDhbN%26ttl_bkt=none%26all_inclusive=false&utm_source=gha_lsd&utm_content=localuniversal&currency=USD&user_country=US&verification=false&rate_rule_ids=&date_type=selected&rate_rule_id=signedout_desktop&utm_campaign=&display_currency=USD&display_all_inclusive_price=9331.29&checkin_at=2026-04-03&checkout_at=2026-04-10&provider_hotel_id=10007072903&provider=ean&num_adults=2&children=[]&user_locale=en-US&user_list_id=&utm_medium=organic&utm_id=gha_lsd_organic",
        "price": {
          "value": 1158,
          "currency": "USD"
        },
        "cost": {
          "value": 1158,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1333,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 9331,
          "currency": "USD"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Device type
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/device-type

Configure the Bright Data Google Hotels Device Type parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Define what device type to be represented in user-agent

  Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1
  ```

  **For specific mobile platform provide one of the following values:**

  | Parameter | Description |
  | - | - |
  | `brd_mobile=ios` | iPhone user-agent (alias `brd_mobile=iphone`) |
  | `brd_mobile=ipad` | iPad user-agent (alias `brd_mobile=ios_tablet`) |
  | `brd_mobile=android` | Android phone |
  | `brd_mobile=android_tablet` | Android tablet |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_mobile=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "four seasons hotel new york downtown - Google Hotel Search",
      "requested": {
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": "unknown",
      "currency": "USD"
    }
  }
  ```
</ResponseExample>


# Free cancellation
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/free-cancellation

Configure the Bright Data Google Hotels Free Cancellation parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Show only offers with free cancellation.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true
  ```

  | Parameter | Description |
  | - | - |
  | `brd_free_cancellation=true` | with free cancellation |
  | `brd_free_cancellation=false` | show any offers |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_free_cancellation=true',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": "unknown",
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels localization
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/localization

Configure the Bright Data Google Hotels Google Hotels localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Two-letter country code used to define the country of search

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us
  ```
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page language

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&hl=en
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&gl=us&hl=en',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "EUR",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQJRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASABEgJ0ovD_BwE&sig=AOD64_2xUs_hsdCl_zU3kgXMXw3f79lqbw&adurl=",
        "price": {
          "value": 882,
          "currency": "EUR"
        },
        "cost": {
          "value": 882,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 882,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQJxoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASADEgJb_PD_BwE&sig=AOD64_0u3wzhI7DSTTRfNJImHIhxC8FYPg&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKBoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAEEgIXafD_BwE&sig=AOD64_1z6iOdmqqGcdTUr4_N8XFNisvhww&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAFEgJxRfD_BwE&sig=AOD64_0UidsBGdOCi_Oa_7eEz6o80GUt1w&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKhoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAGEgJ8APD_BwE&sig=AOD64_20A3O9tWCNcRNrw_BrNXgkH38Nbw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQKxoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYASAHEgJQpvD_BwE&sig=AOD64_1dTQ4X378diHkUNs9NBwVXjny3ag&adurl=",
            "extensions": [
              "2 double beds"
            ],
            "price": {
              "value": 945,
              "currency": "EUR"
            },
            "cost": {
              "value": 945,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 945,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "Expedia.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQCRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiABEgIgp_D_BwE&sig=AOD64_0QKaGVbKXETl3s7roYBRtGwR6hOQ&adurl=",
        "price": {
          "value": 882,
          "currency": "EUR"
        },
        "cost": {
          "value": 882,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 882,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQChoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiACEgKSHfD_BwE&sig=AOD64_0Zi_mSfTuClXGJFuovQHRjOf2edw&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQCxoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiADEgITtvD_BwE&sig=AOD64_2l_wXdqXc6uv4FMfC3B0_IhD2KBQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQDBoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiAEEgIm4fD_BwE&sig=AOD64_1eOpLFyXNrye4TPF3McvFl7Vpy8Q&adurl=",
            "extensions": [
              "1 king bed"
            ],
            "price": {
              "value": 882,
              "currency": "EUR"
            },
            "cost": {
              "value": 882,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 882,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiQlc6wmfiSAxX8j1AGHcmwMM0YACICCAEQDRoCZGc&co=1&gclid=EAIaIQobChMIkJXOsJn4kgMV_I9QBh3JsDDNEAoYAiAFEgKBqfD_BwE&sig=AOD64_3VJtgFzXWgbLHeDJPz66MfCv181A&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Mar 4"
            ],
            "price": {
              "value": 926,
              "currency": "EUR"
            },
            "cost": {
              "value": 926,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 926,
              "currency": "EUR"
            }
          }
        ]
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Occupancy
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/occupancy

Configure the Bright Data Google Hotels Occupancy parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Number of guests to book a room for (maximum 6 guests)

  > **Examples:**\
  > `brd_occupancy=1` - look for a room for 1 person \
  > `brd_occupancy=2` - for 2 persons (`default`)  \
  > `brd_occupancy=3` - for 3 persons, etc.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=4',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={8} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 4,
        "number_of_adults": 4
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQARoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYASABEgKFTfD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_3BwF5zkVM4yFnjzLkJe3yZ4LIyng&adurl=",
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 3167,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQAhoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYASACEgLW2vD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_1qIIPYxKKm7b-KBtAnQD0jNESHyg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2755,
              "currency": "USD"
            },
            "cost": {
              "value": 3167,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3167,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQBBoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAiABEgJ5oPD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_3vAW6Wlrj7Rvy2jGGZZ6pL34wsVQ&adurl=",
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 3167,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Liberty Suite - Non-Refundable",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQBRoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAiACEgKRnvD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_1XxpKPh0u6KGRVipGp7q3p9amoFg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2755,
              "currency": "USD"
            },
            "cost": {
              "value": 3167,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3167,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Vio.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/297592521974050080.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQBxoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAyABEgJh9vD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_2CX8l_iwFjmkflD-t9Z7gieK67mQ&adurl=",
        "price": {
          "value": 2190,
          "currency": "USD"
        },
        "cost": {
          "value": 2520,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 2520,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Standard Room",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQCBoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYAyACEgIMUPD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_0nv1YpOB69DWGzx2lByFVSC_ivyg&adurl=",
            "extensions": [
              "4 guests"
            ],
            "price": {
              "value": 2190,
              "currency": "USD"
            },
            "cost": {
              "value": 2520,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2520,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQChoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYBCABEgI4tPD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_3NNqDK7Rkm1NGU2m-irDhU4bHmcA&adurl=",
        "price": {
          "value": 2190,
          "currency": "USD"
        },
        "cost": {
          "value": 2520,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 2520,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Cheapest combo rooms",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zFEWEw3P5LJ7DtpU5VZk-6S6290T43IYWTz_h9ZHdy2WeJ2vEnEa8_Iy3d0ZZkGaxyflvduFfgDrYPFqMBc4-m_i7PhfXt96n6-zCVUW9xJtMm9uVrPup4AiuB04E66RdOrEa3Ve8YGw6858gktvrq927g-DpC2dqXeQ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwijm_uwofiSAxXccn8AHX8pBPEYACICCAEQCxoCb2E&co=1&gclid=EAIaIQobChMIo5v7sKH4kgMV3HJ_AB1_KQTxEAoYBCACEgLu5PD_BwE&cid=CAASuwHkaHvrNFePLzN1GKdqRyRfUekwmG14uq0FowVTwkztlO6UtkzyhkK67lIMIeWSFk-8obkOW1y125TcPEIQCX25GBIPP7tiKKZwZ88fC0bGYXRdVCqww4zsDwj6wS5sEG-XwaUZHFe7akV-ZmK-hfWe__Kf9UBc_xEKsKP4KmpeaWk_tjrIwl6WMhlqTHsQuHcrvPddIlKTpLv5sbAfVUO2Ggc7tFda9t9cKzpzxT0I3IzVlw7yL1IsND82&sig=AOD64_0bI6JJitSd-AaPRLu9KNec0ySscg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 2190,
              "currency": "USD"
            },
            "cost": {
              "value": 2520,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2520,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Priceline",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "link": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C35500803_localuniversal_1%7C20260227%7Cdesktop%7Cuserdate|public|||1%7C4%7C0|0|EN&hotelid=35500803&checkin=20260227&checkout=20260228&rooms=1&currency=USD&displayedCurr=USD&POSCountryCode=US&taxDisplayMode=BP&cityID=3000016152&adults=4&land=L&metaid=TZPY09t6i2r8eviYUv_ZZBhFokmqUcwjlhUz2OZhFpKJ_rcUR08v4V943zEFapC_d6iKdC2tfSjcdj31xM0zJyhOMHSWV-drRvv2NC7o90epTYWMpaY76kUc-CtZXTvPvntFnxKdY1xxaFkVPijMdJOtLubvNu35SROPjECv-OOtf4RMjpRUAs_LFggabmF5pYZaSn24vTxdKcO1T2D0sB53EF1l-Y40Aze_QDOGr57T9Crjb5YfW7ZF2lfuE6WRJ7ZCEdRglTx2nkLKmQXBkbToGwYa5PApnnoctK8mTKN2Cb-ua0kwaHsTQLTqwY8jSfg73Izv1NynJnRvBtfj4jSZSjECfwjffvVSkOQbeofOpqIu1YyBbYuNf9XXdGG_z6UaIjPvCApalSXVl9jYWMj33qOd9LB2LHv1qw0jE60&dblcnt=true&user_num_adults=4&hc=1&pdtax=411.86&pdf=0.00&pdt=3166.86&locale=en-us&ad-src=&numChild=0",
        "extensions": [
          "4 guests"
        ],
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 2755,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 3167,
          "currency": "USD"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=4&req_adults=4&show_room=59953509_336303630_4_0_0&lang=en&selected_currency=USD&exrt=1.00000000&ext_price_total=3166.86&ext_price_tax=411.86&xfc=USD&hca=m&group_children=0&req_children=0&&no_rooms=1&ts=1772143929&&utm_source=metagha&utm_medium=localuniversal&utm_campaign=US&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-4_rateid-0_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-&aid=2127486&label=metagha-link-LUUS-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-4_rateid-0_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-0_checkin-20260227_ppt-",
        "extensions": [
          "4 guests"
        ],
        "price": {
          "value": 2755,
          "currency": "USD"
        },
        "cost": {
          "value": 2755,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 3167,
          "currency": "USD"
        },
        "cost_with_tax": {
          "value": 3167,
          "currency": "USD"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Occupancy (children)
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/occupancy-children

Configure the Bright Data Google Hotels Occupancy (children) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Number of guests to book a room for (maximum 6 guests)

  Also supports a comma-separated list of integers where:

  * first value is a number of adult guests
  * subsequent values are ages of children

  > **Format:**\
  > `brd_occupancy=<number of adults>,<child 1 age>,<child 2 age>,...,<child N age>`

  > **Examples:**\
  > `brd_occupancy=1,5,7,12` - for 1 adult and 3 children (5, 7 and 12 years old) \
  > `brd_occupancy=2,1,3` - for 2 adults and 2 children (1 and 3 years old)

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_occupancy=2,1,3',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={8-14} theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-02-27",
        "end_date": "2026-02-28",
        "occupancy": 4,
        "number_of_adults": 2,
        "children_ages": [
          [1],
          [3]
        ]
      },
      "available": true,
      "currency": "NOK",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQBhoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYASABEgIHBvD_BwE&category=acrcp_v1_48&sig=AOD64_2OB6sX_jfTYCYLnlSGgBhU8g-6Hw&adurl=",
        "price": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost": {
          "value": 30258,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 30258,
          "currency": "NOK"
        },
        "rooms": [
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQBxoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYASACEgIMKfD_BwE&category=acrcp_v1_48&sig=AOD64_2F6JXEmahBZuiRR9EpMxhKpGEH7Q&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 30258,
              "currency": "NOK"
            },
            "cost": {
              "value": 30258,
              "currency": "NOK"
            },
            "price_with_tax": {
              "value": 30258,
              "currency": "NOK"
            }
          }
        ]
      },
      {
        "title": "Agoda",
        "logo": "https://www.gstatic.com/travel-hotels/branding/b13642de-d476-41bd-8254-3edc2e567aa6.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQARoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYAiABEgKpjfD_BwE&category=acrcp_v1_48&sig=AOD64_2r-7jD4nxhXD_rMhMHuUypocs3CQ&adurl=",
        "price": {
          "value": 24078,
          "currency": "NOK"
        },
        "cost": {
          "value": 24078,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 24078,
          "currency": "NOK"
        },
        "rooms": [
          {
            "title": "Cheapest combo rooms",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zFEWEw3P5LJ7DtpU5VZk-6S6290T43IYWTz_h9ZHdy2WeJ2vEnEa8_Iy3d0ZZkGaxyflvduFfgDrYPFqMBc4-m_i7PhfXt96n6-zCVUW9xJtMm9uVrPup4AiuB04E66RdOrEa3Ve8YGw6858gktvrq927g-DpC2dqXeQ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQAhoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYAiACEgIE0fD_BwE&category=acrcp_v1_48&sig=AOD64_2MHXW3CYo5b3mUtWJvns6jar4Ytg&adurl=",
            "extensions": [
              "Suite 4 guests Suite"
            ],
            "price": {
              "value": 24078,
              "currency": "NOK"
            },
            "cost": {
              "value": 24078,
              "currency": "NOK"
            },
            "price_with_tax": {
              "value": 24078,
              "currency": "NOK"
            }
          }
        ]
      },
      {
        "title": "Bluepillow.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/c770e909-af04-45dd-8ad7-335bc5055826.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiU2KzSoviSAxWcEKIDHSotINgYACICCAEQBBoCbGU&co=1&ase=2&gclid=EAIaIQobChMIlNis0qL4kgMVnBCiAx0qLSDYEAoYAyABEgK6BvD_BwE&category=acrcp_v1_48&sig=AOD64_3VR2PGCT6ktb9oob8TiCSCYOczrg&adurl=",
        "price": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost": {
          "value": 30258,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 30258,
          "currency": "NOK"
        }
      },
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.booking.com/searchresults.en.html?dest_id=599535&highlighted_hotels=599535&dest_type=hotel&checkin=2026-02-27&checkout=2026-02-28&group_adults=2&req_adults=2&show_room=59953509_336303630_4_0_0&lang=en&selected_currency=NOK&exrt=9.55452061&ext_price_total=30257.85&ext_price_tax=3935.15&xfc=USD&hca=m&group_children=2&req_children=2&&age=1&req_age=1&age=3&req_age=3&no_rooms=1&ts=1772145314&edgtid=CWkbcNRxSWWiPwBRRdWNjA&efpc=J1WwCjFmuGov&utm_source=metagha&utm_medium=localuniversal&utm_campaign=NO&utm_term=hotel-599535&utm_content=dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-2_checkin-20260227_ppt-&aid=2127633&label=metagha-link-LUNO-hotel-599535_dev-desktop_los-1_bw-1_dow-Friday_defdate-0_room-0_gstadt-2_rateid-public_aud-0_gacid-_mcid-10_ppa-0_clrid-0_ad-0_gstkid-2_checkin-20260227_ppt-",
        "extensions": [
          "4 guests"
        ],
        "price": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost": {
          "value": 30258,
          "currency": "NOK"
        },
        "price_with_tax": {
          "value": 30258,
          "currency": "NOK"
        },
        "cost_with_tax": {
          "value": 30258,
          "currency": "NOK"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/parsed-json

Configure the Bright Data Google Hotels Google Hotels parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://www.google.com/maps/search/hotels+new+york/?brd_json=json
  ```

  | value | description |
  | - | - |
  | `html` (default) | Returns the standard HTML response from Google Maps. |
  | `json` | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown&brd_json=json',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "EUR",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007, United States",
      "phone": "+1 646-880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQExoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASABEgLsBvD_BwE&sig=AOD64_0M7LSslBABYjrcuHz7043HM6Gk0A&adurl=",
        "price": {
          "value": 912,
          "currency": "EUR"
        },
        "cost": {
          "value": 912,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 912,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ySiIEbCWYVgsWXAcT9P6GEaGc7OIZTLS03_DwOCK8IfvGbD_qIjGfPO3Eqe2ujdp686Jxaub2fQPluNbPelOp1hXNH1wTqhWRTw5yvK3qB_eDVgGDDZjnm-Y8JdMbrXO8mvoFY9XldhKGW0xzs8vHzPlebVX5jVqIXrZZrBft7bw1oadabdwy0BcKwTI-5__z5UG9mhDZhf8RBL3tbtlCP7ltZNmSUmDI"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQFxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASAFEgJzD_D_BwE&sig=AOD64_2e1w7gdEW072SImBtdJlNKkhT9mg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 912,
              "currency": "EUR"
            },
            "cost": {
              "value": 912,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 912,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y-KJSTcZEDdQDB_yrI3W9M4YdQouODBZz7TiHG3QmpZ0OqLVH1OJBAZE0HVvZijUgVuHuZMs_mfmpjomUOTS8lqsUND0wquBfjTjHcaUg8n5X_8L3vRdpu48DbpVXIbsL1KelRaLGYW4onvYiIoxH7fOQHdwDF7ZAM0UYPuH2HW1iFj-WaCvMkKc3Depo1fg5GQ5a_BRyAo1kCPl3-XxL8vmd8KJT1xBg"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQGBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASAGEgKPq_D_BwE&sig=AOD64_0J2K_vmz2GLmSU03WXOCMRhoBlHQ&adurl=",
            "extensions": [
              "Suite 3 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2378,
              "currency": "EUR"
            },
            "cost": {
              "value": 2378,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2378,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y-KJSTcZEDdQDB_yrI3W9M4YdQouODBZz7TiHG3QmpZ0OqLVH1OJBAZE0HVvZijUgVuHuZMs_mfmpjomUOTS8lqsUND0wquBfjTjHcaUg8n5X_8L3vRdpu48DbpVXIbsL1KelRaLGYW4onvYiIoxH7fOQHdwDF7ZAM0UYPuH2HW1iFj-WaCvMkKc3Depo1fg5GQ5a_BRyAo1kCPl3-XxL8vmd8KJT1xBg"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQGRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYASAHEgLD0vD_BwE&sig=AOD64_3S34MlYvIksxmVX7QUZTbYSlmV-g&adurl=",
            "extensions": [
              "Suite 4 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2475,
              "currency": "EUR"
            },
            "cost": {
              "value": 2475,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2475,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "Expedia.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQARoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiABEgJB9_D_BwE&sig=AOD64_1kUnuX6YdD_AOE7R0KHjsKNHzHtA&adurl=",
        "price": {
          "value": 911,
          "currency": "EUR"
        },
        "cost": {
          "value": 911,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 911,
          "currency": "EUR"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zYFNVKMsbaLNMZ-gh_Vbck_EkR8kV2OMjj3OtbYpSHjv2_txZgd66NC_oCCHrpeS9cogHDn_k13nqZzaZFFSkCGm0EHjsEAI0GI55NP4BBX0xBq3_Uji01c2RQdjeRwUWYKQw8avPS9WzOhaV1-bo2nq-ut_Yev3lE"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQAhoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiACEgIYZPD_BwE&sig=AOD64_31Yv_SBh0jcVaEnpTo_sphgYd8zQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 911,
              "currency": "EUR"
            },
            "cost": {
              "value": 911,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 911,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQAxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiADEgIyB_D_BwE&sig=AOD64_0aALGynTChUuX8X4JGHzzFv63uEA&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 28"
            ],
            "price": {
              "value": 911,
              "currency": "EUR"
            },
            "cost": {
              "value": 911,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 911,
              "currency": "EUR"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zYFNVKMsbaLNMZ-gh_Vbck_EkR8kV2OMjj3OtbYpSHjv2_txZgd66NC_oCCHrpeS9cogHDn_k13nqZzaZFFSkCGm0EHjsEAI0GI55NP4BBX0xBq3_Uji01c2RQdjeRwUWYKQw8avPS9WzOhaV1-bo2nq-ut_Yev3lE"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAEEgIyi_D_BwE&sig=AOD64_1WCiGga8oG95r2jdwkVTbeYeey6w&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 911,
              "currency": "EUR"
            },
            "cost": {
              "value": 911,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 911,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wds_0O4X_fvybSRinVrg9UstYEgU4qlouU4v-lNTqXPUsLuEGHK_CkIuB034caQMwQ19oFDkJOXz9wRrpy2gUDf3Egip9BJS2H3OgYoesDW7QwJb_47iLzahGhE99F8YjZI-n30IIO4j4Lbfcx1oSboErOa9DVzJg"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAFEgLrFPD_BwE&sig=AOD64_1QEZ4cu5k9E6lseKW11ciAm-J3Hw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1008,
              "currency": "EUR"
            },
            "cost": {
              "value": 1008,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1008,
              "currency": "EUR"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x6Z4f55TyGgXgPaK-luUCFyHuULMAS-fnt2cgI_EjYzlVobLpV_HI_PaCiSXVq4GJt7GYYLs7gCr3Wj__EOYfq-W6hB87lXPWt24y5G_yEfds77WaqbxUytFauHjPoQYygsMPkPfJ2uhm751bN0EKKLGimw0u0n8_t"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBhoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAGEgK67vD_BwE&sig=AOD64_3xtc8VbYzfm2iEB2RXKgqK9wikUQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1008,
              "currency": "EUR"
            },
            "cost": {
              "value": 1008,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1008,
              "currency": "EUR"
            }
          },
          {
            "title": "SoHo Premier Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yv0AxYLP4aAQwN6J8XDZbtkYY1_0Nvgv2ZYCVK0dBpzNv3fyOhcZ5TokalUILoZ3r3_zQCPCeiwcYq64hCMNh58fXCXCVgKapWEA2_oGjJ0J5SG5BF2ui0ZLXtk7VtHRKqqc3k-WtT17r0KAJGpqnXX6tKm6gHYbRz"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQBxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAHEgKDn_D_BwE&sig=AOD64_1iuHdiaZaL4jNVIKcfH6RhD7xnDA&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1042,
              "currency": "EUR"
            },
            "cost": {
              "value": 1042,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1042,
              "currency": "EUR"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQCBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAIEgJFSfD_BwE&sig=AOD64_3YXLgnD1EZ2At_PacM0-00UUNKUg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1105,
              "currency": "EUR"
            },
            "cost": {
              "value": 1105,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1105,
              "currency": "EUR"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yeBfSgeyblSeisek8ZI4YEHLCIbbXrCJxgyCdZUamkH5oV5DdlJoKUakDV53Z7p-BDS0E8rJ62m6QZMrFqObi9meM30tA-IA6SocR49mzpLbxLgLGE-3-aodZ0vOxTfpmcX440cUjJEe1Ngv3iSw2LSIyNpQLwWUtZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQCRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAJEgJfmfD_BwE&sig=AOD64_1DTRq-qsUqhPdcqeYLHg35iQxssg&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1139,
              "currency": "EUR"
            },
            "cost": {
              "value": 1139,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 1139,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y1iwF2gynru2fHktFEUS_8KfNtswHyO__zLmmGruUe4Ex1i3-2bce9c4ZsKDg_FUp82xUBdJK6t2v_2LrUVEYneXqLJ_XzfxddpaZh0GK7zS7WDWI2M7HCeVS-wBrT2vpSFn7exa2XIrZ0TfHXz6MHq1IlxpCExlE"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQChoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAKEgII2_D_BwE&sig=AOD64_17Z2jIYpTclspi0DhcDa9qSX5jxg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2277,
              "currency": "EUR"
            },
            "cost": {
              "value": 2277,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2277,
              "currency": "EUR"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_x0PMpt7VzEy6A83OymvL5l9KvaUZ0rKRlPgI6PsNAzDGi6YSr7mFOEw18HHxDv_YswU22MN7u6e33RiFrmuC8vFWme_o-Mx4il9gSTGbOQGiKBhloGENHQHdRJO041_DbIaeWEkvvh4SI7ghnbeMUXrlekMq1DGb16"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQCxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiALEgKY9_D_BwE&sig=AOD64_3W6o-NofXoJKH-U9PQOfT3GF-QsA&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2277,
              "currency": "EUR"
            },
            "cost": {
              "value": 2277,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 2277,
              "currency": "EUR"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDBoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAMEgJKQPD_BwE&sig=AOD64_1A2Bj9M8g_-exQBUM2i7-TbfOKwg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3278,
              "currency": "EUR"
            },
            "cost": {
              "value": 3278,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3278,
              "currency": "EUR"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wUo6BPQW7nrkfgpTzJi_nQA8xpSw312DpP20wbOYdpEfOmvds9VLU7L_ibu_895NqpjU5kLib0DfsImWRp7v19NjwaSBrUJ6TUGTFABEDUUB7vOgVyyP0W54B-SH86pi457VRBGPvK7ykAT93UU9whEXLD7fMb9jLf"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDRoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiANEgI97PD_BwE&sig=AOD64_3BbzIs9pAmbIiAOwG-ebVejU-r4A&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3278,
              "currency": "EUR"
            },
            "cost": {
              "value": 3278,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3278,
              "currency": "EUR"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDhoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAOEgJgyfD_BwE&sig=AOD64_0DhmqCAFUP4PJ897doHPRo-DoXUw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3763,
              "currency": "EUR"
            },
            "cost": {
              "value": 3763,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3763,
              "currency": "EUR"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQDxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAiAPEgLxivD_BwE&sig=AOD64_36lE-tVjg-zTEHTsq2iii5UCC-mA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3958,
              "currency": "EUR"
            },
            "cost": {
              "value": 3958,
              "currency": "EUR"
            },
            "price_with_tax": {
              "value": 3958,
              "currency": "EUR"
            }
          }
        ]
      },
      {
        "title": "trivago.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/1922649917165881388.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQGxoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYAyABEgInWPD_BwE&sig=AOD64_39CkAu5QatiC1HqSk9jCdelh03mw&adurl=",
        "price": {
          "value": 911,
          "currency": "EUR"
        },
        "cost": {
          "value": 911,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 911,
          "currency": "EUR"
        }
      },
      {
        "title": "Tripadvisor.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/7993073966338005995.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwjk_sbYqPiSAxWECAYAHQhZFt4YACICCAEQERoCd3M&co=1&gclid=EAIaIQobChMI5P7G2Kj4kgMVhAgGAB0IWRbeEAoYBCABEgLrBfD_BwE&sig=AOD64_1DG7E3wUl5ZY2x3EFZRgwHazLXXw&adurl=",
        "price": {
          "value": 912,
          "currency": "EUR"
        },
        "cost": {
          "value": 912,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 912,
          "currency": "EUR"
        }
      },
      {
        "title": "Expedia.de",
        "logo": "https://www.gstatic.com/travel-hotels/branding/ac238c97-1652-4830-8da8-bb8d8883af88.png",
        "link": "https://www.expedia.de/Hotel-Search?selected=15438428&startDate=2026-03-06&endDate=2026-03-07&MDPCID=DE.META.HPA.HOTEL-ORGANIC-desktop.HOTEL&MDPDTL=HTL.15438428.20260306.20260307.DDT.8.CID..AUDID..RRID.bex_eu_desktop&adults=2&children=&mctc=10&ct=hotel&mpg=EUR&mpf=881.94&mpj=115.95&mpr=0.00&mpl=EUR&exp_pg=google&langid=2057&ad=2&tp=&utm_source=google&utm_medium=cpc&utm_term=15438428&utm_content=localuniversal&utm_campaign=HotelAds&rateplanid=381382188&mpm=24&mpn=201555591&mpo=EC&mpp=1",
        "price": {
          "value": 882,
          "currency": "EUR"
        },
        "cost": {
          "value": 882,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 882,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 882,
          "currency": "EUR"
        }
      },
      {
        "title": "Vio.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/297592521974050080.png",
        "link": "https://deals.vio.com/?sig=73aca13c7f952d2641c156f3e69125e1eb497c325f122828ee5aa8797168b9a12d32303331333438363233&turl=https%3A%2F%2Fwww.vio.com%2FHotel%2FSearch%3FcheckIn%3D2026-03-06%26checkOut%3D2026-03-07%26currency%3DEUR%26forceCurrencyChange%3D1%26lang%3Den%26forceLanguageChange%3D1%26rooms%3D2%3A%26utm_source%3Dgha%26utm_medium%3Dcpc%26hotelId%3D3021724%26userCountry%3DDE%26profile%3Dr2d2m73kn8%26preferredRate%3D877.78%26label%3Dsrc%253Dgha%2526cltype%253Dhotel%2526datype%253Ddefault%2526gsite%253Dlocaluniversal%2526vf%253D0%2526ucountry%253DDE%2526udevice%253Ddesktop%2526hotel%253D3021724%2526day%253D06%2526month%253D03%2526year%253D2026%2526los%253D1%2526price%253D877.78%2526currency%253DEUR%2526cid%253D%2526listid%253D%2526rateid%253DZZ_D%2526closerateid%253D%2526promo%253D0%2526isPrivateRate%253D0%2526isAudienceUser%253D0%2526isPaidClick%253D0%2526%26cp%3DJe1RbssPiD0CgtNYlhfM0Vja2J2bxiPlYPNBiACOKb4juINQhcIq4mL-_S42PLVARD-vwUgi2kqA1VTRA",
        "price": {
          "value": 878,
          "currency": "EUR"
        },
        "cost": {
          "value": 878,
          "currency": "EUR"
        },
        "price_with_tax": {
          "value": 878,
          "currency": "EUR"
        },
        "cost_with_tax": {
          "value": 878,
          "currency": "EUR"
        }
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Hotels text search
Source: https://docs.brightdata.com/api-reference/serp/google-hotels/text-search

Configure the Bright Data Google Hotels Google Hotels text search parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
```

## Parameters

<ParamField type="string">
  The search query parameter. Specifies the keyword or phrase you want to search for on Google.

  ```txt wrap theme={null}
  https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/travel/hotels?q=four+seasons+hotel+new+york+downtown',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "overview": {
      "type": "hotels",
      "title": "Four Seasons Hotel New York Downtown",
      "requested": {
        "start_date": "2026-03-06",
        "end_date": "2026-03-07",
        "occupancy": 2,
        "number_of_adults": 2
      },
      "available": true,
      "currency": "USD",
      "coordinates": {
        "latitude": 40.712633,
        "longitude": -74.0092141
      },
      "address": "27 Barclay St, New York, NY 10007",
      "phone": "(646) 880-1999",
      "fid": "0x89c25a18e3553f8b:0x1337dae5edaabaa2"
    },
    "prices": [
      {
        "title": "Booking.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQGRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASABEgKkQPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3WZxVwX7M7SdQk8bv9GVdk2wUCRA&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xnOTripjyZxILxkGgM1cYmQNCrIY1AgC49RisFNimj2Fshwx2QGIQcEqMKtGUPMMgiTEEzO4iBsB7TbE47tH61of_7vI_YBVxRVepXz1HrN4BiNtYi4Ah55Rj-ClCQiYnxdsj2Tpfv5eCDvZZSbZZLfUosmTOb06MxTGypuYoqum1sM7IVOBEd69gXyVDP61aNCFq1_pfxvUA6hH4zIOqsaudDn5pkTw"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAEEgLuCvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0cXRg9LtSvb94BUoXNgy8J04C5QQ&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 27"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAFEgLqhPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1ar70DInUs8eU0WRh2f8RzL1QKww&adurl=",
            "extensions": [
              "Suite 3 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2440,
              "currency": "USD"
            },
            "cost": {
              "value": 2805,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2805,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zWFS0CdMRk4l9ZyD2WEhENua_lhcl151tKXdiyVEd3df2rCS_OT9oNo1z9ucWUFbu9qUa-2e94u9qYlLAEhP2kfhc2eC1XuqvQIkVleTmhE-GpsCtZ8W7Z6F9iEH-ksjoYLDTXJpWop7XJncxvLfeaoL8HQBbNlYfm9MGirHA9P__hgBbv44tBBEX614hpQmQ4vIL1OrS_55SiEINCqyNKvzxnZ4mSkSo"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQHhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYASAGEgKKYfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3Tw83cHkve-fjPnlHEu96gRaGYag&adurl=",
            "extensions": [
              "Suite 4 guests Free cancellation until Feb 27 Suite"
            ],
            "price": {
              "value": 2540,
              "currency": "USD"
            },
            "cost": {
              "value": 2920,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2920,
              "currency": "USD"
            }
          }
        ]
      },
      {
        "title": "Hotels.com",
        "logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
        "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiABEgLFyPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0Uc0x_tn6Dpzw1hNIA3bvO-V8XeQ&adurl=",
        "price": {
          "value": 935,
          "currency": "USD"
        },
        "cost": {
          "value": 1076,
          "currency": "USD"
        },
        "price_with_tax": {
          "value": 1076,
          "currency": "USD"
        },
        "rooms": [
          {
            "title": "Accessible Manhattan Room with King Bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiACEgLJMfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-IaI3Wc2iZiz04F2g0iO4omJcxw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with Double Beds",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiADEgJLvPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1l9E4tRWWXqZXljR31RIHW1CjIRg&adurl=",
            "extensions": [
              "2 double beds Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Manhattan Room with king bed",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zirGqnNUV3bUkVZ6Yq4QzaxzMTFw8S7BL88YG2xqf5qarRKkr50s-PfillUJkRvSl7KQqXwV9-bVLeYtBRigMpPPejfmFNDLX3qXcjydhC3sIHQL6X9_KcnnQtD_1b8kFPT_gkxt3Bjoif3Alols11Pq0yWqW6dkvZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQIxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAEEgL_UvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2kR-kPDdNnb1lcBUNkpM5s-Q_yLw&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 935,
              "currency": "USD"
            },
            "cost": {
              "value": 1076,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1076,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xfIleTKUi_ePsxGkSstGASzo99qNFBpB94rAAtcEI1C-ZLD4XATuPdh4hGG4RUio3DvonDRyOo7dGZScl55LMBJ7ZEgdijCjGdglXAmtBG3qRZGZdrm-Uggx1OjUAheXtRIDPT0atuWFPccAbkfddjQ7vp6ud3UM4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAFEgKVwPD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0ZrJRz7IXgFt5CcI54GIb2V_aOEA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wuMW97qyG0dgi5Gj5Nob9SzWQ170RVssqu5Fios_swsegU93lsHLoiTo_9hPSttkpklB0QBmU3t8wNPCQgylOL-NJIgsqbtdxI9d0gUE0XKG75M-LzpdyK3M_cTzH8nIl8lL0Sg42N7pxz2ygDzoP-qsR7LH3Hj-q4"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAGEgLyS_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0iD3vQeRSxwkBcCu0F0NEdbpHPBQ&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1035,
              "currency": "USD"
            },
            "cost": {
              "value": 1191,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1191,
              "currency": "USD"
            }
          },
          {
            "title": "SoHo Premier Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_yWbtP4vz4gyFOxx-uO3-5Qz-n7oPrXCYz5CjsOYpGwfd4vSy9B9DmddpQ72H1LjiPhk20d5mt6c1lijronkH7FfBq_eJpzEc5CHGZ7teq5zP3sV-Qv2c7VwXXrPvClVawgmkgAWf80sXLQrVzreBLAZ8lA7k1Ud8YY"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAHEgJD9_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1-qvLSoH3qtZl1Jzkpvr6iRQtDug&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1070,
              "currency": "USD"
            },
            "cost": {
              "value": 1231,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1231,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner King",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_xh7ZruI7-cODN5bzF1IWAG3PEIQADDGgw0sWtDDRk-TbV4EPtEVYDEJewJgMRtl6Zejine24V66DGiU5FlqCq-EMgShWDmqhjLyVs9FERHWG0QxGnFxW7LN7-HGl4UrF7-s8XcAj7YDUQ5xjlaAX-v836WgUq0svU"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQJxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAIEgK2a_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_1zUSId1nUwCQq7yh4XLKuB1Ohivg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1135,
              "currency": "USD"
            },
            "cost": {
              "value": 1306,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1306,
              "currency": "USD"
            }
          },
          {
            "title": "Hudson Corner Double",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_zBdES1oKIM8aMTINPz_t2xtu2KC-uSe_oOKzsl9YklwJYFM1GwO-qFi8swCpTQ_KV9p47-tkiSad2to48uKImdUBLBvt6mhp6Hs8Q18Gxe3ss20foBlRPuXa_2vk47r8GRUWFd23wok1KV0TIGM9U2NVIgJ0V74PeZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAJEgJde_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_22y9VcsfNpoGEERdBgj2VqhrAopg&adurl=",
            "extensions": [
              "1 double bed Free cancellation until Feb 28"
            ],
            "price": {
              "value": 1170,
              "currency": "USD"
            },
            "cost": {
              "value": 1346,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 1346,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_ww5DsjCN4YmZZyFdZwwPcaACASJul2NHBc33CJI6PmL57ABgizbEjzHfF-mdnm5fxu6htw4H8-uYg1_Hp4qVlRby0MErfZfndCcURjMKhkg1-H-L9fnoCjiJ7eBmFoggT1Yxbr1qxMmBTH5lSeBZGEPtjpj86vT0g"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAKEgJvsfD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2U0x0rvKUK5FsuuDInhoRPaeosTQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Liberty Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wzZm0OmUCedgu3fTY7PUUPLbLCV5zcQfVDJeHlIBCvk_avmplnbY5FYHLBDZKrSL5xDNRYIn5kBNf-pTzMl2LYIG88MTku07E2_2upUCMIEmY5ZBgeEaPLdgYIcJi5ZTmfLknhkRwQxfF_ZBA8n0mDClKJ3zKe-XUZ"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiALEgIye_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_34I7FZ_rEBXGJThi3NhYqDuWYI3A&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 2340,
              "currency": "USD"
            },
            "cost": {
              "value": 2691,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 2691,
              "currency": "USD"
            }
          },
          {
            "title": "Accessible Oculus Suite",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQKxoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAMEgIFE_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_3ti3aEDih8ZhM7xCfbWZFN0AcKQg&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Oculus Suite",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_y4BiOX0ESx2hQ7R1AbK80n3kIom2QrPE77qx5wQvFyLUGAipd0VVxl3bzztdN3u3e0coud9niym1jM0s4UhuNUWRzj21SpdUKFbMiimNpy6v_iUqVvWpe-e3YUNId8uEmwiUehwTzNU9zmegcaboD_rrmY0mNts-tK"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLBoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiANEgLNU_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_0LHnRl4WLtqnzsap0aQqFfKg1BbQ&adurl=",
            "extensions": [
              "Suite Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3370,
              "currency": "USD"
            },
            "cost": {
              "value": 3873,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 3873,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLRoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAOEgJKvvD_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2S_jbXgWlzoU8K7yog2CEpOluqOg&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 3870,
              "currency": "USD"
            },
            "cost": {
              "value": 4446,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4446,
              "currency": "USD"
            }
          },
          {
            "title": "Suite, 1 King Bed, Non Smoking, Terrace (Gotham)",
            "pictures": [
              "https://lh3.googleusercontent.com/hrppk/ANjXD_wa3n-lr_eOJ0aPzXtn0Ebx66AFv4U7oXLWeRazx5Mx2o6WFFtgTe3EqZEunp1KCnoJm_wvXijwQ2Myh3MWvnXHxGeOfrUrPAcH16zjLtwHUkWaD5QHJID78QeK4jwRmpjx-VH9LUNu1xj7yJce1r__ZvucnvWD0Zc"
            ],
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwi93-zwnPiSAxXyBwYAHWE7FUMYACICCAEQLhoCd3M&co=1&ase=2&gclid=EAIaIQobChMIvd_s8Jz4kgMV8gcGAB1hOxVDEAoYAiAPEgKOW_D_BwE&cid=CAASuwHkaL1egiUkcaDPYynZOvPq_V1EjqjtDp-9Z46FQkOyBpyfhHc-NUCl9yq3u7QyCAXmMfG7WgM0eJL-m6ffngDwqurgSL9-kC6NPHZDup2xReT7bDxa38ybswFsaU4B_G16xz9HcBlehtT01ctyXGnH2nDuDzIOE0RQGHNLuEE8c-jZ7vZkqreNfIZPxM-8E2BBF9MBAV42LwdqX2MhImKoMRZiXJ2W1Kk1zYceNVQugE8uJgtuFPUBLOmW&category=acrcp_v1_48&sig=AOD64_2C1L5MfDLw9PVpTdVQNSYIu3EKvA&adurl=",
            "extensions": [
              "1 king bed Free cancellation until Feb 28 Suite"
            ],
            "price": {
              "value": 4070,
              "currency": "USD"
            },
            "cost": {
              "value": 4676,
              "currency": "USD"
            },
            "price_with_tax": {
              "value": 4676,
              "currency": "USD"
            }
          }
        ]
      }
    ],
    "reviews": {
      "rating": 4.7,
      "reviews_cnt": 1280,
      "reviews_by_stars": {
        "5 star": "1%"
      }
    }
  }
  ```
</ResponseExample>


# Google Lens async request
Source: https://docs.brightdata.com/api-reference/serp/google-lens/async

Use the Bright Data Google Lens async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="query">
  URL of image you want to search

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=50&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=48&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&vsrid=CKyfsYXfqLqsXBACGAEiJGRjZWVkMGFmLTg2ZDAtNDA5MS04YTg0LWI1OWU2Y2Q2ZWNlOTIGIgJlaCgOOM7hleir95IDUAA&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=44&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEBAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLnWDN_Y-v9FbvWxAgwSTAqqZiZJSalWCSm6RonW6TomqQYmOkmGpin6ppaJKakmVukGiRZmhqxKTGlZmjwWZx7OPXF6u-TmAMYANX5B_RLAAAA&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube - App on Amazon Appstore",
        "link": "https://www.amazon.com/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How to Turn Off YouTube Shorts Remixing [Tutorial] - YouTube",
        "link": "https://www.youtube.com/watch?v=cRHC1EFtsk0",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube (YouTube channel) - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/YouTube_(YouTube_channel)",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "YouTube Shuts Down Original Content Group : r/television",
        "link": "https://www.reddit.com/r/television/comments/s73vjv/youtube_shuts_down_original_content_group/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "How to Upload a Video to YouTube From iPhone or Android",
        "link": "https://www.howtogeek.com/744825/how-to-upload-a-video-to-youtube-from-iphone-or-android/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "How-To Geek",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "YouTube has new features to try. Here's how to use them - CNET",
        "link": "https://www.cnet.com/tech/services-and-software/youtube-has-new-features-to-try-how-to-use-them/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "CNET",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "YouTube is getting a dynamic new look, no matter where you ...",
        "link": "https://www.androidpolice.com/youtube-new-look-new-features-web-mobile-tvs/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRh-53vY1i8heyMuwxhs4Rh2bAOMAEhKGRMSyNqK3XnCg8XxR6fsmw51vJ1BdWTmU0zdaBZKX0INk_QSxu8WtbQpVSnvw7AvcHACAbySI8alifLtpZD7BW9J6s",
        "source": "Android Police",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "An unknown YouTube channel just broke all records… kind of ...",
        "link": "https://www.instagram.com/p/DTcrRD8DUUl/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Get YouTube Premium - YouTube",
        "link": "https://www.youtube.com/premium",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube Recap 2025 now available. How users can see their recap",
        "link": "https://www.rgj.com/story/life/2025/12/05/youtube-wrapped-2025-now-available-for-nevadans/87628967007/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkBRB-B1bhwblr3JZ2n5B-bzIRXa5zL8IeBYmMtvs34T7OWwzAwMnFTasLSxYfqOr82Qi-hJMikzLPqOL4TMHp4APbkxL5s_Y2Vuz9hYxt2Q",
        "source": "Reno Gazette Journal",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Top 10 most-watched videos on YouTube globally as of 2024",
        "link": "https://indianexpress.com/article/trending/top-10-listing/top-10-most-watched-videos-on-youtube-globally-as-of-2024-9644368/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcREHhA82Fap_IO3U-7dlibrn8yJlsi0qT2kUdbck1KimPVEHNIsCtGxstAKlPt07s9RhkEkAIgCRXi9RFzfFCaR0Y8p_z22jf2uaKW4DCqIgJOO0GBmOA",
        "source": "The Indian Express",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "YouTube secretly tested AI video enhancement without ...",
        "link": "https://arstechnica.com/google/2025/08/youtube-secretly-tested-ai-video-enhancement-without-notifying-creators/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQoMdSJ0j3GUYtZdhvAzdB08yh2z11ylT-saWok78BDvRQ-2lYkLNBMp7mID2z5fLuG1RmEM90UiyubJEejEhO0VIEZXzsojyonbUtnqqZ9Q2NvyIk",
        "source": "Ars Technica",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Anyone older than YouTube is officially old enough to drink ...",
        "link": "https://www.reddit.com/r/BarbaraWalters4Scale/comments/1r4ejjo/anyone_older_than_youtube_is_officially_old/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "YouTube should give more prominence to public service media ...",
        "link": "https://www.bbc.co.uk/news/articles/clyl07nekzxo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "YouTube | The Verge",
        "link": "https://www.theverge.com/youtube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQUvjXAGG2ILQkdobGNlrkN845RoDIT9G4L-sPBcsw7sdEAQIF2bqZftAiLLpBKccaBBAjaSpfW9ouqLNlezyTrUZXWckKVGEY4FwEpL2uaLSkcp1gZ",
        "source": "The Verge",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Yt randomly stopped working yesterday - YouTube",
        "link": "https://www.youtube.com/watch?v=SYWjR4Ie9H4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Sorry Search, YouTube Is More Important to Google Than Ever ...",
        "link": "https://www.wired.com/2015/10/sorry-search-youtube-is-more-important-to-google-than-ever/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcThlD2e1C2_v--cgb8ALlm86tHfzrbkhTDvq9HqJqt0GoealFINHn1O1SnJiZeCJz_iJdliO5UpQz_2yc4oIqE_wZwQYOWkpR7S4fJyBLlWCG9w",
        "source": "WIRED",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "5 facts about Americans and YouTube | Pew Research Center",
        "link": "https://www.pewresearch.org/short-reads/2025/02/28/5-facts-about-americans-and-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR17CLniZiP5RD4SSFBbTXMqovUhHiNZ6yCLWZRWhSdopCIttlaz9BdH7uaz3dkB5DNfwoRw2bfkueSYNMVp9gc7dN9ER0CA0x59pXXqIG1tptNBNM52iPO",
        "source": "Pew Research Center",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "10 Reasons to Start a YouTube Channel Today | TubeBuddy",
        "link": "https://www.tubebuddy.com/blog/10-reasons-start-youtube-channel/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQBpw2mbW8vadl8QZpNXIHukGlh5Coavo8CfqmCVM0SS02q94VLSJJLzwjVhOCQSIFe7Hrul3Ykzz-aqn1btCE8KE1zDbk1srhzknIFUWmi3v9eDwTBLw",
        "source": "TubeBuddy",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "How Can I Watch Videos on YouTube?",
        "link": "https://www.ncoa.org/article/how-to-find-and-watch-videos-on-youtube-a-tutorial/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQus8nqyjv6rmz1FLbKGZwnxSd9hg2_yL96BFiHAN5QTJwn-zY4BSa6vY_ZLuZfuYPBbNQe3YDy_mTjL8MRVHMK4-T4re0IpNTONmS2C4dVF44",
        "source": "The National Council on Aging (NCOA)",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Reports that YouTube is d0wn for many users 🚨",
        "link": "https://www.instagram.com/p/DU4h9Wlj3Tr/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "YouTube Has a New Way to Share Channels",
        "link": "https://www.howtogeek.com/youtube-channels-qr-codes/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube Music - YouTube",
        "link": "https://www.youtube.com/channel/UCStaiwu-FAgp_RC_tBiLh9A",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "How To Upload To YouTube [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=s-KZu1kru8Y",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Livestreams and Recordings – Saint Robert's Catholic Church",
        "link": "https://saintroberts.org/livestreams-and-recordings/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRjhous8nGXkV0aOGtVkKN5c1hOh61JSqwS0iq3rZZWxnMc_gYOJFfkdICHl9Am33bjcVi1267LSKrraHCqHZjkiNVaDkNMLWUQ3DdvxgaI5IouOlq8",
        "source": "Saint Robert's Catholic Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "YouTube is giving you better control over what videos are on ...",
        "link": "https://www.xda-developers.com/youtube-better-control-over-what-videos-are-on-your-homepage/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRAME90RmDvZ7n5QF-g_fXA6hrG1UpK1yFStismLE2bPsvQ8NDeM_419lGa-XTsXWEQ7-TMRilzLDBgbo39QRarJ_dIvrWYKxo3Lc1KDOvngg4HxOqxV7yDSBqR",
        "source": "XDA",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "YouTube Set To Overtake Facebook As Second Largest Website ...",
        "link": "https://www.tubefilter.com/2018/08/08/youtube-second-largest-us-website/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQOnfaQAkwfbzgAhZAsN5ZEqvhBteEgAtOUgDLozCYjPpNAwfem0ykIevsPO1a2BQWF_eWOq8yhCPPs39ddN7Qnn_REbXXsh4g8Ox6A4cd2s6tzF_8vt3Y",
        "source": "Tubefilter",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "Church News | Grace Community Church West Allis, Wisconsin 53227",
        "link": "https://www.ourgcc.com/LiveStream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjOVrgTcfOQd208wODKcdmYhpg0A4c8rI0iQOfObfVtqWQ3A82OkIxtd9eJo8DhTCB4XaOFUL34ZsE90N4upcd5sNfeR0y0DH1HagFogmWOS1Jdw",
        "source": "ourgcc.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/c/CalvaryChapelMyrtleBeach",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Simplest way to embed a Youtube video in your React app ...",
        "link": "https://dev.to/bravemaster619/simplest-way-to-embed-a-youtube-video-in-your-react-app-3bk2",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "live — Edgerton First Reformed",
        "link": "https://www.edgertonfrc.org/live",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQX0DHkVwqsNq8LU6oTPXlV6-xin23cGL575S3bUgZ-ziBlBpRnlJZ3jTzBnHkxrc1w_hwFCKe0N3ZBwslfw9g6etfzO4wticYgPriK-2Mu0IXr_c98ZeHj",
        "source": "edgertonfrc.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Lincoln Community Foundation Garden Performance Series - Home",
        "link": "https://artsincorporated.org/fgps/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcS_mDfJIg_rnjz21iR8FusOKVEXvVIiA-75CTo2W2-sI2qE6ostf4cDLy__KgU7p6j5H6qkYP9c1yefmjXdqXrlcrn42fsPCfAlyCZDyPivGq2Luyw4ywFD8Q",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "services — New Horizons Fellowship Church",
        "link": "https://www.nhfchurch.com/services",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTx3EZkS6f0vTYrOCdoVKZ0ixnXJfk3j5vGiEvhGHSQu_S0tK-En_lsD39BVN-vCPey0Az03DUsK682x59bi7rV2Ak9QaYX15hZYCqn6_QGaKllETzKFw",
        "source": "nhfchurch.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Exact matches
Source: https://docs.brightdata.com/api-reference/serp/google-lens/exact-matches

Configure the Bright Data Google Lens Exact Matches parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  The `brd_lens` parameter in your request fetches specific Google Lens **tab results** by specifying a tab value (e.g. `products`, `homework`, `visual_matches`, `exact_matches`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=exact_matches',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={5} theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "exact_matches"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sa=X&sca_esv=2dc65c8cbd5d287b&lns_surface=26&biw=1060&bih=1095&hl=en&gl=us&udm=50&vsrid=CNeD0ePDsf-PugEQAhgBIiRiYmRjMDRlOC04YzcwLTRjZDAtYWUzNi1iMzAyYWQyMGY0M2MyBiICcHcoHDiYp4b09PySA1AA&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=fEUg-2t0DWAPdWWQnNYlwye88VeRdG-Q3ryaW-kJC7VZkm8UN79RVQ&lsessionid=LpJLEfXiJ2BaHlGUfp7QHwMAzKrkYM_GI7nGrYtEkxI3UVsA6QtSGA&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQ2J8OegQIBBAD"
      },
      {
        "name": "All",
        "type": "all",
        "link": "https://www.google.com/search?sa=X&sca_esv=2dc65c8cbd5d287b&lns_surface=26&biw=1060&bih=1095&hl=en&gl=us&udm=26&vsrid=CNeD0ePDsf-PugEQAhgBIiRiYmRjMDRlOC04YzcwLTRjZDAtYWUzNi1iMzAyYWQyMGY0M2MyBiICcHcoHDiYp4b09PySA1AA&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=fEUg-2t0DWAPdWWQnNYlwye88VeRdG-Q3ryaW-kJC7VZkm8UN79RVQ&lsessionid=LpJLEfXiJ2BaHlGUfp7QHwMAzKrkYM_GI7nGrYtEkxI3UVsA6QtSGA&q=&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQs6gLegQICBAB"
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "selected": true
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sa=X&sca_esv=2dc65c8cbd5d287b&lns_surface=26&biw=1060&bih=1095&hl=en&gl=us&udm=44&vsrid=CNeD0ePDsf-PugEQAhgBIiRiYmRjMDRlOC04YzcwLTRjZDAtYWUzNi1iMzAyYWQyMGY0M2MyBiICcHcoHDiYp4b09PySA1AA&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=fEUg-2t0DWAPdWWQnNYlwye88VeRdG-Q3ryaW-kJC7VZkm8UN79RVQ&lsessionid=LpJLEfXiJ2BaHlGUfp7QHwMAzKrkYM_GI7nGrYtEkxI3UVsA6QtSGA&q=&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQs6gLegQIBhAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy4vLguN588fHhjf_7dzEKMEkwKqkkJaUkG5ikWuhaJJsb6JokpxjoJqYam-kmGRsYJaYYGaSZGCcbsSkxFZRryFjMWN725cufScwBDACKWlZTTAAAAA&sa=X&ved=2ahUKEwiixqr19PySAxXrETQIHYm2EFEQs6gLegQIBxAB"
      }
    ],
    "exact_matches": [
      {
        "title": "MRU's YouTube Channel - Emissions Analyzers",
        "link": "https://mru-instruments.com/inthenews/mrus-youtube-channel/",
        "extensions": [
          "Sep 14, 2020",
          "1,140x500"
        ],
        "source": "MRU Instruments",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVMAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Subscribe to out YouTube Channel - Connected Community Schools",
        "link": "https://connectedcommunityschools.org/subscribe-to-out-youtube-channel/",
        "extensions": [
          "980x595"
        ],
        "source": "Connected Community Schools",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "YouTube | Nintendo Switch download software | Games",
        "link": "https://www.nintendo.com/en-gb/Games/Nintendo-Switch-download-software/YouTube-1467860.html",
        "extensions": [
          "Aug 11, 2018",
          "2,000x1,000"
        ],
        "source": "Nintendo",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "extensions": [
          "Sep 16, 2021",
          "780x260"
        ],
        "source": "Music Ally",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "YouTube Music gets background listening for free users in Canada",
        "link": "https://musically.com/2021/10/05/youtube-music-gets-background-listening-for-free-users-in-canada/",
        "extensions": [
          "Oct 5, 2021",
          "780x260"
        ],
        "source": "Music Ally",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Industry figures hail YouTube Music's 50m-subscribers milestone",
        "link": "https://musically.com/2021/09/03/industry-hail-youtube-subscribers/",
        "extensions": [
          "Sep 3, 2021",
          "780x260"
        ],
        "source": "Music Ally",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYUAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Social Media Tutorials - Visual One Law",
        "link": "https://visualonelaw.com/social-media-tutorials/",
        "extensions": [
          "1,730x580"
        ],
        "source": "Visualonelaw",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYQAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYQAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "How to restore Dislikes in Youtube - Hardware Busters",
        "link": "https://hwbusters.com/news/how-to-restore-dislikes-in-youtube/",
        "extensions": [
          "Aug 26, 2022",
          "1,920x720"
        ],
        "source": "Hardware Busters",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAW8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAW8AAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Adverts On Youtube - Can You Avoid Them On Your Video?",
        "link": "https://www.media2u.co.uk/adverts-on-youtube-can-you-avoid-them-on-your-video/",
        "extensions": [
          "Apr 20, 2022",
          "867x266"
        ],
        "source": "Media2u",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZYAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZYAAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "extensions": [
          "Apr 25, 2025",
          "707x190"
        ],
        "source": "Tulsa Marketing Online",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "YouTube | Hitler Parody Wiki - Fandom",
        "link": "https://hitlerparody.fandom.com/wiki/YouTube",
        "extensions": [
          "1,200x393"
        ],
        "source": "Hitler Parody Wiki",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYkAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAYkAAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "Subscribe to our YouTube channel - Tataylino.com",
        "link": "https://tataylino.com/subscribe-to-our-youtube-channel/",
        "extensions": [
          "Apr 16, 2019",
          "640x164"
        ],
        "source": "Tataylino.com",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "In the Asian Evening, Singapore, Jakarta, Manila and North. On ...",
        "link": "https://x.com/tomkeene/status/1821308177930969460",
        "extensions": [
          "Aug 7, 2024",
          "1,200x300"
        ],
        "source": "X",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-4GOC0vgtX2GCD65XyX5eT2urI45FymFw1Uhdwathjbw3GKVDaw8QEto&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-4GOC0vgtX2GCD65XyX5eT2urI45FymFw1Uhdwathjbw3GKVDaw8QEto&s",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "How to: YouTube Marketing - Snob Monkey",
        "link": "https://snobmonkey.com/how-to-youtube-marketing/",
        "extensions": [
          "Jul 12, 2021",
          "1,920x720"
        ],
        "source": "Snob Monkey",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTlRMnxh88z62FES3D7rsZSN2WmKodtzDXtKPnF8veHWW0EnOGZDIFnOkut&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTlRMnxh88z62FES3D7rsZSN2WmKodtzDXtKPnF8veHWW0EnOGZDIFnOkut&s",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "The differences between RTK and PPK. Which method is best for ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "extensions": [
          "1,000x400"
        ],
        "source": "ArduSimple",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTSOfaprHZdVN8UCo8I3KGyyCdaDUgKmETI7BVYwD8EnDpTH2304GR6ic9&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTSOfaprHZdVN8UCo8I3KGyyCdaDUgKmETI7BVYwD8EnDpTH2304GR6ic9&s",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "YouTube Logo and the history of the company - LogoMyWay",
        "link": "https://blog.logomyway.com/youtube-logo/",
        "extensions": [
          "707x190"
        ],
        "source": "LogoMyWay",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB0AAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQy3L_1DMIwi0fIZCfLDMfL7RIVAXgCx6_y7OhadkHjSkbYZxY0xjirBAA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQy3L_1DMIwi0fIZCfLDMfL7RIVAXgCx6_y7OhadkHjSkbYZxY0xjirBAA&s",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Some of My Favorite YouTube Channels - The \"Make Do\" Homemaker",
        "link": "http://makedohomemaker.blogspot.com/2024/04/some-of-my-favorite-youtube-channels.html",
        "extensions": [
          "Apr 16, 2024",
          "1,125x360"
        ],
        "source": "The \"Make Do\" Homemaker",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSywszzbKDZNevDZGLNeU9tv7P4y8wFTXWt_WF17cZxi9O7H_TFXrx4RsA&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSywszzbKDZNevDZGLNeU9tv7P4y8wFTXWt_WF17cZxi9O7H_TFXrx4RsA&s",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "Others - Tataylino.com",
        "link": "https://tataylino.com/category/others/",
        "extensions": [
          "Sep 30, 2020",
          "640x164"
        ],
        "source": "Tataylino.com",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_psUGnh3vZ3sXlJw7jVAYoSuR71ZdDi4qIbGUb0Mro34k51pRhFgRIZ0&s",
        "rank": 18,
        "global_rank": 18
      }
    ]
  }
  ```
</ResponseExample>


# Geo location
Source: https://docs.brightdata.com/api-reference/serp/google-lens/geo-location

Configure the Bright Data Google Lens Geo Location parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  Stands for the encoded location you want to use for your search and will be used to change geo-location.

  ```http theme={null}
  https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw
  ```

  <Tip>
    A CSV with all available `uule` values can be [downloaded here](https://developers.google.com/adwords/api/docs/appendix/geotargeting).

    The value of column **Canonical Name** from the CSV can be used as a raw string to the API

    > **Example**: `&uule=New+York,New+York,United+States`
  </Tip>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&biw=1037&bih=919&hl=en&gl=US&udm=50&vsrid=CNWSwa6dvb26MRACGAEiJGZjZmVkMTA5LWU1YjUtNGY2MS1hZmM3LTcyYzUyYjQ0NmY0MDIGIgJyZCgUOI2kxu-TkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=DZR50JQYyMxbQJrvq7PeV_MY0rIByGIyG3idXE9XvEwv8h4VM8wPfQ&lsessionid=10HbqH5rQCTpEG8xd9XfsRcHLz-290cV44RmAYO_JKusBKWhwkH5Og&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Q2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&biw=1037&bih=919&hl=en&gl=US&udm=48&vsrid=CNWSwa6dvb26MRACGAEiJGZjZmVkMTA5LWU1YjUtNGY2MS1hZmM3LTcyYzUyYjQ0NmY0MDIGIgJyZCgUOI2kxu-TkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=DZR50JQYyMxbQJrvq7PeV_MY0rIByGIyG3idXE9XvEwv8h4VM8wPfQ&lsessionid=10HbqH5rQCTpEG8xd9XfsRcHLz-290cV44RmAYO_JKusBKWhwkH5Og&vsrid=CNWSwa6dvb26MRACGAEiJGMzZDNlNmUzLTFmY2MtNGE1MC05ZjQ5LTkxY2QzNDg0NzI2NTIGIgJyZCgUOI2kxu-TkpMDUAA&q=&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Qs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&biw=1037&bih=919&hl=en&gl=US&udm=44&vsrid=CNWSwa6dvb26MRACGAEiJGZjZmVkMTA5LWU1YjUtNGY2MS1hZmM3LTcyYzUyYjQ0NmY0MDIGIgJyZCgUOI2kxu-TkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=DZR50JQYyMxbQJrvq7PeV_MY0rIByGIyG3idXE9XvEwv8h4VM8wPfQ&lsessionid=10HbqH5rQCTpEG8xd9XfsRcHLz-290cV44RmAYO_JKusBKWhwkH5Og&q=&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Qs6gLegQIExAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLnuDrp4Lq5e_fuMhRgkmBUUklLTktNMTSw1E01TTLVNUkzM9RNTEs21zU3SjY1SjIxMUszMTBiU2IqStEQsehdcuz95EmTmQMYACLVmXhLAAAA&sa=X&ved=2ahUKEwi_y5jwk5KTAxUBcvEDHb79Jl0Qs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube - App on Amazon Appstore",
        "link": "https://www.amazon.com/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How to Turn On Comments on YouTube Channel [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=RlIZ4-RaLpY",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube (YouTube channel) - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/YouTube_(YouTube_channel)",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "How to Message Someone on YouTube",
        "link": "https://www.howtogeek.com/738001/how-to-message-someone-on-youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "How-To Geek",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Springdale Free Will Baptist Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "YouTube, the online video powerhouse, turns 20 - The ...",
        "link": "https://www.businesstimes.com.sg/international/youtube-online-video-powerhouse-turns-20",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcT5N3_bzDYGNT2jalJYdfr8L458W6cjkhi7txmPQNCeYfAwLKYRa01dM-1pEzcSfDW9pLGzZVqOTTADpX0dGNxRFd-qULiLJ4xB7jcbYT_Ofd46fyEd3LyVL-1j2Po",
        "source": "The Business Times",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTpth80AXpzNoCU2kpFOoxi-CSR7bwLgBrwa2ZvU_gI9jCormwe",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTpth80AXpzNoCU2kpFOoxi-CSR7bwLgBrwa2ZvU_gI9jCormwe",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "As disinformation and hate thrive online, YouTube quietly ...",
        "link": "https://www.cbc.ca/news/entertainment/youtube-content-moderation-rules-1.7559931",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXNmMtLoL3Z6BddLurw0e_OAJKtMjmtSQOZ6A7NlD45zcbWRzY7f2GBGKzdX9IKdw7C9AbyIREv9irUlf46b-SQExzT2Vi01mKo8Ei1jo2",
        "source": "CBC",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTG8Yr3O3bHwxq33pMWvAJPw4Tyz-Yg7PGceA4e0l2Hne4vKeED",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTG8Yr3O3bHwxq33pMWvAJPw4Tyz-Yg7PGceA4e0l2Hne4vKeED",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "YouTube is getting a dynamic new look, no matter where you ...",
        "link": "https://www.androidpolice.com/youtube-new-look-new-features-web-mobile-tvs/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRh-53vY1i8heyMuwxhs4Rh2bAOMAEhKGRMSyNqK3XnCg8XxR6fsmw51vJ1BdWTmU0zdaBZKX0INk_QSxu8WtbQpVSnvw7AvcHACAbySI8alifLtpZD7BW9J6s",
        "source": "Android Police",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "Someone just broke YouTube! 🤯 This video is over 1.2 ...",
        "link": "https://www.instagram.com/p/DTcugJjkbhE/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "YouTube now second only to BBC as most popular media ...",
        "link": "https://www.bbc.co.uk/news/articles/c4gzvee78eqo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS75k2PhGgSWUgIpGDWZESBMOoZJh5Rz0RyjgaxkwEN6peMudvE",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS75k2PhGgSWUgIpGDWZESBMOoZJh5Rz0RyjgaxkwEN6peMudvE",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "Top 10 most-subscribed YouTube channels | Mashable",
        "link": "https://mashable.com/article/most-subscribed-youtube-channels",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ7RhLwgx1nFu2wvGlmXALP-5gdBSTAHTHo61tnylb_OE1TylgB9waP9v2lwGMa7cFseQ8lC1ie7GmQqDNfEnPNHgu6SULXkGK45bLtSjMho3Q",
        "source": "Mashable",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTmWpdRF4lk_Sk9GFHAFu_Vr3vdVTLq3aNnjsDUpqgo4sKN1Z-L",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTmWpdRF4lk_Sk9GFHAFu_Vr3vdVTLq3aNnjsDUpqgo4sKN1Z-L",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "YouTube launches its biggest live update: What's new with AI ...",
        "link": "https://timesofindia.indiatimes.com/technology/tech-news/youtube-launches-its-biggest-live-update-whats-new-with-ai-shorts-and-latest-streaming-tools/articleshow/123939418.cms",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQGahxRW9Oc075lMrHzhtYmwFLaO-CZMJ16aIR6QABQBjrURgF1kzgixv8P1D_g-AGpqo-qfCqp4WFV8-cCam-9iz92wPK-i8aGInj83AiKehqzZgsxHSZf6aB-G6dehTI",
        "source": "Indiatimes",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSmYEqxKCvnDXuWiIRff3LPC-AI74uC0PlwIfkrPnypv9TTJ8GK",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSmYEqxKCvnDXuWiIRff3LPC-AI74uC0PlwIfkrPnypv9TTJ8GK",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Shannon Ong - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "YouTube Recap is here. How to view your most-watched content ...",
        "link": "https://www.cincinnati.com/story/entertainment/2025/12/04/youtube-recap-2025how-to-view-most-watched-videos-content/87601902007/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR27tm_wiYENng1DwhCw2hHE-PifONmz3eN7eRaSr85X5NOl3M7uQQvNP_zd950V0OZG2Y3QemU27pUUCQRbPsqdpLJlzgOK3OxVCBu1cDfvNIPfAlKldE",
        "source": "Cincinnati Enquirer",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise - Internet Safety",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "YouTube Is a Big Business. Just How Big Is Anyone's Guess ...",
        "link": "https://www.nytimes.com/2019/07/24/technology/youtube-financial-disclosure-google.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRszyNSCYR04WGtSoefBwhwwe0NZDJ2NRax9ELrHGpQtwbG2FlJEx0ypzELo9V6Wpi6bcLEWpUcrMTLpkhIptbuYuWkKpaRsx-z4E6t7l8zAoUPsCc",
        "source": "The New York Times",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcStmaUZMu5JHN9J3SglDlcn2E-q03ztxHL5MwhQm9Ru1qeD4o-q",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcStmaUZMu5JHN9J3SglDlcn2E-q03ztxHL5MwhQm9Ru1qeD4o-q",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "YouTube Australia & New Zealand - YouTube",
        "link": "https://www.youtube.com/channel/UCgffSD0hpI0nglPAV_77dtA",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Youtube: Latest News, Entertainment, and YouTubers | The Sun",
        "link": "https://www.thesun.co.uk/topic/youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTAzmaCeD7SECQ6CzPSL-VtJwcaglmxyDTR5rjxf1QsNNldg6Ahh515idFNHVCPJF3-vrEuRFIgpzGHMAuf1O3tkyjn_KuGrOJcB6ZDtoxo8EkQimfu",
        "source": "The Sun",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT246CmjQ5nHxzTYzWqaOmHWpZRNYZszEwX16RfyEdnh-mbKEq-",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT246CmjQ5nHxzTYzWqaOmHWpZRNYZszEwX16RfyEdnh-mbKEq-",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "YouTube Stops Counting Paid Ads in Music-Video Viewing ...",
        "link": "https://www.bloomberg.com/news/articles/2019-09-13/youtube-stops-counting-paid-ads-in-music-video-viewing-records",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQe8-4u1vGHnWI08nokhQFeCBq2xuVVby17tJeU809SoWIBa1aZsXjfC6uoUnIhUMVxQJ6mFczTws3NcsaQRl5J1JOXqlx_niS6uct6oz-52kMQZtZEiQ",
        "source": "Bloomberg.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQIsKpZ2VIjNLorJiTxxVc7O_FB7wwCgq82vZVNXjlPcuTs45D9",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQIsKpZ2VIjNLorJiTxxVc7O_FB7wwCgq82vZVNXjlPcuTs45D9",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Top 10 most-watched videos on YouTube globally as of 2024",
        "link": "https://indianexpress.com/article/trending/top-10-listing/top-10-most-watched-videos-on-youtube-globally-as-of-2024-9644368/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcREHhA82Fap_IO3U-7dlibrn8yJlsi0qT2kUdbck1KimPVEHNIsCtGxstAKlPt07s9RhkEkAIgCRXi9RFzfFCaR0Y8p_z22jf2uaKW4DCqIgJOO0GBmOA",
        "source": "The Indian Express",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "News and updates about YouTube | Google Blog",
        "link": "https://blog.google/products-and-platforms/products/youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcStL-sTzHn2J4VaK5tWXvxPveo_FDanN9An682O-vsvvva1mpz3OvUYdtmBNqFXZBSCAaE8oq_nkmdnRPg3lOUregpQRTKpqiQAjs18pfPSUQ",
        "source": "blog.google",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTt0bO3rityxtULGmxQEMrEyasw8yy5NIpK_5zOdPx0_6rNpqUx",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTt0bO3rityxtULGmxQEMrEyasw8yy5NIpK_5zOdPx0_6rNpqUx",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "YouTube should give more prominence to public service media ...",
        "link": "https://www.bbc.co.uk/news/articles/clyl07nekzxo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "File:YouTube 2024 (white text).svg - 维基百科，自由的百科全书",
        "link": "https://zh.wikipedia.org/wiki/File:YouTube_2024_(white_text).svg",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTgod29MM5WNalqnjIcBsJz-FYzexdoriMaYgfDJBNVB0dbbr8oUvUUdO4TpGJwnQik_QDLqNUx8Xng_fGxFXTCjPoQ5kaT0V-VDXPPm6cez-UNBLHj",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcR_SW1C9p0Im0tfYKM0a6X_vnDSB2PBhaui6vlP1juYkU54F6De",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcR_SW1C9p0Im0tfYKM0a6X_vnDSB2PBhaui6vlP1juYkU54F6De",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "The YouTube app is about to get a big change for millions of ...",
        "link": "https://www.tomsguide.com/phones/the-youtube-app-is-about-to-get-a-big-change-for-millions-of-users-heres-how",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQsE43WEfOZgVYWDovFX_tyPSpSCRqQFo91ibMPqiy_m0F1N4zEImtI17toXeeuTIJYtqiOnB_2IPvFYGTZqmWbYqamkcqaiG1WI3FXmcAKcbogzL4nuw",
        "source": "Tom's Guide",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR-WWCeow11tvybRoNr-Iuy7_WJviCTGg1k3EIWXWWPA3w0HdN6",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR-WWCeow11tvybRoNr-Iuy7_WJviCTGg1k3EIWXWWPA3w0HdN6",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "10 Reasons to Start a YouTube Channel Today | TubeBuddy",
        "link": "https://www.tubebuddy.com/blog/10-reasons-start-youtube-channel/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQBpw2mbW8vadl8QZpNXIHukGlh5Coavo8CfqmCVM0SS02q94VLSJJLzwjVhOCQSIFe7Hrul3Ykzz-aqn1btCE8KE1zDbk1srhzknIFUWmi3v9eDwTBLw",
        "source": "TubeBuddy",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "YouTube Premium - YouTube Music",
        "link": "https://music.youtube.com/youtube_premium/family",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ-VBgsmwz5f69M533t3sJUHkFBS_kxEG3iuqRIevaZHUUbgiPCwBCSivswuNFKV42TtMpHyFx8k7aRMWDlPWNRF5-O_2wJbazOBTE4A4GnbUXlpRn4RA",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Get Ready to Talk to the YouTube App",
        "link": "https://www.howtogeek.com/youtube-conversational-ai-feature/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "List of YouTube Premium original programming - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/List_of_YouTube_Premium_original_programming",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "YouTube Music - YouTube",
        "link": "https://www.youtube.com/channel/UCStaiwu-FAgp_RC_tBiLh9A",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/channel/UC8-zrGpx1tbkjV4vOzlLvdg",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "How To Turn On Comments On Specific YouTube Video [Guide ...",
        "link": "https://www.youtube.com/watch?v=YaLKiiIjPFo",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Find Out Who Posts the Most Comments on Your YouTube Videos",
        "link": "https://vidiq.com/blog/post/youtube-video-comments/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRi92uWOGPpN-xT5Ryt5IsYXvQHoOTBvyLZ2UjgKY_BLC8EJVHrkRRsBYEkfaKwauzv1iwUYLMLcLs84kgjvH43R9WYkdS7Okx5MWmEzWE",
        "source": "vidIQ",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTdiX3UycHs_XFFkysSeTNa27anWDPZA1eGMDEQ4uRrj35e2Vpp",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTdiX3UycHs_XFFkysSeTNa27anWDPZA1eGMDEQ4uRrj35e2Vpp",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "YouTube app gets a huge redesign - PhoneArena",
        "link": "https://www.phonearena.com/news/YouTube-app-gets-a-huge-redesign_id97544",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTzmmUWlKNu2N6Vu_BuvybF4XRJzXoEG5iXXHkZMamhlXGoSgsSvpeu9hQP8FywapcndqFH07W0BWQ3DUcUTSh89ouuATT334y1FEgi-BAx9N93KNMDMNw",
        "source": "PhoneArena",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Lincoln Municipal Band - Home",
        "link": "https://www.artsincorporated.org/lmb/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQuvdPTZZ78-9IyZ_1DsRl9-qzEAGLKh2kDWKxvcYVspd4pk2Ua9HA--cFdERby410oLEF3KxmAdP-0p_dpjWLh4V0MqU3eKqpU_PSiKWmjX2RJszYD1WTCQyTttSg",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "new u-center video tutorials on Youtube - ArduSimple",
        "link": "https://www.ardusimple.com/u-center-tutorials-with-ardusimple/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Second chances on YouTube - YouTube Blog",
        "link": "https://blog.youtube/inside-youtube/second-chances-on-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ6knNVKlTZXHba4AvgwcPeP1LSOT0TtO_nBtUHwAPuP-HGZD_UR3N4CIuTBLH014pjXkVi8F1RBibCJPxLvsuH6kqD7AxlkWJpv5mcAAer2BE",
        "source": "YouTube Official Blog",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Simplest way to embed a Youtube video in your React app ...",
        "link": "https://dev.to/bravemaster619/simplest-way-to-embed-a-youtube-video-in-your-react-app-3bk2",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "YouTube | DanTDM Wiki | Fandom",
        "link": "https://dantdm.fandom.com/wiki/YouTube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDCanRiWJrZS7a13YyMPPZ6coybQKs2az6TVioAGkAmKXHG0PBmhzVHm1YMDZdiI1hUyOkhQJ3blcHmQK0ItSZzAgSbzPtQZS1C8COApTsVzE2QQNqgg",
        "source": "Fandom",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTLwjLbNQwAMg-RuJ8KfrLlNWHvHxtx72iFWtW2PjOtlbseAaSR",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTLwjLbNQwAMg-RuJ8KfrLlNWHvHxtx72iFWtW2PjOtlbseAaSR",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "Streaming — Circa Blue",
        "link": "http://www.circa-blue.com/streaming",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTt3fNIjA-fl6fHJU_Tgl1Fk56_swi_Ij-_JFF5erPd7uzyCKFJy9ns5E9-tjhfWsQHN3FR47EQtgit-UWbLwsbIdRRNp-iQH2AC4L7nscMj3e-XADIgw",
        "source": "Circa Blue",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Church Online — Littleton Church of Christ",
        "link": "https://www.littletonchurch.org/churchonline",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQmfVipbq7rQtwPoqC4Po-xMH3P5qM5wg-EiVrEzIM2YuYZi43HsxiThXF45lTkdaYGMxPX9S2W8IVzVEU9fT930n6iskBckvsKR2IypAVZNdYDIvPFY6v82FNF3A",
        "source": "Littleton Church of Christ",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Homework
Source: https://docs.brightdata.com/api-reference/serp/google-lens/homework

Reference for the Bright Data Google Lens Homework parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  The `brd_lens` parameter in your request fetches specific Google Lens **tab results** by specifying a tab value (e.g. `products`, `homework`, `visual_matches`, `exact_matches`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=homework',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en-IT",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=48&vsrid=CNOUvZmOpL2mwgEQAhgBIiRmM2MwMDIwOC1iNWQ3LTRlYzYtOGM0MS04MmUyODY1NzYyYmIyBiICbHUoGTiiwvzx9fySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=199BB_yGai7OYftshUcQc_T1bixm7iSCOlobtaK0eHMeUJZrpcZ5Ng&lsessionid=YplFE6xNV5NtX7HzSrAuqm7Dy9VcsV2Jk_HtsKDahzJkkw0tHtBl1g&vsrid=CNOUvZmOpL2mwgEQAhgBIiQwZTFkYzdjMS0xNDdkLTRmN2QtYmE0Mi1iOTY5MDdjZWEyMzgyBiICbHUoGTiiwvzx9fySA1AA&q=&sa=X&ved=2ahUKEwjapK_z9fySAxWVDxAIHXA9KdsQs6gLegQIExAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?newwindow=1&sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=44&vsrid=CNOUvZmOpL2mwgEQAhgBIiRmM2MwMDIwOC1iNWQ3LTRlYzYtOGM0MS04MmUyODY1NzYyYmIyBiICbHUoGTiiwvzx9fySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=199BB_yGai7OYftshUcQc_T1bixm7iSCOlobtaK0eHMeUJZrpcZ5Ng&lsessionid=YplFE6xNV5NtX7HzSrAuqm7Dy9VcsV2Jk_HtsKDahzJkkw0tHtBl1g&q=&sa=X&ved=2ahUKEwjapK_z9fySAxWVDxAIHXA9KdsQs6gLegQIEhAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAAFMALP_IkoKSAjTlL2ZjqS9psIBEAIYASIkZjNjMDAyMDgtYjVkNy00ZWM2LThjNDEtODJlMjg2NTc2MmJiMgYiAmx1KBk4osL88fX8kgNQAOdfoXtMAAAA&sa=X&ved=2ahUKEwjapK_z9fySAxWVDxAIHXA9KdsQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "File:YouTube Logo 2017.svg - Wikipedia",
        "link": "https://it.wikipedia.org/wiki/File:YouTube_Logo_2017.svg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAdsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAdsAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube-Nuovo-Logo – Parrocchia Ss. Rufina e Seconda ...",
        "link": "https://www.santerufinaeseconda.it/youtube-nuovo-logo/",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "Parrocchia Sante Rufina e Seconda",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "L'alternativa a Youtube? I nuovi social video | Webhero",
        "link": "https://www.webhero.it/alternativa-a-youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "webhero.it",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "File:YouTube Logo (2013-2017).svg - Wikipedia",
        "link": "https://it.wikipedia.org/wiki/File:YouTube_Logo.svg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Social",
        "link": "https://www.volleylivorno.com/social.htm",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "Volley Livorno",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQsAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Youtube logo per popolare in linea media soddisfare ...",
        "link": "https://it.vecteezy.com/png/22721714-youtube-logo-per-popolare-in-linea-media-soddisfare-creazione-sito-web-e-applicazione",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Vecteezy",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAARwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAARwAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Abbonamenti YouTube come funziona | by Michele Maccini | Medium",
        "link": "https://medium.com/@michelemaccini/abbonamenti-youtube-come-funziona-343d2314b1b2",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Medium",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "YouTube Creators Italia - YouTube",
        "link": "https://www.youtube.com/@YouTubeCreatorsItalia/shorts",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "YouTube (Website) - SteamGridDB",
        "link": "https://www.steamgriddb.com/game/36663",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "SteamGridDB",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAALcAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAALcAAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "YouTube now second only to BBC as most popular media ...",
        "link": "https://www.bbc.co.uk/news/articles/c4gzvee78eqo",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "BBC",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Social Unipv | Università di Pavia",
        "link": "https://portale.unipv.it/it/social-unipv",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAA...",
        "source": "Università di Pavia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "YouTube",
        "link": "https://www.youtube.com/watch?v=2rjtpWxRSP8",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAA...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "YouTube: app su Amazon Appstore",
        "link": "https://www.amazon.it/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRrWOi-uC3lC6i4Y5BR23l1r_krEzq6-XeaA-OmOUDcF7MinJfzKPpK8BLim4sdIhs1McRYibNwWRyVuUwqb9-s6vvkCfbv-XG6KQuPTpYyLOt2",
        "source": "Amazon.it",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-6m6YWsWrwK0xLxwV3BwaFdz-2ShM4ZmwbBHxiaB1psVHSuGY",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-6m6YWsWrwK0xLxwV3BwaFdz-2ShM4ZmwbBHxiaB1psVHSuGY",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Cos'è Recap di YouTube, il riassunto del tuo 2025 come ...",
        "link": "https://www.fastweb.it/fastweb-plus/digital-marketing-social/cose-recap-di-youtube-il-riassunto-del-tuo-2025-come-wrapped-di-spotify/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQibqeiTf2oFFIN3s6727bZSB4Eh1lvb2OvJmpGdkfR7-S__vUDUXK7ZtPlN5Zxn6s9VhgIQQeesoWmdXjq4U3aaUFd4J5NvcsORecUJ1teM-PwvQ",
        "source": "Fastweb",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVH2dSLC7vGH3Y1yHXjdN1813MLPK5CK-TfI2qcTc4Zb32IXy7",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVH2dSLC7vGH3Y1yHXjdN1813MLPK5CK-TfI2qcTc4Zb32IXy7",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "File:YouTube icon (2013-2017).svg - Wikipedia",
        "link": "https://it.wikipedia.org/wiki/File:YouTube_icon_(2013-2017).svg",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT2KN4_0uNdyYsmuqBnsfNd2oA3qDagOJceNJq4UmjB5HJYGxbH-XBIhG9cB-OPNzK4-NViS9Rx5Qbhckroz79jN-qc9tfJZGFIkiBOLs0yqgITnKC4",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTM9jPouDIip3ZBRP4KSYlnrmN6mbKLej1iYljENHlNRMKZANkH",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTM9jPouDIip3ZBRP4KSYlnrmN6mbKLej1iYljENHlNRMKZANkH",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise - Internet Safety",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube compie 20 anni, ecco come ha fatto la storia | Wired ...",
        "link": "https://www.wired.it/article/youtube-20-anni-storia/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNZPRbDNIzqnpXEHf9D7gMsMgswNoc6Ai37G-l1N3pvkacWcLbUEyoW3tsBvzel43K6dUNlJ40GxqCQU2KUizIP64IQ5ws8e6N-8Q1-MLHtG8",
        "source": "Wired",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQHkhjtx-2zs48nSm64xwXgqqAp2ZaOPOWgiKlg1Cg5fyaQpt0R",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQHkhjtx-2zs48nSm64xwXgqqAp2ZaOPOWgiKlg1Cg5fyaQpt0R",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Installare APP di YOUTUBE su Windows10 - YouTube",
        "link": "https://www.youtube.com/watch?v=0sk3XWTRKCY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjTW3p5Nd9g_MBrLsKVgg4xCEp5tfcDUn0JX1zuLVhshjygn2N",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjTW3p5Nd9g_MBrLsKVgg4xCEp5tfcDUn0JX1zuLVhshjygn2N",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "I canali YouTube da seguire per imparare la storia ...",
        "link": "https://www.focusjunior.it/scuola/storia/canali-youtube-storia/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ_Ztb3_R87Lu4TAwYlJh4eQS2DFxwc6Hjy4fNTmHj2WcpOY0JSBg6M93uVJtSZglgzTMPO9IhAlk9MfCnR0guQtlhZcSFpDMH-ui_8UPNmO0CifGa7f_U",
        "source": "FocusJunior.it",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSTLmZSLFh9nZYcFeAHEk9gKYx4UhtbsLA6iyHLPlvvUg5qCYZK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSTLmZSLFh9nZYcFeAHEk9gKYx4UhtbsLA6iyHLPlvvUg5qCYZK",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Canali Video | Dipartimento di Chirurgia",
        "link": "https://chirurgia.web.uniroma1.it/it/canali-video",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSfJxpEqOXXBiVDlt5IZlpYGoN3lzKbj6vD6YsAucBIwVBD4ehjMyaNuN7_c0Ha9bvVpJ1mXWPN-EgqIMnO7Nl0L4kX-d2jyPymqjipoKfh9McdVzu0jL_hTldPD-sF",
        "source": "Sapienza Università di Roma",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQN41rEo-ELHGSR8uZak6deN5MHa258xeZNO2zerFebjzL8yCz0",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQN41rEo-ELHGSR8uZak6deN5MHa258xeZNO2zerFebjzL8yCz0",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRt9iyy-3-IW5iqOAYPaXafEUkma3FFNpyZ975Llg6NySgv6jDhL0aC_yGcYyedQxEPrACxZiQcVikTSGJKfEPFpCr0bG55riarTKeEvAGH",
        "source": "varvid.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "How to share a YouTube video starting at a specific time ...",
        "link": "https://www.foxnews.com/tech/how-share-youtube-video-starting-specific-time",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQVx4PNOkwyIKigtzRRkbJhhFkJHqN_SRMlPVlAq-1o8H9-VoeLnReotGS2Fkrg1KkJqFas-T4SuJ0YVKtQx5MZEu0ladHVFErrMwzVLr1-aon-6FI",
        "source": "Fox News",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTOoImdEyesSvClzoCpQvmbJmAsN7lfIbIRVsGNHsWXWkRGzNaC",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTOoImdEyesSvClzoCpQvmbJmAsN7lfIbIRVsGNHsWXWkRGzNaC",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Storia di YouTube - FASTWEBPLUS",
        "link": "https://www.fastweb.it/fastweb-plus/digital-marketing-social/youtube-la-storia/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQibqeiTf2oFFIN3s6727bZSB4Eh1lvb2OvJmpGdkfR7-S__vUDUXK7ZtPlN5Zxn6s9VhgIQQeesoWmdXjq4U3aaUFd4J5NvcsORecUJ1teM-PwvQ",
        "source": "Fastweb",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSzv_0opRJ0u9J_Lcbbr0LY_4PGj6MNzNnsobq6-mGou5-hIezj",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSzv_0opRJ0u9J_Lcbbr0LY_4PGj6MNzNnsobq6-mGou5-hIezj",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Pubblicità su YouTube: quanto costa e come farla | Italiaonline",
        "link": "https://www.italiaonline.it/risorse/pubblicita-su-youtube-costi-e-consigli-pratici-per-iniziare-2704",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQzG707t-UnUkkRWg4KMLn7GIjexYOv4o7xwM0Uz-g7WVQ3rQpAIATR55SpSz1V1Tq4xeIqHIlpKwjI9J__AWDdoelelTtfCfGsmJusO-yRD8fAEk_HWwlW",
        "source": "Italiaonline",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ24gfzQMiyMHQCrMxA_AVhoU_T4Z2VKliwWYRjUY5WpwMkLw36",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ24gfzQMiyMHQCrMxA_AVhoU_T4Z2VKliwWYRjUY5WpwMkLw36",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "YouTube Creators (@YouTubeCreators) / Posts / X",
        "link": "https://x.com/YouTubeCreators",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSofvqtbDtdUTZsANJSe_PTSgsuDSmzMNykD5ePbsMk3EyTY0EoF56jNp_rHuufm9BtNpZYsFhp9M6u-DLxqcg2x-FRa41-OCrNmA",
        "source": "X",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "YouTube Premium Hiking Prices On Family Plan Service Just ...",
        "link": "https://www.imdb.com/it/news/ni63800513/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFehdJYsJGaKRE9UV-IK0kaOc0dNWXVGr3XLPVFUGvc-sssumlm-DVVWDCahNCXEbCcS9XnW6yhTAYAjfCH8kiJvjjmg2R3XCq5d_cl1CJe0c",
        "source": "IMDb",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRUdwMKaMRwijquPGu_ZMr2yIh-lfejdvzeXEUCGNwG_2n-tIZk",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRUdwMKaMRwijquPGu_ZMr2yIh-lfejdvzeXEUCGNwG_2n-tIZk",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "Cost of Living in Italy | Italian Cell Phone and Home Internet",
        "link": "http://www.rafaeldifuria.com/2-cost-of-living-in-italy/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSSG0TUm1VLSIjW78ktClbDJulZat6eOZP3TJxOP1PdHL6PZTGop5ECoMjdHNN0lecB0JDj8uJj_1kkM9Q87mOfPdABhegUSEWpxq9Fj3M59_GRYPRszlFA_A",
        "source": "Rafael Di Furia",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdy8ZDbQmGHV96HohESFUmKVQINpBGorhyafzXgCcIOYhx5_oJ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdy8ZDbQmGHV96HohESFUmKVQINpBGorhyafzXgCcIOYhx5_oJ",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Lo youtuber: un lavoro di fatto o solo hobby? - CMW lab",
        "link": "https://www.cmwlab.it/talks/lo-youtuber-un-lavoro-di-fatto-o-solo-hobby/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDS40iZ9iFdwM0TimYwq-JoKczfwRWm7IX1qzwu9jMmVA-my1r6OLC2qkLZhlbHtP-q15MSAARchruDzl5d4M5yJDz_k6LvWmgW7jDh3uBUfVt",
        "source": "cmwlab.it",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRixio63NO9jA1g35ur5-MbGRcXPbkfdB19_NshxJmHXFiCuORW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRixio63NO9jA1g35ur5-MbGRcXPbkfdB19_NshxJmHXFiCuORW",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "Come funziona l'algoritmo di YouTube | Salvatore Aranzulla",
        "link": "https://www.aranzulla.it/come-funziona-lalgoritmo-di-youtube-1546586.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRUu0vV7VyqmAzB58l9-BV8KO7uXEv-d4K9t-cRarNgGwxsjyslQbkplYUCIfAsXtpEqzxxgl_ZfX3bkWztATTed0jsqb74J0Ua-KH4cV7BS6-i8oVS",
        "source": "Salvatore Aranzulla",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTYMrxHzP3aoUB_2mrdV54z20x_HgJPjhXuUw4eA53yc11D6hNY",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTYMrxHzP3aoUB_2mrdV54z20x_HgJPjhXuUw4eA53yc11D6hNY",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS5aAPiqqU_t-jR1gLb3Fs8bPIaW2N7eKjZlmGEZUU8MP0N-sP_",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS5aAPiqqU_t-jR1gLb3Fs8bPIaW2N7eKjZlmGEZUU8MP0N-sP_",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Come funziona il sistema dei video consigliati su YouTube",
        "link": "https://www.franzrusso.it/condividere-comunicare/come-funziona-sistema-video-consigliati-youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQaF0FSE7PxA7btowNW0WI4eDj_FIKEI_8408re2-q1-EWHUjS5AQVoTTaJ-RakzjGMdUBAvUq-zSLlGEqkkpNnEcOtOky24fZQuUa_IiOj565m9k0KBw",
        "source": "Franz Russo",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT-1SdNMHWAPCiQEx-PaXPiQgbyeVdsltTbQ1JQ2wYMJqxu4kPJ",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT-1SdNMHWAPCiQEx-PaXPiQgbyeVdsltTbQ1JQ2wYMJqxu4kPJ",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "I 10 video di YouTube più visti di sempre | Wired Italia",
        "link": "https://www.wired.it/article/video-youtube-piu-visti-di-sempre/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNZPRbDNIzqnpXEHf9D7gMsMgswNoc6Ai37G-l1N3pvkacWcLbUEyoW3tsBvzel43K6dUNlJ40GxqCQU2KUizIP64IQ5ws8e6N-8Q1-MLHtG8",
        "source": "Wired",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRM76n1BuaKDNQ68GXp_7gBquBqhONk5FYIlzrpM8FOTfAqKlXv",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRM76n1BuaKDNQ68GXp_7gBquBqhONk5FYIlzrpM8FOTfAqKlXv",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "YouTube for Android TV - Download APK per Android | Aptoide",
        "link": "https://atv-smart-youtube-tv-bridge.it.aptoide.com/app",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRmou9huBiGuvQ21o1_oHca9pNgDLkKfBV39Ymzeqzl9bVNgBcQESX4EAfJATbcbQY7S7GQuJO1Ou6Jc24MdGEl8WlzAqg5TJjUSdBlq3Ukq0yLY5PpixNL4RUL2kJVtac3Fo67G2BmBOCHfCB5okQ",
        "source": "Aptoide",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQbFb_Z78oKP5XSvEuouNwS_eTmOoVZjJsJNzdvHMokFARfQcCI",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQbFb_Z78oKP5XSvEuouNwS_eTmOoVZjJsJNzdvHMokFARfQcCI",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube | Giochi scaricabili per Nintendo Switch | Giochi ...",
        "link": "https://www.nintendo.com/it-it/Giochi/Giochi-scaricabili-per-Nintendo-Switch/YouTube-1467860.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcToBGjo96GmUCHevYIGmN-UpS53MeR2ZhzA3_OkIOo1c13GKN_eBvJl9QW6mzxeD5hTpJ-y6aDxlz1ebw2zFTwvBQpumpCdgwqbY9MRx5lDJF5Ae_Qe",
        "source": "Nintendo",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Come scaricare un immagine copertina di un video YouTube ...",
        "link": "https://webalquadrato.it/come-scaricare-un-immagine-copertina-di-un-video-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQqQLHtVtIDCM4p5M9cKyfWvs5oDIfpFJfHM-vRxjW2lSZ2fiShFZO5qOTXBiu0qgA_-nJOD15TpD_-4orPtUBnc5n-PMslDq5f983xndy1DgwZmzob",
        "source": "Web al quadrato",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "List of YouTube Premium original programming - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/List_of_YouTube_Premium_original_programming",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQCdjg8v5Sy3YsUUJ7-QKrqKVv26GF2AbrlVv_rQrpC5kdTfq9_",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "YouTube come mezzo di comunicazione. I canali diventano ...",
        "link": "https://www.ecommerceguru.it/youtube-come-mezzo-di-comunicazione/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTlXC0HckJlOMKsilif9KELjOHd62VYSJFK0mmewDY9MDAHHi5mGbZATgwf9k581dMWeh1F_DidSh11JvqMsWzelPmDvArMyJnlogBFKOkDzeu6xgKiikhvpw",
        "source": "ecommerceguru.it",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQ4WRq8HcvOsFshqR-1_Mqnh8S8nyW5vqEc7U0mQsCAMAQZvXva",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQ4WRq8HcvOsFshqR-1_Mqnh8S8nyW5vqEc7U0mQsCAMAQZvXva",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "youtubelogo.tiny - Piccola Università Italiana",
        "link": "https://piccolauniversitaitaliana.com/blog/youtube-channel-of-our-school/attachment/youtubelogo-tiny-2/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR_uujiZj-c2T9IQGsi6RNDQA89V4tPPS5KRIxQZ9N88MXVOjUm4UoW-68H-wX87kpvdGQooJKCi1audgBArGeKR1a8zRH9D8hYgcR6mwH7nciS06nMb8nanUXoewto4NcU9g",
        "source": "Piccola Università Italiana",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT1WIniCTAf1KvBtx0SgYqJnVbcv2-_Ss44mQt0Z6xqtFZ27oAx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT1WIniCTAf1KvBtx0SgYqJnVbcv2-_Ss44mQt0Z6xqtFZ27oAx",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Città di Ponte San Pietro : Canale YouTube: aggiornamenti video",
        "link": "https://www.comune.pontesanpietro.bg.it/novita/comunicati/dettaglio-notizia/Canale-YouTube-aggiornamenti-video/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQYy6M3JjkX0X8LPbEOZE4CKd12ng6JUKdWNiyzTNZJ6sQl3rJtN7USDPjLsV-quvoQfua6PHHUlDqm9DlYGTlNZOwqt2JsjYxjLCzBzofYZHBnh5TLsWLRhLBSIP2wNx3BaZpR",
        "source": "pontesanpietro.bg.it",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuKDi6F0Pi_otuJXdsJk3LoL3vUdYphDcle31ckVsg5tR1ce_3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuKDi6F0Pi_otuJXdsJk3LoL3vUdYphDcle31ckVsg5tR1ce_3",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "Press",
        "link": "https://www.iiha.org/press.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRhW5srReDyH4_Ak-Tx9sMmSq-Dbpveb62oLnH4KmiLq3WFl3jmpv0iPDENzO-MoVm8mduSVpKp_WebkoCPBxhk8dFAXXiZwVYRfIxPXJ5JWro",
        "source": "Irish Ice Hockey Association",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ2hEDNlncUZyS8U3J6dUD1-BxhSq1amS3ffxckJGdzzilKYXsJ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ2hEDNlncUZyS8U3J6dUD1-BxhSq1amS3ffxckJGdzzilKYXsJ",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "YouTube su Switch: un'accoppiata che funziona",
        "link": "https://it.ign.com/nintendo-switch/147290/feature/youtube-su-switch-unaccoppiata-che-funziona",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSSV2SvwjCHocUU61DsiGPk_xEyElRFvCIpM_4xYZbvJZt60dCBPEDxcQG_Btpd1nXTXg3O6C2K0d7Knb8SZOxPols7I1RBKwjo2DG8czqG",
        "source": "IGN",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ4guUHpb7PpQ0iB6vnGeBIVPaKrwBMErmLOxQYBGwoWW434KJK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ4guUHpb7PpQ0iB6vnGeBIVPaKrwBMErmLOxQYBGwoWW434KJK",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Second chances on YouTube - YouTube Blog",
        "link": "https://blog.youtube/inside-youtube/second-chances-on-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ6knNVKlTZXHba4AvgwcPeP1LSOT0TtO_nBtUHwAPuP-HGZD_UR3N4CIuTBLH014pjXkVi8F1RBibCJPxLvsuH6kqD7AxlkWJpv5mcAAer2BE",
        "source": "blog.youtube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTTf5i3EODOl4b32sCP5Yhgj4hNmvVPWgwZTD5YDT0OncItqKCO",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "Talking Socks – Yarndale",
        "link": "https://yarndale.co.uk/yarndale-hub/talking-socks/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRW-jDkjydIsMxsIswJAjXKYPgAGHbi5frCW_wkxIlJVsn_RX57VXne-KKjHK3yL5mtffPfYwTcrfJuXw4HXZ2YD6jOEsMhuRORN8GTa40qsyq_Ww",
        "source": "Yarndale",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSdYWY7pF-cjaLg7cqkh-bus_51jAvae90N7h3ieGK14aqKSA1G",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSdYWY7pF-cjaLg7cqkh-bus_51jAvae90N7h3ieGK14aqKSA1G",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Best Free YouTube Video Downloader for Windows 2025",
        "link": "https://www.donemax.com/video-download/top-4-free-youtube-video-downloader.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT42ycJdf2UKgzoluI34OleyFF20kCMoM4nCVIyKw6nZHeVCEEYZRNkNzQOSdCzqTsMJC0veLw3rjdZkoJJJb57F_FMNM63E8_laLInHR0Vxvk-wSQ",
        "source": "Donemax",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Testimonianze - Clau, voglio diventare ingegnere",
        "link": "https://clauqsi.com/it/testimonianze",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRq0bWaYnFKSUlL5Bqc42G56ZVCx7Wxy_brTzlvm8n1DqzAznp8xdso2ZwOv9R8lwFL3Xf5cxBfFkRPmOhpcPSP4WUhlU4W4W4idiHKRyFIWA",
        "source": "Clau, quiero ser ingeniera",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTRu0KyScoMFSBoE16gLVu9g7A3WpgVOkFi4H13bzbIvW_ZzC7y",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTRu0KyScoMFSBoE16gLVu9g7A3WpgVOkFi4H13bzbIvW_ZzC7y",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "Modello youtube logo | PosterMyWall",
        "link": "https://it.postermywall.com/index.php/art/template/7f67c7b6e98d694318172f5e604754bf/youtube-logo-design-template",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRpQxOSkKstTyAFbJHW7rFZ432-A3RYGcUNLv2-07rCPWsOoVu086hoXkahUhaXtmu30niar0mQHpOfVbOLQTutltborWpYq9eh-eAnQWpzodI5tEtf8uW_",
        "source": "PosterMyWall",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ0BRHf0T2mCd0w0aZdoBUQJdUm1Ln9AeKzH_-Jla64YK6_3TBU",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ0BRHf0T2mCd0w0aZdoBUQJdUm1Ln9AeKzH_-Jla64YK6_3TBU",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "YouTube ha cambiato logo e grafica",
        "link": "https://www.ilpost.it/2017/08/29/youtube-nuovo-logo-grafica/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQp-snfKZuufR_iAZB397tN-BNRwouvNzxo8dSsZEupR4RNui_AX8ap7B4vsR34kj0V10xUWUWoXUN0aPkZ68w3plXZyyzZHsJZPopGufKBbFE7",
        "source": "Il Post",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTfUtY8fn-_Pip0clNa2qDhwz2rDmxTB3sESP0I7OO3TmQw5Co8",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTfUtY8fn-_Pip0clNa2qDhwz2rDmxTB3sESP0I7OO3TmQw5Co8",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Come guadagnare su YouTube - EuroFormation Formazione ...",
        "link": "https://www.euroformation.it/elenco-corsi/come-guadagnare-su-youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ4trsmZFzYn4QUE3VmVGhk133-S5_qpuEytq7ujFk4NGhIqk5hig3XfNYZU5Wqmatsqq94VuU1nNR1_eyw6nWrAdifa1y5jb622URJ_0XMNHbSSt3SMzHrGw",
        "source": "EuroFormation",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwSNRvPPOe3Lr4tNIW3KEAag8zcgL6tDmrwQmG4rVtEvak75lI",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwSNRvPPOe3Lr4tNIW3KEAag8zcgL6tDmrwQmG4rVtEvak75lI",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "How to Copy YouTube Video URL Link from YouTube App on Phone ...",
        "link": "https://www.youtube.com/watch?v=QCwoGxArIsY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Youtube Immagini - Sfoglia 139,903 foto, vettoriali e video ...",
        "link": "https://stock.adobe.com/it/search?k=youtube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRmO_8sjV79Lvr80yZ9v1mjcRZDN1hZFi-kX0mYgHFcDxvZ4OuuaYwV5sxiW05Fr2yEjvT8RYkmpSI3x9KzYnAoAOZc8ty6wCgzyZMh0u3JrhgGpag",
        "source": "Adobe",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Come mandare un messaggio privato su YouTube - YouTube",
        "link": "https://www.youtube.com/watch?v=KmU-csRfCW0",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Image URL
Source: https://docs.brightdata.com/api-reference/serp/google-lens/image-url

Configure the Bright Data Google Lens Image URL parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
```

## Parameters

<ParamField type="query">
  URL of image you want to search

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=50&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=48&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&vsrid=CKyfsYXfqLqsXBACGAEiJGRjZWVkMGFmLTg2ZDAtNDA5MS04YTg0LWI1OWU2Y2Q2ZWNlOTIGIgJlaCgOOM7hleir95IDUAA&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1051&bih=903&hl=en&gl=US&udm=44&vsrid=CKyfsYXfqLqsXBACGAEiJDY2YWJkOGFmLTNjOGQtNGQwNi1hMDdlLTU4YWRmNzhlMGI5NTIGIgJlaCgOOM7hleir95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=X5sybacr9AH2FFW5u55jWMKsjzMaGy26mNmVV5pQr_H0M5pBEc7j0Q&lsessionid=KHO-TDOe8LGxANpz2bra8gWY4yp0Cd_aUyg0SL1ygC5KScvNoK5hgg&q=&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIEBAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLnWDN_Y-v9FbvWxAgwSTAqqZiZJSalWCSm6RonW6TomqQYmOkmGpin6ppaJKakmVukGiRZmhqxKTGlZmjwWZx7OPXF6u-TmAMYANX5B_RLAAAA&sa=X&ved=2ahUKEwiu8dLoq_eSAxU_0AIHHdfmKpcQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "YouTube - App on Amazon Appstore",
        "link": "https://www.amazon.com/Google-LLC-YouTube/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How to Turn Off YouTube Shorts Remixing [Tutorial] - YouTube",
        "link": "https://www.youtube.com/watch?v=cRHC1EFtsk0",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube (YouTube channel) - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/YouTube_(YouTube_channel)",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "YouTube Shuts Down Original Content Group : r/television",
        "link": "https://www.reddit.com/r/television/comments/s73vjv/youtube_shuts_down_original_content_group/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "How to Upload a Video to YouTube From iPhone or Android",
        "link": "https://www.howtogeek.com/744825/how-to-upload-a-video-to-youtube-from-iphone-or-android/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "How-To Geek",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "YouTube has new features to try. Here's how to use them - CNET",
        "link": "https://www.cnet.com/tech/services-and-software/youtube-has-new-features-to-try-how-to-use-them/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "CNET",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "YouTube is getting a dynamic new look, no matter where you ...",
        "link": "https://www.androidpolice.com/youtube-new-look-new-features-web-mobile-tvs/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRh-53vY1i8heyMuwxhs4Rh2bAOMAEhKGRMSyNqK3XnCg8XxR6fsmw51vJ1BdWTmU0zdaBZKX0INk_QSxu8WtbQpVSnvw7AvcHACAbySI8alifLtpZD7BW9J6s",
        "source": "Android Police",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN6xABbWVsaoYSrrb3HJASKCExp3mmdNc7_Gf22OtW4h_5_9DQ",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjQaN7z_b3AiHrbsF4XB6ToTBej8slFG0IIzUuIqFHfjKAys53",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "An unknown YouTube channel just broke all records… kind of ...",
        "link": "https://www.instagram.com/p/DTcrRD8DUUl/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-A9yKAxNvhWfCefDoHRIKNCAL4C3rqCrAG7tRnddJa3G5J1TQ",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Get YouTube Premium - YouTube",
        "link": "https://www.youtube.com/premium",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube debuts new Recap feature. Here's how to get your ...",
        "link": "https://www.independent.co.uk/arts-entertainment/music/news/youtube-recap-2025-music-video-wrapped-how-to-get-b2877770.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSrV5qFXK4MrrpmF-qGRuGZ3XvO58kiXpkOWX91Kx8-eTpm--qUCQciIk1KfIFiK7-tBEP0myCykgJYy4NHLoay0SMKqJd_ci1MQXzy391HtuxldxaIDbUucMM",
        "source": "The Independent",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTuzg2v7alS0tL2thS_clhgpAbur9kGjuALPI12kLuwKXZiu9at",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "YouTube Recap 2025 now available. How users can see their recap",
        "link": "https://www.rgj.com/story/life/2025/12/05/youtube-wrapped-2025-now-available-for-nevadans/87628967007/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkBRB-B1bhwblr3JZ2n5B-bzIRXa5zL8IeBYmMtvs34T7OWwzAwMnFTasLSxYfqOr82Qi-hJMikzLPqOL4TMHp4APbkxL5s_Y2Vuz9hYxt2Q",
        "source": "Reno Gazette Journal",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSNWx8A2aLUw2Fxug1gCZyFLvZ4Y7aKVraBvUsGh4CACU8aGzpV",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Top 10 most-watched videos on YouTube globally as of 2024",
        "link": "https://indianexpress.com/article/trending/top-10-listing/top-10-most-watched-videos-on-youtube-globally-as-of-2024-9644368/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcREHhA82Fap_IO3U-7dlibrn8yJlsi0qT2kUdbck1KimPVEHNIsCtGxstAKlPt07s9RhkEkAIgCRXi9RFzfFCaR0Y8p_z22jf2uaKW4DCqIgJOO0GBmOA",
        "source": "The Indian Express",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT8p0DDTwJ21nLYDW12Vmj8DsHfuIxqF5R7sZDvK_cUKPazOEQT",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "YouTube secretly tested AI video enhancement without ...",
        "link": "https://arstechnica.com/google/2025/08/youtube-secretly-tested-ai-video-enhancement-without-notifying-creators/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQoMdSJ0j3GUYtZdhvAzdB08yh2z11ylT-saWok78BDvRQ-2lYkLNBMp7mID2z5fLuG1RmEM90UiyubJEejEhO0VIEZXzsojyonbUtnqqZ9Q2NvyIk",
        "source": "Ars Technica",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSl2yITQzATmYhGq-fB7XwmSF01zPiThjHEJQrZtJKQGxIEFP-l",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Anyone older than YouTube is officially old enough to drink ...",
        "link": "https://www.reddit.com/r/BarbaraWalters4Scale/comments/1r4ejjo/anyone_older_than_youtube_is_officially_old/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS8t9_wIn62SKBGmnoLU0RvrOhQ9CoGqM3t2yjRkvStTp14An5n",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "YouTube should give more prominence to public service media ...",
        "link": "https://www.bbc.co.uk/news/articles/clyl07nekzxo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQkfkHsgY8lS21mPHFUbDtwW6Et_KFgAwjd1eumnE7PsvEhqdw6Kv69JwDtX9AXmV8-fm6t54pB8PATe-Pzv5BHmyDELvrJFZqQ7nx8_vZwcD6x",
        "source": "BBC",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTCIXoliRxY3r5Vx1pd9ThbHblQxHEbzddAo4HHt2kSCUd7gsqf",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "YouTube | The Verge",
        "link": "https://www.theverge.com/youtube",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQUvjXAGG2ILQkdobGNlrkN845RoDIT9G4L-sPBcsw7sdEAQIF2bqZftAiLLpBKccaBBAjaSpfW9ouqLNlezyTrUZXWckKVGEY4FwEpL2uaLSkcp1gZ",
        "source": "The Verge",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQTN14quh9Stlf80QyS_Hu3gvWmTirVetvyHyozGMqJsSmd-QWx",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Yt randomly stopped working yesterday - YouTube",
        "link": "https://www.youtube.com/watch?v=SYWjR4Ie9H4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQc_5D9QjSgCLNacTmdhIf96JsDys4r2sKAXqaKXihgWf0K-S-C",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Sorry Search, YouTube Is More Important to Google Than Ever ...",
        "link": "https://www.wired.com/2015/10/sorry-search-youtube-is-more-important-to-google-than-ever/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcThlD2e1C2_v--cgb8ALlm86tHfzrbkhTDvq9HqJqt0GoealFINHn1O1SnJiZeCJz_iJdliO5UpQz_2yc4oIqE_wZwQYOWkpR7S4fJyBLlWCG9w",
        "source": "WIRED",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTXLdsL_7M3gvVqAYuTTqVg-ckcsaFhdg9LEPdn_s-bZ7JJ4JSt",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "YouTube Music Review | PCMag",
        "link": "https://www.pcmag.com/reviews/youtube-music",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQT2SxtS9PqiMpEW2DDJLdjuVqHzsB-BQ_R7sUFdvjuE3SMmj4UDrJTT0vpXgXFeSKQtj3idX4xCu9G5dm0yLJ9c45ktlpBDPBKR2kVTtday3EF",
        "source": "PCMag",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRuf5sF-d6UFF8UNcLGO-duPlx_Ir1i4MoSICNnH8NU08ifkakF",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "5 facts about Americans and YouTube | Pew Research Center",
        "link": "https://www.pewresearch.org/short-reads/2025/02/28/5-facts-about-americans-and-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR17CLniZiP5RD4SSFBbTXMqovUhHiNZ6yCLWZRWhSdopCIttlaz9BdH7uaz3dkB5DNfwoRw2bfkueSYNMVp9gc7dN9ER0CA0x59pXXqIG1tptNBNM52iPO",
        "source": "Pew Research Center",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT6PQoNDFTvRBZ0WDSLnorgHo35ZVej0QjPZ78OOGTTE0F0I0mt",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "10 Reasons to Start a YouTube Channel Today | TubeBuddy",
        "link": "https://www.tubebuddy.com/blog/10-reasons-start-youtube-channel/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQBpw2mbW8vadl8QZpNXIHukGlh5Coavo8CfqmCVM0SS02q94VLSJJLzwjVhOCQSIFe7Hrul3Ykzz-aqn1btCE8KE1zDbk1srhzknIFUWmi3v9eDwTBLw",
        "source": "TubeBuddy",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSBPIH0c-fIrX1ZpB-T3QK8ydY6_Kn5Y2_L9ZzfwZNcuJlmJVz7",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "How Can I Watch Videos on YouTube?",
        "link": "https://www.ncoa.org/article/how-to-find-and-watch-videos-on-youtube-a-tutorial/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQus8nqyjv6rmz1FLbKGZwnxSd9hg2_yL96BFiHAN5QTJwn-zY4BSa6vY_ZLuZfuYPBbNQe3YDy_mTjL8MRVHMK4-T4re0IpNTONmS2C4dVF44",
        "source": "The National Council on Aging (NCOA)",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR-23W6IbOhj49W3-iVbuNP5cdswORmNoZkpGYmYJSrHXpeXZbp",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Is Getting Two New Smart Features",
        "link": "https://www.howtogeek.com/youtube-is-getting-two-new-smart-features/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjsUXO2w4xeQxrjXEq137RF1UCZAmNj-EvtP0ZBa-_fNtTmPav",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Reports that YouTube is d0wn for many users 🚨",
        "link": "https://www.instagram.com/p/DU4h9Wlj3Tr/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSQDo_DFR_HJoAMOXQ1BQc5evDdbjSlU2h2IZXlnuK1xGoIg2AR",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "YouTube Has a New Way to Share Channels",
        "link": "https://www.howtogeek.com/youtube-channels-qr-codes/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQi7d7OE3tYYpQ0K0N2YmwhwaeJDpQia9z8E5mUUGmYuXveM7Jc79TKGAwew0HGVw8nR3bhm6JDzDYTfw9UOl8rmynEx6jiQgFI18MGyTgd52tKjiLMwQ",
        "source": "How-To Geek",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQZge9V5uwknS8grLnlN9-MjxTo_CzGn4MBqlS2DL32NmfuEOdk",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube Music - YouTube",
        "link": "https://www.youtube.com/channel/UCStaiwu-FAgp_RC_tBiLh9A",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTE12NwfEIz3s1Scc9ug0S0sWhuK0DDv5kBgBbvJc5phh3nDliM",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "How To Upload To YouTube [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=s-KZu1kru8Y",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Livestreams and Recordings – Saint Robert's Catholic Church",
        "link": "https://saintroberts.org/livestreams-and-recordings/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRjhous8nGXkV0aOGtVkKN5c1hOh61JSqwS0iq3rZZWxnMc_gYOJFfkdICHl9Am33bjcVi1267LSKrraHCqHZjkiNVaDkNMLWUQ3DdvxgaI5IouOlq8",
        "source": "Saint Robert's Catholic Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "YouTube is giving you better control over what videos are on ...",
        "link": "https://www.xda-developers.com/youtube-better-control-over-what-videos-are-on-your-homepage/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRAME90RmDvZ7n5QF-g_fXA6hrG1UpK1yFStismLE2bPsvQ8NDeM_419lGa-XTsXWEQ7-TMRilzLDBgbo39QRarJ_dIvrWYKxo3Lc1KDOvngg4HxOqxV7yDSBqR",
        "source": "XDA",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "YouTube Set To Overtake Facebook As Second Largest Website ...",
        "link": "https://www.tubefilter.com/2018/08/08/youtube-second-largest-us-website/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQOnfaQAkwfbzgAhZAsN5ZEqvhBteEgAtOUgDLozCYjPpNAwfem0ykIevsPO1a2BQWF_eWOq8yhCPPs39ddN7Qnn_REbXXsh4g8Ox6A4cd2s6tzF_8vt3Y",
        "source": "Tubefilter",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "Church News | Grace Community Church West Allis, Wisconsin 53227",
        "link": "https://www.ourgcc.com/LiveStream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjOVrgTcfOQd208wODKcdmYhpg0A4c8rI0iQOfObfVtqWQ3A82OkIxtd9eJo8DhTCB4XaOFUL34ZsE90N4upcd5sNfeR0y0DH1HagFogmWOS1Jdw",
        "source": "ourgcc.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/c/CalvaryChapelMyrtleBeach",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Simplest way to embed a Youtube video in your React app ...",
        "link": "https://dev.to/bravemaster619/simplest-way-to-embed-a-youtube-video-in-your-react-app-3bk2",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSh5PWTqIAO1R2wHP12Nb0aflEKKY5TP5n42uX4UK7IAizpajZQ",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "live — Edgerton First Reformed",
        "link": "https://www.edgertonfrc.org/live",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQX0DHkVwqsNq8LU6oTPXlV6-xin23cGL575S3bUgZ-ziBlBpRnlJZ3jTzBnHkxrc1w_hwFCKe0N3ZBwslfw9g6etfzO4wticYgPriK-2Mu0IXr_c98ZeHj",
        "source": "edgertonfrc.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Lincoln Community Foundation Garden Performance Series - Home",
        "link": "https://artsincorporated.org/fgps/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcS_mDfJIg_rnjz21iR8FusOKVEXvVIiA-75CTo2W2-sI2qE6ostf4cDLy__KgU7p6j5H6qkYP9c1yefmjXdqXrlcrn42fsPCfAlyCZDyPivGq2Luyw4ywFD8Q",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "services — New Horizons Fellowship Church",
        "link": "https://www.nhfchurch.com/services",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTx3EZkS6f0vTYrOCdoVKZ0ixnXJfk3j5vGiEvhGHSQu_S0tK-En_lsD39BVN-vCPey0Az03DUsK682x59bi7rV2Ak9QaYX15hZYCqn6_QGaKllETzKFw",
        "source": "nhfchurch.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Google Lens localization
Source: https://docs.brightdata.com/api-reference/serp/google-lens/localization

Configure the Bright Data Google Lens Google Lens localization parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  Two-letter language code used to define the page languages

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "de-US",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "KI‑Modus",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=912&bih=1055&hl=de&gl=US&udm=50&vsrid=CLyBnbbE-rvuaRACGAEiJGFhMWIwOWE2LTI1ZDctNDk0Zi05NDM0LTZiZTliNDc3NjAxODIGIgJzZChYOOmkpJat95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=asRPaSchYw9tQDTXqsGk5tww15VHt6nmfxqTlI0tV3giA4ZvNBcMSg&lsessionid=oLjt_CfkSy9-l6EqHLU0PHJfSb-wMWPOKj12yxI_Q5OqAs21rlPJQw&fbs=ADc_l-bQrFPR8qvD0srDSK1yPoIVJPB2H6jQhOFYRGjy7Uwrp_IJFEdt-fFKhyqjW5-jKsNNUav_lvb78dH42zTP5T_ZC54CsSV8FOJkJCb7fXQPvfzdf4bhuW6UZhaCk5wfbDpkA4p8v7RxnwLLKLzB8iFQuiocRg&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQ2J8OegQIDxAD"
      },
      {
        "name": "Alle",
        "type": "all",
        "selected": true
      },
      {
        "name": "Genaue Übereinstimmungen",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=912&bih=1055&hl=de&gl=US&udm=48&vsrid=CLyBnbbE-rvuaRACGAEiJGFhMWIwOWE2LTI1ZDctNDk0Zi05NDM0LTZiZTliNDc3NjAxODIGIgJzZChYOOmkpJat95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=asRPaSchYw9tQDTXqsGk5tww15VHt6nmfxqTlI0tV3giA4ZvNBcMSg&lsessionid=oLjt_CfkSy9-l6EqHLU0PHJfSb-wMWPOKj12yxI_Q5OqAs21rlPJQw&vsrid=CLyBnbbE-rvuaRACGAEiJDc5NGUxYzBmLTA2MjktNDA1Yi1hZjNlLWU0MWRiNTFiNDViMzIGIgJzZChYOOmkpJat95IDUAA&q=&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQs6gLegQIExAB"
      },
      {
        "name": "Visuelle Übereinstimmungen",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=912&bih=1055&hl=de&gl=US&udm=44&vsrid=CLyBnbbE-rvuaRACGAEiJGFhMWIwOWE2LTI1ZDctNDk0Zi05NDM0LTZiZTliNDc3NjAxODIGIgJzZChYOOmkpJat95ID&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=asRPaSchYw9tQDTXqsGk5tww15VHt6nmfxqTlI0tV3giA4ZvNBcMSg&lsessionid=oLjt_CfkSy9-l6EqHLU0PHJfSb-wMWPOKj12yxI_Q5OqAs21rlPJQw&q=&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQs6gLegQIEBAB"
      },
      {
        "name": "Infos zu diesem Bild",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLn2NM4d9uRX7vfZQowSTAqqSQmGiYZWCaa6RqZppjrmliapOlamhib6JolpVommZibmxkYWhixKTEVp2hEWLxcsmTa2u-TmAMYAHJruTJLAAAA&sa=X&ved=2ahUKEwjYx46XrfeSAxVYTWwGHa5WMUIQs6gLegQIEhAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "YouTube:www.amazon.com:Appstore for Android",
        "link": "https://www.amazon.de/-/en/dp/B07T771SPH",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Amazon.de",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "Die Taskleiste wird während der Wiedergabe von YouTube ...",
        "link": "https://www.youtube.com/watch?v=Tt4Jb80DFQw",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "LinkedIn",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Bark Avenue",
        "link": "https://barkavenue6.com/",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "barkavenue6.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAT4AAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "YouTube-Hintergrund. YouTube-Symbol. Social-Media-Symbole ...",
        "link": "https://de.freepik.com/vektoren-premium/youtube-hintergrund-youtube-symbol-social-media-symbole-realistisches-logo-vektor-saporischschja-ukraine-10-mai-2021_16494843.htm",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Freepik",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "Run - Ludovico Einaudi (1 hour) - YouTube",
        "link": "https://www.youtube.com/watch?v=mYB8kd3F26g",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Does your YouTube logo also have a peace loop? Is that ...",
        "link": "https://www.reddit.com/r/Switzerland/comments/1q21t42/does_your_youtube_logo_also_have_a_peace_loop_is/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASgAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASgAAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Tulsa Marketing Online",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Springdale Free Will Baptist Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "Emergence with Elaira",
        "link": "https://www.elairaflow.com/podcast/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Elaira Flow",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7RCT4r1ULdXFpOWV7360X_4uHe_tgQD8LjRH_CH1PdrUaVhIVyar26V_7gxFFa3iH8Oy21z9GPKAYnBLMmPWgbGAmEwYkn8RSAqv6Zzv0OcuUFQ",
        "source": "Whonix",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRXYvXSyyCilfbT9uHBSCn_f8N0EHl1BJIvVnTlaimF1YfRaHUK",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "YouTube pours money into how-to videos",
        "link": "https://www.bbc.com/news/technology-45940777",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqQdPtFBN3bPsr-Qgzb7Y0PF6GpVT51CS6HYSB6PXjFM1KQM0riEjmg6eZuNil3vXzxVUlL9E0q5Xq_wIPsMz28MXi8-AtXYEI7eLNJMpzlQ",
        "source": "BBC",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGZQ6e8cZafg_Gf3BelBILe655wBxWBgMcfq4SS-_T-HNPLV0H",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGZQ6e8cZafg_Gf3BelBILe655wBxWBgMcfq4SS-_T-HNPLV0H",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "YouTube says that music is now 25% of its global watch time",
        "link": "https://musically.com/2021/09/16/youtube-says-that-music-is-now-25-of-its-global-watch-time/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Haases Papiertheater auf YouTube – Haases Papiertheater",
        "link": "https://www.haases-papiertheater.de/foerderung-vom-land-nrw-fuer-haases-papiertheater/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRSbs77zp164Kuy7sGM2Gom24YH_NFR_5v6RjiePFuZ22m27Ln1xCjlR5g_2fpkRwwuxmQhpNpHWuSYaaWUNOjD3JhChL8zn6Y06KyQW409ZWQIYKbmbO1lyEc1Dsx6Kf0",
        "source": "Haases Papiertheater",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQbTcRQfP9eXQEOyuwSbayvlRvs-i4tAGSVk9keXMQgZ7ZXUT7_",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQbTcRQfP9eXQEOyuwSbayvlRvs-i4tAGSVk9keXMQgZ7ZXUT7_",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "Titanium Exhaust Shop USA & Supercar Exhaust Fabrication ...",
        "link": "https://www.juggernautmotorsports.com/contact-us",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR8hgMBnSvz0patcT-KaUUmbTuH8f3sF83fa2jAOmFcrLOiOE6fT5HmQjPzlbF6Np1BGYRy6orYGanCsOolZ3U9jKBDL2SugPBWgDoKPDoycWlcMK9NgAeZKoHLFqsV3fY9_Q",
        "source": "Juggernaut Motorsports",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "How to Turn On YouTube Shorts Remixing [Tutorial] - YouTube",
        "link": "https://www.youtube.com/watch?v=vjD2N1AWZd4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Veranstaltungen zum Nachschauen und -hören - Deutsch ...",
        "link": "https://dai-heidelberg.de/de/news/veranstaltungen-zum-nachhschauen-und-hoeren-63191/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRubgKOCSHYYQVWP5ywYqLMUuc9FMnPidY092PuUbWdw8Wqn6nd_adSREb9JX8HEHn1PSRgBVIlDCA_RF-rCb-6gveaFLTejz3pR3RcGDIg95HUnlN3Yw",
        "source": "dai-heidelberg.de",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQMngHlpuDdQU9Q1GE5VdctE3yinroAJPfKefg6uv__gAcfCAGR",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQMngHlpuDdQU9Q1GE5VdctE3yinroAJPfKefg6uv__gAcfCAGR",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "Contact - Floorotex : Floorotex",
        "link": "https://www.floorotex.com/contact/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT7-TOxoo2JACiBhQ1IAhyD0w5Dad-Ait8UJ-eSRUDY6ekkFnjPALCvxXAU96xjtKYDQURiYt4Q7_uuABwt9-Vhv4QfKHqJMXzZlVDFAJBqCpP9sz_ZUg",
        "source": "Floorotex",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "Video Gallery — Hay Street United Methodist Church",
        "link": "https://www.haystreetchurch.org/video-gallery",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ3pXOvQSC3hZs5EWZ0GtX4OOH7IrL_oUiE-ZB9RBOWZH5-j0fd3YogXOtepk9iG8rzsY0NZvIyPgFkTQjVLiCO78bTCZgDveUS_aRdGyO2ue8T9dL1qUwUk2wXaA",
        "source": "Hay Street United Methodist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "Filme - Network for Fashion Textile.Interior.Accessory.Design",
        "link": "https://vdmd.de/de/filme/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcR7ldkB8Lul97UqWiMBOWruO1c735YYEZGCec9D08sT6cEdtf5qpjSGe9Ue47ecwWq-g7SugxfGsAbnUdAyuQLdHSN_iMsXL_qyNDox",
        "source": "vdmd.de",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTxh6IZAo2T2oTqzj9xiSmxIWxZxbixj2j-ICuVvOqYlVaoKenC",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTxh6IZAo2T2oTqzj9xiSmxIWxZxbixj2j-ICuVvOqYlVaoKenC",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "Creative Works – Thaddeus Patrick",
        "link": "https://thaddeusthought.com/creative-works/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR9H-Uc02qgJl7WDZEQsH1N02jvcPWlLdbOlHlS7Z30I-bEHZ5h0xv93j6OLjoC_ItqzSJ0f6PGdr0SLYhHLgpH2VpVDiQW8wq1UoQMMISLxmgHL5BtXtwA",
        "source": "thaddeusthought.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Youtube Channels | TV Apps | Roku Channel Store | Roku",
        "link": "https://channelstore.roku.com/en-gb/details/501a4e61aa4f7737df0305124a39119b:9f0f785535ad319cd05f98e8af0171c6/youtube",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSO_kezB5kMQoD9_s3N-QRanlvx8SnyVdj4oVz-z-YMqBY42JynrtZZjT8A7Y6s6CZXzmwsRDriFFretsc90DQaj3mxyyki3ZZE7zOfPSi0OUSyI2c-lr3XTmo",
        "source": "Roku",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTTCA7weGXnEdtDhaHBwHUAF-KOHPUZEkmhgX08pFr0Z9zoEwCt",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTTCA7weGXnEdtDhaHBwHUAF-KOHPUZEkmhgX08pFr0Z9zoEwCt",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Bayerische Kartoffel auf YouTube | Die Bayerische Kartoffel",
        "link": "https://www.bayerische-kartoffel.de/aktuelles/bayerische-kartoffel-auf-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR9K9HiIajG2nwWdB6xTp23C8Pxt8gwW1-NTh-gICYKEhSd2a9FzhttVd_0ZX3p1tHjDYSCFv4BMUOegG6-Vo2Q6eEotRwmzGHFz5sP-UZO3b7tInKflGxX6OSSdZP6JuE",
        "source": "Die Bayerische Kartoffel",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSAW8PSzvHDR8w-DtwSa_BacOu2CidT_Gj5U8KYoJNZ7Yi8uLrp",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSAW8PSzvHDR8w-DtwSa_BacOu2CidT_Gj5U8KYoJNZ7Yi8uLrp",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Oakland Woods Baptist Church Clarkston, MI 48346 | SERMONS",
        "link": "http://oaklandwoodschurch.com/sermons",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTXfJE8ouK2vMdX69h7N9hTKqb3Iwwv_tiR6Qy7yMpvk-fdv8p7Kerkm5O2CiIXIN2ofBE1QylpSaJmJ6jyv2IrSVNAIloIRCQA5al_ZZ5Ys0JcdmsC9wSF5uE",
        "source": "Oakland Woods Baptist Church",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "Home - Lee Elci",
        "link": "https://leeelci.com/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSHzFCDKQSmNCwYFbcv_DuBQL5I_58V2XjhA7XXKwCjXFJAlHo9X8hb9DNhViTlrFhg5-BD3W4Ol5DeDs9KsmrtYa98y-SEmu6Ic3fTLWSxiA",
        "source": "leeelci.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "Audio",
        "link": "https://brendaportman.com/audio",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRPjf6QxgmeUGa05T8HdECxJNNlljUS99TcB9GpPhQPUt0tiH_f9DcBpWKe8SrSR0ytd9QHKXFz-FZ0baurTnTM-LXGqzJgNnshlSal0c0GLOELKYENCw",
        "source": "Brenda Portman",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "YouTube 동영상 업로드 오류 안내",
        "link": "https://blog.google/intl/ko-kr/company-news/inside-google/youtube-notice/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcStL-sTzHn2J4VaK5tWXvxPveo_FDanN9An682O-vsvvva1mpz3OvUYdtmBNqFXZBSCAaE8oq_nkmdnRPg3lOUregpQRTKpqiQAjs18pfPSUQ",
        "source": "blog.google",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4rcFXGBKsxw_bVlL03UUllcJr3-edp5hnWRpxBvXRRlFGeYSe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4rcFXGBKsxw_bVlL03UUllcJr3-edp5hnWRpxBvXRRlFGeYSe",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "Contact Us - Hallenbeck Coin Gallery",
        "link": "https://www.hallenbeckcoingallery.com/contact-us/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWWAUyOLwNPgurEHGWs6O5nK3gzRktiQIDHonqXHjbbVgeB2dIORFssSne4yuGA2IOpY29Jt8EUT9Ldmj38MMYq_i2V6bFOZq9ylncdWC3pFeXFzSQ9ufhXM6Z7SAB9tMkNA",
        "source": "Hallenbeck Coin Gallery",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRn5nRuouCl-6RhwoOhbfXaWlngehryBlZjRT9RixkO6XNK9XUC",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRn5nRuouCl-6RhwoOhbfXaWlngehryBlZjRT9RixkO6XNK9XUC",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "The Texas Rottweiler Ranch - Home",
        "link": "http://www.txrottweilerranch.com/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTBDNxpP9eOxf0Ypwz4oWBJfb5KK1L30dFjVxexlJHK5slCqqP_NZxA8_qv9FiUUNO-T-GrDxaCg7d-BZ2UDhzPu1lKn87KOKacsjVJkWM-gB-poSpVmcAdWzOJVHI",
        "source": "The Texas Rottweiler Ranch",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN-ze1vuOfO-5jpYKAsuiZ2hKxMEFZV81x8QzmhzeORZ_n7Poc",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSN-ze1vuOfO-5jpYKAsuiZ2hKxMEFZV81x8QzmhzeORZ_n7Poc",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube Logo and the history of the company | LogoMyWay",
        "link": "https://blog.logomyway.com/youtube-logo/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRDhnhnZAw_dtHXVlyEHDgNsfsuCdE9Olv5SxsSbMitiTsa_ufALNgLS0r4eDvmSP6uhnM9oqlRWXEJ_l9x6g2BULG9lnkCwz9AgRvI15F7QmsEY641VQc",
        "source": "LogoMyWay",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "File:YouTube Logo 2017.svg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_Logo_2017.svg",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTL-8CUJTd73GCUIV8UGB5fmmuMsr_d6qBRcWfDwJ6HzKPVJnDE",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTL-8CUJTd73GCUIV8UGB5fmmuMsr_d6qBRcWfDwJ6HzKPVJnDE",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "Should I translate the name of a university from the ...",
        "link": "https://www.reddit.com/r/German/comments/1dr9pqo/should_i_translate_the_name_of_a_university_from/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRFeJS-IhfJCysoVmCqJ1d-1lzbIHTsbcy4DrBsZJpxQ31zznhym7THnNEKCEnngpvdl4aupEFtEblIPBEMJY7_biy055d40m6TYfVg7CpFOrWOXw",
        "source": "Reddit",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSbWnwY1aI2EIjSbMzjyYGUQ-DMTGcDz01a9-Ww5zEO2_To-b-2",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSbWnwY1aI2EIjSbMzjyYGUQ-DMTGcDz01a9-Ww5zEO2_To-b-2",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "YouTube Logo - Panzoid",
        "link": "https://panzoid.com/creations/596198",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQL5lXx3JDQdDJ-mJXnJF9PpovKVrQSLxtSgej1YQdbS02oZEGYShIBCfEOK2u04sSpgl0F5IS_zxaK5suWnw_CJ1UonivnEBZcfC0A7dLqIg",
        "source": "Panzoid",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQn2qYndjltUvCrL4dyPggse2p8imimFnHvoqMt-EHWRCtFp1e6",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQn2qYndjltUvCrL4dyPggse2p8imimFnHvoqMt-EHWRCtFp1e6",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "So deaktivieren Sie „Video angehalten“. Weiter ansehen' auf ...",
        "link": "https://www.youtube.com/watch?v=XO0bS573BX0",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRljGzaUycjQb5RmqkBcRwZeuHns3XuLgI69iBQQSFnPijyMXBd",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "YouTube Logo (2018-2021 #2) - YouTube",
        "link": "https://www.youtube.com/watch?v=xtL7yvRndCc",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Sermon Archives | orangecoastchurch",
        "link": "https://www.orangecoastchurch.org/copy-of-oc-youth",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSRl-YuyI6JKnSDVeAkRbGF6Q79arjy9006NvRHlZfCK4z9_FZuDFiY9BBmIBW-TKzUcQ1c0af9KTY2lgC6b4rCPwkW0qfwCRVH5_T8MfkBoUuNVDy7NTyXoxE25ewf",
        "source": "orangecoastchurch",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRAgK4l11CcpbAbn6cSP8XXDWcBCM96MeyMMqizC1zJmLgpybGW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRAgK4l11CcpbAbn6cSP8XXDWcBCM96MeyMMqizC1zJmLgpybGW",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "YouTube | Nintendo Switch Download-Software | Spiele ...",
        "link": "https://www.nintendo.com/de-de/Spiele/Nintendo-Switch-Download-Software/YouTube-1467860.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcToBGjo96GmUCHevYIGmN-UpS53MeR2ZhzA3_OkIOo1c13GKN_eBvJl9QW6mzxeD5hTpJ-y6aDxlz1ebw2zFTwvBQpumpCdgwqbY9MRx5lDJF5Ae_Qe",
        "source": "Nintendo",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGpA4xQIe7fXc11z8A81pK0q3YGsufPEU8nLwQ1i7WmtEYr9ow",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGpA4xQIe7fXc11z8A81pK0q3YGsufPEU8nLwQ1i7WmtEYr9ow",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "在YouTube上获得100个订阅者需要多长时间？",
        "link": "https://www.huaqiutong.com/web-seo/2397.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRBAf2G9E6Rvndjr1-s8Iz67cMph7tzbdTGHuTg2omlwfp1EfSIX8ghExnZqbZtdgy7FpAT4gZl2u_CUk2ARnfEicVgNeVMzRlmEMf9xS5610ADm1bKqOk",
        "source": "huaqiutong.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSOb3S0sW3yfSaXpjCGw6awPB9P1P_AyjyvGujOvfG6qRYhDq82",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSOb3S0sW3yfSaXpjCGw6awPB9P1P_AyjyvGujOvfG6qRYhDq82",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Einen Podcast per RSS in Youtube integrieren – Jörn Schaars ...",
        "link": "https://joernschaar.de/einen-podcast-per-rss-in-youtube-integrieren/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRet8iXqe6yDnYpGMpMcp-bME0tzlQgTk297zWKqWeHzDkFmVnKziV2mnQNIgbTm4aV2OS9-D2z3gLvSTPgm8DGFVYsfK2gQ7pkhjI7ZXp4npFT7A",
        "source": "joernschaar.de",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHoAd9FaBVTUNQo2fHJvtxknczljt7kq9E6hKRewIcBHzwxwsn",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQHoAd9FaBVTUNQo2fHJvtxknczljt7kq9E6hKRewIcBHzwxwsn",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "Unsere Gottesdienste auf YouTube - Stadtmission Solingen",
        "link": "https://www.stadtmission-solingen.de/sermon/unsere-gottesdienste-auf-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQRd_bJaeVbzjj0lHqkBKiC6WyXT9A4fZURJAzZxIea8Oxj28PLx2LHy3rLnADulQnW-_cqeDBCmTV3IxlV5EylS20hWQZ8DnlWwzc3mtYBffsHHAXNldXvE5SzRfhBAUhk",
        "source": "Stadtmission Solingen",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSB8z8JeUTqzBQrTnFfVILg5fRl9Yj9JokYcjDnxMF0lwpL-TIi",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSB8z8JeUTqzBQrTnFfVILg5fRl9Yj9JokYcjDnxMF0lwpL-TIi",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "YouTube app gets a huge redesign - PhoneArena",
        "link": "https://www.phonearena.com/news/YouTube-app-gets-a-huge-redesign_id97544",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTzmmUWlKNu2N6Vu_BuvybF4XRJzXoEG5iXXHkZMamhlXGoSgsSvpeu9hQP8FywapcndqFH07W0BWQ3DUcUTSh89ouuATT334y1FEgi-BAx9N93KNMDMNw",
        "source": "PhoneArena",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Youtube-канал — Беляевы и партнеры",
        "link": "https://bvlegal.by/blog/youtube-channel/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTkBUDhrCRXCnQXWwr_iQt3hLQ-Vy3zaBZeoQeNhfaUBQVBoK67CYhwzVIa_ZoOax1jZhOWxUKvO7z4sb4cyETtVElOpqxp3uwO0B0Ctnh1",
        "source": "Беляевы и партнеры",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGvHt9kJ7YyNC4TaYSEphTg-YRdfzsYHBtBzNv2sGLry77qYEW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGvHt9kJ7YyNC4TaYSEphTg-YRdfzsYHBtBzNv2sGLry77qYEW",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "yt-log-groß - meta HR",
        "link": "https://www.metahr.de/meta-hr-startet-youtube-kanal/youtube-logo-gross/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcS0sP2SEAn181zYtVCdK90wy22QwvKAtYibQInkDPPU06cOp878Llkhq2yoJ39uMg1e7cKH6ajMBtU_WqoelbZefvfaOy1a4lNQfqeuA7cc_X9V",
        "source": "metahr.de",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTPcmAj_Iyu7oeyUAs0i72rjbHTIqZRXvIAVCd2qhICSr95odw4",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "YouTube: Neues Logo und Videos im Hochkant-Format - onlinepc.ch",
        "link": "https://www.onlinepc.ch/internet/youtube/youtube-neues-logo-videos-im-hochkant-format-1286877.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSKmZAmq7gBwvxYvipHi3z-YJT92XyRBjzeVv9jjaZ-_TrOlNRoKbBYuhQwztM-lUXpYzF4WHUbpj251FtoBzBI8kAV7sH-uG4o-dU_lnp617TuTJQ",
        "source": "onlinepc.ch",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQThZmFA2Ekg_YSopFPubNH39O8K3o0GTuYeVrgUmy0tlsf6wlA",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQThZmFA2Ekg_YSopFPubNH39O8K3o0GTuYeVrgUmy0tlsf6wlA",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Lincoln Municipal Band - Home",
        "link": "https://www.artsincorporated.org/lmb/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQuvdPTZZ78-9IyZ_1DsRl9-qzEAGLKh2kDWKxvcYVspd4pk2Ua9HA--cFdERby410oLEF3KxmAdP-0p_dpjWLh4V0MqU3eKqpU_PSiKWmjX2RJszYD1WTCQyTttSg",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "EULE – TV – Kinder-Lehm-Haus",
        "link": "https://kinder-lehm-haus.de/eule-tv-videothek-ueberblick",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRXvNd56A5WwXSA37VnQwpY0W2ZICTtUuq5az8nusIwDky5KCYDBe4JKgb2SbIGN5AKnbrAQueAueEr_7YWoxwtxUeylf6rIrwoAEeWz-CAN973zrRpZ0AI",
        "source": "Kinder-Lehm-Haus",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQQgA8PGntx1hbjo-bMUWZfso0ZW5j8RDIaAIAjb4JacLbgXtFz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQQgA8PGntx1hbjo-bMUWZfso0ZW5j8RDIaAIAjb4JacLbgXtFz",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "Classic Week 2024 – 15. bis 23. Juni 2024",
        "link": "https://www.classic-week.de/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSZ4bHkh5NV1s9nUVoVSABAPmnkLKauZCqWcAeSeyDq5BZcoIqyx61DD76wnbtHWy2Jc0Cf3NosR8QSLM4vloj9I-MU6ckLPgcyxj1XhfqO455HIT5f3IeA",
        "source": "Classic Week 2024",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ9yUmAdMXWs2aOIjikcIBUXJZVV4treOr8WzpMyqQ_oACFOUyB",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ9yUmAdMXWs2aOIjikcIBUXJZVV4treOr8WzpMyqQ_oACFOUyB",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Google Lens parsed JSON
Source: https://docs.brightdata.com/api-reference/serp/google-lens/parsed-json

Configure the Bright Data Google Lens Google Lens parsed JSON parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  Set the `brd_json` parameter to `json` to get the results in JSON format.

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1
  ```

  | value | description |
  | - | - |
  | `html` (default) | Returns the standard HTML response from Google Maps. |
  | `json` | Returns the search results in a structured JSON format, making it easier to parse and extract specific data points. |
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1073&bih=1042&hl=en&gl=US&udm=50&vsrid=CK2WzY-pjI-16QEQAhgBIiRlMDYzMjhlZC01MTc1LTQxYzQtODhiNS0yN2NlODEyYTEwZWIyBiICbHUoADj_gK6NrveSAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=MT3grhEKqHgQVHgJnUBREyQXyRnNWZAssdsZ77bDS9Xpej1yiuSa3A&lsessionid=5msAOvETWC1NffbKCz-rMtHP2AxXEoZ6vqQrhpFpYavgEfO62MmIyQ&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1073&bih=1042&hl=en&gl=US&udm=48&vsrid=CK2WzY-pjI-16QEQAhgBIiRlMDYzMjhlZC01MTc1LTQxYzQtODhiNS0yN2NlODEyYTEwZWIyBiICbHUoADj_gK6NrveSAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=MT3grhEKqHgQVHgJnUBREyQXyRnNWZAssdsZ77bDS9Xpej1yiuSa3A&lsessionid=5msAOvETWC1NffbKCz-rMtHP2AxXEoZ6vqQrhpFpYavgEfO62MmIyQ&vsrid=CK2WzY-pjI-16QEQAhgBIiRjMDdlZmExZi0wZWY5LTQ3ZWItOWZiYS00OGE4ZTYyNTQxMGIyBiICbHUoADj_gK6NrveSA1AA&q=&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=5f09d3ac69940124&lns_surface=26&biw=1073&bih=1042&hl=en&gl=US&udm=44&vsrid=CK2WzY-pjI-16QEQAhgBIiRlMDYzMjhlZC01MTc1LTQxYzQtODhiNS0yN2NlODEyYTEwZWIyBiICbHUoADj_gK6NrveSAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=MT3grhEKqHgQVHgJnUBREyQXyRnNWZAssdsZ77bDS9Xpej1yiuSa3A&lsessionid=5msAOvETWC1NffbKCz-rMtHP2AxXEoZ6vqQrhpFpYavgEfO62MmIyQ&q=&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQs6gLegQIExAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy4vLgWDvtbP_Knv6tLxkFmCQYlVRSDcyMjSxSU3RNDc1NdU0Mk010LSySTHWNzJNTLQyNEg0NUpOM2JSYcko1GCz-N6zrXfd9EnMAAwBNfA7iTAAAAA&sa=X&ved=2ahUKEwih2OGNrveSAxXQHxAIHR4aAUMQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "varvid.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAZ8AAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Stopmotion x cel animation mixed media reel✨ I have lots of ...",
        "link": "https://www.instagram.com/reel/DLm6SS8yeLx/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Instagram",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "How To Turn Off “Paid Promotion” Disclaimer on YouTube ...",
        "link": "https://www.youtube.com/watch?v=yTfcl3jHKvA",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube Shuts Down Original Content Group : r/television",
        "link": "https://www.reddit.com/r/television/comments/s73vjv/youtube_shuts_down_original_content_group/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASsAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Worship – New Horizons Christian Church",
        "link": "https://newhorizonschristianchurch.com/worship/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "New Horizons Christian Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcAAAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "LinkedIn",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAcIAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "really hard question here: whats even the purpose of this ad ...",
        "link": "https://www.reddit.com/r/youtube/comments/1pxov43/really_hard_question_here_whats_even_the_purpose/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVQAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Springdale Free Will Baptist Church",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAa8AAA...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "Yt randomly stopped working yesterday - YouTube",
        "link": "https://www.youtube.com/watch?v=SYWjR4Ie9H4",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Emergence with Elaira",
        "link": "https://www.elairaflow.com/podcast/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Elaira Flow",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbUAAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "Watching YouTube Videos in Whonix",
        "link": "https://www.whonix.org/wiki/YouTube",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Whonix",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbIAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAbIAAA...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "AI Overviews Are Coming To YouTube In New Test",
        "link": "https://www.tulsamarketingonline.com/ai-overviews-are-coming-to-youtube-in-new-test/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQdlX-huMkuAXP9QrJWUVbCax_aXdhGZO9qhv8aeHvTCCjnHzWOfuNp56fCD5n-lQFo2UOXmqvBrWv1EP-Y3kRZL70kqvASoG3GGaVXHP1FDF_9UrN2663TziCS-bzqD4Hw",
        "source": "Tulsa Marketing Online",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSrAt7rOPRTZ3ARkL-YGWskDIZZrBNHNFU8hu07vmAdCxPSDyOH",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "YouTube",
        "link": "https://www.youtube.com/c/youtubeANZ",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRNJVypm9wQcKz7Io8sTjglOqe-TND59T-1cEZ1NsgWtrAgJb4P",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "Council Meeting Videos | City of Oconomowoc, WI - Official ...",
        "link": "https://www.oconomowoc-wi.gov/769/Council-Meeting-Videos-on-YouTube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQTyr2X3_sexqjYHbmBx8BOfYR2NdvXo7-7f_aOtDoQqtUeIhYdRlCTaktRxMJqisDnx5bKSz--9AFYPlCBMyEtRQwVFaVo85gmzwH-C_YqrqE2qay2p3PyKYw",
        "source": "City of Oconomowoc, WI (.gov)",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRdPwT4HJnPOPNlvcKaANyl-0YrnwPHxnAmbKyRdYM5SIE35CD3",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "Popaganda Podcast",
        "link": "https://www.popagandapod.com/season1",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxbqFeVrr2di3ffaWz_O8ivKYW7tRtmi51RAq8MylGvGAQHmV9lqUDOdmE8rMpy9s63aeBGIzHjho53xhXkEkOIxVNl6MrlEqQ859957BgADrGHPH31PUP5g",
        "source": "Popaganda Podcast",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQti39Qu5s92QMRuS63qsnoyO5JlBmIu84Q0GtL1b0Sc1XG0O0s",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "How To Upload To YouTube [Guide] - YouTube",
        "link": "https://www.youtube.com/watch?v=s-KZu1kru8Y",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTmetLJpEeBZIkBH8iY9Hl9Zmg6FyRiNKggrlH2TYUydoK_WFTm",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "Where is Your YouTube History? - YouTube",
        "link": "https://www.youtube.com/watch?v=hcnkv0y-0WM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR3b0891aPxG36yA2V8x8ScZNv17SVWNfwTDtXyZFdmJMa4mdIu",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "How to Live Stream on YouTube Using Your iPhone 15, iPhone ...",
        "link": "https://www.youtube.com/watch?v=rXU3sRnDi5M",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT2J6imTTg_XtsK2Yul9RScPHVLmB1y2NppWjMLXRW2mzJYEfsC",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "Rob Pratley",
        "link": "https://luc.devroye.org/fonts-87321.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWUq4levL2IJLit-bQYDm4o9U35ZP1zDILK4M6PZ6IXNLyCCfM8mN-Dbup_Cpy009Pdqs1OO4W0vRc2OyGIu5EkE4SHxrmzXIh0JQo5KSeh2hI2HA",
        "source": "devroye.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRVwnQjv1TrJlbyTjSQfLesOC8dVjEjXQlEF08KnM-2HdN1g0po",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "Video — Paul Lincoln",
        "link": "http://www.paullincoln.com/media-2",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR-7rvA3OHfu4y9znRDkYgG7MqdqU9M_63edTViGISPZfmcm4O5VHSj1fgqQaZhVc97bITyZ4ipdRQsSwDz9CXyGSmbU5bwbTAtn4uoZeT55MUe9P61fVQ",
        "source": "paullincoln.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT09i7ZbByzqgW95PWzZyFcVp4mWoEZcKolsA6nd0lmJES3epCe",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "YouTube Set To Overtake Facebook As Second Largest Website ...",
        "link": "https://www.tubefilter.com/2018/08/08/youtube-second-largest-us-website/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQOnfaQAkwfbzgAhZAsN5ZEqvhBteEgAtOUgDLozCYjPpNAwfem0ykIevsPO1a2BQWF_eWOq8yhCPPs39ddN7Qnn_REbXXsh4g8Ox6A4cd2s6tzF_8vt3Y",
        "source": "Tubefilter",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQdG1HLsjtJ1yGqDtoqiT8_0BJBOdjgBslZdnESZl90s5Ogt1M9",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "Livestreams and Recordings – Saint Robert's Catholic Church",
        "link": "https://saintroberts.org/livestreams-and-recordings/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRjhous8nGXkV0aOGtVkKN5c1hOh61JSqwS0iq3rZZWxnMc_gYOJFfkdICHl9Am33bjcVi1267LSKrraHCqHZjkiNVaDkNMLWUQ3DdvxgaI5IouOlq8",
        "source": "Saint Robert's Catholic Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhDUhnp1HB4uSLfEsS8T6WgFzOGY6vStFEMzNyh1NVhas8Pvd3",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Calvary Chapel Myrtle Beach - YouTube",
        "link": "https://www.youtube.com/c/CalvaryChapelMyrtleBeach",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNzpg3c-1dwwy9JkJ-8U9yJF8wTocFJoEsF19F1v5VWwUAUT_j",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "Church News | Grace Community Church West Allis, Wisconsin 53227",
        "link": "https://www.ourgcc.com/LiveStream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjOVrgTcfOQd208wODKcdmYhpg0A4c8rI0iQOfObfVtqWQ3A82OkIxtd9eJo8DhTCB4XaOFUL34ZsE90N4upcd5sNfeR0y0DH1HagFogmWOS1Jdw",
        "source": "ourgcc.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC3exulTpXNFqIrOs03eepYpCz8B5lco2RIq-ASaFmrLW9GiZe",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "Listen – Kicks Band of Fargo-Moorhead",
        "link": "https://fmkicksband.com/listen/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSXIP238x7Ns9vg5fxViRnkAHehX-cXBHAumAnxFErtlfXQpKU6hVJib-drG2IjKuQ3zFj0pmu3F_N8pdVpuCn5VuYHj67pIOKWTIo3uZnmRNt9Eag",
        "source": "Kicks Band of Fargo-Moorhead",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRoVsB0EGH2wECLCNA1IotQT_M1ApQTGq-53qFeSPfLlaP7dceG",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "Industry figures hail YouTube Music's 50m-subscribers ...",
        "link": "https://musically.com/2021/09/03/industry-hail-youtube-subscribers/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSFAxZpnQqFaA4qoNqYk_NlH7wPwpNpjN3Fyh-p6wfFTc-IhE0-Ufkg2aomh1NFcGdcunSi9BYOB0RK6mkP7VVvlBlxdcQcbJILVSRsFGTY83Gj",
        "source": "Music Ally",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjPmybg3_wHprlJf2gIX5GjEPxEsB51OyF42VDXiKkYjYF2oTr",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "YouTube Links for Anne Z | Anne Z on the Web",
        "link": "https://annezontheweb.com/you-tube-links-anne-z-on-the-web/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSDIIO4W4Ama4T6lvAPC7HUk1SV3hRP_oJkukjBzEtKDA7PUJXbLEZ-Tjp-4nBHRgMn1FPzDOR62BrAex4X0BvfOfJjndvL3FjGsa2F37448wajStuF3g",
        "source": "annezontheweb.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR7QzVG2h-AGEuDvhAWzIs1oJltO_TwztlJYqfZE--A3SpDptSx",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Practices + Playlists — Shawn J. Moore, The Mindful Rebel®",
        "link": "https://www.shawnjmoore.com/listen",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRtkwHR73zt_pPwLkrunvKwi5t5l12sPzyLDJiB0L5o99WE7uXv8OPet3Po9wW4dyeA0FeuNfoVOed_WWwZL9ihFpVlRie_NG1JuggWI4Xnv8U0blP_7wOD",
        "source": "shawnjmoore.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTzD6aBv7OJzyeYz2m1jZBbaEYlKxk1ScXMopYqPJcp5i55Fu15",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "live — Edgerton First Reformed",
        "link": "https://www.edgertonfrc.org/live",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQX0DHkVwqsNq8LU6oTPXlV6-xin23cGL575S3bUgZ-ziBlBpRnlJZ3jTzBnHkxrc1w_hwFCKe0N3ZBwslfw9g6etfzO4wticYgPriK-2Mu0IXr_c98ZeHj",
        "source": "edgertonfrc.org",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSf1bfDH6bh3UdF_o7mdSZ2UoprkQF0je__l3Y6hHynVZH7gQ-O",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "Lincoln Community Foundation Garden Performance Series - Home",
        "link": "https://artsincorporated.org/fgps/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcS_mDfJIg_rnjz21iR8FusOKVEXvVIiA-75CTo2W2-sI2qE6ostf4cDLy__KgU7p6j5H6qkYP9c1yefmjXdqXrlcrn42fsPCfAlyCZDyPivGq2Luyw4ywFD8Q",
        "source": "Arts Incorporated",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTPfkm0GAi--1NuzfHwVOBBGRUoQvIuQIeTV6G8cOOVVsWh-Z9V",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "Apps Channels | TV Apps | Roku Channel Store | Roku",
        "link": "https://channelstore.roku.com/browse/apps",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSO_kezB5kMQoD9_s3N-QRanlvx8SnyVdj4oVz-z-YMqBY42JynrtZZjT8A7Y6s6CZXzmwsRDriFFretsc90DQaj3mxyyki3ZZE7zOfPSi0OUSyI2c-lr3XTmo",
        "source": "Roku",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-0RyHs8e9iZZ2WURifM75lBtdqOWoDlQT8RGPCju-gJ9oKlcw",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-0RyHs8e9iZZ2WURifM75lBtdqOWoDlQT8RGPCju-gJ9oKlcw",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "Church Online — Littleton Church of Christ",
        "link": "https://www.littletonchurch.org/churchonline",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQmfVipbq7rQtwPoqC4Po-xMH3P5qM5wg-EiVrEzIM2YuYZi43HsxiThXF45lTkdaYGMxPX9S2W8IVzVEU9fT930n6iskBckvsKR2IypAVZNdYDIvPFY6v82FNF3A",
        "source": "Littleton Church of Christ",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQWWCUZZ6WNLcZiywey8g4QDw2H7naK4fL7-G7NAmYDymOd8ZFd",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "services — New Horizons Fellowship Church",
        "link": "https://www.nhfchurch.com/services",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTx3EZkS6f0vTYrOCdoVKZ0ixnXJfk3j5vGiEvhGHSQu_S0tK-En_lsD39BVN-vCPey0Az03DUsK682x59bi7rV2Ak9QaYX15hZYCqn6_QGaKllETzKFw",
        "source": "nhfchurch.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSd-3Ystky8B46WBC0gNQABC8vpOxd9wmxTIUeTIBkExCpwHtET",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "The differences between RTK and PPK. Which method is best ...",
        "link": "https://www.ardusimple.com/ppk-vs-rtk/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNV33vg9eOKdK3IItijTo0CjIoVAK2c9OzzYXzVXS1gtbyE61651a9drsxjJW2yC0K7rfttJXAP3g7_LZ0wmwPHQOmepn9z-zIMHJDGlgrijHfNKFESgc",
        "source": "ArduSimple",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS0cxDcJbc9ypZFOS_APjj_8Xzy-gGHG-wbSV_WR0Wn0-tqUAVf",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Kristeen Garcia - Google | LinkedIn",
        "link": "https://www.linkedin.com/in/kristeen-garcia-6879a73b",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQTy_qmt5vLpWNHYFG0-Lswj8W_w9tqvcuXY9-9zmjyLrBEa_5h",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "YouTube Logo (2017-current) - YouTube",
        "link": "https://www.youtube.com/watch?v=qGkE0wz2dwY",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSrIsvSRQmUafGp12uSG_RsufFOOqUxiuk1fYHDoW5gUqWAzpUz",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube's Checks to Warn Creators About Copyright Issues ...",
        "link": "https://ottverse.com/youtube-checks-warn-creators-about-copyright-issues/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQV3QA33hwGlp-HOrq6qCTu4V6QtzpxE8W62b4_TiSVunAN06tPoZW18UhkT5wOHmoEx5PlHrrZjin1Jl1x4ad_9aAYWSZe79fxVLSv4UJHaJ8",
        "source": "OTTVerse",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ4tiYPe8b5sDGi8ePUF7WnAyOgV0ZcmTYWZBsgXYT-fq0M7m6J",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Streaming — Circa Blue",
        "link": "http://www.circa-blue.com/streaming",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTt3fNIjA-fl6fHJU_Tgl1Fk56_swi_Ij-_JFF5erPd7uzyCKFJy9ns5E9-tjhfWsQHN3FR47EQtgit-UWbLwsbIdRRNp-iQH2AC4L7nscMj3e-XADIgw",
        "source": "Circa Blue",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSi2nZFN-lVelw1BqLmLlBvH9w-6upuwyZXJ-NhZkAGPmy-3v77",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "YouTube Logo and the history of the company | LogoMyWay",
        "link": "https://blog.logomyway.com/youtube-logo/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRDhnhnZAw_dtHXVlyEHDgNsfsuCdE9Olv5SxsSbMitiTsa_ufALNgLS0r4eDvmSP6uhnM9oqlRWXEJ_l9x6g2BULG9lnkCwz9AgRvI15F7QmsEY641VQc",
        "source": "LogoMyWay",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpI8R30EVrYnnmV0b5mTFM56JDvDTaPIir8iK3Qcoo9Ad4eu1Q",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Video Gallery — Hay Street United Methodist Church",
        "link": "https://www.haystreetchurch.org/video-gallery",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ3pXOvQSC3hZs5EWZ0GtX4OOH7IrL_oUiE-ZB9RBOWZH5-j0fd3YogXOtepk9iG8rzsY0NZvIyPgFkTQjVLiCO78bTCZgDveUS_aRdGyO2ue8T9dL1qUwUk2wXaA",
        "source": "Hay Street United Methodist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQhO-_k6w9u19ktOabB7m6miYtUyUo_q5yhx1wDAy51XGgj1gUI",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "Titanium Exhaust Shop USA & Supercar Exhaust Fabrication ...",
        "link": "https://www.juggernautmotorsports.com/contact-us",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR8hgMBnSvz0patcT-KaUUmbTuH8f3sF83fa2jAOmFcrLOiOE6fT5HmQjPzlbF6Np1BGYRy6orYGanCsOolZ3U9jKBDL2SugPBWgDoKPDoycWlcMK9NgAeZKoHLFqsV3fY9_Q",
        "source": "Juggernaut Motorsports",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ-6pPnPTwM0a4_gapWHEGKYYe7bU38hPSJcYBf3ozmr1kUgg-O",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "Creative Works – Thaddeus Patrick",
        "link": "https://thaddeusthought.com/creative-works/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR9H-Uc02qgJl7WDZEQsH1N02jvcPWlLdbOlHlS7Z30I-bEHZ5h0xv93j6OLjoC_ItqzSJ0f6PGdr0SLYhHLgpH2VpVDiQW8wq1UoQMMISLxmgHL5BtXtwA",
        "source": "thaddeusthought.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQKG7fqC0d46Ny6wd_aOxD6hTy-XddCy6qjZCzBnRRx2Gdb5ir0",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Media — Family Life",
        "link": "https://www.familylifechurch.me/media",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTOeWZ9jZa4Ht-whsllIBvoXsJBLS7blh4YOJFlBAEXitJ1ud9HgUl2HMBGpBHv1zgp3rvxRZLYCYa7_8Fm_Y8_r6hoVGksZhCYdXNWLOzojOKIL1pRppR7kOHwWw",
        "source": "familylifechurch.me",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-X_hzrtPVUIBHfI_iNjJPMJUOlZgOV5JdXXu2YE-S7ZssIZqA",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-X_hzrtPVUIBHfI_iNjJPMJUOlZgOV5JdXXu2YE-S7ZssIZqA",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "YouTube app gets a huge redesign - PhoneArena",
        "link": "https://www.phonearena.com/news/YouTube-app-gets-a-huge-redesign_id97544",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTzmmUWlKNu2N6Vu_BuvybF4XRJzXoEG5iXXHkZMamhlXGoSgsSvpeu9hQP8FywapcndqFH07W0BWQ3DUcUTSh89ouuATT334y1FEgi-BAx9N93KNMDMNw",
        "source": "PhoneArena",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSQ0Itkcn1QdHRMaVdbpRl6vFhhmq__ZvwiBpWzUYix_VJl8ChG",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Current and Past sermons — Foundation Life Bible Church",
        "link": "https://www.foundationlbc.com/current-past-sermons",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTq-xC-QB4eZoBS4DqluJM9tL3BYTkwcThRQQPPZHR4nIM0hEe30FxSMS0CeL22FQM45RzaTnM_HG0qwTWRqH0Sj9G37kr5WK1xlPPGsKCV-BVrAFJfrC71ivU",
        "source": "Foundation Life Bible Church",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTC53jUWWmtIi-G7SAhX7IJUuj08aRco0kzVt7hphJsvyGMwWZM",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTC53jUWWmtIi-G7SAhX7IJUuj08aRco0kzVt7hphJsvyGMwWZM",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "YouTube unveils homepage redesign for desktop web, tablets ...",
        "link": "https://9to5google.com/2019/11/07/youtube-homepage-redesign/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSC2wBsL2-6jUZRgkl0ZXRz8gpwdpLpTxlI8h6mQjpB188cgO9NzasbxthOpq32FkvwGqDIJyinNbCcMaYDXi09_z9bCOou8fJppEVDHjq5_Lpv5g",
        "source": "9to5Google",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjg6NW8e4I6ISrW--CRXep5kxRkO1B7PqkZCEu7ESWkaK7rKIX",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQjg6NW8e4I6ISrW--CRXep5kxRkO1B7PqkZCEu7ESWkaK7rKIX",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "YouTube Logo (2018-2021 #2) - YouTube",
        "link": "https://www.youtube.com/watch?v=xtL7yvRndCc",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTm3CC34QLpm3ysWo1wybCF78VXBI065JHZXMqApDxrdTV9XhX9",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Contact - Floorotex : Floorotex",
        "link": "https://www.floorotex.com/contact/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT7-TOxoo2JACiBhQ1IAhyD0w5Dad-Ait8UJ-eSRUDY6ekkFnjPALCvxXAU96xjtKYDQURiYt4Q7_uuABwt9-Vhv4QfKHqJMXzZlVDFAJBqCpP9sz_ZUg",
        "source": "Floorotex",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQu7YMOulaVrpBem_YLg7z8UJY34rCTQtTYuhrZy9L_L1RQFtcX",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "Solved: HubSpot Community - Videos in blogs - upload file or ...",
        "link": "https://community.hubspot.com/t5/Blog-Website-Page-Publishing/Videos-in-blogs-upload-file-or-embed-YouTube-video-Which-is/m-p/206849",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcT0ejhaBcqcekAURVnne4Gi4GZgSvgA2EKTPrErARZWejRQImvTgl0UKyuTJRF2DIUWx4D_VU2wpGQZDaBP5zJzigVgGNBIgqB9-J-9GrxdEe0CSe5DlCD19sI",
        "source": "HubSpot",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQI4GdPyH4qaXU1S0cQEEGxPqc2UqV2Ng6AtVEDdlcOjy3GCBsn",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQI4GdPyH4qaXU1S0cQEEGxPqc2UqV2Ng6AtVEDdlcOjy3GCBsn",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "YouTube Ident NEW August 2017 - YouTube",
        "link": "https://www.youtube.com/watch?v=ceA2XVoh0Z4",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRRTAfBYG-g4MIQVwrdCFHpejrjpVW8cIrQO1Zs1NhiT9ugg7Vg",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRRTAfBYG-g4MIQVwrdCFHpejrjpVW8cIrQO1Zs1NhiT9ugg7Vg",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Oakland Woods Baptist Church Clarkston, MI 48346 | SERMONS",
        "link": "http://oaklandwoodschurch.com/sermons",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTXfJE8ouK2vMdX69h7N9hTKqb3Iwwv_tiR6Qy7yMpvk-fdv8p7Kerkm5O2CiIXIN2ofBE1QylpSaJmJ6jyv2IrSVNAIloIRCQA5al_ZZ5Ys0JcdmsC9wSF5uE",
        "source": "Oakland Woods Baptist Church",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTNV6lCytXThIrG4j-8UnGh3luZqr6RFmPLEFz3Q1zk6hZl8OL6",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "How to Sign Up for YouTube TV - YouTube",
        "link": "https://www.youtube.com/watch?v=Qw_8AEoy59o",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSGXVl_lm2UZWqLNkC80N2ZUZlVjMaQzdQaePReyiDB3XDRdz3v",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Elite Recognition Programs Use Our Bespoke E-Commerce Sites",
        "link": "https://societyawards.com/pages/client-retail-stores",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRYk1npGvp5ODOp9brtfx6w50k7MYAMedVhazQ4WB-vvl9K85IsRsixZ9GpHW2te6FBzzL5-bKVIvXia1GKQyN9conp9AtuYgZYX_gwZXP9sagKRQtuSQ",
        "source": "Society Awards",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS4qAmp-7hc-YaD1gpl4DLD6PXSdtWO2CkVx1E5PApu9FPPX31U",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS4qAmp-7hc-YaD1gpl4DLD6PXSdtWO2CkVx1E5PApu9FPPX31U",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Grace Baptist Church, Evansville, Indiana - Livestream",
        "link": "https://gbcevansville.org/livestream",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRV4NguZWfiQ6mFl6KYjn9wcq58bKAdpmD9dNoPp05Lwcfb5jcopqg5RfY4SoDPSDetllVbeRuefoV9gSz460bLOSoP0QV8A2Wl319Xah8QJeRFQsT_xg",
        "source": "Grace Baptist Church, Evansville, Indiana",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-YNqtRd2r0dX-jAR5XulC-Ohw3KmUPTD4xSa51-t3oirJR64p",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-YNqtRd2r0dX-jAR5XulC-Ohw3KmUPTD4xSa51-t3oirJR64p",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "Home - Lee Elci",
        "link": "https://leeelci.com/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSHzFCDKQSmNCwYFbcv_DuBQL5I_58V2XjhA7XXKwCjXFJAlHo9X8hb9DNhViTlrFhg5-BD3W4Ol5DeDs9KsmrtYa98y-SEmu6Ic3fTLWSxiA",
        "source": "leeelci.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQuqb4DjbLh83llruMEH1J3CjUX6x_e_P44LRIf88dlY6q2eUeH",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "Trickshots Yoodle playing now on the YouTube homepage ...",
        "link": "https://www.instagram.com/p/C0flYK7LjUn/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQCZEUC7yeNkzodt4yVdRTth4dYyv7WmfQa9DLsxppGav-PHyna",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQCZEUC7yeNkzodt4yVdRTth4dYyv7WmfQa9DLsxppGav-PHyna",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Sermons - St. John Lutheran Church",
        "link": "https://www.stjohnclarinda.org/page/sermons",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSvb-FwLr9PmStwWcCqR6UDm_JcypU8n6xD6QyIqQ7-Xxct9mPocyLWLDKh8IRG8bHWfrSkzaism9ja6OTui6AGTNCYIeDDsh2K3TUO7JFzQZAbaajA22O2gXzY",
        "source": "stjohnclarinda.org",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTMeSkAm2H_pzdGPDEwyLH0n2dywTfg3evBf8EQfhZK0loy4q-X",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTMeSkAm2H_pzdGPDEwyLH0n2dywTfg3evBf8EQfhZK0loy4q-X",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "Audio",
        "link": "https://brendaportman.com/audio",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRPjf6QxgmeUGa05T8HdECxJNNlljUS99TcB9GpPhQPUt0tiH_f9DcBpWKe8SrSR0ytd9QHKXFz-FZ0baurTnTM-LXGqzJgNnshlSal0c0GLOELKYENCw",
        "source": "Brenda Portman",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRE25aYMxpbO5iS_s7uFs8vAHPekYHm0rLFDBJytzIStBePD0mH",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "New Jerusalem Baptist Church - Landover - Church",
        "link": "https://njbc-landover.org/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTZKZfvNGoD6tUxakhZrEH0P0WPV5gjubqX7FS8GYaOdRnnZU5kj_R54v1djk3YGM7CA72ole_O9Y-MMAZzPjGXoPouGFqC9J__tVFoKy3OCcDG0aKQxQ",
        "source": "njbc-landover.org",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSpJH4guqf7yMwpci0J7ebdCxdCq8n7-KO3s-hv7NPwYmwerjKw",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSpJH4guqf7yMwpci0J7ebdCxdCq8n7-KO3s-hv7NPwYmwerjKw",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Products
Source: https://docs.brightdata.com/api-reference/serp/google-lens/products

Reference for the Bright Data Google Lens Products parameter. Refines queries and returns matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  The `brd_lens` parameter in your request fetches specific Google Lens **tab results** by specifying a tab value (e.g. `products`, `homework`, `visual_matches`, `exact_matches`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=products',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "en-AR",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=50&vsrid=CMKUncyTyreC-QEQAhgBIiRkODk3MGI4MC1jMTMzLTRjOTEtYjE4My1mYWMzMjdjMWFhOTMyBiICY2coCjjV7f7D9vySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=iyuSUvhA6gPxqXtV7-kWdx271odwkq52yC_ZQadCLcsOiJt-udofqA&lsessionid=j-5aVB4uWbzMVnMov8kPD0zsJOqrvTRbwGvIZDr4E-UxmI7_r6L2NA&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQ2J8OegQIDxAD"
      },
      {
        "name": "All",
        "type": "all",
        "selected": true
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=48&vsrid=CMKUncyTyreC-QEQAhgBIiRkODk3MGI4MC1jMTMzLTRjOTEtYjE4My1mYWMzMjdjMWFhOTMyBiICY2coCjjV7f7D9vySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=iyuSUvhA6gPxqXtV7-kWdx271odwkq52yC_ZQadCLcsOiJt-udofqA&lsessionid=j-5aVB4uWbzMVnMov8kPD0zsJOqrvTRbwGvIZDr4E-UxmI7_r6L2NA&vsrid=CMKUncyTyreC-QEQAhgBIiQ3ZTEzNGQ4Zi1hMTU2LTQ5ZmEtYmJiZC0zZWY2Yzc0MGMxNjQyBiICY2coCjjV7f7D9vySA1AA&q=&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQs6gLegQIEhAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=2dc65c8cbd5d287b&lns_surface=26&hl=en&udm=44&vsrid=CMKUncyTyreC-QEQAhgBIiRkODk3MGI4MC1jMTMzLTRjOTEtYjE4My1mYWMzMjdjMWFhOTMyBiICY2coCjjV7f7D9vySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=iyuSUvhA6gPxqXtV7-kWdx271odwkq52yC_ZQadCLcsOiJt-udofqA&lsessionid=j-5aVB4uWbzMVnMov8kPD0zsJOqrvTRbwGvIZDr4E-UxmI7_r6L2NA&q=&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQs6gLegQIERAB"
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAAFMALP_IkoKSAjClJ3Mk8q3gvkBEAIYASIkZDg5NzBiODAtYzEzMy00YzkxLWIxODMtZmFjMzI3YzFhYTkzMgYiAmNnKAo41e3-w_b8kgNQAP3h16dMAAAA&sa=X&ved=2ahUKEwiRuIDF9vySAxU7npUCHcrTGNsQs6gLegQIExAB"
      },
      {
        "name": "Feedback",
        "link": "https://www.google.com#"
      }
    ],
    "images": [
      {
        "title": "YouTube | Memespedia | Fandom",
        "link": "https://meme.fandom.com/es/wiki/YouTube",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Fandom",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "App YouTube - App Store",
        "link": "https://apps.apple.com/us/app/youtube/id544007664?l=es-MX&platform=tv",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Apple",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAATYAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAATYAAA...",
        "rank": 2,
        "global_rank": 2
      },
      {
        "title": "Archivo:YouTube Logo (2013-2017).svg - Wikipedia, la ...",
        "link": "https://es.wikipedia.org/wiki/Archivo:YouTube_Logo_(2013-2017).svg",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Wikipedia",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAVcAAA...",
        "rank": 3,
        "global_rank": 3
      },
      {
        "title": "YouTube se actualiza - YouTube",
        "link": "https://www.youtube.com/watch?v=F1nq3JfbFgQ",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQMAAA...",
        "rank": 4,
        "global_rank": 4
      },
      {
        "title": "Universidad del Cine",
        "link": "https://ucine.edu.ar/actividades/youtube-summer-camp-2020",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABkAAA...",
        "source": "Universidad del Cine",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUEAAA...",
        "rank": 5,
        "global_rank": 5
      },
      {
        "title": "Qué logo de YouTube es mejor? : r/youtube",
        "link": "https://www.reddit.com/r/youtube/comments/1d4y2s0/which_youtube_logo_is_better/?tl=es-es",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAd0AAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAd0AAA...",
        "rank": 6,
        "global_rank": 6
      },
      {
        "title": "El nuevo negocio de YouTube",
        "link": "https://www.clarin.com/tecnologia/nuevo-negocio-youtube_0_BJVX94-cz.html",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Clarin.com",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAA...",
        "rank": 7,
        "global_rank": 7
      },
      {
        "title": "YouTube Latinoamérica - YouTube",
        "link": "https://www.youtube.com/channel/UCBrGE6cmFbcwzlwAyIDMGpw",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "YouTube",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAOEAAA...",
        "rank": 8,
        "global_rank": 8
      },
      {
        "title": "2020 | Wiki YouTube Pedia | Fandom",
        "link": "https://youtube.fandom.com/es/wiki/2020",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Fandom",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 9
      },
      {
        "title": "YouTube now second only to BBC as most popular media ...",
        "link": "https://www.bbc.co.uk/news/articles/c4gzvee78eqo",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "BBC",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 10
      },
      {
        "title": "Cómo usar y publicar los Cortos de YouTube con su beta, la ...",
        "link": "https://www.xataka.com/basics/como-usar-publicar-cortos-youtube-alternativa-a-tiktok",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Xataka",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWwAAA...",
        "rank": 11,
        "global_rank": 11
      },
      {
        "title": "YouTube prueba los videos de calidad superior",
        "link": "https://www.iprofesional.com/tecnologia/278517-4k-internet-video-YouTube-prueba-los-videos-de-calidad-superior",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "iProfesional",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 12,
        "global_rank": 12
      },
      {
        "title": "Diseño del logo de YouTube: historia y evolución | Turbologo",
        "link": "https://turbologo.com/es/blog/logotipo-de-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcR6tUu-mAbS6Kcb50kBPqLT98Mp3NtABDtMpKcwLAfhbn1T5xdZLM64whLYXwy2bw2P60gTc7zIAhcjk6cfQA2RW3jRZeFq8_AwdrwVOIIXWp0A",
        "source": "Turbologo logo maker",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSN1CN7mcicZ-Uo5-OaUBUNJNB9F1E2h1okTubW7Q0-KLVWEAaH",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSN1CN7mcicZ-Uo5-OaUBUNJNB9F1E2h1okTubW7Q0-KLVWEAaH",
        "rank": 13,
        "global_rank": 13
      },
      {
        "title": "Últimas noticias de Videos virales | TN",
        "link": "https://tn.com.ar/tags/%2Fvideos-virales/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSJbU5ugKLEVJpAJhKG-Kpo0ZqLVY2ON4Wm5ybBFA5621Bgmq_nKNqPV_RJj9v6V_22fldVB78-4r1aW0t2r0iBRco8sthKzCKBqp9xlF4",
        "source": "TN",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSiA-hAINFCOeRB5x02QlA03ByvJb3X6DUGkU9TBb3ymCl1EhT2",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSiA-hAINFCOeRB5x02QlA03ByvJb3X6DUGkU9TBb3ymCl1EhT2",
        "rank": 14,
        "global_rank": 14
      },
      {
        "title": "A 20 años de la llegada de YouTube: la plataforma que ...",
        "link": "https://www.conclusion.com.ar/info-general/a-20-anos-de-la-llegada-de-youtube-la-plataforma-que-transformo-los-videos-caseros-en-una-profesion/02/2025/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQa-eLJd9_jHp81mqzGDa0ycAFBH9np6w9cd_qzY8ZwzNkXtPjg9RB02q8DHs5bvH-Hl9xkYc9PMeTGCb8tGrV7TWbF7fiivnn4L49H3ZC50Y-2Tx6vbrLz7Ys",
        "source": "Diario Digital Conclusión",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRf6tQ43gFnFLiqCk3k28LJCpFPdNcUCffhp97v5Ekn9zkAlWSI",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRf6tQ43gFnFLiqCk3k28LJCpFPdNcUCffhp97v5Ekn9zkAlWSI",
        "rank": 15,
        "global_rank": 15
      },
      {
        "title": "YouTube presenta su nuevo logotipo y un profundo rediseño de ...",
        "link": "https://www.outono.net/elentir/2017/08/29/youtube-presenta-su-nuevo-logotipo-y-un-profundo-rediseno-de-su-portal/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTOvB0_qpvIfTOqAnMDcCvH2Lc7LhVX0xg18uwBryjiPTd7iaXQs3WcgYY5nXHW01ApiD06O2FX82Qju-FCkt5WFXRrtmpk09eYCiGvEai1KiA_Ig",
        "source": "Contando Estrelas",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQT1uIGMKDvU8vJCs3gdq4AZ2H-CdD9xkEZI_jLwCsZjnyDVjuM",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQT1uIGMKDvU8vJCs3gdq4AZ2H-CdD9xkEZI_jLwCsZjnyDVjuM",
        "rank": 16,
        "global_rank": 16
      },
      {
        "title": "Qué tan grande es YouTube? Nadie lo sabe - The New York Times",
        "link": "https://www.nytimes.com/es/2019/07/28/espanol/youtube-ganancias-google.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRszyNSCYR04WGtSoefBwhwwe0NZDJ2NRax9ELrHGpQtwbG2FlJEx0ypzELo9V6Wpi6bcLEWpUcrMTLpkhIptbuYuWkKpaRsx-z4E6t7l8zAoUPsCc",
        "source": "The New York Times",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQUrEBqelGhE2yFiY8Ndcoa4wMUkfjMt6iRo7yDD_MpIsB6S8jU",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQUrEBqelGhE2yFiY8Ndcoa4wMUkfjMt6iRo7yDD_MpIsB6S8jU",
        "rank": 17,
        "global_rank": 17
      },
      {
        "title": "Streaming: qué es esta nueva moda y con qué plataformas se hace",
        "link": "https://www.lacapital.com.ar/informacion-general/streaming-que-es-esta-nueva-moda-y-que-plataformas-se-hace-n2629027.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRvjD9C8f1iRqlUM1tJLrVPgl_PPIIWkoEF07zoIMN5LpLiEaxDbVtC-xVQFSdv4R-fIvM2s1O1jBU8tcef0o8vFk5TsZN1CNQox-kgBM-IycO8Jak7Jxs7JQ",
        "source": "La Capital",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTZ8uRHP8tWztYzrUUFVoj3wbSZMpkc9mvnaY2ajphoiOfz6h86",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTZ8uRHP8tWztYzrUUFVoj3wbSZMpkc9mvnaY2ajphoiOfz6h86",
        "rank": 18,
        "global_rank": 18
      },
      {
        "title": "Hype, la nueva herramienta de Youtube para Creadores de ...",
        "link": "https://www.a24.com/trends/youtube-lanza-una-nueva-herramienta-ayudar-los-creadores-contenido-pocos-seguidores-n1359433",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTNEcleeClkxVsgUZPqJalPF5C8B8W1QZ8C5ISiFMBneB3QVAH8gVIE7oeepN3M0YwNftP9a2WWndJXtA1wioUcNrQ4FuOEHZ33VDa9sHQqBw",
        "source": "a24.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQkdwfP5dHc06cUX4Blh36d_hB2UWA74ekM1TC8r0rjr6hHUyhv",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQkdwfP5dHc06cUX4Blh36d_hB2UWA74ekM1TC8r0rjr6hHUyhv",
        "rank": 19,
        "global_rank": 19
      },
      {
        "title": "Noticias de Youtube - El Destape",
        "link": "https://www.eldestapeweb.com/tag/youtube",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT5tjXlL4a6_N6iDYuOuEOCT7-QaFXti9GFgpdxTjI4bgP7wngjc4FtUeCTozmraUbLLmBPlzgnksXM3dghB4kUuOCn5zUWGVG2bOMlqXLzLzafhzluL5b8PA",
        "source": "El Destape",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQA5_xQbWxlIeUWBe2g7YEIOYPwA2Ka10qMnusOqyQXedUtEEeB",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQA5_xQbWxlIeUWBe2g7YEIOYPwA2Ka10qMnusOqyQXedUtEEeB",
        "rank": 20,
        "global_rank": 20
      },
      {
        "title": "File:YouTube logo upside down.jpg - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/File:YouTube_logo_upside_down.jpg",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRLIcgPlYxOaoBg0MnSobLYyflrgF_RLdwAY09AXHWGy2jqWQnuIBNCY5I1BuzY7jeAJga0y0b9htBHe94i3Pg4B0NhHMNDVsmS-FVRKL014d-Xf6sX",
        "source": "Wikipedia",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSfrQHl2V53W7OwOig95s00ICt1v4hY4a7lZNd0b-uyTTtj5cGV",
        "rank": 21,
        "global_rank": 21
      },
      {
        "title": "La caída de YouTube: ¿qué pasó y por qué te quedaste sin videos?",
        "link": "https://www.iprofesional.com/tecnologia/448363-el-fin-de-youtube-que-paso-y-por-que-te-quedaste-sin-videos",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQIY5tthJUk2HFe1X82Pc1B0p_xyfdGPejRT2hGeDXEDFRAuF8RVCRWPQt5nrBwptU1dRzDJgBPte6yFOPjtsvuy7XouJ8-B2k67KhrpfvD6r0Fbme2qD3nDg",
        "source": "iProfesional",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRfj_K55WxnGboVPK_VFDwHDF9MZ0FNYD0p9Q2vYUSJfRCJybbz",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRfj_K55WxnGboVPK_VFDwHDF9MZ0FNYD0p9Q2vYUSJfRCJybbz",
        "rank": 22,
        "global_rank": 22
      },
      {
        "title": "20.000 suscriptores en YouTube y el cambio que vi en la ...",
        "link": "https://www.sirchandler.com.ar/2018/07/20-000-suscriptores-en-youtube-y-el-cambio-que-vi-en-la-plataforma/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQqyKc2GXt9Z8xgsjkPfcOvc-GGQ3Qm3sHdlU3-J5pYeDXwujlJfHlvXEr3ywQ9s9GOzHVtQ30LV-C9y1hZlbllIv59UL8c16K06k541VDTY-ShRCnzJQQMwVmf",
        "source": "Sir Chandler",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcScbSRfuTNQ8N4vsN7i2r6ppN6SQ7gweiPa5reRISkXwxsGBHZ7",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcScbSRfuTNQ8N4vsN7i2r6ppN6SQ7gweiPa5reRISkXwxsGBHZ7",
        "rank": 23,
        "global_rank": 23
      },
      {
        "title": "Cuánto paga YouTube por un video que supera las 1.000 ...",
        "link": "https://www.lagaceta.com.ar/nota/1060541/sociedad/cuanto-paga-youtube-video-supera-1000-visualizaciones.html",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcTuu44DyXS2om-cU2I3lzPmu90_4SScET0wWBL2Qdk5if5Ya545htgXwr7K__IJu5FA6Nid52A8QjMIQt0UmPy0o-HRf5_G0sSEFsdyxJNlB0UE7pIOgwt2",
        "source": "La Gaceta",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQNm9sZXv7dm8ucLqShCSrLwD6f0MP4FTzqwIqv_7D5pBsSctWu",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQNm9sZXv7dm8ucLqShCSrLwD6f0MP4FTzqwIqv_7D5pBsSctWu",
        "rank": 24,
        "global_rank": 24
      },
      {
        "title": "YouTube: el truco viral para resumir los videos y que es ...",
        "link": "https://www.ambito.com/tecnologia/youtube-el-truco-viral-resumir-los-videos-y-que-es-completamente-gratis-n6078103",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRrvz5bLnZhSkk0pRUzYwvsBlv97yjyOcjNpDbJK1Ykl-rOWXS5YVVbeGarqUUFe8eN7Xb8Z7o_lPiwC8Ca6AexPxXuPeZPgeOuzRYgqHnpEf036g",
        "source": "Ambito",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQWj2v-hwFsJMx6lS8l19J1TVP03QB5rqRwZpBngX8MisOnyvAM",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQWj2v-hwFsJMx6lS8l19J1TVP03QB5rqRwZpBngX8MisOnyvAM",
        "rank": 25,
        "global_rank": 25
      },
      {
        "title": "21 ANIVERSARIO DE:\"YOUTUBE\" 14 de febrero de 2005, se lanzó ...",
        "link": "https://www.instagram.com/p/DUvidwzj0wh/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQT4N8A_ZfJasQcFUwjMciAzoSf7lVsH1hJ9oNLqks1Mi6Psbvr",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQT4N8A_ZfJasQcFUwjMciAzoSf7lVsH1hJ9oNLqks1Mi6Psbvr",
        "rank": 26,
        "global_rank": 26
      },
      {
        "title": "What is YouTube?",
        "link": "https://www.webwise.ie/parents/what-is-youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSbLBrYqX4Z0t1sT5T5OU0dU6Fvo9atHPiaH8iMCrSjf5T6HovbHsmdOsi0EyUarD3VOBf91gWcD9zD6UooW24U6P9v-9hAL7DI5HNE9UQ5lM_Xvw",
        "source": "Webwise - Internet Safety",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQwO8Vfju8uGEWjkvVBJbZ-TFwjll0_nwfouGH5ZX0GP62kXokW",
        "rank": 27,
        "global_rank": 27
      },
      {
        "title": "Historia del logo de YouTube: evolución desde el 2005 hasta hoy",
        "link": "https://www.imprentaonline.net/blog/logo-youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT1eWyufUIDauJkbZXSRQ1XN83wJwy0lqzrCCTC6XuIYz8x5rlXAOtKFwAWjroj04nnlbYVyVoCuZsyZ9-REe_y91pZVyFVgQgJBf-PToAm_dsNBE6zm_e_S470",
        "source": "Imprenta Online",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRg97a8CdqdCZmA0_cEVZ0yufqqkyJ4q4NI8dkPRjiLZ5q5767T",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRg97a8CdqdCZmA0_cEVZ0yufqqkyJ4q4NI8dkPRjiLZ5q5767T",
        "rank": 28,
        "global_rank": 28
      },
      {
        "title": "Últimas noticias de YouTube | TN",
        "link": "https://tn.com.ar/tags/youtube/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSJbU5ugKLEVJpAJhKG-Kpo0ZqLVY2ON4Wm5ybBFA5621Bgmq_nKNqPV_RJj9v6V_22fldVB78-4r1aW0t2r0iBRco8sthKzCKBqp9xlF4",
        "source": "TN",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSpQLoWP-Z8oXD4avRfZQh7PhGIQYWS-37zNUdfSf_A9ePF3eBh",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSpQLoWP-Z8oXD4avRfZQh7PhGIQYWS-37zNUdfSf_A9ePF3eBh",
        "rank": 29,
        "global_rank": 29
      },
      {
        "title": "Se cayó YouTube: qué pasó y cuándo vuelve - TyC Sports",
        "link": "https://www.tycsports.com/interes-general/se-cayo-youtube-que-paso-y-cuando-vuelve-id704724.html",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQWBz2_p1S6liAJwp3r1Ghs4-CVkJ7uWrq2SN__qyJc0tZEaPV44tv2Y6mwXYKtx2_yVs4Bjk4yjKde1GcPDfxZu9DhPp6oKoZlx0-UOEFa3M4POWSZpw",
        "source": "TyC Sports",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRlq2yLRIJW5dykvjMHhoMGErZf-Rf4EwrMKi01OUM9fWirAgF_",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRlq2yLRIJW5dykvjMHhoMGErZf-Rf4EwrMKi01OUM9fWirAgF_",
        "rank": 30,
        "global_rank": 30
      },
      {
        "title": "YouTube para Nintendo Switch - Sitio Oficial de Nintendo ...",
        "link": "https://www.nintendo.com/es-ar/store/products/youtube-switch/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcToBGjo96GmUCHevYIGmN-UpS53MeR2ZhzA3_OkIOo1c13GKN_eBvJl9QW6mzxeD5hTpJ-y6aDxlz1ebw2zFTwvBQpumpCdgwqbY9MRx5lDJF5Ae_Qe",
        "source": "Nintendo",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRTAm2QK0oWNamFEEaSAGn-YXfdVX2J0FgPq402JWb5mitzKB24",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRTAm2QK0oWNamFEEaSAGn-YXfdVX2J0FgPq402JWb5mitzKB24",
        "rank": 31,
        "global_rank": 31
      },
      {
        "title": "YouTube Creators (@YouTubeCreators) / Posts / X",
        "link": "https://x.com/YouTubeCreators",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSofvqtbDtdUTZsANJSe_PTSgsuDSmzMNykD5ePbsMk3EyTY0EoF56jNp_rHuufm9BtNpZYsFhp9M6u-DLxqcg2x-FRa41-OCrNmA",
        "source": "X",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTpYm0h48xaRTDWgjq-VmSTCs-T0tZlf-TYLWaEkUFI6qXpuNBd",
        "rank": 32,
        "global_rank": 32
      },
      {
        "title": "YouTube",
        "link": "https://www.youtube.com/watch?v=2rjtpWxRSP8",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSIG8oSJsLuYZ6VU_Eza7vyti1F9pMnaPAiH3dGZTFw31zOVole",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSIG8oSJsLuYZ6VU_Eza7vyti1F9pMnaPAiH3dGZTFw31zOVole",
        "rank": 33,
        "global_rank": 33
      },
      {
        "title": "Microcurso: Aprendé a usar YouTube | Educ.ar, portal ...",
        "link": "https://www.educ.ar/recursos/157416/microcurso-aprende-a-usar-youtube",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSOVQrKfBshEiz9Z856_AfmPDmFagGCjiOzhCABq_tWARw_V3Swe9UQ--NEMhYE9svYtsxkj7uMF6_da5l-Wv2u7D31b6g9mX46zIx5gRTFlQ",
        "source": "Educ.ar",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQeNFmvKVVqq7JAl6MKlh4tGJtUa9FKIFVuvY-nezCYqplh8zK8",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQeNFmvKVVqq7JAl6MKlh4tGJtUa9FKIFVuvY-nezCYqplh8zK8",
        "rank": 34,
        "global_rank": 34
      },
      {
        "title": "Youtube se cayó a nivel mundial: miles de usuarios ...",
        "link": "https://radiomitre.cienradios.com/mundo/youtube-se-cayo-a-nivel-mundial-miles-de-usuarios-reportaron-fallas-al-momento-de-utilizarlo/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRYud675uvJsE28w3xxp10rd9pH7gOnuLTTYzU4dGi6lCdPNYwND4rGytlEzec5Q-y_8iQJqlU-60XvQlS3h9eU4IfTGrtm0UP0lfajo9JpcKRTQViwduGXdBVDh3VE",
        "source": "Cienradios",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSC-OEaaBPYm-qsL_CPOkxHCZfzFGjA4K20GSOBWBCTPWvPLDZw",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSC-OEaaBPYm-qsL_CPOkxHCZfzFGjA4K20GSOBWBCTPWvPLDZw",
        "rank": 35,
        "global_rank": 35
      },
      {
        "title": "Por qué YouTube impulsa las herramientas de IA para ...",
        "link": "https://www.rionegro.com.ar/tecnologia/por-que-youtube-impulsa-las-herramientas-de-ia-para-creadores-de-videos/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQPXtmlbUUF-TvlAH5Rh72QkGVUM6wECTPLuYKur6oe3mcp55McLFWNN_jkc-nlmBnY2MWhf2DzSGRlAixfY1-avuOpHVRZwzHDt-MUJ25TD1t6UyR4Jg64",
        "source": "Diario Río Negro",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS2hujQa-2w3xZ-MMU9sDTVzjXj0cf5p3qoHmSU2sikaZCCDndk",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS2hujQa-2w3xZ-MMU9sDTVzjXj0cf5p3qoHmSU2sikaZCCDndk",
        "rank": 36,
        "global_rank": 36
      },
      {
        "title": "YouTube celebra su 20° Aniversario | PORTAL INFOBRANDSEN",
        "link": "https://www.infobrandsen.com.ar/2025/04/23/youtube-celebra-su-20-aniversario/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRiNs6yRqD0TYtn9LAUaMaY1Zy1t7g5VxE-BXsHy6RS6m-C-_4y6R7v11lvrpTDqeZCZySRpYVNK0gVd9y-gW7NCUuzwHRE03Jz2ZIuUAX5dlgSv3gN-DSXws6AyQ",
        "source": "Infobrandsen",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTMsPGpEn62QA4Mbp5b1w1BukB0845GFcxnabPIa_NNOti8mwbY",
        "rank": 37,
        "global_rank": 37
      },
      {
        "title": "YouTube Recap 2025 en Argentina revela cuáles son los videos ...",
        "link": "https://www.clarin.com/tecnologia/youtube-recap-2025-argentina-revela-videos-creadores-vistos-viste_0_fANqjYaTe5.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTjJ58r7L5G0jSZyHd6tQ8oeizM_cAj-DHZy-SaoLLYhvAQDSIqECAy16IlRKF3xQT5UZusZY-YYCzt7M2jBY3EmvAm6btP8u2jHqGK8NXvKUs8sA",
        "source": "Clarin.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRo-xxKoMUsaHCMxUjR952ic5dSOBDsfzbMy8gZZ5SZYSqs2RKU",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRo-xxKoMUsaHCMxUjR952ic5dSOBDsfzbMy8gZZ5SZYSqs2RKU",
        "rank": 38,
        "global_rank": 38
      },
      {
        "title": "Descubre vídeos de YouTube adecuados para familias ...",
        "link": "https://www.youtube.com/intl/ALL_es/kids/familyfriendly-videos/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcREjZAOHqN4ntQCHnWupART1zemHPNxT-K6Vkhxa9GMMuNOZ9ER",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcREjZAOHqN4ntQCHnWupART1zemHPNxT-K6Vkhxa9GMMuNOZ9ER",
        "rank": 39,
        "global_rank": 39
      },
      {
        "title": "YouTube actualizará tus videos antiguos a 4k usando IA: un ...",
        "link": "https://www.infobae.com/tecno/2025/10/30/youtube-actualizara-tus-videos-antiguos-a-4k-usando-ia-un-cambio-muy-favorable/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDJSoti_tDfiR_vuZSDA_MJ_IjYOOlEmN7SbCZfohWPjZ_7d8VVr2r2xFglMDSqxYoST6tmoMREWvo1ShnVcRLcth-da1-O4UZ7xomdiLQCc_YdRs",
        "source": "Infobae",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTUThi_9UBd0ItPQTIKnvkraVPx_BE1UR5XoWu3TZ2EtF7-xb6B",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTUThi_9UBd0ItPQTIKnvkraVPx_BE1UR5XoWu3TZ2EtF7-xb6B",
        "rank": 40,
        "global_rank": 40
      },
      {
        "title": "Vector de Stock Youtube logo on a white background | Adobe Stock",
        "link": "https://stock.adobe.com/ar/images/youtube-logo-on-a-white-background/300389025",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRmO_8sjV79Lvr80yZ9v1mjcRZDN1hZFi-kX0mYgHFcDxvZ4OuuaYwV5sxiW05Fr2yEjvT8RYkmpSI3x9KzYnAoAOZc8ty6wCgzyZMh0u3JrhgGpag",
        "source": "Adobe",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQjtKyF0z1Hck78_jgdXgYKBeedGXV1jWUKglS7pNRJlYkDBhrW",
        "rank": 41,
        "global_rank": 41
      },
      {
        "title": "FM ALTAVOZ – FM 94.1",
        "link": "https://fmaltavozclasicos.ar/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSn4fhxjdfhpn6Du5HX7oa-73KWVr9C70IQjc0i7KwTi2IJ6ZHtb3oo0r_MFE16hjwiusvELJ2dXuTNA5h9Z7vuDdppuyueLD2mGgidraS3II1oKu9C-xVY5A",
        "source": "fm altavoz",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTFuO2Irn3aJOPN7atMv-J4SSfjdOYSMuNsNvO91ax44iaeRvlo",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTFuO2Irn3aJOPN7atMv-J4SSfjdOYSMuNsNvO91ax44iaeRvlo",
        "rank": 42,
        "global_rank": 42
      },
      {
        "title": "YouTube Premium - YouTube",
        "link": "https://www.youtube.com/premium?app=desktop&gl=MX&hl=es-419",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRoA3XLRLlSu7GDeIM4mOo8n2IsC2MMXJTUWuPEhLl8-H8UQjAV",
        "rank": 43,
        "global_rank": 43
      },
      {
        "title": "Bienvenidos a nuestro nuevo canal de Youtube",
        "link": "https://convivir.org/2022/08/bienvenidos-a-nuestro-nuevo-canal-de-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRuyJeitZ-_zbSuk7V0aMlEZz31ZLzke2G4kPWJ3dGfy9aY3Mw4PGMgmJjtzOQgJUW0Z7yM6ZqhCJgu-rAVI2he9Jy3txyZttHqdhymeAlJj0Q",
        "source": "convivir.org",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSPTuiwSU2bu7guekjPAgE39vAcduX2aMm85k5GrZANTU4P-Xa6",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSPTuiwSU2bu7guekjPAgE39vAcduX2aMm85k5GrZANTU4P-Xa6",
        "rank": 44,
        "global_rank": 44
      },
      {
        "title": "Cómo superar a tu competencia en Youtube 2025 🚀",
        "link": "https://comprarvisitas.net/como-superar-a-tu-competencia-en-youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ7ZL0TitorxOOVxwsDP3WXZyeHp4FAZqSJnbUe8b_V9-QNUwp-0DR2Ad-bOKcpryp-10NC_Ae5quhY-mkQgZ7sfPTjxk2X4W-rLmYSrwNWD8FFHj__nNg",
        "source": "Comprarvisitas.net",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQbF2iyk4oG4zMb1WHxp6EUGPGUHL2UYktp6XSPjs2x_Ucui_Or",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQbF2iyk4oG4zMb1WHxp6EUGPGUHL2UYktp6XSPjs2x_Ucui_Or",
        "rank": 45,
        "global_rank": 45
      },
      {
        "title": "Ocho de cada diez argentinos afirman que YouTube es el ...",
        "link": "https://www.eltribuno.com/tecnologia/2024-1-6-17-1-0-ocho-de-cada-diez-argentinos-afirman-que-youtube-es-el-servicio-de-videos-que-mas-miran",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFlGm6kDo__eMV3uQ7Fl4TO20X1SIfFb8jDeOzXx7JFU_4sDnVnPwempbQsfLHzC57jbACV8HqopmZTUZRDXErYUhL9_Bw0lt9vE8Y-oZpQgx_4Zi6TQ",
        "source": "El Tribuno",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRAL4bCogkWpDQobugDeI1QMf0D3x_Bq6c9699iK3oWR_TO1FiQ",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRAL4bCogkWpDQobugDeI1QMf0D3x_Bq6c9699iK3oWR_TO1FiQ",
        "rank": 46,
        "global_rank": 46
      },
      {
        "title": "YouTube is giving you better control over what videos are on ...",
        "link": "https://www.xda-developers.com/youtube-better-control-over-what-videos-are-on-your-homepage/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRAME90RmDvZ7n5QF-g_fXA6hrG1UpK1yFStismLE2bPsvQ8NDeM_419lGa-XTsXWEQ7-TMRilzLDBgbo39QRarJ_dIvrWYKxo3Lc1KDOvngg4HxOqxV7yDSBqR",
        "source": "XDA",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRQic49NGU9caQSmutaO1b9OICmJ1yA74nHS4EBDblaazX9dnyE",
        "rank": 47,
        "global_rank": 47
      },
      {
        "title": "Logotipo de YouTube YouTube es un sitio web para compartir ...",
        "link": "https://www.freepik.es/vector-premium/logotipo-youtube-youtube-es-sitio-web-compartir-videos_30873446.htm",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQjfDgOxQ9diXs3nHxnVm0cOXUeN2KLO4fzw6694xmC8tFwgYIZ1Ukmss0xzHh9FeA4GBpeeiHWbiDUrO2skF2b_zaY-B9AW_w0lq9idE-UcYKVCQ",
        "source": "Freepik",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRFIr7apuuUboNA9BNNRXvFmDCqDqnq6y9Ns4jZl4gdHv2Xx39C",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRFIr7apuuUboNA9BNNRXvFmDCqDqnq6y9Ns4jZl4gdHv2Xx39C",
        "rank": 48,
        "global_rank": 48
      },
      {
        "title": "Shannon Ong - Product Lead at YouTube (Google) | Ex-Amazon ...",
        "link": "https://www.linkedin.com/in/shannon-ong-44887053",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTFMvFisG5Yfyq07VS0hk1otTr6uQvufSrlgYLzmBkZlxd7MQh66ZmKRUOdwfXrertN7RslYSLWGQCDyxLn3JsHLob5z5LPzTRUUQlVmSHaBnVJlJa8",
        "source": "LinkedIn",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSHV_Rg6Zrd0YDIQ2z9jIc_bujs7QKmKxjUMoDk6jXc_c9S5XVv",
        "rank": 49,
        "global_rank": 49
      },
      {
        "title": "Tienda Online de Mates Imperio Verde - YOUTUBE",
        "link": "https://matesimperioverde.com.ar/youtube/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcR5Trf_oqul8xGk_4jZQfKCZ-lk2734NX87Uwm_GxwlN_lbvnhhXrpdFv50y6oLusQg9dlOc7xvbLBAiHfF4uLxvUcIoFH8zsPoaUft1Hnt21uI4B_GSdBh8iTtyoI",
        "source": "Mates Imperio Verde",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRY6VMEnyET4gl4llMs0eN_sbvlU-ykjoPYVR34W_9AejsMhW_s",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRY6VMEnyET4gl4llMs0eN_sbvlU-ykjoPYVR34W_9AejsMhW_s",
        "rank": 50,
        "global_rank": 50
      },
      {
        "title": "YouTube como herramienta educativa | Revista Cabal",
        "link": "https://www.revistacabal.coop/tecnologia/youtube-como-herramienta-educativa",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ5dtjoI0FQNrhM5bawPCCVj0-38LAVb5pM2MpzMjqJGHl0jV-LWq1DwpI7ISWMXzGJ1OE78u26weDllx5NWpJvXmAifXPi-nqfsMURD32bGRij_X0ncqxkahM",
        "source": "Revista Cabal",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTNylW048lm1-5LdJclgNpW9DfUVYU_5tiMdDo7OrW2DKK7v74",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRTNylW048lm1-5LdJclgNpW9DfUVYU_5tiMdDo7OrW2DKK7v74",
        "rank": 51,
        "global_rank": 51
      },
      {
        "title": "Best Free YouTube Video Downloader for Windows 2025",
        "link": "https://www.donemax.com/video-download/top-4-free-youtube-video-downloader.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT42ycJdf2UKgzoluI34OleyFF20kCMoM4nCVIyKw6nZHeVCEEYZRNkNzQOSdCzqTsMJC0veLw3rjdZkoJJJb57F_FMNM63E8_laLInHR0Vxvk-wSQ",
        "source": "Donemax",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSRNHWLmtSnUSexb14Iegqe3ZtC3-TjRAiHzoLmjzm2dhr9a8fc",
        "rank": 52,
        "global_rank": 52
      },
      {
        "title": "Me at the Zoo: el primer video de YouTube cumple 17 años y ...",
        "link": "https://www.lacapital.com.ar/informacion-general/me-at-the-zoo-el-primer-video-youtube-cumple-17-anos-y-sigue-sumando-clicks-n10013748.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRvjD9C8f1iRqlUM1tJLrVPgl_PPIIWkoEF07zoIMN5LpLiEaxDbVtC-xVQFSdv4R-fIvM2s1O1jBU8tcef0o8vFk5TsZN1CNQox-kgBM-IycO8Jak7Jxs7JQ",
        "source": "La Capital",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQDgcQDY8awAQt18xCSFVORK9VD5KCPes_loy4eE5nTE-zZ03Nz",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQDgcQDY8awAQt18xCSFVORK9VD5KCPes_loy4eE5nTE-zZ03Nz",
        "rank": 53,
        "global_rank": 53
      },
      {
        "title": "Comparte tu pasión por la cocina y únete a nuestra comunidad ...",
        "link": "https://www.facebook.com/hoyquecomemosblog/posts/comparte-tu-pasi%C3%B3n-por-la-cocina-y-%C3%BAnete-a-nuestra-comunidad-de-youtube-gratis-c/884788059910526/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRv794zBOQO02ChHD5K_TnlJwwf8PThFmn58OZAhQnomqvb1XKnHGAk8BQDBcyXho53FvXtsB2eVFSimUAzH3zcBAPC_yfttm2gkn07x3UumIdkepR5",
        "source": "Facebook",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSmsFe8ViO8t8SNMFkStD6BhROxgG9kDif5gAZngEiWrUSYahIK",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSmsFe8ViO8t8SNMFkStD6BhROxgG9kDif5gAZngEiWrUSYahIK",
        "rank": 54,
        "global_rank": 54
      },
      {
        "title": "Ya puedes descargar la aplicación de YouTube en Nintendo ...",
        "link": "https://www.3djuegos.com/nintendo-switch/noticias/ya-puedes-descargar-la-aplicacion-de-youtube-en-nintendo-181108-87335",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSKZlwlNGXQBQKkw2pg-KrPUZxAksUOqKO1ZdE0lJO-0YI4-YZJjm9P3LU5coiCkfrI0iYvMeBJIor0-yoKl7hpjYnvqmThha4uqv_qpcrByskNvvW1",
        "source": "3DJuegos",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS5LV_hdWzY-suftbx6omDTvx21lflPXeIRtc5HjJs9OqZd3J-2",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS5LV_hdWzY-suftbx6omDTvx21lflPXeIRtc5HjJs9OqZd3J-2",
        "rank": 55,
        "global_rank": 55
      },
      {
        "title": "¿Cuánto dinero genera Youtube? Por primera vez desde que ...",
        "link": "https://www.infobae.com/economia/2020/02/04/cuanto-dinero-genera-youtube-por-primera-vez-desde-que-compro-la-empresa-google-dio-cifras-de-su-sitio-de-videos-estrella/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDJSoti_tDfiR_vuZSDA_MJ_IjYOOlEmN7SbCZfohWPjZ_7d8VVr2r2xFglMDSqxYoST6tmoMREWvo1ShnVcRLcth-da1-O4UZ7xomdiLQCc_YdRs",
        "source": "Infobae",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQINP_FiwMrIzkRSoE_zj6e0foYKcekJ6zxWiL5EKcwIRUxvwtV",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQINP_FiwMrIzkRSoE_zj6e0foYKcekJ6zxWiL5EKcwIRUxvwtV",
        "rank": 56,
        "global_rank": 56
      },
      {
        "title": "Tutorial: ¿Cómo hacer para que YouTube siempre me avise ...",
        "link": "https://www.youtube.com/watch?v=Dcl7XDJeFdw",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSNIr-THYZRUQIpMuyoK0WjonB4jWMFW9YXOH5WuCpUqc5dm9k7",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSNIr-THYZRUQIpMuyoK0WjonB4jWMFW9YXOH5WuCpUqc5dm9k7",
        "rank": 57,
        "global_rank": 57
      },
      {
        "title": "Videos - Springdale FWB - Springdale Free Will Baptist Church",
        "link": "https://www.springdalefwb.org/videos.html",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRqfiy0VdOS4lUakqCu5N8oAxk1lHi2UaYOIXQHAKeXimo0wfiqsUhsC8W74MzgM1uVP4A1OfEYMAxluM5HZzWfyPpD_RblP2GNnRHVxUFnREbuqPZT2UY4gw4",
        "source": "Springdale Free Will Baptist Church",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQnoUBdcMizJv-JxXxIQAVVUTuZKps3gGr-K2riQiHI58po0zMW",
        "rank": 58,
        "global_rank": 58
      },
      {
        "title": "Youtube Live Streaming – Varvid",
        "link": "https://varvid.com/broadcast-platforms/youtube/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRt9iyy-3-IW5iqOAYPaXafEUkma3FFNpyZ975Llg6NySgv6jDhL0aC_yGcYyedQxEPrACxZiQcVikTSGJKfEPFpCr0bG55riarTKeEvAGH",
        "source": "varvid.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFA-6rv6huR7t2LS2ELkPJV7iQ2AM5sC6GCwWtvL37ACe-Sm9T",
        "rank": 59,
        "global_rank": 59
      },
      {
        "title": "How to Make a YouTube API Call? - DEV Community",
        "link": "https://dev.to/cyanspray/how-to-make-a-youtube-api-call-13nn",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSQRYRjo6rRDeEwOaYrr8zfImMVmlI3BXXupnqDJb9APJUNVXQUR_ECPJEd7MrgNMDi2ZkWz2U7Ukg8DNNNK2HaNLsmHqhhaPiKpi4",
        "source": "DEV Community",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSTtMgLcdFtkbexCqPOGOD6z8hnKY18bw5PNXmFT4mXItLYMVfw",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSTtMgLcdFtkbexCqPOGOD6z8hnKY18bw5PNXmFT4mXItLYMVfw",
        "rank": 60,
        "global_rank": 60
      }
    ]
  }
  ```
</ResponseExample>


# Upload file
Source: https://docs.brightdata.com/api-reference/serp/google-lens/upload-file

Configure the Bright Data Google Lens Upload File parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```sh theme={null}
curl -k -F "encoded_image=@cat.jpg" \
  --proxy brd.superproxy.io:44445 \
  --proxy-user "brd-customer-CUSTOMER_USERNAME-zone-ZONE-NAME:CUSTOMER_PASSWORD" \
  "https://lens.google.com/v3/upload"
```

## Parameters

<ParamField type="file">
  The image file to upload for Google Lens search (e.g., `cat.jpg`).
</ParamField>

<RequestExample>
  ```sh Native proxy theme={null}
  curl -k -F "encoded_image=@cat.jpg" \
    --proxy brd.superproxy.io:44445 \
    --proxy-user "brd-customer-CUSTOMER_USERNAME-zone-ZONE-NAME:CUSTOMER_PASSWORD" \
    "https://lens.google.com/v3/upload"
  ```

  ```py Python theme={null}
  import requests

  url = "https://lens.google.com/v3/upload"
  proxy_url = "http://brd-customer-CUSTOMER_USERNAME-zone-ZONE-NAME:CUSTOMER_PASSWORD@brd.superproxy.io:44445"

  proxies = {
      "http": proxy_url,
      "https": proxy_url,
  }

  # Opening the local file 'cat.jpg'
  files = {
      'encoded_image': ('cat.jpg', open('cat.jpg', 'rb'), 'image/jpeg')
  }

  # verify=False mimics the -k (insecure) flag in curl
  response = requests.post(url, proxies=proxies, files=files, verify=False)

  # Save the JSON response
  with open("response-2.json", "w", encoding="utf-8") as f:
      f.write(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "general": {
      "language": "vi-MZ",
      "mode": "search",
      "type": "all"
    },
    "tabs": [
      {
        "name": "Chế độ AI",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&udm=50&vsrid=CLaIsa2N3ajiJBACGAEiJDU2MThkODM5LWY2NDItNDVhZi04NjlmLWM3NjM0ZGNlODhhMTIGIgJ3ZSgQOI7_me6YkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEJgFGOkDJQAAgD8&lns_mode=un&source=lns.web.ukn&vsdim=664,489&gsessionid=WUJuhv7x0JMKXLsFwcKDV6Ufy323c9CGeknNum_eaJqe2RR6hs2IDw&lsessionid=lDdJjKQ3-v9Qr28WxvUl4h8jWEzdn5R6D-_FG9QyXNUgnJJgrnWlHA&fbs=ADc_l-ZfYqvb1LHQ3Tukr-_BxDE0X-Uvzm4xOB4VvS95wD_MPW-mtjKIHr8wde7qnTyuHHpMrqvxJBudekBp9hzzuzgReN80u3GBIQEsa88i1Ahyl7M4t-xwaIWYVAn2ltCAjbrUccfafxAU7uZFk9XKyx1gCwBqL2OtYXhOaw3bPgjXo8jmKBE&q=&aep=1&ntc=1&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ2J8OegQIDxAD"
      },
      {
        "name": "Tất cả",
        "type": "all",
        "selected": true
      },
      {
        "name": "Kết quả khớp chính xác",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&udm=48&vsrid=CLaIsa2N3ajiJBACGAEiJDU2MThkODM5LWY2NDItNDVhZi04NjlmLWM3NjM0ZGNlODhhMTIGIgJ3ZSgQOI7_me6YkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEJgFGOkDJQAAgD8&lns_mode=un&source=lns.web.ukn&vsdim=664,489&gsessionid=WUJuhv7x0JMKXLsFwcKDV6Ufy323c9CGeknNum_eaJqe2RR6hs2IDw&lsessionid=lDdJjKQ3-v9Qr28WxvUl4h8jWEzdn5R6D-_FG9QyXNUgnJJgrnWlHA&vsrid=CLaIsa2N3ajiJBACGAEiJGY3MzEzYmYwLTFmMWMtNDkwYi04ZDMzLTU2YjYyZGM5MjM3YTIGIgJ3ZSgQOI7_me6YkpMDUAA&q=&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQs6gLegQIEBAB"
      },
      {
        "name": "Hình ảnh trùng khớp",
        "type": "visual_matches",
        "link": "https://www.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&udm=44&vsrid=CLaIsa2N3ajiJBACGAEiJDU2MThkODM5LWY2NDItNDVhZi04NjlmLWM3NjM0ZGNlODhhMTIGIgJ3ZSgQOI7_me6YkpMD&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEJgFGOkDJQAAgD8&lns_mode=un&source=lns.web.ukn&vsdim=664,489&gsessionid=WUJuhv7x0JMKXLsFwcKDV6Ufy323c9CGeknNum_eaJqe2RR6hs2IDw&lsessionid=lDdJjKQ3-v9Qr28WxvUl4h8jWEzdn5R6D-_FG9QyXNUgnJJgrnWlHA&q=&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQs6gLegQIExAB"
      },
      {
        "name": "Thông tin về hình ảnh này",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAFPy5HLn2NaxcW3v3RWPVASYJBiVVEzNDC1SLIwtddPMTIx0TUwT03QtzCzTdJPNzYxNUpJTLSwSDY3YlJjKUzUELPr-z3w3Y9Jk5gAGAGCc-FhLAAAA&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQs6gLegQIERAB"
      }
    ],
    "images": [
      {
        "title": "Cat Breeds and Their Characteristics | L&L Info Hub – Lords ...",
        "link": "https://www.lordsandlabradors.co.uk/blogs/journal/cat-breeds-and-their-characteristics",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Lords & Labradors",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      },
      {
        "title": "Samuel Arnold Lion",
        "link": "https://arnoldlion.com/kittens/samuel",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Arnold Lion Cattery",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 5
      },
      {
        "title": "Maine Coon Cattery Argentina | Buenos Aires",
        "link": "https://www.facebook.com/bbcattery/?locale=pt_BR",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Facebook",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 6
      },
      {
        "title": "Gatinho Maine Coon Red Tabby Bicolor | Foto Premium",
        "link": "https://br.freepik.com/fotos-premium/gatinho-maine-coon-red-tabby-bicolor_31031132.htm",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Freepik",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 4,
        "global_rank": 7
      },
      {
        "title": "He's such a proper gentleman! : r/mainecoons",
        "link": "https://www.reddit.com/r/mainecoons/comments/1ivs3oe/hes_such_a_proper_gentleman/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 5,
        "global_rank": 8
      },
      {
        "title": "Carina cats",
        "link": "https://www.instagram.com/reel/DT3GLXQiHVr/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Instagram",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 6,
        "global_rank": 9
      },
      {
        "title": "Light Orange Maine Coon Kitten Laying Stock Photo 411860023 ...",
        "link": "https://www.shutterstock.com/image-photo/light-orange-maine-coon-kitten-laying-411860023",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Shutterstock",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 7,
        "global_rank": 10
      },
      {
        "title": "Adopting a cream silver maine coon cat",
        "link": "https://www.facebook.com/groups/406917014031585/posts/1235952737794671/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Facebook",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 8,
        "global_rank": 11
      },
      {
        "title": "大家好像都蠻喜歡紅銀虎斑🤔🤔 但我還是偷站銀黑虎斑一票😂",
        "link": "https://www.threads.com/@lucien_mainecoon/post/DS60jTfksLC/%E5%A4%A7%E5%AE%B6%E5%A5%BD%E5%83%8F%E9%83%BD%E8%A0%BB%E5%96%9C%E6%AD%A1%E7%B4%85%E9%8A%80%E8%99%8E%E6%96%91%E4%BD%86%E6%88%91%E9%82%84%E6%98%AF%E5%81%B7%E7%AB%99%E9%8A%80%E9%BB%91%E8%99%8E%E6%96%91%E4%B8%80%E7%A5%A8",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Threads",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 9,
        "global_rank": 12
      },
      {
        "title": "Here is Jadzia : r/mainecoons",
        "link": "https://www.reddit.com/r/mainecoons/comments/1bub4rt/here_is_jadzia/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Reddit",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 10,
        "global_rank": 13
      },
      {
        "title": "Фотогалерея – Питомник котов",
        "link": "https://mainecoonsintengel.com/%D1%84%D0%BE%D1%82%D0%BE%D0%B3%D0%B0%D0%BB%D0%B5%D1%80%D0%B5%D1%8F/",
        "logo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "source": "mainecoonsintengel.com",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 11,
        "global_rank": 14
      },
      {
        "title": "kefir | Kitties",
        "link": "https://www.missmainecoon.com/kefir",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTi1oDj6Fuxl44i1zoZulsdc_WTg7gdWqBdDrzXkV5nDD2Vy7f2_AbymlYEjjgEQN30rQjWWotfKt_xDsrRndEaV2WF3QEabRzxOIgqhCpcvmPNpxAt1xyr-Ok",
        "source": "missmainecoon.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpBw_v4WdkaXx8-nouGx2jBjyZnhx2pLK43Tez49pFS11r6Alx",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpBw_v4WdkaXx8-nouGx2jBjyZnhx2pLK43Tez49pFS11r6Alx",
        "rank": 12,
        "global_rank": 15
      },
      {
        "title": "Maine Coon - Người Bạn Bốn Chân Khổng Lồ - Pet House - Cửa ...",
        "link": "https://pethouse.com.vn/maine-coon-nguoi-ban-bon-chan-khong-lo/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcR99I1MiUPQYOMjUOL4XZH-gAU9xrv7LHNzEosnnBue-Pjxc_A9kcm2fFsWeXbciZfWLWUzFb-EgFhenNa423sysObYfNLYBNU0N09cFvzdyw9S2jA",
        "source": "pethouse.com.vn",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTklJc6P_z7aE_lGoWnnjC00OkXF3MikzfgiFjc_hkNETbxOsHd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTklJc6P_z7aE_lGoWnnjC00OkXF3MikzfgiFjc_hkNETbxOsHd",
        "rank": 13,
        "global_rank": 16
      },
      {
        "title": "Veterinary Clinic Shows Off 'Biggest Cat They've Ever Seen ...",
        "link": "https://www.yahoo.com/lifestyle/articles/veterinary-clinic-shows-off-biggest-153000861.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ98tQHFQS3n7QHqC7pmpE-1Z-UlH70Xakqp_talW_6584HsAJbQSpaXQuXSvIGnmhrnpeqIsZGvSvSm6DfJQ3SyRT60SFIdZnZ1XwLf-UtO1Hj",
        "source": "Yahoo",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQsjtW-xkRyKfOdimg1GrJPYXoQT7ddg5EqYbuAwuGbyBf_kAtk",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQsjtW-xkRyKfOdimg1GrJPYXoQT7ddg5EqYbuAwuGbyBf_kAtk",
        "rank": 14,
        "global_rank": 17
      },
      {
        "title": "Vom Dattelner Meer - Maine Coon Cattery",
        "link": "https://www.vom-dattelner-meer.de/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSIiIl8YfgA596O3F7M9CyObkhxEpuylB_DFOu_dSMpNzHn7G3m7ctaFX3bxzMuRkri2A-8Fp10me66-6q0VHRk4O9dEJ-w9pqb1A98ieETLeE6dxIRDZmchU2V_1Rm",
        "source": "Vom Dattelner Meer",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT2KXnPmJnIU_Cll4SPTbP_96XUVUtylLXoQgE_n8Cj6VOm2xNn",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcT2KXnPmJnIU_Cll4SPTbP_96XUVUtylLXoQgE_n8Cj6VOm2xNn",
        "rank": 15,
        "global_rank": 18
      },
      {
        "title": "Photo gallery :: WildNfluffy",
        "link": "https://www.wildnfluffy.com/photo-gallery/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQl9uFsvTCsVxrIaORywqmHIuKE_SI7CTEzoU6gjhhwkUbGxu2lC25h1zRsTrkJo8WLjg99NTRrswGrOp4rXR0eQV8_sGFE9wVJNkjCGB42wqmM83-0NOQe",
        "source": "WildNfluffy",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSo-21X0krB_TXVsV-agzxxsxyjPRgNj9aq5VAKlp8yx3i25Kqq",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSo-21X0krB_TXVsV-agzxxsxyjPRgNj9aq5VAKlp8yx3i25Kqq",
        "rank": 16,
        "global_rank": 19
      },
      {
        "title": "Kastraten – Maine Coon vom drei Galgenberg",
        "link": "https://vomdreigalgenberg.de/kastraten/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRQHx4CQqvaBc4LF-o_oG9Y1ixpMo5DaeBpnWHb27FvCY9z9rzEy6eFC2CVOEaQQwhx5ng7_VYS8cWIrs-nPwOhewXXOJx24_4zgG8vI1N4AaofS4X0sM_4AA",
        "source": "Maine Coon vom drei Galgenberg",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTFpkb29cq_AgrHYqqZV_ocdgWgy3c9tbscDUyQkkimsbGPToGX",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTFpkb29cq_AgrHYqqZV_ocdgWgy3c9tbscDUyQkkimsbGPToGX",
        "rank": 17,
        "global_rank": 20
      },
      {
        "title": "The Cat Market",
        "link": "https://www.petage.com/the-cat-market/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSieb7w70lzy65clVXWGqqGSZ-LVtMgL6LZKkfwEYgq2YKOi77Xx53w0uqGKulHsvpWB2Y0xmpwcvXgecSeuH6mZhti-dqaYLJr6krW0UZRaMGRbw",
        "source": "Pet Age",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTsdSgtilRi0CVU9rhjVorgst-I_AtjIdsxCCryvXMID9zy_QVD",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTsdSgtilRi0CVU9rhjVorgst-I_AtjIdsxCCryvXMID9zy_QVD",
        "rank": 18,
        "global_rank": 21
      },
      {
        "title": "STARKS EDMOND — Starks",
        "link": "http://starkscoon.ru/gallery/starks-edmond/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSxM7a1CsnrWHQLeS0q652KjbJFF3ZrGDKscukFsuzoVaUNVSJLqmNPBJFbFI6ho_QAMFTdlQo6o3wGZ9jhfiiKPn1vdpIliYfu-z_AauT0QHM",
        "source": "starkscoon.ru",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS7lApLQryXfLr4qUJPlBO9GD4mdbpRT9WLIuid6G3JHXEp2-Fj",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS7lApLQryXfLr4qUJPlBO9GD4mdbpRT9WLIuid6G3JHXEp2-Fj",
        "rank": 19,
        "global_rank": 22
      },
      {
        "title": "Ginger Cat Sleeps On Pile TextileẢnh có sẵn2496921573 ...",
        "link": "https://www.shutterstock.com/vi/image-photo/ginger-cat-sleeps-on-pile-textile-2496921573",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQwdI3sb1idjasgpEajuGBarrfMhFwWbJceP1HmKLp9LB8NKtpVfuUo17r2zkDPmlw6QrBqa5Pauk8AHMTKtOxo2mv157Swt5427ca_0tkvot_JzOuLv-zNkQ",
        "source": "Shutterstock",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSA8oYXwNx1A4jV9GSv7cr7TRt-v4yt8fgMFFsvFNjeiNK1fNyF",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcSA8oYXwNx1A4jV9GSv7cr7TRt-v4yt8fgMFFsvFNjeiNK1fNyF",
        "rank": 20,
        "global_rank": 23
      },
      {
        "title": "TICA European Maine Coon Cat Breeder | Cattery",
        "link": "https://mainecoonkittens.com/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSAmjQiPVDAsiDIsT-tH9LAktJ53sdgQwhuMkTdsX3P-VoZViancxGDrtHdq7LgThwKqnf88l4xwvUAe3nJOAzIXXaeAUTz8FFCv-mZG8tk11ADpvCY6ofcNw",
        "source": "mainecoonkittens.com",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRBOFfs6E6vUJSUsHigj2luwKwtUmqEuMs2OyYdx-UdPfZ5veaL",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRBOFfs6E6vUJSUsHigj2luwKwtUmqEuMs2OyYdx-UdPfZ5veaL",
        "rank": 21,
        "global_rank": 24
      },
      {
        "title": "Remi (5) | Sandra Notenboom-Frencken | Flickr",
        "link": "https://www.flickr.com/photos/153127362@N07/26756503017/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTfrOu0sWKs3Pcw2QmgK3YJ56j2-ayOW-qRIJSQvaGvhVZy3tuULAELn-9WhCkJkgiSJmW8S2sgnoc74IbwPBg6aBaBJfMsZdN3QKOSPEQO0xq3oQ",
        "source": "Flickr",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYQeqYVBFq6qU5x4B-VqzWEniODoZmtVTrmJYQeAXVGM4hY7ty",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYQeqYVBFq6qU5x4B-VqzWEniODoZmtVTrmJYQeAXVGM4hY7ty",
        "rank": 22,
        "global_rank": 25
      },
      {
        "title": "LT*Šešuvos Brendis - BALTIC LYNX - Namine lusis",
        "link": "https://balticlynx.weebly.com/ltscaronescaronuvos-brendis.html",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcREbs6EwEX044DLm4uuSESOblHE_OP6DXiF3X-1oyzDtX9IUTpCXtMYlWyPvZiceP245PwUZ_NR0kpKbYp5shH1-6nYDzhOsAMqO9zfs2KIR2U6zbrbYUWjIRw",
        "source": "Weebly",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSKEpxjgeyXdR1gnr0dfhb0L7zEK7PdqJxE9SsYHCXWRXBmleKI",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSKEpxjgeyXdR1gnr0dfhb0L7zEK7PdqJxE9SsYHCXWRXBmleKI",
        "rank": 23,
        "global_rank": 26
      },
      {
        "title": "ELARA ECLIPSE MAINE COON CATTERY - Updated March ...",
        "link": "https://m.yelp.com/biz/elara-eclipse-maine-coon-cattery-pinehurst",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTMJbNJmAPdfKj5ih9ASLCbVCvZ1HdFNJLDlwoVMI6AJI9InCRbnDekwhO1QIBYzQ0DgkguT65-RKJGpPZn4x5Zr1jrsau2XRfsFlcSyqnD",
        "source": "Yelp",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQtrBbMI0rildJKuThv1wJREtJMuAJ-fXewoAJGazVf1xZGYjqb",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQtrBbMI0rildJKuThv1wJREtJMuAJ-fXewoAJGazVf1xZGYjqb",
        "rank": 24,
        "global_rank": 27
      },
      {
        "title": "Купить котенка породы Рэгдолл из проверенных питомников ...",
        "link": "http://zoonika.com/pitomniki/regdoll",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSdNWWb7TsMRYA5En4YMwBPgzxAKiBnqXwVnuHnSws1XnY5e_oz-YOHi0JSgmUa-n7S2EVtkCDKSk4cCaZah-5PVvbW7m0D8OLV1mxL-tCI",
        "source": "Зооника",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTROyBIIZD93Sq8Q097C86zViUA96dVoCA2Ct31nCzVTQnGTomz",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTROyBIIZD93Sq8Q097C86zViUA96dVoCA2Ct31nCzVTQnGTomz",
        "rank": 25,
        "global_rank": 28
      },
      {
        "title": "Maine Coon Fleece Blanket by Joachim G Pinkawa - Fine Art ...",
        "link": "https://fineartamerica.com/featured/maine-coon-joachim-g-pinkawa.html?product=fleece-blanket",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQDwpYAYqn3EBF7tk14LrzU-6oVXH9tDyHifIHLcDe-g-Vp3eY6oGA-iJQiD7-_7GD-xuDMSsgXtmDxPRfnZ9ptcLVyhoHIl4NQeQppRIEV4diQfx-Gdf4",
        "source": "Fine Art America",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR0IdmvPJQlJ1Oyk1tYqGogVQP1jrqKD899DMopCtxtOGuiZ8Na",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR0IdmvPJQlJ1Oyk1tYqGogVQP1jrqKD899DMopCtxtOGuiZ8Na",
        "rank": 26,
        "global_rank": 29
      },
      {
        "title": "Les Sentiers Sauvages - Elevage familial de Maine Coon",
        "link": "https://www.ckc-net.com/creation-site-web/les-sentiers-sauvages",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRfLfP8CXklJKr02UIN0KiCFbgTE8fwedBZThB2744Gp1NxnkYUolGJIuv5Pj2Tox-ezEL7kzK5DytdVAZYKjqQzoI3vwYQrp823QoTmMNRwtrCRM4",
        "source": "CKC-Net",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRrkW8fPsP_lFuIgESpuBYcnwwtDildK8WAC45tq-7BSzJ2ulex",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRrkW8fPsP_lFuIgESpuBYcnwwtDildK8WAC45tq-7BSzJ2ulex",
        "rank": 27,
        "global_rank": 30
      },
      {
        "title": "Maine Coon Adventures Live! - YouTube",
        "link": "https://www.youtube.com/watch?v=V_L03xdRpDM",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQHQslzHLLyLc_qne5jxn7JocidlmUPyegZ8ojX3WVlorFk8BxW9a3vJWjDzN99UHVTqSaNBj_-6XykhxuVQfF3Ye7xScSWSuc2QHXi0a12CkVwBmo",
        "source": "YouTube",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpyBFPZErIfFp1ov73KSTWFZyXSXOSbXpfhoZ5Nn9nWAPqgTwe",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQpyBFPZErIfFp1ov73KSTWFZyXSXOSbXpfhoZ5Nn9nWAPqgTwe",
        "rank": 28,
        "global_rank": 31
      },
      {
        "title": "American Bobtail Tea",
        "link": "https://www.adagio.com/signature_blend/blend.html?blend=232279",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcS3fFVdB-VNMS6SBFUCZ4wi1x2NSU9S6sGVyJkgsPtApVouB4_g2LZfUEBztW-NoWAhpMTLyNFOrKoH1F9CkehM4PRYBUCTOn-qXKnqMbeIbUYCvQ",
        "source": "adagio.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS4rBaFHGnRZxlwAtAEraaKqf2hWcBxolTLl0I-f2v7n4toZxzh",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS4rBaFHGnRZxlwAtAEraaKqf2hWcBxolTLl0I-f2v7n4toZxzh",
        "rank": 29,
        "global_rank": 32
      },
      {
        "title": "Mèo Maincoon màu Kem mã MC1774 - Pet House - Cửa hàng thú ...",
        "link": "https://pethouse.com.vn/san-pham/meo-maincoon-mau-kem-ma-mc1774/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcR99I1MiUPQYOMjUOL4XZH-gAU9xrv7LHNzEosnnBue-Pjxc_A9kcm2fFsWeXbciZfWLWUzFb-EgFhenNa423sysObYfNLYBNU0N09cFvzdyw9S2jA",
        "source": "pethouse.com.vn",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQeDIGQhXlC4DsLxb06_ItW9nyivGa_4wtfXK72L8nrtMPr8rOD",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQeDIGQhXlC4DsLxb06_ItW9nyivGa_4wtfXK72L8nrtMPr8rOD",
        "rank": 30,
        "global_rank": 33
      },
      {
        "title": "Geriatric Care for Senior Dogs & Cats in Rancho Cucamonga",
        "link": "https://www.ranchovet.com/site/veterinary-services-rancho-cucamonga/geriatrics",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQnf_X15t0JgJLFc7OIAVFuDLn2Ti3VDrhRY0c9qRrd0al4rzxDUS-Nrhq8bwHd5VPNLxdtJHBcObw9crihLAa50TQ0HH6UWNGgJtdR1FvHtwnxG1MHzQ",
        "source": "Rancho Regional Veterinary Hospital",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRt-zNv90rUbD9roBd9tSrqE1V8QOz4Qg6PtoWfLDizCv9JhNO3",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRt-zNv90rUbD9roBd9tSrqE1V8QOz4Qg6PtoWfLDizCv9JhNO3",
        "rank": 31,
        "global_rank": 34
      },
      {
        "title": "Mom Cats | Maine Coon NY",
        "link": "https://mainecoonny.com/mom-cats",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSb8751R8664h1wRIV8OSf0JEzM1uxNMwzohG611JAzg_Ww6vglo2j8oh7WrS2PEL5MLSzFXZlOB3-iRUiiTZh0XfS0OowJ6Etj9sfjZ9pmrSvqH3w",
        "source": "Maine Coon NY",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpDO8sk53goOtLUu3K1o4-19vYM3AgRaz1YFwuWkVCIOcfI_ei",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRpDO8sk53goOtLUu3K1o4-19vYM3AgRaz1YFwuWkVCIOcfI_ei",
        "rank": 32,
        "global_rank": 35
      },
      {
        "title": "Nos males - La tour d'Eden",
        "link": "https://www.latourdeden.net/nos-males",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTJ3kL3zAcJplRzS4ESf_Usw3z6HjbPYH5hAmuU8YO7HcADajdJoE92QErCkJbqyJuEKkbw8biwGCfLlMFfv71jZ52dYs1zqDdhLhLnhHGfLJAOkYy1ePvy",
        "source": "La tour d'Eden",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDX5poFdpjh6Pm0cf3RUZQnRNk2WjzKx01U8hPdt9zNpQJYpOq",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDX5poFdpjh6Pm0cf3RUZQnRNk2WjzKx01U8hPdt9zNpQJYpOq",
        "rank": 33,
        "global_rank": 36
      },
      {
        "title": "Photo de votre animal - Studio Louise Mary",
        "link": "https://www.studiolouisemary.com/prestation/animaux/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTp__S8oPDCwLjz5RTYLnxB5sacyiWhHDOdHblknqRjiD0NneFPNIhTLh1wU00vUW54DHPP2HhgpylaxANCQyD0AVYoX2JWmxsXBT3AvNL4uXNUbNJ3cq-7YPHkrpk",
        "source": "Studio Louise Mary",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRKM0GZM2G-Hl4nDTP0JHVlIho5I-IMVG2ssdeB7IixZ351nRwH",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRKM0GZM2G-Hl4nDTP0JHVlIho5I-IMVG2ssdeB7IixZ351nRwH",
        "rank": 34,
        "global_rank": 37
      },
      {
        "title": "Maine Coon Cat's Persistent Way of Demanding Treats Is ...",
        "link": "https://paradepets.com/pet-news/maine-coon-cat-persistent-way-demanding-treats-on-point",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQUrf3qSBiZG-yhrsTbmR9akt3A1UR82dgfZv-j7l0vvT2ErjoGqohREU8VzqWxVY0U36KjFroQNlRZdOqPLv9GnOEQYcRLim3ZnlAFwE4Ruq6Acg",
        "source": "ParadePets",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQKlmwdqB6y3rzTHz7Aa3EiyrAhRXmXJIEPXxkaJuGgdW0c4zQb",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQKlmwdqB6y3rzTHz7Aa3EiyrAhRXmXJIEPXxkaJuGgdW0c4zQb",
        "rank": 35,
        "global_rank": 38
      },
      {
        "title": "Le Coonoahope Shana - Chat Maine coon polydactyle Loiret",
        "link": "https://www.mainecoonchaton.com/maine-coon-polydactyle-shana",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcR55ompJ6QjCEoyBrv77-5Spcb73mfvYop9spKBH4n8KbvSTY0msHwRxGnma2-Ri7UWQOc0fsBJmiS_1NZQHEjpd0jI26Yj686piPy24yRqIWkjC99mK6v1YfAwfg",
        "source": "www.mainecoonchaton.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSqVsEp3YL3w_rWKAJcOgWNsHbp8Hki1eaA0cEXLUqoGQMZxHGQ",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSqVsEp3YL3w_rWKAJcOgWNsHbp8Hki1eaA0cEXLUqoGQMZxHGQ",
        "rank": 36,
        "global_rank": 39
      },
      {
        "title": "Coonattack Maine Coon Cats",
        "link": "http://www.coonattack.de/Galerie/Galerie.htm",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcQVuA4YKgp3DjvGOi9XgIiHZZFtaTLxXZK-uXJwJapYHiMKXMviMsnZcxa3vy2OVvTNfmeACwilr906ZSkAxXBB2UrCYCz_mavD1I0Y397zsug6347J",
        "source": "coonattack.de",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTHA4PWqxGBDB_xdTkU0iytV8secxQnY8WzTGKbKyxmVf5AtCyB",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTHA4PWqxGBDB_xdTkU0iytV8secxQnY8WzTGKbKyxmVf5AtCyB",
        "rank": 37,
        "global_rank": 40
      },
      {
        "title": "Mèo Maine Coon: Những Người Khổng Lồ Dịu Dàng Nước Mỹ",
        "link": "https://nhapet.com/meo-canh/meo-maine-coon/",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQ1XoP7YDmYBSbqh8Xr9oxNh2SvBQCKovZrEIFFwJwJQaUiBxJCrHb0m-x-tOY3udkSyq0Smbw-0DObZIct9WxAOQI-KAB8U93Q6ytjYOs0",
        "source": "nhapet.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRmUbHLV3PL1GxokRP6w3wdalL-zHmGOooQoSYwXTrfUut9bib0",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRmUbHLV3PL1GxokRP6w3wdalL-zHmGOooQoSYwXTrfUut9bib0",
        "rank": 38,
        "global_rank": 41
      },
      {
        "title": "Thutmosis",
        "link": "http://www.of-juja-tuja.de/index.php/34-news/231-thutmosis",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcTIn2ie3oouVxOQjNlLfQjguYL9xYjFc5qbL4Sa2-4aX8HGH5Ur-V-FlSy5l8EwjvFgKAwrOFl5qz-NmA5alEcfYtuSXhdBC3rYGEkYSKGcCfIM43jYsWQ",
        "source": "of-juja-tuja.de",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS7pT04WtJKlLunMEMB4wQqxydXdcoTaZSaBlrbvApeDYVhE_Cd",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcS7pT04WtJKlLunMEMB4wQqxydXdcoTaZSaBlrbvApeDYVhE_Cd",
        "rank": 39,
        "global_rank": 42
      },
      {
        "title": "XXL Maine Coon Kater Alex of Maine Coon Castle",
        "link": "https://www.maine-coon-castle.de/xxl-maine-coon-kater-alex-mcc-cats/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRdZwEsk0itLNiuD9wO1Fg9Y36uUSlxsJeCZEDKTYHzNQs3bt5QDDAzEaT3DotArbnvWUOjpUfwgSkwnzPpByEBcVF2NyKJ0uNNJNz6KgfDP0oJm0BXgkoBa1as9wA",
        "source": "Maine Coon Castle",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTIufIWj-g-O2pF4FLAoFLdvK79g2lBARkQaFl3TLnOq-nUMNvC",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTIufIWj-g-O2pF4FLAoFLdvK79g2lBARkQaFl3TLnOq-nUMNvC",
        "rank": 40,
        "global_rank": 43
      },
      {
        "title": "Our Available Kittens | Aristocoon Cat",
        "link": "https://www.aristocooncat.com/our-available-kittens-1",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTVsL-tSdCbppraBcdDdRvkytD6p6QcRD3RZpvRVDiA_6pqYQtxZiDe7T8wO0GBgN7ddHnCseDCt2OPy3dz_3AOqL4Kht1qLH71TWQBgVDhvxWD50s6xVNwndI",
        "source": "Aristocoon Cat",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSN6556UnvhfkWDrh8yTHwpI6UuTs-wgPMVliJjNlqBszYnvkR9",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSN6556UnvhfkWDrh8yTHwpI6UuTs-wgPMVliJjNlqBszYnvkR9",
        "rank": 41,
        "global_rank": 44
      },
      {
        "title": "Pets | Chipperton Photography | O'ahu, Hawaii",
        "link": "https://www.chipperton.com/miscellaneous",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTh4y6sPQjksnsKM9IWhmiL952V2nkZbn3xzxXlA06J2eoNrYFnUIl5xRVNPfuqF4MOBp6kCDTG7zw03m_1kKyREjpux0h2ZCn8uVtrEgWFrutRQXoIjOU",
        "source": "Chipperton Photography",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRxj1r00B-N0vupC_pCybkL0LA56-SWZFHpBLWzYDO5Z8D01Ph1",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRxj1r00B-N0vupC_pCybkL0LA56-SWZFHpBLWzYDO5Z8D01Ph1",
        "rank": 42,
        "global_rank": 45
      },
      {
        "title": "无敌了！全国发货凯米尔色白色大脚银虎缅因猫幼崽，萌化你的每 ...",
        "link": "https://goods.taobao.com/t/_4423/ddaf7c84699233fbff139e745f548085.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSeX25HcG4yQvnattuo8Ozi_yupe789ZUwKcK5BE8n_6WupRZoDBIIJwewsIoVi5PDhQ6Q7wASvEw2nLJiHdp7E26KkdodogchMguC1wXPWNKA5PWBp",
        "source": "Taobao.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-7cbCCsvzc4nGQLQ3eFIvSkAS97eK_IzqnHSyPnp_HZvk0Kle",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcS-7cbCCsvzc4nGQLQ3eFIvSkAS97eK_IzqnHSyPnp_HZvk0Kle",
        "rank": 43,
        "global_rank": 46
      },
      {
        "title": "Lenne (2019-2023) - Welkom bij Maine Coon Cattery AsKháMo",
        "link": "https://www.askhamo.com/in-memoriam/lenne-2019-2023/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT9eNhZpVoNF9TX62CROQDwShP00V3zPol_e3DE2sR7eXkTcCQaK1iVUETp4mNTuVDFup1_QqON_g-gVLOIjeA5OeDuSTNXe2I5PMmiDT_1ReM8QhU",
        "source": "askhamo.com",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRw4nLD4sV87-GdI-f1dkGHAQmV0G4t0uLQNlKnNSuanSu0bl-c",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRw4nLD4sV87-GdI-f1dkGHAQmV0G4t0uLQNlKnNSuanSu0bl-c",
        "rank": 44,
        "global_rank": 47
      },
      {
        "title": "Red Tabby Maine Coon Kitten Stock Photo - Download Image Now ...",
        "link": "https://www.istockphoto.com/photo/red-tabby-maine-coon-kitten-gm528976532-93176983",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcTOkSla3xBgSGY8Vxv3HRJORoHcom_0Lnxa4c9OyARUS6iOZa2CuyO7HRMfIn2Nkn3CbNnVyyX9pi45q3fZlr9Qfs6UX7FLxq_TAfsr6fWeezQZfSQGhVc6",
        "source": "iStock",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTS9WTUN3QQeNXryN1Idqh1MhtDm7rndJni9qJRYySBsdgsgXOR",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTS9WTUN3QQeNXryN1Idqh1MhtDm7rndJni9qJRYySBsdgsgXOR",
        "rank": 45,
        "global_rank": 48
      },
      {
        "title": "maine coon kitten mainecoon hobbyzucht aus hamburg",
        "link": "https://mainecoon-hamburg.de/deutsch/kitten_w.php",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcT6qmfYzy3fdQze-zbrvVnC_hW0fJPOojQDXI-Q0bLiFWzH8VfgUUT3a0OH0JpYS5K9u67srGaYusuhIhF62Ex8TXPuaA0PGkC7fhe54d4Ubhi1vqu03cxiPQ",
        "source": "mainecoon-hamburg.de",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT6jA4weIxUtUUb_juOozkdcChf7Km_yD2bEvsMnSJq6r5STtOx",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT6jA4weIxUtUUb_juOozkdcChf7Km_yD2bEvsMnSJq6r5STtOx",
        "rank": 46,
        "global_rank": 49
      },
      {
        "title": "Majestuoso Timon cada día más bello ♥️ @timonypumba_coon ...",
        "link": "https://www.instagram.com/p/C9GmdpityDA/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSpoKX-MM8KwYvjLm-JRx4G0Kwl8RLkE48NjkNQo2Gq3SC32GSp-nb0Bv1Gwdg0bIZuT7qIQcsQnlAbeKhfDsUARVp1OzzHay_AKGuFGTR9Of3S2pacaw",
        "source": "Instagram",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKGbJYHXBHZNP5eMes_8jjWd77rcBOpWFYyAXWMo9UyzOcfruN",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKGbJYHXBHZNP5eMes_8jjWd77rcBOpWFYyAXWMo9UyzOcfruN",
        "rank": 47,
        "global_rank": 50
      },
      {
        "title": "Рыжий полосатый биколорный котенок мейн-кун ...",
        "link": "https://ru.freepik.com/premium-photo/red-tabby-bicolour-maine-coon-kitten_31031137.htm",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSsZFTTo1ow2OZzLRYRVvk-D-OkYsxjVIweSeVGTTzFNkyki7acUbAdBoGRnbaCuVTX8p0TxVZcFqx7ePsbSJNW-yvjy0DexoxlDoRK33YPs2CTZw",
        "source": "Freepik",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRcoHkAUREgVjIdHmLjSs45UOfSZUOuGlISYCyW3K6AbvspoVaM",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRcoHkAUREgVjIdHmLjSs45UOfSZUOuGlISYCyW3K6AbvspoVaM",
        "rank": 48,
        "global_rank": 51
      },
      {
        "title": "Padhington 🦁 Mainecoon on Instagram: “Do you think i could ...",
        "link": "https://in.pinterest.com/pin/cats--297659856627419519/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcSYpax9-23w3k55h5fvk6iCbcYzKnm1qjhMsJ1P4Bb4O6gI2DZH7bYpZ5seEAXynHj3p4A6cHFAP_wbQ2CvnQYaOUp6ihp29pqECCB1pKH0MRnuasA6",
        "source": "Pinterest",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRM9Fzsd21B4QBto1_ty0XKP5DdtfYAysfKBJq_WBjiFwp9IGeV",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRM9Fzsd21B4QBto1_ty0XKP5DdtfYAysfKBJq_WBjiFwp9IGeV",
        "rank": 49,
        "global_rank": 52
      },
      {
        "title": "AEON Mall Makuhari Shintoshin｜猫カフェ MOCHA(モカ)",
        "link": "https://catmocha.jp/vi/shop/makuhari",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcS1927I_9mTpD59EqW47-SXfE5O0gNFrhRzclxOWqO07FNK3BKJSCWT9FMTuzSozLm7nEiytbxW6lRaTEJGQOowgAzP0ITPDm1zYicyOSvIpg",
        "source": "猫カフェ MOCHA",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcThWx2c57dk4DQNxWSdxyAay20ry0okm-tsjVzMsfrOOlyvCP_8",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcThWx2c57dk4DQNxWSdxyAay20ry0okm-tsjVzMsfrOOlyvCP_8",
        "rank": 50,
        "global_rank": 53
      },
      {
        "title": "Here's my gorgeous 2 year old red silver Maine coon Morris",
        "link": "https://www.facebook.com/groups/mainecoonsuk/posts/541747411467992/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRv794zBOQO02ChHD5K_TnlJwwf8PThFmn58OZAhQnomqvb1XKnHGAk8BQDBcyXho53FvXtsB2eVFSimUAzH3zcBAPC_yfttm2gkn07x3UumIdkepR5",
        "source": "Facebook",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQMp2LgbEWtTjNQi6S35hXQ03X7hu7ak0SroK9S9lxRlufouit2",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQMp2LgbEWtTjNQi6S35hXQ03X7hu7ak0SroK9S9lxRlufouit2",
        "rank": 51,
        "global_rank": 54
      },
      {
        "title": "Choáng váng chú mèo khổng lồ to gần bằng người | Báo điện tử ...",
        "link": "https://tienphong.vn/choang-vang-chu-meo-khong-lo-to-gan-bang-nguoi-post1071249.tpo",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRCs_jSgp8oBD2KHVaMGzFUn-tld79q888hGrtpAjRYQFRselIgE1ta8ipmQJWjSKLih6spOjUXArSoXZ9YL_2p7CERcTrjROIxk0g-9Y3R9Fs",
        "source": "Báo điện tử Tiền Phong",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTYwBN8Bgs3VFk_hxs5qzNKMf9YVk4wSGrb9GUVW4AmK5b4TvAM",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTYwBN8Bgs3VFk_hxs5qzNKMf9YVk4wSGrb9GUVW4AmK5b4TvAM",
        "rank": 52,
        "global_rank": 55
      },
      {
        "title": "几元一斤和几十一斤的猫粮有区别吗，各有什么优缺点呢？_猫咪 ...",
        "link": "https://post.m.smzdm.com/p/a4xvzem8/",
        "logo": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcQiaRo_8LBdLeUqwHuU6NhcrDaA_MYP4SN4AKtM1QE2Jbfu3r_czS4NY6bzRAtLfBvZzGUjJUi7ox8k4Oqvakjfvv7LIQEIGfxm88r2bfSTe8BW5dGg",
        "source": "什么值得买",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTKiIKgPXzbgzLNSrqf9EenpYrCDo-VqucUCh6fG3zhbzYyiqlW",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTKiIKgPXzbgzLNSrqf9EenpYrCDo-VqucUCh6fG3zhbzYyiqlW",
        "rank": 53,
        "global_rank": 56
      },
      {
        "title": "Homepage - TapsiGiants",
        "link": "https://www.tapsigiants.com/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRXDc4ztHVARBzV6cn6aa5MwOxUMxxMHoV1Z5kIVaRojwwYHT0cLrs4Ql7835-Z-7lkZBShcjOAuEllRGejGaKpzUWtnCFoS7sSsL3tb-sZ2y96Pvb3eWlc",
        "source": "tapsigiants.com",
        "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRcDalsy-jbo-2G984rTmtvODNTN64W2uUeCseBP8_2JvDFhvsy",
        "image_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRcDalsy-jbo-2G984rTmtvODNTN64W2uUeCseBP8_2JvDFhvsy",
        "rank": 54,
        "global_rank": 57
      },
      {
        "title": "mèo Mỹ lông dài – RussiCat",
        "link": "https://meonhapkhau.com/tu-khoa-tim-kiem/meo-my-long-dai/",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcSEHCfO7o9Eh6BGAWjUj3xQZPda4bxgg-G6N46jWpjTilkO7ikFKHHXB93RjMOIf61rOsXyXQRgjec-VwzmIXrHjocXU-T1V74E5uLLBZObnGsQwiE",
        "source": "Mèo Nhập Khẩu",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQBFC31w8lZRVDaBO7V9EJKxdY5EXHNbHjnR0cE9scZuDM-9C4r",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQBFC31w8lZRVDaBO7V9EJKxdY5EXHNbHjnR0cE9scZuDM-9C4r",
        "rank": 55,
        "global_rank": 58
      },
      {
        "title": "Enjoy the wintersun | Georg Kohr | Flickr",
        "link": "https://www.flickr.com/photos/145593473@N02/33110211546/",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcTfrOu0sWKs3Pcw2QmgK3YJ56j2-ayOW-qRIJSQvaGvhVZy3tuULAELn-9WhCkJkgiSJmW8S2sgnoc74IbwPBg6aBaBJfMsZdN3QKOSPEQO0xq3oQ",
        "source": "Flickr",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRblVH-qXDE9QR4UT-yEKwFffj4jpbUE4D_ZZ1R1p1DJn6eeXOU",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcRblVH-qXDE9QR4UT-yEKwFffj4jpbUE4D_ZZ1R1p1DJn6eeXOU",
        "rank": 56,
        "global_rank": 59
      },
      {
        "title": "Maine Coon Special Agent Kociaki - Kittens Poland",
        "link": "http://specialagent.ewitar.com.pl/Miot2J/Jantar.htm",
        "logo": "https://encrypted-tbn3.gstatic.com/favicon-tbn?q=tbn:ANd9GcRrxqQ9kzIVkJJMg5ITcNlo-fZp9fv2yJmbjpUB6CcW1ilNY5UMoSPbryod1qTj0ldOgvFVFDSPunGnvVgY14qrPS1OUl5uazxUWfnzhd92thAFUWreINH9TO-xIhcu",
        "source": "ewitar.com.pl",
        "image": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcT0VaTEUX7IvXhl5m_ad3hkrPg7vhn2L3Vv2P8UmE9jSitmq695",
        "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcT0VaTEUX7IvXhl5m_ad3hkrPg7vhn2L3Vv2P8UmE9jSitmq695",
        "rank": 57,
        "global_rank": 60
      },
      {
        "title": "gunillanoren.se - Katter",
        "link": "https://gunillanoren.com/katter",
        "logo": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcSqiHFClCLWiBi_608fT9Nmcl1Z_4kSCLfFjH4U-GBRAF6bcryW4zDYpOTDjVZun4JdjUxf26bzvcsI4hMqa6oMPXuCTz3-vxXzUkye2Y50b93p24sR",
        "source": "gunillanoren.com",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSjNQdURmcLW2qEhmaKT4Kdj-zIna4jDCP3mR7Y7csFfD1UmdJm",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSjNQdURmcLW2qEhmaKT4Kdj-zIna4jDCP3mR7Y7csFfD1UmdJm",
        "rank": 58,
        "global_rank": 61
      },
      {
        "title": "Mèo Maine Coon - Vi Sinh Cá Cảnh Aquarium Care",
        "link": "https://aquariumcare.vn/san-pham/396/meo-maine-coon.html",
        "logo": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn:ANd9GcRj1qsON4rZlp8IQL3mgM-oMKzhEYbuo4O7N_jG7KpyTtjbnV0-gRyP371iuYwyPRJcKy7R52PQmzUtBULk5jpljUR_3h4QubPNQOHrrHR7G0XYlk8",
        "source": "Vi Sinh Cá Cảnh Aquarium Care",
        "image": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSXQ_-JMXW7wI30EhWPQaUoBqDTAkttv4gYoirHIMxHmch7I8nP",
        "image_url": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcSXQ_-JMXW7wI30EhWPQaUoBqDTAkttv4gYoirHIMxHmch7I8nP",
        "rank": 59,
        "global_rank": 62
      }
    ],
    "related_search": [
      {
        "title": "Maine Coon",
        "link": "https://lens.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&q=Maine+Coon&kgmid=/m/0j60j&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ9_gLKAB6BQiHAhAB",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 2
      },
      {
        "title": "Norwegian Forest Cat",
        "link": "https://lens.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&q=Norwegian+Forest+Cat&kgmid=/m/017fsk&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ9_gLKAF6BQiHAhAD",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 2,
        "global_rank": 3
      },
      {
        "title": "Siberian cat",
        "link": "https://lens.google.com/search?sca_esv=b5143ed2853990e4&lns_surface=26&q=Siberian+cat&kgmid=/m/02zkbf&sa=X&ved=2ahUKEwi4yqrvmJKTAxVLpCcCHdItHaYQ9_gLKAJ6BQiHAhAF",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 3,
        "global_rank": 4
      }
    ],
    "organic": [
      {
        "link": "https://www.shutterstock.com/vi/image-photo/ginger-cat-sleeps-on-pile-textile-2496921573",
        "source": "Shutterstock",
        "display_link": "https://www.shutterstock.com › image-photo › ginger-c...",
        "title": "Ginger Cat Sleeps On Pile TextileẢnh có sẵn2496921573",
        "extensions": [
          {
            "type": "text",
            "text": "25,00 US$",
            "rank": 1
          },
          {
            "type": "text",
            "text": "Còn hàng",
            "rank": 2
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSHT4y2V82d2E_Amw_Pb5olsPIM0fXjBKNoNCdCdKwXrPIRBw30VpiJ&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSHT4y2V82d2E_Amw_Pb5olsPIM0fXjBKNoNCdCdKwXrPIRBw30VpiJ&usqp=CAE&s",
        "rank": 1,
        "global_rank": 63
      },
      {
        "link": "https://www.adagio.com/signature_blend/blend.html?blend=232279&srsltid=AfmBOooatupRsGtMf2j9jKFWLSq5Eb3mnJ8HjA8gFmUiLD2p-BQjWOHg",
        "source": "adagio.com",
        "display_link": "https://www.adagio.com › blend",
        "title": "American Bobtail - Adagio Teas",
        "extensions": [
          {
            "type": "text",
            "text": "14,00 US$",
            "rank": 1
          },
          {
            "type": "text",
            "text": "Còn hàng",
            "rank": 2
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc0slC2GsD_mZoWif5P39bAvRqS3FU3qn_tw-kcSF15XFBPOyWn3ES&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSc0slC2GsD_mZoWif5P39bAvRqS3FU3qn_tw-kcSF15XFBPOyWn3ES&usqp=CAE&s",
        "rank": 2,
        "global_rank": 64
      },
      {
        "link": "https://www.facebook.com/bbcattery/?locale=pt_BR",
        "source": "Facebook · Maine Coon Cattery Argentina",
        "display_link": ">1,8 N người theo dõi",
        "title": "Maine Coon Cattery Argentina | Buenos Aires",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRcNsvubDFXpzAMnkde1xYoEWiTRpioJlIVKKAXvlCLQphQcBhKGe-S&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRcNsvubDFXpzAMnkde1xYoEWiTRpioJlIVKKAXvlCLQphQcBhKGe-S&usqp=CAE&s",
        "rank": 3,
        "global_rank": 65
      },
      {
        "link": "https://www.lordsandlabradors.co.uk/blogs/journal/cat-breeds-and-their-characteristics?srsltid=AfmBOor7hkIH6gq0ID2_xBa5Djyme-ejASOM4TwVlGW-kitWwDn39DQX",
        "source": "Lords & Labradors",
        "display_link": "https://www.lordsandlabradors.co.uk › ...",
        "title": "Cat Breeds and Their Characteristics | L&L Info Hub",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAMw4fY0rOUGp6r06qEJGgtJ7q1DIrzlm1WWZvP5s44PzKUyekUR4t&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTAMw4fY0rOUGp6r06qEJGgtJ7q1DIrzlm1WWZvP5s44PzKUyekUR4t&usqp=CAE&s",
        "rank": 4,
        "global_rank": 66
      },
      {
        "link": "https://www.yelp.com/biz/elara-eclipse-maine-coon-cattery-pinehurst",
        "source": "Yelp",
        "display_link": "https://www.yelp.com › biz › elara-ecl...",
        "title": "ELARA ECLIPSE MAINE COON CATTERY - Yelp",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRY5TAhcrYHlj7QWweaK-6EhkiGxEvHfmFHcA9Zm9E&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRY5TAhcrYHlj7QWweaK-6EhkiGxEvHfmFHcA9Zm9E&usqp=CAE&s",
        "rank": 5,
        "global_rank": 67
      },
      {
        "link": "https://www.freepik.com/free-photos-vectors/purebred-cats/35",
        "source": "Freepik",
        "display_link": "https://www.freepik.com › purebred-c...",
        "title": "Page 35 | Purebred cats Images - Free Download on ...",
        "description": "Find & Download Free Graphic Resources for Purebred cats Vectors, Stock Photos & PSD files. ✓ Free for commercial use ✓ High Quality Images.",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "images": [
          {
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRk0n_3Eld3jFsOYfYQZOdNNWHFSsUUtWKvr5yl-6M_n7-b7XWGCmk-_x7X7qPg9UMVWRxS&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRk0n_3Eld3jFsOYfYQZOdNNWHFSsUUtWKvr5yl-6M_n7-b7XWGCmk-_x7X7qPg9UMVWRxS&s"
          },
          {
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRsFg-kGDTCuYeP4IP6qIAUShjd0sYfvLLZsw7ED5f7_4dok9xiM8xvgmM&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRsFg-kGDTCuYeP4IP6qIAUShjd0sYfvLLZsw7ED5f7_4dok9xiM8xvgmM&s"
          },
          {
            "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQz_uyb1FbUWMei9f0qKWBQ2F4mfPonXMESPtGElYxSZpvipIAr7qBxMOQe&s",
            "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQz_uyb1FbUWMei9f0qKWBQ2F4mfPonXMESPtGElYxSZpvipIAr7qBxMOQe&s"
          }
        ],
        "rank": 6,
        "global_rank": 68
      },
      {
        "link": "https://www.instagram.com/reel/DT3GLXQiHVr/",
        "source": "Instagram · mikhailazarenkov",
        "display_link": ">10 lượt thích · 1 tháng trước",
        "title": "Carina cats",
        "description": "15 likes, 0 comments - mikhailazarenkov on January 23, 2026: \"Carina cats\".",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKHMqtB3gq19t8wm3OYFXYxI5i6Mn_LnyZX6LLvl81dpMbdyCRF7j7SQ&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKHMqtB3gq19t8wm3OYFXYxI5i6Mn_LnyZX6LLvl81dpMbdyCRF7j7SQ&s",
        "duration": "0:20",
        "duration_sec": 20,
        "rank": 7,
        "global_rank": 69
      },
      {
        "link": "https://www.missmainecoon.com/kefir",
        "source": "missmainecoon.com",
        "display_link": "https://www.missmainecoon.com › kefir",
        "title": "kefir | Kitties - Miss Maine Coon",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDmwtbHpEnQX-ZGB-U7yqVVmBp1XEyEfoN3QaQtQlmyHOQ6NAuJ5vm&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTDmwtbHpEnQX-ZGB-U7yqVVmBp1XEyEfoN3QaQtQlmyHOQ6NAuJ5vm&usqp=CAE&s",
        "rank": 8,
        "global_rank": 70
      },
      {
        "link": "https://www.instagram.com/p/CzMjyVlviCW/",
        "source": "Instagram · dear.fig",
        "display_link": ">8,2 N lượt thích · 2 năm trước",
        "title": "Introducing my wonderful & wild zoo 🤗🐶 ... - Instagram",
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTnfbw4xXrCjgIGvU7G1DETerB4oJDMOEbR9e6Vwcu-Utz2jfV5MvqZ&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTnfbw4xXrCjgIGvU7G1DETerB4oJDMOEbR9e6Vwcu-Utz2jfV5MvqZ&usqp=CAE&s",
        "rank": 9,
        "global_rank": 71
      },
      {
        "link": "https://www.thesprucepets.com/orange-boy-cat-names-5114556",
        "source": "The Spruce Pets",
        "display_link": "https://www.thesprucepets.com › oran...",
        "title": "225 Orange Cat Names for Male Cats",
        "description": "18 thg 6, 2025 —",
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "18 thg 6, 2025",
            "rank": 1
          }
        ],
        "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAA...",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT5T4oXZDS_w4SY3b5UF5_gt5qO38G6wjCg2iYRTJiDtolvxIDj2wBP&usqp=CAE&s",
        "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcT5T4oXZDS_w4SY3b5UF5_gt5qO38G6wjCg2iYRTJiDtolvxIDj2wBP&usqp=CAE&s",
        "rank": 10,
        "global_rank": 72
      }
    ]
  }
  ```
</ResponseExample>


# Visual matches
Source: https://docs.brightdata.com/api-reference/serp/google-lens/visual-matches

Configure the Bright Data Google Lens Visual Matches parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches
```

## Parameters

<ParamField type="query">
  URL of image you want to search
</ParamField>

<ParamField type="string">
  The `brd_lens` parameter in your request fetches specific Google Lens **tab results** by specifying a tab value (e.g. `products`, `homework`, `visual_matches`, `exact_matches`).

  ```txt wrap theme={null}
  https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_lens=visual_matches',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 highlight={5} theme={null}
  {
    "general": {
      "language": "en",
      "mode": "search",
      "type": "visual_matches"
    },
    "tabs": [
      {
        "name": "AI Mode",
        "link": "https://www.google.com/search?sa=X&sca_esv=71ffffd766b5380a&lns_surface=26&biw=987&bih=1097&hl=en&gl=us&udm=50&vsrid=CKienZejr5684gEQAhgBIiQzNWFmNzM5NS0zM2Y4LTRkNmEtOThjYi01NjliM2E2Mjc2ZDIyBiICc2QoBTi4ueOU8PySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=hitd2dN0jyWqgFfGjP_XnQPIvavy1d_VkxyabwBmHYuXXOL8cfIoFg&lsessionid=v7TCxI5b8d12uRO4bCJNRxNbkUm0dXpFWrm7z_WkPK3J6NVN2VpjMg&fbs=ADc_l-Yv0YTTwuvIVYRVntg99Yl4C2siJayzZyC50sFnWwRH6ow_bxUxJgqfeyXucYwXL8BodgQvcQKf4r6af6eJrUBEJPcPla2xArZ4O2zHdIqqQ1YVgeUF-eZ8YfKEFkJDuGVjK7bY&q=&aep=1&ntc=1&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Q2J8OegQIDBAD"
      },
      {
        "name": "All",
        "type": "all",
        "link": "https://www.google.com/search?sa=X&sca_esv=71ffffd766b5380a&lns_surface=26&biw=987&bih=1097&hl=en&gl=us&udm=26&vsrid=CKienZejr5684gEQAhgBIiQzNWFmNzM5NS0zM2Y4LTRkNmEtOThjYi01NjliM2E2Mjc2ZDIyBiICc2QoBTi4ueOU8PySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=hitd2dN0jyWqgFfGjP_XnQPIvavy1d_VkxyabwBmHYuXXOL8cfIoFg&lsessionid=v7TCxI5b8d12uRO4bCJNRxNbkUm0dXpFWrm7z_WkPK3J6NVN2VpjMg&q=&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Qs6gLegQIDxAB"
      },
      {
        "name": "Exact matches",
        "type": "exact_matches",
        "link": "https://www.google.com/search?sa=X&sca_esv=71ffffd766b5380a&lns_surface=26&biw=987&bih=1097&hl=en&gl=us&udm=48&vsrid=CKienZejr5684gEQAhgBIiQzNWFmNzM5NS0zM2Y4LTRkNmEtOThjYi01NjliM2E2Mjc2ZDIyBiICc2QoBTi4ueOU8PySAw&vsint=CAIqDAoCCAcSAggKGAEgATojChYNAAAAPxUAAAA_HQAAgD8lAACAPzABEIAIGIAIJQAAgD8&lns_mode=un&source=lns.web.gsbubu&vsdim=1024,1024&gsessionid=hitd2dN0jyWqgFfGjP_XnQPIvavy1d_VkxyabwBmHYuXXOL8cfIoFg&lsessionid=v7TCxI5b8d12uRO4bCJNRxNbkUm0dXpFWrm7z_WkPK3J6NVN2VpjMg&vsrid=CKienZejr5684gEQAhgBIiQzODQ1Zjk3YS1kYjM0LTRlMDQtODMwNi1jNmYxYTM2Yzg4ODcyBiICc2QoBTi4ueOU8PySA1AA&q=&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Qs6gLegQIDRAB"
      },
      {
        "name": "Visual matches",
        "type": "visual_matches",
        "selected": true
      },
      {
        "name": "About this image",
        "type": "about",
        "link": "https://www.google.com/search/about-this-image?img=H4sIAAAAAAAAAAFMALP_IkoKSAionp2Xo6-evOIBEAIYASIkMzVhZjczOTUtMzNmOC00ZDZhLTk4Y2ItNTY5YjNhNjI3NmQyMgYiAnNkKAU4uLnjlPD8kgNQAJs_T4BMAAAA&sa=X&ved=2ahUKEwjXpfmV8PySAxVOUGwGHXIbGt4Qs6gLegQIEBAB"
      }
    ],
    "images": [
      {
        "title": "YouTube gets a brand new logo and a new look for both mobile and desktop",
        "link": "https://www.androidauthority.com/youtube-new-logo-796482/",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "Android Authority",
        "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUUAAA...",
        "image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUUAAA...",
        "rank": 1,
        "global_rank": 2
      }
    ],
    "exact_matches": [
      {
        "title": "Find Out Who Posts the Most Comments on Your YouTube Videos",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAA...",
        "source": "vidIQ",
        "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2w...",
        "rank": 1,
        "global_rank": 1
      }
    ]
  }
  ```
</ResponseExample>


# Google Reviews async request
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/async

Use the Bright Data Google Reviews async endpoint (31 languages). Submit a request, poll the job ID and retrieve results as JSON with 200 OK on success.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
```

<ParamField type="boolean">
  Set `async=true` in the request URL to enable asynchronous requests.

  ```txt wrap theme={null}
  https://api.brightdata.com/request?async=true
  ```
</ParamField>

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={1} theme={null}
    curl -X POST https://api.brightdata.com/request?async=true \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl -i --silent --compressed \
    -H "Content-Type: application/json"
    -H "Authorization: Bearer API_KEY" \
    -d $'{"country":"us","query":{"q":"pizza"}}'
    "https://api.brightdata.com/serp/req?customer=CUSTOMER_USERNAME&zone=ZONE_NAME"
  ```

  ```js Node.js highlight={2} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request?async=true', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={17} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request?async=true', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXfHOWf_k3xFLr7N87GuvjsQHzsDSZb3FW1zjSl6LV32uKV4qI=s120-c-rp-mo-ba4-br100",
          "display_name": "Brian Ash",
          "link": "https://www.google.com/maps/contrib/109749787540014073287?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tRNFRVOXVUVE51YXpKVVdHb3laV3R5TjNScmRuYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkQ4TU9uTTNuazJUWGoyZWtyN3Rrdnc%7C0dK0Oisp5f4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "a month ago",
        "date": "2025-12-30",
        "comment": "The staff here were friendly and helpful. Everyone was cheerful and considerate. The staff here made our experience pleasant and memorable. The rooms were nice, but the location is perfect if you want to be in thick of the hustle and bustle of the city. Conveniently located, great facilities and a room rate that won’t break the bank. I wouldn’t hesitate to book again.",
        "review_reply": "Dear Brian,\nThank you for the wonderful review. We are glad to hear our team’s friendliness and positive energy helped make your stay pleasant and memorable. It is great to know you enjoyed the room, facilities, and our convenient location, along with a rate that added value to your visit. We truly appreciate your recommendation and look forward to welcoming you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psEgneI8FIdEeGP0U0DKFzwPjUbeMcfWkr7I6LvoCMXzPz_f8qvhEnl6IrGg73jlvLo1xOLrtjDLM7BY9doDWY9GddvM4JckW6EY8Bi5-GN7IzokII2PtHT99mWEr3bEWjh0RBhA7KKeVk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psP7Yx2Swd3UOEIevzruzpKAerYUdMJPXETQJt-A3SrKXcnHP4Cy0TLirJExW50cQ_kzoUUnZLHzfu-tUwtz_Kp_4yUSeqjo4Tm-BK1z9D6CmokJrkvo9QCtYAG7hjERaHOzibyBzSLaHlz",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pun-0zZPPEzWSkW_XUq8eHQSze3imSI7iMEq9_29WwJJdM82HBq3LwycenRdrTRIt70jyr3jPd4kiIABo-GdwhMJ6jd3QbOjrBuq4xfzs9OPPW_DEu52MrDQK0MnY8vgRQG8wfId5sLZtau",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvs0bS1DXsAMv1l2rUc2o5O3r07JiEVr2mXuo8_HxN-e47l0YqBxSfHQCGATeYbu059C-Gh9Om5nIuuoXGKbx-VqSFcovQuuboYcXxg9r4AOkj8y_1Atv5LieCvzZNjKt2lP_EIFUmpNIzv",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pvGyxLHYBHrq2Xjc1_XkBMitY3PltgQXVrpUHliY22qm1juTnbcQM9Dppxgbb-YeCgQjzlWuEHfe22uXMf2LyAtWpiNnKrN62zNG5SeDhCZiGYwMDpp6TLNTVPWGcJgeTH7ozM12r70coMx",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptnOwAnTti7y3hrhxJ7TVOyrr9FmaGP1YvVDgo5ca-Mokl4thE-Ds1t9oaM_v6ofHs6MheZ1g02rNAsUlQqc0dRArJXKwYp8JAwhFQPOz0Cel9gu645rgw4O26EzLm1PkYHwzci7D_Wewdf",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu4U-BFG3nJCIUa3yMRZFr2NWas-3A1PUlCsROljZC05rtJhDHjDqd50W5ucTMpu8ywsM7yFNZLywcjhgKaXWqWsIHQtWJdOhAnQlsaq30fmt-3NNu3FISJ1wB1p-TvteQ-A3kcyAVZlkHb",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9pu8TqvQu_MO3rNMEH_5qVZ5fUYMHgVnS4PWsnKI2EVxPvBBiRZuwVhJLUZfKGxS6mnZMMKRfJB5KYlk2T7eZ1fNk6wqqGENrmoaYnGdqMcQm3CaV2OKSbYMAEcZRGstJI13u37JVn6_dsjI"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Diana Nichols",
          "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
        "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Solo",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "My room was perfect and bigger than I expected for NYC.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Lots of police officers around! Felt extremely safe.",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
          "display_name": "Natiesha Wray Henry",
          "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
        "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Cozy and comfortable",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Times Square is walkable from here",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "10 out of 10",
            "description": "Walkability"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Parking and traffic is a nightmare.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
          "display_name": "R471LZalext",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "2 months ago",
        "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKxAYr7LFV6ZMNckj3q8VKiPdMIZXgCzt920CSu2v1nYG3GzQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Elia Alejandra",
          "link": "https://www.google.com/maps/contrib/107082141027365570078?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKdk5FdHVMVW8xTjFoT2MzUjJlamQyV0hSTk4wRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJvNEtuLUo1N1hOc3R2ejd2WHRNN0E%7C0d6T99EL24S%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "2/5",
        "created": "3 months ago",
        "comment": "Room had a nice view. Staff was friendly.\nRoom was dirty when we walked in. There were hairs in the bathtub, and sink wasn’t very clean. Restrooms and rooms along with furniture are very old! Bedsheets had some hairs and not very clean. Room was cleaned once out of 4 days so it’s not daily. They do give you a 35$ voucher for the cafe they have and 25$ for their services. Luggage hold is free if you get there early but they charge 5$ a piece if you need to check out of your room but still have time before the airport. Elevators are nice they have a system that makes it run smoother.\nHotel seems very central so that’s a good thing. Lots of things around but that’s just New York.\nOver all because of how old rooms seems and how dirty it was 2/5. Wouldn’t stay here again .",
        "review_reply": "Dear Elia,\nThank you for taking the time to share such detailed feedback. We’re glad to hear you enjoyed the wonderful view, the fantastic location, and the friendliness of the team, but we’re truly sorry to learn that the room did not meet expectations during your stay. Your comments about cleanliness, upkeep, and service frequency are important, and they’ll be shared with the appropriate teams so we can take a closer look. We appreciate you noting the helpful amenities like the café credit, services credit, luggage storage, and elevator system as well. We’re grateful for your perspective and hope the rest of your time in New York City was wonderful.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 3,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
          "display_name": "Amanda Garcia",
          "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
        "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChZDSUhNMG9nS0VKdXluNURVNjR1UWJnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdVsxDWqDDLG62Q3M3dmLlHORJs5jz0NWRJO3cP21KtRNPfosO7RpofjnbUgpyNjOTDew=s120-c-br100",
          "display_name": "LisaO964",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045294524?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "4/5",
        "created": "a month ago",
        "comment": "Spent 6 nights here with my family- arrives 9.45pm due to flight delay but on arrival rooms were not ready, the gentleman at check in was helpful and found us a room however it was interconnecting with another family which meant we were disturbed by their noise quite a lot. However, this hotel is really lovely and other than this and the elevators being slow I can’t fault it. They have installed a new elevator system and should have thought it through as during busy times they are packed and it can take quite some time to get one. |Rooms are lovely , cleaned every day, excellent location and staff all really lovely. I would recommend staying here."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VNT3NySlBUc01UbTZRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qdvd3mFTmnQslJajBtyC7hGXBv5KKEN_7z5ZnXByEfDkAAFDmgEV3HW1P9_iXApXyf1XA=s120-c-br100",
          "display_name": "bobrobb",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045071077?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=BF&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "2/5",
        "created": "a month ago",
        "comment": "On a positive, the location is excellent and the room was big enough for a family which I think is a rarity for such a location.  We visited from 30th Dec to 6th Jan and in all honesty the hotel is just not set up to be running at capacity.  There were queues for everything, check in, check out, restrooms, bars and the lifts.  The lifts deserve a special mention - if on a lower floor you might have to wait for 5 to 6 lifts to get one that had any capacity if heading down at a busy time.  The service at check in and check out was pretty non- existent, the $35 “destination charge” is to encourage you to spend in their bar.  If lucky enough to actually get served in the lobby bar 2 x beers is more than the $35 - it just leaves a bad taste.  There are no tea and coffee facilities in room (a given in UK), but on a positive note towels were changed daily.  When checking out this morning nobody asked us how our stay was, totally impersonal, then we got hit with the $5 per item holding fee, to hold our baggage from 12 noon to 2 pm - as we had 7 items (hand luggage also counts as a separate item) we got a $35 charge after checking out.  If anyone genuinely cared about customer experience, that would have been taken out of your destination charge, but of course that isn’t possible.    It is a shame really, a once grand hotel, living off the Hilton brand, in need of a refurb with a clear focus on revenue creation as opposed to customer experience.  The location just isn’t enough to make up for the lack of experience I’m afraid - there are much better out there."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJQgX50KQ8oURrMb8SgiRyqOysMS1rNXBa0wHN1BoF7o8ORvQ=s120-c-rp-mo-br100",
          "display_name": "Olaoluwa Ajilore",
          "link": "https://www.google.com/maps/contrib/115992020596208851571?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNlbnpfNnNsMm53R3Axdk80RFhrV3c%7C0d3TryOnoQy%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I rarely write reviews, but I felt compelled to share my experience—especially because of the outstanding room service I’ve received. I’m currently staying here, and everything has been fantastic so far. What truly sets this place apart is the incredible housekeeping team on the 34th floor.\n\nThey are, without a doubt, the most attentive and genuinely kind crew I’ve encountered in any hotel across the country. Always cheerful, always ready to help—even when I’ve had the “Do Not Disturb” sign up, they’ve gone out of their way to check in if they see me in the hallway, just to make sure I don’t need anything. That level of care and consistency is rare, and it deserves to be celebrated.\n\nThey’re simply the best.",
        "review_reply": "Dear Olaoluwa,\nThank you for taking the time to share this, especially since you mentioned you rarely write reviews. It means even more to know you felt moved to speak about your stay while you’re still here with us. We're truly thrilled to hear how well everything has been going, and your kind words about our housekeeping team on the 34th floor mean the world. They take such pride in caring for our guests with thoughtfulness and genuine warmth, and it’s wonderful to know that their efforts have made such an impression. We'll be sure to share your message with them. I know it will brighten their day and remind them just how meaningful their care is. Thank you again for recognizing their hard work and spirit. We’re grateful to have you with us here at New York Hilton Midtown and are here for anything you may need for the rest of your visit. We hope the rest of your time with us continues to feel relaxing, comfortable, and well cared for!\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_GM@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "perfect, nice view, great ambiance",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Alot of activities",
            "description": "Nearby activities"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Filter by keyword
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/filter-keyword

Configure the Bright Data Google Reviews Filter by Keyword parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  Filter keyword. Will respond with reviews that contain specified keyword only.

  > **For Example:**\
  > `filter=awesome` - search for reviews containing 'awesome' word

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&filter=awesome',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK7OOVJIAqO_bUXJsXNClGhPiS_codAAJ_4jbQhjngD2I5VQA=s120-c-rp-mo-ba3-br100",
          "display_name": "L File",
          "link": "https://www.google.com/maps/contrib/112336634363254268566?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9XSlh5QXRTZ0lwV1ozMnhDRGg3a0E%7C0dCjYvbWq6w%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "2 months ago",
        "comment": "Awesome location, rooms were clean and comfortable.  Bar drinks are just ok, food is meh.  But I didn’t go to NYC to eat/drinkk in my hotel.  Its location is perfect.  We walked about 5 miles a day to see what we wanted and to go where we wanted.  Subway was easy to use.  The elevators are nice, but they do need more.  Construction on one, but there is almost always a line to go up and getting down is awful.  Give yourself plenty of time and the higher the room, the easier to get “on”.  Oftentimes people had been waiting multiple stops for the elevator to get down to the lobby, if on lower floors, but it would be full.  That was the only pitfall, but could be a significant one if you are in a hurry.",
        "review_reply": "Thank you for sharing your experience with us. We are glad to hear you enjoyed the clean and comfortable rooms, as well as our convenient location, which made it easy to explore the city on foot and by subway. We appreciate your comments regarding food, beverages, and elevator availability, and we will be reviewing these concerns with our team to help improve the overall guest experience. We appreciate you staying with us and hope to have the chance to host you again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tOQ2RVOWthRFZwVWtGMFgxTmFSakpqUjBOaVRWRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocLCd6QVG_vE1DlQTKcKWG5vfq92wigYd3HhKhqbNu3lwOeJag=s120-c-rp-mo-ba2-br100",
          "display_name": "Christine Yacoub",
          "link": "https://www.google.com/maps/contrib/101475921371619109061?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tOQ2RVOWthRFZwVWtGMFgxTmFSakpqUjBOaVRWRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNCdU9kaDVpUkF0X1NaRjJjR0NiTVE%7C0dEkCa75rer%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Awesome location in the city, but outdated rooms, zero amenities, and the elevator situation was an absolute nightmare. We had to tack on at least 10+ minutes to account for the elevator ride alone, sometimes having to ride the elevator up to other floors just to catch it back down. Rooms were insanely hot at night with no way to bring down the temperature. Terrible experience, unfortunately. I expected more from a Hilton in such a prime location",
        "review_reply": "Dear Christine,\nThank you for sharing your experience. We are truly sorry that your stay didn’t meet your expectations. Your comments have been shared with our team to help improve the guest experience, and we appreciate you taking the time to provide this detailed feedback.\n\nSincerely,\n\nNew York Hilton Midtown Team\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnTUNJc2R5czdRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUX4Awz4I21tTfDxKx-yJXmRLbBhffYdzezsAe7EFE7BXRxSDa2AQ=s120-c-rp-mo-ba5-br100",
          "display_name": "Jonna Pantelis",
          "link": "https://www.google.com/maps/contrib/107822826899657610772?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnTUNJc2R5czdRRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgMCIsdys7QE%7C0cXD2lhpDph%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Edited 6 months ago",
        "comment": "The difference in reviews on this hotel are just wild. I stayed on the 30th floor and found my room to be great. It was larger than what I typically expect from a hotel room in NYC and was so happy to see a couch!  Everything was clean, with exception of some rust stains around the shower drain.\nNo, the hotel rooms do not have coffee makers, however there's a coffee shop located in the lobby that was open at 5:30am.\nCheck in was a breeze, I checked in online and then visited the front desk to pick up a physical card. Service was fast and easy.\nThe hotel itself is in an awesome location!\n\nEdit to add: my most recent stay is wildly different.\nMy room on 32nd floor really needs refurbishment. The elevators have been absolutely horrible. Only 1 in my floor bank worked and on day 2 that even stopped, I ended up having to take the service elevator down.",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VNZXFqTWlOd2MtVWdBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qe1FTSCg98CZ3VrSg28YAOa76nyaQfZNd66XhsW7MF99ozoooauY0gRdjL2-kPkUfooOQ=s120-c-br100",
          "display_name": "Maureen",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "10/10",
        "created": "9 months ago",
        "comment": "Positive: The staff was awesome.  On the check-in Kathleen went out of her way to make sure the room worked for us.  It was just the first of many experiences with attentive staff.  Friendly and responsive.  Location was great. Negative: \"\""
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSUNfLUpybzRnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QdygWaVcJ3ItdBHng2W3iaFRVWQH1rVo2JLZNRPvIK0yuW9fy8TZEHD74TDScrP3xIW2Q=s120-c-br100",
          "display_name": "Kimberly",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "10/10",
        "created": "a year ago",
        "comment": "Positive: The location & staff were awesome! Reminder to spend your daily credit. See Hotel employee in the bar and order a ?Lazarus? if you?re a fan of espresso martinis! Negative: It is getting a bit tired in the hallway and bathrooms. Especially the wallpaper but the other things outweigh so I wasn?t bothered."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSURlN05XUHhBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjU54My1PEEpcJ07il9yu48emyyENeicNVgsx7mPTtono7URPdXf=s120-c-rp-mo-ba3-br100",
          "display_name": "Caroline Hipple",
          "link": "https://www.google.com/maps/contrib/110997671651209094064?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSURlN05XUHhBRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIDe7NWPxAE%7C0YvRSCodSVV%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "Edited 3 years ago",
        "comment": "We enjoyed our stay at the Hilton Midtown and would definitely consider it again for a future NYC trip. The location is fabulous, easy walk to anywhere.  Staff were friendly and helpful, got us checked in very quickly despite our early arrival time.  The room was a good size by NYC standards and although a little older, it was clean and comfortable.  Awesome large windows with a great view.  Enjoyed hanging out in the Executive Lounge for coffee and a bit of peace and quiet!",
        "review_reply": "Dear Caroline,\nWe're so happy to hear that our amazing location and friendly team members impressed you at New York Hilton Midtown and that you had a great time overall. It would be an absolute pleasure to host you again the next time you come to the Big Apple, so hurry back!\n\nSincerely,\n\nNew York Hilton Midtown Team\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 years ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSUR3ME8tSHJBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUuDalG7UAbNUpgMrJxdadLrrH_HRlGdnbh3KGWLjKogCERxLA=s120-c-rp-mo-ba4-br100",
          "display_name": "William Purcell",
          "link": "https://www.google.com/maps/contrib/111518848845096895914?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSUR3ME8tSHJBRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIDw0O-HrAE%7C0YxW5al_xXs%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "Edited 3 years ago",
        "comment": "I have stayed here many times and the location cannot be beat.  The executive lounge is awesome for breakfast with caring staff.  The service at this hotel overall is excellent.   The rooms are very nice too.\n\nI love that you are an 8 min walk to so many things like Broadway theaters and Central Park too.  You can walk to so many places, take a rest in the executive lounge, and go out some more.\n\nMy family highly recommends this New York property."
      },
      {
        "review_id": "ChZDSUhNMG9nS0VJQ0FnSUNEbUxYb2VBEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUG0JejyKmnmkKjKsXv3Zqzr53W2a6F95lt-dqtlETw65cW3sY=s120-c-rp-mo-br100",
          "display_name": "Jaxson Karn",
          "link": "https://www.google.com/maps/contrib/115116250847951428621?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSUNEbUxYb2VBEAE!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgICDmLXoeA%7C0_zuQCkZ3Fc%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a year ago",
        "comment": "First Time to New York and I was a little nervous but Midtown Hilton is a super chill hotel that is easy to relax in and take a break from the hectic but fun city. The vibe is good and the rooms are nice. Special shout out to Willie who was working at the Bridges Bar in the lobby. Willie you are the reason I am writing this review. You are the most friendly and down to Earth guy I have met. You make Midtown Hilton awesome, keep it up! Willie is a solid 100/10.",
        "review_reply": "Dear Jaxson,\nThank you for staying with us at New York Hilton Midtown and for your fantastic review. Willie will be pleased when we share your kind words with him. Thank you for choosing to visit us during your trip to the city, and we look forward to seeing you again soon for another relaxing break.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a year ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Friends",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Willie is a solid guy.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChZDSUhNMG9nS0VJQ0FnSURNOXM2NEFnEAE",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUhkHISOyI-Hj1pC-_kkDRTzjZw8J_EcPXjWpX3rsTfVAG0s2CS0A=s120-c-rp-mo-ba4-br100",
          "display_name": "Becci Dougherty",
          "link": "https://www.google.com/maps/contrib/106862988338556860792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSURNOXM2NEFnEAE!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIDM9s64Ag%7C0YxUl92CLoc%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Edited 3 years ago",
        "comment": "Great location, clean, staff friendly, executive club staff AWESOME.  THE Herb'N'Kitchen has no place being in any Hilton property though.  Food is good sometimes but usually just Okay.  Most of the staff there is very abrupt.  Every where else in the hotel is great..... Except... We were there over Christmas & even with the fan \"on\" constantly & the windows open..... It was very hot in our room. Housekeeping, security, concierge were all fantastic though!",
        "review_reply": "Becci, I'm happy to know that our executive lounge team left you with a great impression! We'll always make sure to be as helpful as we can when you're here. Additionally, we appreciate your patience while you were here. We will always try our best to be accommodating to your needs, but we take note when our guests go above and beyond to make themselves feel at home. We take your feedback to heart as we use any information to improve the overall experience of our guests. -Andrew Verburg, Director of Front Office Operations",
        "review_reply_created": "6 years ago"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSUMwMG91QXh3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUFy0ZwQ2ZKM0j0haGOcdBh3u2sxTgJYH1l1tMxwOCaf98Yrus=s120-c-rp-mo-ba2-br100",
          "display_name": "Caleb noiles",
          "link": "https://www.google.com/maps/contrib/114781757379111938014?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSUMwMG91QXh3RRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CIHM0ogKEICAgIC00ouAxwE%7C0YxUtk-RQok%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "Edited 3 years ago",
        "comment": "I am a Hilton diamond member and was quite excited to see what it would give me in New York. But I was dissatisfied with the \"perks\" we had reserved a standard king room knowing we would be upgraded. But that was a total failure, they upgraded us to a premium king room with an accessible bathroom. Which wasn't the issue. The issue was the room was damp and could smell the mold. So we called down to get switched into another room but they had sold our original room and down graded us to a double room...\n\nThe double room was clean but very outdated, the wall paper was curling and the fridge wasn't working.\n\nThe cleaning lady gets 5 stars though she was awesome, she went above and beyond for us.\n\nThe breakfast lobby was just a typical continental breakfast no warm foods. Nothing like any other hilton I had stayed at.\n\nI am just not sure how the hotel has a 4 star rating. It's an easy 3 star in my mind had they made the diamond experience better and put us in a king room of some kind.",
        "review_reply": "Caleb, thank you for taking the time to share your experience. We try our best to maintain our rooms as best as we can, but we're always receptive to our guests' feedback. We'll use this information to improve. We greatly appreciate your review, as we use it as a means to improve. We hope to have the opportunity to welcome you back soon and Make it Right. -Andrew Verburg, Director of Front Office Operations",
        "review_reply_created": "6 years ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 2,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Google Reviews pagination
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/pagination

Configure the Bright Data Google Reviews Google Reviews pagination parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  Define the result offset - results to start from the selected value. Used for managing pagination.

  > **Examples:**\
  > `start=0` (default) - first page of results \
  > `start=10` - second page of results \
  > `start=20` - third page of results, etc.

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10
  ```
</ParamField>

<ParamField type="string">
  <Warning>
    **Deprecated As of September 11, 2025 by Google**

    * The Number of results to return is usually 10, results' set size may vary.
    * The `start` parameters can be used to paginate within results' set. 
    * To get top 100 results, Bright Data offers a Web Scraping API. Read more here: [Get top google 100 results in one API call](/products/serp-api/get-top-100-google-results)
  </Warning>
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&start=10',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT214TVYwUnBkeTB4YVVSUFdXVmpkRVF5YUdWNU5VRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocL3C36IqORKTyGT30AEfavKkHg-QKtec5fuvyfp5frlqqNi8A=s120-c-rp-mo-br100",
          "display_name": "Rose Vu",
          "link": "https://www.google.com/maps/contrib/104779998134668984454?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT214TVYwUnBkeTB4YVVSUFdXVmpkRVF5YUdWNU5VRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmxMV0Rpdy0xaURPWWVjdEQyaGV5NUE%7C0d4z-lTsbDt%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "3 months ago",
        "comment": "Great location. Double room with city view was very spacious. Nice gym. Helpful staff all throughout the hotel. Nice random free wine hour one evening. It’s a very large hotel.\n\nMy only two complaints are:\n\nWaiting for the elevator can be very annoying in the mornings and evenings. We ended up using the alternative elevator one morning because the normal ones came by already packed.\n\nThe hot water situation. In order for us to get hot water, we had to run the faucet for 5-7 mins. This was something I had never encountered in any hotel I’ve ever stayed at and was a disappointment considering this hotel is a 4-star hotel. I had to repeat this for each person in the room who planned to shower. It was also an inconvenience during a colder week to not have hot water immediately available.",
        "review_reply": "Dear Rose,\nThank you for staying with us and for sharing these thoughtful details. Hearing that the city view room felt spacious, the gym supported your routine, our team was genuinely helpful, and the surprise wine hour added a nice touch means a great deal. However, we regret the elevator congestion during peak times and the delay before hot water reached the tap. We'll be sure to share your comments with maintenance to improve speed and consistency. Your stay should feel seamless from elevator timing to a comfortable shower, and we hope to welcome you back for a seamless experience down the line.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21OV1RXdDZRME5yYm01RU9UVXpiMDVEU25kcU5VRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJw2qrSfWVwpVjOvixKQwrktL_cVaBt27i66c8B0MoldFk_n8QQ=s120-c-rp-mo-ba3-br100",
          "display_name": "megan zhang",
          "link": "https://www.google.com/maps/contrib/114757865199967482135?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21OV1RXdDZRME5yYm01RU9UVXpiMDVEU25kcU5VRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmNWTWt6Q0Nrbm5EOTUzb05DSndqNUE%7C0d7PxGL8OrX%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "3/5",
        "created": "3 months ago",
        "date": "2025-11-22",
        "comment": "We visit NYC at least once a year. The Hilton Midtown is well located. Hotel lobby has no sitting area for guest to rest. We waited 30 mins to check in, November 21st Friday, so prepared long waiting time. Booked a room with two beds, end up given one king and a pull out couch, the hotel is totally sold out. The front desk lady was not very friendly. She was exhausted and not  very patient. I am in hospitality business, it’s understandable but not acceptable. It didn’t bother me . Management team should either train your employees better or schedule more employees to work. The hotel room is spacious for NYC, but the pull out couch is stained. I will have to call at late night to request sheets to cover it. Hotel Gym is big and well equipped. I also just read they charge $5 per luggage to store your luggage after check out which I will need this service when we check out on Monday. I travel everywhere in the world. First time see a nice hotel charging luggage storage.  Hilton should know you are not Handling hostels guests. Your guests need only couple of  hours to be hands free before catching their flight.",
        "review_reply": "Dear Megan,\nThank you for sharing your comments about your recent stay. It is disappointing to hear about the long check-in wait, the room type not matching your reservation, and the condition of the sofa bed. The experience at the front desk should feel patient and professional, and it is regrettable that this interaction felt otherwise. Your points regarding service are important and will be reviewed internally. It is good to know that the room size and gym were positive aspects, and we hope to welcome you back for a visit that feels far more comfortable and well-supported.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "Edited 3 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psfevwStQ-CTLagO0LNX5SdjuBX4sQ0xD8ifxyabsqHgHEkdSBa3R0r8B7aAHNfXI_hhxx8XcM_c8lmQbEaZfBxSJsQvf_2eLf08e3FNs-vyZFLOcDx1-0ARxiAwW2SpSBXRyE0gbyQOrl_",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptxi7ADgZPrCMkqepy6MhIITVdd_bCbN3TdsOhsck0m2G149zwbxnEbp2P_VfJmTt03vzpViQR8SYYQmbai7Lt4PpTBERH9sROcDVadqZNvEQn96vxxZ2rsmVSnIAu2GZ9SIuwi7Ex344yp"
        ],
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 3,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205UVowMVZTbTF2V25aVVNsWm5PVTlSTUVrNVgyYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIgaHv0uz4qb1IAWCes4xZmxRX7BTldk_Dk5zU0797PEdLoSA=s120-c-rp-mo-ba3-br100",
          "display_name": "John S",
          "link": "https://www.google.com/maps/contrib/104471260898528618969?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205UVowMVZTbTF2V25aVVNsWm5PVTlSTUVrNVgyYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9QZ01VSm1vWnZUSlZnOU9RMEk5X2c%7C0dI4AoZafdG%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "2 months ago",
        "comment": "Great hotel in Downtown NYC.  Perfect location for Christmas Season as we could walk everywhere with young kids.  Would definitely stay there again.  Service was very responsive, from checking bags on arrival to room requests.  Clean rooms although old, but no complaints.  Elevators are going through an upgrade process so some delays there, but just had to give yourself an extra 2-5 minutes incase they were delayed or crowded.\nI would definitely stay here again.",
        "review_reply": "Dear John,\nThank you for sharing your experience. We’re delighted to hear that our downtown location worked so well for your family and that our team provided responsive service from start to finish. We appreciate your understanding regarding our elevators during the enhancement process and are glad our room cleanliness and overall stay met your expectations. Your kind words mean a lot, and we look forward to welcoming you back to New York Hilton Midtown for another enjoyable visit.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Rooms were a little dated and lights were dim, but felt clean, comfortable beds, and quiet.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Great location and easy walk to Rockefeller Center, Bryant Park, Time Square, & Central Park",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Always felt safe and secure",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "Very walkable for everything we wanted to do",
            "description": "Walkability"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjWR9P0hsugLdp9Oat4sxTahBKrA0gZ1C7uqw4MNisrIvLu3hy-V=s120-c-rp-mo-ba2-br100",
          "display_name": "Jennifer Wakefield",
          "link": "https://www.google.com/maps/contrib/114840974672973065687?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkRlRlZlX0NJdElCYkdvbEwxcmRuZmc%7C0dI--RQ5bgo%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "Edited 2 months ago",
        "date": "2025-12-24",
        "comment": "The location is fabulous. Everything else is terrible. This hotel has severely gone downhill over the years. It is not a four star maybe a two star at best. The rooms were adequate. The bathroom was disgusting and had discolored water forcing us to brush our teeth with bottled water. The wait for the elevators was ridiculous and we ended up using the service elevators and that area was absolutely disgusting and did not feel safe.",
        "review_reply": "Dear Jennifer,\nThough we are glad you enjoyed our central location, we regret that other aspects of your visit fell below your expectations and the high standards we strive for. What you have described regarding our accommodations, amenities, and the comfort and convenience we aim to consistently provide our guests is not typical for us. Rest assured, your insights will be promptly addressed for review and correction. We hope to welcome you back in the future to change your lasting impressions. \n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptLCFihq0e2Rr2xf5cBpxANMMhfDf1JNipzZV2xKzKvd-Td8Qfo806H4UwgM0apfWvMJArehhlrJbvtpuZyVzbpeBnkVhyxekIHl5lw7aRAKEy5Qw6DMp1-Ra6BPNVObzRdWeu7N9tJKFQ",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptpkESmccJfCgtjbmg66XKUKhbCM_Z8uVSsZ9a1wSHiSeaTKmsqURZ5b_UTuXuVxraFCv-MEHjqkhz10E3BsL2XiV3iQlmNEzik1QUg2tHyJVUJYF3XePBNCursMNftK2ATijYCAE3XIGk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psDnhsuOCuRiEKmw2YqOiDUbqGeziogZ0aJj0PL8tIz4-PbpFotEiJa1hZ4reobYw54gMKgbmU-ahevtF4KefFBTpBtOs_6jB8OQBjZiQGtEXE69koipvhvJPHSG0ADdpnkNyYkf4FQxc0"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJ2aeQdtiJkWeCyxq8wk3mwShLLZdvL3mNfhS0phcXWil15iw=s120-c-rp-mo-ba2-br100",
          "display_name": "Sarah Vertrees",
          "link": "https://www.google.com/maps/contrib/114286611919008365782?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmw3MHowZU10dWk4TDdmWmQ2WFBBLXc%7C0dHofB_sbAT%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "The only positive about this hotel is the location.\n\nWhen we arrived we were told that they were out of parking so we had to park ourselves in the parking garage across the street.\n\nWe paid over $600 a night for a room that was fair at best. It was very dated, screws missing out of the door handle, semi-clean, the bath tub wouldn’t drain-when I went to adjust the stopper it came out and the bath tub itself was pealing, the hotel staff were all less than pleasant!\n\nAs many others have mentioned the elevator stops a nightmare!",
        "review_reply": "emailed guest",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXCL-8vEvUDz822rsEmwqB79dYFIjQbHiK1dnR4PV9_VvfzFXTB=s120-c-rp-mo-br100",
          "display_name": "Sandi Butler Hughes",
          "link": "https://www.google.com/maps/contrib/118216174767304514343?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmVsbVZ2aVZneW1ZekVYU0VRc3AwRkE%7C0dDjnmf81ZY%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "date": "2025-12-11",
        "comment": "We stayed here for the Macy’s Thanksgiving Day Parade. The elevators were crowded and the line could be long - but it was overall a great experience and I highly recommend staying here. Room service was fast and good. Staff was helpful. Great, central location!",
        "review_reply": "Dear Sandi,\nThank you for choosing us for your Thanksgiving parade stay and for sharing these thoughtful highlights! It is wonderful to hear that the central setting worked well, room service arrived quickly and hit the spot, and that our team provided helpful care throughout. We recognize that elevator demand can surge during major events, and we are committed to seeking ways to keep things moving more smoothly. It was a pleasure having you here, and we hope to welcome you back for another festive visit.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psih2_1OOcMpwE2s3oVDJsT3YU-z52F9_knHdLNoArRhctk8qSKNiZfebnmWcA4a2l9uILAIVTXWa0nJpv7vdFrXZVyVPyZgvz5gOjmU1QKE9wCuI64Fd8ojOo157ZUIP2EKx6tVOsVKikX"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUEYov0tioO-gi58kZLHwZ7jHvkGkquiLm9YYLfq7ZPZFhuYLpQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Paula Januszkiewicz",
          "link": "https://www.google.com/maps/contrib/108960975385810447306?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkFUOWlHaktGd1J5alFEWlBVN2JUeGc%7C0d2miwB-5in%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "date": "2025-11-08",
        "comment": "The reliable favorite! With great, relatively peaceful location, which I appreciate.\n\nI’ve stayed here a few times already - it’s always such a good and reliable hotel. But this time you really surprised me with the yogurt selection: one with a taste of rose and the other matcha - omg, thank you! That little detail truly made my day. So delicious!",
        "review_reply": "Dear Paula,\nThank you for staying with us at New York Hilton Midtown. It means a lot that we’re your go-to when you are in the city. We also love that the new yogurt flavors were a hit, and our team will be so happy that the little touch stood out to you. We appreciate your loyalty and look forward to welcoming you back.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psjBORXqPHXaA8lWVYVBmJZG9vNFgZadE2xV7IIBNmMrZYD-cGjNPlD5g8QZfocFZHbG0vrwkPt_mwVMQJqew7JhEdJycvA7kxGjvVCOIoJQjhFVXrOTTLWJcswEKDpSp550TagX22ZUSIP"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQdnIyOHU1LVppVGlBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfnSFWXMd1oJu73a6IhdtgibYcjse2HKQTHeghNQd9Cyw8DYQQJZDCyh-TD68ehXuY-FA=s120-c-br100",
          "display_name": "R471LZalext",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=KZ&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d1379306-r1043196288?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=KZ&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "3/5",
        "created": "2 months ago",
        "comment": "Room was ok. For a Hilton I thought it would be better. Could do with an update with better placed plug sockets and some USB sockets. It is 2025 and people need multiple sockets to charge phones, tablets, watches etc.||Staff were underwhelming. Our flight home was cancelled and we had to find accommodation for another night. I understand they couldn’t accept us as they were fully booked. I would have appreciated some sort of effort to see if other Hilton hotels available but no, just a shrug of the shoulders pretty much and left to sort ourselves out. I understand that it is probably over there pay grade. However, a phone call or some sort of contact with other Hilton hotels would have been put our anxiety at ease. I am disappointed because i expect staff from the Hilton brand would excel at customer service, but they didn’t. They would’ve earned a decent tip from it. ||Only 2 things impressed me. The coffee machine in our room and the cleaning staff. They always did a superb job."
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUfusV7ZUjUCOLqMSt3fppZPTMYkLGZT4DP2M1Af_cL-58ns8WggA=s120-c-rp-mo-br100",
          "display_name": "Alison McGuckin",
          "link": "https://www.google.com/maps/contrib/117751954034681560040?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnh4U0VudE0wcVF3bkxqRTFWSHNtSWc%7C0dC2Wfaja3C%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Everything about this hotel would be great if it weren’t for the horrid elevator situation. It took 30 minutes for us to get 4 people downstairs from floor 38. We had to separate as a group to put one person into an elevator every time it showed up and actually had room. While in the jam packed elevator you would stop at every single floor, only for most of them to not even have anyone getting off there or waiting. We used to love this hotel, now we’ll be looking for a different midtown stay.",
        "review_reply": "Good morning, Alison, \nThank you for providing details of your experience with us. I would love to connect with you and make things right. We are currently unable to locate a reservation in your name. Can you kindly send your reservation details to Hannah.Zipkin@hilton.com? I look forward to hearing from you.",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK7OOVJIAqO_bUXJsXNClGhPiS_codAAJ_4jbQhjngD2I5VQA=s120-c-rp-mo-ba3-br100",
          "display_name": "L File",
          "link": "https://www.google.com/maps/contrib/112336634363254268566?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT205WFNsaDVRWFJUWjBsd1Yxb3pNbmhEUkdnM2EwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm9XSlh5QXRTZ0lwV1ozMnhDRGg3a0E%7C0dCjYvbWq6w%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "4/5",
        "created": "2 months ago",
        "comment": "Awesome location, rooms were clean and comfortable.  Bar drinks are just ok, food is meh.  But I didn’t go to NYC to eat/drinkk in my hotel.  Its location is perfect.  We walked about 5 miles a day to see what we wanted and to go where we wanted.  Subway was easy to use.  The elevators are nice, but they do need more.  Construction on one, but there is almost always a line to go up and getting down is awful.  Give yourself plenty of time and the higher the room, the easier to get “on”.  Oftentimes people had been waiting multiple stops for the elevator to get down to the lobby, if on lower floors, but it would be full.  That was the only pitfall, but could be a significant one if you are in a hurry.",
        "review_reply": "Thank you for sharing your experience with us. We are glad to hear you enjoyed the clean and comfortable rooms, as well as our convenient location, which made it easy to explore the city on foot and by subway. We appreciate your comments regarding food, beverages, and elevator availability, and we will be reviewing these concerns with our team to help improve the overall guest experience. We appreciate you staying with us and hope to have the chance to host you again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Sort (highest)
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/sort-highest

Configure the Bright Data Google Reviews Sort (Highest) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  The way reviews are sorted.

  | value | description |
  | - | - |
  | `sort=qualityScore` | most relevant first (`default`) |
  | `sort=newestFirst` | newest first |
  | `sort=ratingHigh` | highest rating first |
  | `sort=ratingLow` | lowest rating first |

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingHigh',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VKeTJ0di1zNGFpLXF3RRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qczn4VDfUM6-AtEt-6oaNazFa-i9Fy6kqPVfGIlPil6vJulEYyK8t930jZwOW4hD80mzw=s120-c-br100",
          "display_name": "DLSharpsteen",
          "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=MU&supul=en"
        },
        "link": "https://www.tripadvisor.com/ShowUserReviews-g60763-d611947-r1045281816?m=68573&staydates=2026_03_08_2026_03_09&uguests=1_2_0&supdv=desktop&supuc=MU&supul=en",
        "source": "Tripadvisor",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_100532569.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "We traveled to NYC to watch The Christmas Spectacular at the Radio City Music Hall and stayed at the Hilton for the night. We loved the location as it was within of 5 minute walking distance of literally everything there is to see at Christmas time. Our room was quite spacious and clean with two full beds and a nice view. Staff was friendly and I loved that you can get there early and check in your bags so you can go explore before check in time as we arrived to the city around noon. Also loved that there was parking on site. We used the valet so you pulled in, got everything out you would need, they give you a card with a number and you walk into the doors and right to the luggage storage area. The elevator system is insane and that's my only complaint. I've never stayed in a hotel where you have to put in your room number and can only ride a certain elevator to your room. Seemed our elevators were always the ones with tons of people waiting to get on or off. The only outside noise you could hear were horns, but I was ok with that and thankful I never heard my neighbors or anyone in the halls. I got an insane discount on my room through my employer otherwise I would never be able to stay here during Christmastime. But I understand why the rate is so high as it is a hotel that sits in the middle of all the amazing attractions NYC has to offer. Would definitely stay here again!"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocIb_1I5stFL2E46ANU5a9D1tE37bd7z3TrcvcjeCv8jbP01sQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Diana Nichols",
          "link": "https://www.google.com/maps/contrib/104268723670363283044?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2t0eVMzWjJjbk5tUWt0TGFFcG5kVU5XWTFvMGQwRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOktyS3Z2cnNmQktLaEpndUNWY1o0d0E%7C0dKeRXjPbb4%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Absolutely the best stay in the world! My room was clean and quiet and had everything I needed. The room was much bigger than I expected for NYC. Shout out to housekeeping who didn’t make a peep in the hallways as they cleaned the vacant rooms. I didn’t leave until around 2pm so they were working hard. Many hotels (even the best of the best) have housekeepers who talk too loudly in the hallways and constantly slam doors. Not here! They were perfect and I didn’t even know they were there until I left. Can’t tell you how much I appreciate that. Tons of security and police presence for the upcoming celebration (New Year’s) or maybe it’s always like that here. Felt extremely safe and protected. Beautiful spacious clean sparkling lobby. Many upscale shops and stores I didn’t have time to visit. Glistening with inviting items to purchase and view. Wish I would have gone into the shops! The staff was very very friendly from the front desk to the security guard who answered all my questions last night about transportation to JFK and local things to visit near the hotel. The man mopping the floor was super friendly (this was around 1am) trying to give me directions for the subway train etc for the next day to JFK. I had the best latte from the wonderful friendly cafe near the lobby. Everything clean and welcoming and beautifully displayed. I decided to take a taxi to JFK\nand asked for a “nice” taxi driver. The gentleman supervising the taxi line immediately made way for me through the throngs of folks on the street and treated me like a celebrity as he directed me to the next available ride. He didn’t laugh at me and I did get the nicest taxi driver - Fabian!!!  I was given excellent directions to get to the airport in JFK by the transportation and show tickets desk and they explained how to take the train bus subway etc but it seemed a little more difficult than I was in the mood for. The energy out on the street was electric and I also wish I had walked around a little before I left the city. This hotel is convenient to everything! Can’t ask for anything more than the wonderful experience I had at this hotel. Thank you everyone who works there and outside and Happy New Year!!!",
        "review_reply": "Dear Diana,\nIt's an absolute pleasure to learn about the exceptional visit you had with us, and we thank you for your perfect marks. Thank you for also going out of your way to spotlight our safe, welcoming facilities and unbeatable New York location. Of course, we'll be sure our team hears they really made a difference with their outstanding service, and we look forward to seeing you again soon here at New York Hilton Midtown for another unforgettable experience.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Solo",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "My room was perfect and bigger than I expected for NYC.",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_SAFETY",
            "name": "Safety",
            "value": "Lots of police officers around! Felt extremely safe.",
            "description": "Safety"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "I just found everyone super friendly. Maybe because I love the people and the energy in NYC anyway.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXmcoJ3y3xhQX30wsKy5q87OD7qFUR6FDUsw_QDL8EWl8-nUSQ=s120-c-rp-mo-ba3-br100",
          "display_name": "Natiesha Wray Henry",
          "link": "https://www.google.com/maps/contrib/102270227746850983681?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25ReVRFUTJiV0ZNUkdVNFduaFNTMnh6VmpGSU5uYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnQyTEQ2bWFMRGU4WnhSS2xzVjFINnc%7C0dKxrV3ZLWB%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "a month ago",
        "comment": "Location, Location,  Location! This hotel made adventuring in Manhattan a breeze. Central Park, Radio City, Rockefeller Center, were all so close, there was simply no excuse to not take a walk and be in all the action. We loved to food trucks and vendors near by but we also enjoyed the walkable restaurants close by as well. Staff and facilities were great. I'm so happy we stayed here.",
        "review_reply": "Dear Natiesha,\nThank you for sharing your wonderful experience with us! It's great that our prime location, close to New York's best attractions and dining options, enhanced your visit. We're also happy that our friendly service added to your experience. It was a pleasure having you as our guest, and we look forward to welcoming you back for another memorable stay.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "Cozy and comfortable",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Times Square is walkable from here",
            "description": "Nearby activities"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_WALKABILITY",
            "name": "Walkability",
            "value": "10 out of 10",
            "description": "Walkability"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NOTEWORTHY_DETAILS",
            "name": "Noteworthy details",
            "value": "Parking and traffic is a nightmare.",
            "description": "Noteworthy details"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUizL79_bwGWMDpI7JDM4zojb6e6Ufpryfw23XnFxFSFJMHriK_=s120-c-rp-mo-ba3-br100",
          "display_name": "Amanda Garcia",
          "link": "https://www.google.com/maps/contrib/102898602342998029792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xWbGRIaHFUblkzZFdaaFdITlNRMlZNZDE5bmNHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOlVldHhqTnY3dWZhWHNSQ2VMd19ncGc%7C0dGM04hI_ys%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "comment": "From the moment we arrived, our experience at this hotel was nothing short of exceptional. The property is beautiful, impeccably clean, and thoughtfully designed for comfort and relaxation. Every detail reflected true five-star quality.\nWhat truly made our stay unforgettable was the incredible staff. The team went above and beyond to make us feel welcomed and valued. Special recognition to Lek at concierge, Christina in housekeeping, Brian and Joland at front desk for their professionalism, warmth, and genuine care. Their attentiveness and willingness to assist with every request during our stay as we celebrate a birthday made a lasting impression.\nHousekeeping was flawless, the amenities were excellent, and the overall atmosphere was both luxurious and inviting. This hotel sets the standard for hospitality, and we cannot wait to return.\nHighly recommend to anyone looking for an outstanding stay! Location a huge plus.",
        "review_reply": "Dear Amanda,\nIt's an absolute pleasure to read about the exceptional celebration experience you had with us here at New York Hilton Midtown. Thank you for going out of your way to write about our gorgeous property, where comfort and charm come together perfectly, and we're delighted our team was able to make your experience that much more memorable. We'll be sure your thoughtful compliments are shared with them, and we hope to have the opportunity to welcome you back soon, whether for another special occasion or simply a relaxing New York getaway.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJQgX50KQ8oURrMb8SgiRyqOysMS1rNXBa0wHN1BoF7o8ORvQ=s120-c-rp-mo-br100",
          "display_name": "Olaoluwa Ajilore",
          "link": "https://www.google.com/maps/contrib/115992020596208851571?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tObGJucGZObk5zTW01M1IzQXhkazgwUkZoclYzYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkNlbnpfNnNsMm53R3Axdk80RFhrV3c%7C0d3TryOnoQy%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I rarely write reviews, but I felt compelled to share my experience—especially because of the outstanding room service I’ve received. I’m currently staying here, and everything has been fantastic so far. What truly sets this place apart is the incredible housekeeping team on the 34th floor.\n\nThey are, without a doubt, the most attentive and genuinely kind crew I’ve encountered in any hotel across the country. Always cheerful, always ready to help—even when I’ve had the “Do Not Disturb” sign up, they’ve gone out of their way to check in if they see me in the hallway, just to make sure I don’t need anything. That level of care and consistency is rare, and it deserves to be celebrated.\n\nThey’re simply the best.",
        "review_reply": "Dear Olaoluwa,\nThank you for taking the time to share this, especially since you mentioned you rarely write reviews. It means even more to know you felt moved to speak about your stay while you’re still here with us. We're truly thrilled to hear how well everything has been going, and your kind words about our housekeeping team on the 34th floor mean the world. They take such pride in caring for our guests with thoughtfulness and genuine warmth, and it’s wonderful to know that their efforts have made such an impression. We'll be sure to share your message with them. I know it will brighten their day and remind them just how meaningful their care is. Thank you again for recognizing their hard work and spirit. We’re grateful to have you with us here at New York Hilton Midtown and are here for anything you may need for the rest of your visit. We hope the rest of your time with us continues to feel relaxing, comfortable, and well cared for!\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_GM@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_ROOMS",
            "name": "Rooms",
            "value": "perfect, nice view, great ambiance",
            "description": "Rooms"
          },
          {
            "id": "HOTELS_TIPS_TOPICS_NEARBY_ACTIVITIES",
            "name": "Nearby activities",
            "value": "Alot of activities",
            "description": "Nearby activities"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjXCL-8vEvUDz822rsEmwqB79dYFIjQbHiK1dnR4PV9_VvfzFXTB=s120-c-rp-mo-br100",
          "display_name": "Sandi Butler Hughes",
          "link": "https://www.google.com/maps/contrib/118216174767304514343?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT21Wc2JWWjJhVlpuZVcxWmVrVllVMFZSYzNBd1JrRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmVsbVZ2aVZneW1ZekVYU0VRc3AwRkE%7C0dDjnmf81ZY%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "2 months ago",
        "date": "2025-12-11",
        "comment": "We stayed here for the Macy’s Thanksgiving Day Parade. The elevators were crowded and the line could be long - but it was overall a great experience and I highly recommend staying here. Room service was fast and good. Staff was helpful. Great, central location!",
        "review_reply": "Dear Sandi,\nThank you for choosing us for your Thanksgiving parade stay and for sharing these thoughtful highlights! It is wonderful to hear that the central setting worked well, room service arrived quickly and hit the spot, and that our team provided helpful care throughout. We recognize that elevator demand can surge during major events, and we are committed to seeking ways to keep things moving more smoothly. It was a pleasure having you here, and we hope to welcome you back for another festive visit.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psih2_1OOcMpwE2s3oVDJsT3YU-z52F9_knHdLNoArRhctk8qSKNiZfebnmWcA4a2l9uILAIVTXWa0nJpv7vdFrXZVyVPyZgvz5gOjmU1QKE9wCuI64Fd8ojOo157ZUIP2EKx6tVOsVKikX"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great view",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUEYov0tioO-gi58kZLHwZ7jHvkGkquiLm9YYLfq7ZPZFhuYLpQ=s120-c-rp-mo-ba4-br100",
          "display_name": "Paula Januszkiewicz",
          "link": "https://www.google.com/maps/contrib/108960975385810447306?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tGVU9XbEhha3RHZDFKNWFsRkVXbEJWTjJKVWVHYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkFUOWlHaktGd1J5alFEWlBVN2JUeGc%7C0d2miwB-5in%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "date": "2025-11-08",
        "comment": "The reliable favorite! With great, relatively peaceful location, which I appreciate.\n\nI’ve stayed here a few times already - it’s always such a good and reliable hotel. But this time you really surprised me with the yogurt selection: one with a taste of rose and the other matcha - omg, thank you! That little detail truly made my day. So delicious!",
        "review_reply": "Dear Paula,\nThank you for staying with us at New York Hilton Midtown. It means a lot that we’re your go-to when you are in the city. We also love that the new yogurt flavors were a hit, and our team will be so happy that the little touch stood out to you. We appreciate your loyalty and look forward to welcoming you back.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psjBORXqPHXaA8lWVYVBmJZG9vNFgZadE2xV7IIBNmMrZYD-cGjNPlD5g8QZfocFZHbG0vrwkPt_mwVMQJqew7JhEdJycvA7kxGjvVCOIoJQjhFVXrOTTLWJcswEKDpSp550TagX22ZUSIP"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Luxury",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pKQllqQm5SSE5qYnpaTmRrbEdZMGMyTTBjNWJIYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjVW7IQQa1I-xPbiSjPFgq_yV38xEaaWp2c0eMF_rjbXydFynAgZ=s120-c-rp-mo-br100",
          "display_name": "Letícia Niquelatti",
          "link": "https://www.google.com/maps/contrib/106373021198817194762?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pKQllqQm5SSE5qYnpaTmRrbEdZMGMyTTBjNWJIYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjJBYjBnRHNjbzZNdklGY0c2M0c5bHc%7C0d8CZSE5EIx%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "I had a great experience at the New York Hilton Midtown. The location is excellent, allowing you to walk to many attractions. The hotel is well organized, the rooms are comfortable, and the staff was always polite and helpful. It’s a large property, but everything ran smoothly — fast check-in and no issues during my stay. I highly recommend it for its convenience and safety.",
        "review_reply": "Dear Letícia,\nThank you for sharing such a thoughtful review with us. It is wonderful that you enjoyed the convenience of the location and the ability to reach so many nearby attractions on foot. We're glad that the room felt comfortable, the property operated smoothly, and that our team treated you with consistent courtesy paints a picture of a stay that unfolded just as it should. A seamless check-in and a sense of safety in a large property can make travel feel effortless, and it is great that was your experience. We appreciated having you with us, and we hope your travels bring you back again.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xkSlZ6ZHRkalZIU2pSaFVWbDRVMnhLZGpoSlFVRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocK9GUmz3QdZCvkPYxAkURvSbS2BhSQZKA7dSq0aBC9gzYk3SA=s120-c-rp-mo-ba4-br100",
          "display_name": "Alison N",
          "link": "https://www.google.com/maps/contrib/114280676597674102522?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xkSlZ6ZHRkalZIU2pSaFVWbDRVMnhLZGpoSlFVRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOldJVzdtdjVHSjRhUVl4U2xKdjhJQUE%7C0cmFqFJatJu%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "5 months ago",
        "comment": "I had a great stay at the Hilton Midtown. Check-in, room upgrade, and check-out were all very smooth and easy. The rooms are spacious, clean, and comfortable, and the staff is very friendly.\nThere can be a bit of a wait for the elevators, which is slightly inconvenient, but nothing too bothersome. The location is perfect, right in the center of New York, with taxis always available and plenty of restaurants and shops around.\nA nice extra perk: $35 per day to spend at the hotel’s restaurants. Overall, a very good experience. Highly recommend!",
        "review_reply": "Dear Alison,\nThank you for your wonderful review! We’re delighted that you enjoyed your stay at New York Hilton Midtown, from our smooth check-in and room upgrade to the comfort and cleanliness of our accommodations. It’s great that our central location and daily dining credit added to your experience. We appreciate your patience with the elevator wait times and are always working to improve convenience for our guests. Your recommendation means so much to us, and we look forward to welcoming you back for another unforgettable getaway in the future.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "5 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Business",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Friends",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pOQmVEWnBZMGRHY1ROMlUxQnplRTFKU20wNVptYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjVq8BGEqL10iiXMHjAAkzBnco5rg50LjBZJg1lY604ktQnnVDxUUA=s120-c-rp-mo-ba5-br100",
          "display_name": "Brad Woodruff",
          "link": "https://www.google.com/maps/contrib/110607930004076171319?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pOQmVEWnBZMGRHY1ROMlUxQnplRTFKU20wNVptYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOjNBeDZpY0dGcTN2U1BzeE1JSm05Zmc%7C0d6dIFB_rJH%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "5/5",
        "created": "3 months ago",
        "comment": "The hotel is basic at best. If you want the NYC experience, stay in Times Square or on the rivers.\n\nWhere this hotel excels is location. It's in the heart of Midtown, convenient to Central Park and a host of subway holes to get to the rest of the city.  A good home base for your stay.\n\nIt's a huge hotel with a lot of rooms, so be prepared to wait to check in/out.\n\nThe room (queen, city view, 27th floor) was a normal room with little amenities included, and that was an upgrade. But again, it's location, location, location.\n\nThe Executive Lounge is also basic, but the staff is too notch. Super friendly and attentive. Plus it's a good place to stock up on waters and fruit before your daily excursions. Or to stop in for Happy Hour to grab a snack before a proper dinner.\n\nThe gym is massive. So many bikes, treadmills, ellipticals and stations. Honestly one of the biggest gyms I have seen in a hotel.",
        "review_reply": "Dear Brad,\nThank you for sharing your review. It’s great to know that our central setting served as a convenient starting point for exploring the city, along with our well-equipped fitness center. Our Executive Lounge team will be thrilled to hear that they made a meaningful impression. At the same time, it’s understood that certain aspects of the room and overall experience didn’t meet your expectations, and your perspective is invaluable as enhancements are continually evaluated. Your insights help guide us, and it would be a pleasure to welcome you back to New York Hilton Midtown again soon.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "3 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 5,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 5,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Great value",
            "description": "How would you describe the hotel?"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Sort (lowest)
Source: https://docs.brightdata.com/api-reference/serp/google-reviews/sort-lowest

Configure the Bright Data Google Reviews Sort (Lowest) parameter to refine queries and return matching results as JSON or HTML. On port 44445.

```txt wrap theme={null}
https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow
```

## Parameters

<ParamField type="string">
  Feature id what you want to fetch reviews to. `fid` parameter can be found in `knowledge.fid` field of google search response.
</ParamField>

<ParamField type="string">
  The way reviews are sorted.

  | value | description |
  | - | - |
  | `sort=qualityScore` | most relevant first (`default`) |
  | `sort=newestFirst` | newest first |
  | `sort=ratingHigh` | highest rating first |
  | `sort=ratingLow` | lowest rating first |

  ```txt wrap theme={null}
  https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow
  ```
</ParamField>

<RequestExample>
  ```shell cURL highlight={6} theme={null}
    curl -X POST https://api.brightdata.com/request \
    --header "Content-Type: application/json" \
    --header "Authorization: Bearer API_KEY" \
    --data '{
      "zone": "serp_api1",
      "url": "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow",
      "format": "raw"
    }'
  ```

  ```shell Native proxy highlight={4} theme={null}
  curl --proxy brd.superproxy.io:44445 \
    --proxy-user CUSTOMER_USERNAME:CUSTOMER_PASSWORD \
    --ssl-no-revoke \
    "https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow"
  ```

  ```js Node.js highlight={10} theme={null}
  (async () => {
    const response = await fetch('https://api.brightdata.com/request', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'
      },
      body: JSON.stringify({
        zone: 'serp_api1',
        url: 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow',
        format: 'raw'
      })
    });
    
    const data = await response.text();
    console.log(data);
  })();
  ```

  ```python Python highlight={11} theme={null}
  import requests

  # API Configuration
  headers = {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer API_KEY',
  }

  payload = {
      'zone': 'serp_api1',
      'url': 'https://www.google.com/reviews?fid=0x89c25855c0679529:0x2a34371cb33f3c80&sort=ratingLow',
      'format': 'raw'
  }

  # Make the request
  response = requests.post(
      'https://api.brightdata.com/request', 
      json=payload, 
      headers=headers
  )

  print(response.text)
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "reviews": [
      {
        "review_id": "ChdDSUhNMG9nS0VQZm1zUENtb0xMc3NRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QcielscjLvsxs3qLg_jAt2zcU0gRqU3PrSHHU2lAuv568Mt5lG3Clk44mfbfmM4sEJa1w=s120-c-br100",
          "display_name": "Caity",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "5 months ago",
        "comment": "Positive: The bathroom was dirty when we arrived. The sink drain was broken and pulled out laying on the sink. The bathtub backed up and filled with water each time we showered. We repeatedly asked for this to be fixed and they did not. Negative: The lightbulb was out in the haPlay with the only mirror we called them and talked to them in person a total of 4 times. They never replaced it. Staff were rude and unhelpful."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VQcTd2ZXJSM3NmdmxBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QeAy-xp9ZrUglhBV1LZEaPGpmlbQnwJJRBzU4YC55Z65V5JcBYvtxvOT-WqxVgRv6wAOA=s120-c-br100",
          "display_name": "Alessandro",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "6 months ago",
        "comment": "Positive: Location Negative: I was scamed with the pricing ( the so called city tax which was never mentioned. Also one of the reasons why I booked it said he offered shuttle to the airports. The hotel lounge  literally scamed.me out of money .the bar tender was a scammer"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnTUR3ZzY2NmtBRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QfitSTClYz8LWcvgW5L4tnq-tcK0wDRS5KpgF4zUnjMZguvii9otIV06c_gvv3urQy3ZQ=s120-c-br100",
          "display_name": "Thea",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "11 months ago",
        "comment": "Positive: \"\" Negative: No microwave, rude staff and they were unwilling to help and did not seem to care. Also, HIlton customer service wouldn't help me when i told them i had issues with the staff and they told me to contact the hotel directly. What are you here for then?."
      },
      {
        "review_id": "ChdDSUhNMG9nS0VKR2Y0b0hjb3V6WDFRRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0QchhyJTr8jjr7kbZNRY9gkp3EPmuhZxKqlMWJ5peJxoA1in-DXrIhwxitaLgo-qo75Ujg=s120-c-br100",
          "display_name": "Dan",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "10 months ago",
        "comment": "Positive: nothing really one of the worst experiences i had staying in a hotel Negative: got to the room at 10 pm nothing went right worst ever"
      },
      {
        "review_id": "ChdDSUhNMG9nS0VJQ0FnSURmdEpLdzJnRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/local-reviews/AJMZ0Qe1FTSCg98CZ3VrSg28YAOa76nyaQfZNd66XhsW7MF99ozoooauY0gRdjL2-kPkUfooOQ=s120-c-br100",
          "display_name": "Mary",
          "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532"
        },
        "link": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_39532&hotel_id=39532",
        "source": "Priceline",
        "source_logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png",
        "rating": "1/10",
        "created": "a year ago",
        "comment": "Positive: \"\" Negative: The metalBed frames stuck out and I sliced my leg and had to get 7 stitches from mt Sinai hospital"
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjWR9P0hsugLdp9Oat4sxTahBKrA0gZ1C7uqw4MNisrIvLu3hy-V=s120-c-rp-mo-ba2-br100",
          "display_name": "Jennifer Wakefield",
          "link": "https://www.google.com/maps/contrib/114840974672973065687?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSbFJsWmxYME5KZEVsQ1lrZHZiRXd4Y21SdVptYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkRlRlZlX0NJdElCYkdvbEwxcmRuZmc%7C0dI--RQ5bgo%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "Edited 2 months ago",
        "date": "2025-12-24",
        "comment": "The location is fabulous. Everything else is terrible. This hotel has severely gone downhill over the years. It is not a four star maybe a two star at best. The rooms were adequate. The bathroom was disgusting and had discolored water forcing us to brush our teeth with bottled water. The wait for the elevators was ridiculous and we ended up using the service elevators and that area was absolutely disgusting and did not feel safe.",
        "review_reply": "Dear Jennifer,\nThough we are glad you enjoyed our central location, we regret that other aspects of your visit fell below your expectations and the high standards we strive for. What you have described regarding our accommodations, amenities, and the comfort and convenience we aim to consistently provide our guests is not typical for us. Rest assured, your insights will be promptly addressed for review and correction. We hope to welcome you back in the future to change your lasting impressions. \n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "photos": [
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptLCFihq0e2Rr2xf5cBpxANMMhfDf1JNipzZV2xKzKvd-Td8Qfo806H4UwgM0apfWvMJArehhlrJbvtpuZyVzbpeBnkVhyxekIHl5lw7aRAKEy5Qw6DMp1-Ra6BPNVObzRdWeu7N9tJKFQ",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9ptpkESmccJfCgtjbmg66XKUKhbCM_Z8uVSsZ9a1wSHiSeaTKmsqURZ5b_UTuXuVxraFCv-MEHjqkhz10E3BsL2XiV3iQlmNEzik1QUg2tHyJVUJYF3XePBNCursMNftK2ATijYCAE3XIGk",
          "https://lh3.googleusercontent.com/geougc-cs/ABOP9psDnhsuOCuRiEKmw2YqOiDUbqGeziogZ0aJj0PL8tIz4-PbpFotEiJa1hZ4reobYw54gMKgbmU-ahevtF4KefFBTpBtOs_6jB8OQBjZiQGtEXE69koipvhvJPHSG0ADdpnkNyYkf4FQxc0"
        ],
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocJ2aeQdtiJkWeCyxq8wk3mwShLLZdvL3mNfhS0phcXWil15iw=s120-c-rp-mo-ba2-br100",
          "display_name": "Sarah Vertrees",
          "link": "https://www.google.com/maps/contrib/114286611919008365782?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT213M01Ib3daVTEwZFdrNFREZG1XbVEyV0ZCQkxYYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOmw3MHowZU10dWk4TDdmWmQ2WFBBLXc%7C0dHofB_sbAT%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "The only positive about this hotel is the location.\n\nWhen we arrived we were told that they were out of parking so we had to park ourselves in the parking garage across the street.\n\nWe paid over $600 a night for a room that was fair at best. It was very dated, screws missing out of the door handle, semi-clean, the bath tub wouldn’t drain-when I went to adjust the stopper it came out and the bath tub itself was pealing, the hotel staff were all less than pleasant!\n\nAs many others have mentioned the elevator stops a nightmare!",
        "review_reply": "emailed guest",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          },
          {
            "id": "HOTELS_VIBE",
            "name": "Hotel highlights",
            "value": "Kid-friendly",
            "description": "How would you describe the hotel?"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjUfusV7ZUjUCOLqMSt3fppZPTMYkLGZT4DP2M1Af_cL-58ns8WggA=s120-c-rp-mo-br100",
          "display_name": "Alison McGuckin",
          "link": "https://www.google.com/maps/contrib/117751954034681560040?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT25oNFUwVnVkRTB3Y1ZGM2JreHFSVEZXU0hOdFNXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOnh4U0VudE0wcVF3bkxqRTFWSHNtSWc%7C0dC2Wfaja3C%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Everything about this hotel would be great if it weren’t for the horrid elevator situation. It took 30 minutes for us to get 4 people downstairs from floor 38. We had to separate as a group to put one person into an elevator every time it showed up and actually had room. While in the jam packed elevator you would stop at every single floor, only for most of them to not even have anyone getting off there or waiting. We used to love this hotel, now we’ll be looking for a different midtown stay.",
        "review_reply": "Good morning, Alison, \nThank you for providing details of your experience with us. I would love to connect with you and make things right. We are currently unable to locate a reservation in your name. Can you kindly send your reservation details to Hannah.Zipkin@hilton.com? I look forward to hearing from you.",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 4,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 4,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 4,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT201VFZHMXJXRmhRY1d4aGVFUXRTVTlxVGxwS2FXYxAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a/ACg8ocKFFBoM5okLNgq5lmdU_db_kYw5sStw7_b6myemC4LpgdpvYA=s120-c-rp-mo-br100",
          "display_name": "Elizabeth Hubbard",
          "link": "https://www.google.com/maps/contrib/107665312411597262592?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT201VFZHMXJXRmhRY1d4aGVFUXRTVTlxVGxwS2FXYxAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOm5TVG1rWFhQcWxheEQtSU9qTlpKaWc%7C0dEm9J76k0S%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "2 months ago",
        "comment": "Unfortunately, this stay was a major disappointment. We were asked to pay $100 for early check-in despite being Hilton members. The hotel was extremely overcrowded, the lobby was chaotic, and the elevator wait times were outrageous—often 10–20 minutes—forcing us to take the stairs from the 7th floor.\n\nLate checkout was denied unless we paid extra, bag storage took over 45 minutes and cost $5 per bag, and there weren’t even complimentary bottles of water in the room. Overall, the experience felt focused on squeezing money out of guests rather than providing hospitality. Very disappointing, and we will never stay at this hotel again.",
        "review_reply": "Dear Elizabeth,\nThank you for being a Hilton Honors member and for taking the time to share such a detailed account of your stay. We’re genuinely sorry to hear of the issues you encountered. Long elevator wait times and missing in-room amenities are never the impression we want any of our guests to have.  Your feedback will be reviewed with the team as we continue to focus on improving comfort, clarity, and support for all our guests. We appreciate you outlining your experience so thoughtfully and hope you will consider giving us another chance to improve your lasting impression.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "2 months ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Family",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 3,
            "description": "Location"
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2twRWJUSTVkVTQxTTNnNGVtTnhlVlZ3V1V0RmRsRRAB",
        "reviewer": {
          "profile_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjW0NZGbAlQzaaxlwFZWEu7-nWpfPfpd-WTTzOnIPQ4L301tf5gX=s120-c-rp-mo-ba4-br100",
          "display_name": "Langee Twentytwo",
          "link": "https://www.google.com/maps/contrib/108549160741845792792?hl=en"
        },
        "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2twRWJUSTVkVTQxTTNnNGVtTnhlVlZ3V1V0RmRsRRAB!2m1!1s0x0:0x2a34371cb33f3c80!3m1!1s2@1:CAIQACodChtycF9oOkpEbTI5dU41M3g4emNxeVVwWUtFdlE%7C0dJIrIshcA6%7C?hl=en",
        "source": "Google",
        "source_logo": "https://www.gstatic.com/images/branding/product/1x/googleg_48dp.png",
        "rating": "1/5",
        "created": "a month ago",
        "comment": "Great location. Terribly ran hotel. The first night they took our towels and didn’t replace them. The executive line either had no food or a line out the door. Service was dismissive in all areas. Starting with the front desk. They have convinced me to cancel my Hilton card and open a Marriott car, even as a Diamond member. Awful experience.",
        "review_reply": "Dear Langee,\nWe regret that our team's service did not meet expectations. What you've described is not the typical experience of our guests, and we will address these concerns promptly. Thank you for bringing these matters to our attention, and we hope you will consider giving us another chance to change your perceptions in the future.\n\nSincerely,\n\nNew York Hilton Midtown Team\n\nNYCNH_FO@hilton.com",
        "review_reply_created": "a month ago",
        "details": [
          {
            "id": "HOTELS_PILOT_TRIP_TYPE",
            "name": "Trip type",
            "value": "Vacation",
            "description": "What kind of trip was it?"
          },
          {
            "id": "HOTELS_PILOT_TRAVEL_GROUP_TYPE",
            "name": "Travel group",
            "value": "Couple",
            "description": "Who did you travel with?"
          },
          {
            "id": "HOTELS_ASPECT_ROOMS",
            "name": "Rooms",
            "value": 1,
            "description": "Rooms"
          },
          {
            "id": "HOTELS_ASPECT_SERVICES",
            "name": "Service",
            "value": 1,
            "description": "Service"
          },
          {
            "id": "HOTELS_ASPECT_LOCATION",
            "name": "Location",
            "value": 5,
            "description": "Location"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>


# Add static IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/Add_Static_Datacenter_ISP_IPs

api-reference/openapi POST /zone/ips
Use the Bright Data Account Management API to add Static IP(s). POST /zone/ips returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Get account available countries
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Available_Countries

api-reference/openapi GET /countrieslist
Use the Bright Data Account Management API to get account available countries. GET /countrieslist returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Zone statistics
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_Static_Datacenter_ISP_IPs

api-reference/openapi GET /zone/ips
Use the Bright Data Account Management API to zone Statistics. GET /zone/ips returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

```json Response when "ip_per_country=true" theme={null}
{
    "gb":198,
    "de":282,
    "br":418,
    "au":115,
    "jp":292,
    "nl":421,
    "uz":333,
    "il":517,
    "kg":566,
    "az":498,
    "lv":484,
    "tw":372,
    "sg":184
}
```


# Zone password
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_Zone_passwords

api-reference/openapi GET /zone/passwords
Use the Bright Data Account Management API to zone Password. GET /zone/passwords returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Get available dedicated IPs per zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_all_available_dedicated_residential_IPs_per_Zone

api-reference/openapi GET /zone/route_vips
Use the Bright Data Account Management API to get available dedicated IPs per Zone via GET /zone/route_vips, returning JSON zone or account data with 200 OK.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Warning>Only works with residential dedicated zone</Warning>


# Available Datacenter and ISP IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_amount_of_available_Datacenter_and_ISP_IPs

api-reference/openapi GET /zone/count_available_ips
Use the Bright Data Account Management API to available Datacenter and ISP IPs via GET /zone/count_available_ips, returning a 200 OK JSON response.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Accordion title="Plan Examples">
  * Available IPs for current Zone plan:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?zone=ZONE" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, dedicated IPs:

  ```sh dedicated IPs theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"dedicated\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in United States:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"country\":\"us\",\"ips_type\":\"shared\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, dedicated ips located in United States:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"country\":\"us\",\"ips_type\":\"dedicated\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in United States, Denver:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"shared\",\"country_city\":\"us-denver\",\"city\":true\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in US, exclusive for domains: amazon.com, fb.com:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"selective\",\"country\":\"us\",\"domain_whitelist\":\"amazon.com%20fb.com\"\}" -H "Authorization: Bearer API_KEY"
  ```

  * Abstract plan, shared IPs located in US, geo IP databases: should persist in both maxmind and dbip:

  ```sh theme={null}
  curl "https://api.brightdata.com/count_available_ips?plan=\{\"ips_type\":\"shared\",\"country\":\"us\",\"geo_db\":\{\"maxmind\":true,\"dbip\":true\}\}" -H "Authorization: Bearer API_KEY"
  ```
</Accordion>


# Get country cities
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_country_cities

api-reference/openapi GET /cities
Use the Bright Data Account Management API to get Country Cities. GET /cities returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# List static network cities by country
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_list_of_available_cities_of_static_network_per_country

api-reference/openapi GET /zone/static/cities
Use the Bright Data Account Management API to list static network cities by country via GET /zone/static/cities, returning a 200 OK JSON response.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Live status of static zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_live_status_of_Static_Datacenter_ISP_Zone_and_IPs_with_connectivity_problem

api-reference/openapi GET /zone/ips/unavailable
Use the Bright Data Account Management API to live status of Static Zone. GET /zone/ips/unavailable returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Recent IPs attempting to use your zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_recent_IPs_attempting_to_use_your_Zone

api-reference/openapi GET /zone/recent_ips
Use the Bright Data Account Management API to recent IPs attempting to use your Zone via GET /zone/recent_ips, returning JSON zone or account data with 200 OK.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Available Datacenter & ISP IPs/zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_available_Data_center_ISP_IPs_per_Zone

api-reference/openapi GET /zone/route_ips
Use the Bright Data Account Management API to available Datacenter & ISP IPs/Zone. GET /zone/route_ips returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Bandwidth stats for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone

api-reference/openapi GET /zone/bw
Use the Bright Data Account Management API to bandwidth stats for a zone. GET /zone/bw returns 200 OK with zone or account configuration data as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Bandwidth stats for all your zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_bandwidth_stats_for_all_your_Zones

api-reference/openapi GET /customer/bw
Retrieve bandwidth consumption stats for every Bright Data API across your account in 1 request, with totals returned per product and time window as JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Note>Sample response redacted</Note>


# Total cost & bandwidth for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Get_the_total_cost_and_bandwidth_stats_for_a_Zone

api-reference/openapi GET /zone/cost
Returns 200 OK with billed cost, bandwidth and usage for a Zone over a date range. Matches the Control Panel Usage Overview and your invoice.

<Warning>
  **The `to` parameter is exclusive.** The day specified in `to` is **not** included in the result. To match a calendar month shown in the Control Panel or on your invoice, set `to` to the first day of the **following** month. For example, `from=2026-04-01&to=2026-05-01` returns all of April 2026.
</Warning>

<Note>
  This endpoint is scoped to a single zone and cannot return Web Scraper API or Scraper Studio cost data (those are keyed by `dataset_id` / collector ID, not by zone name). For multi-product or WSA / Scraper Studio breakdowns, use [Cost breakdown export](/api-reference/account-management-api/Export_cost_breakdown).
</Note>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F).
</Tip>

## Reproduce your monthly invoice

To retrieve the exact billed cost and usage for a calendar month as shown in the Control Panel and on your invoice, set `from` to the first day of the month and `to` to the first day of the **following** month:

```bash theme={null}
# Returns billed usage for all of April 2026
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.brightdata.com/zone/cost?zone=YOUR_ZONE&from=2026-04-01&to=2026-05-01"
```

Using `to=2026-04-30` would omit the last day of the month. Always set `to` to the day **after** the last day you want included.

## Reconciling with raw request logs

The values returned by this endpoint are the source of truth for billing. They match the Control Panel's Usage Overview and your invoice. If you compare these values against raw request logs you collect yourself (e.g., access logs forwarded to Logz, CloudWatch, or another sink), expect differences of a few percent. Raw logs may capture requests that were never committed to the billing database because of async aggregation timing or transient network issues. Your invoice always reflects the values returned by this endpoint.

## Related endpoints

* [Bandwidth stats for a Zone](/api-reference/account-management-api/Get_the_bandwidth_stats_for_a_Zone). Bandwidth only, no cost.
* [Bandwidth stats for all your Zones](/api-reference/account-management-api/Get_the_bandwidth_stats_for_all_your_Zones). Aggregate across zones.


# Migrate static IPs between zones
Source: https://docs.brightdata.com/api-reference/account-management-api/Migrate_Static_Datacenter_ISP_IPs_between_zones

api-reference/openapi POST /zone/ips/migrate
Use the Bright Data Account Management API to migrate Static IPs between zones. POST /zone/ips/migrate returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Refresh static IPs (Datacenter/ISP)
Source: https://docs.brightdata.com/api-reference/account-management-api/Refresh_Static_Datacenter_ISP_IPs

api-reference/openapi POST /zone/ips/refresh
Use the Bright Data Account Management API to refresh Static IPs (Datacenter/ISP) via POST /zone/ips/refresh, returning JSON zone or account data with 200 OK.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

```json Sample Response for Static IPs theme={null}
{
    "ips":[
        "1.1.1.1",
        "1.1.1.2",
        "1.1.1.3"
    ],
    "new_ips":[
        "1.1.1.1",
        "1.1.1.3"
    ]
}
```


# Refresh dedicated residential IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Refresh_dedicated_residential_IPs

api-reference/openapi POST /zone/ips/refresh
Use the Bright Data Account Management API to refresh dedicated residential IPs via POST /zone/ips/refresh, returning JSON zone or account data with 200 OK.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>

<Warning>
  Each dedicated residential IP refreshed costs \$0.02/refresh/IP
</Warning>


# Remove static IPs (Datacenter/ISP)
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_Static_Datacenter_ISP_IPs

api-reference/openapi DELETE /zone/ips
Use the Bright Data Account Management API to remove Static IPs (Datacenter/ISP). DELETE /zone/ips returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove dedicated residential IPs
Source: https://docs.brightdata.com/api-reference/account-management-api/Remove_dedicated_residential_IPs

api-reference/openapi DELETE /zone/vips
Use the Bright Data Account Management API to remove dedicated residential IPs. DELETE /zone/vips returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Turn on/off zone
Source: https://docs.brightdata.com/api-reference/account-management-api/Turn_on_off_Zone

api-reference/openapi POST /zone/change_disable
Use the Bright Data Account Management API to turn on/off Zone. POST /zone/change_disable returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Add zone password
Source: https://docs.brightdata.com/api-reference/account-management-api/add-zone-password

api-reference/openapi POST /zone/add_password
Use the Bright Data Account Management API to add Zone Password. POST /zone/add_password returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Note>
  To add multiple passwords in a single request, pass an array of strings to the `password` field.
</Note>


# Allowlist IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/allowlist-ip

api-reference/openapi POST /zone/whitelist
Use the Bright Data Account Management API to allowlist IP(s). POST /zone/whitelist returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Allowlist/denylist domain(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/allowlist-or-denylist-domains

api-reference/openapi POST /zone/domain_perm
Use the Bright Data Account Management API to allowlist/Denylist Domain(s). POST /zone/domain_perm returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Denylist IP(s)
Source: https://docs.brightdata.com/api-reference/account-management-api/denylist-ip

api-reference/openapi POST /zone/blacklist
Use the Bright Data Account Management API to denylist IP(s). POST /zone/blacklist returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Domain consumption
Source: https://docs.brightdata.com/api-reference/account-management-api/domain-consumption

api-reference/proxy-manager GET /domains/{metric}
Retrieve per-domain usage metrics including bandwidth and request count from the Bright Data Domain Consumption API. Returns 200 OK with JSON results.

## Sample Requests

<CodeGroup>
  ```sh All zones theme={null}
  curl --request GET \
    --url 'api.brightdata.com/domains/bw?from=2025-12-01&to=2025-12-10' \
    --header 'Authorization: Bearer API_KEY'
  ```

  ```sh Bandwidth by zone theme={null}
  curl --request GET \
    --url 'api.brightdata.com/domains/bw?from=2025-12-01&to=2025-12-10&zones=zone_name' \
    --header 'Authorization: Bearer API_KEY'
  ```

  ```sh Requests by zone theme={null}
  curl --request GET \
    --url 'api.brightdata.com/domains/req?from=2025-12-01&to=2025-12-10&zones=zone_name' \
    --header 'Authorization: Bearer API_KEY'
  ```
</CodeGroup>


# Get proxies pending replacement
Source: https://docs.brightdata.com/api-reference/account-management-api/get-proxies-pending-replacement

api-reference/openapi GET /zone/proxies_pending_replacement
Use the Bright Data Account Management API to get Proxies Pending Replacement via GET /zone/proxies_pending_replacement, returning a 200 OK JSON response.



# Remove domain from allow/denylist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist

api-reference/openapi DELETE /zone/domain_perm
Use the Bright Data Account Management API to remove domain from allow/denylist via DELETE /zone/domain_perm, returning JSON zone or account data with 200 OK.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove IP from zone allowlist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-ip-from-zone-allowlist

api-reference/openapi DELETE /zone/whitelist
Use the Bright Data Account Management API to remove IP from Zone allowlist. DELETE /zone/whitelist returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove IP from zone denylist
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-ip-from-zone-denylist

api-reference/openapi DELETE /zone/blacklist
Use the Bright Data Account Management API to remove IP from Zone denylist. DELETE /zone/blacklist returns 200 OK with zone or account JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning> **Warning:** This API can modify your account settings, damage your operations or incur charges.</Warning>

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# Remove zone password
Source: https://docs.brightdata.com/api-reference/account-management-api/remove-zone-password

api-reference/openapi POST /zone/remove_password
Use the Bright Data Account Management API to remove Zone Password. POST /zone/remove_password returns 200 OK with zone or account configuration data as JSON.

<Warning>Only users with **Admin** or **Ops** roles can perform this action.</Warning>

<Warning>
  A zone must always have at least one password. This request will fail if removing the specified password(s) would leave the zone with no passwords.
</Warning>

<Note>
  To remove multiple passwords in a single request, pass an array of strings to the `password` field.
</Note>


# List of allowlisted IPs for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/zone-ip-allowlist

api-reference/openapi GET /zone/whitelist
Use the Bright Data Account Management API to list of allowlisted IPs for a zone. GET /zone/whitelist returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# List of denylisted IPs for a zone
Source: https://docs.brightdata.com/api-reference/account-management-api/zone-ip-denylist

api-reference/openapi GET /zone/blacklist
Use the Bright Data Account Management API to list of denylisted IPs for a zone. GET /zone/blacklist returns 200 OK with zone or account JSON.

<Tip>
  Paste your API key to the authorization field. To get an API key, [Create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](/api-reference/authentication#how-do-i-generate-a-new-api-key%3F)
</Tip>


# How to set up Bright Data with AdsPower
Source: https://docs.brightdata.com/integrations/adspower

Pair Bright Data (400M+ residential IPs) with AdsPower to stay secure and undetectable for privacy-focused research and market intelligence at scale.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is AdsPower?

AdsPower is a versatile anti-detect browser perfect for marketers, researchers, and data professionals who need a secure, efficient way to manage multiple browser profiles. Each profile runs in its own isolated environment, keeping your activities discreet and safe from detection.

With AdsPower, you get unique digital fingerprints for every profile, things like IP address, device type, and user agent, ensuring your actions stay under the radar. Whether you’re collecting web data, conducting market research, or working on affiliate marketing, AdsPower keeps your browsing profiles secure and private.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## AdsPower Proxy Integration

Integrating Bright Data proxies with AdsPower is quick and easy. Let’s set you up in a few simple steps:

Step 1. **Download AdsPower**. Head over to the [AdsPower website](https://www.adspower.com/download) to download and install the app.

Step 2. **Create a New Profile.** Once the app is installed, open it and click **New Profile** to create your first browser profile.

<Frame>
  <img alt="AdsPower Proxy Integration" />
</Frame>

Step 3. **Configure Your Proxies**. Now, let’s set up your Bright Data proxy. Follow these simple steps:

* **Proxy Type**: Choose from`HTTP`,`HTTPS`, or`SOCKS5`(based on your proxy type).

* **Proxy Host**: Enter[`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

* **Proxy Port**: 44445

* **Proxy Username**: Enter your Bright Data proxy zone`username`.

* **Proxy Password**: Enter your Bright Data proxy zone`password`.

Step 4: Click **Check Proxy** to ensure everything is working.

<Note>
  Some versions of AdsPower use `google.com` as their default test site. Bright data proxies are blocking `google.com`. Validate this is not a search engine website.
</Note>

<Note>
  If you chose either Residential or Mobile proxies you must install Bright Data SSL certificate to secure your end to end communication. **Otherwise you will encounter Errors**.
  SSL installation instructions can be found [here](/general/account/ssl-certificate#ssl-certificate)
  Alternatively, you can ignore SSL verification on AdsPower: Go to advanced settings when setting up a profile and paste: `--ignore-certificate-errors` in launch args.
</Note>

<Info>
  **For country-specific proxies, you can enter a format like `your-username-country-us` to receive a United States exit node.**
</Info>

Once everything is in place, click **OK** to save your settings.

Step 5. **Launch the Browser**.\
Click **Open** under **Tags** to launch your browser with the configured proxy.

<Frame>
  <img alt="AdsPower Proxy Integration" />
</Frame>

That’s it! You’ve successfully integrated Bright Data proxies with AdsPower, and you’re ready to go.


# How to set up Bright Data with Agno
Source: https://docs.brightdata.com/integrations/agno

Use Bright Data's MCP toolkit in Agno to give AI agents real-time web access and structured data extraction from 40+ platforms.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The Bright Data MCP toolkit is now available in Agno, bringing real-world web access to AI agents. This integration enables structured data extraction and web scraping from over 40 platforms, including Amazon, LinkedIn, TikTok, Instagram, and Facebook.

Agents can perform tasks like scraping product listings, capturing screenshots, running search queries, and accessing live structured data feeds, all with minimal setup. This makes it easy to build intelligent agents that can reason, act, and fetch real-time web data for research, automation, and monitoring.

## How to Integrate Bright Data With LangChain

<Steps>
  <Step title="Pre-requisites">
    * Bright Data API key
    * Active SERP Zone for search engine capabilities
    * Active Web Unlocker API zone for Scraping
  </Step>

  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    You can install the Bright Data integration directly from GitHub using the tool code available [here](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/brightdata.py).

    <Note>
      This integration will be published to **PyPI** by the end of the week. Once available, you’ll be able to install it using:

      ```sh theme={null}
      pip install agno
      ```
    </Note>
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python theme={null}
    import os


    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```
  </Step>

  <Step title="Example usage">
    ```python theme={null}
    from agno.agent import Agent
    from agno.tools.brightdata import BrightDataTools 
    from agno.models.openai import OpenAIChat 
    from dotenv import load_dotenv 

    load_dotenv() 

    agent = Agent(
      tools=[
          BrightDataTools(
            serp_zone="serp",
            web_unlocker_zone="unlocker"
          )
        ],
      show_tool_calls=True,
      model=OpenAIChat(id="gpt-4o-mini"),
    ) 

    agent.print_response("Search for AAPL news", markdown=True)
    ```
  </Step>
</Steps>


# Overview
Source: https://docs.brightdata.com/integrations/ai-integrations

Connect Bright Data (thousands of pre-built scrapers) to AI and ML workflows for RAG pipelines, agent search and structured data collection via the MCP server.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Which AI integrations are supported

<CardGroup>
  <Card title="LangChain" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/langchain.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=c73d66ffa0b6a9f411e7c369d732ac47" href="/integrations/langchain">
    Connect LLMs with external data and agents using LangChain.
  </Card>

  <Card title="OpenClaw" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/openclaw.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=504ea1dc94bc5e061df293d0bfdd174a" href="/integrations/openclaw">
    Give your OpenClaw AI agent web search, scraping, browser automation, and 50+ structured data tools.
  </Card>

  <Card title="OpenClaw on Railway" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/openclaw.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=504ea1dc94bc5e061df293d0bfdd174a" href="/integrations/openclaw-railway">
    Deploy an OpenClaw agent with 66 Bright Data tools on Railway in one click.
  </Card>

  <Card title="Crew AI" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/crew-ai.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=4bf84f44575e2469cea09fb8d9b70399" href="/integrations/crew-ai">
    Build and scale AI workflows with Crew AI.
  </Card>

  <Card title="Vercel AI SDK" icon="https://assets.vercel.com/image/upload/q_auto/front/favicon/vercel/favicon.ico" href="/integrations/vercel-ai-sdk">
    Build production-ready AI apps with Vercel AI SDK.
  </Card>

  <Card title="Yutori" icon="https://yutori.com/logo-dark.svg" href="/integrations/yutori">
    Browse the web autonomously with Yutori's n1 reasoning model and Bright Data's Scraping Browser
  </Card>

  <Card title="Haystack" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/haystack.jpg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=440249b2f8cef9244e60697eedf0243b" href="/integrations/haystack">
    Enhances your RAG pipelines and AI applications with Haystack.
  </Card>

  <Card title="Mastra" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/mastra.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=fc987035364e7df036d203618a8f1258" href="/integrations/mastra">
    Build intelligent AI agents with web scraping, search, and data extraction capabilities.
  </Card>

  <Card title="Dify" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/dify.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=f8d0159f3a7b28da23619aa8184a1dc6" href="/integrations/dify">
    Access real-time web data in Dify with Bright Data
  </Card>

  <Card title="Lindy.ai" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/lindy-ai.webp?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=2665cf234bbeccb9f3762ab9759cdf24" href="/integrations/lindy-ai">
    Enhance your AI applications with Lindy.ai's powerful features.
  </Card>

  <Card title="LlamaIndex" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/integrations/ai-integrations/llamaindex.png" href="/integrations/llama-index">
    Simplify data retrieval and management for LLMs with LlamaIndex.
  </Card>

  <Card title="make.com" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/make.com.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=e67579fa07705baa5bf3e807a50b8d73" href="/integrations/make">
    Automate workflows and connect apps with make.com.
  </Card>

  <Card title="n8n" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/n8n.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=539f7a69b60084c42bd68b869940bdd0" href="/integrations/n8n">
    Create and automate workflows with n8n's powerful features.
  </Card>

  <Card title="Pica" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/picaos.jpeg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=844eb2e91d3ce126c69a589b446aa1a7" href="/integrations/pica">
    Build and scale AI workflows with Pica.
  </Card>

  <Card title="Strands" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/strands.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=ea1bd38e74438e0b750e4af155a342d5" href="/integrations/strands">
    Orchestrate and manage multi-agent AI workflows with Strands.
  </Card>

  <Card title="xpander.ai" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/xpander-ai.jpeg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=3962687624e26fe3e80ddf3df5281278" href="/integrations/xpander-ai">
    Enhance your AI applications with xpander.ai's powerful features.
  </Card>

  <Card title="Agno" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/agno.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=7852e6e5c458f92a633fed5f7dcc92fb" href="/integrations/agno">
    Build memory-powered, multimodal AI agents with Agno
  </Card>
</CardGroup>

***

<Card title="MCP Clients" icon="server" href="/products/mcp-server/integrations/overview">
  <p>Connect to our MCP clients for seamless integration.</p>
</Card>


# How to use Bright Data with Apify
Source: https://docs.brightdata.com/integrations/apify

Step-by-step guide to configuring Bright Data (400M+ IPs) in Apify actors to bypass IP bans, geo-restrictions and CAPTCHAs in scraping workflows.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Apify?

Apify is a powerful platform for web scraping and automation. It enables developers to create and run custom web scraping tools, called **Actors**, which automate data collection and processing tasks. By integrating Bright Data proxies, you can enhance the anonymity, stability, and efficiency of your Apify workflows, ensuring your tasks run smoothly.

## How to Integrate Bright Data with Apify

For this guide, we’ll use the [**Web Scraper**](https://apify.com/apify/web-scraper) actor as an example.

**Step 1. Access Your Apify Dashboard and Tools**

1\. Log in to your [Apify account](https://apify.com/) using your credentials.

2\. From the dashboard, navigate to the **Apify Store** to explore available tools. Use the search bar or browse categories to locate the Web Scraper actor.

**Step 2. Launch the Web Scraper Actor**

1\. From the **Actors** section in the left-hand menu, locate the **Web Scraper actor**.

2\. Click on it to open the configuration page.

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

**Step 3. Define Target URLs for Scraping**

1\. In the **Input** tab, find the **Basic Configuration** section.

2\. Enter the target URLs of the web pages you want to scrape.

3\. Add one or multiple URLs depending on your scraping requirements.

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

<Note>
  Bright Data compliance allows access to search engines like `google` only from SERP proxy zones. To test, use non search engine targets
</Note>

**Step 4.** **Set Up Custom Proxy Options**

1\. Scroll down to the **Proxy and Browser Configuration** section.

2\. Select **Own proxies** to enable custom proxy settings.

3\. Enter your [Bright Data proxy details](https://brightdata.com/cp/zones) in the following format:

```basic theme={null}
http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]
```

4\. Use your Bright Data credentials, and if needed, modify the username for geo-specific access (e.g., `your-username-country-US`).

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

**Step 5. Start and Validate Your Actor Task**

1\. Once the proxy configuration is complete, click **Save & Start** to launch the actor.

2\. Check the logs to ensure the task runs smoothly and that the Bright Data proxy is active.

<Frame>
  <img alt="How to Integrate Bright Data with Apify" />
</Frame>

With Bright Data proxies integrated into Apify, you can run powerful, anonymous, and geo-targeted automation workflows. Whether you’re scraping data, processing information, or managing large-scale projects, Bright Data ensures smooth and reliable operations on Apify. Start building smarter automation today!


# Automation integrations
Source: https://docs.brightdata.com/integrations/automation-integrations

Use Bright Data proxies and web data APIs with workflow automation platforms including Zapier, Clay, n8n, Make and Lindy.ai for hands-off data flows.

<CardGroup>
  <Card title="Zapier" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/zapier-action-setup.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=77777d21d76a8e12f57c71827ef191de" href="/integrations/zapier">
    Automate workflows and connect apps with Bright Data via Zapier.
  </Card>

  <Card title="Clay" icon="table" href="/integrations/clay">
    Trigger Scraper API jobs from a Clay workflow and route the records to your tools.
  </Card>

  <Card title="n8n" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/n8n.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=539f7a69b60084c42bd68b869940bdd0" href="/integrations/n8n">
    Build and automate workflows with n8n's self-hosted platform.
  </Card>

  <Card title="make.com" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/ai-integrations/make.com.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=e67579fa07705baa5bf3e807a50b8d73" href="/integrations/make">
    Automate multi-step workflows with make.com (formerly Integromat).
  </Card>

  <Card title="Boomi" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/boomi.svg?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=05953b059444de9c39479cf2704fee84" href="/integrations/boomi">
    Connect Bright Data's scraping and data APIs to Boomi integration processes.
  </Card>

  <Card title="PhantomBuster" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/phantombuster1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=1ceec79a02eb4fffc56d1e1410080ce7" href="/integrations/phantombuster">
    Automate LinkedIn, Instagram, and other social media data collection.
  </Card>

  <Card title="TexAu" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/texau1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=dfbc4d053fd6b063b4b6d28f79d6aa2e" href="/integrations/texau">
    Automate web scraping and data enrichment workflows with TexAu.
  </Card>

  <Card title="Apify" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/apify1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=774ba65eaa91546ec3627a5ff2df33a4" href="/integrations/apify">
    Run Apify actors using Bright Data proxies for reliable scraping.
  </Card>

  <Card title="SaleFreaks" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/SaleFreaks-4.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=d2210679975d1ffac389094e248ad654" href="/integrations/salefreaks">
    Power SaleFreaks dropshipping automation with Bright Data proxies.
  </Card>

  <Card title="Easync" icon="bolt" href="/integrations/easync">
    Automate e-commerce pricing and product data collection with Easync.
  </Card>

  <Card title="Capsolver" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/capsolver1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=317c5dca43c093a2de663051aa21ff06" href="/integrations/capsolver">
    Solve CAPTCHAs automatically in your automation workflows.
  </Card>

  <Card title="OpenBullet" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/openbullet1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=b5bd17e20685e2fb3f19c42f770a8e24" href="/integrations/openbullet">
    Configure Bright Data proxies in OpenBullet for credential testing.
  </Card>

  <Card title="Playwright" icon="code" href="/integrations/playwright">
    Use Bright Data proxies with Playwright browser automation scripts.
  </Card>

  <Card title="Puppeteer" icon="code" href="/integrations/puppeteer">
    Use Bright Data proxies with Puppeteer headless browser scripts.
  </Card>

  <Card title="Selenium" icon="code" href="/integrations/selenium">
    Use Bright Data proxies with Selenium WebDriver automation.
  </Card>

  <Card title="StablerSOLO" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/stabler1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=79de6aba5243c73c596ee2636206cdab" href="/integrations/stablersolo">
    Configure proxies in StablerSOLO for sneaker and retail automation.
  </Card>

  <Card title="Nginx" icon="server" href="/integrations/nginx">
    Route traffic through Bright Data proxies using Nginx as a forward proxy.
  </Card>
</CardGroup>


# How to use Bright Data with BeautifulSoup
Source: https://docs.brightdata.com/integrations/beautifulsoup

Step-by-step guide to configuring Bright Data proxies in Python BeautifulSoup scripts for reliable, anonymous web scraping. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is BeautifulSoup?

BeautifulSoup is a Python library that simplifies the process of extracting and organizing data from HTML and XML documents. Combined with Bright Data proxies, it enables you to scrape data securely and anonymously while reducing the risk of detection and blocking.

## How to Integrate Bright Data with BeautifulSoup

**Step 0. Prerequisites**

Before you start:

* Download the latest Python version from [python.org](https://www.python.org/).

* Install BeautifulSoup and the `requests` library:

```bash theme={null}
     pip install beautifulsoup4 requests
```

**Step 1. Set Up the Proxy**

Login to bright data account, and select the proxy zone you with to use. In the **Overview,** under **Access details**, you can find the required information to get your access information. \*\*\*\*&#x20;

1. Log in to your [Bright Data account](https://brightdata.com/cp/zones) and retrieve your proxy credentials:

   * **Host**: [`http://brd.superproxy.io/`](http://brd.superproxy.io/)

   * **Port**: 44445

   * **Username**: Your Bright Data username. Modify it for geo-specific proxies if needed (e.g., `your-username-country-US`).

   * **Password**: Your Bright Data proxy zone password.

2. Define your proxy details in your script:

```python theme={null}
proxy = {
  "http": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
}
```

**Step 2. Implement Proxy Settings with requests and Parse Data Using BeautifulSoup**

Here’s a comprehensive script that demonstrates how to integrate Bright Data with BeautifulSoup for secure data retrieval and parsing:

```python theme={null}
import requests
from bs4 import BeautifulSoup

# Bright Data Proxy Configuration
proxy = {
    "http": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]",
    "https": "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"
}

# Target URL to verify the proxy
url = "https://httpbin.org/ip" 

try:
    # Send the request using the proxy
    response = requests.get(url, proxies=proxy, timeout=10)
    response.raise_for_status()  # Handle HTTP errors

    # Parse the HTML content
    soup = BeautifulSoup(response.text, "html.parser")

    # Print the formatted page content
    print("Response Content (IP Address):")
    print(soup.prettify())

except requests.exceptions.RequestException as e:
    print("Error occurred while using the proxy:", e)

```

**Step 3. Verify the Output**

If the Bright Data proxy is configured correctly, you should see the IP address of the proxy displayed in the output:

```json theme={null}
{
  "origin": "123.45.67.89"
}
```

Integrating Bright Data proxies with BeautifulSoup allows you to scrape data securely, anonymously, and efficiently. Whether you’re extracting structured data, accessing geo-restricted content, or managing large-scale scraping tasks, Bright Data ensures reliability and privacy for all your scraping needs. Start scraping smarter with Bright Data and BeautifulSoup today!


# How to set up Bright Data with Boomi
Source: https://docs.brightdata.com/integrations/boomi

Learn how to connect Bright Data's scraping and data collection APIs to a Boomi process using the Bright Data Partner connector. Spans 195 countries.

The [Bright Data Partner connector](https://help.boomi.com/searchResults?q=bright%20data) lets you retrieve data from Bright Data's scraping and data collection APIs directly within a Boomi process. You can integrate with the SERP, Dataset, Scraper, and Web Unlocker APIs to build end-to-end public web data workflows without leaving the Boomi platform.

<Note>
  The Bright Data Partner connector is developed and maintained by Bright Data. Customer support is handled through the Boomi Support Portal, where tickets are triaged to Bright Data.
</Note>

## Which object types are supported

The connector supports the following object types, each accessed via the Execute action:

| Object | Description |
| - | - |
| Dataset | Access marketplace datasets with filtering and snapshot retrieval |
| Scraper | Submit web scraping jobs and retrieve results asynchronously |
| Unlocker | Access protected web content via proxy and unblocking services |
| SERP | Retrieve search engine results pages from Google, Bing, and others |

## Prerequisites

Before you begin, ensure you have:

* A valid Bright Data account
* An API key generated from the [Bright Data Control Panel](https://brightdata.com/cp/setting/users) with permissions for the services you intend to use

## Connect your Bright Data account

<Steps>
  <Step title="Open the Connection configuration">
    In your Boomi process, add a new **Bright Data Partner connector** component and navigate to the **Connection** tab.
  </Step>

  <Step title="Set the Base URL">
    Enter the Bright Data API base URL:

    ```http theme={null}
    https://api.brightdata.com
    ```

    Customize this value only if you need to point to a different endpoint, such as for testing or regional deployments.
  </Step>

  <Step title="Enter your API key">
    Paste your Bright Data API key into the **API Token** field (Boomi's connector UI labels it this way). The connector uses this key for Bearer authentication.
  </Step>

  <Step title="Test the connection">
    Click **Test Connection** to verify your settings. If the test succeeds, save the connection. If it fails, review your Base URL and API key, then test again.
  </Step>
</Steps>

## Configure an operation

Each operation defines how the connector interacts with a specific Bright Data object. Create a separate operation component for each action/object combination your integration requires.

All object types use the **Execute** action.

### Options tab fields

| Field | Description |
| - | - |
| Connector action | Set to **Execute** for all Bright Data operations |
| Object | Import using the **Import** button. Choose Dataset, Scraper, Unlocker, or SERP |
| Request profile | A flexible XML/XSD schema that accepts dynamic content structures |
| Response profile | A JSON profile returned by the connector |
| Tracking direction | Select **Input Documents** or **Output Documents** |
| Error behavior | Enable to handle failed operations in your process rather than only reporting them |
| Request Payload | Optional document-level override for the request. Accepts JSON, URL query style, or newline-separated `key=value` pairs |

## How each object type behaves

### How the Dataset object works

The connector operates in one of two modes depending on whether a `snapshot_id` is present:

* **Mode A (Filter):** No `snapshot_id` provided. Filters marketplace datasets based on your query parameters.
* **Mode B (Snapshot):** A `snapshot_id` starting with `snap_` is provided. The connector polls every 10 seconds, up to 25 retries, until the snapshot is ready.

```json theme={null}
{
  "dataset_id": "gd_l1viktl72bvl7bjuj0",
  "filter": {
    "name": "name",
    "operator": "=",
    "value": "Or Lenchner"
  }
}
```

### How the Scraper object works

* **Mode A (Trigger):** No `snapshot_id` provided. Submits a new scraping job and returns a `snapshot_id`.
* **Mode B (Snapshot):** A `snapshot_id` starting with `s_` is provided. The connector polls for completion and downloads results.

```json theme={null}
{
  "dataset_id": "gd_l1viktl72bvl7bjuj0",
  "url": "https://www.linkedin.com/in/orlenchner",
  "discover_by": "profile_url"
}
```

### How the Unlocker object works

Requires a `url` parameter to bypass website restrictions. Supports `method`, `country`, and `body` parameters.

```json theme={null}
{
  "zone": "web_unlocker1",
  "url": "https://geo.brdtest.com/welcome.txt",
  "format": "json",
  "method": "GET",
  "country": "us",
  "data_format": "markdown"
}
```

### How the SERP object works

Requires `engine` and `query` parameters. Supports multiple engines in a single request using a comma-separated list.

```json theme={null}
{
  "zone": "serp_api1",
  "url": "https://www.google.com/search?q=BrightData",
  "format": "json",
  "method": "GET",
  "country": "us",
  "data_format": "markdown"
}
```

<Note>
  The connector returns all data in JSON format. If the underlying API returns non-JSON content such as HTML or CSV, the connector wraps the raw content in a JSON structure for consistent processing in Boomi.
</Note>

## What's in each release

**Version 1.0.0**

Initial release. Supports Dataset, Scraper, Unlocker, and SERP object types via the Execute action.


# Anti-detect browser integrations
Source: https://docs.brightdata.com/integrations/browser-integrations

Configure Bright Data proxies (400M+ residential IPs) in anti-detect browsers like GoLogin, MuLogin and XLogin for multi-account fingerprint management.

Anti-detect browsers let you manage multiple browser profiles with unique fingerprints. Adding Bright Data proxies gives each profile a distinct, trusted IP address.

<CardGroup>
  <Card title="GoLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/gologin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=55c444e98d731a7ae0963f86406d2da7" href="/integrations/gologin">
    Assign Bright Data proxies to GoLogin browser profiles.
  </Card>

  <Card title="Multilogin" icon="browser" href="/integrations/multilogin">
    Configure Bright Data proxies in Multilogin browser profiles.
  </Card>

  <Card title="AdsPower" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/adspower1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=bd012b7b56effe44847cf6b32cadefda" href="/integrations/adspower">
    Set up Bright Data proxies in AdsPower for multi-account management.
  </Card>

  <Card title="Kameleo" icon="browser" href="/integrations/kameleo">
    Add Bright Data proxies to Kameleo browser profiles.
  </Card>

  <Card title="Dolphin Anty" icon="browser" href="/integrations/dolphin-anty">
    Configure Bright Data proxies in Dolphin Anty profiles.
  </Card>

  <Card title="Incogniton" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/maskfog1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=66098359f4a870aa4bbad388c0b0d054" href="/integrations/incogniton">
    Use Bright Data proxies with Incogniton anti-detect browser.
  </Card>

  <Card title="Undetectable" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/undetectable1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=6d1b626060b47e0a5e85fb3d55272cc1" href="/integrations/undetectable">
    Set up Bright Data proxies in Undetectable browser profiles.
  </Card>

  <Card title="Ghost Browser" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/ghostbrowser1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=e0ccf5a905b9a6c4c28c4cb9709aebfb" href="/integrations/ghost-browser">
    Add Bright Data proxies to Ghost Browser workspaces.
  </Card>

  <Card title="Octo Browser" icon="browser" href="/integrations/octobrowser">
    Configure Bright Data proxies in Octo Browser profiles.
  </Card>

  <Card title="SessionBox" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/sessionbox1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=766b1c7d627d5e7c0ac68d98dfe181db" href="/integrations/sessionbox">
    Use Bright Data proxies with SessionBox multi-session management.
  </Card>

  <Card title="Aezakmi" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/aezakmi1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=0dc409873f10c2c9ceb284a65b887487" href="/integrations/aezakmi">
    Set up Bright Data proxies in Aezakmi browser profiles.
  </Card>

  <Card title="BitBrowser" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/bitbrowser1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=8fb6d555996ba73da9f2a5af9822ae94" href="/integrations/bitbrowser">
    Configure Bright Data proxies in BitBrowser profiles.
  </Card>

  <Card title="ClonBrowser" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/clonbrowser1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=ed40825101578866106191ee5d3dbf9e" href="/integrations/clonbrowser">
    Add Bright Data proxies to ClonBrowser sessions.
  </Card>

  <Card title="DICloak" icon="browser" href="/integrations/dicloak">
    Use Bright Data proxies with DICloak anti-detect browser.
  </Card>

  <Card title="Geelark" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/geelark1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=158f9dc832276c407c9b8c1f6687ae45" href="/integrations/geelark">
    Configure Bright Data proxies in Geelark cloud phone profiles.
  </Card>

  <Card title="GenLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/genlogin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=245fc0ebe89bd6afa5beb7e73c5d98d7" href="/integrations/genlogin">
    Set up Bright Data proxies in GenLogin browser profiles.
  </Card>

  <Card title="HideMyAcc" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/hidemyacc1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=9de473f20401802c05b4b25d896f73e5" href="/integrations/hidemyacc">
    Add Bright Data proxies to HideMyAcc browser profiles.
  </Card>

  <Card title="IXBrowser" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/ixbrowser1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=dff907199d2e46177f8ccc24db657ea5" href="/integrations/ixbrowser">
    Configure Bright Data proxies in IXBrowser profiles.
  </Card>

  <Card title="Lalicat" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/lalicat1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=61fb5af29351a62b2c74a438dd2a0867" href="/integrations/lalicat">
    Use Bright Data proxies with Lalicat anti-detect browser.
  </Card>

  <Card title="MarketerBrowser" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/marketerbrowser1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=8252cdbb0021120499c04182a8900be7" href="/integrations/marketerbrowser">
    Add Bright Data proxies to MarketerBrowser profiles.
  </Card>

  <Card title="Maskfog" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/maskfog1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=66098359f4a870aa4bbad388c0b0d054" href="/integrations/maskfog">
    Configure Bright Data proxies in Maskfog browser profiles.
  </Card>

  <Card title="MoreLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/morelogin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=49efd4ff85818aa0fc7f286f4869ac92" href="/integrations/morelogin">
    Set up Bright Data proxies in MoreLogin browser profiles.
  </Card>

  <Card title="MuLogin" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/mulogin1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=2d7dbdc8466dbb50ed4ccc114a9cfbc9" href="/integrations/mulogin">
    Add Bright Data proxies to MuLogin browser profiles.
  </Card>

  <Card title="SMLogin" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/smlogin2.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=3e93ff6aa65b6fe93ec80d7446f3c882" href="/integrations/smlogin">
    Configure Bright Data proxies in SMLogin browser profiles.
  </Card>

  <Card title="Sphere Browser" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/sphere-browser1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=d385277e6efd50fb662c50a8c45b01de" href="/integrations/sphere-browser">
    Use Bright Data proxies with Sphere anti-detect browser.
  </Card>

  <Card title="VMLogin" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/vmlogin1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=e43349f255b24958eafc4a6433ed1284" href="/integrations/vmlogin">
    Add Bright Data proxies to VMLogin browser profiles.
  </Card>

  <Card title="XLogin" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/xlogin1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=e780377078d05097c518c0ba646becc3" href="/integrations/xlogin">
    Configure Bright Data proxies in XLogin browser profiles.
  </Card>

  <Card title="Antik" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/antik1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=07de9399ef81d37c5f6211d3ca9a8e18" href="/integrations/antik">
    Set up Bright Data proxies in Antik browser profiles.
  </Card>

  <Card title="Insomniac" icon="browser" href="/integrations/insomniac">
    Configure Bright Data proxies in Insomniac browser.
  </Card>

  <Card title="Chrome" icon="https://mintcdn.com/brightdata/jeaQWxFKde5jgPN8/images/integrations/chrome1.png?fit=max&auto=format&n=jeaQWxFKde5jgPN8&q=85&s=8b62de64984b10e89b0a8121e96680f7" href="/integrations/chrome">
    Configure Bright Data proxies directly in Google Chrome.
  </Card>

  <Card title="Firefox" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/firefox1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=32492262d4b037fd13e11c83c73bbf0f" href="/integrations/firefox">
    Set up Bright Data proxies in Mozilla Firefox.
  </Card>
</CardGroup>


# How to set up Bright Data with Capsolver
Source: https://docs.brightdata.com/integrations/capsolver

Integrate Bright Data proxies (195 countries) with Capsolver to solve reCAPTCHA, hCaptcha and image CAPTCHAs in automation and scraping workflows.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Capsolver?

Capsolver is a CAPTCHA-solving service that automates the process of bypassing common CAPTCHA challenges such as reCAPTCHA, hCaptcha, and image-based CAPTCHAs. It is commonly used in automation, scraping, and testing workflows where uninterrupted access to target websites is required. When combined with Bright Data proxies, Capsolver provides improved anonymity, geo-targeting, and reliability.

***

## Why Use Bright Data With Capsolver?

* **Enhanced Anonymity**: Hide your real IP address while solving CAPTCHAs.
* **Geo-Targeted Access**: Solve CAPTCHAs from specific countries or regions using localized proxies.
* **Improved Stability**: Reduce request failures and service interruptions.
* **Scalable Automation**: Safely handle high-volume CAPTCHA-solving workloads.

***

## How to Integrate Bright Data With Capsolver

### Prerequisites

Before starting, ensure you have:

* An active Capsolver account
* An active Bright Data account
* A configured Bright Data proxy zone (ISP or Data Center recommended)
* Your Bright Data proxy credentials (host, port, username, password)

***

### Step 1. Log In to Capsolver

* Visit the [Capsolver website](https://www.capsolver.com/) and log in to your account.
* Ensure your Capsolver API key and balance are active before proceeding.

***

### Step 2. Open Proxy Configuration

1. Open the **Capsolver Extension** in your browser.
2. Navigate to the **Settings** section.
3. Locate the **Proxy** option and toggle it **On** to enable proxy usage.

<Frame>
  <img alt="Step 2. Open Proxy Configuration" />
</Frame>

***

### Step 3. Add Your Bright Data Proxy Details

Enter your Bright Data proxy credentials in the proxy configuration fields:

* **Host**: `brd.superproxy.io`
* **Port**: `44445`
* **Username**: Your Bright Data username\
  *(Optionally append `-session-<id>` to maintain a consistent IP)*
* **Password**: Your Bright Data password

<Note>
  For geo-targeted proxies, format the username as\
  `your-username-country-XX` (for example, `your-username-country-US`)\
  to route CAPTCHA-solving traffic through a specific country.
</Note>

***

### Step 4. Save and Test the Proxy

* Save the proxy configuration.
* Run a test CAPTCHA task to verify that Capsolver is routing traffic through the Bright Data proxy.
* Confirm successful execution by checking Capsolver logs or task responses.

***

## Best Practices

* Use session-based usernames to maintain IP consistency during CAPTCHA-heavy workflows
* Assign dedicated proxies for sensitive or account-based tasks
* Avoid excessive parallel CAPTCHA requests from the same proxy
* Monitor Capsolver task logs for proxy-related errors
* Rotate sessions periodically for long-running operations

***

## Conclusion

By integrating Bright Data with Capsolver, you can run secure, anonymous, and scalable CAPTCHA-solving workflows. This setup minimizes detection risks, enables geo-specific operations, and ensures reliable performance across automation tasks. With your proxy configuration in place, you’re ready to handle CAPTCHA challenges efficiently and at scale.


# Set up Bright Data with ChangeDetection
Source: https://docs.brightdata.com/integrations/changedetection

Integrate Bright Data proxies (400M+ IPs) with ChangeDetection to monitor competitor prices, product availability and content changes across multiple sites.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is ChangeDetection?

**ChangeDetection** is a powerful tool for monitoring website updates. It allows you to track content changes, receive notifications, and analyze updates in real-time. Whether you’re monitoring competitors, prices, or product availability, ChangeDetection ensures you’re always informed. By integrating **Bright Data**, you can enhance privacy, bypass restrictions, and manage multiple monitoring tasks seamlessly.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

### How to Integrate Bright Data With ChangeDetection

**Step 1. Install and Launch ChangeDetection**

1\. Visit the [ChangeDetection website](https://changedetection.io/) and download the application for your operating system.\
2\. Install ChangeDetection and launch the application.\
3\. Log in to your account to access the dashboard.

**Step 2. Configure Proxy Settings**

1\. Open the **Settings** menu from the ChangeDetection dashboard.\
2\. Navigate to the **Network Settings** or **Proxy Settings** section.

**Step 3. Enter Your Bright Data Proxy Details**

1. In the proxy configuration field, input your Bright Data proxy details:

   * **Protocol**: Select HTTP, HTTPS, or SOCKS5 depending on your proxy type.

   * **Host**: Enter [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

   * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).

   * **Username**: Enter your Bright Data username.

   * **Password**: Enter your Bright Data password.

<Note>
  **For geo-targeted proxies, include the country code in your username (e.g., `your-username-country-US` for a US-based proxy).**
</Note>

**Step 4. Verify the Proxy Connection**

1. Test the proxy connection to ensure it is active:

   * In the same settings menu, look for a **Test Proxy** or **Validate Proxy** button.

   * Run the test to confirm that the proxy is working as expected.

2. Save your settings to apply the configuration.

**Step 5. Monitor Websites With Bright Data**

1. Return to the ChangeDetection dashboard and start adding websites to monitor.

2. Configure individual tasks as needed, ensuring they utilize the proxy settings for privacy and efficiency.

With **Bright Data** integrated into **ChangeDetection**, you can monitor websites securely, bypass geographical restrictions, and manage multiple tasks with ease. Enjoy seamless tracking and privacy for all your web monitoring needs!


# How to configure proxy settings in Chrome
Source: https://docs.brightdata.com/integrations/chrome

Step-by-step guide to configuring Bright Data proxies (port 44445) in Chrome for privacy, geo-bypass and managing multiple browser sessions or accounts.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

## Changing Proxy Settings in Chrome

Ready to unlock the power of proxies in Chrome? It’s simple, just follow these steps and you’re good to go:

### Step 1. **Access Chrome Settings**

Open Chrome, click on the **three-dot menu** in the top-right corner, and choose **Settings** from the dropdown.

<Frame>
  <img alt="Step 1. Access Chrome Settings." />
</Frame>

### Step 2. **Open System Proxy Settings**

Navigate to the **System** section and select **Open your computer’s proxy settings** to proceed.

<Frame>
  <img alt="Step 2. Open System Proxy Settings." />
</Frame>

### Step 3. **Configure Proxy in Your Operating System**

Since Chrome uses your operating system’s proxy settings, you’ll be redirected to the system configuration screen. Follow these steps based on your OS:

* **On Windows**: Enable “Use a proxy server,” then enter the proxy address and port provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
* **On macOS**: Select the appropriate protocol (like HTTP or SOCKS5) and input the proxy address, port, and credentials. It’s quick and straightforward!

All done! Your Chrome browser is now set up with **Bright Data**. Whether you’re managing accounts, shopping worldwide, or browsing privately, you’re ready for a secure and seamless experience.


# How to integrate Scraper API with Clay
Source: https://docs.brightdata.com/integrations/clay

Call the Bright Data Scraper API from a Clay workflow with an HTTP request block, then route the scraped records to a sheet, a database or another tool.

This guide shows you how to call the Bright Data Scraper API from a Clay workflow, so that Clay triggers a scrape on a schedule or an event and passes the records on to the tools your team already uses.

## Prerequisites

* A Clay account with administrator privileges.
* A Bright Data API key from [account settings](https://brightdata.com/cp/setting/users).
* The dataset ID of the scraper you want to run. Find it on the scraper's page in the [Control Panel](https://brightdata.com/cp/scrapers/browse); the Amazon products scraper is `gd_l7q7dkf244hwjntr0`.

## Step 1: Prepare the scraper

1. Open the scraper in the Control Panel and pick the endpoint you need.
2. Load the inputs you plan to send, as JSON or CSV.
3. Turn on **Include errors report with the results**, so a failed input is reported rather than silently dropped.
4. Turn on **Deliver results to external storage** or **Send to webhook**, depending on where Clay should collect the data.

## Step 2: Add the request to a Clay workflow

1. In Clay, open **Workflows** and choose a trigger: manual, scheduled, or an event from another service connected to Clay.

2. Add an **HTTP request** block.

3. Set the method to `POST` and the URL to the trigger endpoint:

   ```text theme={null}
   https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_l7q7dkf244hwjntr0&format=json
   ```

4. Add the headers:

   ```json theme={null}
   {
     "Authorization": "Bearer YOUR_API_KEY",
     "Content-Type": "application/json"
   }
   ```

5. Set the body to the inputs. A bare JSON array works for every scraper:

   ```json theme={null}
   [{"url": "https://www.amazon.com/dp/B0FQFB8FMG"}]
   ```

   To have the records pushed to a URL when the job finishes, add `endpoint=https://your-server.com/webhook` to the query string. See [How to deliver results to a webhook or S3](/products/scrapers/scrapers-library/data-delivery).

6. Send a test request with Clay's testing tools. The response is a `snapshot_id`; the records arrive at the delivery destination once the job finishes. The [Trigger a collection](/api-reference/rest-api/scraper/asynchronous-requests) reference lists every query parameter.

## Step 3: Use the records in Clay

* Send the records on to a database, Google Sheets, email or any other service Clay connects to.
* Add conditions or filters, for example only records whose price is above a threshold.

## Step 4: Schedule the workflow

Set the workflow to run on the schedule you need, hourly or daily, or leave it on the manual trigger.

## Related

<CardGroup>
  <Card title="Async requests" icon="layer-group" href="/products/scrapers/scrapers-library/async-requests">
    What the trigger endpoint returns and how to poll or download a snapshot.
  </Card>

  <Card title="Deliver results" icon="truck" href="/products/scrapers/scrapers-library/data-delivery">
    Storage destinations, formats and the IAM setup for each.
  </Card>
</CardGroup>


# How to integrate Bright Data with CrewAI
Source: https://docs.brightdata.com/integrations/crew-ai

Integrate Bright Data Web Scraper API (thousands of scrapers) and SERP API into CrewAI agents to add live web data, search and unblocking to agentic workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

A comprehensive suite of CrewAI tools that leverage Bright Data's powerful infrastructure for web scraping, data extraction, and search operations. These tools provide three distinct capabilities:

## How to extract data with BrightDataDatasetTool

Extract structured data from popular data feeds (Amazon, LinkedIn, Instagram, etc.) using pre-built datasets

## How to search with BrightDataSearchTool

Perform web searches across multiple search engines with geo-targeting and device simulation

## How to scrape with BrightDataUnlockerAPITool

Scrape any website content while bypassing bot protection mechanisms

## Steps to Get Started

To effectively use the BrightData Tools, follow these steps:

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for CrewAI, along with `aiohttp` and `requests` by running the following command:

    ```shell theme={null}
    pip install crewai[tools] aiohttp requests
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```bash theme={null}
    export BRIGHT_DATA_API_KEY="your_api_key_here"
    export BRIGHT_DATA_ZONE="your_zone_here"
    ```
  </Step>

  <Step title="Select your preferred Bright Data tool">
    The Bright Data + CrewAI integration currently supports:

    <CodeGroup>
      ```python DatasetTool theme={null}
      # Dataset Tool - Extract Amazon Product Data
      from crewai_tools import BrightDataDatasetTool

      # Initialize with specific dataset and URL
      tool = BrightDataDatasetTool(
          dataset_type="amazon_product",
          url="https://www.amazon.com/dp/B08QB1QMJ5/"
      )
      result = tool.run()
      ```

      ```python SearchTool theme={null}
      # Search Tool - Perform Web Search
      from crewai_tools import BrightDataSearchTool

      # Initialize with search query
      tool = BrightDataSearchTool(
          query="latest AI trends 2025",
          search_engine="google",
          country="us"
      )
      result = tool.run()
      ```

      ```python UnlockerAPITool theme={null}
      # Web Unlocker API Tool - Scrape Website Content
      from crewai_tools import BrightDataWebUnlockerTool

      # Initialize with target URL
      tool = BrightDataWebUnlockerTool(
          url="https://example.com",
          data_format="markdown"
      )
      result = tool.run()
      ```
    </CodeGroup>
  </Step>
</Steps>

## Conclusion

By integrating BrightData Tools into your CrewAI agents, you gain access to reliable web scraping and data extraction capabilities. These tools handle complex challenges like bot protection, geo-restrictions, and data parsing, allowing you to focus on building your applications rather than managing scraping infrastructure.


# How to set up Bright Data with Dify
Source: https://docs.brightdata.com/integrations/dify

Add Bright Data's web scraping plugin to Dify to extract data from 50+ platforms including Amazon, LinkedIn and Instagram, plus search and markdown.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The Bright Data plugin for Dify pulls structured web data, search results and page markdown into your Dify workflows. Install it from the Dify Marketplace, add your Bright Data API key, and drop the scraping tools into any workflow. It covers 50+ platforms including Amazon, LinkedIn, Instagram and YouTube.

<Frame>
  ![Dify workflow using the Bright Data plugin to extract Amazon product data and summarize it with an LLM node](https://github.com/user-attachments/assets/5825d274-d47b-4fed-950f-65e6b7c63e58)
</Frame>

<Note>
  For the latest plugin updates, see the [Bright Data Dify plugin repository](https://github.com/brightdata/brightdata-dify-plugin/blob/main/BrightData/brightdata-dify-plugin/README.md).
</Note>

## Prerequisites

* A [Bright Data account](https://brightdata.com/cp) with an [API key](/api-reference/authentication#api-key)
* A Dify account with access to Dify Studio

## How to add the Bright Data plugin to Dify

<Steps>
  <Step title="Install the plugin">
    Install the Bright Data plugin from the [Dify Marketplace](https://marketplace.dify.ai/plugins/idanvilenski/brightdata).
  </Step>

  <Step title="Get your Bright Data API key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#api-key) if you do not have one.
  </Step>

  <Step title="Add a scraping tool to a workflow">
    1. Go to **Dify Studio** and open a **Workflow**.
    2. Add one of the Bright Data tools:
       * **Structured Data Feeds**: extract structured data from 50+ platforms
       * **Scrape As Markdown**: convert any webpage to clean markdown
       * **Search Engine**: get search results from Google, Bing or Yandex
    3. Enter your Bright Data API key when prompted.
    4. Connect an **LLM node** to process or summarize the scraped data.
  </Step>

  <Step title="Run an example workflow">
    The banner image above shows this workflow. To extract Amazon product information and summarize it:

    1. **START**: input a product URL
    2. **Structured Data Feeds**: extract product details
    3. **LLM**: summarize into readable text
    4. **END**: output a clean product summary

    <Note>
      Two tips for reliable workflows:

      * Reference every stage to the output of the previous stage
      * Set a high character limit on input fields (for the URL field, choose the "short paragraph" var option)
    </Note>
  </Step>
</Steps>

## Available tools

The plugin adds three tools to Dify.

### Structured data feeds

Extract structured data from popular platforms:

* **E-commerce**: Amazon, eBay, Walmart, Best Buy, Etsy, Zara
* **Social media**: Instagram, Facebook, TikTok, YouTube, X (Twitter)
* **Professional**: LinkedIn profiles, companies, jobs
* **Business**: Crunchbase, ZoomInfo
* **Maps and reviews**: Google Maps, booking sites
* **News**: news sources and articles

### Scrape as markdown

Convert any webpage into clean, readable markdown for:

* Content analysis
* Documentation extraction
* Article processing

### Search across engines

Get search results from major search engines:

* Google
* Bing
* Yandex and others

## Use cases

* **E-commerce monitoring**: track product prices and availability
* **Lead generation**: extract business information from LinkedIn
* **Content research**: gather articles and news for analysis
* **Market research**: monitor competitor websites and social media
* **SEO analysis**: track search engine results and rankings

## Advanced: use Bright Data MCP

The Dify plugin uses hosted APIs. For advanced workflows, you can also integrate the [Bright Data MCP server](/products/mcp-server/overview), which exposes the full Bright Data scraping and automation toolset over the Model Context Protocol.

Call MCP tools from Dify using custom HTTP requests or external service nodes to add capabilities like browser automation and real-time scraping.

* [Explore MCP on GitHub](https://github.com/brightdata/brightdata-mcp/tree/main)
* [Try MCP in the Smithery Playground](https://smithery.ai/server/@luminati-io/brightdata-mcp/tools)


# How to set up Bright Data with Easync
Source: https://docs.brightdata.com/integrations/easync

Configure Bright Data proxies (port 44445) in Easync to route automated e-commerce operations through residential, datacenter, ISP or mobile IPs.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is Easync?

**Easync** is an automation tool built for e-commerce businesses to streamline order fulfillment, inventory synchronization, price tracking, and marketplace operations across multiple platforms. By integrating Bright Data with Easync, you can improve automation reliability, protect your IP reputation, and access geo-specific marketplace data with reduced risk of blocks.

***

## Why Use Bright Data With Easync?

* **IP Anonymity**: Hide your real IP address during automated e-commerce operations
* **Geo-Targeted Access**: Access region-specific marketplaces and suppliers
* **Improved Stability**: Reduce IP bans and connection failures
* **Scalable Automation**: Safely handle high-volume order and inventory workflows

***

## How to Integrate Bright Data With Easync

### Prerequisites

Before starting, ensure you have:

* An active Easync account
* An active Bright Data account
* A configured Bright Data proxy zone (ISP or Data Center recommended)
* Bright Data proxy credentials (username, password)
* Administrator access to your operating system network settings

***

### Step 1. Configure Bright Data on Your Operating System

Easync uses the proxy settings configured at the **operating system level**.\
Follow the setup guide for your OS to configure Bright Data as a system proxy:

* [How to Set Up Bright Data on Windows](/integrations/windows)
* [How to Set Up Bright Data on macOS](/integrations/macos)

Once completed, all supported applications, including Easync, will route traffic through Bright Data automatically.

<Note>
  ISP or Data Center proxies are recommended for e-commerce automation due to their higher stability and lower block rates.
</Note>

***

### Step 2. Log In to Easync

1. Visit the [Easync website](https://easync.io/) and log in to your account.
2. Launch the Easync application or dashboard.
3. No additional proxy configuration is required inside Easync, as it inherits system-level proxy settings.

***

### Step 3. Test the Proxy Integration

After configuring Bright Data at the OS level, verify that Easync is using the proxy:

* Perform a lightweight action in Easync, such as:
  * Fetching product details
  * Syncing inventory
  * Placing a test order
* Confirm the task completes successfully without connectivity issues.

***

### Step 4. Verify and Monitor the Setup

1. Use a browser or visit `http://httpbin.org/ip` to confirm that traffic is routed through a Bright Data IP.
2. Monitor task execution inside Easync to ensure:
   * Orders are processed correctly
   * Inventory updates run smoothly
   * No proxy-related errors occur

***

## Best Practices

* Use **dedicated ISP proxies** for account-based marketplace automation
* Assign separate proxies for different seller accounts
* Avoid running too many concurrent tasks on a single proxy
* Monitor Easync logs for timeout or connection errors
* Rotate sessions periodically for long-running workflows

***

## Conclusion

By integrating Bright Data with Easync at the operating system level, you enable secure, anonymous, and stable e-commerce automation. This setup helps protect your IP reputation, reduces block risks, and ensures reliable performance across order processing, inventory management, and price monitoring workflows, allowing you to scale operations with confidence.


# Firefox proxy configuration
Source: https://docs.brightdata.com/integrations/firefox

Step-by-step guide to configuring Bright Data proxies (port 44445) in Firefox for privacy, geo-bypass and managing multiple browser sessions or accounts.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

## Changing Proxy Settings in Firefox

Take control of your Firefox browsing experience! Setting up proxies is easy, just follow these clear steps to get started:

<Steps>
  <Step title="Access Firefox Settings">
    Launch Firefox and click on the **menu icon** (three horizontal lines) located in the top-right corner.\
    From the dropdown, select **Settings** to access the browser's configuration menu.

    <Frame>
      <img alt="Changing Proxy Settings in Firefox" />
    </Frame>
  </Step>

  <Step title="Go to Network Settings">
    Scroll down within the settings menu until you find the **Network Settings** section.\
    Click on **Settings** to open the proxy configuration window.

    <Frame>
      <img alt="Changing Proxy Settings in Firefox" />
    </Frame>
  </Step>

  <Step title="Set Up Proxy Configuration">
    In the proxy settings window, do the following:

    1. Select **Manual proxy configuration** to enable custom proxy settings.
    2. Provide the necessary information:

    * **HTTP Proxy**: Input `http://brd.superproxy.io/`.
    * **Port**: Enter the port number displayed in your [Bright Data dashboard](https://brightdata.com/cp/zones).

    1. (Optional) Enable **Use this proxy server for all protocols** to apply the same proxy across all connection types.
    2. For SOCKS proxies, select **SOCKS v5** and fill in the appropriate server details.
  </Step>

  <Step title="Authenticate When Needed">
    When you access a website, Firefox might ask you for authentication credentials.\
    Enter your **Username** and **Password** from your Bright Data account when prompted.
  </Step>
</Steps>

### Getting "Software is Preventing Firefox From Safely Connecting to this site" Error?

You are probably trying to access a website which is blocked by Bright Data policy. We often see this when trying to access [google.com](http://google.com) via our datacenter, ISP, residential or mobile proxies. Try a a different website ; we recommend to test your proxy connection with our test website: [https://geo.brdtest.com/welcome.txt](https://geo.brdtest.com/welcome.txt) .

And that’s it! Your Firefox browser is now configured with **Bright Data**, opening the door to a secure and private browsing experience. Whether you’re managing accounts, running essential tasks, or simply enjoying unrestricted access to the web, you’re all set for a faster, safer, and more reliable online journey.


# How to set up Bright Data with Haystack
Source: https://docs.brightdata.com/integrations/haystack

Integrate Bright Data with Haystack to enhance RAG pipelines and AI applications with reliable, scalable web data extraction. Covers 45+ datasets.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Integrating Bright Data with Haystack enhances your RAG pipelines and AI applications with reliable, scalable web data extraction for real-world use cases.

The `haystack-brightdata` Python package is the official Haystack integration for Bright Data, including support for:

* **Bright Data Web Scraper** - Extract structured data from 45+ supported websites including Amazon, LinkedIn, Instagram, Facebook, TikTok, YouTube, and more using Bright Data's Dataset API.
* **Bright Data SERP** - Query search engines (Google, Bing, Yahoo) with geo-targeting and language customization for real-time search results.
* **Bright Data Unlocker** - Access geo-restricted and bot-protected websites, bypass CAPTCHAs and anti-bot measures to extract content in multiple formats.

## How to Integrate Bright Data With Haystack

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for Haystack by running the following command:

    ```bash theme={null}
    pip install haystack-brightdata
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python theme={null}
    import os
    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```
  </Step>

  <Step title="Select your preferred Bright Data component">
    The Bright Data + Haystack integration currently supports:

    <Tabs>
      <Tab title="BrightDataWebScraper">
        <Tip>
          **API reference**: [Scrapers Documentation](/products/scrapers/overview)
        </Tip>

        Extract structured data from 45+ supported websites, including e-commerce, social media, and business intelligence platforms.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from haystack_brightdata import BrightDataWebScraper
          import os

          # Set your API key
          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          # Initialize the scraper
          scraper = BrightDataWebScraper()

          # Extract Amazon product data
          result = scraper.run(
              dataset="amazon_product",
              url="https://www.amazon.com/dp/B08N5WRWNW"
          )
          print(result["data"])
          ```

          ```python Advanced Usage - LinkedIn Profile theme={null}
          from haystack_brightdata import BrightDataWebScraper
          import os

          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          scraper = BrightDataWebScraper()

          # Extract LinkedIn profile data
          result = scraper.run(
              dataset="linkedin_person_profile",
              url="https://www.linkedin.com/in/example-profile/"
          )
          print(result["data"])

          # Extract Instagram profile data
          result = scraper.run(
              dataset="instagram_profiles",
              url="https://www.instagram.com/username/"
          )
          print(result["data"])
          ```

          ```python List Supported Datasets theme={null}
          from haystack_brightdata import BrightDataWebScraper

          # Get all supported datasets
          datasets = BrightDataWebScraper.get_supported_datasets()
          for dataset in datasets:
              print(f"{dataset['id']}: {dataset['description']}")

          # Get info about a specific dataset
          info = BrightDataWebScraper.get_dataset_info("amazon_product")
          print(f"Description: {info['description']}")
          print(f"Required inputs: {info['inputs']}")
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataSERP">
        <Tip>
          **API reference**: [SERP API Documentation](/products/serp-api/introduction)
        </Tip>

        Collect search engine results with geo-targeting and language customization.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from haystack_brightdata import BrightDataSERP
          import os

          # Set your API key
          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          # Initialize SERP component
          serp = BrightDataSERP(
              default_search_engine="google",
              default_country="us",
              default_language="en"
          )

          # Execute a search query
          result = serp.run(
              query="machine learning tutorials",
              num_results=20,
              search_type="web"
          )
          print(result)
          ```

          ```python Advanced Usage with Geo-targeting theme={null}
          from haystack_brightdata import BrightDataSERP
          import os

          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          serp = BrightDataSERP()

          # Search from a different country with different language
          result = serp.run(
              query="inteligencia artificial",
              country="es",
              language="es",
              num_results=10
          )
          print(result)
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataUnlocker">
        <Tip>
          **API reference**: [Web Unlocker Documentation](/products/web-unlocker/introduction)
        </Tip>

        Access any public website, even if it's bot-protected or geo-restricted.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from haystack_brightdata import BrightDataUnlocker
          import os

          # Set your API key
          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          # Initialize Web Unlocker
          unlocker = BrightDataUnlocker(default_output_format="markdown")

          # Access a website and get content as markdown
          result = unlocker.run(
              url="https://example.com/restricted-content",
              output_format="markdown"
          )
          print(result["content"])
          ```

          ```python Advanced Usage with Geo-targeting theme={null}
          from haystack_brightdata import BrightDataUnlocker
          import os

          os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"

          unlocker = BrightDataUnlocker()

          # Access from a specific country
          result = unlocker.run(
              url="https://example.com",
              country="gb",
              output_format="html"
          )
          print(result)

          # Get a screenshot
          result = unlocker.run(
              url="https://example.com",
              output_format="screenshot"
          )
          # result contains base64-encoded screenshot
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Step>
</Steps>

## RAG Pipeline Examples

### Product Data RAG Pipeline

Build a Retrieval-Augmented Generation (RAG) pipeline using Bright Data to extract product data from Amazon and answer questions about products:

```python theme={null}
import os
from haystack import Pipeline, Document
from haystack.components.builders import ChatPromptBuilder
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.components.embedders import OpenAIDocumentEmbedder, OpenAITextEmbedder
from haystack.components.retrievers.in_memory import InMemoryEmbeddingRetriever
from haystack.document_stores.in_memory import InMemoryDocumentStore
from haystack.dataclasses import ChatMessage
from haystack_brightdata import BrightDataWebScraper
import json

# Set API keys
os.environ["BRIGHT_DATA_API_KEY"] = "your-brightdata-api-key"
os.environ["OPENAI_API_KEY"] = "your-openai-api-key"

# Initialize components
scraper = BrightDataWebScraper()
document_store = InMemoryDocumentStore()
docs_embedder = OpenAIDocumentEmbedder()
text_embedder = OpenAITextEmbedder()
retriever = InMemoryEmbeddingRetriever(document_store)
generator = OpenAIChatGenerator()

# Scrape product data from multiple Amazon products
product_urls = [
    "https://www.amazon.com/dp/B0DRWBJDLJ",
    "https://www.amazon.com/dp/B08B8M5JGN",
    "https://www.amazon.com/dp/B09WTTWH1R",
]

documents = []
for url in product_urls:
    result = scraper.run(dataset="amazon_product", url=url)

    # Parse the response
    if isinstance(result["data"], str):
        product_data = json.loads(result["data"])
    else:
        product_data = result["data"]

    if not isinstance(product_data, list):
        product_data = [product_data]

    for product in product_data:
        content_parts = [
            f"Product: {product.get('title', 'N/A')}",
            f"Brand: {product.get('brand', 'N/A')}",
            f"Price: ${product.get('final_price', 'N/A')} {product.get('currency', '')}",
            f"Rating: {product.get('rating', 0)}/5",
            f"Reviews Count: {product.get('reviews_count', 0)}",
        ]

        if product.get('description'):
            content_parts.append(f"Description: {product.get('description')}")

        if product.get('features'):
            features_text = '\n  - '.join(product.get('features', []))
            content_parts.append(f"Features:\n  - {features_text}")

        content = '\n'.join(content_parts)

        documents.append(Document(
            content=content,
            meta={
                "url": product.get('url', url),
                "title": product.get('title', ''),
                "price": product.get('final_price', 0),
                "rating": product.get('rating', 0),
            }
        ))

# Embed and store documents
embeddings = docs_embedder.run(documents)
document_store.write_documents(embeddings["documents"])

# Create RAG pipeline with ChatPromptBuilder
messages = [
    ChatMessage.from_system("You are a helpful shopping assistant."),
    ChatMessage.from_user("""
Context:
{% for document in documents %}
    {{ document.content }}
{% endfor %}

Question: {{question}}
""")
]

prompt_builder = ChatPromptBuilder(template=messages)

# Build and connect pipeline
pipe = Pipeline()
pipe.add_component("embedder", text_embedder)
pipe.add_component("retriever", retriever)
pipe.add_component("prompt_builder", prompt_builder)
pipe.add_component("llm", generator)

pipe.connect("embedder.embedding", "retriever.query_embedding")
pipe.connect("retriever", "prompt_builder.documents")
pipe.connect("prompt_builder", "llm")

# Ask questions about the products
question = "Which product has the best rating?"
response = pipe.run({
    "embedder": {"text": question},
    "prompt_builder": {"question": question}
})

print(f"Answer: {response['llm']['replies'][0].text}")
```

### SERP + Web Content RAG Pipeline

Use SERP API to find relevant web pages, then use Web Unlocker to extract content for a RAG pipeline:

```python theme={null}
import os
from haystack import Pipeline, Document
from haystack.components.builders import ChatPromptBuilder
from haystack.components.generators.chat import OpenAIChatGenerator
from haystack.components.embedders import OpenAIDocumentEmbedder, OpenAITextEmbedder
from haystack.components.retrievers.in_memory import InMemoryEmbeddingRetriever
from haystack.document_stores.in_memory import InMemoryDocumentStore
from haystack.dataclasses import ChatMessage
from haystack_brightdata import BrightDataSERP, BrightDataUnlocker
import json

# Set API keys
os.environ["BRIGHT_DATA_API_KEY"] = "your-brightdata-api-key"
os.environ["OPENAI_API_KEY"] = "your-openai-api-key"

# Initialize components
serp = BrightDataSERP()
unlocker = BrightDataUnlocker(default_output_format="markdown", zone="unblocker")
document_store = InMemoryDocumentStore()
docs_embedder = OpenAIDocumentEmbedder()
text_embedder = OpenAITextEmbedder()
retriever = InMemoryEmbeddingRetriever(document_store)
generator = OpenAIChatGenerator(model="gpt-4")

# Search for information
search_query = "best practices for machine learning in production"
search_result = serp.run(query=search_query, num_results=5)
search_data = json.loads(search_result["results"])

# Extract URLs from search results
urls = []
for result in search_data.get("organic", [])[:5]:
    url = result.get("url") or result.get("link")
    if url:
        urls.append(url)

# Fetch content from each URL
documents = []
for url in urls:
    try:
        result = unlocker.run(url=url, output_format="markdown")
        content = result["content"]
        documents.append(Document(
            content=content,
            meta={"url": url}
        ))
    except Exception as e:
        print(f"Failed to fetch {url}: {e}")

# Embed and store documents
embeddings = docs_embedder.run(documents)
document_store.write_documents(embeddings["documents"])

# Create RAG pipeline
messages = [
    ChatMessage.from_system("You are a knowledgeable AI assistant."),
    ChatMessage.from_user("""
Context from web sources:
{% for document in documents %}
    Source: {{ document.meta.url }}
    {{ document.content }}
{% endfor %}

Question: {{question}}
""")
]

prompt_builder = ChatPromptBuilder(template=messages)

pipe = Pipeline()
pipe.add_component("embedder", text_embedder)
pipe.add_component("retriever", retriever)
pipe.add_component("prompt_builder", prompt_builder)
pipe.add_component("llm", generator)

pipe.connect("embedder.embedding", "retriever.query_embedding")
pipe.connect("retriever", "prompt_builder.documents")
pipe.connect("prompt_builder", "llm")

# Ask questions
question = "What are the main challenges of deploying ML models in production?"
response = pipe.run({
    "embedder": {"text": question},
    "prompt_builder": {"question": question}
})

print(f"Answer: {response['llm']['replies'][0].text}")
```

## Which datasets are supported

The `BrightDataWebScraper` component supports 45+ datasets across multiple categories:

| Category | Datasets |
| - | - |
| **E-commerce** | amazon\_product, amazon\_product\_reviews, amazon\_product\_search, walmart\_product, walmart\_seller, ebay\_product, homedepot\_products, zara\_products, etsy\_products, bestbuy\_products |
| **LinkedIn** | linkedin\_person\_profile, linkedin\_company\_profile, linkedin\_job\_listings, linkedin\_posts, linkedin\_people\_search |
| **Instagram** | instagram\_profiles, instagram\_posts, instagram\_reels, instagram\_comments |
| **Facebook** | facebook\_posts, facebook\_marketplace\_listings, facebook\_company\_reviews, facebook\_events |
| **TikTok** | tiktok\_profiles, tiktok\_posts, tiktok\_shop, tiktok\_comments |
| **YouTube** | youtube\_profiles, youtube\_videos, youtube\_comments |
| **Search & Commerce** | google\_maps\_reviews, google\_shopping, google\_play\_store, apple\_app\_store, zillow\_properties\_listing, booking\_hotel\_listings |
| **Business Intelligence** | crunchbase\_company, zoominfo\_company\_profile |
| **Other** | github\_repository\_file, yahoo\_finance\_business, x\_posts, reddit\_posts |

<Tip>
  For detailed information about each dataset and its required parameters:

  ```python theme={null}
  from haystack_brightdata import BrightDataWebScraper

  # List all datasets
  datasets = BrightDataWebScraper.get_supported_datasets()
  for dataset in datasets:
      print(f"{dataset['id']}: {dataset['description']}")
  ```
</Tip>

## Use Cases

Bright Data's Haystack integration enables powerful use cases:

* **E-commerce Intelligence**: Price monitoring, product data extraction, and competitive analysis
* **Social Media Analytics**: Content monitoring and engagement analysis across platforms
* **Business Intelligence**: Company research and competitive landscape analysis
* **Search Analysis**: SEO/SEM research with geo-targeted search results
* **Content Aggregation**: Building RAG pipelines with real-time web data
* **Market Research**: Accessing geo-restricted content for global research


# Set up Bright Data with Helium Scraper
Source: https://docs.brightdata.com/integrations/helium-scraper

Configure Bright Data proxies in Helium Scraper to route web scraping jobs through residential, datacenter, ISP, or mobile IPs at scale. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Helium Scraper?

Helium Scraper is an intuitive, desktop-based web scraping tool designed to help you extract data from websites without needing any coding skills. Its visual interface makes it easy to select, extract, and organize data, perfect for both beginners and experienced users alike.

Helium Scraper is ideal for small to medium-scale scraping projects. Whether you're a freelancer, marketer, or business professional, it provides an efficient and straightforward way to collect and structure web data without the complexity of programming.

## Helium Scraper Proxy Integration

Follow these simple steps to set up Bright Data proxies with Helium Scraper:

<Steps>
  <Step title="Install Helium Scraper">
    1. [Download Helium Scraper](https://www.heliumscraper.com/eng/download.php) and install it on your computer.
    2. Launch Helium Scraper once the installation is complete.
  </Step>

  <Step title="Access the Proxy List">
    In Helium Scraper, click on **File > Proxy List** to open the proxy configuration panel.

    <Frame>
      <img alt="Helium Scraper Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Add your Bright Data proxy details to the fields provided:

    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Username**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    Click **OK** to store your proxy settings.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Enable Proxies for Your Project">
    1. Go to **Project > Settings** from the menu.

    <Frame>
      <img alt="Helium Scraper Proxy Integration" />
    </Frame>

    2. In the settings window, set **Enable Proxies** to **True**.

    <Frame>
      <img alt="Helium Scraper Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Verify the Proxy Setup">
    1. Open a website that displays your IP address using Helium Scraper’s built-in browser.
    2. Check if the displayed IP matches the Bright Data proxy settings to confirm the proxy integration.
  </Step>
</Steps>

**That’s it!** You've now successfully integrated Bright Data proxies with Helium Scraper.


# Set up Bright Data with Smolagents
Source: https://docs.brightdata.com/integrations/hugging-face

Connect Smolagents to Bright Data (thousands of pre-built scrapers) so your agent can crawl sites, run web searches and access data from LinkedIn and Amazon.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Why Use Bright Data With Smolagents?

The Bright Data tools for Smolagents provide the following capabilities:

<AccordionGroup>
  <Accordion title="Web Search">
    * **`search_tool`**\
      Search Google and get structured search results. This tool can search the web and return relevant results for your queries.

    ```python theme={null}
    from smolagents import Tool

    web_search = Tool.from_space(
        "BrightData/brightdata-search-tool",
        name="search_tool",
        description="search the web"
    )
    ```
  </Accordion>

  <Accordion title="Extract">
    * **`extract_tool`**\
      Scrape webpages and extract content as Markdown format. This tool can bypass CAPTCHA and bot detection to reliably extract data from any website.

    ```python theme={null}
    from smolagents import Tool

    extract = Tool.from_space(
        "BrightData/brightdata-scraper-tool",
        name="extract_tool",
        description="extract data from the web as markdown without getting blocked"
    )
    ```
  </Accordion>

  <Accordion title="Structured Data Feeds">
    * **`data_feeds_tool`**\
      Retrieve structured data from various platforms including LinkedIn, Amazon, Instagram, Facebook, X (Twitter), Zillow, and more.

    ```python theme={null}
    from smolagents import Tool

    data_feeds = Tool.from_space(
        "BrightData/brightdata-dataset-tool",
        name="data_feeds_tool",
        description="extract structured data from the web"
    )
    ```

    Supported platforms include:

    * LinkedIn (profiles and companies)
    * Amazon (products and reviews)
    * Instagram (profiles, posts, reels, comments)
    * Facebook (posts, marketplace listings, company reviews)
    * X/Twitter (posts)
    * Zillow (property listings)
    * Booking.com (hotel listings)
    * YouTube (videos)
    * And many more

    For more information, visit the [Bright Data documentation](/).
  </Accordion>
</AccordionGroup>

## How to Integrate Bright Data With Smolagents?

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Installation">
    Install the required packages. **Important:** As of December 9, 2025, these specific versions are mandatory to align with Smolagents:

    ```bash theme={null}
    pip install smolagents
    pip install --upgrade --force-reinstall "gradio_client<2.0.0" "gradio<6.0.0"
    ```
  </Step>

  <Step title="Configure API Key">
    Set your Bright Data API key as an environment variable:

    ```bash theme={null}
    export BRIGHTDATA_API_KEY="your-api-key"
    ```

    Or set it in your Python code:

    ```python theme={null}
    import os
    os.environ["BRIGHTDATA_API_KEY"] = "your-api-key"
    ```
  </Step>

  <Step title="Obtain Your Hugging Face API Token">
    When using `InferenceClientModel`, you need a Hugging Face token for authentication:

    * Visit [Hugging Face Settings - Tokens](https://hf.co/settings/tokens)
    * Create a new token with "Make calls to the serverless Inference API" permission
    * Set it as an environment variable:

    ```bash theme={null}
        export HF_TOKEN="your-hf-token"
    ```

    Or pass it directly when initializing the model:

    ```python theme={null}
        model = InferenceClientModel(
            model_id="Qwen/Qwen3-Next-80B-A3B-Thinking",
            token="your-hf-token"
        )
    ```

    **Note:** Free Hugging Face accounts include inference credits. Upgrade to PRO for higher rate limits.
  </Step>

  <Step title="Usage">
    Here's a complete example of how to use Bright Data tools with Smolagents:

    ```python theme={null}
    from smolagents import CodeAgent, InferenceClientModel, Tool

    # Load Bright Data tools from Hugging Face Spaces
    web_search = Tool.from_space(
        "BrightData/brightdata-search-tool",
        name="search_tool",
        description="search the web"
    )

    extract = Tool.from_space(
        "BrightData/brightdata-scraper-tool",
        name="extract_tool",
        description="extract data from the web as markdown without getting blocked"
    )

    data_feeds = Tool.from_space(
        "BrightData/brightdata-dataset-tool",
        name="data_feeds_tool",
        description="extract structured data from the web"
    )

    # Initialize the model
    model = InferenceClientModel(model_id="Qwen/Qwen3-Next-80B-A3B-Thinking")

    # Create the agent with Bright Data tools
    agent = CodeAgent(tools=[web_search, extract, data_feeds], model=model)

    # Run the agent
    response = agent.run(
        "Improve this prompt, then search the web for it.",
        additional_args={'user_prompt': 'who is elon musk'}
    )

    print(response)
    ```
  </Step>
</Steps>

## Example Use Cases

<AccordionGroup>
  <Accordion title="Web Research">
    Use the search tool to find information across the web:

    ```python theme={null}
    agent.run("Search for the latest developments in quantum computing")
    ```
  </Accordion>

  <Accordion title="Data Extraction">
    Scrape and extract content from websites:

    ```python theme={null}
    agent.run("Extract the main content from https://example.com/article")
    ```
  </Accordion>

  <Accordion title="Competitor Analysis">
    Extract structured data from e-commerce platforms:

    ```python theme={null}
    agent.run("Get product details and reviews for the top-rated laptops on Amazon")
    ```
  </Accordion>

  <Accordion title="Social Media Intelligence">
    Retrieve data from social media platforms:

    ```python theme={null}
    agent.run("Get the latest posts and engagement metrics from a LinkedIn company page")
    ```
  </Accordion>
</AccordionGroup>

## Tips for Best Results

* **Be specific** with your prompts to help the agent understand exactly what data you need
* **Combine tools** for complex tasks - the agent can use search, extract, and data feeds together

For more advanced configurations and detailed API documentation, visit [Bright Data's documentation](/).


# IBM Watsonx Orchestrate
Source: https://docs.brightdata.com/integrations/ibm-watsonx-orchestrate

Connect Bright Data's MCP server to IBM watsonx Orchestrate so agents can call live web scraping, search, and unblocking tools at runtime. Spans 195 countries.

## Overview

This integration provides your agents with web scraping and multi-engine search operations with bot protection bypass.

## Prerequisites

Before you begin, ensure you have:

* Access to IBM watsonx Orchestrate
* A Bright Data account with an active subscription
* Your Bright Data API key

## Steps to Get Started

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp)
    * Navigate to [Account Settings](https://brightdata.com/cp/setting/users)
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already
    * Copy and securely store your API key for the next steps
  </Step>

  <Step title="Open the Agent Toolset">
    * Navigate to **Manage Agents** in IBM watsonx Orchestrate
    * Select your agent
    * In the left menu, click **Toolset**
    * Click **Add Tool**
      <img alt="Steps to Get Started" />
  </Step>

  <Step title="Add MCP Server Connection">
    In the "Add tool" dialog:

    <Frame>
      <img alt="Image" />
    </Frame>

    * Select **MCP server**

    * Click on the **Add MCP server** button:

      <Frame>
        <img alt="Add MCP server button in IBM watsonx Orchestrate" />
      </Frame>

    * Select **Remote MCP** and click **Next**:

      <Frame>
        <img alt="Selecting Remote MCP in IBM watsonx Orchestrate" />
      </Frame>

    * Choose a name for your Bright Data MCP server, add an optional description, and paste the MCP server URL including your API token, then click **Connect**:

      ```bash theme={null}
      https://mcp.brightdata.com/sse?token=YOUR_API_KEY
      ```

      <Frame>
        <img alt="Bright Data MCP server connection details in IBM watsonx Orchestrate" />
      </Frame>
  </Step>

  <Step title="Enable Available Capabilities">
    Once installation completes, multiple capabilities will appear in your agent's toolset. Enable the following:

    `search_engine`

    `scrape_as_markdown`
  </Step>

  <Step title="Test Your Connection">
    Verify the integration is working:

    * Open your agent's chat interface
    * Ask the agent to perform a simple task (e.g., "Search for recent AI trends")
    * Confirm the agent successfully retrieves and processes data from Bright Data
  </Step>
</Steps>

## Example use cases

Once `search_engine` and `scrape_as_markdown` are enabled, your IBM watsonx Orchestrate agent can handle prompts like the ones below. Each example shows the user prompt, which Bright Data tool the agent will call, and the expected outcome.

### Search the live web with `search_engine`

Use `search_engine` when the agent needs fresh SERP results from Google, Bing or Yandex without being blocked.

<CodeGroup>
  ```text Market research theme={null}
  Find the top 10 results on Google for "enterprise RAG platforms 2026"
  and return the title, URL and snippet for each result as a table.
  ```

  ```text Geo-targeted SERP theme={null}
  Search Google for "best cloud GPU providers" as if I were located in
  Germany, then list the first page of organic results.
  ```

  ```text News monitoring theme={null}
  Search Bing News for "IBM watsonx Orchestrate" from the last 7 days
  and summarize the top 5 headlines with publication dates.
  ```
</CodeGroup>

**Expected behavior:** the agent calls `search_engine`, parses the SERP JSON, and replies with a structured summary. No proxy setup or CAPTCHA handling is required on your side.

### Extract page content with `scrape_as_markdown`

Use `scrape_as_markdown` when the agent needs the full content of a known URL, including pages protected by bot detection.

<CodeGroup>
  ```text Competitive intelligence theme={null}
  Scrape https://www.ibm.com/products/watsonx-orchestrate and summarize
  the key features and pricing tiers in a 5-bullet executive briefing.
  ```

  ```text Documentation lookup theme={null}
  Fetch the page at https://docs.brightdata.com/api-reference/MCP-Server
  and list every tool name with its one-line description.
  ```

  ```text Product page extraction theme={null}
  Scrape this product URL and return the title, price, rating and the
  first 3 customer reviews as JSON: https://www.example-store.com/item/123
  ```
</CodeGroup>

**Expected behavior:** the agent calls `scrape_as_markdown` with the URL, receives clean markdown, and extracts the requested fields. Pages that would normally trigger CAPTCHAs or 403 responses are handled by Bright Data's Unlocker infrastructure.

### Combine both tools in one task

The agent can chain `search_engine` and `scrape_as_markdown` to answer multi-step questions.

```text Research workflow theme={null}
Search Google for "top 5 vector databases 2026", then scrape the
homepage of each result and produce a comparison table with: product
name, pricing model, supported languages and a one-sentence positioning
statement.
```

The agent first calls `search_engine` to get the URLs, then calls `scrape_as_markdown` once per URL, then synthesizes the comparison. This pattern works for competitor analysis, lead enrichment and content aggregation flows.

## What you can do next

Your agent is now connected to Bright Data and ready to:

* Extract structured data from major platforms
* Perform geo-targeted web searches
* Scrape website content while bypassing bot protection
* Process large-scale data extraction tasks

## Where to get support

Need help? Contact Bright Data support or refer to the [Bright Data documentation](/) for detailed API references and troubleshooting guides.


# Integrations
Source: https://docs.brightdata.com/integrations/introduction

Connect Bright Data with your favorite tools, frameworks, and platforms. Browse by category to find setup guides for your stack.

Pick the category that matches your stack. Each one lists every tool Bright Data has a setup guide for, in the same order as the sidebar.

<CardGroup>
  <Card title="Coding agents" icon="server" href="/products/mcp-server/integrations/overview">
    Claude Code, Cursor, VS Code and Codex, connected through Bright Data MCP.
  </Card>

  <Card title="Agentic platforms" icon="brain" href="/integrations/ai-integrations">
    LangChain, LlamaIndex, CrewAI, Dify, Haystack and 25 more agent frameworks.
  </Card>

  <Card title="Automation tools" icon="bolt" href="/integrations/automation-integrations">
    Zapier, n8n, PhantomBuster, Playwright, Puppeteer and other workflow tools.
  </Card>

  <Card title="Scraping tools" icon="spider" href="/integrations/scraping-tools-integrations">
    Scrapy, BeautifulSoup, Octoparse, ParseHub and Screaming Frog.
  </Card>

  <Card title="Browsers" icon="browser" href="/integrations/browser-integrations">
    Chrome, Firefox and 29 anti-detect browsers including AdsPower and Kameleo.
  </Card>

  <Card title="Proxy managers" icon="network-wired" href="/integrations/proxy-manager-integrations">
    FoxyProxy, Proxifier, SwitchyOmega, Shadowrocket and Postern.
  </Card>

  <Card title="Operating systems" icon="desktop" href="/integrations/systems-integrations">
    Android, iOS, macOS, Ubuntu and Windows setup guides.
  </Card>

  <Card title="Testing" icon="flask" href="/integrations/testing-integrations">
    Postman and other API testing tools.
  </Card>
</CardGroup>


# How to set up Bright Data with LangChain
Source: https://docs.brightdata.com/integrations/langchain

Integrate Bright Data with LangChain to give LLM-powered agents reliable, anonymous, and scalable web access for real-world data tasks. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Integrating Bright Data with LangChain enhances LLM-powered agents with reliable, anonymous, and scalable web access for real-world applications.\
You can do it either by using the `langchain-brightdata` Python package is the official LangChain integration for Bright Data, including support for:

* **BrightDataSERP** - Bright Data provides a powerful SERP API that allows you to query search engines (Google,Bing, DuckDuckGo,Yandex) with geo-targeting and advanced customization options, particularly useful for AI agents requiring real-time web information.
* **BrightDataUnlockerAPI** - Bright Data provides a powerful Web Unlocker API that allows you to access websites that might be protected by anti-bot measures, geo-restrictions, or other access limitations, making it particularly useful for AI agents requiring reliable web content extraction.
* **BrightDataWebScraperAPI** - Bright Data provides a powerful Scrapers that allows you to extract structured data from 100+ ppular domains, including Amazon product details, LinkedIn profiles, and more, making it particularly useful for AI agents requiring reliable structured web data feeds.

Or by [**Bright Data’s MCP (Model Context Protocol)**](/products/mcp-server/overview#configuration) - a local server that exposes a wide range of scraping and automation tools. While not part of the `langchain-brightdata` package, it can be integrated manually using LangChain’s `Tool` or `RequestsWrapper`.

## How to Integrate Bright Data With LangChain

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for LangChain by running the following command:

    ```bash theme={null}
    pip install langchain-brightdata
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key as an environment variable:

    ```python theme={null}
    import os
    os.environ["BRIGHT_DATA_API_KEY"] = "your-api-key"
    ```

    <Tip>
      Or pass it directly when initializing tools:

      ```python theme={null}
      from langchain_bright_data import BrightDataSERP

      tool = BrightDataSERP(bright_data_api_key="your-api-key")
      ```
    </Tip>
  </Step>

  <Step title="Select your preferred Bright Data tool">
    The Bright Data + LangChain integration currently supports:

    <Tabs>
      <Tab title="BrightDataSERP">
        <Tip>
          **API reference**: [SERP API Documentation](/products/serp-api/introduction)
        </Tip>

        Collect search engine results with geo-targeting

        <CodeGroup>
          ```python Basic Usage theme={null}
          from langchain_brightdata import BrightDataSERP

          # Initialize the tool
          serp_tool = BrightDataSERP(
              bright_data_api_key="your-api-key"  # Optional if set in environment variables
          )

          # Run a basic search
          results = serp_tool.invoke("latest AI research papers")

          print(results)
          ```

          ```python Advanced Usage with Parameters theme={null}
          from langchain_brightdata import BrightDataSERP

          # Initialize with default parameters
          serp_tool = BrightDataSERP(
              bright_data_api_key="your-api-key",
              search_engine="google",  # Default
              country="us",  # Default
              language="en",  # Default
              results_count=10,  # Default
              parse_results=True,  # Get structured JSON results
          )

          # Use with specific parameters for this search
          results = serp_tool.invoke(
              {
                  "query": "best electric vehicles",
                  "country": "de",  # Get results as if searching from Germany
                  "language": "de",  # Get results in German
                  "search_type": "shop",  # Get shopping results
                  "device_type": "mobile",  # Simulate a mobile device
                  "results_count": 15,
              }
          )

          print(results)
          ```

          ```python Use within an agent theme={null}
          from langchain_brightdata import BrightDataSERP
          from langchain_google_genai import ChatGoogleGenerativeAI
          from langgraph.prebuilt import create_react_agent

          # Initialize the LLM
          llm = ChatGoogleGenerativeAI(model="gemini-2.0-flash", google_api_key="your-api-key")

          # Initialize the Bright Data SERP tool
          serp_tool = BrightDataSERP(
              bright_data_api_key="your-api-key",
              search_engine="google",
              country="us",
              language="en",
              results_count=10,
              parse_results=True,
          )

          # Create the agent
          agent = create_react_agent(llm, [serp_tool])

          # Provide a user query
          user_input = "Search for 'best electric vehicles' shopping results in Germany in German using mobile."

          # Stream the agent's output step-by-step
          for step in agent.stream(
              {"messages": user_input},
              stream_mode="values",
          ):
              step["messages"][-1].pretty_print()
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataUnblocker">
        <Tip>
          **API reference**: [Web Unlocker API Documentation](/products/web-unlocker/introduction)
        </Tip>

        Access any public website, even if it’s bot-protected or geo-restricted.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from langchain_brightdata import BrightDataUnlocker

          # Initialize the tool
          unlocker_tool = BrightDataUnlocker(
              bright_data_api_key="your-api-key"  # Optional if set in environment variables
          )

          # Access a webpage
          result = unlocker_tool.invoke("https://example.com")

          print(result)
          ```

          ```python Advanced Usage with Parameters theme={null}
          from langchain_brightdata import BrightDataUnlocker

          unlocker_tool = BrightDataUnlocker(
              bright_data_api_key="your-api-key",
          )

          # Access a webpage with specific parameters
          result = unlocker_tool.invoke(
              {
                  "url": "https://example.com/region-restricted-content",
                  "country": "gb",  # Access as if from Great Britain
                  "data_format": "html",  # Get content in markdown format
                  "zone": "unlocker",  # Use the unlocker zone
              }
          )

          print(result)
          ```

          ```python Use within an agent theme={null}
          from langchain_brightdata import BrightDataUnlocker
          from langchain_google_genai import ChatGoogleGenerativeAI
          from langgraph.prebuilt import create_react_agent

          # Initialize the LLM
          llm = ChatGoogleGenerativeAI(model="gemini-2.0-flash", google_api_key="your-api-key")

          # Initialize the tool
          bright_data_tool = BrightDataUnlocker(bright_data_api_key="your-api-key")

          # Create the agent
          agent = create_react_agent(llm, [bright_data_tool])

          # Input URLs or prompt
          user_input = "Get the content from https://example.com/region-restricted-page - access it from GB"

          # Stream the agent's output step by step
          for step in agent.stream(
              {"messages": user_input},
              stream_mode="values",
          ):
              step["messages"][-1].pretty_print()
          ```
        </CodeGroup>
      </Tab>

      <Tab title="BrightDataWebScraperAPI">
        <Tip>
          **API reference**: [Scrapers Documentation](/products/scrapers/overview)
        </Tip>

        Extract structured data from over 100 supported domains like Amazon, LinkedIn, and more.

        <CodeGroup>
          ```python Basic Usage theme={null}
          from langchain_brightdata import BrightDataWebScraperAPI

          # Initialize the tool
          scraper_tool = BrightDataWebScraperAPI(
              bright_data_api_key="your-api-key"  # Optional if set in environment variables
          )

          # Extract Amazon product data
          results = scraper_tool.invoke(
              {"url": "https://www.amazon.com/dp/B08L5TNJHG", "dataset_type": "amazon_product"}
          )

          print(results)
          ```

          ```python Advanced Usage with Parameters theme={null}
          from langchain_brightdata import BrightDataWebScraperAPI

          # Initialize with default parameters
          scraper_tool = BrightDataWebScraperAPI(bright_data_api_key="your-api-key")

          # Extract Amazon product data with location-specific pricing
          results = scraper_tool.invoke(
              {
                  "url": "https://www.amazon.com/dp/B08L5TNJHG",
                  "dataset_type": "amazon_product",
                  "zipcode": "10001",  # Get pricing for New York City
              }
          )

          print(results)

          # Extract LinkedIn profile data
          linkedin_results = scraper_tool.invoke(
              {
                  "url": "https://www.linkedin.com/in/satyanadella/",
                  "dataset_type": "linkedin_person_profile",
              }
          )

          print(linkedin_results)
          ```

          ```python Use within an agent theme={null}
          from langchain_brightdata import BrightDataWebScraperAPI
          from langchain_google_genai import ChatGoogleGenerativeAI
          from langgraph.prebuilt import create_react_agent

          # Initialize the LLM
          llm = ChatGoogleGenerativeAI(model="gemini-2.0-flash", google_api_key="your-api-key")

          # Initialize the Bright Data Scrapers tool
          scraper_tool = BrightDataWebScraperAPI(bright_data_api_key="your-api-key")

          # Create the agent with the tool
          agent = create_react_agent(llm, [scraper_tool])

          # Provide a user query
          user_input = "Scrape Amazon product data for https://www.amazon.com/dp/B0D2Q9397Y?th=1 in New York (zipcode 10001)."

          # Stream the agent's step-by-step output
          for step in agent.stream(
              {"messages": user_input},
              stream_mode="values",
          ):
              step["messages"][-1].pretty_print()
          ```
        </CodeGroup>
      </Tab>
    </Tabs>
  </Step>
</Steps>


# How to set up Bright Data with Lindy.ai
Source: https://docs.brightdata.com/integrations/lindy-ai

Connect Bright Data to Lindy.ai to automate web data workflows: trigger real-time collection, call APIs and feed results into business apps.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Lindy.ai?

Lindy.ai is a no-code AI automation platform that enables users to create and deploy AI-powered agents, often referred to as "AI employees," to automate a wide range of business tasks. These agents can handle functions such as email management, customer support, scheduling, CRM data entry, lead generation, and more, integrating seamlessly with over 200 applications including Gmail, Slack, Zoom, and HubSpot.

## Why Use Bright Data With Lindy.ai?

**Automate Web Data Collection Workflows**

* Bright Data can scrape real-time data from websites (e.g., eCommerce, job boards, social media).
* Lindy.ai can automate when, how, and where that data is used (e.g., daily digests, alerts, CRM updates).

**No-Code Integration of Complex Data Pipelines**

* No need for developers or manual scripting.
* Build workflows visually in Lindy.ai using HTTP blocks to call Bright Data APIs.

**Trigger Actions Based on Live Data**

* **Example**: Scrape prices from competitor websites → If a product is cheaper than yours → Trigger a Slack alert or email team.
* **Example**: Monitor job postings → If a new listing matches your criteria → Add to Google Sheet or notify via SMS.

**Boost Operational Efficiency**

* Eliminate repetitive tasks like manual monitoring or copy-pasting scraped data.
* Your Lindy agents can act on web data automatically, 24/7.

**Scalable & Reliable**

* Bright Data handles proxy management, anti-bot bypassing, and data quality.
* Lindy handles logic, scheduling, and integrations with 200+ apps (CRM, Notion, Airtable, etc.).

## How to Integrate Bright Data With Lindy.ai?

<Steps>
  <Step title="Prerequisites">
    Before starting, make sure you have:

    * A **Bright Data** account with access to APIs (e.g., Browser API, Web Unlocker API, or DCA)
    * Your **Bright Data API key**
    * A **Lindy.ai** account
    * A basic understanding of APIs and HTTP requests
  </Step>

  <Step title="Choose and Configure Your Bright Data API">
    Depending on your use case, select the appropriate Bright Data API:

    * **Browser API** – For rendering JavaScript-heavy pages
    * **Data Collector API (DCA)** – For prebuilt scrapers
    * **Web Unlocker API** – For bypassing anti-bot mechanisms

    > 🔗 Example API endpoint (DCA):

    ```http theme={null}
    POST https://api.brightdata.com/dca/trigger
    ```
  </Step>

  <Step title="Get Your Bright Data API Key">
    1. Log in to your [Bright Data dashboard](https://brightdata.com/).
    2. Navigate to **API settings**.
    3. Copy your **API key**.
  </Step>

  <Step title="Create a New Workflow in Lindy.ai">
    1. Go to [Lindy.ai](https://lindy.ai) and log in.
    2. Click **Create Agent** or **New Workflow**.
    3. Choose a **Blank Workflow** or start from a use-case template.
  </Step>

  <Step title="Add an HTTP Request Block">
    1. Click “+” to add a block in your workflow.
    2. Select **HTTP Request**.

    > Configure as follows:
    >
    > * **Method**: `POST` or `GET` (depends on API)
    > * **URL**: Bright Data API endpoint (e.g., DCA trigger endpoint)
    > * **Headers**:
    >   * `Authorization`: `Bearer <your_api_key>`
    >   * `Content-Type`: `application/json`
    > * **Body** (if POST): JSON payload for your API

    ### Example: Trigger a Data Collector

    **HTTP Request Body:**

    ```json theme={null}
    {
      "collector_id": "clt_123456789",
      "start_url": "https://example.com/products"
    }
    ```

    **Response**: Bright Data returns a `collection_id`, which you can use in another step fetch the results."
  </Step>

  <Step title="Add Logic to Handle API Response">
    * Use Lindy's built-in blocks to:
      * Store the response
      * Parse data (e.g., JSON extract)
      * Trigger next steps (e.g., email, CRM update, Slack alert)
  </Step>

  <Step title="Test & Deploy">
    * Run the workflow with test data.
    * Check response logs and tweak headers or body if needed.
    * Once successful, activate the workflow or schedule it on a timer.
  </Step>
</Steps>

<Tip>
  ### 🎯 Bonus Use Case Example: Scrape + Notify

  1. Use Bright Data to scrape job listings.
  2. Use Lindy to filter for roles with keywords (e.g., “remote”, “Python”).
  3. Automatically email the relevant listings to your hiring team daily.
</Tip>


# How to set up Bright Data with LlamaIndex
Source: https://docs.brightdata.com/integrations/llama-index

Connect Bright Data to LlamaIndex to enable your agent to crawl websites, search the web, and extract structured data from major platforms. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

This tool connects to [Bright Data](https://brightdata.com/) to enable your agent to crawl websites, search the web, and access structured data from platforms like LinkedIn, Amazon, and social media.

Bright Data's tools provide robust web scraping capabilities with built-in CAPTCHA solving and bot detection avoidance, allowing you to reliably extract data from the web.

## Why Use Bright Data With LlamaIndex?

The Bright Data tool provides the following capabilities:

<AccordionGroup>
  <Accordion title="Web Scraping">
    * **`scrape_as_markdown`**\
      Scrape a webpage and convert the content to Markdown format. This tool can bypass CAPTCHA and bot detection.

    ```python theme={null}
    result = brightdata_tool.scrape_as_markdown("https://example.com")
    print(result.text)    
    ```
  </Accordion>

  <Accordion title="Visual Capture">
    * **`get_screenshot`**\
      Take a screenshot of a webpage and save it to a file.

    ```python theme={null}
    screenshot_path = brightdata_tool.get_screenshot(
        "https://example.com", output_path="example_screenshot.png"
    )
    ```
  </Accordion>

  <Accordion title="Search Engine Access">
    * **`search_engine`**\
      Search Google, Bing, or Yandex and get structured search results as JSON or Markdown. Supports advanced parameters for more specific searches.

    ```python theme={null}
    search_results = brightdata_tool.search_engine(
        query="climate change solutions",
        engine="google",
        language="en",
        country_code="us",
        num_results=20,
    )
    print(search_results.text)
    ```
  </Accordion>

  <Accordion title="Structured Web Data Extraction">
    * **`web_data_feed`**\
      Retrieve structured data from various platforms including LinkedIn, Amazon, Instagram, Facebook, X (Twitter), Zillow, and more.

    ```python theme={null}
    linkedin_profile = brightdata_tool.web_data_feed(
        source_type="linkedin_person_profile",
        url="https://www.linkedin.com/in/username/",
    )
    print(linkedin_profile)

    amazon_product = brightdata_tool.web_data_feed(
        source_type="amazon_product", url="https://www.amazon.com/dp/B08N5KWB9H"
    )
    print(amazon_product)
    ```
  </Accordion>

  <Accordion title="Advanced Configuration">
    The Bright Data tool offers various configuration options for specialized use cases:

    ### Search Engine Parameters

    The `search_engine` function supports advanced parameters like:

    * Language targeting (`language` parameter)
    * Country-specific search (`country_code` parameter)
    * Different search types (images, shopping, news, etc.)
    * Pagination controls
    * Mobile device emulation
    * Geolocation targeting
    * Hotel search parameters

    ```python theme={null}
    results = brightdata_tool.search_engine(
        query="best hotels in paris",
        engine="google",
        language="fr",
        country_code="fr",
        search_type="shopping",
        device="mobile",
        hotel_dates="2025-06-01,2025-06-05",
        hotel_occupancy=2,
    )
    ```

    ### Supported Web Data Sources

    The `web_data_feed` function supports retrieving structured data from:

    * LinkedIn (profiles and companies)
    * Amazon (products and reviews)
    * Instagram (profiles, posts, reels, comments)
    * Facebook (posts, marketplace listings, company reviews)
    * X/Twitter (posts)
    * Zillow (property listings)
    * Booking.com (hotel listings)
    * YouTube (videos)
    * ZoomInfo (company profiles)

    For more information, visit the [Bright Data documentation](/).
  </Accordion>
</AccordionGroup>

## How to Integrate Bright Data With LlamaIndex?

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Installation">
    Install the required packages:

    ```bash theme={null}
    pip install llama-index llama-index-core llama-index-tools-brightdata
    ```
  </Step>

  <Step title="Usage">
    Here's an example of how to use the BrightDataToolSpec with LlamaIndex:

    ```python theme={null}
    llm = OpenAI(model="gpt-4o", api_key="your-api-key")

    brightdata_tool = BrightDataToolSpec(api_key="your-api-key", zone="unlocker")

    tool_list = brightdata_tool.to_tool_list()

    for tool in tool_list:
        tool.original_description = tool.metadata.description
        tool.metadata.description = "Bright Data web scraping tool"

    agent = OpenAIAgent.from_tools(tools=tool_list, llm=llm)

    query = (
        "Find and summarize the latest news about AI from major tech news sites"
    )
    tool_descriptions = "\n\n".join(
        [
            f"Tool Name: {tool.metadata.name}\nTool Description: {tool.original_description}"
            for tool in tool_list
        ]
    )

    query_with_descriptions = f"{tool_descriptions}\n\nQuery: {query}"

    response = agent.chat(query_with_descriptions)
    print(response)
    ```
  </Step>
</Steps>


# How to set up Bright Data with Make.com
Source: https://docs.brightdata.com/integrations/make

Connect Bright Data (thousands of scrapers) to Make.com for no-code data workflows: trigger scrapers, deliver to Google Sheets, Notion or any HTTP webhook.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## What is Make.com?

[Make](https://www.make.com/en/integrations/brightdata) (formerly Integromat) is a visual automation platform that lets you connect various apps and services to create powerful workflows, without writing any code.

Bright Data's integration with Make enables seamless web data collection and processing. With this integration, you can automate tasks like scraping websites, retrieving datasets, and making API calls.

Bright Data offers the following six modules in Make:

1. **Run an Web Unlocker API** – Access and extract data from sites that block bots.
2. **Download a Snapshot Content** – Retrieve the full content of a previously captured dataset.
3. **Filter a Dataset** – Apply filters to datasets and generate refined snapshots.
4. **Get a Snapshot Metadata** – Fetch detailed metadata for a snapshot.
5. **Get a Snapshot Part** – Retrieve a specific section of a snapshot.
6. **Make an API Call** – Execute any authorized request to Bright Data’s API.

## Why Use Bright Data With Make.com?

Integrating Bright Data with [Make](https://www.make.com/en/integrations/brightdata) allows you to build sophisticated web data pipelines, without writing a single line of code.

You can visually design and automate workflows that connect Bright Data with over 2,000 other apps and services. For example, you can:

* Extract data from websites using **Web Unlocker API**.
* Download and store snapshot content.
* Apply filters to datasets dynamically.
* Retrieve snapshot metadata or specific parts.
* Trigger authorized Bright Data API calls.

These capabilities let you build end-to-end data flows that connect Bright Data with tools like Google Sheets, Airtable, Notion, Slack, or your internal systems.

## How to Integrate Bright Data With Make.com

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already.
  </Step>

  <Step title="Create a New Scenario">
    * Log in to your Make.com account.
    * Click **Create a new scenario** in the top-left corner.
    * Choose the **Build from scratch** option.
  </Step>

  <Step title="Add the Bright Data Module to the Scenario">
    * Click the **+** button to add a module.
    * Search for and select **Bright Data** from the list.
  </Step>

  <Step title="Configure the 'Run an Web Unlocker API' Module">
    * Select the **Run an Web Unlocker API** module.
    * Click **Create a connection**.
    * Enter a descriptive connection name.
    * Paste your Bright Data API key into the **API Token** field.
    * Set parameters such as `zone`, `url`, `format`, `method`, `country`, and `async`.
    * Click **Save**.
  </Step>

  <Step title="Wait for Task Completion">
    * Add a delay or use a scheduling mechanism to allow the Web Unlocker API task to finish before proceeding.
  </Step>

  <Step title="Download the Snapshot Content">
    * Add the **Download a Snapshot Content** module.
    * Configure it to fetch the results of the completed Web Unlocker API task.
  </Step>

  <Step title="Store Data in Google Sheets">
    * Add a **Google Sheets** module.
    * Use it to insert the extracted data into your spreadsheet.
  </Step>
</Steps>

This setup builds a no-code data extraction pipeline that automates the process of collecting and storing data, perfect for use cases like price monitoring or competitor tracking.


# How to set up Bright Data with Mastra
Source: https://docs.brightdata.com/integrations/mastra

Integrate Bright Data's SDK with Mastra to add web scraping and structured data extraction from 40+ platforms to your AI agents.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

The Bright Data SDK integration is now available in Mastra, bringing powerful web scraping and data extraction capabilities to AI agents. This integration enables structured data extraction from over 40 platforms, including Amazon, LinkedIn, and major search engines like Google, Bing, and Yandex.

Mastra agents can perform tasks like web scraping with anti-bot protection, running search queries, extracting Amazon product data, and collecting LinkedIn profiles-all with minimal setup. This makes it easy to build intelligent agents that can reason, act, and fetch real-time web data for research, automation, and competitive analysis.

## How to Integrate Bright Data With Mastra

<Steps>
  <Step title="Prerequisites">
    * Node.js
    * npm (latest version)
    * Bright Data API key
    * OpenAI API key (for GPT-4o-mini)
    * Bright Data zones will be auto-created if needed
  </Step>

  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
    * Enable SDK access for your API key
  </Step>

  <Step title="Obtain Your OpenAI API Key">
    * Go to [OpenAI Platform](https://platform.openai.com)
    * Navigate to the API keys section
    * Create a new API key
    * Ensure you have access to the GPT-4o-mini model
  </Step>

  <Step title="Create a New Mastra Project Using the Template">
    Create a new project using the Bright Data Mastra template:

    ```bash theme={null}
    npx create-mastra@latest --template brightdata-mastra-tools
    cd brightdata-mastra-tools
    npm install
    ```

    <Note>
      Alternatively, you can clone the repository directly:

      ```bash theme={null}
      git clone https://github.com/brightdata/brightdata-mastra-tools
      cd brightdata-mastra-tools
      npm install
      ```
    </Note>
  </Step>

  <Step title="Configure Environment Variables">
    Edit `.env` and add your API keys:

    ```env theme={null}
    OPENAI_API_KEY=your_openai_api_key_here
    BRIGHTDATA_API_KEY=your_brightdata_api_key_here
    ```
  </Step>

  <Step title="Start the Development Server">
    Run the Mastra development server with hot reloading:

    ```bash theme={null}
    npm run dev
    ```

    Your Bright Data-powered web agent is now ready to use!
  </Step>

  <Step title="Example Usage">
    The web agent comes pre-configured with four powerful tools. Here's how the agent works:

    ```typescript theme={null}
    import { Agent } from '@mastra/core/agent';
    import { Memory } from '@mastra/memory';
    import { LibSQLStore } from '@mastra/libsql';
    import { brightDataTools } from './tools/web-tools';

    const apiKey = process.env.BRIGHTDATA_API_KEY ?? '';
    const brightTools = brightDataTools({ apiKey });

    export const webAgent = new Agent({
      name: 'Web Agent',
      instructions: `
        You are a general-purpose web research assistant with Bright Data capabilities.
        
        Tool usage guidelines:
        - Start with the search tool to build context or surface credible sources.
        - Use the scrape tool to pull detailed content from specific pages.
        - Call the Amazon product tool for pricing, availability, or review summaries.
        - Fetch LinkedIn profile details when users need professional background information.
      `,
      model: 'openai/gpt-4o-mini',
      tools: {
        searchTool: brightTools.search!,
        scrapeTool: brightTools.scrape!,
        amazonProductTool: brightTools.amazonProduct!,
        linkedinCollectProfilesTool: brightTools.linkedinCollectProfiles!,
      },
      memory: new Memory({
        storage: new LibSQLStore({
          url: 'file:../mastra.db',
        }),
      }),
    });
    ```

    **Example queries you can ask the agent:**

    * "Search for the latest developments in quantum computing"
    * "Scrape the pricing information from example.com"
    * "Get details and reviews for this Amazon product: \[URL]"
    * "Collect LinkedIn profiles for executives at \[company name]"
  </Step>

  <Step title="Available Tools">
    The integration provides four powerful tools:

    **1. Search Tool**

    * Search across Google, Bing, or Yandex
    * Returns results in markdown or HTML format
    * Automatic anti-bot protection bypass
    * Supports localized results with country codes

    **2. Scrape Tool**

    * Extract website content in clean markdown format
    * Automatic CAPTCHA and bot detection bypass
    * Country-specific proxy support

    **3. Amazon Product Tool**

    * Get pricing, ratings, reviews, and specifications
    * Location-specific data with ZIP code support
    * Comprehensive product information

    **4. LinkedIn Collect Profiles Tool**

    * Fetch professional background, experience, and education
    * Batch processing for multiple profiles
    * Detailed skills and work history
  </Step>

  <Step title="Customizing Tools">
    You can selectively enable or disable tools:

    ```typescript theme={null}
    const brightTools = brightDataTools({
      apiKey: process.env.BRIGHTDATA_API_KEY!,
      excludeTools: ['linkedinCollectProfiles'] // Disable specific tools
    });
    ```
  </Step>
</Steps>

## How the project is structured

```text theme={null}
your-project/
├── src/
│   └── mastra/
│       ├── agents/
│       │   └── web-agent.ts           # Main AI agent
│       ├── tools/
│       │   └── web-tools.ts           # Bright Data SDK tools
│       └── index.ts                   # Mastra configuration
├── .env                               # Your API keys (do not commit)
├── .env.example                       # Environment template
├── package.json                       # Dependencies
└── tsconfig.json                      # TypeScript config
```

## Key Features

* **AI-Powered Intelligence**: Uses OpenAI GPT-4o-mini for intelligent reasoning
* **Bright Data SDK Integration**: Direct integration with Bright Data's web data tools
* **Multiple Data Sources**: Search engines, web scraping, Amazon, LinkedIn
* **Anti-Bot Protection**: Automatic CAPTCHA and bot detection bypass
* **Persistent Memory**: Maintains conversation history using LibSQL
* **TypeScript Support**: Fully typed for better development experience

## How to deploy to production

Build and start your production server:

```bash theme={null}
npm run build
npm run start
```

## Troubleshooting

**"Bright Data API key is required to initialize tools"**

* Ensure `.env` file exists with a valid `BRIGHTDATA_API_KEY`
* Verify the API key has SDK access permissions
* Check that the API key is not expired

**"OpenAI API key not found"**

* Verify `OPENAI_API_KEY` in `.env`
* Ensure the API key has access to GPT-4o-mini model
* Check your OpenAI account has available credits

**Tool initialization failures**

* The integration uses `autoCreateZones: true` to automatically create zones
* Check that the zones were created in your Bright Data account

## Where to learn more

* [Mastra Documentation](https://mastra.ai/en/docs)
* [Bright Data SDK Documentation](/api-reference/SDK-JS)
* [GitHub Repository](https://github.com/brightdata/brightdata-mastra-tools)


# How to set up Bright Data with n8n
Source: https://docs.brightdata.com/integrations/n8n

Connect Bright Data to n8n to build automated, no-code data workflows with native nodes for SERP, Web Unlocker and Web Scraper API in your self-hosted instance.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## What is n8n?

[n8n](https://n8n.io) is a powerful workflow automation tool that allows you to connect apps and APIs with ease using a visual interface. It supports custom logic, API integrations, and now, thanks to the community, Bright Data’s Web Unlocker API.

With the new [n8n-nodes-brightdata](https://www.npmjs.com/package/n8n-nodes-brightdata) node, you can automate your web scraping pipelines using Bright Data’s advanced proxy and CAPTCHA-solving infrastructure directly inside your n8n workflows.\
\
For advanced use cases, you can also integrate [**Bright Data MCP**](/products/mcp-server/overview) via custom HTTP request nodes to access structured data tools, browser automation, and real-time scraping capabilities.

## Why Use Bright Data With n8n?

Integrating Bright Data with n8n lets you create advanced, resilient web scrapers without writing code. Benefits include:

* Scrape websites without getting blocked
* Emulate real-user behavior with headers, IP rotation, and fingerprinting
* Bypass CAPTCHA automatically
* Run headless scraping jobs reliably
* Chain the data into any of n8n’s 350+ supported services (Google Sheets, Airtable, Notion, and more)

For teams without proxy infrastructure or those scraping premium/anti-bot domains, this integration is a game-changer.

## How to Integrate Bright Data With n8n

This is a sample n8n workflow that automates the process of collecting and delivering the "Deals of the Day" from MediaMarkt, specifically tailored to user preferences, and sends those deals via email.

<Frame>
  <img alt="n8n-workflow-sample" />
</Frame>

**Workflow Structure:**

1. Webhook Trigger (User Form Submission)
2. Bright Data (Data Scraping)
3. HTML Extract (Content Extraction)
4. OpenAI (Recommendation Generation)
5. Split Out (Deal Item Separation)
6. Document Generator (HTML Document Creation)
7. SMTP Email Send (Email Delivery)

<Steps>
  <Step title="Prerequisites">
    * [Bright Data API key](/api-reference/authentication#api-key): For scraping data from MediaMarkt.
    * **OpenAI API**: To generate the list of recommended deals using GPT-4o-mini.
    * **SMTP credentials**: For sending the email with the deals.
    * The following community nodes installed in your n8n instance:
      * `n8n-nodes-base.brightdata`
      * `n8n-nodes-base.documentGenerator`
  </Step>

  <Step title="Form Submission (Webhook)">
    This node will be the entry point of your workflow, triggered by a form submission.

    * Drag and drop a Webhook node onto your canvas.
    * Request body includes:
      * `email`: User's email
      * `categories`: Array of categories like `"phones"`, `"appliances"`

    **Webhook Settings**

    * HTTP Method: `POST`
    * Path: `recommend-deals`
  </Step>

  <Step title="Scrape Deals with Bright Data">
    This node will connect to Bright Data to scrape the MediaMarkt website.

    * Drag and drop a **Bright Data** community node onto your canvas and connect it to the Webhook node.
    * Set Service to `Web Unlocker API`
    * Use method `GET` with the following request settings:
      * URL: `https://www.mediamarkt.es/es/campaign/campanas-y-ofertas`
      * Zone: Your Bright Data zone
      * Country: The country of your choosing for example: `es` (Spain)
      * API Token: Your Bright Data API key
  </Step>

  <Step title="Extract HTML Content">
    This node will extract specific HTML content from the raw data returned by Bright Data.

    * Drag and drop an HTML Extract node onto your canvas and connect it to the Bright Data node.
    * Use a **Set** or **Function** node to extract `title` and `body` from the HTML.

    You can optionally use the **HTML Extract** node if parsing specific sections.
  </Step>

  <Step title="Generate Recommendations with OpenAI">
    This node will use GPT-4o-mini to process the extracted data and generate recommended deals.

    * Drag and drop an OpenAI node onto your canvas and connect it to the HTML Extract node.
    * Authentication:
      * Credential Type: Select "API Key".
      * API Key: Enter your OpenAI API Key.
      * Model: Select `gpt-4o-mini`.
      * Temperature: 0.7 (Adjust as needed)
    * Prompt it with:

    ```text theme={null}
    You are an AI assistant. Based on the following HTML content, extract and recommend the best deals related to the categories: {{ $json["categories"].join(", ") }}.

    Respond in JSON array with keys: name, description, price, link.

    Content: {{ $json["html"] }}
    ```
  </Step>

  <Step title="Split Recommendations">
    This node will split the JSON array of deals generated by OpenAI into individual items for further processing.

    * Drag and drop a Split Out node onto your canvas and connect it to the OpenAI node.
    * Use a **SplitOut** node to split the response from OpenAI (JSON array) into individual deals.

      **Split Type**: Items in an array\
      **Input Path**: `$.json.deals`
  </Step>

  <Step title="Create HTML Document">
    This node will create an HTML document from a template, populating it with the recommended deals.

    * Drag and drop a Document Generator community node onto your canvas and connect it to the Split Out node.

    **Input**

    * Title: "Your Personalized Deals from MediaMarkt"
    * Template: Custom HTML with deal cards (include name, description, price, and link)

    **Optional**

    * Loop over split items to render a card per deal
  </Step>

  <Step title="Send Email with Deals">
    This node will send the generated HTML document as an email to the user.

    * Drag and drop an SMTP Email Send node onto your canvas and connect it to the Document Generator node.

    **Settings**

    * To: `{{$json["email"]}}`
    * Subject: "🔥 Your Personalized MediaMarkt Deals"
    * Message: Embed the generated HTML document
  </Step>
</Steps>

<Note>
  * The Bright Data community node in n8n is designed specifically for integrating with the Web Unlocker API only
  * This node is not officially developed by Bright Data - it's a community contribution
  * For more information and community support, visit: [n8n Community Discussion](https://community.n8n.io/t/bright-data-community-node-for-scrapping-anything/92011)
</Note>


# How to set up Bright Data with NGINX
Source: https://docs.brightdata.com/integrations/nginx

Step-by-step guide to configuring NGINX with Bright Data proxies for upstream traffic routing, domain masking, and connection management. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is NGINX?

**NGINX** is a high-performance web server and reverse proxy used for load balancing, caching, and securing connections. By integrating NGINX with **Bright Data**, you can mask proxy domains, route traffic seamlessly, and optimize your infrastructure for better performance.

## How to Set Up Bright Data With NGINX

<Steps>
  <Step title="Install NGINX">
    1. Install **NGINX** on your server following the [official installation guide](https://nginx.org/en/download.html).
    2. Ensure you’re using version **1.15.10 or higher**.
    3. Verify that your server’s IP is **not** added to the Bright Data proxy allowlist to avoid conflicts.
  </Step>

  <Step title="Configure the NGINX Core Settings">
    1. Open the main NGINX configuration file:

    ```bash theme={null}
    sudo nano /etc/nginx/nginx.conf   
    ```

    2. Update the following parameters:
       * **Set `worker_processes`** to `auto` for dynamic optimization.
       * **Set `worker_connections`** to `200` (or more, depending on your required number of ports).

    3. At the end of the `http` section, add:

    ```nginx theme={null}
    include /etc/nginx/sites-enabled/*;
    ```

    4. Save the changes and exit the editor.
    5. Your updated `nginx.conf` should look like this:

    ```nginx theme={null}
    worker_processes  auto;
    user              www-data;

    error_log         /var/log/nginx/error.log info;
    events {
        worker_connections 200;
    }

    http {
        include         /etc/nginx/mime.types;
        access_log      /var/log/nginx/access.log combined;

        server {
            server_name   localhost;
            listen        127.0.0.1:80;
            error_page    500 502 503 504  /50x.html;
        }

        include /etc/nginx/sites-enabled/*;
    }
    ```
  </Step>

  <Step title="Create a Proxy Configuration File">
    1. Create the directory for custom configurations:

    ```bash theme={null}
    sudo mkdir -p /etc/nginx/sites-enabled
    ```

    2. Create a new configuration file:

    ```bash theme={null}
    sudo nano /etc/nginx/sites-enabled/brightdata.conf
    ```

    3. Add the following configuration to the file, adjusting the port range as needed:

    ```nginx theme={null}
    server {
        listen 24000-24100;
        location / {
            resolver 8.8.8.8;
            proxy_pass http://127.0.0.1:$server_port;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
    ```

    3. Save and close the file.
  </Step>

  <Step title="Restart NGINX">
    1. Apply the changes by restarting NGINX:

    ```bash theme={null}
    sudo service nginx restart
    ```
  </Step>

  <Step title="Test the Proxy Configuration">
    1. Verify the proxy connection with the following command, replacing `10.0.2.15` with your server's IP:

    ```bash theme={null}
    curl --proxy http://10.0.2.15:24000 "http://brdtest.com/myip.json" -v
    ```

    2. Confirm that the response includes the expected proxy IP and location.

       **Expected output:**

       ```json theme={null}
       {
         "ip": "43.252.31.41",
         "country": "US",
         "asn": {
           "asnum": 207990,
           "org_name": "HostRoyale Technologies Pvt Ltd"
         },
         "geo": {
           "city": "Chicago",
           "region": "IL",
           "region_name": "Illinois",
           "postal_code": "60602",
           "latitude": 41.8874,
           "longitude": -87.6318,
           "tz": "America/Chicago",
           "lum_city": "chicago",
           "lum_region": "il"
         }
       }
       ```
  </Step>

  <Step title="Restart NGINX">
    1. To ensure that traffic routes through NGINX, monitor your proxy manager logs.
    2. Confirm that the "sent from" IP matches your NGINX server’s IP address.
  </Step>
</Steps>

Your **Bright Data** are now successfully integrated with **NGINX**, providing secure, efficient traffic routing and domain masking. This setup is ideal for optimizing web scraping, load balancing, and secure proxy management. Enjoy streamlined operations!


# How to set up Bright Data with Octoparse
Source: https://docs.brightdata.com/integrations/octoparse

Configure Bright Data proxies (400M+ residential IPs) inside Octoparse to extract data from complex sites without IP blocks, with geo-targeted exits.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Octoparse?

Octoparse is a user-friendly web scraping tool that allows you to collect data from websites without needing any coding knowledge. With its simple point-and-click interface, Octoparse enables you to extract information from even the most complex sites. It offers the flexibility to customize, automate, and schedule scraping tasks, saving the extracted data in formats such as CSV or Excel. Perfect for market research, price tracking, or lead generation, Octoparse makes data collection fast, easy, and efficient!

## Octoparse Proxy Integration

Follow these simple steps to integrate Bright Data proxies with Octoparse:

<Steps>
  <Step title="Install Octoparse">
    Visit the [Octoparse website](https://www.octoparse.com/download) to download and install Octoparse.
  </Step>

  <Step title="Create a New Task">
    Click the **+New** button in the top-left corner, then select **Custom Task**.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Enter the Target URL">
    In the **URL Input** field, enter the URL of the website you wish to scrape, then click **Save**.
  </Step>

  <Step title="Access Proxy Settings">
    Once the page loads, navigate to **Task Settings > Anti-blocking**.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Enable Proxy Usage">
    Check **Access websites via proxies** and select **Use my own proxies**. Then click **Configure**.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    In the pop-up window, enter your Bright Data proxy details in the following format:

    ```sh theme={null}
    IP/host:port:username:password
    ```

    * **IP/host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
    * **Username**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.
    </Info>

    If you're using rotating proxies, set the **Switch interval** to specify how often the IPs should rotate. For sticky sessions, adjust it according to your preferred session length.

    <Frame>
      <img alt="Octoparse Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Save Your Settings">
    Click **Confirm** to apply the changes, then click **Save**.
  </Step>
</Steps>

And that's it! You've now successfully integrated Bright Data proxies with Octoparse.


# How to set up Bright Data with OpenBullet
Source: https://docs.brightdata.com/integrations/openbullet

Configure Bright Data proxies (port 44445) in OpenBullet to run HTTP automation and testing workflows with geo-targeted IPs and reduced detection risk.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is OpenBullet?

**OpenBullet** is an automation and testing framework used to manage HTTP requests, perform automated workflows, and validate responses at scale. It is commonly used for scraping, testing, and automation scenarios that require precise control over requests and proxy usage. When combined with Bright Data, OpenBullet gains improved anonymity, geo-targeting, and reduced detection risk.

***

## Why Use Bright Data With OpenBullet?

* **Enhanced Anonymity**: Mask your real IP address during automated workflows
* **Geo-Targeting**: Route traffic through specific countries or regions
* **Improved Stability**: Reduce connection errors and IP bans
* **Scalable Automation**: Safely handle large volumes of automated requests

***

## How to Set Up Bright Data With OpenBullet

Follow the steps below to integrate Bright Data proxies into OpenBullet.

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * An active Bright Data account
    * A configured Bright Data proxy zone (ISP or Datacenter recommended)
    * Your Bright Data proxy credentials (host, port, username, password)
    * OpenBullet installed on your system
  </Step>

  <Step title="Install OpenBullet">
    1. Visit the [OpenBullet GitHub page](https://github.com/openbullet/OpenBullet2) and download the latest release.
    2. Extract the downloaded archive.
    3. Launch the OpenBullet application on your system.
  </Step>

  <Step title="Create a Proxy Group">
    1. Open OpenBullet and navigate to the **Proxies** tab.
    2. Click **Add Group** to create a new proxy group.

    <Frame>
      <img alt="How to Set Up Bright Data With OpenBullet" />
    </Frame>

    3. Enter a descriptive name for the group (for example, `brightdata-dc`).
    4. Click **Accept** to save the group.

    <Frame>
      <img alt="How to Set Up Bright Data With OpenBullet" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    1. Select the proxy group you created.
    2. Click **Import** to open the proxy import panel.

    <Frame>
      <img alt="How to Set Up Bright Data With OpenBullet" />
    </Frame>

    3. In the **Import proxies** dialog:
       * Switch to the **Paste** tab.
       * Paste your proxy credentials using the format:\
         `HOST:PORT:USERNAME:PASSWORD`
       * Click **Accept** to import the proxies.

    <Note>
      To maintain a consistent IP, append a session parameter to the username\
      (for example, `your-username-session-1`).

      For geo-targeting, format the username as\
      `your-username-country-XX` (for example, `your-username-country-US`).
    </Note>
  </Step>

  <Step title="Validate Proxy Connectivity">
    1. Select the imported proxy group.
    2. Use OpenBullet’s built-in proxy checker to test connectivity.
    3. Confirm that proxies return valid responses before running automation jobs.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for long-running automation
* Assign separate proxy groups for different projects
* Avoid excessive parallel requests from a single proxy
* Rotate sessions periodically for high-volume workflows
* Monitor OpenBullet logs for proxy-related failures

***

## Conclusion

By integrating Bright Data with OpenBullet, you create a secure and scalable automation environment. This setup protects your identity, enables geo-specific workflows, and improves reliability across automated tasks. With Bright Data proxies configured, you can run OpenBullet workflows with confidence and consistency.


# Set up Bright Data with OpenClaw
Source: https://docs.brightdata.com/integrations/openclaw

Give your OpenClaw AI agent real-time web search, bot-bypass scraping, browser automation, and 50+ structured data tools powered by Bright Data.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

[OpenClaw](https://openclaw.ai/) is a self-hosted AI assistant gateway that connects messaging apps like WhatsApp, Telegram, Discord, and iMessage to AI coding agents. It features a plugin system that lets you extend your agent with new tools and capabilities.

The **Bright Data plugin for OpenClaw** brings the full power of Bright Data's web data infrastructure directly into your OpenClaw agent. Install once, and your agent gains:

* **Real-time web search** via Google, Bing, and Yandex with geo-targeting
* **Bot-bypass scraping** through Web Unlocker, which handles CAPTCHAs, JS rendering, and rate limits automatically
* **Full browser automation** via a real Chromium instance routed through Bright Data's residential proxy network
* **50+ structured data tools** for Amazon, LinkedIn, Instagram, TikTok, YouTube, Reddit, and more

<Note>
  The plugin registers **66 tools** across five categories: search, scrape, batch operations, browser automation, and structured web data.
</Note>

## Steps to Get Started

<Steps>
  <Step title="Prerequisites">
    * [OpenClaw](https://openclaw.ai/) installed and running
    * A [Bright Data account](https://brightdata.com) with an API key
    * Node.js 22+ (managed by OpenClaw)
  </Step>

  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Plugin">
    Install the plugin using the OpenClaw CLI:

    ```bash theme={null}
    openclaw plugins install @brightdata/brightdata-plugin
    ```

    Verify the installation:

    ```bash theme={null}
    openclaw plugins inspect brightdata
    ```

    You should see the plugin ID `brightdata` along with all registered tools.
  </Step>

  <Step title="Configure Your API Key">
    Choose one of the following methods to provide your Bright Data API key:

    <Tabs>
      <Tab title="Environment Variable (recommended for local dev)">
        ```bash theme={null}
        export BRIGHTDATA_API_TOKEN=your_token_here
        ```
      </Tab>

      <Tab title="OpenClaw Config (recommended for persistent setups)">
        ```bash theme={null}
        openclaw config set plugins.entries.brightdata.config.webSearch.apiKey your_token_here
        ```
      </Tab>
    </Tabs>

    <Tip>
      The plugin automatically creates two proxy zones on first use: `mcp_unlocker` (Web Unlocker) and `mcp_browser` (Browser API). No manual zone setup is required.
    </Tip>

    To use existing zones instead:

    ```bash theme={null}
    export BRIGHTDATA_UNLOCKER_ZONE=my_existing_zone
    export BRIGHTDATA_BROWSER_ZONE=my_existing_browser_zone
    ```
  </Step>

  <Step title="Enable the Plugin">
    Enable the plugin and restart the gateway:

    ```bash theme={null}
    openclaw plugins enable brightdata
    openclaw gateway restart
    ```

    <Note>
      If the plugin tools are not being exposed to your agent, you may need to explicitly allow plugin tools:

      ```bash theme={null}
      openclaw config set tools.alsoAllow '["group:plugins"]'
      ```
    </Note>
  </Step>

  <Step title="Start Using the Tools">
    Your OpenClaw agent now has access to all 66 Bright Data tools. Try these example prompts:

    ```text Search the web theme={null}
    Use the brightdata_search tool to search for "latest AI news" and return the top 5 results.
    ```

    ```text Scrape a webpage theme={null}
    Use the brightdata_scrape tool on https://example.com and summarize the page in 3 bullets.
    ```

    ```text Automate a browser theme={null}
    Use brightdata_browser_navigate to open https://example.com, then use brightdata_browser_get_text to return the visible page text.
    ```

    ```text Get structured data theme={null}
    Use brightdata_amazon_product to get details for https://www.amazon.com/dp/B0D2Q9397Y
    ```
  </Step>
</Steps>

## Available Tools

### How to search the web

| Tool | Description |
| - | - |
| `brightdata_search` | Search Google, Bing, or Yandex with geo-targeting. Returns structured results with pagination support. |
| `brightdata_search_batch` | Run up to 5 search queries in parallel. Partial failures are returned inline. |

**Parameters for `brightdata_search`:**

| Parameter | Type | Description |
| - | - | - |
| `query` | `string` | **Required.** Search query |
| `engine` | `"google"` \| `"bing"` \| `"yandex"` | Search engine (default: `google`) |
| `count` | `number` | Results to return, 1-10 |
| `cursor` | `string` | Pagination cursor for next page |
| `geo_location` | `string` | 2-letter ISO country code (e.g. `us`, `de`) |

### Scrape

| Tool | Description |
| - | - |
| `brightdata_scrape` | Fetch any page through Web Unlocker. Works on bot-protected sites, JS-rendered pages, and geo-restricted content. |
| `brightdata_scrape_batch` | Scrape up to 5 URLs in parallel with the same extraction options. |

**Parameters for `brightdata_scrape`:**

| Parameter | Type | Description |
| - | - | - |
| `url` | `string` | **Required.** HTTP/HTTPS URL to scrape |
| `extractMode` | `"markdown"` \| `"text"` \| `"html"` | Output format (default: `markdown`) |
| `maxChars` | `number` | Maximum characters to return (min: 100) |

### How to automate the browser

Full Chromium browser control routed through Bright Data's residential proxy network. Sessions idle-timeout after 10 minutes.

| Tool | Description |
| - | - |
| `brightdata_browser_navigate` | Navigate to a URL with optional country routing |
| `brightdata_browser_snapshot` | Capture an ARIA snapshot with interactive element refs |
| `brightdata_browser_click` | Click an element by its snapshot ref |
| `brightdata_browser_type` | Type into a field by ref (optional Enter to submit) |
| `brightdata_browser_fill_form` | Fill multiple form fields in a single operation |
| `brightdata_browser_screenshot` | Take a viewport or full-page screenshot |
| `brightdata_browser_get_html` | Get current page HTML |
| `brightdata_browser_get_text` | Get current page text content |
| `brightdata_browser_scroll` | Scroll to the bottom of the page |
| `brightdata_browser_scroll_to` | Scroll to a specific element by ref |
| `brightdata_browser_wait_for` | Wait for an element to become visible |
| `brightdata_browser_network_requests` | List network requests since page load |
| `brightdata_browser_go_back` | Navigate back |
| `brightdata_browser_go_forward` | Navigate forward |

### Structured Web Data (50+ Platforms)

Each tool accepts a `url` or `keyword` and returns clean, typed JSON. No scraping or parsing required.

<AccordionGroup>
  <Accordion title="E-commerce (10 tools)">
    | Tool | Data |
    | - | - |
    | `brightdata_amazon_product` | Product details, pricing, specs |
    | `brightdata_amazon_product_reviews` | Customer reviews and ratings |
    | `brightdata_amazon_product_search` | Search results with rankings |
    | `brightdata_walmart_product` | Product details and availability |
    | `brightdata_walmart_seller` | Seller profile and metrics |
    | `brightdata_ebay_product` | Listing details and bids |
    | `brightdata_homedepot_products` | Product catalog and pricing |
    | `brightdata_zara_products` | Fashion catalog data |
    | `brightdata_etsy_products` | Handmade and vintage listings |
    | `brightdata_bestbuy_products` | Electronics catalog and deals |
  </Accordion>

  <Accordion title="Professional Networks (7 tools)">
    | Tool | Data |
    | - | - |
    | `brightdata_linkedin_person_profile` | Full person profile |
    | `brightdata_linkedin_company_profile` | Company overview and stats |
    | `brightdata_linkedin_job_listings` | Open positions with details |
    | `brightdata_linkedin_posts` | Post content and engagement |
    | `brightdata_linkedin_people_search` | People search results |
    | `brightdata_crunchbase_company` | Funding, investors, founders |
    | `brightdata_zoominfo_company_profile` | Company intelligence data |
  </Accordion>

  <Accordion title="Social Media (17 tools)">
    **Instagram**

    | Tool | Data |
    | - | - |
    | `brightdata_instagram_profiles` | Profile stats and bio |
    | `brightdata_instagram_posts` | Post content and engagement |
    | `brightdata_instagram_reels` | Reel metadata and views |
    | `brightdata_instagram_comments` | Comment threads |

    **Facebook**

    | Tool | Data |
    | - | - |
    | `brightdata_facebook_posts` | Post content and reactions |
    | `brightdata_facebook_marketplace_listings` | Marketplace items |
    | `brightdata_facebook_company_reviews` | Page reviews and ratings |
    | `brightdata_facebook_events` | Event details and attendance |

    **TikTok**

    | Tool | Data |
    | - | - |
    | `brightdata_tiktok_profiles` | Creator profile and stats |
    | `brightdata_tiktok_posts` | Video content and metrics |
    | `brightdata_tiktok_shop` | TikTok Shop product data |
    | `brightdata_tiktok_comments` | Comment threads |

    **X (Twitter)**

    | Tool | Data |
    | - | - |
    | `brightdata_x_posts` | Post content and metrics |
    | `brightdata_x_profile_posts` | Profile post history |

    **YouTube & Reddit**

    | Tool | Data |
    | - | - |
    | `brightdata_youtube_profiles` | Channel stats and info |
    | `brightdata_youtube_videos` | Video details and metrics |
    | `brightdata_youtube_comments` | Comment threads |
    | `brightdata_reddit_posts` | Post content and scores |
  </Accordion>

  <Accordion title="Maps, Shopping & Apps (4 tools)">
    | Tool | Data |
    | - | - |
    | `brightdata_google_maps_reviews` | Location reviews and ratings |
    | `brightdata_google_shopping` | Shopping results and prices |
    | `brightdata_google_play_store` | App details and reviews |
    | `brightdata_apple_app_store` | App details and reviews |
  </Accordion>

  <Accordion title="Finance, News & Code (3 tools)">
    | Tool | Data |
    | - | - |
    | `brightdata_yahoo_finance_business` | Company financials and news |
    | `brightdata_github_repository_file` | Repository file contents |
  </Accordion>

  <Accordion title="Real Estate & Travel (2 tools)">
    | Tool | Data |
    | - | - |
    | `brightdata_zillow_properties_listing` | Property listings and estimates |
    | `brightdata_booking_hotel_listings` | Hotel listings and pricing |
  </Accordion>

  <Accordion title="AI Insights (3 tools)">
    | Tool | Data |
    | - | - |
    | `brightdata_chatgpt_ai_insights` | ChatGPT responses |
    | `brightdata_grok_ai_insights` | Grok responses |
    | `brightdata_perplexity_ai_insights` | Perplexity responses |
  </Accordion>
</AccordionGroup>

## Web Search Provider Integration

The plugin also registers as an OpenClaw **web search provider**. To set Bright Data as your default search provider:

```bash theme={null}
openclaw config set tools.web.search.provider brightdata
```

Once set, any generic web search your agent performs will route through Bright Data's search infrastructure.

## Which settings to configure

All settings can be provided via environment variable or OpenClaw config. Environment variables take priority.

| Setting | Environment Variable | OpenClaw Config Path | Default |
| - | - | - | - |
| API Key | `BRIGHTDATA_API_TOKEN` | `plugins.entries.brightdata.config.webSearch.apiKey` | **required** |
| Base URL | `BRIGHTDATA_BASE_URL` | `plugins.entries.brightdata.config.webSearch.baseUrl` | `https://api.brightdata.com` |
| Unlocker Zone | `BRIGHTDATA_UNLOCKER_ZONE` | `plugins.entries.brightdata.config.webSearch.unlockerZone` | `mcp_unlocker` |
| Browser Zone | `BRIGHTDATA_BROWSER_ZONE` | `plugins.entries.brightdata.config.webSearch.browserZone` | `mcp_browser` |
| Request Timeout | - | `plugins.entries.brightdata.config.webSearch.timeoutSeconds` | `30s` search / `60s` scrape |
| Polling Timeout | - | `plugins.entries.brightdata.config.webSearch.pollingTimeoutSeconds` | `600s` |

## How to manage the plugin

```bash theme={null}
# Verify installation and loaded tools
openclaw plugins inspect brightdata

# Update to latest version
openclaw plugins update brightdata

# Temporarily disable
openclaw plugins disable brightdata

# Re-enable
openclaw plugins enable brightdata

# Uninstall
openclaw plugins uninstall brightdata
```

## Troubleshooting

**Plugin not found after install**

* Run `openclaw plugins list` to verify the plugin is installed.
* Check that the plugin ID is `brightdata` with `openclaw plugins inspect brightdata`.
* Run `openclaw plugins doctor` for diagnostic information.

**Tools not registering**

* Ensure the plugin is enabled: `openclaw plugins enable brightdata`.
* Restart the gateway: `openclaw gateway restart`.

**Authentication errors**

* Verify your API key is set correctly via env var or config.
* Check that the token has not expired in your [Bright Data dashboard](https://brightdata.com/cp/setting/users).

**Zone creation failures**

* The plugin auto-creates `mcp_unlocker` and `mcp_browser` zones on first use.
* If auto-creation fails, create the zones manually in your Bright Data dashboard and set them via environment variables.

## Where to learn more

* [OpenClaw Documentation](https://docs.openclaw.ai)
* [OpenClaw Plugin CLI Reference](https://openclawlab.com/en/docs/products/cli/plugins/)
* [Bright Data API Documentation](/)
* [Plugin Source Code on GitHub](https://github.com/brightdata/openclaw-plugin)


# Deploy Bright Data + OpenClaw on Railway
Source: https://docs.brightdata.com/integrations/openclaw-railway

Deploy an OpenClaw AI agent preloaded with 66 Bright Data web tools on Railway in one click, with no CLI setup or manual plugin install.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

This guide shows you how to deploy an [OpenClaw](https://openclaw.ai/) AI agent with the official Bright Data plugin on Railway using a one-click template, so your agent gets 66 Bright Data web tools with no CLI setup and no manual plugin installation.

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/openclaw-bright-data)

The Railway template bundles the **Bright Data plugin for OpenClaw** pre-installed and pre-configured. On first boot, the container installs the plugin, registers all tools and generates a persistent gateway token, giving your agent real-time web search, bot-bypass scraping, browser automation and 50+ structured data tools across platforms like Amazon, LinkedIn and Instagram.

<Note>
  The plugin registers **66 tools** across five categories: search, scrape, batch operations, browser automation and structured web data.
</Note>

<Tip>
  Prefer to install the plugin yourself on an existing OpenClaw instance? Use the manual CLI install in [Set up Bright Data with OpenClaw](/integrations/openclaw).
</Tip>

## Prerequisites

* A [Bright Data account](https://brightdata.com) with an API key
* A [Railway account](https://railway.com) (free trial available)
* An AI provider API key: [OpenRouter](https://openrouter.ai/keys) (free), OpenAI, Anthropic or Gemini

<Note>
  OpenRouter is recommended. Its free Nemotron model provides the 262K context window required to handle the 66-tool plugin manifest without rate limit errors.
</Note>

## How to deploy the template on Railway

<Steps>
  <Step title="Get your Bright Data API key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Deploy on Railway">
    Click **Deploy on Railway**. Railway creates a new project from the template.

    <Warning>
      Add a **persistent volume mounted at `/data`** in your service settings before or immediately after deploying. Without it, the gateway cannot store its configuration.
    </Warning>
  </Step>

  <Step title="Set environment variables">
    Set the following variables in the Railway **Variables** tab:

    | Variable | Description | Required |
    | - | - | - |
    | `BRIGHTDATA_API_TOKEN` | Your Bright Data API key | **Required** |
    | `SETUP_PASSWORD` | Password for the `/setup` status page | **Required** |
    | `OPENROUTER_API_KEY` | Recommended AI provider | Recommended |
    | `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` / `GEMINI_API_KEY` | Alternative AI providers | Optional |
  </Step>

  <Step title="Wait for initialization">
    First boot takes three to five minutes. The container installs the plugin, registers all 66 tools and generates a persistent gateway token.
  </Step>

  <Step title="Open the setup page and copy the gateway token">
    Open `https://your-app.up.railway.app/setup`, enter your `SETUP_PASSWORD` and wait for status **DONE**. Copy the **gateway token**.
  </Step>

  <Step title="Connect the OpenClaw UI">
    Open the OpenClaw UI from the setup page and paste the gateway token. All 66 Bright Data tools are available immediately.
  </Step>
</Steps>

## Which Bright Data tools are included?

The plugin registers 66 tools across five categories: search, scrape, batch operations, browser automation and structured web data (Amazon, LinkedIn, Instagram, TikTok, YouTube, Reddit, Zillow and more).

For the full list of tools, parameters and example prompts, see the [tool reference on the OpenClaw integration page](/integrations/openclaw#available-tools).

## Troubleshooting

**Do I need to add a volume?**

Yes. Add a persistent volume mounted at `/data` before or immediately after deploying. Without it, the OpenClaw gateway cannot store its configuration and will not retain the gateway token across restarts.

**Why is OpenRouter recommended over other providers?**

The free Nemotron model on OpenRouter provides a 262K context window, which is required to handle the 66-tool plugin manifest without rate limit errors. OpenAI, Anthropic and Gemini also work if you set their API keys instead.

**The setup page is not showing my tools yet**

Wait for the `/setup` page to report status **DONE** before opening the OpenClaw UI. First boot takes three to five minutes while the container installs the plugin, registers all 66 tools and generates the gateway token.

## Additional resources

* [Set up Bright Data with OpenClaw](/integrations/openclaw): manual CLI install for an existing OpenClaw instance
* [AI integrations overview](/integrations/ai-integrations)
* [OpenClaw documentation](https://docs.openclaw.ai)
* [Template source code on GitHub](https://github.com/ReallyGreatTech/brightdata-railway)


# How to set up Bright Data with ParseHub
Source: https://docs.brightdata.com/integrations/parsehub

Integrate Bright Data proxies (400M+ IPs) with ParseHub for secure, anonymous web scraping access, reducing the risk of detection and IP bans at scale.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is ParseHub?

ParseHub stands out as a user-friendly, powerful web scraping tool that revolutionizes data extraction from the web. Its intuitive design allows users to effortlessly interact with complex sites, manage AJAX and JavaScript elements, and navigate through forms and infinite scrolls, all without writing a single line of code. By integrating Bright Data proxies with ParseHub, users gain an unmatched advantage, seamlessly handling even the most challenging data extraction tasks with ease. This combination ensures not only efficient data scraping but also a high level of privacy and security, making it an ideal solution for professionals seeking comprehensive data collection capabilities.

## Bright Data Proxies: Empowering Your ParseHub Experience

Integrating Bright Data [proxies](https://brightdata.com/proxy-types) with ParseHub transforms your web scraping capabilities, bringing a new level of efficiency and reliability to your data extraction tasks. Here’s why Bright Data’s proxy solutions are an ideal match for ParseHub’s powerful scraping features:

**Extensive Proxy Network**

* Global Reach: Access 400M+ monthly residential IPs across 195+ countries, ensuring you can scrape data from any geographic region.
* Diverse Proxy Types: Choose from residential, datacenter, static residential, and mobile proxies to fit the specific needs of your scraping projects.

**Enhanced Anonymity and Security**

* Robust Privacy: Protect your scraping activities from detection and blocking, maintaining the anonymity of your operations.
* Secure Data Collection: Confidently scrape sensitive data with the assurance of Bright Data’s advanced security measures.

**High Performance and Reliability**

* Speed and Efficiency: Experience fast and efficient data extraction, even from complex, JavaScript-heavy websites.
* Reliable Connectivity: Minimize disruptions and maintain consistent performance with Bright Data’s stable proxy infrastructure.

**Versatile and Scalable Solutions**

* Adaptable to Various Use Cases: Whether for market research, web scraping, SEO analysis, or competitive intelligence, Bright Data’s proxies are versatile enough to handle diverse scraping scenarios.
* Scalability: Effortlessly scale your scraping operations to handle large volumes of data without compromising on speed or accuracy.

**User-Friendly Integration**

* Simple Setup: Easily integrate Bright Data proxies with ParseHub, regardless of your technical expertise.
* Comprehensive Support: Benefit from Bright Data’s extensive documentation and customer support for a smooth integration process.

## How to integrate ParseHub proxies:

<Steps>
  <Step title="Sign up to Bright Data">
    1. After signing up, go to the Bright Data dashboard
    2. Navigate to the “**Proxy & Scraping Infrastructure**” section
    3. **Add** a new designated **Zone** for your proxy usage.

    <Frame>
      <img alt="ph-add-zone-2.png" />
    </Frame>
  </Step>

  <Step title="Select proxy type">
    In this example, we will show how to set up ISP proxies.

    <Frame>
      <img alt="ph-proxy-types.png" />
    </Frame>
  </Step>

  <Step title="Name proxy solution">
    <Frame>
      <img alt="ph-select-ip-type.png" />
    </Frame>
  </Step>

  <Step title="Select IP count">
    Fill in the number of IPs you need.

    <Frame>
      <img alt="ph-number-of-ips-1.png" />
    </Frame>
  </Step>

  <Step title="Country & city selection">
    Choose your desired country and city for the IP location.

    <Frame>
      <img alt="ph-city-ip.png" />
    </Frame>
  </Step>

  <Step title="Choose domain">
    Use specific domains or use ‘All domains’ for one IP to target websites using the same IP.

    <Frame>
      <img alt="ph-domains.png" />
    </Frame>
  </Step>

  <Step title="Add zone">
    Click the “**Add**” button to create the Zone.

    <Frame>
      <img alt="ph-click-add.png" />
    </Frame>
  </Step>

  <Step title="Access parameters">
    Click on the name of your Zone, navigate to the “Access Parameters” tab, and note down the proxy credentials:

    <Frame>
      <img alt="ph-access-parameters.png" />
    </Frame>

    1. host: brd.superproxy.io
    2. port: 44445
    3. username: `your-zone-username`
    4. password: `your-zone-password`
  </Step>

  <Step title="Download and Install ParseHub">
    <Frame>
      <img alt="ph-parsehub.png" />
    </Frame>

    * Visit the official website of ParseHub, download, and install the ParseHub application suitable for your operating system.
    * Launch ParseHub and either create a new account or log into your existing account.
  </Step>

  <Step title="Create a New Project">
    Click on the “+ New Project” button from the ParseHub home screen.

    <Frame>
      <img alt="ph-create-a-new-project.png" />
    </Frame>
  </Step>

  <Step title="Start a New Project with a URL">
    Insert a URL from which you wish to scrape data (for example, instagram.com) and press “Start project on this URL”.

    <Frame>
      <img alt="ph-start-new-project.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Proxy Configuration in ParseHub">
    Switch to the Browser mode, slider turns green to indicate browsing mode.

    <Frame>
      <img alt="ph-broswer-mode.png" />
    </Frame>
  </Step>

  <Step title="Settings">
    Open the settings located at the top-right side of the Browser interface and click on “options”.

    <Frame>
      <img alt="ph-open-settings.png" />
    </Frame>
  </Step>

  <Step title="Access Advanced Network Settings">
    Select the “Advanced” tab.

    <Frame>
      <img alt="ph-advanced-network-settings.png" />
    </Frame>
  </Step>

  <Step title="Click on the “Network” tab">
    Under “Connection” choose “Settings”.

    <Frame>
      <img alt="ph-connection-settings.png" />
    </Frame>
  </Step>

  <Step title="Configure Manual Proxy Settings">
    In the network settings, select “Manual proxy configuration”.

    <Frame>
      <img alt="ph-configure-manual-settings.png" />
    </Frame>
  </Step>

  <Step title="Proxy settings">
    Under HTTP Proxy field enter the Bright Data proxy URL **brd.superproxy.io** and port as **44445**.

    <Frame>
      <img alt="ph-proxy-and-port.png" />
    </Frame>
  </Step>

  <Step title="Switch to SOCKS v4 and click ok">
    After you switched to the SOCKS v4, click the ‘OK’ button.

    <Frame>
      <img alt="ph-switch-to-socks.png" />
    </Frame>
  </Step>

  <Step title="Proxy zone credentials">
    Insert your proxy zone’s credentials , they can be found on your proxy zone’s access parameters.

    <Frame>
      <img alt="ph-access-param-parsehub.png" />
    </Frame>
  </Step>

  <Step title="Format Proxy Configuration">
    * Format your proxy details as IPAddress:Port:Username:Password:Realm.
    * In case of Bright Data Proxies it will be:\
      `brd.superproxy.io:44445:brd-customer-hl_******-zone-isp_proxy6:b1s*****:BrightData`

    Apply Configured Proxy to ParseHub Project:

    * Navigate to your project settings in ParseHub.

    <Frame>
      <img alt="ph-project-settings.png" />
    </Frame>
  </Step>

  <Step title="Enable Custom Proxies">
    Check “Rotate IP Addresses” to enable the “Custom Proxy” text box.

    <Frame>
      <img alt="ph-custom-proxies.png" />
    </Frame>
  </Step>

  <Step title="Custom proxies field">
    Paste your formatted proxy into the “Custom Proxies” field. For multiple proxies, list each one on a separate line.

    <Frame>
      <img alt="ph-custom-proxies-field.png" />
    </Frame>
  </Step>

  <Step title="Save your project settings">
    After saving, run it with your Bright Data Proxies.

    <Frame>
      <img alt="ph-save-project.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, Web Unlocker API or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s).

  This is a simple process, see [this guide](/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# Set up Bright Data with PhantomBuster
Source: https://docs.brightdata.com/integrations/phantombuster

Step-by-step guide to configuring Bright Data proxies in PhantomBuster automations for safer, higher-success-rate data gathering workflows. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is PhantomBuster?

PhantomBuster is a cloud-based automation platform designed to handle repetitive online tasks at scale. It enables you to automate actions across social networks, websites, and online services without managing infrastructure or writing complex scripts. By combining PhantomBuster with Bright Data proxies, you gain higher reliability, improved anonymity, and better protection against blocks.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. Bright Data proxies rotate IPs by default.\
  [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

***

## How to Integrate Bright Data With PhantomBuster

Integrating Bright Data proxies into PhantomBuster helps you maintain anonymity, reduce the risk of blocks, and improve automation stability. Follow the steps below to complete the setup.

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * An active PhantomBuster account
    * An active Bright Data account
    * A configured Bright Data proxy zone (ISP or Data Center recommended)
    * Your Bright Data proxy credentials (host, port, username, password)
  </Step>

  <Step title="Open the Proxies Settings">
    Log in to your [PhantomBuster account](https://phantombuster.com/) and navigate to **Settings → Proxies**.\
    This section allows you to manage proxy pools used by your Phantoms.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Create a New Proxy Pool">
    Click **New proxy pool** to create a dedicated pool for Bright Data proxies.\
    Using separate proxy pools for different projects helps isolate workflows and reduce detection risk.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Name Your Proxy Pool">
    Assign a clear and descriptive name to your proxy pool (for example, `brightdata-isp-eu`).\
    This makes it easier to identify and reuse the pool across multiple Phantoms.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    Enter your Bright Data proxy credentials using the following format:

    `host:port:username:password`

    You can find these details in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).

    After entering the credentials, click **Add proxy** to save them to the pool.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Configure Advanced Phantom Settings">
    Open the Phantom you want to run and expand the **Advanced settings** section.\
    This is where you define network and execution behavior for your workflow.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Apply the Proxy Pool">
    In **Advanced settings**, select the Bright Data proxy pool you created.\
    Click **Save settings** to apply the configuration.

    From this point forward, the Phantom will route all traffic through Bright Data proxies.

    <Frame>
      <img alt="How to Integrate Bright Data With PhantomBuster" />
    </Frame>
  </Step>

  <Step title="Run and Monitor Your Phantom">
    Start your Phantom and monitor execution logs.\
    If you encounter blocks or slowdowns:

    * Reduce execution frequency
    * Use session-based usernames for IP consistency
    * Assign dedicated proxies to sensitive accounts
  </Step>
</Steps>

***

## Best Practices

* Use one proxy pool per platform or account type
* Avoid running too many Phantoms concurrently from the same pool
* Prefer ISP proxies for logged-in or session-based workflows
* Monitor Phantom execution logs for proxy-related errors
* Rotate sessions periodically for long-running workflows

***

## Conclusion

Your Bright Data proxies are now fully integrated with PhantomBuster. This setup enables more reliable automation, stronger anonymity, and reduced block rates across your workflows. With the technical foundation in place, you can focus on scaling outreach, data collection, and growth initiatives with confidence.


# How to set up Bright Data with Pica
Source: https://docs.brightdata.com/integrations/pica

Integrate Bright Data with Pica to give AI agent workflows reliable, anonymous web access and scalable data collection from the public web. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

[Pica](https://www.picaos.com/) is a platform designed to enhance AI agent workflows by providing reliable, anonymous, and scalable web access for real-world data automation. Integrating Pica with Bright Data allows AI agents to leverage Bright Data's advanced web scraping and proxy network capabilities, enabling them to collect and process data from the web efficiently and effectively.

## Available Bright Data Tools

Bright Data offers the following tools for integration with Pica:

* **Scrapers**: Automate web data extraction with Bright Data's powerful Scrapers.
* **Web Unlocker API**: Access and retrieve data from websites that employ advanced anti-bot measures.

## How to Integrate Bright Data With Pica

<Steps>
  <Step title="Obtain Your Bright Data API Key">
    * Log in to your [Bright Data dashboard](https://brightdata.com/cp).
    * Go to [Account Settings](https://brightdata.com/cp/setting/users).
    * [Generate an API key](/api-reference/authentication#how-do-i-authenticate-with-api-key%3F) if you haven't already done so.
  </Step>

  <Step title="Install the Bright Data Integration">
    Install the Bright Data integration package for Pica by running the following command:

    ```sh theme={null}
    pip install pica-langchain
    ```

    <Note>
      Other available integrations include:

      * [Vercel AI SDK](https://docs.picaos.com/sdk/vercel-ai)
      * [MCP](https://docs.picaos.com/sdk/mcp)
    </Note>
  </Step>

  <Step title="Select your preferred Bright Data tool">
    [Pica connectors](https://www.picaos.com/community/connectors) for Bright Data include two main tools for integration:

    <CodeGroup>
      ```python Scrapers endpoint using Pica With LangChain theme={null}
      import os
      from langchain_openai import ChatOpenAI
      from langchain.agents import AgentType
      from pica_langchain import PicaClient, create_pica_agent
      from pica_langchain.models import PicaClientOptions

      def main():
        try:
            pica_client = PicaClient(
                secret=os.environ["PICA_SECRET"],
                options=PicaClientOptions(
                    connectors=["test::bright-data::default::fd583f2344fa414293bdda4f240258c1"] # Initialize all available connections or pass specific connector keys
                )
            )

            pica_client.initialize()
            
            llm = ChatOpenAI(
                temperature=0,
                model="gpt-4o",
            )

            # Create an agent with Pica tools
            agent = create_pica_agent(
                client=pica_client,
                llm=llm,
                agent_type=AgentType.OPENAI_FUNCTIONS,
            )

            # Execute a multi-step workflow using the GitHub Connector
            result = agent.invoke({
                "input": (
                    "Trigger Synchronous Web Scraping and Retrieve Results, use this dataset ID : gd_l7q7dkf244hwjntr0 and search for this URL : https://www.amazon.com/dp/B0D2Q9397Y?th=1&psc=1"
                )
            })
            
            print(f"\nWorkflow Result:\n {result}")
        
        except Exception as e:
            print(f"ERROR: An unexpected error occurred: {e}")


      if __name__ == "__main__":
        main()

      ```

      ```python Web Unlocker API through Pica & LangChain theme={null}
      import os
      from langchain_openai import ChatOpenAI
      from langchain.agents import AgentType
      from pica_langchain import PicaClient, create_pica_agent
      from pica_langchain.models import PicaClientOptions

      def main():
        try:
            pica_client = PicaClient(
                secret=os.environ["PICA_SECRET"],
                options=PicaClientOptions(
                    connectors=["test::bright-data::default::fd583f2344fa414293bdda4f240258c1"] # Initialize all available connections or pass specific connector keys
                )
            )

            pica_client.initialize()
            
            llm = ChatOpenAI(
                temperature=0,
                model="gpt-4o",
            )

            # Create an agent with Pica tools
            agent = create_pica_agent(
                client=pica_client,
                llm=llm,
                agent_type=AgentType.OPENAI_FUNCTIONS,
            )

            # Execute a multi-step workflow using the GitHub Connector
            result = agent.invoke({
                "input": (
                    "Unlock this site and provide me with the data : https://www.amazon.com/dp/B0D2Q9397Y?th=1&psc=1"
                )
            })
            
            print(f"\nWorkflow Result:\n {result}")
        
        except Exception as e:
            print(f"ERROR: An unexpected error occurred: {e}")


      if __name__ == "__main__":
        main()
      ```
    </CodeGroup>
  </Step>
</Steps>


# How to set up Bright Data with Playwright
Source: https://docs.brightdata.com/integrations/playwright

Configure Bright Data proxies (port 44445) in Playwright to route automated browser tests and scraping jobs through residential, datacenter or mobile IPs.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is Playwright?

Playwright is a versatile Node.js toolkit for automating popular browsers in one go. Whether you’re scraping data, testing applications, or building seamless automation flows, Playwright’s unified interface and robust features help you get more done in less time, without compromising quality.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

## How to Integrate Bright Data With Playwright

### Prerequisites

1. **Node.js**: Download and install the latest version from [nodejs.org](https://nodejs.org/).

2. **Playwright Package**: Add Playwright to your project:

3. **Bright Data Account**: You must have an active Bright Data account with at least one enabled proxy zone.\
   For browser automation use cases, **ISP or Data Center proxies are recommended** for better stability.

4. **Proxy Access Permissions**: Ensure your IP is allowlisted in the Bright Data dashboard (if IP whitelisting is enabled) and that your proxy zone is active.

5. **Supported Operating System**: Playwright is supported on the following operating systems:

   * macOS
   * Linux
   * Windows

   Make sure your system meets Playwright’s browser runtime requirements.

6. **Basic JavaScript Knowledge**: Familiarity with JavaScript, Node.js, and `async/await` syntax is recommended to correctly configure and manage Playwright scripts.

7. **Network Stability**: A stable internet connection is required to download browser binaries and maintain proxy connections during automation tasks.

```bash theme={null}
npm install playwright
```

### Get Your Bright Data Credentials

Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans) and note the following details:

* **Host**: [http://brd.superproxy.io/](http://brd.superproxy.io/)
* **Port**: `44445`
* **Username**: Enter your Bright Data `username`.
* **Password**: Enter your Bright Data `password`.

You’ll need these for proxy authentication.

### Configure Playwright to Use Bright Data

<Note>
  If you want to use Playwright with Bright Data's Browser API, please refer to the [Browser API documentation](/products/scraping-browser/introduction) for correct setup and code examples. Proxy Integration guides below are for direct proxy integration, not for Browser API.
</Note>

1. **Set the Proxy Server**: Include your Bright Data host and port in the browser launch options. Use the format `host:port`.
2. **Add Authentication**: Provide your Bright Data **username** and **password** to ensure secure access.

### Ignoring SSL Errors

If you get SSL errors working our residential proxies or Web Unlocker API set: `ignoreHTTPSErrors: True` in your JS code. Alternatively - you can setup our certificate on your system or import it into your code. More access information can be found [here](/integrations/playwright#expand-to-get-your-bright-data-proxy-access-information).

### Example Code

```javascript theme={null}
import { chromium } from 'playwright';

// Bright Data proxy configuration
const BRIGHTDATA_HOST = process.env.BRIGHTDATA_HOST || 'brd.superproxy.io';
const BRIGHTDATA_PORT = process.env.BRIGHTDATA_PORT || '44445';
const BRIGHTDATA_USERNAME = process.env.BRIGHTDATA_USERNAME;
const BRIGHTDATA_PASSWORD = process.env.BRIGHTDATA_PASSWORD;

// Optional: use session to keep the same IP
const SESSION_ID = 'session_1';

(async () => {
  const browser = await chromium.launch({
    headless: true, // set to false for debugging
    proxy: {
      server: `http://${BRIGHTDATA_HOST}:${BRIGHTDATA_PORT}`,
      username: `${BRIGHTDATA_USERNAME}-session-${SESSION_ID}`,
      password: BRIGHTDATA_PASSWORD,
    },
  });

  const context = await browser.newContext({
    ignoreHTTPSErrors: true, // prevents SSL issues with residential / Unlocker proxies
  });

  const page = await context.newPage();

  // Verify proxy connection
  await page.goto('https://brdtest.com/myip.json', {
    waitUntil: 'networkidle',
    timeout: 60000,
  });

  const ipInfo = await page.textContent('pre');
  console.log('Proxy IP info:', ipInfo);

  // Navigate to target website
  await page.goto('https://example.com', {
    waitUntil: 'domcontentloaded',
  });

  console.log('Page title:', await page.title());

  // Optional screenshot for validation
  await page.screenshot({ path: 'playwright-brightdata.png' });

  await browser.close();
})();
```

With **Bright Data** integrated into **Playwright**, your automation is both secure and discreet. Enjoy faster workflows, reduced detection risks, and greater peace of mind as you scrape, test, and automate online tasks.


# How to set up Bright Data with Puppeteer
Source: https://docs.brightdata.com/integrations/puppeteer

Configure Bright Data proxies (port 44445) in Puppeteer to run headless Chrome with geo-targeted IPs for web scraping and automated testing in Node.js.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is Puppeteer?

Think of Puppeteer as a remote control for headless browsers. With just a few lines of Node.js code, you can direct browsers to gather information, run tests, and automate routine actions. It’s all about turning tough, time-consuming workflows into quick, manageable steps.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

## How to Integrate Bright Data With Puppeteer

### How to get started

Before integrating Bright Data, ensure you have the essentials:

1. **Node.js**: Install the latest version from [nodejs.org](https://nodejs.org/).

2. **Project Setup**: Use a code editor you prefer (such as VS Code) and initialize a Node.js project.

3. **Bright Data Account**: You must have an active Bright Data account with at least one enabled proxy zone.\
   For browser automation use cases, **ISP or Data Center proxies are recommended** for better stability.

4. **Basic JavaScript Knowledge**: Familiarity with JavaScript, Node.js, and `async/await` syntax is recommended to correctly configure and manage Playwright scripts.

5. **Network Stability**: A stable internet connection is required to download browser binaries and maintain proxy connections during automation tasks.

6. **Puppeteer**: Add Puppeteer to your project by running:

```bash theme={null}
npm install puppeteer
```

### Retrieve Your Bright Data Credentials

Sign in to your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans) and note down your proxy details:

• **Host**

• **Port**

• **Username**

• **Password**

These credentials will let Puppeteer route traffic through Bright Data’s secure, anonymous proxy network.

### Configure Puppeteer for Bright Data

<Note>
  If you want to use Puppeteer with Bright Data's Browser API, please refer to the [Browser API documentation](/products/scraping-browser/introduction) for correct setup and code examples. Proxy Integration guides below are for direct proxy integration, not for Browser API.
</Note>

To connect Puppeteer with Bright Data:

1. **Set the Proxy Server**: Add `--proxy-server=[HOST]:[PORT]` to Puppeteer’s launch arguments.

2. **Authenticate**: Use `page.authenticate()` in Puppeteer to provide your Bright Data **username** and **password**.

### Example Code

Here’s a sample script to guide you:

```javascript theme={null}
const puppeteer = require('puppeteer');

const BRIGHTDATA_HOST = process.env.BRIGHTDATA_HOST || 'brd.superproxy.io';
const BRIGHTDATA_PORT = process.env.BRIGHTDATA_PORT || '44445';
const BRIGHTDATA_USERNAME = process.env.BRIGHTDATA_USERNAME;
const BRIGHTDATA_PASSWORD = process.env.BRIGHTDATA_PASSWORD;

// Optional: use a session to maintain the same IP
const SESSION_ID = 'session_1';

(async () => {
  const browser = await puppeteer.launch({
    headless: true, // set to false for debugging
    args: [
      `--proxy-server=http://${BRIGHTDATA_HOST}:${BRIGHTDATA_PORT}`
    ]
  });

  const page = await browser.newPage();

  // Authenticate with Bright Data
  await page.authenticate({
    username: `${BRIGHTDATA_USERNAME}-session-${SESSION_ID}`,
    password: BRIGHTDATA_PASSWORD,
  });

  // Verify proxy connection
  await page.goto('https://brdtest.com/myip.json', {
    waitUntil: 'networkidle2',
    timeout: 60000,
  });

  const ipInfo = await page.evaluate(() => document.body.innerText);
  console.log('Proxy IP info:', ipInfo);

  // Navigate to target website
  await page.goto('https://example.com', {
    waitUntil: 'domcontentloaded',
  });

  console.log('Page title:', await page.title());

  // Optional screenshot for verification
  await page.screenshot({ path: 'puppeteer-brightdata.png' });

  await browser.close();
})();
```

With Bright Data proxies integrated into Puppeteer, you gain secure and private browsing for all your automated tasks. Enjoy smoother data collection, reduced detection risks, and a more reliable workflow, so you can focus on insights and results, not on technical roadblocks.


# How to set up Bright Data with SaleFreaks
Source: https://docs.brightdata.com/integrations/salefreaks

Integrate Bright Data proxies (400M+ IPs) with SaleFreaks to manage dropshipping automation securely, protect seller accounts and reduce IP-related risks.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is SaleFreaks?

SaleFreaks is an automation platform built for dropshippers to manage online stores more efficiently. It helps automate key workflows such as product sourcing, order fulfillment, and inventory synchronization. SaleFreaks commonly integrates with marketplaces like eBay and Amazon, where stable IP usage is critical to avoid account flags or suspensions.

Using Bright Data proxies with SaleFreaks improves account safety, enables geo-targeted operations, and ensures long-term automation stability.

***

## Why Use Bright Data With SaleFreaks?

* **Account Protection**: Reduce the risk of marketplace bans by using dedicated, consistent IPs
* **Geo-Targeting**: Operate seller accounts from specific countries or cities
* **High Stability**: Dedicated datacenter or ISP proxies ensure uninterrupted automation
* **Scalability**: Manage multiple seller accounts with isolated proxy identities

***

## Steps to Integrate SaleFreaks With Bright Data Proxies

### Step 1. Sign Up to Bright Data

1. Log in to your Bright Data dashboard
2. Navigate to **Proxy & Scraping Infrastructure**
3. Click **Add** to create a new proxy **Zone**

<Frame>
  <img alt="add-zone-2.png" />
</Frame>

***

### Step 2. Select Proxy Type

For SaleFreaks, **Datacenter or ISP proxies** are recommended for maximum account stability.

<Frame>
  <img alt="Step 2. Select Proxy Type" />
</Frame>

***

### Step 3. Name the Proxy Zone

Choose a clear name for your proxy zone (for example, `salefreaks-ebay-us`).

<Frame>
  <img alt="select-ip-type.png" />
</Frame>

***

### Step 4. Select IP Count

Specify the number of IPs required.\
Best practice: **one IP per seller account**.

<Frame>
  <img alt="number-of-ips-1.png" />
</Frame>

***

### Step 5. Country & City Selection

Select the country and city that best match your marketplace region.

<Frame>
  <img alt="city-ip.png" />
</Frame>

***

### Step 6. Add the Zone

Click **Add** to create and activate the proxy zone.

<Frame>
  <img alt="click-add.png" />
</Frame>

***

### Step 7. Zone Is Ready

Click on the zone name to view configuration details.\
You can edit settings or add more proxies from the **Configuration** page.

<Frame>
  <img alt="zone-ready.png" />
</Frame>

***

### Step 8. Add a New Proxy Password

Navigate to **Access parameters** and click **Add password** to generate a new proxy password.

<Frame>
  <img alt="adding-new-pass.png" />
</Frame>

***

### Step 9. Open the Configuration Page

After adding a password, go back to the configuration page to manage IP access.

<Frame>
  <img alt="proxy-config.png" />
</Frame>

***

### Step 10. Review Allocated IPs

Click **Show allocated IPs** to view your assigned IP addresses.

<Frame>
  <img alt="allocated-ips.png" />
</Frame>

***

### Step 11. Download the IP List

Download the allocated IPs list for use in SaleFreaks.

<Frame>
  <img alt="download-ips.png" />
</Frame>

<Tip>
  If you added a new password, wait a few minutes before downloading the IP list to allow the password to sync correctly.
</Tip>

***

### Step 12. Open the IP File

Open the downloaded file in a text editor of your choice.

<Frame>
  <img alt="file-editor.png" />
</Frame>

***

### Step 13. Review Required Proxy Fields

Use the following values when configuring SaleFreaks:

* **Proxy Type**: `HTTP`
* **Proxy IP / Host**: `brd.superproxy.io`
* **Proxy Port**: `44445`
* **Proxy Username**:\
  `lum-customer-{your_customer_id}-zone-{your_zone}-ip-{allocated_ip}`
* **Proxy Password**:\
  Your generated proxy password

<Frame>
  <img alt="requried-fileds.png" />
</Frame>

***

### Step 14. Log In to SaleFreaks

Log in to your SaleFreaks account.\
When prompted to add a marketplace account, choose **Provide my own proxy**.

<Frame>
  <img alt="salefreaks-logins.png" />
</Frame>

***

### Step 15. Enter Proxy Details in SaleFreaks

Paste the proxy details from the Bright Data IP file into the SaleFreaks proxy fields.

<Frame>
  <img alt="fill-in-info.png" />
</Frame>

***

### Step 16. Enable Auto-Recharge (Recommended)

To avoid losing access to allocated IPs, enable **auto-recharge** in your Bright Data billing settings.

<Frame>
  <img alt="autorecharge.png" />
</Frame>

***

<Warning>
  **Important Note**

  If you are using Bright Data **Residential Proxies**, **Web Unlocker API**, or **SERP API**, you must install an SSL certificate to enable secure connections.

  Follow the instructions in this guide to complete the setup:\
  [https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate](https://docs.brightdata.com/general/account/ssl-certificate#installation-of-the-ssl-certificate)
</Warning>

***

## Best Practices

* Use **one dedicated IP per seller account**
* Avoid reusing IPs across multiple marketplaces
* Monitor SaleFreaks logs for proxy-related errors
* Use ISP or Datacenter proxies for long-term account safety
* Keep auto-recharge enabled to prevent service interruptions

***

## Conclusion

By integrating Bright Data proxies with SaleFreaks, you create a stable and secure automation environment for dropshipping operations. This setup protects seller accounts, enables geo-specific workflows, and ensures reliable performance across sourcing, fulfillment, and inventory management, allowing you to scale your business with confidence.


# Scraping tools integrations
Source: https://docs.brightdata.com/integrations/scraping-tools-integrations

Use Bright Data proxies with web scraping frameworks like Scrapy, BeautifulSoup, Puppeteer, Playwright and Selenium for reliable, unblocked data collection.

<CardGroup>
  <Card title="Scrapy" icon="spider" href="/integrations/scrapy">
    Configure Bright Data residential or datacenter proxies in Scrapy spiders.
  </Card>

  <Card title="BeautifulSoup" icon="code" href="/integrations/beautifulsoup">
    Use Bright Data proxies with Python's BeautifulSoup parsing library.
  </Card>

  <Card title="Octoparse" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/octoparse1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=43b9c31bb400f0658336d40237f8aae9" href="/integrations/octoparse">
    Add Bright Data proxy support to Octoparse no-code scraping workflows.
  </Card>

  <Card title="ParseHub" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/ph-parsehub.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=26a4e7b84f81389e54365fa7e41dac44" href="/integrations/parsehub">
    Route ParseHub scraping jobs through Bright Data proxies.
  </Card>

  <Card title="Screaming Frog" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/screamingfrog1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=4bccd791fd603f359db168b51a52ab66" href="/integrations/screaming-frog">
    Configure Bright Data proxies in Screaming Frog SEO Spider.
  </Card>

  <Card title="WebHarvy" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/webharvy_int1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=62db6315e7b913f1caf09b96a107686a" href="/integrations/webharvy">
    Use Bright Data proxies with WebHarvy visual scraping software.
  </Card>

  <Card title="Web Scraper" icon="https://mintcdn.com/brightdata/z2V3XghEDR2bikNt/images/integrations/webscraperio_integration1.png?fit=max&auto=format&n=z2V3XghEDR2bikNt&q=85&s=de5da1bd48181bf07c429be1194de8b3" href="/integrations/webscraper">
    Connect the Web Scraper Chrome extension to Bright Data proxies.
  </Card>

  <Card title="Helium Scraper" icon="https://mintcdn.com/brightdata/pq7wn7mJJj8UJsym/images/integrations/helium-scraper1.png?fit=max&auto=format&n=pq7wn7mJJj8UJsym&q=85&s=1a4776cc1bac43a22bc25ab504f39dcf" href="/integrations/helium-scraper">
    Configure Bright Data proxies in Helium Scraper desktop app.
  </Card>

  <Card title="ChangeDetection" icon="bell" href="/integrations/changedetection">
    Monitor web page changes through Bright Data proxies with ChangeDetection.io.
  </Card>
</CardGroup>


# How to use Bright Data with Scrapy
Source: https://docs.brightdata.com/integrations/scrapy

Configure Bright Data proxies (port 44445) in Scrapy projects to crawl sites with geo-targeted, rotating IPs in anonymous, large-scale Python pipelines.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Scrapy?

Scrapy is a powerful Python-based framework for web scraping and data extraction. Designed for speed and scalability, Scrapy helps developers crawl websites and collect structured data efficiently. By integrating Bright Data proxies into Scrapy, you can enhance your scraping tasks with secure, anonymous, and geo-targeted connections.

## Why Use Bright Data with Scrapy?

* **Enhanced Privacy**: Mask your IP to stay anonymous while scraping.

* **Geo-Targeted Data Access**: Use Bright Data’s country-specific proxies to gather data from different regions.

* **Improved Reliability**: Reduce the risk of detection or being blocked by distributing requests across Bright Data proxies.

## How to Set Up and Start a Scrapy Project

**Step 0. Prerequisites**

Before you begin, ensure you have:

1. **Python Installed**:

   * Download and install the latest version from [python.org](https://www.python.org/).

2. **Scrapy Installed**: Run the following command in your terminal to install Scrapy:

   ```bash theme={null}
   pip install scrapy
   ```

3. **Bright Data Proxy Credentials**:

   * Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans) and retrieve your proxy details (Host, Port, Username, and Password).
   * For region-specific proxies, modify your username using the format `your-username-country-XX` (e.g., `your-username-country-US` for a US proxy).

**Step 1. Create or Open Your Scrapy Project**

1. If you don’t have a Scrapy project, create one by running:

   ```bash theme={null}
   scrapy startproject myproject
   ```

   Replace "myproject" with a name that reflects the purpose of your project, such as "brightdata\_test" or "web\_scraper".

2. Navigate to your project folder:

   ```bash theme={null}
   cd myproject
   ```

**Step 2. Generate a Spider**

1. Use Scrapy’s command to create a spider:

   ```bash theme={null}
   scrapy genspider <spider_name> <target_url>
   ```

   For example, to scrape [httpbin.org/ip](http://httpbin.org/ip), you can run:

   ```bash theme={null}
   scrapy genspider BrightDataExample http://httpbin.org/ip
   ```

2. This generates a basic spider template located in the `spiders/` directory of your project. It looks something like this:

   ```python theme={null}
   import scrapy

   class BrightDataExampleSpider(scrapy.Spider):
   name = "BrightDataExample"
   allowed_domains = ["httpbin.org/ip"]
   start_urls = ["http://httpbin.org/ip"]

   def parse(self, response):
       pass
   ```

**Step 3. Configure Bright Data Proxies**

1. Open the generated spider file in a text editor (`spiders/BrightDataExample.py`) and update it to include Bright Data proxy settings. Here’s an example:

   ```python theme={null}
   import scrapy

   class BrightDataExampleSpider(scrapy.Spider):
       name = "BrightDataExample"
       start_urls = ['http://httpbin.org/ip']

       def start_requests(self):
           # Define the Bright Data proxy
           proxy = "http://[USERNAME]:[PASSWORD]@[HOST]:[PORT]"  # Replace with your Bright Data proxy details

           # Use the proxy for all requests
           for url in self.start_urls:
               yield scrapy.Request(url, meta={'proxy': proxy})

       def parse(self, response):
           # Parse and return the IP address
           yield {
               'proxy_ip': response.text
           }
   ```

2. Replace \[USERNAME], \[PASSWORD], \[HOST], and \[PORT] with your Bright Data credentials. If you need a country-specific proxy, modify the username (e.g., `your-username-country-US`).

**Step 4. Run Your Scrapy Spider**

1. Navigate to the project directory in your terminal:

   ```bash theme={null}
   cd myproject
   ```

2. Run the spider:

   ```bash theme={null}
   scrapy crawl BrightDataExample
   ```

3. To save the output to a file, use:

   ```bash theme={null}
   scrapy crawl BrightDataExample -o output.json
   ```

**Step 5. Verify the Output**

1. If everything is configured correctly, the spider will display the IP address of the Bright Data proxy it’s using. Example output:

   ```json theme={null}
   [
       {
           "proxy_ip": "{\n  \"origin\": \"123.45.67.89\"\n}"
       }
   ]
   ```

2. Open the output.json file (if you used the -o flag) to review the scraped data.

With **Bright Data** proxies integrated into **Scrapy**, your web scraping tasks become more secure, private, and efficient. Whether you’re collecting geo-specific data, managing high-volume scraping jobs, or avoiding detection, Bright Data provides the stability and anonymity you need. Start scraping smarter with Bright Data and Scrapy today!


# Set up Bright Data with Screaming Frog
Source: https://docs.brightdata.com/integrations/screaming-frog

Configure Bright Data proxies in Screaming Frog SEO Spider to route crawls through residential, datacenter, ISP, or mobile IPs at scale. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Screaming Frog?

**Screaming Frog SEO Spider** is a versatile tool for SEO professionals and website managers. It helps audit websites, identify technical issues, and optimize performance by generating actionable insights. Combining Screaming Frog with **Bright Data** allows you to conduct secure, unrestricted, and geo-specific crawls, ensuring seamless SEO analysis.

## How to Set Up Bright Data With Screaming Frog

**Step 1. Download and Install Screaming Frog**

1. Visit the official [Screaming Frog website](https://www.screamingfrog.co.uk/seo-spider/).
2. Download and install the SEO Spider tool compatible with your operating system.
3. Launch the application once the installation is complete.

**Step 2. Access Proxy Settings**

1. In Screaming Frog, click on **File** in the top menu.
2. Select **Settings > Proxy** to open the proxy configuration window.

<Frame>
  <img alt="How to Set Up Bright Data With Screaming Frog" />
</Frame>

**Step 3. Enter Your Bright Data Proxy Details**

1. In the **Proxy** window, check **Use Proxy Server** to enable proxy usage.
2. If required, check **Use Proxy Credentials** and provide your login details.
3. Fill in the required proxy fields as follows:
   * **Address**: Input `http://brd.superproxy.io/`.
   * **Port**: Enter the port number found in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
   * **Username**: Provide your Bright Data username.
   * **Password**: Enter your Bright Data password.
4. Once all details are entered, click **OK and Restart** to save your proxy settings.

<Note>
  For geo-specific proxies, append the country code to your username (e.g., `your-username-country-US`) to use a specific exit location.
</Note>

Your Bright Data proxies are now integrated with Screaming Frog, enabling more secure and efficient web crawling. With this setup, you can bypass restrictions, avoid IP blocks, and conduct geo-specific audits to enhance your SEO tasks effortlessly.


# How to use Selenium with Bright Data
Source: https://docs.brightdata.com/integrations/selenium

Configure Bright Data proxies (port 44445) in Selenium Python to run browser automation with geo-targeted IPs across Chrome, Firefox and other webdrivers.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is Selenium?

Selenium is a powerful, open-source tool for automating web browsers. It supports multiple programming languages, including JavaScript, Python, and Java, and provides a robust API for controlling browser actions.

Selenium is widely used for:

* Web scraping
* Automated testing
* Browser-based workflows

With its flexibility and cross-browser compatibility, Selenium is an essential tool for developers and testers alike.

<Tip>
  Maintain a consistent IP throughout your browser session by using the <code>-session</code> parameter in your username.\
  This is essential because Bright Data proxies rotate IPs by default.

  Learn more:\
  [https://docs.brightdata.com/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session](https://docs.brightdata.com/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  <br />

  <br />

  New users should begin with **ISP** or **Datacenter** proxies, which need no KYC.\
  Residential proxies require a KYC-verified business account:
  [https://docs.brightdata.com/products/residential/network-access](https://docs.brightdata.com/products/residential/network-access)
</Tip>

## How to Integrate Bright Data with Selenium

### Step 0: Prerequisites

Before starting, ensure you have the following:

1. **Python installed**\
   Download the latest version from [https://www.python.org/](https://www.python.org/)

2. **Install Selenium**
   ```bash theme={null}
   pip install selenium
   ```

3. **Bright Data proxy credentials**\
   Get your host, port, username, and password from the [Bright Data Control Panel](https://brightdata.com/cp/zones/page/plans)

4. **WebDriver installed**\
   Download the appropriate driver for your browser\
   Example (Chrome): [https://developer.chrome.com/docs/chromedriver/](https://developer.chrome.com/docs/chromedriver/)

5. **Optional: WebDriver Manager**\
   For easier driver setup:
   ```bash theme={null}
   pip install webdriver-manager
   ```

<Note>
  If you want to use Selenium with Bright Data's **Browser API**, refer to the official documentation: [https://docs.brightdata.com/products/scraping-browser/introduction](https://docs.brightdata.com/products/scraping-browser/introduction)

  The steps below apply to direct proxy integration, not Browser API usage.
</Note>

### Step 1: Import Required Libraries

```python theme={null}
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
from webdriver_manager.chrome import ChromeDriverManager
```

### Step 2: Configure Your Bright Data Proxy

```python theme={null}
# Bright Data Proxy Configuration
proxy_host = "brd.superproxy.io"
proxy_port = "port"          # Replace with your port
proxy_username = "username"  # Replace with your Bright Data username
proxy_password = "password"  # Replace with your Bright Data password
 
# Full proxy URL
proxy = f"http://{proxy_username}:{proxy_password}@{proxy_host}:{proxy_port}"
```

### Step 3: Set Up Chrome Options

```python theme={null}
chrome_options = Options()
chrome_options.add_argument(f"--proxy-server={proxy}")
```

### Step 4: Initialize the WebDriver

```python theme={null}
service = Service(ChromeDriverManager().install())
driver = webdriver.Chrome(service=service, options=chrome_options)
```

### Step 5: Test the Proxy Connection

```python theme={null}
print("Connecting to target website...")
driver.get("http://httpbin.org/ip")
 
print("Page content:")
print(driver.page_source)
 
driver.quit()
```

### Step 6: Verify the Output

If the proxy is working correctly, you'll see an IP address similar to:

```json theme={null}
{
  "origin": "123.45.67.89"
}
```

## Summary

By integrating Bright Data proxies with Selenium, you can automate browser workflows securely and efficiently.

This setup is ideal for:

* Testing web applications
* Scraping dynamic content
* Accessing geo-restricted websites

Bright Data ensures reliability, anonymity, and scalability, helping you build smarter automation workflows with Selenium.


# Set up Bright Data with StablerSOLO
Source: https://docs.brightdata.com/integrations/stablersolo

Configure Bright Data proxies (400M+ IPs) inside StablerSOLO antidetect profiles to run sneaker and ecommerce automation with geo-targeted residential IPs.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is StablerSOLO?

**StablerSOLO** is a low-code data extraction and web scraping platform that allows developers, analysts, and data teams to configure and run scrapers without writing custom code for every target. It simplifies large-scale data collection while maintaining flexibility for advanced scraping needs.

When combined with Bright Data proxies, StablerSOLO delivers higher success rates, stronger anonymity, and reliable access to geo-restricted content.

***

## Why Use Bright Data With StablerSOLO?

* **Enhanced Anonymity**: Protect your real IP address during scraping operations
* **Geo-Targeted Access**: Collect region-specific data using country- or city-level proxies
* **Higher Success Rates**: Reduce blocks and CAPTCHAs with premium proxy IPs
* **Scalable Extraction**: Run large-scale scraping tasks reliably

***

## How to Integrate Bright Data With StablerSOLO

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * An active StablerSOLO account
    * An active Bright Data account
    * A configured Bright Data proxy zone (ISP or Datacenter recommended)
    * Your Bright Data proxy credentials (host, port, username, password)
  </Step>

  <Step title="Access StablerSOLO Proxy Configuration">
    1. Log in to your [StablerSOLO account](https://stabler.tech/).
    2. From the main dashboard, scroll down to the **Recent Proxies** section.
    3. Click **New Proxy** to open the proxy configuration window.

    <Frame>
      <img alt="How to Integrate Bright Data With StablerSOLO" />
    </Frame>
  </Step>

  <Step title="Add Bright Data Proxy Details">
    1. In the proxy configuration window:
       * Switch to the **Proxies List** tab.
       * Enter your Bright Data proxy credentials in the following format:

    Example:

    2. Click **Test a Proxy Randomly** to verify connectivity.
    3. Once the test succeeds, click **Add New Proxy** to save the proxy.

    <Note>
      To maintain a consistent IP, append a session parameter to your username\
      (for example, `username-session-1`).

      For geo-targeted scraping, format the username as\
      `username-country-XX` (for example, `username-country-US`).
    </Note>
  </Step>

  <Step title="Apply the Proxy to Scraping Jobs">
    1. Select the newly added proxy when configuring your scraping tasks.
    2. Run a small test extraction to confirm successful data retrieval.
    3. Monitor execution logs for stability and performance.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for long-running scraping jobs
* Assign separate proxies for different target websites or regions
* Avoid excessive parallel requests from a single proxy
* Rotate sessions periodically for large-scale extraction
* Monitor StablerSOLO logs for proxy-related errors

***

## Conclusion

By integrating Bright Data with StablerSOLO, you create a secure, scalable, and geo-flexible data extraction setup. This integration improves scraping success rates, minimizes detection risks, and enables reliable data collection across regions and platforms. With your proxy configuration complete, you’re ready to scale your data workflows with confidence.


# Set up Bright Data with Strands Agents
Source: https://docs.brightdata.com/integrations/strands

Use Bright Data with Strands Agents to add reliable web scraping and proxy capabilities to open-source Python AI agent workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Strands Agents is an open-source Python library that provides a unified toolkit for developing autonomous AI agents. It bridges the gap between large language models and practical applications by offering ready-to-use tools for file operations, system execution, API interactions, mathematical operations, and more.

## Steps to Get Started

<Steps>
  <Step title="Prerequisites">
    * Bright Data API Key
    * Python 3.10+
  </Step>

  <Step title="Installation">
    Set up the strands-agents-tools package by either using the quick pip install or the full development installation with virtual environment and pre-commit hooks.

    ```bash Quick Install theme={null}
    pip install strands-agents-tools
    ```
  </Step>

  <Step title="Set the environment variable">
    Set your Bright Data API key and unlocker zone as an environment variables:

    ```bash theme={null}
    export BRIGHT_DATA_API_KEY="your_api_key_here"
    export BRIGHT_DATA_ZONE="your_unlocker_zone_here"
    ```
  </Step>

  <Step title="Bright Data Usage Examples">
    <Tabs>
      <Tab title="Using bright data tools within an agent">
        <CodeGroup>
          ```py Sample Code theme={null}
          from strands import Agent
          from strands.models.litellm import LiteLLMModel
          import strands_tools.bright_data as bright_data
          import os
          from dotenv import load_dotenv


          load_dotenv()


          def main():
          load_dotenv()
          print("🔍 Testing Bright Data Tool with OpenAI GPT-4o via LiteLLM")
          print("=" * 50)

          # Configure OpenAI model via LiteLLM
          openai_model = LiteLLMModel(
              client_args={
                  "api_key": os.getenv("OPENAI_API_KEY"), 
              },
              model_id="openai/gpt-4o",
          )

          # Create agent with LiteLLM model and bright_data tool
          agent = Agent(
              model=openai_model,
              tools=[bright_data],
              system_prompt="you are a helpful Web Search assistant, whenever user asks you to search the web you will use avilable tools, always set zone name to 'unlocker'"
          )

          # Test the bright_data tool with a relevant query
          print("Testing web scraping...")
          result = agent("Please scrape the content from https://example.com and return it as markdown")
          print(f'\n\nScraping Result:\n{result}')

          print("\n" + "=" * 50)
          print("Testing web search...")
          result2 = agent("Please search Google for 'Python programming tutorials")
          print(f'\n\nSearch Result:\n{result2}')


          if __name__ == "__main__":
          main()
          ```

          ```md Sample Output theme={null}
          🔍 Testing Bright Data Tool with OpenAI GPT-4o via LiteLLM
          =================================================
          Testing web scraping...

          Tool #1: bright_data  
          [Bright Data] Request: https://example.com/  
          Here is the scraped content from [example.com](https://example.com/) in Markdown format:

          # Example Domain

          This domain is for use in illustrative examples in documents. You may use this domain in literature without prior coordination or asking for permission.

          [More information...](https://www.iana.org/domains/example)

          Scraping Result:  
          Here is the scraped content from [example.com](https://example.com/) in Markdown format:

          # Example Domain

          This domain is for use in illustrative examples in documents. You may use this domain in literature without prior coordination or asking for permission.

          [More information...](https://www.iana.org/domains/example)

          ==================================================
          Testing web search...

          Tool #2: bright_data  
          [Bright Data] Request: https://www.google.com/search?q=Python%20programming%20tutorials&num=10

          Here are some search results for "Python programming tutorials" from Google:
          1. **The Python Tutorial | Python documentation** - This is an official tutorial from the Python documentation introducing basic concepts and features of the Python language. [Link to tutorial](https://docs.python.org/3/tutorial/index.html).
          2. **Python Tutorial | W3Schools** - A popular platform to learn Python, covering everything from basic syntax to more advanced topics. Start learning Python now. [Link to W3Schools Python](https://www.w3schools.com/python/).
          3. **Python Full Course for Beginners | YouTube by Programming with Mosh** - A comprehensive YouTube tutorial to learn Python from scratch. [Watch on YouTube](https://www.youtube.com/watch?v=K5KVEU3aaeQ).
          4. **Python For Beginners | Python.org** - Contains a list of tutorials suitable for experienced programmers on the BeginnersGuide/Tutorials page. [Getting started with Python](https://www.python.org/about/gettingstarted/).
          5. **Learn Python - Free Interactive Python Tutorial** - An interactive coding environment provided by DataCamp to learn Python with hands-on challenges. [Explore LearnPython.org](https://www.learnpython.org).
          6. **Python Tutorial | TutorialsPoint** - Offers a complete understanding of Python programming language from basic concepts to more advanced. [Read more on TutorialsPoint](https://www.tutorialspoint.com/python/index.htm).
          7. **Python Tutorial | GeeksforGeeks** - Provides the latest Python 3.13 version compiler and tutorials, where you can edit and compile code directly. [Visit GeeksforGeeks Python Tutorial](https://www.geeksforgeeks.org/python/python-programming-language-tutorial/).

          These resources should help you get started with Python programming or deepen your existing knowledge.
          ```
        </CodeGroup>
      </Tab>

      <Tab title="Direct tool invocation">
        ```py theme={null}
        from strands import Agent
        from strands.models.litellm import LiteLLMModel
        import strands_tools.bright_data as bright_data
        import os
        from dotenv import load_dotenv


        load_dotenv()


        def main():
          load_dotenv()
          print("🔍 Testing Bright Data Tool with OpenAI GPT-4o via LiteLLM")
          print("=" * 50)
          
          # Configure OpenAI model via LiteLLM
          openai_model = LiteLLMModel(
              client_args={
                  "api_key": os.getenv("OPENAI_API_KEY"), 
              },
              model_id="openai/gpt-4o",
          )
          
          # Create agent with LiteLLM model and bright_data tool
          agent = Agent(
              model=openai_model,
              tools=[bright_data],
              system_prompt="you are a helpful Web Search assistant, whenever user asks you to search the web you will use avilable tools, always set zone name to 'unblocker'"
          )
          
          # Test the bright_data tool with a relevant query
          print("Testing web scraping...")
          result = agent.tool.bright_data(
          action="scrape_as_markdown",
          url="https://example.com",
          zone="unblocker"
        )
          print(f'\n\nScraping Result:\n{result}')
          
          print("\n" + "=" * 50)
          print("Testing web search...")
          result2 = agent.tool.bright_data(
          action="search_engine",
          query="Python programming tutorials",
          engine="google",
          zone="unblocker"
          )
          print(f'\n\nSearch Result:\n{result2}')


          result5 = agent.tool.bright_data(
              action="web_data_feed",
              source_type="amazon_product",
              url="https://www.amazon.com/dp/B0D2Q9397Y?th=1"
          )
          print(f'\n\nAmazon Product Data:\n{result5}')


        if __name__ == "__main__":
          main()
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>


# How to set up Bright Data with TexAu
Source: https://docs.brightdata.com/integrations/texau

Configure Bright Data proxies (400M+ IPs) in TexAu to scale social outreach and lead-gen automations with geo-targeted IPs and reduced ban risk.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## What is TexAu?

TexAu is a growth automation platform designed to help marketers and businesses scale lead generation, outreach, and online engagement. It automates actions across social networks and websites, allowing you to run workflows efficiently without manual intervention. When combined with Bright Data proxies, TexAu provides improved anonymity, geo-targeting capabilities, and reduced risk of IP bans.

<Tip>
  Maintain a consistent IP throughout your automation session by using the `-session` parameter in your username. Bright Data proxies rotate IPs by default.\
  [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

***

## Why Use Bright Data With TexAu?

* **Enhanced Privacy**: Hide your real IP address while running automation tasks.
* **Geo-Targeted Access**: Collect location-specific data using country- or city-level proxies.
* **Improved Stability**: Reduce blocks and interruptions during long-running workflows.
* **Account Safety**: Isolate accounts with dedicated IPs to minimize risk.

***

## How to Integrate Bright Data With TexAu

Follow the steps below to configure Bright Data proxies in TexAu.

### Prerequisites

Before you begin, ensure you have:

* An active TexAu account
* An active Bright Data account
* A configured Bright Data proxy zone (ISP or Data Center recommended)
* Your Bright Data proxy credentials (host, port, username, password)

***

### Step 1. Log In to TexAu

1. Visit the [TexAu website](https://texau.com/) and sign in to your account.
2. From the dashboard, access your automation workspace.

***

### Step 2. Open Proxy Configuration Settings

1. From the dashboard, navigate to **Preferences** in the left-hand menu.
2. Select the **Proxies** tab.
3. Click **New Proxy** to add a new proxy configuration.

<Frame>
  <img alt="Step 2. Open Proxy Configuration Settings" />
</Frame>

***

### Step 3. Add Your Bright Data Proxy Details

Fill in the proxy details using the information from your Bright Data dashboard:

* **Host**: `brd.superproxy.io`
* **Port**: Use the port assigned to your proxy zone
* **Username**: Your Bright Data username\
  *(Optionally append `-session-<id>` to maintain a consistent IP)*
* **Password**: Your Bright Data password

After entering the details, click **Test Proxy** to verify the connection.

<Note>
  If you are using geo-targeted proxies, format your username as\
  `your-username-country-XX` (for example, `your-username-country-US`)\
  to target a specific country.
</Note>

***

### Step 4. Save and Apply the Proxy

Once the proxy test is successful:

1. Click **Save** to store the proxy configuration.
2. Assign the proxy to your automation workflows or accounts as needed.

TexAu will now route all automation traffic through Bright Data proxies.

***

## Best Practices

* Use one proxy per account for account-based automation
* Avoid running too many automations concurrently on the same proxy
* Start with low execution limits and scale gradually
* Monitor TexAu logs for proxy-related errors
* Rotate sessions periodically for long-running workflows

***

## Conclusion

By integrating Bright Data with TexAu, you gain a secure, reliable, and scalable automation setup. This combination helps protect your identity, access geo-specific data, and maintain stable performance across all your growth and engagement workflows. With the technical setup complete, you can focus on driving results with confidence.


# Set up Bright Data with Vercel AI SDK
Source: https://docs.brightdata.com/integrations/vercel-ai-sdk

How to integrate Bright Data's web scraping and proxy capabilities with Vercel AI SDK to add real-time web data access to AI applications. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$50K value).
</Card>

Vercel AI SDK is a TypeScript toolkit for building AI applications with React, Next.js, Vue, Svelte, Node.js, and more. It provides a unified API for working with different AI providers and includes utilities for streaming, function calling, and building conversational interfaces.

The `@brightdata/ai-sdk` package gives you drop-in tools for web scraping, search, and structured dataset collection, no manual wiring required.

## Steps to Get Started

<Steps>
  <Step title="Prerequisites">
    * Bright Data API Key, get yours from the [Bright Data Dashboard](https://brightdata.com/cp)
    * Node.js 18+
    * TypeScript (recommended)
  </Step>

  <Step title="Installation">
    Install the Bright Data AI SDK package alongside the Vercel AI SDK:

    ```bash theme={null} theme={null}
    npm install @brightdata/ai-sdk ai zod
    ```

    Set your API key as an environment variable:

    ```bash .env.local theme={null} theme={null}
    BRIGHTDATA_API_KEY=your_api_key_here
    ```
  </Step>

  <Step title="Import and Use">
    Import the tools you need directly from `@brightdata/ai-sdk` and pass them to any Vercel AI SDK call.
    No additional setup files or wrappers needed, each tool is a factory function that reads your API key
    automatically from `BRIGHTDATA_API_KEY`.

    ```typescript theme={null} theme={null}
    import { scrape, search, amazon_product, linkedin_profile } from '@brightdata/ai-sdk'
    import { generateText, stepCountIs } from 'ai'
    import { openai } from '@ai-sdk/openai'

    const { text } = await generateText({
      model: openai('gpt-4o'),
      prompt: 'Scrape https://news.ycombinator.com and summarize the top 5 stories',
      tools: {
        scrape: scrape(),
      },
      stopWhen: stepCountIs(5),
    })

    console.log(text)
    ```
  </Step>

  <Step title="Usage Examples">
    <Tabs>
      <Tab title="Next.js App Router">
        Create an API route that uses Bright Data tools with any AI provider:

        ```typescript app/api/chat/route.ts theme={null} theme={null}
        import { openai } from '@ai-sdk/openai'
        import { streamText, stepCountIs } from 'ai'
        import { scrape, search } from '@brightdata/ai-sdk'

        export const maxDuration = 60

        export async function POST(req: Request) {
          const { messages } = await req.json()

          const result = streamText({
            model: openai('gpt-4o'),
            messages,
            tools: {
              scrape: scrape(),
              search: search(),
            },
            stopWhen: stepCountIs(10),
          })

          return result.toDataStreamResponse()
        }
        ```

        Then use it in your component:

        ```typescript app/page.tsx theme={null} theme={null}
        'use client'

        import { useChat } from 'ai/react'

        export default function Chat() {
          const { messages, input, handleInputChange, handleSubmit } = useChat()

          return (
            <div className="flex flex-col h-screen">
              <div className="flex-1 overflow-y-auto p-4">
                {messages.map((m) => (
                  <div key={m.id} className="mb-4">
                    <strong>{m.role === 'user' ? 'You: ' : 'AI: '}</strong>
                    {m.content}
                  </div>
                ))}
              </div>
              <form onSubmit={handleSubmit} className="p-4 border-t">
                <input
                  value={input}
                  onChange={handleInputChange}
                  placeholder="Try: 'Scrape https://example.com' or 'Search for best laptops 2025'"
                  className="w-full p-2 border rounded"
                />
              </form>
            </div>
          )
        }
        ```
      </Tab>

      <Tab title="Node.js Script">
        ```typescript script.ts theme={null} theme={null}
        import { anthropic } from '@ai-sdk/anthropic'
        import { generateText, stepCountIs } from 'ai'
        import { scrape, search, amazon_product } from '@brightdata/ai-sdk'

        async function main() {
          // Example 1: Scrape a website
          console.log('=== Example 1: Web Scraping ===')
          const scrapeResult = await generateText({
            model: anthropic('claude-opus-4-6'),
            tools: { scrape: scrape() },
            stopWhen: stepCountIs(10),
            prompt: 'Scrape https://news.ycombinator.com and summarize the top 5 stories',
          })
          console.log(scrapeResult.text)

          // Example 2: Web search
          console.log('\n=== Example 2: Web Search ===')
          const searchResult = await generateText({
            model: anthropic('claude-opus-4-6'),
            tools: { search: search() },
            stopWhen: stepCountIs(10),
            prompt: 'Search for the latest JavaScript frameworks and tell me about the top 3',
          })
          console.log(searchResult.text)

          // Example 3: Amazon product research
          console.log('\n=== Example 3: Amazon Product ===')
          const amazonResult = await generateText({
            model: anthropic('claude-opus-4-6'),
            tools: { amazon_product: amazon_product() },
            stopWhen: stepCountIs(10),
            prompt: "Get details about this product: https://www.amazon.com/dp/B0D2Q9397Y and tell me if it's worth buying",
          })
          console.log(amazonResult.text)
        }

        main()
        ```
      </Tab>

      <Tab title="Custom API Key">
        Pass the API key directly to any tool instead of relying on the environment variable:

        ```typescript theme={null} theme={null}
        import { scrape, search } from '@brightdata/ai-sdk'
        import { generateText, stepCountIs } from 'ai'
        import { openai } from '@ai-sdk/openai'

        const { text } = await generateText({
          model: openai('gpt-4o'),
          prompt: 'Search for AI news today',
          tools: {
            scrape: scrape({ api_key: 'your-api-key-here' }),
            search: search({ api_key: 'your-api-key-here' }),
          },
          stopWhen: stepCountIs(5),
        })
        ```
      </Tab>

      <Tab title="Social & Dataset Tools">
        Use the structured dataset tools for LinkedIn, Instagram, Facebook, and more:

        ```typescript theme={null} theme={null}
        import { linkedin_profile, linkedin_jobs, instagram_profile, facebook_profile } from '@brightdata/ai-sdk'
        import { generateText, stepCountIs } from 'ai'
        import { openai } from '@ai-sdk/openai'

        const { text } = await generateText({
          model: openai('gpt-4o'),
          prompt: 'Find AI engineering jobs in San Francisco on LinkedIn',
          tools: {
            linkedin_profile: linkedin_profile(),
            linkedin_jobs: linkedin_jobs(),
            instagram_profile: instagram_profile(),
            facebook_profile: facebook_profile(),
          },
          stopWhen: stepCountIs(10),
        })
        ```
      </Tab>
    </Tabs>
  </Step>
</Steps>

## Available Tools

All tools are factory functions, call them with an optional config object (or no arguments at all to use env defaults):

| Tool | Import | Description |
| - | - | - |
| `scrape()` | `import { scrape } from '@brightdata/ai-sdk'` | Scrape any website and return clean markdown. Bypasses anti-bot protection and CAPTCHAs. |
| `search()` | `import { search } from '@brightdata/ai-sdk'` | Search Google, Bing, or Yandex with anti-bot bypass. Returns markdown results. |
| `amazon_product()` | `import { amazon_product } from '@brightdata/ai-sdk'` | Get detailed Amazon product info: price, ratings, reviews, and specs. |
| `linkedin_profile()` | `import { linkedin_profile } from '@brightdata/ai-sdk'` | Fetch LinkedIn profile data including experience, education, and skills. |
| `linkedin_jobs()` | `import { linkedin_jobs } from '@brightdata/ai-sdk'` | Search LinkedIn job postings by location and keyword. |
| `instagram_profile()` | `import { instagram_profile } from '@brightdata/ai-sdk'` | Get Instagram profile info and recent posts. |
| `facebook_profile()` | `import { facebook_profile } from '@brightdata/ai-sdk'` | Collect Facebook profile data from a profile URL. |
| `chatgpt()` | `import { chatgpt } from '@brightdata/ai-sdk'` | Query ChatGPT via Bright Data's dataset API with optional web search mode. |

## How each tool works

### `scrape(options?)`

Scrape any public webpage and get back clean markdown (or HTML).

```typescript theme={null} theme={null}
import { scrape } from '@brightdata/ai-sdk'

const tool = scrape({
  api_key: 'optional — defaults to BRIGHTDATA_API_KEY env var',
  data_format: 'markdown', // or 'html'
  country: 'us',           // default proxy country (2-letter code)
})
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | `string` | Yes | The URL to scrape |
| `country` | `string` | No | 2-letter country code for the proxy exit node |

***

### `search(options?)`

Search the web via Google, Bing, or Yandex.

```typescript theme={null} theme={null}
import { search } from '@brightdata/ai-sdk'

const tool = search({
  api_key: 'optional',
  search_engine: 'google', // 'google' | 'bing' | 'yandex'
  data_format: 'markdown', // or 'html'
  country: 'us',
})
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `query` | `string` | Yes | The search query |
| `search_engine` | `string` | No | `'google'` (default), `'bing'`, or `'yandex'` |
| `country` | `string` | No | 2-letter country code for localized results |
| `data_format` | `string` | No | `'markdown'` (default) or `'html'` |

***

### `amazon_product(options?)`

Retrieve structured Amazon product data.

```typescript theme={null} theme={null}
import { amazon_product } from '@brightdata/ai-sdk'

const tool = amazon_product({ api_key: 'optional' })
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | `string` | Yes | Amazon product URL (must include `/dp/` or `/gp/product/`) |
| `zipcode` | `string` | No | ZIP code for location-specific pricing |

***

### `linkedin_profile(options?)`

Collect detailed LinkedIn profile data for one or more profiles.

```typescript theme={null} theme={null}
import { linkedin_profile } from '@brightdata/ai-sdk'

const tool = linkedin_profile({
  api_key: 'optional',
  format: 'json', // 'json' | 'jsonl'
})
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `urls` | `string[]` | Yes | Array of LinkedIn profile URLs (min 1) |

***

### `linkedin_jobs(options?)`

Search LinkedIn job postings by location and keyword.

```typescript theme={null} theme={null}
import { linkedin_jobs } from '@brightdata/ai-sdk'

const tool = linkedin_jobs({ api_key: 'optional' })
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `location` | `string` | Yes | Job location, e.g. `"New York, NY"` |
| `keyword` | `string` | No | Job title or search keyword |
| `country` | `string` | No | 2-letter country code |

***

### `instagram_profile(options?)`

Fetch Instagram profile info and recent posts.

```typescript theme={null} theme={null}
import { instagram_profile } from '@brightdata/ai-sdk'

const tool = instagram_profile({ api_key: 'optional' })
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | `string` | Yes | Instagram profile URL |

***

### `facebook_profile(options?)`

Collect Facebook profile data.

```typescript theme={null} theme={null}
import { facebook_profile } from '@brightdata/ai-sdk'

const tool = facebook_profile({
  api_key: 'optional',
  format: 'json', // 'json' | 'jsonl'
})
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `url` | `string` | Yes | Facebook profile URL |

***

### `chatgpt(options?)`

Query ChatGPT via Bright Data's ChatGPT dataset API with optional web search.

```typescript theme={null} theme={null}
import { chatgpt } from '@brightdata/ai-sdk'

const tool = chatgpt({
  api_key: 'optional',
  format: 'json', // 'json' | 'jsonl'
})
```

**LLM input schema:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `prompt` | `string` | Yes | Prompt to send to ChatGPT |
| `additional_prompt` | `string` | No | Optional follow-up prompt |
| `country` | `string` | No | 2-letter country code |
| `require_sources` | `boolean` | No | Fail when no sources are found |
| `web_search` | `boolean` | No | Enable ChatGPT web search mode |

***

## Example Output

### Example: scrape a webpage

**Prompt:** "Scrape [https://example.com](https://example.com) and tell me what it's about"

**AI Response:**

```text theme={null}
I've scraped the website. Here's what I found:

# Example Domain

This domain is for use in illustrative examples in documents. You may use this
domain in literature without prior coordination or asking for permission.

The website appears to be a placeholder domain used for documentation and
examples. It's maintained by IANA (Internet Assigned Numbers Authority) and
serves as a standard example domain that can be referenced in documentation
without needing permission.
```

### Example: run a Google search

**Prompt:** "Search for best mechanical keyboards 2025"

**AI Response:**

```text theme={null}
I found several highly-rated mechanical keyboards for 2025:

1. **Keychron Q1 Pro** — Premium 75% layout, hot-swappable switches,
   wireless. ~$200.

2. **Wooting 60HE** — Analog switches with adjustable actuation points,
   popular among gamers.

3. **GMMK Pro** — 75% gasket-mounted, extensive customization options.
```

### Amazon Product Example

**Prompt:** "Get info about [https://www.amazon.com/dp/B0D2Q9397Y](https://www.amazon.com/dp/B0D2Q9397Y)"

**AI Response:**

```text theme={null}
Product: Logitech MX Master 3S Wireless Mouse
Price: $99.99
Rating: 4.6/5 (8,234 reviews)

Key Features:
- 8K DPI sensor
- Quiet clicks
- USB-C charging
- Connects to up to 3 devices

Verdict: Excellent choice for productivity users. Premium price, but
justified by ergonomics and multi-device support.
```

## Best Practices

1. **API key management**, Use `BRIGHTDATA_API_KEY` in your environment; avoid hardcoding keys.
2. **Error handling**, All tools catch errors internally and return a descriptive string, so LLM loops won't crash.
3. **Data format**, Use `markdown` for scraping to get clean, LLM-friendly content.
4. **Multi-step agents**, Set `stopWhen: stepCountIs(N)` to let the model chain tool calls autonomously.
5. **Country targeting**, Pass a 2-letter country code to get geo-specific results or pricing.
6. **Async datasets**, For large dataset jobs (many LinkedIn profiles, etc.), consider setting `async: true` in the underlying SDK client to avoid timeouts.

## Which environment variables to set

```bash .env.local theme={null} theme={null}
BRIGHTDATA_API_KEY=your_api_key_here
```

Get your API key from the [Bright Data Dashboard](https://brightdata.com/cp).


# How to set up Bright Data with WebHarvy
Source: https://docs.brightdata.com/integrations/webharvy

Configure Bright Data proxies in WebHarvy to route automated web scraping jobs through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is WebHarvy?

WebHarvy is a web scraping tool that can easily extract text, HTML, images, URLs, and emails from websites and save the extracted content in various formats. If you are running a large scraping operation, using one of the [proxy services](https://brightdata.com/proxy-types) Bright Data offers will help you increase the success rates and send a lot more concurrent requests to the same target.

## How to setup WebHarvy with Bright Data proxies:

* Download and install WebHarvy Web Scraper
* Go to Webharvy → Home tab → Settings → Proxy Settings

<Frame>
  <img alt="WebHarvy toolbar with home and settings options." />
</Frame>

* Sign up for Bright Data’s Proxy Network
* Go to your Bright Data dashboard
* In the **Integrate** **with Bright Data Proxy Network** section, select **With a crawler or a bot** option

<Frame>
  <img alt="webharvy_int1.png" />
</Frame>

* On the API Examples page, you will see the following details:
  * Proxy address, Port number, User name, and Password

<Frame>
  <img alt="Instructions for bot configuration with red arrows." />
</Frame>

* Go back to WebHarvy Proxy settings and paste the details from Bright Data to WebHarvy Proxy settings
* Click on the + button
* Click Apply

<Frame>
  <img alt="WebHarvy proxy settings configuration screen." />
</Frame>

<Note>
  **Please note**: Webharvy will use proxy servers only during mining. The configuration browser of Webharvy will not use this proxy server, so if you check the IP address within the configuration browser, it will still be the original IP of your computer. To make the configuration browser use the proxy server, you should set the proxy address directly in Windows.
</Note>

To **disable the proxy server**, you just need to **uncheck the Enable Network connection via Proxy server checkbox** at Webharvy → Home Menu → Settings → Proxy Settings Tab.

Alternatively, you can use our own data collection tool for a quicker and easier process.

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, Web Unlocker API or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s).

  This is a simple process, see [this guide](/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# Webscraper.io proxy integration
Source: https://docs.brightdata.com/integrations/webscraper

Integrate Bright Data proxies (400M+ IPs) with Webscraper.io to run no-code scraping jobs with geo-targeted IPs and reduced detection risk across sites.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

Webscraper.io extension and Webscraper.io Cloud can be your perfect tool for data extraction. With an easy point-and-click interface scraper gather website data in a few minutes.

With Webscraper.io Cloud, automate scraping tasks completely with scheduler, API, data parser, data export, and more.

## Getting started with Webscraper.io

1. Install Web Scraper browser extension via [Chrome Store](https://chrome.google.com/webstore/detail/web-scraper/jnhgnonknehpejjnehehllkliplmbmhn?hl=en)

2. Sign up for [Webscraper.io Cloud](https://cloud.webscraper.io/register?luminati)

3. Subscribe to [Scale](https://cloud.webscraper.io/subscription-manager?luminati) plan

4. Open “Proxy Manager” on the left-side toolbar

<Frame>
  <img alt="webscraperio_integration6.png" />
</Frame>

## Create a proxy in Bright Data

1. Go to your [Bright Data Dashboard](https://brightdata.com/cp/zones) and click **Add Zone**

2. Select a network type and press **Add Zone**

3. Back in your Bright Data dashboard, click a Zone name

4. Take note of your Zone username and password

5. Switch back to the Web Scraper Cloud Proxy Manager

6. Choose **Bright Data Proxy** as the designated Proxy Server

<Frame>
  <img alt="webscraperio_integration7.png" />
</Frame>

7. Input a custom name, the username, and password form Bright Data created zone.
   If needed, limit your proxy region by selecting a country in the drop-down menu.

<Frame>
  <img alt="webscraperio_integration5.png" />
</Frame>

8. Click **Add Proxy**

9. The custom proxy will now be listed down below

<Frame>
  <img alt="webscraperio_integration1.png" />
</Frame>

10. To use a proxy for a scraping job, go to “My Sitemaps” from the menu on the left side

<Frame>
  <img alt="webscraperio_integration4.png" />
</Frame>

11. Click **Details Page** next to the sitemap you want to scrape

<Frame>
  <img alt="webscraperio_integration2.png" />
</Frame>

12. From the **Proxy** drop-down menu select the created proxy and click **Scrape**

<Frame>
  <img alt="webscraperio_integration3.png" />
</Frame>

There you have it - Webscraper.io Cloud will run your scraper via Bright Data Proxy.
As easy as that!

### Webscraper.io is Not A Bright Data Product

Note: the webscraper.io is not Bright Data Scrapers utility - this article refers to the external Webscraper.io integration.&#x20;


# How to set up Bright Data with xpander.ai
Source: https://docs.brightdata.com/integrations/xpander-ai

Integrate Bright Data with xpander.ai to give enterprise AI agents reliable web access and structured data extraction from public websites. Spans 195 countries.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

[xpander.ai](https://xpander.ai/) is a Backend-as-a-Service platform for building autonomous AI agents. It is a no-code solution designed to help enterprise developers efficiently build, test, and deploy AI agents. It also comes with an open-source SDK to programmatically build and run AI agents.

## Available Bright Data Tools

<Card>
  <CardGroup>
    <Card title="Start Data Collection Job by Dataset ID" icon="1">
      Launches a scraping job for a specified dataset using the Scraperss.
    </Card>

    <Card title="Execute Proxy Request by URL" icon="2">
      Sends an HTTP request through Bright Data’s proxy network for accessing the content of any web page.
    </Card>

    <Card title="Download Dataset Snapshot by ID" icon="3">
      Downloads a snapshot of a dataset in various formats, passing the data to the AI.
    </Card>
  </CardGroup>
</Card>

## How to Integrate Bright Data With xpander.ai

<Steps>
  <Step title="Prerequisites">
    * [xpander.ai account](https://app.xpander.ai/login)
    * [Bright Data API key](/api-reference/authentication#api-key)
  </Step>

  <Step title="Create a new agent">
    1. In your [profile dashboard](https://app.xpander.ai/agents) and press the “New Agent” button to add a new agent:

    <Frame>
      <img alt="Clicking the “Agents > New Agent” button" />
    </Frame>
  </Step>

  <Step title="Basic Configuration">
    1. Choose an appropriate name for your agent. For example, if you want to create a web scraping agent, you can call it “Web Scraper Agent”.

    <Frame>
      <img alt="Calling the new agent “Web Scraper Agent”" />
    </Frame>

    2. Leave all other settings in the “General” tab as they are. The defaults are enough for a simple setup like this one. By default, xpander.ai will use [OpenAI’s GPT-4o as the LLM model](https://openai.com/index/hello-gpt-4o/).
  </Step>

  <Step title="Add Bright Data integration tools">
    1. Go to the “Tools” tab on your agent’s page, then click the “Add tools” button:

    <Frame>
      <img alt="Clicking the “Add tools” button" />
    </Frame>

    2. Search for “bright data” on the right side panel and select the Bright Data integration:

    <Frame>
      <img alt="Selecting the Bright Data connector" />
    </Frame>
  </Step>

  <Step title="Configure the Bright Data Connector">
    The following modal will show up:

    <Frame>
      <img alt="Filling out the Bright Data connector configuration form" />
    </Frame>

    Fill it out as follows:

    | Configuration Option | Value |
    | :- | :- |
    | Connector name | Bright Data Connector (or any name you prefer) |
    | Authentication mode | API Key |
    | Authentication scope | Integration user |
    | API Key | \[Your Bright Data API key] |
    | Authentication type | Bearer |

    Once everything is filled in, press the “Save” button.
  </Step>

  <Step title="Select the Bright Data Tools">
    Now, you will be prompted to select the specific Bright Data tools you want to enable in your agent:

    <Frame>
      <img alt="Selecting the Bright Data tools to enable" />
    </Frame>

    We recommend selecting all tools to unlock full web scraping capabilities. As of this writing, the available tools are:

    * **Start Data Collection Job by Dataset ID**: Launches a scraping job for a specified dataset using the [Scraperss](https://brightdata.com/products/web-scraper).
    * **Execute Proxy Request by URL**: Sends an HTTP request through [Bright Data’s proxy network](https://brightdata.com/proxy-types/) for accessing the content of any web page.
    * **Download Dataset Snapshot by ID**: Downloads a snapshot of a dataset in various formats, passing the data to the AI.
  </Step>

  <Step title="Add the Tools to Your Agent">
    Once you have selected the desired tools, click the “Add to agent” button in the bottom-right corner:

    <Frame>
      <img alt="Clicking the “Add to agent” button" />
    </Frame>

    The “Tools” tab of your agent will now show the Bright Data connector with the tools you configured:

    <Frame>
      <img alt="Note the configured Bright Data tools" />
    </Frame>

    Notice that you can click on any tool to view or adjust its configuration.

    Fantastic! Your AI agent is now fully integrated with Bright Data tools and ready to scrape the web.
  </Step>

  <Step title="Specialize Your AI Scraping Agent">
    Now that your agent has access to the Bright Data tools for web scraping, give it a custom [system prompt](https://www.promptlayer.com/glossary/system-prompt). This tells the agent what it is and how it should operate.

    To do this, click on the “Instructions” tab and paste something like the following into the “System prompt” textarea:

    ```text theme={null}
    You are an AI agent capable of grounding your responses by scraping data from the web
    ```

    <Frame>
      <img alt="Adding a system prompt to your agent" />
    </Frame>

    For more specialized agents, you can also add custom rules and goals.

    Amazing! Your xpander scraping agent is ready.
  </Step>

  <Step title="View the Agent Graph">
    Click on the “Agent graph” button to view your current AI agent workflow:

    <Frame>
      <img alt="The agent graph" />
    </Frame>

    You will see a single agent with access to the three configured Bright Data tools for web scraping.

    Well done! All that is left is to test the agent and see it in action.
  </Step>

  <Step title="Send a Prompt to Your Agent">
    Go back to the “Tester Chat” tab and try out your agent with a prompt like this:

    ```text theme={null}
    Search for top 3 headphones under $100 and provide me info from their PDP's
    ```

    This instructs your web scraping agent to dynamically look online for the top 3 headphones priced under \$100 and retrieve information directly from their [product detail pages (PDPs)](https://www.dynamicyield.com/glossary/product-detail-page/).

    As you can imagine, a standard LLM would be able to handle this kind of task without access to dedicated scraping tools like those provided by Bright Data.

    Paste the prompt into the chat input and send it to your agent:

    <Frame>
      <img alt="The AI scraping agent in action" />
    </Frame>
  </Step>

  <Step title="Analyze the Agent's Response">
    The agent uses the LLM and Bright Data tools to:

    1. Perform a web search and find the top 3 headphones.
    2. For each product, start a data collection job and download data from Amazon.
    3. Summarize the information into a short, accurate response, complete with real-world links to the Amazon product detail pages.
  </Step>

  <Step title="Inspect the Tool Calls">
    If you expand one of the tool sections in the interface, you will see something like this:

    <Frame>
      <img alt="The I/O details from a tool call" />
    </Frame>

    This proves that, behind the scenes, the AI agent automatically detected which Bright Data tools to use to complete the task. In detail, it called them with the right parameters to fetch fresh scraped data (in this case, directly from Amazon product pages).
  </Step>
</Steps>

Et voilà! You now have a fully functional scraping agent on xpander.ai, powered by Bright Data’s AI data infrastructure.


# How to set up Bright Data with Zapier
Source: https://docs.brightdata.com/integrations/zapier

Connect Bright Data to Zapier to automate web data collection and route results into Google Sheets, Slack, Trello, Airtable and Salesforce.

Bright Data’s Zapier integration enables you to automate web data collection and seamlessly route structured data into apps like Google Sheets, Slack, Trello, Airtable, and Salesforce, without writing a single line of code.

## Available Zap Actions

The following actions are currently supported via the Bright Data Zapier integration:

| Actions | Description |
| :- | :- |
| Scrape Amazon | Create a new scraping request for Amazon data, waits for data to be received |
| Scrape Crunchbase | Create a new scraping request for Crunchbase data, waits for data to be received |
| Scrape Facebook | Scrape data from a Facebook Post, Comment or Reel |
| Scrape Google Play Store | Create a new scraping request for Google Play Store data, waits for data to be received |
| Scrape Instagram | Creates a new scraping request for Instagram data, waits for data to be received |
| Scrape Pinterest | Create a new scraping request for Pinterest data, waits for data to be received |
| Run an Web Unlocker API | Creates an Web Unlocker API run |
| Scrape Vimeo | Create a new scraping request for Vimeo data, waits for data to be received |
| Scrape Yelp | Create a new scraping request for Yelp data, waits for data to be received |
| Scrape ChatGPT | Create a new scraping request for ChatGPT data, waits for data to be received |
| Download Snapshot Content (Scrapers) | Download snapshot content (Scrapers) |
| Scrape Glassdoor | Create a new scraping request for Glassdoor data, waits for data to be received |
| Scrape Indeed | Create a new scraping request for Indeed data, waits for data to be received |
| Scrape LinkedIn | Create a new scraping request for LinkedIn data, waits for data to be received |
| Scrape Pitchbook | Create a new scraping request for Pitchbook data, waits for data to be received |
| Scrape TikTok | Create a new scraping request for TikTok data, waits for data to be received |
| Scrape X (Twitter) | Create a new scraping request for X data, waits for data to be received |
| Scrape YouTube | Create a new scraping request for YouTube data, waits for data to be received |

***

## How to Integrate Bright Data With Zapier

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * A valid Bright Data API Key
    * An active Zapier account
    * Access to the Bright Data Zapier app
    * A clear understanding of what data you want to scrape and where it should be sent
  </Step>

  <Step title="Create a Zap">
    Log in to your Zapier account, navigate to the **Zaps** section, and click **Create Zap** to start building your automation workflow.
  </Step>

  <Step title="Set Up a Trigger">
    Choose a trigger app and event that fits your use case. Common examples include:

    * **Schedule by Zapier**, run a scraper hourly, daily, or weekly
    * **New Row in Google Sheets**, trigger scraping when new input data is added
    * **Webhooks or Form Submissions**, trigger scrapers dynamically using real-time inputs
  </Step>

  <Step title="Add Bright Data as an Action">
    In the **Action** step, search for and select **Bright Data**. You will then be prompted to choose one of the available scraping or Unlocker actions.

    <Frame>
      <img alt="zapier-action-setup" />
    </Frame>
  </Step>

  <Step title="Select an Action Event">
    Choose the Bright Data action that matches your target platform.\
    For example:

    * Select **Scrape Amazon** to collect product data
    * Select **Scrape LinkedIn** to extract profile or company information
    * Select **Run an Web Unlocker API** for advanced dynamic website access
  </Step>

  <Step title="Connect Your Bright Data Account">
    Click **Sign In** next to the Bright Data connection field.\
    Enter your Bright Data API key to authorize Zapier to run scraping actions on your behalf.

    <Frame>
      <img alt="zapier-api-key" />
    </Frame>
  </Step>

  <Step title="Configure Action Parameters">
    Configure the required input fields for the selected action.\
    Depending on the scraper, this may include:

    * Target URLs or search terms
    * Country or localization settings
    * Result limits or pagination options
    * Output format preferences
  </Step>

  <Step title="Test the Action">
    Click **Test Action** to validate your configuration.\
    Zapier will execute a sample scrape and return example output so you can confirm:

    * Data is returned successfully
    * Fields are mapped correctly
    * The response matches your expectations
  </Step>

  <Step title="Add Downstream Actions (Optional)">
    After the Bright Data action, you can chain additional steps, such as:

    * Save results to Google Sheets or Airtable
    * Send alerts to Slack or Email
    * Push structured data into CRMs or internal tools
  </Step>

  <Step title="Publish and Monitor Your Zap">
    Once everything is verified, click **Publish Zap** to activate it.

    After publishing:

    * Monitor task history in Zapier
    * Adjust triggers or scraping parameters as needed
    * Scale workflows by duplicating Zaps for other platforms
  </Step>
</Steps>

***

## Best Practices

* Start with low-frequency triggers and scale gradually
* Validate output fields before sending data to production tools
* Use scheduling triggers for predictable workloads
* Monitor Zapier task usage and Bright Data API limits
* Keep API keys secure and rotate them periodically

***

## Conclusion

With Bright Data’s Zapier integration, you can automate web data collection without writing code. From scheduled scrapes to real-time triggers, this setup enables flexible, scalable workflows that seamlessly deliver structured data into your favorite tools, powering analytics, monitoring, and business operations with ease.


# Agent Builder MCP server integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/agent-builder

Connect OpenAI Agent Builder to the Bright Data MCP server (60+ tools) to build AI agents with real-time web search, scraping and structured data access.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

**Requirements:**

* [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
* OpenAI Account with a [verified organization](https://help.openai.com/en/articles/10910291-api-organization-verification)

<Steps>
  <Step title="Create a new flow">
    Go to [Agent Builder](https://platform.openai.com/agent-builder) and create a new flow

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Click on the agent node">
    <img alt="Agent Builder MCP Server Integration" />

    After clicking the agent node, the agent configuration panel will appear on the left side of the screen.
  </Step>

  <Step title="Click on Tools to add the MCP">
    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Choose MCP and add the Bright Data MCP server">
    Copy and paste the following URL into the URL section:

    ```http theme={null}
    https://mcp.brightdata.com/mcp?token=YOUR_API_KEY
    ```

    Replace `YOUR_API_KEY` with your actual Bright Data API key.

    <Note>
      You can copy this URL with a pre-filled API key from your [control panel](https://brightdata.com/cp/mcp)
    </Note>

    Then click the Connect button.

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Choose your preferred tools and add them">
    Here you can choose the relevant tools you want to expose to the agent, or add all of them by clicking the Add button.

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Configure your agent with a name and instructions">
    Give your agent a name, provide an instruction set, choose the reasoning effort level, and click the Preview button to test it.

    <img alt="Agent Builder MCP Server Integration" />
  </Step>

  <Step title="Test your agent">
    Ask your agent any question that requires real-time web data and get an instant answer.

    <img alt="Screenshot 2025-10-10 at 10.52.31.png" />
  </Step>
</Steps>


# OpenAI's ChatGPT MCP server integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/chat-gpt

Connect ChatGPT to the Bright Data MCP server to give your custom GPTs real-time web search, scraping and structured data access in a few setup steps.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

**Requirements:**

* [Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)
* OpenAI account

<Steps>
  <Step title="Add a new source">
    Go to [ChatGPT](https://chatgpt.com/) and click the "+" button to add a new source.

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Connect more">
    Click the "Add" button, then select "Connect more".

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Advanced settings">
    Click on "Advanced settings", enable Developer Mode, then click "Create app".

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Connect Bright Data MCP">
    Click "Create app" and fill in the following details:

    * **App name**
    * **MCP Server URL:**

    ```http theme={null}
    https://mcp.brightdata.com/mcp?token=YOUR_API_KEY
    ```

    * **Authentication: no authentication**

    Here is how it should look like:

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>

  <Step title="Unlock the web">
    Tag Bright Data MCP and chat with the open web without getting blocked!

    <img alt="OpenAI's ChatGPT MCP Server Integration" />
  </Step>
</Steps>


# Claude Desktop integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/claude

Connect Claude Desktop to the Bright Data MCP server to give Claude real-time web search, scraping and structured data access. Exposes 60+ tools.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

**Getting Started Video**:

<iframe title="Easiest way to start with Claude" />

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Configure your MCP server">
    1. Open Claude Desktop
    2. Go to: Settings → Developer → Edit Config
    3. Add this to your `claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE"
          ]
        }
      }
    }
    ```

    4. **`Replace YOUR_API_TOKEN_HERE`** with your actual API token from Step 1
    5. Save and restart Claude Desktop
  </Step>

  <Step title="Test it works">
    1. Ask your AI: "Can you search Google for 'weather today'?"
    2. Claude will ask for permission - click "Allow"
    3. You should see results!
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Node.js ](https://nodejs.org/en/download) is installed and up to date
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)  (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `WEB_UNLOCKER_ZONE `environment variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Go to Claude -> Settings -> Developer -> Edit Config -> `claude_desktop_config.json` to include the following:

    ```json expandable theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": ["@brightdata/mcp"],
          "env": {
            "API_TOKEN": "<insert your api key from https://brightdata.com/cp/setting/users>"     
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Advanced Configuration">
    If you want to use advanced features like rate limiting or custom zones, you can add more environment variables:

    ```json expandable theme={null}
    {
      "mcpServers": {
        "Bright Data": {
          "command": "npx",
          "args": ["@brightdata/mcp"],
          "env": {
            "API_TOKEN": "<insert your api key from https://brightdata.com/cp/setting/users>",
            "WEB_UNLOCKER_ZONE": "<Optional - if you want to use a specific name for web_unlocker, the name goes here. If not - REMOVE this field>",
            "BROWSER_ZONE": "<Optional - if you want to use a specific name for browser_api, the name goes here. If not - REMOVE this field>",
            "RATE_LIMIT": "<Optional - rate limit format, possible values: limit/time+unit, e.g., 100/1h, 50/30m, 10/5s. If not in use - REMOVE this field>",
            "PRO_MODE": "<Optional - set to true to enable all 60+ tools>",
            "GROUPS": "<Optional - comma-separated tool groups, e.g., browser,ecommerce,social>",
            "TOOLS": "<Optional - comma-separated individual tool names to enable>"
          }
        }
      }
    }
    ```
  </Step>
</Steps>


# Claude Code MCP server integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/claude-code

Connect Claude Code to the Bright Data MCP server (60+ tools) with a 1-line install command to give your coding agent real-time web search and scraping.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Quick Install

To integrate Bright Data into Claude Code, simply copy this command to your terminal:

```bash theme={null}
claude mcp add --transport sse brightdata "https://mcp.brightdata.com/sse?token=YOUR_API_KEY"
```

<Warning>
  Use an API key with **Admin permissions**. Keys without Admin permissions may cause Claude Code to show a "Failed to connect" error in `claude mcp list`.
</Warning>

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Claude Code](https://docs.anthropic.com/en/docs/claude-code) is installed and configured
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing, and then you can pay as you go)
    * A Bright Data **Admin API key** from the [user settings page](https://brightdata.com/cp/setting/users). The key must have **Admin permissions** to connect to the hosted Bright Data MCP server. New users receive an **API key** in the welcome email.

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `unlocker` url parameter variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Add the Bright Data MCP server to your Claude Code configuration:

    ```bash theme={null}
    claude mcp add --transport sse brightdata https://mcp.brightdata.com/sse?token=YOUR_API_KEY
    ```

    Replace `YOUR_API_KEY` with your actual API token from Bright Data.
  </Step>

  <Step title="Validation">
    Verify the integration by running:

    ```bash theme={null}
    claude mcp list
    ```

    You should see the following output confirming successful connection:

    ```text theme={null}
    brightdata: https://mcp.brightdata.com/sse?token=<yourapikey>(SSE) - ✓ Connected
    ```
  </Step>
</Steps>

## Troubleshooting

### Why does `claude mcp list` show "Failed to connect"?

If `claude mcp list` fails to connect, confirm that the API key has **Admin permissions**. Generate a new Admin API key on the [user settings page](https://brightdata.com/cp/setting/users) if needed, then remove and re-add the Bright Data MCP server configuration:

```bash theme={null}
claude mcp remove brightdata
claude mcp add --transport sse brightdata "https://mcp.brightdata.com/sse?token=YOUR_API_KEY"
```

Run `claude mcp list` again to confirm that the `brightdata` server shows `✓ Connected`.


# Cloudflare Agents SDK integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/cloudflare-agents

How to integrate Cloudflare's Agents SDK with Bright Data's Bright Data MCP server for building AI agents on Cloudflare Workers. Exposes 60+ MCP tools.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Set up your Cloudflare environment">
    Make sure you have Node.js 20+ installed, then log in to Cloudflare:

    ```shell theme={null}
    npx wrangler login
    ```
  </Step>

  <Step title="Install the Agents Starter template">
    ```shell theme={null}
    npx create-cloudflare@latest mcp-demo --template cloudflare/agents-starter
    cd mcp-example
    npm install
    ```
  </Step>

  <Step title="Configure environment variables">
    Copy the example env file and add your OpenAI API key:

    ```shell theme={null}
    cp .dev.vars.example .dev.vars
    ```

    Edit `.dev.vars`:

    ```env theme={null}
    OPENAI_API_KEY=sk-...
    ```
  </Step>

  <Step title="Connect Bright Data MCP in your agent">
    In `src/server.ts`, find the default commented-out MCP connection inside `onChatMessage`:

    ```ts theme={null}
    // const mcpConnection = await this.mcp.connect(
    //   "https://path-to-mcp-server/sse"
    // );
    ```

    Replace it with the Bright Data MCP connection:

    ```ts expandable theme={null}
    // Connect to Bright Data MCP server
    const mcpConnection = await this.mcp.connect(
      "https://mcp.brightdata.com/mcp?token=<API_TOKEN>"
    );

    // Merge MCP tools with local tools
    const allTools = {
      ...tools,
      ...this.mcp.getAITools()
    };
    ```

    <Note>
      Make sure `mcp.connect()` is called **before** `this.mcp.getAITools()` to avoid `jsonSchema not initialized` errors.
    </Note>
  </Step>

  <Step title="Test it works">
    1. Replace `<API_TOKEN>` with your actual Bright Data API token
    2. Start the development server:

    ```shell theme={null}
    npm start
    ```

    3. Open the app in your browser and ask the agent a question, for example:

    ```text theme={null}
    Find the latest 3 news items about Cloudflare Agents and summarize them in bullets with links.
    ```

    You should see the agent use Bright Data's web scraping tools to fetch and summarize live results:

    <img alt="Hosted MCP" />
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# Codex MCP server integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/codex

Connect OpenAI Codex CLI to the Bright Data MCP server (60+ tools) via config.toml or the codex mcp add command for real-time web search and scraping.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

Add the Bright Data MCP server to OpenAI's Codex CLI so your coding agent can search, scrape and browse the live web without getting blocked. Codex reads MCP server definitions from `~/.codex/config.toml`, which you can edit directly or update with the `codex mcp add` command.

## Prerequisites

* [Codex CLI](https://github.com/openai/codex) is installed and signed in
* [Node.js](https://nodejs.org/en/download) is installed and up to date (required only for the self-hosted server)
* [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing, and then you can pay as you go)
* An API key from the [user settings page](https://brightdata.com/cp/setting/users) (new users receive an API key in the welcome email)

## Hosted MCP

The hosted server needs no local install. Add the following table to `~/.codex/config.toml`, replacing `YOUR_API_KEY` with your Bright Data API key:

```toml theme={null}
[mcp_servers.brightdata]
url = "https://mcp.brightdata.com/mcp?token=YOUR_API_KEY"
```

The `[mcp_servers.<id>]` table uses `url` for streamable HTTP servers. The Bright Data hosted MCP accepts the API key as the `token` query parameter, so no separate authentication header is required.

<Tip>
  If you prefer to use a different zone name, specify it with the `unlocker` URL parameter, for example `...?token=YOUR_API_KEY&unlocker=<your-zone>`.
</Tip>

## Self-hosted MCP

The self-hosted server runs locally through `npx` and reads your API key from an environment variable.

<Steps>
  <Step title="Add the server with the CLI">
    Run the following command in your terminal. The `--` separator tells Codex where the environment flags end and the server command begins:

    ```bash theme={null}
    codex mcp add brightdata --env API_TOKEN=YOUR_API_KEY -- npx -y @brightdata/mcp
    ```
  </Step>

  <Step title="Or edit config.toml directly">
    Alternatively, add this table to `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.brightdata]
    command = "npx"
    args = ["-y", "@brightdata/mcp"]

    [mcp_servers.brightdata.env]
    API_TOKEN = "YOUR_API_KEY"
    ```
  </Step>
</Steps>

## Validation

Verify the integration by listing the configured MCP servers:

```bash theme={null}
codex mcp list
```

You should see `brightdata` in the output, confirming the server is configured. Start a Codex session and ask it to fetch a live web page to confirm the tools respond.


# CrewAI integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/crewai

Connect CrewAI multi-agent crews to the Bright Data MCP server, using either the hosted endpoint or self-hosted mode for real-time web data access.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    from crewai import Agent, Task, Crew
    from crewai_tools import MCPServerAdapter
    import os


    server_params = {
        "url": "https://mcp.brightdata.com/sse?token=API_TOKEN",
        "transport": "sse"
    }

    try:
        with MCPServerAdapter(server_params) as mcp_tools:
            print(f"Available tools: {[tool.name for tool in mcp_tools]}")
            
            my_agent = Agent(
                role="Web Scraping Specialist",
                goal="Extract data from websites using Bright Data tools",
                backstory="I am an expert at web scraping and data extraction using MCP tools.",
                tools=mcp_tools,
                verbose=True,
                llm="gpt-4o-mini",
            )
            
            task = Task(
                description="Search for flights from New York to San Francisco and provide a summary of what you found. Use the search_engine tool to find flight information and return the results in a clear format.",
                expected_output="A clear summary of available flights from New York to San Francisco, including key details like airlines, times, and prices if available.",
                agent=my_agent
            )
            
            crew = Crew(
                agents=[my_agent],
                tasks=[task],
                verbose=True
            )
            
            result = crew.kickoff()
            print("\n=== RESULT ===")
            print(result)
            
    except Exception as e:
        print(f"Error connecting to MCP server: {e}")
        print("Make sure you have:")
        print("1. Replaced API_TOKEN in the MCP server URL with your Bright Data API key")
        print("2. Installed the Bright Data MCP server: npm install -g @bright_data/ai/mcp-server-bright-data")
        print("3. Have Node.js installed on your system")
    ```
  </Step>

  <Step title="Test it works">
    1. Run your CrewAI script with the flight search task
    2. The agent will use Bright Data tools to search for flight information
    3. You should see results with flight details
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# Cursor MCP server integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/cursor

Connect Cursor IDE to the Bright Data MCP server (60+ tools) in either hosted or self-hosted mode, for AI coding assistant web search and scraping.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Node.js ](https://nodejs.org/en/download) is installed and up to date
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)  (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `WEB_UNLOCKER_ZONE `environment variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Go to Cursor -> Click the gear icon -> Tools & Integrations -> Add Custom MCP -> include the following:

    ```json expandable theme={null}
    {
        "mcpServers": {
        "brightdata-mcp": {
            "command": "npx",
            "args": ["-y", "@brightdata/mcp"],
            "env": {
            "API_TOKEN": "<your API token>"
            }
        }
        }
    }
    ```

    <Frame>
      <img alt="Screenshot 2025-07-14 at 13.50.57.png" title="Screenshot 2025-07-14 at 13.50.57.png" />
    </Frame>

    Then you need to see:

    <Frame>
      <img alt="Screenshot 2025-07-14 at 14.18.16.png" title="Screenshot 2025-07-14 at 14.18.16.png" />
    </Frame>
  </Step>
</Steps>


# Google ADK integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/google-adk

Connect Google Agent Development Kit (ADK) to the Bright Data MCP server (60+ tools) for Gemini-powered agents with web search and structured extraction.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Remote MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install required packages">
    ```shell theme={null}
    pip install google-adk
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    from google.adk.agents import Agent
    from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams
    from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset

    BRIGHTDATA_API_KEY = "YOUR_API_KEY"

    root_agent = Agent(
    model="gemini-2.5-pro",
    name="brightdata_agent",
    instruction="""Help users access web data using Bright Data""",
    tools=[
        MCPToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"https://mcp.brightdata.com/mcp?token={BRIGHTDATA_API_KEY}",
            ),
        )
    ],
    )
    ```
  </Step>

  <Step title="Set up environment variables (optional)">
    For better security, you can store your API token as an environment variable:

    ```python theme={null}
    import os
    BRIGHTDATA_API_KEY = os.getenv("BRIGHTDATA_API_KEY")
    ```

    Then create a `.env` file in your project directory:

    ```env theme={null}
    BRIGHTDATA_API_KEY=your_brightdata_api_key_here
    ```
  </Step>

  <Step title="Test it works">
    1. Replace `YOUR_API_KEY` with your Bright Data API key
    2. Run your Google ADK script
    3. You should see the agent execute web searches and provide comprehensive responses
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>

## Local MCP Server

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install required packages">
    ```shell theme={null}
    pip install google-genai
    npm install -g @brightdata/mcp
    ```
  </Step>

  <Step title="Configure your local MCP server">
    ```python expandable theme={null}
    from google.adk.agents import Agent
    from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
    from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset
    from mcp import StdioServerParameters

    BRIGHTDATA_API_KEY = "YOUR_API_KEY"

    root_agent = Agent(
    model="gemini-2.5-pro",
    name="brightdata_agent",
    instruction="Help users access web data using Bright Data",
    tools=[
        MCPToolset(
            connection_params=StdioConnectionParams(
                server_params = StdioServerParameters(
                    command="npx",
                    args=[
                        "@brightdata/mcp",
                    ],
                    env={
                        "API_TOKEN": BRIGHTDATA_API_KEY,
                        "PRO_MODE": "true",  # Optional: Enable all 60+ tools
                    }
                ),
                timeout=300,
            ),
        )
    ],
    )
    ```
  </Step>

  <Step title="Test it works">
    1. Replace `YOUR_API_KEY` with your Bright Data API key
    2. Run your Google ADK script with the local MCP server
    3. The agent will use the locally installed MCP server to access all available tools
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>

## Available Tools

The Bright Data MCP server provides access to powerful web scraping capabilities:

* **Rapid Mode (Free Tier)**: 4 essential tools including search, scraping, and extraction
* **Pro Mode**: 60+ additional tools including batch operations, browser automation, and structured data APIs for major platforms

[View complete tool documentation](../tools)

[Visit Google ADK docs ](https://google.github.io/adk-docs/)


# LangChain integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/langchain

Connect LangChain and LangGraph agents to the Bright Data MCP server to add real-time web search, scraping and structured data tools to your AI workflows.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install required packages">
    ```shell theme={null}
    pip install langchain-mcp-adapters
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    import asyncio
    from langchain_openai import ChatOpenAI
    from langgraph.prebuilt import create_react_agent
    from langchain_mcp_adapters.client import MultiServerMCPClient
    from dotenv import load_dotenv
    import os

    load_dotenv()

    async def main():
        # Configure MCP client
        client = MultiServerMCPClient({
            "bright_data": {
                "url": "https://mcp.brightdata.com/sse?token=<API_TOKEN>",
                "transport": "sse",
            }
        })

        # Get available tools
        tools = await client.get_tools()
        print("Available tools:", [tool.name for tool in tools])

        # Configure LLM
        llm = ChatOpenAI(
            openai_api_key=os.getenv("OPENROUTER_API_KEY"),
            openai_api_base="https://openrouter.ai/api/v1",
            model_name="moonshotai/kimi-k2"
        )

        # System prompt for web search agent
        system_prompt = """
        You are a web search agent with comprehensive scraping capabilities. Your tools include:
        - **search_engine**: Get search results from Google/Bing/Yandex
        - **scrape_as_markdown**: Extract content from any webpage with bot detection bypass
        - **Structured extractors**: Fast, reliable data from major platforms (Amazon, LinkedIn, Instagram, Facebook, X, TikTok, YouTube, Reddit, Zillow, etc.)
        - **Browser automation**: Navigate, click, type, screenshot for complex interactions

        Guidelines:
        - Use structured web_data_* tools for supported platforms when possible (faster/more reliable)
        - Use general scraping for other sites
        - Handle errors gracefully and respect rate limits
        - Think step by step about what information you need and which tools to use
        - Be thorough in your research and provide comprehensive answers

        When responding, follow this pattern:
        1. Think about what information is needed
        2. Choose the appropriate tool(s)
        3. Execute the tool(s)
        4. Analyze the results
        5. Provide a clear, comprehensive answer
        """

        # Create ReAct agent
        agent = create_react_agent(
            model=llm,
            tools=tools,
            prompt=system_prompt
        )

        # Test the agent
        print("Testing ReAct Agent with available tools...")
        print("=" * 50)

        result = await agent.ainvoke({
            "messages": [("human", "Search for the latest news about AI developments")]
        })

        print("\nAgent Response:")
        print(result["messages"][-1].content)

    if __name__ == "__main__":
        asyncio.run(main())
    ```
  </Step>

  <Step title="Set up environment variables">
    Create a `.env` file in your project directory:

    ```env theme={null}
    OPENROUTER_API_KEY=your_openrouter_api_key_here
    ```
  </Step>

  <Step title="Test it works">
    1. Replace `<API_TOKEN>` with your actual Bright Data API token
    2. Run your LangChain script
    3. You should see the agent execute web searches and provide comprehensive responses
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# LlamaIndex integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/llamaindex

Connect LlamaIndex agents to the Bright Data MCP server to add live web search, scraping and structured data retrieval to your RAG and indexing pipelines.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install LlamaIndex MCP Toolkit ">
    ```shell theme={null}
    pip install llama-index-tools-mcp
    ```
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    import asyncio
    from llama_index.tools.mcp import BasicMCPClient

    async def main():
        http_client = BasicMCPClient("https://mcp.brightdata.com/mcp?token=<API_TOKEN>")

        # List tools
        tools = await http_client.list_tools()
        print("Tools:", tools)

        # Call a tool
        result = await http_client.call_tool("scrape_as_markdown", {"url":"https://docs.llamaindex.ai/en/stable/examples/tools/mcp/"})
        print("Result:", result)

    asyncio.run(main())

    ```
  </Step>

  <Step title="Test it works">
    1. Run your LlamaIndex script with the manual tool calling
    2. You should see the requested URL in markdown
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# Set up the Bright Data MCP with n8n
Source: https://docs.brightdata.com/products/mcp-server/integrations/n8n

Connect the Bright Data MCP server to n8n to build automated, no-code data workflows with web search, scraping and structured extraction nodes.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Overview

This guide explains how to integrate **Bright Data MCP** with **n8n** to build automated, AI-driven workflows.

You can connect MCP to n8n in two ways:

1. **Streamable HTTP MCP** – Easiest, cloud-based setup

2. **Self-hosted MCP Client** – Advanced, customizable deployment

Choose the approach that best fits your infrastructure and control requirements.

***

## Streamable HTTP MCP Integration

Streamable HTTP is the **recommended option** for most users.

It requires no local setup and allows n8n AI agents to interact with Bright Data MCP over HTTPS with real-time streaming.

### Requirements

* A **Bright Data account**\
  [https://brightdata.com/?hs\_signup=1\&utm\_source=docs](https://brightdata.com/?hs_signup=1\&utm_source=docs)

* An **API token** from your user settings\
  [https://brightdata.com/cp/setting/users](https://brightdata.com/cp/setting/users)

* An AI-enabled workflow (e.g., an **AI Agent**) in n8n

***

### How to configure remote MCP

1. **Create an AI Agent** in n8n or your preferred AI orchestration platform.

2. **Attach the following components:**

   * A **Chat Model** (e.g., `gpt-4`, `gpt-4o`)

   * An **MCP Client** node

3. **Configure the Remote MCP URL** using your API token:

```text theme={null}
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
```

4. **Select MCP tools**

   * Expose specific tools explicitly, or

   * Allow the AI agent to choose tools dynamically

Once configured, the AI agent will invoke MCP tools as needed and stream responses in real time back into your workflow.

### When to Use Streamable HTTP

* No-code or low-code automation

* Fast setup with minimal infrastructure

* Cloud-hosted n8n deployments

* Real-time, AI-driven data extraction

***

## Self-hosted MCP Integration (MCP Client – Community Node)

The self-hosted option provides maximum control by running the Bright Data MCP client locally or within your own infrastructure.

This approach is best suited for advanced users who require custom rate limits, isolated environments, or internal networking.

### Requirements

* Node.js installed\
  [https://nodejs.org/en/download](https://nodejs.org/en/download)

* A Bright Data account\
  [https://brightdata.com/?hs\_signup=1\&utm\_source=docs](https://brightdata.com/?hs_signup=1\&utm_source=docs)

* An API token from user settings\
  [https://brightdata.com/cp/setting/users](https://brightdata.com/cp/setting/users)

* n8n with support for community or custom nodes

### How to configure self-hosted MCP

1. **Create an AI Agent** in n8n.

2. **Attach the following components:**

   * A **Chat Model** (e.g., `gpt-4`, `gpt-4o`)

   * **Bright Data MCP Client** (via HTTP or WebSocket)

3. **Configure the MCP client execution settings:**

   | Variable | Value |
   | - | - |
   | Command | `npx` |
   | Arguments | `@brightdata/mcp` |
   | Environments | `API_KEY=<api-key>`<br />`WEB_UNLOCKER_ZONE=<unlocker_api_zone_name>`<br />`BROWSER_ZONE=<browser_zone_name>`<br />`RATE_LIMIT=<rate-limit>` |

4. **Example values for RATE\_LIMIT:**

   * `100/1h`
   * `50/30m`
   * `10/5s`

   These limits help control request throughput and prevent overuse of MCP tools.

### When to Use Self-hosted MCP

* Enterprise or regulated environments

* Custom networking or security requirements

* Fine-grained rate limiting

* On-premise or private-cloud n8n deployments

***

## Summary

By integrating Bright Data MCP with n8n, you can build powerful AI-driven automation pipelines without writing complex code.

* **Streamable HTTP MCP** → Fastest and simplest setup

* **Self-hosted MCP Client** → Maximum flexibility and control

Both approaches enable AI agents to access Bright Data tools seamlessly, unlocking advanced data workflows at scale.
Bright Data - All in One Platform for Proxies and Web Scraping
Award winning proxy networks, powerful web scrapers, and ready-to-use datasets for download. Welcome to the world's #1 web data platform.


# NVIDIA NeMo Agent Toolkit integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/nvidia-nemo

Connect the NVIDIA NeMo Agent Toolkit to the Bright Data MCP server (60+ tools) to give NeMo-powered agents web search, scraping and structured data.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Overview

NVIDIA NeMo Agent Toolkit is an open-source framework for building, profiling, and optimizing AI agents and workflows. It provides framework-agnostic architecture, YAML-based configuration, built-in MCP support, and unified monitoring across multi-agent systems.

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Install NeMo Agent Toolkit">
    ```bash theme={null}
    pip install nvidia-nat[mcp]
    ```
  </Step>

  <Step title="Create workflow configuration">
    Create a file named `brightdata-mcp-config.yml`:

    ```yaml expandable theme={null}
    function_groups:
      brightdata_web:
        _type: mcp_client
        server:
          transport: streamable-http
          url: "https://mcp.brightdata.com/mcp?token=<YOUR_BRIGHTDATA_API_TOKEN>"
        tool_call_timeout: 120  # Increase timeout for web requests
        auth_flow_timeout: 300
        reconnect_enabled: true
        reconnect_max_attempts: 3


    llms:
      nim_llm:
        _type: nim
        model_name: "meta/llama-3.1-8b-instruct"
        temperature: 0.0
        api_key: "${env:NVIDIA_API_KEY}"

    workflow:
      _type: react_agent
      tool_names:
        - brightdata_web
      llm_name: nim_llm
      max_iterations: 10
      verbose: true
    ```

    Replace `YOUR_BRIGHTDATA_API_TOKEN` with your actual token from Step 1.
  </Step>

  <Step title="Set up environment variables">
    ```bash theme={null}
    # Set your NVIDIA API key (for NIM or NGC)
    export NVIDIA_API_KEY="your-nvidia-api-key"
    ```
  </Step>

  <Step title="Verify MCP connection">
    Test the connection to Bright Data's MCP server:

    ```bash theme={null}
    nat mcp client ping --url "https://mcp.brightdata.com/mcp?token=YOUR_BRIGHTDATA_API_TOKEN"
    ```

    Expected output:

    ```text theme={null}
    Successfully connected to MCP server
    Server version: 1.0
    Available tools: 15
    ```
  </Step>

  <Step title="List available tools">
    Inspect the tools provided by Bright Data MCP:

    ```bash theme={null}
    nat mcp client tool list --url "https://mcp.brightdata.com/mcp?token=YOUR_TOKEN"
    ```
  </Step>

  <Step title="Run your first agent">
    Execute the workflow with a query:

    ```bash theme={null}
    nat run --config_file brightdata-mcp-config.yml \
      --input "Search for the latest NVIDIA GPU releases and extract their specifications"
    ```

    The agent will use Bright Data's web scraping tools to search and extract information.
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
    3. Monitor tool calls in logs with: `nat run --config_file brightdata-mcp-config.yml`
  </Step>
</Steps>

## Where to learn more

* [NeMo Agent Toolkit Documentation](https://docs.nvidia.com/nemo/agent-toolkit/)
* [NeMo Agent Toolkit GitHub](https://github.com/NVIDIA/NeMo-Agent-Toolkit)
* [Bright Data MCP Documentation](/mcp-server/)


# OpenAI SDK integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/openai

Connect the OpenAI SDK to the Bright Data MCP server to give GPT-4o and o-series models real-time web search, scraping and structured data access.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Hosted MCP

<Steps>
  <Step title="Get your API token">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API token (it looks like: `2dceb1aa0***************************`)
  </Step>

  <Step title="Configure your MCP server">
    ```python expandable theme={null}
    from openai import OpenAI

    client = OpenAI()

    resp = client.responses.create(
      model="gpt-4o",
      tools=[
        {
          "type": "mcp",
          "server_label": "BrightData",
          "server_url": "https://mcp.brightdata.com/sse?token=API_TOKEN",
          "require_approval": "never",
        },
      ],
      input="What is the weather in Paris ?",
    )

    print(resp.output_text)
    ```
  </Step>

  <Step title="Test it works">
    1. Ask your AI: "Can you search Google for 'weather today'?"
    2. You should see results!
  </Step>

  <Step title="Monitor usage">
    1. View your API usage at [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Your free tier includes 5,000 requests per month
  </Step>
</Steps>


# MCP server integrations overview
Source: https://docs.brightdata.com/products/mcp-server/integrations/overview

Connect Bright Data's MCP server (60+ tools) to AI frameworks and agent tools to give models real-time web access for search, scraping and browsing tasks.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Which MCP integrations are supported

<CardGroup>
  <Card title="Codex" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/chat-gpt.png" href="/products/mcp-server/integrations/codex">
    Connect OpenAI Codex CLI to Bright Data for live web search and scraping.
  </Card>

  <Card title="Claude Code" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/claude.png" href="/products/mcp-server/integrations/claude-code">
    Integrate Bright Data with Claude Code for enhanced AI capabilities.
  </Card>

  <Card title="Agent Builder" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/agent-builder.png" href="/products/mcp-server/integrations/agent-builder">
    Build intelligent AI agents with Bright Data and Agent Builder.
  </Card>

  <Card title="Claude Desktop" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/claude.png" href="/products/mcp-server/integrations/claude">
    Enhance your AI applications with Bright Data and Claude Desktop.
  </Card>

  <Card title="CrewAI" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/crewai.png" href="/products/mcp-server/integrations/crewai">
    Build and scale AI workflows with Bright Data and CrewAI.
  </Card>

  <Card title="Cursor" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/cursor.png" href="/products/mcp-server/integrations/cursor">
    Empower your AI applications with Bright Data and Cursor.
  </Card>

  <Card title="LlamaIndex" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/llamaindex.png" href="/products/mcp-server/integrations/llamaindex">
    Integrate Bright Data with LlamaIndex for enhanced AI capabilities.
  </Card>

  <Card title="n8n" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/n8n.png" href="/products/mcp-server/integrations/n8n">
    Automate workflows with Bright Data and n8n integration.
  </Card>

  <Card title="LangChain" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/langchain.png" href="/products/mcp-server/integrations/langchain">
    Build intelligent AI agents with Bright Data and LangChain.
  </Card>

  <Card title="Snowflake" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/snowflake.png" href="/products/mcp-server/integrations/snowflake">
    Integrate live, structured web data directly into your Snowflake data lake workflows.
  </Card>

  <Card title="VS Code" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/vscode.png" href="/products/mcp-server/integrations/vscode">
    Enhance your AI applications with Bright Data and VS Code.
  </Card>

  <Card title="Vapi AI" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/vapi.png" href="/products/mcp-server/integrations/vapi">
    Build and scale AI workflows with Bright Data and Vapi AI.
  </Card>

  <Card title="NVIDIA NeMo" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/nvidia-nemo.png" href="/products/mcp-server/integrations/nvidia-nemo">
    Empower your AI applications with Bright Data and NVIDIA NeMo.
  </Card>

  <Card title="ChatGPT" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/chat-gpt.png" href="/products/mcp-server/integrations/chat-gpt">
    Empower your AI applications with Bright Data and Google ADK.
  </Card>

  <Card title="Cloudflare agents" icon="https://mintlify.s3.us-west-1.amazonaws.com/brightdata/images/products/mcp-server/integrations/overview/cloudflare.png" href="/products/mcp-server/integrations/cloudflare-agents">
    Build intelligent Cloudflare Workers agents powered by Bright Data's live web data.
  </Card>
</CardGroup>

***

<Card title="AI Frameworks" icon="layer-group" href="/integrations/ai-integrations">
  <p>Connect to our MCP clients for seamless integration.</p>
</Card>


# Snowflake integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/snowflake

Connect Snowflake Cortex to the Bright Data MCP server (60+ tools) to enrich tables with live web data and run automated extraction inside your warehouse.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

<Steps>
  <Step title="Get your Bright Data API key">
    1. Go to [Bright Data user settings](https://brightdata.com/cp/setting/users)
    2. Copy your API key (it looks like: `2dceb1aa0***************************`)
    3. Keep it secure - you'll use it when connecting to the MCP
  </Step>

  <Step title="Install the Bright Data MCP app">
    1. Navigate to **Apps** in your Snowflake interface
    2. Find and click **Bright Data MCP**
    3. Click **Install** to add the application to your account
  </Step>

  <Step title="Configure external access">
    1. Open the installed app
    2. You'll see a request for **Bright Data External Access**
    3. Click **Review** to see the network configuration
    4. Click **Connect** - this automatically creates the necessary network rules
    5. Click **Activate** to enable the external access integration

    The app now has all the resources it needs to run.
  </Step>

  <Step title="Start the MCP service and get the endpoint">
    Start the application and retrieve the MCP endpoint URL.

    ```sql expandable theme={null}
    -- Start the app
    CALL <application-name>.app_public.start_app();

    -- Check application status
    CALL <application-name>.app_public.service_status();

    -- Get the endpoint URL
    SHOW ENDPOINTS IN SERVICE <application-name>.core.mcp_service;
    ```

    Copy the endpoint URL from the output, you'll need it to connect your MCP client.
  </Step>

  <Step title="Create a Snowflake Personal Access Token (PAT)">
    1. In Snowflake, go to **Settings**
    2. Navigate to **Authentication** → **Programmatic Access Tokens**
    3. Click **Generate New Token**
    4. Save the token securely, it will be used for MCP authentication
  </Step>

  <Step title="Connect to the Bright Data MCP">
    Use the following endpoint format in your MCP client:

    ```text theme={null}
    https://<endpoint>.snowflakecomputing.app/mcp?token=YOUR_API_KEY
    ```

    Include the required authentication header:

    ```text theme={null}
    Authorization: Snowflake Token="YOUR_SNOWFLAKE_PAT"
    ```

    Replace:

    * `<endpoint>` with the Snowflake endpoint from the previous step
    * `YOUR_API_KEY` with your Bright Data API key
    * `YOUR_SNOWFLAKE_PAT` with your Snowflake Personal Access Token
  </Step>

  <Step title="Test the integration">
    1. Connect to the MCP endpoint from your MCP-compatible client (e.g. Claude Desktop)
    2. Invoke a tool such as web browsing or scraping
    3. Confirm that responses are returned successfully
  </Step>

  <Step title="Monitor usage">
    1. Visit [My Zones](https://brightdata.com/cp/zones) in your Bright Data dashboard
    2. Track request volume and usage
    3. Your free tier includes **5,000 requests per month**
  </Step>
</Steps>


# Vapi AI MCP server integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/vapi

Connect Vapi AI voice agents to the Bright Data MCP server (60+ tools) to give voice assistants real-time web search, scraping and structured data retrieval.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Watch the demo

<iframe title="YouTube video player" />

## Quick Install

To integrate Bright Data into Vapi AI, add the following MCP server URL to your Vapi tools:

```http theme={null}
https://mcp.brightdata.com/sse?token=YOUR_API_KEY
```

## How to set up Vapi AI

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [A Vapi AI account](https://vapi.ai) (sign up if you don't have one)
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs) (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `unlocker` url parameter variable in your configuration
    </Tip>
  </Step>

  <Step title="Login to Vapi AI">
    Navigate to [vapi.ai](https://vapi.ai) and log in to your account.
  </Step>

  <Step title="Claim Your Bright Data API Key">
    Log in to your Bright Data account and navigate to the [user settings page](https://brightdata.com/cp/setting/users) to retrieve your API key.
  </Step>

  <Step title="Access Tools in Vapi">
    In your Vapi dashboard, click on **Tools** in the navigation menu.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Create a New Tool">
    Click on **Create tool** button to start adding the Bright Data MCP integration.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Choose MCP">
    Select **MCP** as the tool type from the available options.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Configure the MCP Server">
    Configure your tool with the following settings:

    * **Name**: `brightdata`
    * **MCP Server URL**: `https://mcp.brightdata.com/sse?token=YOUR_API_KEY`
    * Set the timeout to 120 seconds to avoid getting errors.

    Replace `YOUR_API_KEY` with your actual API token from Bright Data.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Add Tool to Assistant">
    Navigate to your assistant settings and add the newly created Bright Data tool to enable the integration.

    <img alt="Setup Guide" />
  </Step>

  <Step title="Test the Integration">
    Verify the integration works correctly by:

    * Testing through the Vapi chat interface
    * Making a test web call to your assistant

    You should see the Bright Data tools available and responding to your requests.

    <img alt="Setup Guide" />
  </Step>
</Steps>

## What's Next?

Now that you've integrated Bright Data with Vapi AI, you can:

* Use web scraping capabilities directly in your voice AI conversations
* Use [Vapi's workflows](https://docs.vapi.ai/workflows/quickstart) for creating more complex voice AI agents
* Access real-time data from various sources
* Enhance your assistant with powerful data collection features

For more information about Bright Data's MCP capabilities, visit the [Bright Data documentation](https://brightdata.com/products/web-scraper/mcp).


# VS Code MCP server integration
Source: https://docs.brightdata.com/products/mcp-server/integrations/vscode

Connect VS Code MCP-enabled chat to the Bright Data MCP server (60+ tools) to give GitHub Copilot real-time web search, scraping and structured data tools.

<Card title="Building an AI startup?" href="https://brightdata.com/ai/ai-startups-program" icon="rocket-launch">
  You might be eligible for our Startup Program. Get fully funded access to the infrastructure you're reading about right now (up to \$20K value).
</Card>

## Quick Install

Click the button below to automatically install and configure the Bright Data MCP server in VS Code:

## Self-hosted MCP

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have the following:

    * [Node.js ](https://nodejs.org/en/download) is installed and up to date
    * [A Bright Data account](https://brightdata.com/?hs_signup=1\&utm_source=docs)  (new users get free credit for testing, and then you can pay as you go)
    * **An API key** from the [user settings page](https://brightdata.com/cp/setting/users) (New users receive an **API key** in the welcome email.)

    <Tip>
      If you prefer to use a different zone name, you can specify it with the `WEB_UNLOCKER_ZONE `environment variable in your configuration
    </Tip>
  </Step>

  <Step title="Basic Configuration">
    Click on the Vs code logo to automatically install the Bright Data MCP:

    <a href="vscode:mcp/install?%7B%22name%22%3A%22the-web-mcp%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22%40brightdata%2Fmcp%22%5D%2C%22env%22%3A%7B%22API_TOKEN%22%3A%22%24input%3Aapi-token%22%7D%7D">
      <img alt="Install in VS Code" title="" />
    </a>
  </Step>
</Steps>


# Billing
Source: https://docs.brightdata.com/general/account/billing-and-pricing/billing

Understand how Bright Data billing works in 4 areas: monthly commitments, pay-as-you-go funds and how usage limits apply to your account.

<Info>
  All of the prices posted on our website are the US Dollar prices
</Info>

<AccordionGroup>
  <Accordion title="How Bright Data billing works?">
    **A minimum monthly commitment** - Each plan requires you to commit to paying a minimum amount at the beginning of every month while your account is in “active” status. This minimum commitment will set the limits for your basic usage: once your usage goes over your minimum commitment amount, you will need to add additional funds to keep using Bright Data.

    <Note>
      Learn more at our [pricing page](https://brightdata.com/pricing).
    </Note>
  </Accordion>

  <Accordion title="How do I re-verify my account to clear a billing issue?">
    If your account was blocked, you will immediately receive an email explaining how to resolve the issue. Contact your dedicated account manager or Bright Data's compliance team at [compliance@brightdata.com](mailto:compliance@brightdata.com). To reinstate your blocked account, you will need to provide the following:

    <Tabs>
      <Tab title="Registered Companies">
        * A company registration form
        * A photo of the flagged payment method
      </Tab>

      <Tab title="Non Registered Companies">
        * Photo ID, driver's license, or passport
        * A photo of the flagged payment method
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How does the Bright Data billing cycle work if I am only using data-center IPs?">
    When customers only use data-center IPs, we calculate their cost on a daily basis. We subtract this daily cost from the current balance in your account, showing the remaining balance available for use. Costs are calculated according to the IP types used (shared vs. dedicated), as well as bandwidth/GB used. We also calculate any additional costs for added features (like exclusive time or dedicated domain/host).\
    You will be billed for the costs described above on the 1st of every month. The balance remaining in your account will reflect the amount available for future use.
  </Accordion>

  <Accordion title="How does the Bright Data billing cycle works?">
    Bright Data's billing cycle starts on the 1st of each month. This means that you will be billed for your monthly account commitment automatically at the 1st of every month as long as your account status is active.
  </Accordion>

  <Accordion title="What happens if I join Bright Data in the middle of the billing cycle (in the middle of the month)?">
    If you join Bright Data in the middle of the month, your first minimum account commitment payment will be charged on the day you join and usage will retroactively apply only to the days in which your account was active during the month.

    **Example**: You join the Bright Data Residential Network on the June 25th, your price plan has a \$500 minimum monthly commitment and you make your first payment of \$500.

    What will happen on July 1st?

    * Bright Data will see your account was active for only 6 days during June which are 20% of the month, so the relative part of the minimum monthly commitment will be \$100. Unless the cost of your usage was higher than that, \$100 will be your cost for June.
    * We will send you an invoice and take \$100 from your balance against June cost, leaving your balance with \$400.
    * Since on the 1st of every month your balance needs to comply with your minimum monthly commitment, we will now charge your credit card for \$100 in order to top it back to \$500 to comply with your minimum monthly commitment for July.
  </Accordion>

  <Accordion title="Will I receive an invoice?">
    Yes. You will receive an invoice by the third Israeli business day of the month. The invoice will provide details of your previous month's usage. It will breakdown how your usage related to your minimum account commitment (and if applicable, any additional funds that were added during the course of the month).
  </Accordion>

  <Accordion title="What is the time zone used for my billing cycle?">
    All billing calculations are made according to our dashboard timezone which is UTC+0. How this can effect your billing? You have the option to enable and disable your Zones. The time of enabling/disabling will be in UTC time therefore the daily charges will be applied accordingly.
  </Accordion>

  <Accordion title="I will not be using Bright Data on a daily basis but on a per-project basis. Do I still need to pay the entire minimum monthly commitment?">
    ### Proxy services billing

    Proxy services are either prepaid per amount of proxies (IP addresses) or per usage.

    | Network type | Proxy type | Payment type | Notes |
    | - | - | - | - |
    | Datacenter | Shared pool | per GB | No usage: no payment. |
    | Datacenter | Shared unlimited | Prepaid per IP | Resumes monthly by default |
    | Datacenter | Dedicated unlimited | Prepaid per IP | Resumes monthly by default |
    | ISP | Shared pool | per GB | No usage: no payment. |
    | ISP | Shared unlimited | Prepaid per IP | Resumes monthly by default |
    | ISP | Dedicated unlimited | Prepaid per IP | Resumes monthly by default |
    | Residential shared | All: IPv4,IPv4+IPv6, IPv6 | per GB | No usage, no payment |
    | Residential dedicated | Dedicated `gIP`s | Fixed charge per `gIP` + per GB | `gIP` charges resume monthly by default, charged on the 1st, prorated |

    ### Non proxy services

    During time periods where you are not using Bright Data, you can turn off your Zones. Billing for service will only apply for the relative part of the month when the service was active. All billing calculations are made according to our dashboard timezone which is UTC+0. How this can effect your billing? You have the option to enable and disable your Zones. The time of enabling/disabling will be in UTC time therefore the daily charges will be applied accordingly.
  </Accordion>

  <Accordion title="What happens if I process a chargeback dispute?">
    In case you process a credit card chargeback or bank dispute and the reason is unjustified, Bright Data will charge a handling fee of \$150 per charge.
  </Accordion>

  <Accordion title="Why was my account blocked due to billing issues?">
    An account is blocked due to billing issues for one of the following reasons:

    * A discrepancy between payment method and personal details
    * The user has logged in from a country that differs from where the credit card is from
    * Too many attempts to process a declined payment
    * Failure to authenticate a credit card payment using 3D secure
  </Accordion>

  <Accordion title="How to add users to the invoice recipients list?">
    To add an email address to invoice recipients list, please follow the below guide

    <Steps>
      <Step title="Click the &#x22;Billing&#x22; button on the Control Panel sidebar" />

      <Step title="Scroll down the page" />

      <Step title="In the &#x22;Invoice recipients&#x22; screen, click on the &#x22;+ Add new recipient&#x22; button button">
        <Frame>
          <img alt="invoice_recipients_1.png" />
        </Frame>
      </Step>

      <Step title="Add name and email address">
        <Frame>
          <img alt="invoice_recipients_2.png" />
        </Frame>
      </Step>

      <Step title="Click on the &#x22;Add&#x22; button">
        <Frame>
          <img alt="invoice_recipients_3.png" />
        </Frame>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="What if my account is not in “active” status for the entire month?">
    If you have remaining funds in your balance during a month in which you were inactive, you will not lose your balance, but will be charged to bring that balance up to the minimum monthly commitment on the 1st day of the next month.

    <Frame>
      <img alt="suspend-account.gif" />
    </Frame>
  </Accordion>

  <Accordion title="How can I prevent suspension of my account?">
    To ensure that your account is never suspended, we highly recommend that you use our automatic recharging option. It can be activated in the “billing” section of your account and ensures uninterrupted service. Auto recharge starts to work when your available balance drops below 85% of the total account balance. The amount set is entirely up to you and can be of any denomination.

    <Frame>
      <img alt="billing.png" />

      <img alt="payment-settings.png" />

      <img alt="confirm.png" />
    </Frame>
  </Accordion>

  <Accordion title="How does the first deposit matching offer work?">
    When you make your first deposit into your account, we will match it dollar-for-dollar.
  </Accordion>

  <Accordion title="What is the maximum bonus I can receive?">
    We will match your deposit up to a maximum of \$500. For example, if you deposit \$500, you will receive an additional \$500 in promotional credits. If you deposit \$600, you will still receive the maximum of \$500 in credits.
  </Accordion>

  <Accordion title=" Is there a time limit to use the bonus credits?">
    Yes. The matched promotional credits must be used within 90 days from the date they are added to your account.
  </Accordion>

  <Accordion title=" Are there any requirements to keep the bonus credits active?">
    Yes. To maintain the bonus, you must have a minimum account usage of \$5 per month. If your usage drops below this amount, the remaining bonus credits may be forfeited.
  </Accordion>
</AccordionGroup>


# About the Bright Rewards program
Source: https://docs.brightdata.com/general/account/billing-and-pricing/bright-rewards-program

Earn Bright Points each month based on Bright Data spending and redeem them as account credit when adding funds. Higher monthly spend unlocks larger rewards.

## Earn & redeem points

The **Bright Rewards** program allows you to earn **points** based on your monthly spending. The more you use, the more you save!\
Key benefits:

* Earn rewards automatically based on your usage
* Redeem your credits easily when adding funds
* Higher spending unlocks greater rewards

### **How to Redeem Your Bright Rewards**

You have two ways to redeem your Bright Rewards points:\
Go to the [billing section](https://brightdata.com/cp/billing/overview) in the control panel, then:

* Click the "Redeem" button in the Bright Rewards section.

Or

* Use the "Add Funds" button to redeem your points.

<Frame>
  <img alt="earn-and-redeem-points.png" />
</Frame>

<Info>
  For more information [please see here](https://brightdata.com/bright-rewards)
</Info>


# Track your usage with Costs Explorer
Source: https://docs.brightdata.com/general/account/billing-and-pricing/costs-explorer

Use Costs Explorer in the Bright Data Control Panel to track usage and costs across all your APIs. Filter by product, date and proxy in 3 clicks.

## Where to Find the Cost Explorer

You can navigate to the costs explorer using [This Link](https://brightdata.com/cp/billing/costs).
Alternatively you can also easily access the Cost Explore feature in the **Billing** tab on the left bar of the control panel. Afterwards look for the dedicated tab clearly marked **"Cost Explorer"**.

## What the Cost Explorer Offers

The Cost Explore feature provides comprehensive usage statistics, which can be broken down by: each product, each zone, charge types etc. for each day or hour you have used our products during the selected time period.
You can also see a breakdown for funds that were used up by your Datasets and Collectors.
The data can be displayed in line chart, bar chart or table.

This allows you to see exactly where your funds are being allocated.

## How accurate the data is

All the information displayed in the Cost Explorer is accurate and updated in real time. This ensures that you always have the most current data at your fingertips.

## How to customize the view

The Cost Explorer offers extensive customization options, allowing you to tailor the insights to your specific needs. Whether you want to see a detailed breakdown of your usage or a high-level overview, Cost Explorer has you covered.

## Visual and User-Friendly

The data in the Cost Explorer is displayed in a visual, easily readable format. This makes it simple to understand your usage and costs at a glance. These tables and charts are also available for download as .csv files.

## Answering Your Questions

If you have any questions about your usage or wish to better understand your bill, Cost Explorer is the place to go. It provides all the answers you need, making it an invaluable resource for managing your expenses.


# Billing and pricing FAQs
Source: https://docs.brightdata.com/general/account/billing-and-pricing/faqs

FAQs about billing for Bright Data accounts, including credentials, cost structure and API management across 4 proxy network products.

<AccordionGroup>
  <Accordion title="Where can I find my credentials like host name, username and password?">
    Your credentials can be found in the "Overview" tab in each zone that you created.

    1. In the sidebar, click on "Proxies and Scraping" and
    2. You will see a table of all the existing products you have created.
    3. Click on each line to see the credentials for each product.
    4. Click the "Overview" tab and you will see the username and password that you need to access that product.
  </Accordion>

  <Accordion title="Does the cost structure differ by country?">
    No, all countries are charged the same rate per GB.
  </Accordion>

  <Accordion title="Am I been charged differently for different domains?">
    Some domains require special permissions or products.

    In case you are not sure which product to use for your use case, it's best to get your dedicated account manager or support team for a integration session.
  </Accordion>

  <Accordion title="Can I limit my daily usage?">
    Yes.

    In the [Zone](https://brightdata.com/cp/zones) page under the "Usage spent limit" column it is possible to limit your daily usage in 2 ways:

    * Bandwidth(bytes)
    * Money spent(Dollars)

    When you reach your daily limit, the zone is suspended, alerted, or both, depending on your configuration.

    <Frame>
      <img alt="limit-daily-usage.gif" />
    </Frame>

    <Tip>
      The Zone limit is calculated every 15 minutes and will not take effect immediately so a Zone might go over it's limit by 15 minutes of usage.
    </Tip>

    <Note>
      When the load is high statistics calculation may have a delay. In order to manually update the usage-statistics in your Zone, open the Zone by clicking on its name, go to the Statistics table, and press the `recalc` button near the desired date. Wait until the red "Loading..." notification at the top of the screen will disappear, and refresh the page. The stats will then be up-to-date.
    </Note>
  </Accordion>

  <Accordion title="Can I use Bright Data without monthly commitment?">
    Absolutely!

    You can use Bright Data datacenter, ISP, residential, and mobile networks without monthly commitment.\
    Simply click the pencil next to the zone name and adjust the plan to 'Pay-As-You-Go'

    <Note>
      In case the ip type is pay per ip/dedicated type or gips, you will be charged for the ips allocated to the zone.
    </Note>
  </Accordion>

  <Accordion title="Who is eligible for a Free Trial?">
    Everyone who signs up to Bright Data automatically gets a free trial, which can be used for all Bright Data products. Every new account also gets a recurring [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month for the Web Unlocker API, SERP API, Web Scraper API, Scraper Studio and Browser API, which renews monthly.

    For additional details, see [here](/general/faqs#what-is-playground-mode).

    <Info>
      to help with trial configurations.
    </Info>
  </Accordion>

  <Accordion title="Why can't I create a Proxy zone or Web Unlocker API?">
    If you signed up with a personal email and are using the free credit without a payment method on file, access to **Proxy Networks** and **Web Unlocker API** is restricted.

    To unlock these products, [add a payment method](https://brightdata.com/cp/billing_flow). You will **not** be charged, this is for verification only and earns you a **\$5 bonus credit**.

    For full details, see [Payment Verification](/general/account/billing-and-pricing/payment-verification).
  </Accordion>

  <Accordion title="Do you have any Advanced Pricing plans?">
    Yes, our datacenter and ISP plans cover unlimited data volume.

    <Info>
      Contact your account manager for unlimited traffic per month plan information
    </Info>
  </Accordion>

  <Accordion title="How do I manage my billing details?">
    To manage your billing details, visit [https://brightdata.com/cp/billing/settings](https://brightdata.com/cp/billing/settings). There, you can add new payment methods, delete existing ones, set a primary payment method for your account, and configure alerts for your balance.
  </Accordion>

  <Accordion title="What payment methods are supported?">
    Brightdata supports payment through the following methods:

    * Credit Card: VISA, MasterCard, American Express
    * PayPal
    * Alipay
    * Payoneer
    * Google Pay
    * Apple Pay
    * Wire transfer
    * Amazon Marketplace

    We do **not** support payment through cryptocurrencies.
  </Accordion>

  <Accordion title="How is bandwidth calculated? ">
    Bandwidth is calculated based on the data transmitted through the proxy peer. For instance, if a webpage has a size of 100 KB, the billed bandwidth will include this 100 KB along with a minimal additional amount to account for network overhead, such as the TCP handshake and other related operations. Billing is precise and measured down to the megabyte (MB), with no rounding up of bandwidth usage. To see a detailed breakdown of your costs consumption, please see: [Billing Overview](https://brightdata.com/cp/billing/overview) and there click on the 'breakdown' link.

    <Note>
      If a request is passed through the super proxy it will not be billed
    </Note>
  </Accordion>

  <Accordion title="Why am I getting &#x22;payment failed&#x22; errors? ">
    The payment failed error could occur due to several reasons, to see the exact cause in your case you should check your [transactions table](https://brightdata.com/cp/billing/transactions), there you will find instructions on how to resolve your issue.  If you require any further assistance, you can contact or sales department at [sales@brightdata.com](mailto:sales@brightdata.com)
  </Accordion>

  <Accordion title="Why does my promo code does not apply getting &#x22;Reached maximum number of activations&#x22; error?">
    This means that there were too many activations of that promo code. Wait till the next day and try again or contact our support.
  </Accordion>
</AccordionGroup>


# Free tier
Source: https://docs.brightdata.com/general/account/billing-and-pricing/free-tier

Get 5,000 free credits per month, no credit card, across Web Unlocker API, SERP API, Web Scraper API, Scraper Studio and Browser API.

Every new Bright Data account gets **5,000 free credits per month** (\~\$7.50 value), usable across the Web Unlocker API, SERP API, Web Scraper API, Scraper Studio and Browser API. No credit card, no promo code, no commitment.

**The Browser API is also included in the monthly free credits.** The Browser API consumes 5 credits per MB of traffic, so a full 5,000-credit allowance gives you nearly 1 GB of free Browser API traffic every month.

## What is the Bright Data free tier?

The free tier is a recurring monthly credit allowance that applies automatically to every new account. Credits renew on the first of each month and draw from a single shared pool, so you can spend them on any combination of the eligible products. The Web Unlocker API, SERP API and Web Scraper API cost one credit per request or record. Scraper Studio draws from the same pool and costs one credit per page load. The Browser API draws from the same pool at 5 credits per MB of traffic.

Bright Data operates on a **pre-paid wallet model**: you are only ever charged for funds you have explicitly deposited. A free tier account has a hard stop when credits are exhausted, never a surprise bill.

## What can I use the free credits on?

| Product | What it does |
| - | - |
| **Web Unlocker API** | Retrieve any web page, bypassing anti-bot protections automatically. |
| **SERP API** | Extract structured search results from Google, Bing and more. |
| **Web Scraper API** | Get structured data from popular websites using pre-built, maintained scrapers. |
| **Scraper Studio** | Build and run custom scrapers in a cloud IDE or with an AI agent. One credit per page load, not per record. |
| **[Browser API](/products/scraping-browser/introduction)** | Run Puppeteer, Playwright or Selenium scripts on Bright Data's cloud browsers with unblocking built in. Included at 5 credits per MB of traffic. |

<Note>
  Proxy products (Datacenter, ISP and Residential proxies) are **not** included in the monthly free credits. New accounts receive a separate one-time **\$2 trial credit** (valid 7 days) to test the proxy products, plus an additional **\$5 bonus** upon adding a payment method (valid 30 days).
</Note>

## How are free credits consumed?

Free credits are drawn from a **single shared pool of 5,000 credits per account**. The Web Unlocker API, SERP API and Web Scraper API consume one credit per request or record. Scraper Studio draws from the same pool and consumes one credit per page load, so its consumption depends on how many pages each scraper loads. The Browser API consumes 5 credits per MB of traffic, so its consumption depends on how much data each browser session transfers. Usage is metered and deducted from the same pool, regardless of which product made the call.

The Control Panel shows in real time whether you are drawing from free credits or your deposited balance.

<Note>
  Bright Data MCP server requests also draw from this pool. The MCP free tier of 5,000 requests per month is the same shared allowance, because the MCP server runs on the Web Unlocker API.
</Note>

<Note>
  Unused free credits do not roll over to the next month. Credits reset to 5,000 on the first of each month.
</Note>

## What happens when free credits run out?

There are two outcomes, depending on whether you have deposited funds:

* **With funds in your account:** usage transitions automatically to your pre-paid balance at your plan's PAYG rates. There is no interruption in service.
* **Without funds:** requests return an error and you are prompted to add funds to continue.

In both cases, your 5,000 free credits renew on the first of the following month.

<Note>
  Accounts operating on the free tier (unfunded) are restricted to a default rate limit of 1,000 requests per minute across the SERP API, Web Unlocker API and Proxy products. You can view this limit in the Control Panel, under the zone's Overview tab > Access details. This rate limit is automatically removed once you add funds to your account.
</Note>

### How do I keep service running after free credits?

Enable **auto-recharge** in your billing settings to ensure uninterrupted service. Auto-recharge triggers when your available balance drops below 85 percent of your configured amount and tops it back up automatically. You can set any denomination. Configure it in [Billing Settings](https://brightdata.com/cp/billing/settings).

## Who is eligible for the free tier?

The free tier is available to **all new accounts** and is applied automatically at signup.

The following account types are **not** eligible:

* Accounts on custom PAYG pricing plans
* Accounts on pre-commit (subscription) plans

<Note>
  If you upgrade to a pre-commit plan, recurring monthly free credits will no longer be issued. Any remaining unused free credits at the time of upgrade remain available to use.
</Note>

<Note>
  Adding a credit card is a verification step only. You will not be charged unless your free credits are exhausted and you have funds deposited in your account.
</Note>

## How do I monitor my free credit usage?

Track your free credit balance and consumption directly in the Control Panel:

1. Go to [Billing Overview](https://brightdata.com/cp/billing/overview).
2. The **Free Tier Credits** section displays your remaining credits and next renewal date.
3. To set up balance threshold alerts, go to [Billing Settings](https://brightdata.com/cp/billing/settings).

## How do I get support on a free tier account?

Free tier accounts can open a ticket with Bright Data Support or get help from **Sophie**, Bright Data's AI assistant. Both are available in the Control Panel.

## FAQ

### How many requests do 5,000 free credits cover?

One credit equals one request for the Web Unlocker API and SERP API, and one delivered record for the Web Scraper API, so your 5,000 monthly free credits cover up to 5,000 requests or records in any combination across these three products. Scraper Studio also draws from the pool and consumes one credit per page load, so its credit consumption depends on how many pages each scraper loads rather than a per-record rate. The Browser API consumes 5 credits per MB, so a full 5,000-credit allowance covers 1,000 MB, nearly 1 GB, of Browser API traffic.

### Do free credits roll over?

No. Credits reset to 5,000 on the first of each month. Unused credits are forfeited.

### Will I be charged automatically when credits run out?

No. If you have no deposited funds, a hard stop is applied and no charges will occur. If you have pre-deposited funds, usage continues against your balance at standard PAYG rates. Enable [auto-recharge](https://brightdata.com/cp/billing/settings) to replenish your balance automatically.

### Can I use the free tier for the Browser API?

Yes. The Browser API draws from the same shared pool of 5,000 monthly free credits at 5 credits per MB of traffic. Spend the whole allowance on the Browser API and it gives you nearly 1 GB of free traffic every month.

### Can I use the free tier for proxies?

No. Datacenter, ISP and Residential proxies are not covered by the monthly free credits. A separate one-time \$2 trial credit is available for the proxy products upon signup, with an additional \$5 bonus when you add a payment method.

### Can I use the free tier for Scraper Studio?

Yes. Scraper Studio is covered by the monthly free credits and draws from the same shared pool of 5,000 credits. In the free tier, Scraper Studio consumes one credit per page load, so credit consumption depends on how many pages your scrapers load rather than a per-record rate.

### What happens to unused credits if I upgrade to a pre-commit plan?

Recurring monthly free credits stop upon upgrading. Any remaining unused credits at the time of upgrade can still be consumed.

### Can I combine free credits with a promo code?

Yes. Free credits are consumed first. Promo code discounts apply to any PAYG usage that follows.

### How do I start using PAYG after the free tier?

Add funds to your account from the [Billing page](https://brightdata.com/cp/billing). There is no minimum commitment. You stay on PAYG and only pay for what you use.

## Related pages

* [Accepted payment methods](/general/account/billing-and-pricing/payment-methods)
* [Billing](/general/account/billing-and-pricing/billing)
* [Bright Data promo codes](/general/account/billing-and-pricing/promo-codes)


# Payment
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment

FAQs on payments for Bright Data accounts across 3 areas: prepayment, automatic recharging and the accepted payment methods on the platform.

<Info>
  All of the prices posted on our website are the US Dollar prices
</Info>

<AccordionGroup>
  <Accordion title="Do I need to sign in online to deposit the prepayment funds?">
    Yes, we send a prepayment billing request to your email which can be completed from the [billing page](https://brightdata.com/cp/billing).
  </Accordion>

  <Accordion title="How does automatic recharging work?">
    Users choose between 2 types of payment schedules:

    <Tabs>
      <Tab title="Monthly recharge">
        If you do not use automatic recharge or decide to turn it off, you will be charged on the 1st of each month for your new month's monthly commitment. If you don't have a plan with a minimum monthly commitment and are using the Pay as you go plan, your account will not be automatically recharged.
      </Tab>

      <Tab title="Recharge at a preset amount">
        When you choose this option, you will manually set a charged amount when your balance runs low (at 25% of the configured amount).

        For example, if you choose `$100`, you will be charged `$100`, and then you will get charged `$100` again when your balance reaches `$25`.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="What is your Payment Verification process?">
    Bright Data maintains high compliance standards based on the principles of deterrence, prevention, and enforcement of malicious activities to ensure that our network is both safe for customers and ethical. It is for this reason that we are requesting that you identify yourself using your preferred payment method. We will perform a per-authorization charge and reward you with an additional \$5 bonus for your help and cooperation.

    These authorizations happen so Bright Data can make sure the card is valid, and check that you have enough funds in your account to make the purchase.

    These are authorization requests and not charges. You don't pay for authorizations.

    Authorizations may stay in your account for 1-14 business days depending on your bank. If you still see the pending authorization after 14 business days, contact your bank for more information.
  </Accordion>

  <Accordion title="How many Zones can I open in my Bright Data account?">
    You can open up to 50 Zones in your Bright Data account, free of charge. Each extra Zone will cost \$5/month
  </Accordion>

  <Accordion title="Can I get a refund?">
    Generally - No, the subscription fees are non-refundable. But, exceptions can be made for specific cases - If you believe you are eligible for a refund you can request one by contacting the Bright Data support team or your account manager. Any funds that were added as a promotional bonus  not eligible for refund.
  </Accordion>
</AccordionGroup>


# Accepted payment methods
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment-methods

Add funds to Bright Data with credit card, PayPal, Alipay, Payoneer, Google Pay or Apple Pay, plus wire transfer and Amazon Marketplace for larger accounts.

<Tabs>
  <Tab title="PayPal">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;PayPal&#x22; as your payment method.">
        You will then be redirected to PayPal page.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Alipay">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;Alipay&#x22; as your payment method.">
        You will then be redirected to Alipay page.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Payoneer">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;Payoneer&#x22; as your payment method.">
        You will then be redirected to Payoneer page.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Credit Card">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;Credit Card&#x22; as your payment method.">
        Now you can click the `Add Balance` button and make a payment with your credit card.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Google Pay">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add funds`.
      </Step>

      <Step title="Select &#x22;Google Pay&#x22; as your payment method.">
        Complete the payment in the Google Pay prompt.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Apple Pay">
    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add funds`.
      </Step>

      <Step title="Select &#x22;Apple Pay&#x22; as your payment method.">
        Complete the payment in the Apple Pay prompt.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Wire transfer">
    <Warning>
      Wire transfer payments are only available after a payment of \$5,000 is made.
    </Warning>

    <Steps>
      <Step title="Go to the billing page">
        [Billing Page](https://brightdata.com/cp/billing) > Click on `Add Payment Method`.
      </Step>

      <Step title="Select &#x22;Other&#x22; as your payment method." />

      <Step title="Select the &#x22;Wire transfer&#x22; option as your payment method.">
        Now you can click the "Add Balance" button and make a payment with Wire transfer.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Amazon Marketplace">
    You can also buy subscription using Amazon Marketplace.

    To purchase the subscription via Amazon Marketplace, please send your account manager your Amazon marketplace ID (i.e. buy an Amazon Marketplace contract, follow the link, do not signup a new Bright Data account, instead, just send your ID). Your account manager will update the Amazon Marketplace ID on your account.

    <Warning>
      There a few limiation when you purchase a subscription using the Amazon Marketplace

      * You will be allowed to use only products purchased via Amazon marketplace.
      * We do not support paying for Cloud Proxy Manager via Amazon Marketplace.
      * All other payment methods will be removed from your account.
      * Auto-recharge will not be available
    </Warning>
  </Tab>
</Tabs>

<Note>
  To ensure your payment goes through smoothly, please disable any ad blockers before proceeding.
</Note>


# Payment method verification
Source: https://docs.brightdata.com/general/account/billing-and-pricing/payment-verification

Why a payment method is required to access Proxy Networks on a free trial across 4 product lines, and how to add one in 2 steps.

## Overview

When you sign up for Bright Data with a **personal email address** you receive a **free credit** to explore Bright Data. Certain products require you to **add a valid payment method** before you can create or use them.

<Note>
  Adding a payment method **does not trigger a charge**. It is used solely for identity verification and to unlock full product access.
</Note>

## Who is affected?

This requirement applies if **all** of the following are true:

| Condition | Detail |
| - | - |
| **Email type** | You signed up with a personal / freemail domain |
| **Payment status** | No valid payment method is on file, you are using the free credit only. |

<Tip>
  Users who signed up with a **business email** or who already have a payment method on file are **not** affected and can use all products immediately.
</Tip>

## Which products are gated?

| Gated products (payment method required) | Available on free credit |
| - | - |
| Residential Proxy | SERP API |
| Mobile Proxy | Web Unlocker API |
| ISP Proxy | Browser API |
| Datacenter Proxy | Scrapers |
| | Datasets Marketplace |
| | Scraper Studio |

## What you will see in the Control Panel

### Zone Creation Wizard - Create Proxy

When creating a **Proxy zone**, the wizard includes an additional step:

<Steps>
  <Step title="Configure your zone">
    Choose your product type and assign a name as usual.
  </Step>

  <Step title="Set zone options">
    Configure any additional settings (geolocation, IP type, etc.).
  </Step>

  <Step title="Add payment method">
    Instead of the usual **Create Proxy** button, you will see **Add payment method**. Clicking it opens the payment method form.
  </Step>

  <Step title="Finalize creation">
    Once a valid payment method is saved, your zone is created automatically. If you leave the payment flow without completing it, the zone is **not** created, but your configuration is saved so you can resume later.
  </Step>
</Steps>

<Warning>
  Your zone will **not** be created until a payment method is successfully added.
</Warning>

### Network Dropdown - SERP API / Browser API configuration

If you are configuring an **allowed** product (SERP API or Browser API) and attempt to switch the underlying network to a gated product, the restricted networks appear **grayed out** in the dropdown:

* Residential
* Mobile
* ISP
* Datacenter

Hovering over a grayed-out option displays a tooltip:

> **"Add a payment method to unlock this product."**

The tooltip includes a link that opens the payment method form directly.

### Trial Credit Modal - "See Details"

In the credit breakdown modal, gated products display a **"Payment method required"** badge next to:

* **Proxy Networks** (covers Residential, Mobile, Datacenter, ISP)

The modal footer includes an **"Add payment method"** button (primary style) alongside the existing "Got it" button.

## How to add a payment method

<Steps>
  <Step title="Go to the Billing page">
    Navigate to [Billing Settings](https://brightdata.com/cp/billing/settings) or click **Add payment method** from any of the prompts described above.
  </Step>

  <Step title="Choose a payment method">
    Select one of the supported methods: **Credit Card**, **PayPal**, **Alipay**, **Payoneer**, **Google Pay** or **Apple Pay**. For details, see [Accepted Payment Methods](/general/account/billing-and-pricing/payment-methods).
  </Step>

  <Step title="Complete verification">
    Follow the on-screen steps. A temporary pre-authorization may appear on your statement, this is **not** a charge and will be released by your bank within 1–14 business days.
  </Step>

  <Step title="Access unlocked">
    After verification you will:

    * Have full access to **all** Bright Data products
    * Receive a **\$5 bonus credit**
    * Be upgraded to the **30-day Limited Trial**
  </Step>
</Steps>

## FAQs

<AccordionGroup>
  <Accordion title="Will I be charged when I add a payment method?">
    No. Adding a payment method triggers a temporary pre-authorization only. You are not charged until you actively add funds or set up auto-recharge.
  </Accordion>

  <Accordion title="I signed up with Gmail, can I change to a business email?">
    Yes. Go to **Account Settings** and update your email. Once verified with a business domain, the gating restriction is removed even without a payment method.
  </Accordion>

  <Accordion title="What happens to my free credit after I add a payment method?">
    Your existing free credit remains available **plus** you receive an additional \$5 verification bonus. Your trial is also extended to 30 days.
  </Accordion>

  <Accordion title="I started creating a zone but didn't finish adding payment, is my config lost?">
    No. Your zone configuration is saved. When you return and successfully add a payment method, the zone creation completes automatically.
  </Accordion>
</AccordionGroup>


# Premium IPs (deprecated)
Source: https://docs.brightdata.com/general/account/billing-and-pricing/premium-ips

Premium IPs are deprecated and no longer offered by Bright Data. Use 1 of 4 alternatives (Datacenter, ISP, Residential or Mobile) for equivalent IP quality.



# Bright Data promo codes
Source: https://docs.brightdata.com/general/account/billing-and-pricing/promo-codes

Find and apply Bright Data promo codes in 3 steps to get exclusive discounts on subscription plans, products and services across the platform.

Bright Data offers promo codes to save money on your subscription plans. You can get exclusive discounts on specific products or services by applying a promo code. This guide will show you everything you need to know about the promo codes.

## How to Apply a Promo Code

To apply a promo code to your subscription plan, follow the steps below:

### Step 1. Go to the Billing page

<Steps>
  <Step title="Go to the Bright Data website">
    Visit [Bright Data](https://brightdata.com/cp/start) page and sign in to your account.
  </Step>

  <Step title="Go to the &#x22;Billing&#x22; page">
    Click on the [Billing](https://brightdata.com/cp/billing) page on the left navigation bar.

    <Frame>
      <img alt="billing-button" />
    </Frame>
  </Step>
</Steps>

### Step 2. Apply the Promo Code

You can choose to apply the promo code in one of two ways:

<Tabs>
  <Tab title="Pay as you go plan">
    <Steps>
      <Step title="Click on &#x22;Apply a promo code&#x22;">
        <Frame>
          <img alt="click-on-apply-promo-code" />
        </Frame>
      </Step>

      <Step title="Enter the Promo Code">
        To activate the promotion, enter your code in the “Enter promo code” field, then click “Apply.”

        <Frame>
          <img alt="enter-promo-code" />
        </Frame>
      </Step>

      <Step title="Congratulations 🎉">
        You have successfully activated the promo code, and your new discounted rates have been applied to your plan.

        <Frame>
          <img alt="payg-promo-added.png" />
        </Frame>
      </Step>

      <Step title="View Updated Pricing">
        You can confirm the changes by going to the “Overview” tab on the “Billing” page, under “Your products” > “All Products,” to view the discounted prices for the relevant product(s). Or you can simply open a zone and get started!

        <Frame>
          <img alt="payg-confirm-discount" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Subscription plan">
    <Steps>
      <Step title="Click on &#x22;Change Plan&#x22;">
        In [Overview](https://brightdata.com/cp/billing/overview) tab, click on the [Change Plan](https://brightdata.com/cp/pricing_packages) button.

        <Frame>
          <img alt="change-plan" />
        </Frame>
      </Step>

      <Step title="Select the Subscription">
        Select the subscription plan of your choice and click on the "Upgrade" button.

        <Frame>
          <img alt="subscription-plans" />
        </Frame>
      </Step>

      <Step title="Enter the Promo Code">
        To activate the promotion, enter your code in the “Enter promo code” field, then click “Apply.” Once you see confirmation of the promo code’s validity, click “Pay & Confirm Upgrade."

        <Frame>
          <img alt="apply-promo-code" />
        </Frame>
      </Step>

      <Step title="Congratulations 🎉">
        You have successfully activated the promo code, and your new discounted rates have been applied to your plan.

        <Frame>
          <img alt="sub-promo-added.png" />
        </Frame>
      </Step>

      <Step title="View Updated Pricing">
        You can confirm the changes by going to the “Overview” tab on the “Billing” page, under “Your products” > “All Products,” to view the discounted prices for the relevant product(s). Or you can simply open a zone and get started!

        <Frame>
          <img alt="sub-confirm-discount" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## FAQs

<AccordionGroup>
  <Accordion title="Do the promo codes work with the 'dollar-for-dollar' first deposit matching promo?">
    Yes, you can use both a promo code and the dollar-for-dollar matching promotion together.

    The promo code will be applied directly to your subscription plan, reducing the cost of your plan. Additionally, we will match your first deposit dollar-for-dollar, up to \$500. The matched promotional credits are valid for 90 days. To maintain the bonus, a minimum monthly usage of \$5 is required.

    <Note>
      The matching dollar for dollar credit works for the first deposit only.
    </Note>
  </Accordion>
</AccordionGroup>


# Account management FAQs
Source: https://docs.brightdata.com/general/account/faqs

FAQs on Bright Data account management across 4 topics: how to re-verify, delete your account, and manage subscriptions on the platform.

<AccordionGroup>
  <Accordion title="How do I re-verify my account to clear a billing issue?">
    There are certain requirements that must be met before you’re allowed to deactivate or delete your Bright Data account. If you are unable to deactivate your account, please make sure all of the following conditions are satisfied:

    * **You must be the account owner:** Only the person who originally opened the account (the "owner") has the ability to delete it.
    * **It is not a Bright Data internal account:** (This is mostly relevant to internal use and not regular customers.)
    * **All bills must be paid:** Your account must have no outstanding payments or unpaid invoices.
    * **Real balance is exactly zero:** Your account’s real balance should be exactly \$0, no positive or negative balances. Note: Bonuses are not counted toward your real balance. Credits, often considered as a "loan" in some cases, may be treated differently; ensure your real balance is zero according to your billing section.
    * **No active long-term subscriptions (LTS):** If you have an ongoing LTS, you must cancel or complete it before deactivating your account.
    * **No monthly commitments:** Any monthly service commitments must be completed or canceled.
    * **No pending costs:** Your account should have no pending or unbilled usage ("pending costs"). For clarification of what qualifies as pending costs, please check your billing section or contact our support.

    If you are the account owner and you have met all the above criteria but still cannot deactivate your account, please contact our support team for further assistance.If your account was blocked, you will immediately receive an email explaining how to resolve the issue. Contact your dedicated account manager or Bright Data's compliance team at [compliance@brightdata.com](mailto:compliance@brightdata.com). To reinstate your blocked account, you will need to provide the following:

    <Tabs>
      <Tab title="Registered Companies">
        * A company registration form
        * A photo of the flagged payment method
      </Tab>

      <Tab title="Non Registered Companies">
        * Photo ID, driver's license, or passport
        * A photo of the flagged payment method
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Why was my account is suspended due to billing issues?">
    Bright Data may suspend your account (which prevents access to any zones in it) due to billing issues for one of the following reasons:

    * A discrepancy between payment method and personal details
    * The user has logged in from a country that differs from where the credit card is from
    * Too many attempts to process a declined payment
    * Failure to authenticate a credit card payment using 3D secure

    To enable your account again and exit the suspension state, review your billing details and fix missing or incorrect information. Once billing is resumed, your account will be active again automatically. If from some reason it doesn't - contact your account manager.
  </Accordion>

  <Accordion title="Why was my account is disabled?">
    Bright Data disables (note: disabled account differs from a suspended account) accounts that have been idle for 12 months. To re-enable your account you need to reach out to our staff, either through the Help & Support section in the control panel.
  </Accordion>

  <Accordion title="How can I set up a password for my account?">
    * Visit [https://brightdata.com/cp/setting/auth](https://brightdata.com/cp/setting/auth).
    * In the "Setup a password" section, enter your desired password.
    * Ensure your password includes digits, uppercase and lowercase letters, and at least one special character.
    * Confirm your password by re-entering it.
    * Click "Save password."
    * If prompted, enter your 2FA code to verify the action.
  </Accordion>

  <Accordion title="Why am I not receiving a password reset email?">
    <Note>
      If your organization has configured **enforced SSO** (via Microsoft Entra ID, Okta, or Google Workspace), password reset emails are **not** sent. Password-based authentication is disabled for accounts with enforced SSO.

      Sign in through your organization's identity provider instead:

      * **Microsoft Entra ID**: enter your email on the Bright Data login page; you'll be redirected to Entra automatically.
      * **Okta**: sign in via your Okta dashboard or the Bright Data Okta tile.
      * **Google Workspace**: use the "Sign in with Google" option on the Bright Data login page.

      Contact your account administrator if you need access restored. See also:

      * [Set up Azure SSO (Entra ID) with Bright Data](/general/authentication/How_to_set_up_Azure_SSO_Entra_ID_with_Bright_Data)
      * [Set up Okta SSO with Bright Data](/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data)
      * [Set up SSO with Google Workspace in Bright Data](/general/authentication/How_to_set_up_SSO_with_Google_Workspace_in_Bright_Data)
    </Note>

    If your account does **not** have enforced SSO and you're still not receiving a reset email:

    * Check your spam/junk folder.
    * Verify the email address on file at [Account settings → Profile](https://brightdata.com/cp/setting/customer_details).
    * Make sure your email provider isn't rate-limiting or blocking mail from `sendgrid.net` / Bright Data domains.
    * Contact [Bright Data support](https://brightdata.com/contact) if the issue persists.
  </Accordion>

  <Accordion title="How to add users to the invoice recipients list?">
    To add an email address to invoice recipients list, please follow the below guide

    <Steps>
      <Step title="Click the &#x22;Billing&#x22; button on the Control Panel sidebar" />

      <Step title="Click on &#x22;More ...&#x22; button on the top" />

      <Step title="In the opened menu, select &#x22;Invoice recipients&#x22;">
        <Frame>
          <img alt="invoice_recipients_1.png" />
        </Frame>
      </Step>

      <Step title="Inside the opened &#x22;Invoice recipients&#x22; screen, click on the &#x22;+ Add new recipient&#x22; button button">
        <Frame>
          <img alt="invoice_recipients_2.png" />
        </Frame>
      </Step>

      <Step title="Add name and email address" />

      <Step title="Click on the &#x22;Add&#x22; button">
        <Frame>
          <img alt="invoice_recipients_3.png" />
        </Frame>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="What if my account is not in “active” status for the entire month?">
    If you have remaining funds in your balance during a month in which you were inactive, you will not lose your balance, but will be charged to bring that balance up to the minimum monthly commitment on the 1st day of the next month.

    <Frame>
      <img alt="suspend-account.gif" />
    </Frame>
  </Accordion>

  <Accordion title="How can I prevent suspension of my account?">
    If your account suspended due to insuffecient funds, you can always charge funds to your account and the suspension will be removed immediately.

    To ensure that your account is never suspended, we highly recommend that you use our automatic recharging option. It can be activated in the “billing” section of your account and ensures uninterrupted service. Auto recharge starts to work when your available balance drops below 85% of the total account balance. The amount set is entirely up to you and can be of any denomination. You can find the auto recharge section [here](https://brightdata.com/cp/billing/settings).

    <Frame>
      <img alt="billing.png" />

      <img alt="payment-settings.png" />

      <img alt="confirm.png" />
    </Frame>
  </Accordion>

  <Accordion title="How can I invite users to my account?">
    To add users to your account follow the instructions:

    1. Navigate to the [Settings page](https://brightdata.com/cp/setting/users)
    2. Click the "New User" button to initiate the user addition process.
    3. Enter the details of the user you want to invite, such as their name and email address.
    4. Choose a permission level for the user from the following options:
       * Admin: Grants access to the entire account, including all settings and configurations.
       * Finance: Limits access to billing and financial pages only.
       * Ops: Provides access to the products but restricts billing access.
       * Limit: Allows the user to modify zone passwords and manage IP allowlists/denylists.
       * User: Grants API usage access without access to billing or product pages.
    5. Confirm and Send Invite: Review the details, confirm the permissions, and send the invite.

    The invitee will receive an email with instructions to join and access the account according to their permission level.

    Once added, the new user will have access to the account according to the granted permission. You can also edit the permissions later if needed.
  </Accordion>

  <Accordion title="Why can't I deactivate my account?">
    There are certain requirements that must be met before you’re allowed to deactivate or delete your Bright Data account. If you are unable to deactivate your account, please make sure all of the following conditions are satisfied:

    * **You must be the account owner:** Only the person who originally opened the account (the "owner") has the ability to delete it.
    * **All bills must be paid:** Your account must have no outstanding payments or unpaid invoices.
    * **Real balance is exactly zero:** Your account’s real balance should be exactly \$0, no positive or negative balances. Note: Bonuses are not counted toward your real balance. Credits, often considered as a "loan" in some cases, may be treated differently; ensure your real balance is zero according to your billing section.
    * **No active long-term subscriptions (LTS):** If you have an ongoing LTS, you must cancel or complete it before deactivating your account.
    * **No monthly commitments:** Any monthly service commitments must be completed or canceled.
    * **No pending costs:** Your account should have no pending or unbilled usage ("pending costs"). For clarification of what qualifies as pending costs, please check your billing section or contact our support.

    If you are the account owner and you have met all the above criteria but still cannot deactivate your account, please contact our support team for further assistance.
  </Accordion>
</AccordionGroup>


# Limited trial account restrictions
Source: https://docs.brightdata.com/general/account/limited-trial-restrictions

How rate limits and balance restrictions apply to Bright Data accounts in Limited Trial mode across 4 products, and how to remove them with verification.

## Overview

Accounts in Limited Trial mode are subject to certain restrictions to prevent abuse and ensure compliance with Bright Data's policies. These restrictions are automatically applied to accounts flagged or operating in Limited Trial mode and can be removed by completing the account verification process.

<Note>
  The "Limited Trial Account Restrictions" described on this page are **not the same as KYC (Know Your Customer) verification**.
  These restrictions only apply to accounts in Limited Trial mode.
</Note>

## Rate limiting restrictions

### Request rate limits

Accounts in Limited Trial mode are restricted to a maximum of **100 requests per minute** across all products.

#### What happens when you exceed the rate limit?

If you exceed this rate limit, your requests will be rejected with an **HTTP 429** error response:

```http theme={null}
HTTP/1.1 429 Too Many Requests
x-brd-err-code: client_10110
x-brd-error: Requests rate from account is too high
x-brd-err-msg: Your limited trial mode account exceeded the allowed rate limits. Reduce requests rate and try again or complete the verification process to remove rate limits.
```

<Warning>
  **You will not be charged for requests that are rejected due to rate limiting.**
</Warning>

#### How to resolve rate limit errors

<Steps>
  <Step title="Reduce your request rate">
    Temporarily reduce your requests to stay under 100 requests per minute while in trial mode.
  </Step>

  <Step title="Complete account verification">
    [Complete the account verification process](https://brightdata.com/cp/account_verification) to remove all rate limiting restrictions.
  </Step>
</Steps>

## Balance addition limits

### Maximum balance top-up

Accounts in Limited Trial mode can only add up to **\$100 to their balance at a time** until verification is completed.

<Info>
  This restriction applies per transaction. After completing verification, you can add any amount to your account balance.
</Info>

### Why this limit exists

The balance addition limit is in place to:

* Prevent fraudulent activity
* Ensure compliance with financial regulations
* Protect Bright Data from potential abuse

## How to remove these restrictions

All Limited Trial restrictions can be removed by completing the account verification process.

<Card title="Complete Account Verification" icon="shield-check" href="https://brightdata.com/cp/account_verification">
  Verify your account to unlock:

  * Unlimited request rates
  * No balance addition restrictions
  * Full access to all Bright Data products
  * Priority support
  * Add more than \$100 payments
</Card>

### Verification process steps

<Steps>
  <Step title="Navigate to Account Verification">
    Visit [https://brightdata.com/cp/account\_verification](https://brightdata.com/cp/account_verification)
  </Step>

  <Step title="Complete identity verification">
    Depending on your use case, you may be asked to provide additional information about your intended usage.
  </Step>

  <Step title="Wait for approval">
    Most verifications are completed instantly, but some may require manual review (1-2 business days).
  </Step>
</Steps>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How long does account verification take?">
    Most account verifications are instant. In some cases, manual review may be required, which typically takes 1-2 business days.
  </Accordion>

  <Accordion title="Can I use Bright Data while waiting for verification?">
    Yes! You can continue using Bright Data services in Limited Trial mode while your verification is being processed, subject to the rate and balance limits described above.
  </Accordion>

  <Accordion title="What if I receive a 429 error after verification?">
    If you continue to receive HTTP 429 errors after completing verification, it may be due to:

    * Domain-specific rate limits (error code: policy\_20220)
    * IP-specific rate limits (error code: policy\_20222)

    Contact [support@brightdata.com](mailto:support@brightdata.com) for assistance.
  </Accordion>
</AccordionGroup>

## Where to read more

* [Account Billing and Pricing FAQs](/general/account/billing-and-pricing/faqs)


# Account management overview
Source: https://docs.brightdata.com/general/account/overview

Manage your Bright Data account: SSL certificates, billing and pricing, team access, user permissions, API keys and security settings from the Control Panel.

<Card>
  <CardGroup>
    <Card title="SSL Certificate" icon="lock" href="/general/account/ssl-certificate">
      Secure your domains with HTTPS encryption using SSL certificates managed through your account.
    </Card>

    <Card title="Users Management" icon="users" href="/general/account/users-management">
      Control team access and permissions to streamline collaboration and ensure data security.
    </Card>

    <Card title="Billing & Pricing" icon="credit-card" href="/general/account/billing-and-pricing">
      View your current plan, track usage, download invoices, and manage payment methods.
    </Card>

    <Card title="Referral Program" icon="gift" href="/general/account/referral-program">
      Invite others and earn rewards, share your referral link and track your bonuses here.
    </Card>

    <Card title="Account Management FAQs" icon="book-open" href="/general/account/faqs">
      Find answers to common questions about managing your account, security, and preferences.
    </Card>

    <Card title="Account Management APIs" icon="code" href="/api-reference/account-management-api">
      Programmatically manage account details, users, and billing through our secure API endpoints.
    </Card>
  </CardGroup>
</Card>


# Referral program
Source: https://docs.brightdata.com/general/account/referral-program

Earn up to 50% of revenue from customers you refer to Bright Data. See how the referral program works, payout terms, and how it differs from affiliates.

Bright Data's referral program offers a straightforward way to earn rewards by introducing others to Bright Data. Here's how it works:

1. **Share Your Referral Link**: After joining the referral program, you'll receive a unique referral link. Share this link with individuals or businesses that could benefit from Bright Data's services.

2. **Earn Commissions**: When someone signs up through your link and subscribes to a paid plan, you earn a commission. Specifically, you'll receive a 50% revenue share, up to \$2,500 per customer.

3. **Receive Account Credits**: Alternatively, you can opt to receive credits to your Bright Data account, with an additional 5% bonus when selecting this option.

**Frequently Asked Questions**

* **How does the Bright Data referral program work?**
  Our referral program allows you to earn by sharing Bright Data with others. Share your unique referral link; when someone you refer signs up and spends \$100, you’ll earn a \$100 credit. Additionally, you can earn a 50% revenue share, up to \$2,500 per customer.

* **Where can I find my referral code?**
  After signing up for the referral program, your unique referral code will be available in your account dashboard. You can copy and share it with potential Bright Data users.

* **How do I earn money with the referral program?**
  You earn in two ways:

  * A \$100 credit when a referred customer spends \$100.

  * A 50% revenue share, up to \$2,500 per customer, as they continue to use Bright Data.

* **Can I track my referral earnings?**
  Yes, you can monitor your referral progress and earnings through your Bright Data account dashboard.

For more information or to join the referral program, visit our [referral page](https://brightdata.com/referral/).

**Referral Program vs. Affiliate Program – What’s the Difference?**
If you’re wondering whether this is the same as Bright Data’s affiliate program – it’s not. Here’s the key distinction:

* **Referral Program**: Ideal for existing users who want to recommend Bright Data to colleagues, friends, or businesses. You earn by directly inviting others to sign up.

* **Affiliate Program**: A broader approach suited for marketers, bloggers, and influencers who promote Bright Data to larger audiences through content, ads, or websites.

If you’re interested in the affiliate program, [click here to learn more](https://brightdata.com/affiliate).


# SSL certificate
Source: https://docs.brightdata.com/general/account/ssl-certificate

Install and use Bright Data's SSL certificate on port 44445 for end-to-end encrypted connections with Residential, Mobile, Unlocker and SERP APIs.

<Note>
  You can use Bright Data products without the SSL certificate:

  1. Using **Bright Data proxy API**. Read more: [API vs. native Access](/api-reference/authentication)
  2. Get your account **verified** with our [KYC process](/products/residential/network-access#kyc-verification)
</Note>

The SSL certificate allows you to establish end-to-end encrypted connections when using [Residential Proxies](/products/residential/introduction), [Web Unlocker API](/products/web-unlocker/introduction) or the [SERP API](/products/serp-api/introduction) in **native** proxy mode.

If you are just doing preliminary testing, you can also proceed without the SSL certificate and use it later.

Using the SSL certificate is straight forward. You download it, and choose how you want to use it in your environment.

## Download the SSL certificate

<Tip>
  Bright Data's current SSL certificate works with proxy port `44445` (introduced July 2026). The old certificates on ports `22225` and `33335` expire on September 25, 2026. See the [root certificate migration guide](/general/account/ssl-certificate-migration).
</Tip>

1. **Right click** on this [link](https://brightdata.com/static/brightdata_proxy_ca.zip) to "save as" the file to your hard drive.
2. **Unzip the file** and choose the certificate to use. Most users - espcially if they are new to Bright Data - should use the **new** SSL certificate.

## Bright Data new SSL Certificate

Bright Data's current SSL certificate is `brightdata_root_ca_44445.crt`, and native proxy connections use port `44445`. It is the certificate to use for all new setups. For a step-by-step move from an older port, see the [root certificate migration guide](/general/account/ssl-certificate-migration).

Port `44445` is required with the new certificate. The old certificates, on ports `22225` and `33335`, expire on September 25, 2026 at 00:00 UTC and cannot be extended or renewed. Traffic still relying on them after that date will fail. Read more in: [FAQ: Which port shall I use](/general/faqs#which-port-shall-i-use-22225-or-33335)

## Using the SSL certificate in your code

If you write scraping code, in most cases, you do not need to install the SSL certificate in your environment. Simply load the SSL certificate in your code. For example, for CURL:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<account-id>-zone-<zone-name>:<zone-password> --cacert <PATH TO CA.CRT> "https://geo.brdtest.com/mygeo.json"
```

You can refer to Bright Data sample code examples in the dashboard for exact syntax.

<Note>
  If curl on Windows fails with `CRYPT_E_REVOCATION_OFFLINE` or `CERT_TRUST_REVOCATION_STATUS_UNKNOWN` on port `44445`, add the `--ssl-revoke-best-effort` flag. See [Windows curl SSL errors on port 44445](/general/account/ssl-certificate-windows-schannel).
</Note>

## Installation of the SSL certificate

In some cases, for example when using some third party tools that don't allow loading the certificate from your hard drive, you still need to install the SSL certificate on your computer.

### Where do I install the certificate?

The SSL certificate needs to be installed **on the host that is running the actual scraping code or application.**

In most cases this is your PC but, if you use a cloud-hosted server to run your code, you need to install the SSL certificate on the server itself.

### How to install the certificate

This takes 2 minutes - simply follow these instructions:

<Tabs>
  <Tab title="Windows">
    * If you didn't do so already, **Right click** on this [link](https://brightdata.com/static/brightdata_proxy_ca.zip) to "save as" the file to your hard drive.
    * Double click the ca.crt file
    * Follow the Windows instructions to install the certificate.
    * Reboot your computer
    * After rebooting, you will be able to connect to Bright Data product you needed (Residential Proxy, Web Unlocker API or SERP API)
  </Tab>

  <Tab title="Chrome">
    * Once you've download the [certificate](https://brightdata.com/static/brightdata_proxy_ca.zip) file (see the instruction on the top of this article)

    <AccordionGroup>
      <Accordion title="Go to Browser settings">
        <Frame>
          <img alt="browser-settings.png" />
        </Frame>
      </Accordion>

      <Accordion title="Go to Privacy and security and click on Security">
        <Frame>
          <img alt="privacy-and-security.png" />
        </Frame>
      </Accordion>

      <Accordion title="Scroll down and click on Manage certificate">
        <Frame>
          <img alt="manage-certificate.png" />
        </Frame>
      </Accordion>

      <Accordion title="Go to Trusted Certification Authorities and click Import">
        <Frame>
          <img alt="trusted-certification-authorities.png" />
        </Frame>
      </Accordion>

      <Accordion title="Click on Next">
        <Frame>
          <img alt="click-next.png" />
        </Frame>
      </Accordion>

      <Accordion title="Click Browse and select the certificate you just downloaded, and click Next">
        <Frame>
          <img alt="click-browse.png" />
        </Frame>
      </Accordion>

      <Accordion title="Select &#x22;Place all certificates in the following store&#x22; and click Next">
        <Frame>
          <img alt="place-all-certificates.png" />
        </Frame>
      </Accordion>

      <Accordion title="Make sure Certificate Store Selected by User is &#x22;Trusted Root Certification Authorities&#x22;, and click Finish">
        <Frame>
          <img alt="trusted-root-certification-authorities.png" />
        </Frame>
      </Accordion>

      <Accordion title="Click OK">
        <Frame>
          <img alt="click-ok.png" />
        </Frame>
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Firefox">
    * Type in the address bar: `about:preferences#advanced`
    * Under “Security” click “View Certificates”
    * Select the authorities tab, and click “Import” button below
    * Browse to the directory you downloaded the certificate file to, select the certificate file and click “Open”
    * In the popup box click the checkbox “Trust this CA to identify websites”
    * Click OK to complete the installation
    * Make sure Bright Data proxy is configured as Firefox's proxy, and browse thru proxy to a protected website
  </Tab>

  <Tab title="Linux">
    * Copy the downloaded certificate file `ca.crt` to the `/usr/local/share/ca-certificates/` folder.
    * Run `sudo update-ca-certificates`. The output of the command should state that 1 certificate was added.
    * Go to an SSL-protected website to check that everything is working as cted.
  </Tab>

  <Tab title="macOS">
    * Double-click the downloaded certificate file. You will see the "Keychain Access" application.
    * Double-click the "luminati.io" certificate to see a popup with certificate settings.
    * Select "Always Trust" in the "When using this certificate" dropdown.
    * Close the popup enter your credentials when asked.
    * Restart your browser and go to an SSL-protected website to check that everything is working as expected.
  </Tab>

  <Tab title="iOS">
    * Open up Safari
    * Navigate to this page and download the certificate using [this link](https://brightdata.com/static/brightdata_proxy_ca.zip), but first read the following two items.
    * Click Install and provide your passcode
    * Click Install in the top right corner and then Done
    * Go to iPhone "Settings"
    * Go to "About"
    * Go to "Certificate Trust Settings"
    * Enable the "luminati.io" certificate
    * You can now go to an SSL-protected website in any browser installed in your system to check that everything is working as expected.
  </Tab>

  <Tab title="Android">
    * Download the following [certificate](https://brightdata.com/static/brightdata_proxy_ca.zip) and save it on your phone.
    * On your phone, look for the downloaded zip through 'My files' and extract it.
    * Go yo Settings > Security and privacy > More security settings
    * Under 'Crednetial storage' click 'Install from device storage'
    * Select 'CA certificate' and click 'Install anyway'
    * Enter your password
    * Select the certificate you extracted from your files and click 'Done'
    * You can now go to an SSL-protected website in any browser installed in your system to check that everything is working as expected.
  </Tab>
</Tabs>

## How to ignore SSL errors?

In some cases you will need to install our certificate or ignore SSL errors in order to get access to specific products or features. In case you are not interested in installing our certificate, you can ignore SSL errors. Check out the following code snippets for different programming languages, the highlighted part is what needs to be added to your code in order to ignore SSL errors.

<CodeGroup>
  ```sh Curl theme={null}
  # Add -k to ignore ssl errors
  curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> -k "http://brdtest.com/myip.json"
  ```

  ```js NodeJS theme={null}
  #!/usr/bin/env node

  const { ProxyAgent, setGlobalDispatcher } = require('undici');

  // Make sure you set rejectUnauthorized to false on the proxy's TLS options
  setGlobalDispatcher(new ProxyAgent({
    uri: 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445',
    requestTls: { rejectUnauthorized: false },
  }));

  (async () => {
    const response = await fetch('http://brdtest.com/myip.json');
    console.log(await response.text());
  })();
  ```

  ```python Python theme={null}
  #!/usr/bin/env python
  print('If you get error "ImportError: No module named \'six\'" install six:\n'+\
      '$ sudo pip install six');

  import sys

  # Make sure you add these two line to ignore ssl error
  import ssl
  ssl._create_default_https_context = ssl._create_unverified_context


  if sys.version_info[0]==2:
      import six
      from six.moves.urllib import request
      opener = request.build_opener(
          request.ProxyHandler(
              {'http': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'}))
      print(opener.open('http://brdtest.com/myip.json').read())

  if sys.version_info[0]==3:
      import urllib.request
      opener = urllib.request.build_opener(
          urllib.request.ProxyHandler(
              {'http': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445',
              'https': 'http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>@brd.superproxy.io:44445'}))
      print(opener.open('http://brdtest.com/myip.json').read())
  ```

  ```cs C# theme={null}
  using System;
  using System.Net;

  class Example
  {
      static void Main()
      {

          // Make sure you add this line to ignore ssl error
          ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;

          var client = new WebClient();
          client.Proxy = new WebProxy("brd.superproxy.io:44445");
          client.Proxy.Credentials = new NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>");
          Console.WriteLine(client.DownloadString("http://brdtest.com/myip.json"));
      }
  }
  ```

  ```ruby Ruby theme={null}
  #!/usr/bin/ruby

  require 'uri'
  require 'net/http'
  require 'net/https'

  uri = URI.parse('http://brdtest.com/myip.json')
  proxy = Net::HTTP::Proxy('brd.superproxy.io', 44445, 'brd-customer-<customer_id>-zone-<zone_name>', '<zone_password>')

  req = Net::HTTP::Get.new(uri)

  # Make sure you add verify_mode => OpenSSL::SSL::VERIFY_NONE
  result = proxy.start(uri.host,uri.port, :use_ssl => uri.scheme == 'https', :verify_mode => OpenSSL::SSL::VERIFY_NONE) do |http|
      http.request(req)

  send

  puts result.body
  ```

  ```java Java theme={null}
  package example;

  import org.apache.http.HttpHost;
  import org.apache.http.client.fluent.*;

  public class Example {
      public static void main(String[] args) throws Exception {
          HttpHost proxy = new HttpHost("brd.superproxy.io", 44445);
          String res = Executor.newInstance()
              .auth(proxy, "brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
              .execute(Request.Get("http://brdtest.com/myip.json").viaProxy(proxy))
              .returnContent().asString();
          System.out.println(res);
      }
  }

  /*In the above example, we are not explicitly ignoring SSL
  I will share with you a short code I wrote that does ignore SSL using JAVA (was taken from cloud proxy manager examples) */

  import java.io.*;
  import java.net.*;
  import java.security.cert.X509Certificate;
  import javax.net.ssl.*;
  import java.util.Base64;

  public class Example {
      public static void main(String[] args) throws Exception {
          // Disable restricted headers for proxy authentication
          System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

          // Set up a TrustManager that does not validate certificate chains
          SSLContext sc = SSLContext.getInstance("SSL");

          TrustManager trust_manager = new X509TrustManager() {
              public X509Certificate[] getAcceptedIssuers() {
                  return null;
              }

              public void checkClientTrusted(X509Certificate[] certs, String authType) {
              }

              public void checkServerTrusted(X509Certificate[] certs, String authType) {
              }
          };
          TrustManager[] trust_all = new TrustManager[] { trust_manager };
          sc.init(null, trust_all, new java.security.SecureRandom());
          HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());

          // Set up the proxy and open a connection
          URL url = new URL("https://geo.brdtest.com/mygeo.json");
          Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("brd.superproxy.io", 44445));
          URLConnection yc = url.openConnection(proxy);

          // Set default Authenticator for proxy authentication
          Authenticator.setDefault(new Authenticator() {
              @Override
              public PasswordAuthentication getPasswordAuthentication() {
                  return new PasswordAuthentication("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>".toCharArray());
              }
          });

          // Read and print the response from the server
          BufferedReader in = new BufferedReader(new InputStreamReader(yc.getInputStream()));
          String inputLine;
          while ((inputLine = in.readLine()) != null)
              System.out.println(inputLine);
          in.close();
      }
  }
  ```

  ```vba VBA theme={null}
  Imports System.Net

  Module Module1
      Sub Main()
        
          ' Make sure you add this line to ignore ssl error
          ServicePointManager.ServerCertificateValidationCallback = Function(se, cert, chain, sslerror) True

          Dim Client As New WebClient
          Client.Proxy = New WebProxy("http://brd.superproxy.io:44445")
          Client.Proxy.Credentials = New NetworkCredential("brd-customer-<customer_id>-zone-<zone_name>", "<zone_password>")
          Console.WriteLine(Client.DownloadString("http://brdtest.com/myip.json"))
      End Sub
  End Module
  ```

  ```php PHP theme={null}
  <?php
  $curl = curl_init('http://brdtest.com/myip.json');
  curl_setopt($curl, CURLOPT_PROXY, 'http://brd.superproxy.io:44445');
  curl_setopt($curl, CURLOPT_PROXYUSERPWD, 'brd-customer-<customer_id>-zone-<zone_name>:<zone_password>');

  // Make sure you add this line to ignore ssl error
  curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0);

  curl_exec($curl);
  ?>
  ```

  ```perl Perl theme={null}
  #!/usr/bin/perl

  use LWP::UserAgent;

  # Make sure you add this line to ignore ssl error
  use IO::Socket::SSL qw( SSL_VERIFY_NONE );

  my $agent = LWP::UserAgent->new();
  $agent->proxy(['http', 'https'], "http://brd-customer-<customer_id>-zone-<zone_name>:<zone_password>\@brd.superproxy.io:44445");
  $agent->ssl_opts(verify_hostname => 0, SSL_verify_mode => SSL_VERIFY_NONE);
  print $agent->get('http://brdtest.com/myip.json')->content();
  ```
</CodeGroup>

## Bright Data Proxy Manager SSL analysis

Some features require the Proxy Manager to have access to HTTPS traffic. This can be done by enabling the **SSL Analyzing** option on the proxy port configuration page.

Once you allow Proxy Manager to terminate the SSL you will also need to [trust Bright Data Certificate Authority (CA)](https://brightdata.com/static/brightdata_proxy_ca.zip).

Under the hood Proxy Manager will create a secure encrypted HTTPS connection with the target site, decrypt the traffic to log requests and run rules based on your settings and then pass the response back to your client in an encrypted HTTPS connection with a certificate signed by our CA certificate.


# Root certificate migration
Source: https://docs.brightdata.com/general/account/ssl-certificate-migration

Migrate to Bright Data's new root certificate on proxy port 44445 before the old certificates on ports 22225 and 33335 expire on September 25, 2026.

Bright Data is replacing the SSL root certificate for its proxy endpoints, including `brd.superproxy.io` and legacy hostnames such as `zproxy.lum-superproxy.io`, and you must migrate to the new certificate on proxy port `44445` before the current certificates expire on **September 25, 2026 at 00:00 UTC** to avoid downtime.

<Warning>
  The current certificates cannot be extended or renewed. After September 25, 2026 at 00:00 UTC, any traffic still relying on the old certificates on ports `22225` or `33335` will fail. Complete the migration before this date.
</Warning>

## Who needs to migrate

You are affected if you use Bright Data proxies, SERP API or Web Unlocker API on port `22225` or `33335`, and/or your code references a Bright Data `.crt` certificate file.

The migration also applies if your code connects through a legacy hostname such as `zproxy.lum-superproxy.io` or another `luminati.io`-era domain. Those hostnames are deprecated, so update them to `brd.superproxy.io` as part of the migration.

You are not affected if you connect through the Bright Data proxy API instead of native proxy mode, or if your account is verified through the [KYC process](/products/residential/network-access#kyc-verification) and you do not load the certificate. See [API vs. native access](/api-reference/authentication).

## Migration timeline

Port `44445` and the new root certificate went live in July 2026. Both the old and new certificates are operational during the transition window, so you can migrate at your own pace before the deadline. On **September 25, 2026 at 00:00 UTC** the old certificates on ports `22225` and `33335` expire, and traffic that still relies on them fails.

## What is changing

| Setting | Before migration | After migration |
| - | - | - |
| Root certificate | `brightdata_root_ca_33335.crt` or the port `22225` certificate (both expire September 25, 2026) | `brightdata_root_ca_44445.crt` |
| Proxy port | `22225` or `33335` | `44445` |
| Certificate file | `brightdata_proxy_ca.zip` | `brightdata_proxy_ca.zip` (updated bundle containing `brightdata_root_ca_44445.crt`) |

## Prerequisites

* Access to the host that runs your scraping code or application, where the certificate is loaded or installed
* The new certificate file from Bright Data
* Ability to open outbound traffic to `brd.superproxy.io` on port `44445` in your network or firewall

## How to migrate to the new certificate

1. **Open port `44445`** for outbound traffic to `brd.superproxy.io`. Ask your network or security administrator to allow this if outbound ports are restricted.
2. **Download the certificate bundle** from [brightdata.com/static/brightdata\_proxy\_ca.zip](https://brightdata.com/static/brightdata_proxy_ca.zip) and save `brightdata_root_ca_44445.crt` to the host that runs your code.
3. **Update your proxy host and port** in every place your code or tools connect to Bright Data. Change your current port (`22225` or `33335`) to `44445`, and replace any legacy hostname such as `zproxy.lum-superproxy.io` with `brd.superproxy.io`. The new certificate must be used in conjunction with port `44445`.
4. **Load or install the new certificate** the same way you use the current one. For code that loads the certificate at runtime, point `--cacert` (or your language's equivalent) at the new file. For tools that require an installed certificate, follow the steps in [SSL certificate installation](/general/account/ssl-certificate#installation-of-the-ssl-certificate).
5. **Test one request** against `https://geo.brdtest.com/mygeo.json` to confirm the migration was successful before switching all traffic.

The following cURL example shows a request using the new port and certificate:

```sh theme={null}
curl --proxy brd.superproxy.io:44445 --proxy-user brd-customer-<account-id>-zone-<zone-name>:<zone-password> --cacert <PATH TO NEW CA.CRT> "https://geo.brdtest.com/mygeo.json"
```

## How to verify the migration worked

* A request to `https://geo.brdtest.com/mygeo.json` through port `44445` returns your geolocation JSON without an SSL error.
* Your existing scraping traffic continues to succeed after you switch the port and certificate.

If a request fails with an SSL error after migrating, confirm that the new certificate is the one loaded or installed on the host running the request, and that the request targets port `44445`. If curl on Windows fails with `CRYPT_E_REVOCATION_OFFLINE` or `CERT_TRUST_REVOCATION_STATUS_UNKNOWN`, see [Windows curl SSL errors on port 44445](/general/account/ssl-certificate-windows-schannel).

If you are still encountering difficulties with the migration, contact [support@brightdata.com](mailto:support@brightdata.com).

## FAQ

### What happens if I do not migrate by September 25, 2026?

Any traffic that still relies on the old certificates on ports `22225` or `33335` fails after September 25, 2026 at 00:00 UTC. The old certificates cannot be extended or renewed.

### Can I use both certificates during the transition?

Yes. Both the old and new certificates are operational during the transition window, each on its own port, so you can migrate at your own pace before September 25, 2026. Use the certificate that matches the port you connect to.

### What if I ignore SSL errors in my code?

If your code disables SSL verification, for example with curl's `-k` flag or your language's equivalent, the certificate expiry does not break your requests because the certificate is never validated. Bright Data still recommends moving to port `44445` so your setup stays consistent with current documentation and code samples. See [how to ignore SSL errors](/general/account/ssl-certificate#how-to-ignore-ssl-errors).

### Why does curl on Windows fail with a revocation error on port 44445?

Windows curl builds that use the Schannel TLS backend may fail with `CRYPT_E_REVOCATION_OFFLINE` or `CERT_TRUST_REVOCATION_STATUS_UNKNOWN` because the new root certificate no longer carries a CRL Distribution Point. Add the `--ssl-revoke-best-effort` flag to your curl command. See [Windows curl SSL errors on port 44445](/general/account/ssl-certificate-windows-schannel) for details.

### Which products does this migration apply to?

Bright Data proxies, SERP API and Web Unlocker API connections that use a Bright Data SSL certificate in native proxy mode on port `22225` or `33335`.


# Windows curl SSL errors on port 44445
Source: https://docs.brightdata.com/general/account/ssl-certificate-windows-schannel

Fix CRYPT_E_REVOCATION_OFFLINE and CERT_TRUST_REVOCATION_STATUS_UNKNOWN errors in Windows Schannel curl on Bright Data proxy port 44445.

This guide explains how to fix SSL revocation errors that Windows curl builds using the Schannel TLS backend return when connecting to Bright Data proxy port `44445`. Add the `--ssl-revoke-best-effort` flag to your curl command:

```sh theme={null}
curl -i -v \
  --ssl-revoke-best-effort \
  --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> \
  --cacert brightdata_root_ca_44445.crt \
  "https://geo.brdtest.com/mygeo.json"
```

The request should return your geolocation JSON with an HTTP 200 status. The flag keeps normal SSL verification enabled and only stops Schannel from failing the request when the revocation status cannot be confirmed.

## What errors does Schannel show?

Affected Windows curl builds fail with `CRYPT_E_REVOCATION_OFFLINE` or `CERT_TRUST_REVOCATION_STATUS_UNKNOWN` during the TLS handshake. In verbose (`-v`) output, the failure looks like this:

```text theme={null}
schannel: next InitializeSecurityContext failed:
CRYPT_E_REVOCATION_OFFLINE (0x80092013)
The revocation function was unable to check revocation because the
revocation server was offline.
```

When you pass the certificate with `--cacert`, the CA file loads correctly but the handshake still fails at the revocation check:

```text theme={null}
schannel: added 1 certificate(s) from CA file
schannel: CertGetCertificateChain trust error
CERT_TRUST_REVOCATION_STATUS_UNKNOWN
```

Both errors mean the same thing: the Bright Data root certificate is valid and installed correctly, but Schannel cannot confirm its revocation status and treats that as fatal.

## Why does Schannel fail on port 44445?

Schannel performs strict certificate revocation checks and treats missing root-level revocation information as a fatal error. In the port `44445` certificate chain, introduced in July 2026, Bright Data moved the CRL Distribution Point from the root CA to the intermediate and leaf certificates.

The old root CA included this extension:

```text theme={null}
X509v3 CRL Distribution Points:
  Full Name:
    URI:http://crl.brightdata.com/proxy_ca.crl
```

The new `brightdata_root_ca_44445.crt` root CA does not. This is the correct chain design: a root CA is a self-signed trust anchor, and revocation information belongs on the intermediate and leaf certificates. curl builds based on OpenSSL or LibreSSL, including all Linux and macOS builds, accept the new chain without errors. Only Schannel-based Windows builds may fail.

## How to check your curl TLS backend

Run `curl -V` and look at the first line of the output. The curl build that ships with Windows 10 and Windows 11 uses Schannel:

```text theme={null}
curl 8.x.x ... Schannel ...
```

Builds that are not affected show `OpenSSL` or `LibreSSL` instead of `Schannel`. If your build shows Schannel, use one of the two fixes below.

## Add the --ssl-revoke-best-effort flag

Adding `--ssl-revoke-best-effort` is the recommended fix for Schannel-based curl. Per the curl manual, the flag tells curl "to ignore certificate revocation checks when they failed due to missing/offline distribution points for the revocation check lists". The flag is Schannel-specific and available since curl 7.70.0.

With the flag, curl still enforces:

* Trusted CA validation
* Hostname validation
* Expiration validation
* Certificate chain validation

<Warning>
  Do not use `-k` or `--insecure` instead. Those flags disable SSL verification entirely, while `--ssl-revoke-best-effort` only relaxes the revocation check that Schannel cannot complete.
</Warning>

## Switch to an OpenSSL or LibreSSL curl build

As an alternative, install a Windows curl build compiled against OpenSSL or LibreSSL and confirm the backend with `curl -V`. These builds validate the port `44445` chain the same way Linux curl does, so no extra flag is needed:

```sh theme={null}
curl -i -v \
  --proxy brd.superproxy.io:44445 \
  --proxy-user brd-customer-<customer_id>-zone-<zone_name>:<zone_password> \
  --cacert brightdata_root_ca_44445.crt \
  "https://geo.brdtest.com/mygeo.json"
```

A successful request returns your geolocation JSON without SSL errors.

## FAQ

### Does --ssl-revoke-best-effort disable SSL verification?

No. The `--ssl-revoke-best-effort` flag keeps trusted CA, hostname, expiration and certificate chain validation enabled. It only stops Schannel from failing the request when the certificate revocation status cannot be confirmed. It is not equivalent to `-k` or `--insecure`, which disable verification entirely.

### Is the new Bright Data certificate untrusted or installed incorrectly?

No. The `CRYPT_E_REVOCATION_OFFLINE` and `CERT_TRUST_REVOCATION_STATUS_UNKNOWN` errors are caused by how Schannel handles missing root-level revocation information, not by the certificate itself. The same certificate works without errors on Linux, macOS and Windows curl builds based on OpenSSL or LibreSSL.

### Does this issue affect Linux or macOS?

No. Linux and macOS curl builds use OpenSSL or LibreSSL, which do not enforce Schannel's root-level revocation behavior. Only Windows curl builds using the Schannel TLS backend are affected.

## Related

* [Root certificate migration](/general/account/ssl-certificate-migration)
* [SSL certificate](/general/account/ssl-certificate)
* [FAQ: Which port shall I use](/general/faqs#which-port-shall-i-use-22225-or-33335)


# Users management
Source: https://docs.brightdata.com/general/account/users-management

Manage Bright Data users and permissions across 3 access types: Control Panel users, proxy/API users and billing contacts, each with separate role scopes.

## Types of User Access

Bright Data has 3 main types of users, each refers to a different access channel:

1. Control panel users
2. API Users using API keys
3. Proxy manager users

Those 3 different access methods control the authentication prior to using any Bright Data services.

They are reflect in 3 users' and API keys' tables under the "Account settings" in the control panel.

## Control panel users

Control panel users can get access to Bright Data control panel as well as to other service per permissions assigned to them on creation.

<Note>
  The user signing up to Bright Data is the account manager and has admin permissions by default.
</Note>

### Permissions and allowed actions

| Permission | Actions |
| - | - |
| Admin | Full account control: create and delete account, add/remove/edit users, add/remove/edit financial and payments, add/remove/edit API key, add/remove/edit proxy manager users, set zone and user limits, add/remove/edit bright data services, consume bright data services |
| Finance | add/remove/edit financial and payments |
| Ops | add/remove/edit bright data services |
| User | Consume Bright Data services |
| Limit | Edit account limit |
| User limit | Edit user usage limits |

## How to manage your API key

Each control panel user can have an API key assigned to him. The first API key is automatically created for the user creating the account. Users with admin permissions cannot display their API key in plain text.

## Proxy Manager users

Proxy manager users are allowed to access only Proxy Manager. The permissions as to which port they can access is done inside the proxy manager console. This is relevant only for users using proxy manager.


# Azure Entra ID SSO setup
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_Azure_SSO_Entra_ID_with_Bright_Data

Step-by-step guide to configuring Azure Entra ID (formerly Azure Active Directory) SSO and SCIM provisioning with Bright Data in 6 steps.

* Prepare application

* Setup SSO

* Setup SCIM provisioning

## How to prepare the application

* Go to [https://entra.microsoft.com/](https://entra.microsoft.com/) and log in to your account.

* Create Enterprise application:

<img alt="Microsoft Entra admin center with the Create Enterprise application button" />

* Click “Create your own application”

* Enter name of your application

* Select “Integrate any other application you don't find in the gallery (Non-gallery)”

* Click “Create”

<img alt="Entra Create your own application dialog with non-gallery option selected" />

## How to set up SSO

<Warning>
  **Enforced Entra SSO disables password-based login.**

  When Entra SSO is enforced for your organization, password-based login and password reset emails are disabled for all users on the account. Users must sign in via Microsoft Entra.

  * Entering an email address on the Bright Data login page automatically redirects the user to the Entra sign-in page.
  * After a successful Entra sign-in, the user is redirected back to Bright Data.
  * Password reset requests will **not** generate an email.
</Warning>

* Go to [https://brightdata.com](https://brightdata.com) and log in to your account.

* Choose Settings->Account settings->Passwords & authentication in left side menu and toggle Microsoft Entra ID (Azur AD) switch

<img alt="Bright Data Passwords and authentication settings with the Microsoft Entra ID toggle" />

* From “App registrations” view select your application.

* Copy “Application (client) ID” to “Client ID”

* Copy “Directory (tenant) ID” to “OAuth2 issuer (tenant)”

* Go to “Add a certificate or secret”

<img alt="Entra App registrations overview showing Application client ID and Directory tenant ID" />

* At secrets screen click “New client secret”

* Fill Description

* Click “Add”

<img alt="Entra Add a client secret dialog with Description and Add button" />

* Once secret is created copy secret value to “Client secret”.

* Copy “Sign-in redirect URI” to be used at next step

<img alt="Bright Data Entra ID dialog with Sign-in redirect URI to copy" />

* At “Authentication” screen click “Add platform” and select “Web”

<img alt="Entra Authentication screen with Add platform dialog and Web option" />

* Paste previously copied “Sign-in redirect URI” to the “Redirect URIs” and save settings by clicking “Configure”:

<img alt="Entra Configure Web platform dialog with Sign-in redirect URI pasted in" />

* Activate EntraID integration at BrighData control panel and test login:

<img alt="Bright Data Entra ID integration activated and ready for test login" />

## Setup SCIM provisioning

* Copy “Auth token” from SCIM section of BrightData EntraID settings:

<img alt="Bright Data Entra ID SCIM section showing the Auth token to copy" />

* Select your application from “Enterprise Applications” view and go to “Provisioning” settings:

<img alt="Entra Enterprise Applications view with Bright Data application selected" />

* Select “Provisioning” under “Manage” menu:

<img alt="Entra Manage menu with Provisioning option highlighted" />

* Select “Automatic” Provisioning Mode

* Fill “Tenant URL” with [https://brightdata.com/users/auth/scim](https://brightdata.com/users/auth/scim) value

* Fill “Secret Token” with previously copied value from BrightData control panel settings

* Test Connection. You should see successful message in top right corner
  Save Settings

<img alt="Entra Provisioning settings with Tenant URL and Secret Token fields filled in" />

* Return to “Overview” tab and click “Start provisioning”.

* You can test provisioning at “Provision on demand” page, but first assign your users to BrightData application at “Users and groups” page:

<img alt="Entra Users and groups page with users assigned to the Bright Data application" />

## Troubleshooting

<AccordionGroup>
  <Accordion title="What should a user do if they are not receiving a password reset email?">
    If your organization has enabled **enforced Entra SSO**, password reset emails are not sent, because password-based authentication is disabled on accounts with enforced SSO.

    To sign in:

    1. Go to the [Bright Data sign-in page](https://brightdata.com/cp).
    2. Enter the user's email address.
    3. The user will be automatically redirected to the Microsoft Entra sign-in page.
    4. After a successful Entra sign-in, the user is redirected back to Bright Data.

    If access issues persist, contact your organization's IT / Entra administrator. They manage the Entra SSO configuration on your company's side.
  </Accordion>

  <Accordion title="Why is a user redirected to a Microsoft login page they do not recognize?">
    This is expected behavior when Entra SSO is enforced. The Bright Data login page detects the email domain associated with your organization's Entra tenant and redirects the user to your configured Microsoft Entra sign-in page.
  </Accordion>
</AccordionGroup>


# Google Workspace SSO setup
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_SSO_with_Google_Workspace_in_Bright_Data

Configure Google Workspace OIDC SSO for Bright Data via a Google Cloud Console OAuth 2.0 client ID. Manual provisioning, hd-claim domain enforcement.

This guide explains how to set up Google Workspace SSO for Bright Data using OIDC, with the OAuth client ID created in the Google Cloud Console and users provisioned manually in the Bright Data Control Panel.

<Note>
  Google Workspace SSO for Bright Data is configured in the **Google Cloud Console** (`console.cloud.google.com`), not the Google Workspace Admin console. This is a separate feature from the public **Continue with Google** sign-in button.
</Note>

**Requirements**

* A Google Cloud project linked to your Google Workspace organization, with permission to configure the OAuth consent screen and create OAuth client IDs (typically a project owner or editor)
* A Bright Data account with admin permission
* All Bright Data users who will sign in via SSO must already exist in the Bright Data Control Panel under **Account Settings → Users**. Bright Data Google Workspace SSO uses manual provisioning. There is no SCIM or JIT provisioning.

<Warning>
  **Enforced Google Workspace SSO disables password-based login.**

  When Google Workspace SSO is enforced for your organization, password-based login and password reset emails are disabled for all users on the account. Users must sign in via Google. Contact your IT / Workspace administrator if access issues arise.
</Warning>

## Configure the OAuth consent screen

1. Sign in to the [Google Cloud Console](https://console.cloud.google.com/) with an account that has access to your Google Workspace organization's project.
2. In the left navigation, go to **APIs & Services → OAuth consent screen**.
3. Set **User type** to **Internal** so only members of your Workspace can sign in.
4. Fill in the required fields (app name, user support email, developer contact information).
5. Save.

## Create the OAuth client ID

6. In the Google Cloud Console, go to **APIs & Services → Credentials**.
7. Click **Create Credentials → OAuth client ID**.
8. Set **Application type** to **Web application**.
9. Name the client. We recommend `Bright Data Control Panel`.
10. Leave **Authorized redirect URIs** empty for now. You will paste in the Bright Data redirect URI in the next section.
11. Click **Create**. Google displays a dialog with your **Client ID** and **Client Secret**. Copy both values.

## Configure Bright Data

12. In a new tab, open the Bright Data [Control Panel](https://brightdata.com/cp/setting) and go to **Account Settings → Passwords & authentication**.
13. Under **Configure Single Sign-On**, click **Google Workspace**.
14. In the dialog, paste:
    * **Client ID** from step 11
    * **Client Secret** from step 11
    * **Workspace Domain**. The primary domain of your Google Workspace (for example, `yourcompany.com`).
15. Copy the read-only **Sign-in redirect URI** displayed in the dialog. It has the form `https://brightdata.com/users/auth/google_workspace/<customer_id>/done`.

## Paste the redirect URI back into Google

16. Return to the Google Cloud Console OAuth client ID you created in step 7.
17. Under **Authorized redirect URIs**, click **Add URI** and paste the **Sign-in redirect URI** from step 15.
18. Click **Save**.

## Activate and test

19. Return to the Bright Data Control Panel **Google Workspace** dialog.
20. Click **Activate**.
21. Test by signing out of Bright Data and signing back in via Google Workspace SSO. Use an account whose email is present in **both** your Google Workspace **and** the Bright Data Control Panel (**Account Settings → Users**).

## Add users for SSO sign-in

Bright Data Google Workspace SSO uses **manual provisioning**. There is no SCIM or JIT user creation. Before a user can sign in:

1. In the Bright Data Control Panel, go to **Account Settings → Users**.
2. Add the user's email address. The email must match the user's primary Google Workspace email.
3. Set the user's role.

When that user signs in via Google Workspace SSO for the first time, Bright Data creates the user record using the pre-added email.

## What else to know

* The OAuth consent screen **must** be set to **Internal** user type. An **External** consent screen would allow any Google account to attempt sign-in.
* The **Workspace Domain** field enforces the OIDC `hd` (hosted domain) claim. Only users whose Google account belongs to the configured Workspace Domain will succeed.
* Google Workspace SSO is a **separate feature** from the public **Continue with Google** sign-in button. They use different client IDs, redirect URIs, and provisioning flows. See [Google OAuth 2.0](/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data#google-oauth-20).
* If you rotate the Client Secret in Google Cloud Console, update it in the Bright Data dialog as well. Otherwise sign-in fails with an `invalid_client` error.
* The Sign-in redirect URI must match exactly between the Bright Data dialog and the Authorized redirect URIs list in Google Cloud Console. Mismatches return a `redirect_uri_mismatch` error.

***

## SSO technical reference

For the full enterprise SSO technical reference, including OIDC parameters and a comparison of provisioning methods across all supported identity providers, see the [SSO technical reference](/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data#sso-technical-reference) on the Okta SSO page.

### Google Workspace-specific parameters

| Parameter | Value |
| - | - |
| Protocol | OpenID Connect (OIDC) |
| Application type | Web application, created in Google Cloud Console → APIs & Services → Credentials |
| Required scopes | `openid profile email` |
| User identifier | `email` claim |
| Hosted domain enforcement | The `hd` claim is validated on every callback. Only emails from the configured Workspace Domain succeed. |
| OAuth consent screen | Must be **Internal** user type |
| Provisioning | Manual. Pre-add the user in Bright Data Control Panel (**Account Settings → Users**) before first sign-in. |


# Okta SSO setup with Bright Data
Source: https://docs.brightdata.com/general/authentication/How_to_set_up_SSO_with_Okta_in_Bright_Data

Step-by-step guide to configure Okta OIDC SSO with Bright Data in 5 steps, plus SSO technical reference for enterprise security questionnaires.

**Requirements**

* An Okta organization account with admin permission
* A Bright Data account with admin permission

<Warning>
  **Enforced Okta SSO disables password-based login.**

  When Okta SSO is enforced for your organization, password-based login and password reset emails are disabled for all users on the account. Users must sign in via Okta. Contact your IT / Okta administrator if access issues arise.
</Warning>

**Steps:**

1. On your Okta admin dashboard, choose '**Applications > Applications**'

```sh theme={null}
https://[your_domain]-admin.okta.com/admin/apps/active
```

2. Click '**Create App Integration**'

<img alt="Okta admin dashboard with Create App Integration button highlighted" />

3. Select '**OIDC - OpenID Connect**' as the Sign-in method,

4. Select'**Web Application**' as the Application type and click '**Next**'

<img alt="Okta Create new app integration dialog with OIDC and Web Application selected" />

5. At this point you should be redirected to a new web app integration page. Here you can name your app integration (we recommend to use "**Bright Data Control Panel**" name).

6. At ‘Grant type’ select **Implicit** along with **Authorization Code**

<img alt="Okta web app grant type settings with Implicit and Authorization Code selected" />

7. Go to Bright Data [Control Panel](https://brightdata.com/cp/setting)

8. Open OKTA configuration dialog

<img alt="Bright Data Control Panel settings page with the Okta SSO configuration dialog open" />

9. Copy **"Sign-in redirect URI"**

**<img alt="Bright Data Okta dialog with Sign-in redirect URI field highlighted for copying" />**

10. Paste it to according field in New App setup in OKTA

<img alt="Okta app integration page with Sign-in redirect URI pasted in" />

11. Repeat the same for **"Sign-out URI"**

12. At ‘Assignments’, select an access level as you want

<img alt="Okta app integration Assignments section showing access level options" />

13. Click '**Save**'

14. Now, you should land on your new app integration settings page.

Copy your **Client ID**, **Client Secret**, and **Okta domain** to OKTA setup dialog in your Bright Data Control Panel. 

<img alt="Okta app integration settings page showing Client ID, Client Secret, and Okta domain fields" />

<img alt="Bright Data Okta SSO dialog with Client ID, Client Secret, and Okta domain pasted in" />

15. Click **"Activate"**.

Skip step 16 if you selected "Allow everyone to access"

16. Go to **"Assignments"** tab and assign users allowed to use this integration

<img alt="Okta Assignments tab listing users assigned to the Bright Data integration" />

17. Go to Bright Data Settings page and make sure all required users presented.

We're working on users provisioning support, at the moment - you should manage it manually.

<img alt="Bright Data Settings users page listing users that can sign in via Okta" />

***The following steps are optional. They are for enabling your users to launch authentication from their dashboard or the Okta Chrome extension.***

18. Scroll down to ‘General Settings’ and click **Edit**

19. Set these settings:

* Login initiated by: **Either Okta or App**
* Application visibility: **Display application icon to users**
* Login flow: **Redirect to app to initiate login (OIDC Compliant)**
* Copy Initiate login URI from Control Panel

<img alt="Okta General Settings showing Login initiated by, Application visibility, and Login flow options" />

<img alt="Bright Data Control Panel showing the Initiate login URI to paste into Okta General Settings" />

20. Save changes. **Now the integration is ready to work.**

**Notes**

* Okta Domain should be the one that appears in your app integration settings (**yourcompany.okta.com**), NOT the one you are seeing as an admin (yourcompany-admin.okta.com)

* Make sure the **Credentials** provided to Bright Data are correct, we cannot check them on our side.

-  **Sign-in Redirect URI** is a must in order to make the SSO feature work correctly\
-  **Initiate login URI** is needed if the you wants to be able to use the feature from the Okta Chrome extension or the Okta dashboard

***

## SSO technical reference

This section is for enterprise security teams completing vendor SSO questionnaires.

### Which SSO protocol is supported

Bright Data supports SSO via **OpenID Connect (OIDC) only**. SAML 2.0 is not supported. There is no SAML metadata XML, Entity ID, or ACS URL.

### Supported identity providers

* Okta
* Microsoft Entra ID (Azure AD)
* Google Workspace

### Which OIDC parameters to configure

| Parameter | Value |
| - | - |
| Protocol | OpenID Connect (OIDC) |
| User identifier | `email` claim |
| Required scopes | `profile email` |
| Required claims | `email` |
| Optional claims | `givenName`, `familyName` |

### How account provisioning works

| Identity provider | Provisioning method |
| - | - |
| Okta | Manual. Add users in the Bright Data Control Panel. User record is created automatically on first sign-in. |
| Microsoft Entra ID | Automatic via SCIM. |
| Google Workspace | Manual. Add users in the Bright Data Control Panel. User record is created automatically on first sign-in. The OIDC `hd` claim enforces the configured Workspace Domain. See [Google Workspace SSO setup](/general/authentication/How_to_set_up_SSO_with_Google_Workspace_in_Bright_Data). |

### Other SSO details

* Password logins can be disabled entirely.
* Access is controlled by users added to the account, not by email domain.
* Different user roles are available to restrict access per user.

### Google OAuth 2.0

Bright Data also supports login via Google OAuth 2.0.

| Parameter | Value |
| - | - |
| Required scopes | `https://www.googleapis.com/auth/userinfo.profile`, `https://www.googleapis.com/auth/userinfo.email` |
| Account provisioning | User must be added to the account via the Bright Data Control Panel first. User record is created after signing up using "Continue with Google". |


# Query Bright Data docs from your agent
Source: https://docs.brightdata.com/general/docs-mcp

Connect your AI coding agent to Bright Data's docs via Model Context Protocol. Retrieve thousands of scraper docs as native MCP resources, no scraping required.

## What is the Docs MCP?

The Docs MCP server at `https://docs.brightdata.com/mcp` exposes all Bright Data documentation as searchable MCP resources. Any MCP-compatible coding agent can connect and query the docs in real-time, directly inside its reasoning loop.

<Info>
  **Two Bright MCP servers - two different jobs:**

  | MCP Server | URL | Purpose |
  | - | - | - |
  | **Docs MCP** | `https://docs.brightdata.com/mcp` | Search and retrieve Bright Data documentation |
  | **Bright Data MCP** | `https://mcp.brightdata.com/mcp?token=<token>` | Access live web data - scraping, search, unlocker |

  This page covers the **Docs MCP**. To access live web data from your agent, see the [MCP Server docs →](/products/mcp-server/overview)
</Info>

***

## Connect your agent

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http brightdata-docs https://docs.brightdata.com/mcp
    ```

    Verify the connection:

    ```bash theme={null}
    claude mcp list
    # brightdata-docs: https://docs.brightdata.com/mcp (HTTP) - ✓ Connected
    ```
  </Tab>

  <Tab title="Cursor">
    Open **Settings → Tools & Integrations → Add Custom MCP** and paste:

    ```json theme={null}
    {
      "mcpServers": {
        "brightdata-docs": {
          "url": "https://docs.brightdata.com/mcp",
          "transport": "http"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code (Copilot)">
    Add to your `.vscode/mcp.json` or user MCP settings:

    ```json theme={null}
    {
      "servers": {
        "brightdata-docs": {
          "url": "https://docs.brightdata.com/mcp",
          "type": "http"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    Add to `claude_desktop_config.json` (usually at `~/.config/claude/`):

    ```json theme={null}
    {
      "mcpServers": {
        "brightdata-docs": {
          "url": "https://docs.brightdata.com/mcp",
          "transport": "http"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf / Any MCP client">
    The Docs MCP uses standard HTTP transport - connect any MCP-compatible client to:

    ```http theme={null}
    https://docs.brightdata.com/mcp
    ```

    No authentication required. No API key needed.
  </Tab>
</Tabs>

***

## What can your agent do with it?

Once connected, your agent gains a **search tool** over the full Bright Data documentation index. It can:

* **Find the right API** - "What's the parameter for setting a custom geo-location in the SERP API?"
* **Retrieve product pages** - Pull the full reference for Web Unlocker, Scraping Browser, or any product
* **Look up code examples** - "Show me a Python example for paginating SERP results"
* **Explore integrations** - "How do I connect LangChain to Bright Data?"
* **Check pricing and limits** - "What are the rate limits for the Bright Data MCP free tier?"

The agent queries docs during its reasoning loop - so it always has accurate, up-to-date information rather than relying on stale training data.

***

## Use both MCP servers together

For maximum capability, connect **both** MCP servers in a single session:

```bash theme={null}
# Docs: know how to use Bright Data
claude mcp add --transport http brightdata-docs https://docs.brightdata.com/mcp

# Data: actually use Bright Data
claude mcp add --transport sse brightdata https://mcp.brightdata.com/sse?token=YOUR_API_KEY
```

Now your agent can look up documentation **and** execute real web data requests in the same session - no context switching required.

<Tip>
  The best setup for a coding agent is all three layers working together:

  1. A **[Skill](/quickstart-coding-agent#how-do-i-install-bright-data-skills)** for embedded baseline knowledge
  2. The **Docs MCP** for on-demand documentation lookup
  3. The **[Bright Data MCP](/products/mcp-server/overview)** for live web access

  Install the skill once, connect both MCP servers, and your agent is fully equipped.
</Tip>

***

## Rate limits

| Limit | Value |
| - | - |
| Requests per user per hour | 200 |
| Requests per domain per hour | 1,000 |

These limits apply to the Mintlify-hosted Docs MCP. For higher throughput, use [llms-full.txt](/quickstart-coding-agent#how-do-i-give-my-agent-the-full-documentation) to load the full docs locally.

***

## Next steps

<CardGroup>
  <Card title="Bright Data MCP Server" icon="microchip-ai" href="/products/mcp-server/overview">
    Add live web data access - search, scrape, and extract from the web
  </Card>

  <Card title="For your coding agent" icon="robot" href="/quickstart-coding-agent">
    Load llms.txt or llms-full.txt for offline or RAG-based access to all docs
  </Card>
</CardGroup>


# Bright Data general FAQs
Source: https://docs.brightdata.com/general/faqs

FAQs about Bright Data accounts: proxy credentials, port 44445, SSL certificates and IP management across all proxy and API products.

<AccordionGroup>
  <Accordion title="Where is my proxy username and password?">
    You can find your username and password for your Bright Data product (e.g. proxy, Web Unlocker API, Browser API etc) in the "Overview" tab for product you created. You can create more than one password if you want.

    **Note**: the username and password you created for the Bright Data site are **NOT** used for accessing the actual products. It is only used for dashboard access.
  </Accordion>

  <Accordion title="Which proxy service port shall I use: 22225 or 33335?">
    In Bright Data we distinguish between our proxy service ports, to which you address your requests and the target ports which refer to the target website or host you are trying to reach.

    This entry refers to Proxy service ports, of our main host: [brd.superproxy.io](http://brd.superproxy.io)

    #### Proxy port

    When working with Bright Data proxies in Native mode, you need to provide a proxy port. This setting is redundant when working with proxy APIs - see more here of the differences between [API vs. native Access](/api-reference/authentication).

    #### Proxy port transition

    Bright Data now serves requests over native proxy port `44445`, introduced with the new root certificate in July 2026. The old certificates on ports `22225` and `33335` expire on September 25, 2026 at 00:00 UTC, and traffic still relying on them after that date will fail. For a step-by-step move, see the [root certificate migration guide](/general/account/ssl-certificate-migration).

    For proxy zones of types **Residential, Mobile, Web Unlocker API and SERP API** which require either [KYC](/products/residential/network-access#kyc-verification) or [SSL Certificate](/general/account/ssl-certificate) it is essential to install the correct certificate which complies with port used.

    If you are still using port `22225` or `33335`, complete the transition to port `44445` before September 25, 2026.

    #### Supported settings

    | Port | Certificate | Expiration |
    | - | - | - |
    | `44445` | New certificate (required) | In effect from July 2026 |
    | `33335` | Old certificate (deprecated) | September 25, 2026 |
    | `22225` | Old certificate (deprecated) | September 25, 2026 |

    #### Working in Tandem

    The certificates operate in tandem and differ by port, so you can migrate gracefully. Use the certificate that matches the port you connect to. Port `44445` uses `brightdata_root_ca_44445.crt`.

    ### Transition steps

    To transition to port `44445` you should:

    1. Inform your network administrator or security administrator to open the domain `brd.superproxy.io` on port `44445` for outgoing communication.
    2. If you are using certificate: install the new certificate. See instructions on certificate installation here: [SSL Certificate](/general/account/ssl-certificate)
  </Accordion>

  <Accordion title="How do I set up a password for my account?">
    Even if you first signed in with 'magic link' or using a six-digit code, you can always create a password for your account. You can then save the password in your browser for faster access to the control panel.

    To set up a password for your Bright Data account, follow these steps:

    1. Access authentication settings: Click on "Settings" and go to the ['Passwords & authentication' tab](https://brightdata.com/cp/setting/auth)
    2. Create your password: Follow the instructions to create a password for your account. We recommend at least a 10-digit password with numbers and symbols.

    Remember, each user must set their own password. If you have other users on your account, they can configure their passwords individually if needed.

    Note: If you're authenticated via third-party service like Google or GitHub, please add a separate user and sign in through Bright Data's standard signup flow instead of using third-party services.
  </Accordion>

  <Accordion title="How to review IPs Allocated to Your Zone?">
    To review the list of IPs allocated to your zone, simply navigate to [**‘My proxies page’**](https://brightdata.com/cp/zones), **click** on your Proxy zone, scroll down to the **‘Allocated IPs’** section, then simply click **‘Show allocated IPs’** or **‘Download IPs list'.**

    <Note>
      Due to privacy and security concerns, this option is not available for Residential Shared Pay-Per-GB configuration. See `-session` flag instead.
    </Note>

    <img alt="review-allocated-ips.gif" />
  </Accordion>

  <Accordion title="How to view your zone's statistics?">
    There are 2 ways to view your zones statistics:

    <Tabs>
      <Tab title="via Control Panel">
        * To see stats across all your zones, go to your [dashboard](https://brightdata.com/cp/zones/dashboard):

          <img alt="statistics-via-control-panel.png" />
        * To see stats for a specific zone, click on "Proxies and Scraping" on the left navigation bar and go to the zone's settings and click the "statistics" tab:

          <img alt="specific-zone-statics.gif" />
      </Tab>

      <Tab title="via The API">
        * Please visit [this page](/api-reference/) to see all available API endpoints (in multiple languages) and example responses related to viewing statistics.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="How to set limits to bandwidth usage?">
    By default, all proxy zones have unlimited usage, and you can set a limit by one of 4 parameters:

    * \$/day
    * \$/month
    * bytes/day
    * bytes/month

    To set this limit on one of your zones, from Bright Data's ['My proxies page'](https://brightdata.com/cp/zones)

    <Steps>
      <Step title="Go to any of your zone's settings by clicking on that zone." />

      <Step title="Go to the &#x22;Access parameters&#x22; tab.">
        <img alt="access-parameters.png" />
      </Step>

      <Step title="Scroll down to &#x22;Limit&#x22;, the default value is &#x22;unlimited&#x22;" />

      <Step title="Click the &#x22;edit&#x22; button">
        <img alt="edit-limit.png" />
      </Step>

      <Step title="Enable the &#x22;spend limit&#x22; option.">
        <img alt="spend-limit-toggle.png" />
      </Step>

      <Step title="Set the parameters you wish to work with and click &#x22;update&#x22;" />

      <Step title="You'll see the change back in the Limit section and the proxies page, in the Usage/Spend Limit column." />
    </Steps>
  </Accordion>

  <Accordion title="How do I calculate the Cost effectiveness of residential IPs?">
    <img alt="cost-limits-table.png" />

    **How did we calculate this table?**

    Your company needs to collect information from the web by sending 1,000 http requests per hour to a specific website. You write the scraper code and run it through a server. The target website allows 50 requests per minute from the same IP before blocking your scraper. Now, you have to purchase more proxies.

    **Assuming you choose datacenter proxies:**\
    You don't want to share IPs, so you buy 200 dedicated data-center IPs. You code the integration of the scraper with the new data-center proxies for 2 hours and then run the new program. This time, it takes 3 days for your target website to detect your scraper. Once your proxies are detected, you'll have to purchase new proxies and repeat this process again, checking each day to make sure the proxies haven't been detected. Cost per month (all numbers are from real customers):

    * 200 dedicated IPs: \$500
    * Bandwidth: (1000 request X 20KB per request X 24 hours X 30 days = 14.5GB): \$3 per month
    * Developer (2 hours integration X 10 + 1 hour every 3 days for managing the proxies): \~3 days of work a month or \~\$900

    Your total cost per month will be at least \$1400 for just these things alone, and the salary of \$30 per hour for a developer is very conservative. Additionally, this doesn't account for a lack of information reliability if your target website sends misinformation before blocking you or if your information flow is cut every few days, which can be detrimental to your brand or your revenue stream.

    **Assuming you choose Bright Data residential proxies:** You buy a basic package of 40GB with access to unlimited residential IPs. It takes 2 hours to integrate your scraper. Due to Bright Data's pool of 400M+ residential IPs, your target website can't detect your scraper, allowing you to focus on other projects.

    The bandwidth and unlimited IPs cost just \$500 per month. Your information is always reliable because your requests are always successful and access is never cut in the middle of the month. When your business grows as a result of this scraping and your projects exceed 600MB each month, the difference in costs can be much higher than just \~\$1000.

    Bright Data also allows you to suspend your account when not in use, so your cost can be lower than \$500 per month. Start by using the \$5 voucher for free data-center traffic to test Bright Data's benefits and then ask for access to our residential network for cheap and reliable data collection.
  </Accordion>

  <Accordion title="What is the yellow warning icon next to my zone name?">
    > **This is a reminder to setup your allowlist access**

    To restrict your proxy zone access from unauthorized servers, we recommend you setup an IP allowlist. This will ensure only IPs you recognize will be allowed to access your proxy zone, for higher security and control.

    Consult your IT or networking specialist to make sure your outgoing IP is fixed and does not change, otherwise you may block yourself or other authorized users from your company to access the proxy zone.
  </Accordion>

  <Accordion title="How to restrict access using Token-based Authentication">
    This workflow is optimal when using multiple crawlers with rotating IPs that target the Proxy Manager installed remotely. This method requires you API key an Authentication token.

    Run From inside the remote server the next command in Terminal/CMD

    ```sh theme={null}
    curl -X GET "http://127.0.0.1:22999/api/gen_token" -H "accept: application/json"
    ```

    This will generate an API key as an authentication token for you:

    ```sh Output theme={null}
    "token":"<API_KEY>"
    ```

    Now you can simply send a request using the API key you just created:

    ```sh theme={null}
    curl -x token:<API_KEY>@<remote-server-IP>:<Port> "target-site.com"
    ```
  </Accordion>

  <Accordion title="Is there a way to know if my publicly-available data was collected by Bright Data's collection platform?">
    > **Yes**

    You can check if your public data was collected here: [https://brightdata.com/check\_your\_data](https://brightdata.com/check_your_data).
  </Accordion>

  <Accordion title="Do you only collect public data or do you also collect private data?">
    We never collect private data. We only collect publicly-available data.
  </Accordion>

  <Accordion title="What is Playground mode?">
    When you sign up, your account automatically enters a free trial "Playground mode" for the first 7 days, allowing you to instantly try different Bright Data solutions. No credit card or any other form of payment method is needed.

    Separately, every new account also gets a recurring [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month for the Web Unlocker API, SERP API, Web Scraper API, Scraper Studio and Browser API. These credits renew on the first of each month and do not expire with the trial.

    You can extend this free trial to **30 days** and **unlock Proxy and Web Unlocker API usage**. To do so and receive a \$5 free credit, [verify your account](https://brightdata.com/cp/billing_flow) to start our Limited 30-day trial. Note that the 30-day trial does not apply to certain countries.

    <Info>
      During Playground mode, **Proxy Networks** (Residential, Mobile, ISP, Datacenter) and **Web Unlocker API** are not available for accounts registered with personal email addresses and no payment method on file. Adding a payment method removes this restriction. See [Payment Verification](/general/account/billing-and-pricing/payment-verification).
    </Info>

    <Note>
      Playground mode is a free trial intended for small-scale testing and exploration, not for large-scale tests or production use. Product usage is subject to limitations such as speed, bandwidth, and requests per second until you [verify your account](https://brightdata.com/cp/billing_flow) and start our [Limited Trial](/general/faqs#what-is-limited-trial-mode).
    </Note>

    <Note>
      While operating in Playground mode (or any unfunded state), requests across the SERP API, Web Unlocker API and Proxies are subject to a default rate limit of 1,000 requests per minute. You can verify your current rate limit in the Control Panel, under the zone's Overview tab > Access details.
    </Note>
  </Accordion>

  <Accordion title="What is Limited Trial mode?">
    **Limited Trial** mode if a free trial period that allows you to freely explore our Bright Data proxy solutions without immediate payment. You'll receive a \$5 credit to use any of our proxy services for a period of 30 days, giving you a full month to test and experience our offerings.

    Note that the 30-day trial does not apply to certain countries. If you don't see this option, add funds to your account to start using Bright Data - you can add as little as \$10 to get started with a Pay as You Go plan.

    #### How do I verify my account to start the “Limited Trial” and receive a \$5 credit?

    Account verification is simple and free. Just [add a valid payment method](https://brightdata.com/cp/billing_flow) to your account to start **Limited Trial** mode and receive your \$5 credit. You will not be charged.

    #### What happens after the 30-day trial?

    At the end of the 30-day trial period, your \$5 proxy trial credit expires (if not already used), and you will need to add funds to your account to keep using the proxy products. The recurring [free tier](/general/account/billing-and-pricing/free-tier) of 5,000 credits per month for the Web Unlocker API, SERP API, Web Scraper API, Scraper Studio and Browser API is unaffected and continues to renew monthly.

    #### Can I use the free credit on any of your proxy products?

    Yes, the \$5 trial credit can be used on any of our proxy products during the duration of the trial, allowing you to test the products that best fit your needs.
  </Accordion>

  <Accordion title="Why can't I connect to brightdata.com site or dashboard?">
    In rare cases, some ad-blocking program/extensions can block access to Bright Data sites. If you encounter any issues, allowlist brightdata.com or disable the ad-blocker.
  </Accordion>

  <Accordion title="Where can I see the list of country codes?">
    Below is the list of ISO 3166 country codes.  **Not** all the countries in the list have Bright Data proxies, most of the countries do.

    | Country Name | Country code |
    | - | - |
    | Åland Islands | ax |
    | Zimbabwe | zw |
    | Zambia | zm |
    | Yemen | ye |
    | Western Sahara | eh |
    | Wallis and Futuna | wf |
    | Virgin Islands (U.S.) | vi |
    | Virgin Islands (British) | vg |
    | Viet Nam | vn |
    | Venezuela (Bolivarian Republic of) | ve |
    | Vanuatu | vu |
    | Uzbekistan | uz |
    | Uruguay | uy |
    | United States of America (the) | us |
    | United States Minor Outlying Islands (the) | um |
    | United Kingdom of Great Britain and Northern Ireland (the) | gb |
    | United Arab Emirates (the) | ae |
    | Ukraine | ua |
    | Uganda | ug |
    | Tuvalu | tv |
    | Turks and Caicos Islands (the) | tc |
    | Turkmenistan | tm |
    | Turkey | tr |
    | Tunisia | tn |
    | Trinidad and Tobago | tt |
    | Tonga | to |
    | Tokelau | tk |
    | Togo | tg |
    | Timor-Leste | tl |
    | Thailand | th |
    | Tanzania, United Republic of | tz |
    | Tajikistan | tj |
    | Taiwan (Province of China) | tw |
    | Syrian Arab Republic | sy |
    | Switzerland | ch |
    | Sweden | se |
    | Svalbard and Jan Mayen | sj |
    | Suriname | sr |
    | Sudan (the) | sd |
    | Sri Lanka | lk |
    | Spain | es |
    | South Sudan | ss |
    | South Georgia and the South Sandwich Islands | gs |
    | South Africa | za |
    | Somalia | so |
    | Solomon Islands | sb |
    | Slovenia | si |
    | Slovakia | sk |
    | Sint Maarten (Dutch part) | sx |
    | Singapore | sg |
    | Sierra Leone | sl |
    | Seychelles | sc |
    | Serbia | rs |
    | Senegal | sn |
    | Saudi Arabia | sa |
    | Sao Tome and Principe | st |
    | San Marino | sm |
    | Samoa | ws |
    | Saint Vincent and the Grenadines | vc |
    | Saint Pierre and Miquelon | pm |
    | Saint Martin (French part) | mf |
    | Saint Lucia | lc |
    | Saint Kitts and Nevis | kn |
    | Saint Helena, Ascension and Tristan da Cunha | sh |
    | Saint Barthélemy | bl |
    | Réunion | re |
    | Rwanda | rw |
    | Romania | ro |
    | Republic of North Macedonia | mk |
    | Qatar | qa |
    | Puerto Rico | pr |
    | Portugal | pt |
    | Poland | pl |
    | Pitcairn | pn |
    | Philippines (the) | ph |
    | Peru | pe |
    | Paraguay | py |
    | Papua New Guinea | pg |
    | Panama | pa |
    | Palestine, State of | ps |
    | Palau | pw |
    | Pakistan | pk |
    | Oman | om |
    | Norway | no |
    | Northern Mariana Islands (the) | mp |
    | Norfolk Island | nf |
    | Niue | nu |
    | Nigeria | ng |
    | Niger (the) | ne |
    | Nicaragua | ni |
    | New Zealand | nz |
    | New Caledonia | nc |
    | Netherlands (the) | nl |
    | Nepal | np |
    | Nauru | nr |
    | Namibia | na |
    | Myanmar | mm |
    | Mozambique | mz |
    | Morocco | ma |
    | Montserrat | ms |
    | Montenegro | me |
    | Mongolia | mn |
    | Monaco | mc |
    | Moldova (the Republic of) | md |
    | Micronesia (Federated States of) | fm |
    | Mexico | mx |
    | Mayotte | yt |
    | Mauritius | mu |
    | Mauritania | mr |
    | Martinique | mq |
    | Marshall Islands (the) | mh |
    | Malta | mt |
    | Mali | ml |
    | Maldives | mv |
    | Malaysia | my |
    | Malawi | mw |
    | Madagascar | mg |
    | Macao | mo |
    | Luxembourg | lu |
    | Lithuania | lt |
    | Liechtenstein | li |
    | Libya | ly |
    | Liberia | lr |
    | Lesotho | ls |
    | Lebanon | lb |
    | Latvia | lv |
    | Lao People's Democratic Republic (the) | la |
    | Kyrgyzstan | kg |
    | Kuwait | kw |
    | Korea (the Republic of) | kr |
    | Korea (the Democratic People's Republic of) | kp |
    | Kiribati | ki |
    | Kenya | ke |
    | Kazakhstan | kz |
    | Jordan | jo |
    | Jersey | je |
    | Japan | jp |
    | Jamaica | jm |
    | Italy | it |
    | Israel | il |
    | Isle of Man | im |
    | Ireland | ie |
    | Iraq | iq |
    | Iran (Islamic Republic of) | ir |
    | Indonesia | id |
    | India | in |
    | Iceland | is |
    | Hungary | hu |
    | Hong Kong | hk |
    | Honduras | hn |
    | Holy See (the) | va |
    | Heard Island and McDonald Islands | hm |
    | Haiti | ht |
    | Guyana | gy |
    | Guinea-Bissau | gw |
    | Guinea | gn |
    | Guernsey | gg |
    | Guatemala | gt |
    | Guam | gu |
    | Guadeloupe | gp |
    | Grenada | gd |
    | Greenland | gl |
    | Greece | gr |
    | Gibraltar | gi |
    | Ghana | gh |
    | Germany | de |
    | Georgia | ge |
    | Gambia (the) | gm |
    | Gabon | ga |
    | French Southern Territories (the) | tf |
    | French Polynesia | pf |
    | French Guiana | gf |
    | France | fr |
    | Finland | fi |
    | Fiji | fj |
    | Faroe Islands (the) | fo |
    | Falkland Islands (the) \[Malvinas] | fk |
    | Ethiopia | et |
    | Eswatini | sz |
    | Estonia | ee |
    | Eritrea | er |
    | Equatorial Guinea | gq |
    | El Salvador | sv |
    | Egypt | eg |
    | Ecuador | ec |
    | Dominican Republic (the) | do |
    | Dominica | dm |
    | Djibouti | dj |
    | Denmark | dk |
    | Côte d'Ivoire | ci |
    | Czechia | cz |
    | Cyprus | cy |
    | Curaçao | cw |
    | Cuba | cu |
    | Croatia | hr |
    | Costa Rica | cr |
    | Cook Islands (the) | ck |
    | Congo (the) | cg |
    | Congo (the Democratic Republic of the) | cd |
    | Comoros (the) | km |
    | Colombia | co |
    | Cocos (Keeling) Islands (the) | cc |
    | Christmas Island | cx |
    | China | cn |
    | Chile | cl |
    | Chad | td |
    | Central African Republic (the) | cf |
    | Cayman Islands (the) | ky |
    | Canada | ca |
    | Cameroon | cm |
    | Cambodia | kh |
    | Cabo Verde | cv |
    | Burundi | bi |
    | Burkina Faso | bf |
    | Bulgaria | bg |
    | Brunei Darussalam | bn |
    | British Indian Ocean Territory (the) | io |
    | Brazil | br |
    | Bouvet Island | bv |
    | Botswana | bw |
    | Bosnia and Herzegovina | ba |
    | Bonaire, Sint Eustatius and Saba | bq |
    | Bolivia (Plurinational State of) | bo |
    | Bhutan | bt |
    | Bermuda | bm |
    | Benin | bj |
    | Belize | bz |
    | Belgium | be |
    | Belarus | by |
    | Barbados | bb |
    | Bangladesh | bd |
    | Bahrain | bh |
    | Bahamas (the) | bs |
    | Azerbaijan | az |
    | Austria | at |
    | Australia | au |
    | Aruba | aw |
    | Armenia | am |
    | Argentina | ar |
    | Antigua and Barbuda | ag |
    | Antarctica | aq |
    | Anguilla | ai |
    | Angola | ao |
    | Andorra | ad |
    | American Samoa | as |
    | Algeria | dz |
    | Albania | al |
    | Afghanistan | af |
  </Accordion>

  <Accordion title="Can I use Bright Data as a VPN for my PC?">
    Not really. Bright Data is a service for enterprise customers who want to collect public web data from the Internet, and is not designed for private users.

    In addition, using Bright Data does not encrypt your Internet traffic.

    If you want a free VPN, we recommend you check out [BrightVPN](https://brightvpn.com) - it is available for Windows and macOS.
  </Accordion>

  <Accordion title="Can I use the direct Bright Data API to manage my account?">
    Yes, we have extensive coverage of actions that can be performed programmatically via code by using our direct API to manage your account and proxies/zones - you can perform actions like adding or deleting zones, managing IP allowlists/denylists, fetch a list of IPs allocated to your zone, get billing balance and so on. For more detailed and accurate information, please see our API documentation section - [Account Management API Documentation](/api-reference/account-management-api)
  </Accordion>

  <Accordion title="How can I add my company details to the invoice?">
    You can add your company details in the [Account Settings](https://brightdata.com/cp/setting/customer_details), and your monthly invoices will be addressed to your company automatically.
  </Accordion>

  <Accordion title="How can I change/update the email address on my account?">
    You cannot directly "change" or "update" the email address in your account. But, you *can* create a new user with the new email address, and then delete the "old" user - this would achieve the same desired result as updating/changing/replacing your email address.
  </Accordion>

  <Accordion title="How to access proxies with IP allowlist only? (IP:PORT method)">
    To gain access your proxies by IP allowlist authentication only (IP:PORT), without using the API key authentication method or the USERNAME:PASSWORD authentication method, you can utilize the [Proxy Manager](/products/proxy-manager/introduction) tool.
  </Accordion>

  <Accordion title="How much time does it take to get a KYC decision and how can I see my account verification status? ">
    It usually takes up to 2 business days to review your KYC request. However, if your submission does not include all the information, or the documentation submitted is unclear visually, outdated or incorrect the KYC can take longer.

    To check your account verification status browse to the control panel, under account settings -> Profile. In there you can see your verification status as one of: `not submitted` , `in progress` , `approved` or `denied`.

    Click this link to view the status: [https://brightdata.com/cp/setting/customer\_details](https://brightdata.com/cp/setting/customer_details)
  </Accordion>

  <Accordion title="Can I use personal email for KYC?">
    No, only company email addresses are accepted for KYC verification.
  </Accordion>

  <Accordion title="Where can I see the legal restrictions and policies of Bright Data?">
    To see our legal restrictions and policies, please see the following page: [Bright Data Master Service Agreement](https://brightdata.com/license)
  </Accordion>

  <Accordion title="How can I contact Bright Data Support/Account Manager/Sales/Compliance? ">
    If you need to reach out to our staff, you can do that either through the Help & Support section in the control panel - in the top right section of the screen under the question mark icon (?) or by emailing [sales@brightdata.com](mailto:sales@brightdata.com), [support@brightdata.com](mailto:support@brightdata.com) or [compliance@brightdata.com](mailto:compliance@brightdata.com)

    Note: assistance from our staff is only provided to paying customers or customers who are employees of an enterprise. If the option to contact support is not available via the control panel, please add funds to your account and the option will be unlocked.
  </Accordion>

  <Accordion title="What is zproxy.lum-superproxy.io? ">
    zproxy.lum-superproxy.io is a deprecated proxy integration endpoint that was used by Bright Data in the past - It should not be used anymore as it has been replaced with: `brd.superproxy.io`
  </Accordion>

  <Accordion title="When should i use scrapers and when should i use datasets?">
    **When should I use scrapers vs. datasets?**

    * Use Scrapers: When you need fresh or real-time data (e.g., prices, news, or live updates) or if the data isn’t available in existing datasets. Scrapers are ideal for tracking changes over time or gathering niche, specific information directly from websites.
    * Use Datasets: When you need historical data or pre-collected, and structured information. Datasets save time and effort, especially for machine learning, analytics, or research, but may not always be up-to-date.

    For ongoing projects, you can combine datasets for historical context and scrapers for real-time updates.
  </Accordion>

  <Accordion title="I want to DELETE my account">
    If you wish to completely delete your account:

    * Go to Settings -> Account Settings -> Profile.
    * Click on Delete account

    Notice that:

    * This action cannot be undone.
    * All your data and settings will be lost
    * All users will be logged out and lose access to the Bright Data Control Panel
  </Accordion>

  <Accordion title="How do I find my Bright Data account ID? ">
    Your Bright Data account ID is a component in your proxy username credentials, and when asking for support, you may need to provide it so a support engineer can provide a proper answer.

    Your account ID and login to Bright Data control panel **are not** your proxy logins. Each zone has its own username and password to access.

    You can see your bright data account ID if you click the User icon on the top right part of your control panel, or by browsing to : "Account settings" on the left menu and selecting the "Profile" tab. You can access the profile tab directly by using this link: [https://brightdata.com/cp/setting/customer\_details](https://brightdata.com/cp/setting/customer_details)
  </Accordion>

  <Accordion title="What do I need to do to submit KYC?">
    In order to submit a KYC you must register to [BrightData.com](http://BrightData.com) with a **company email** Free emails like `***@google`.com or `***@yahoo.com` com are not eligible to submit a KYC. Requests from free email providers are not allowed and rejected on the spot.

    During the process, you will be required to provide proof of identity, business identity and ownership/role as well as your business use cases.
  </Accordion>
</AccordionGroup>


# Acceptable use policy
Source: https://docs.brightdata.com/general/policy/acceptable-use-policy

Bright Data's Acceptable Use Policy defines permitted and prohibited platform uses across 4 product areas, including restrictions on illegal activity.

Bright Data’s platform, technology, and network (collectively, “Services”) are meant for legitimate and legal purposes only and are subject to the [Bright Data Master Service Agreement](https://brightdata.com/license).

Bright Data takes and will take firm action against illegal or non-compliant use of the Bright Data Services, and will assist law enforcement in investigating potentially abusive activities of the Bright Data Services.

Any use of the Bright Data Services for illegal, fraudulent, or abusive activities is strictly prohibited. Any such suspected use will be investigated.

Forbidden activities include, but are not limited to:

* Collection of nonpublic information (i.e data behind login)
* DDoS attacks
* Spam: mass posting any mail/message boards/IRC/comments messages and images
* Ad fraud or click fraud
* Impersonation or spoofing for fraudulent purposes
* Creating fake accounts or content
* Use of automatic ticket purchasing (ticket-bots)
* Raffles, lottery, or gambling
* Fake engagement (likes, comments, shares, etc.)
* Gaming or trading of in games items/currency
* Reselling of proxies without Bright Data’s prior written approval (see our [partners programs](https://brightdata.com/partners))
* Use of streaming related domains (videos, music or images streaming)
* Trading crypto/virtual currency or NFT
* Any Search Engine Optimization (SEO) manipulation (i.e: fake clicks in search engines results)
* Posting on classified, used, and resell sites (such as Craig’s list)
* Completion of surveys in return for a benefit or anything of value
* Any form of activity that is in violation of applicable law or regulations or any third party rights

Bright Data proactively blocks certain web content (i.e: Adult content, Governmental websites, Harmful domains, etc.), as determined by Bright Data in its sole and exclusive discretion. Bright Data reserves the right to add or retract, at any time and at its sole discretion, any web content blocking.

Use of Bright Data Services may be limited by Bright Data in its sole discretion in order to prevent any damage or service disruption to any third party computers or service. Bright Data shall not be liable towards Client for any limits imposed as described herein.

We encourage users to report any misuse or suspicious activity in our network through our dedicated email ([abuse@brightdata.com](mailto:abuse@brightdata.com)) or our reporting channel ([https://brightdata.com/report-abuse](https://brightdata.com/report-abuse)) .


# App privacy and security
Source: https://docs.brightdata.com/general/privacy/privacy-and-security-for-apps

How Bright Data ensures the privacy and security of users who install its apps across 3 protections: open-source SDK, sandboxing and user controls.

Bright Data takes the privacy and security of its users very seriously and has internal procedures and tests aimed specifically at this area that run 24/7. Aside from this we do several external audits a year that include all security and privacy aspects of the software running on the user's devices. However this wasn't enough for us. We want the security and privacy of our users to be clear, transparent and self-evident. We are working on these drastic steps that will be completed by the end of 2021:

* Making the Bright Peer SDK open source. Anyone can look at the code, breakdown our production releases and compare the code and validate it's identical. Every internal release we do is pushed out to open source for the public eye.
* Running the Bright SDK in a sandbox environment. No matter what privileges the user installs the Bright App with, it will always be constrained by the sandbox it's running in. So even if given root access it will not be able to actually collect anything from the user\`s private data.
* Adding full user control. Bright app users can now fully control when their devices will be available as peers on the network, what bandwidth will be allocated to it, resource levels and even low level control over the target domains that are allowed through the device. Everything is transparent and configurable.
* Collaboration with a known security company to secure the network traffic going through the residential network. Every target domain goes through real time updated denylists and sites that are marked as malicious, containing malware or any other illegal content are blocked before any traffic can be sent through the user\`s device


# Protecting end user resources
Source: https://docs.brightdata.com/general/privacy/protect-end-users-resources

How Bright Data's idle monitor technology protects end users' battery, bandwidth and data plan across 3 resource categories when the device is a network node.

Bright Data's patented idle monitor technology ensures that an end user's device is used under strict limitations so that battery power, bandwidth and data plan are preserved. These limitations consist of a monitor that restricts the usage of the device if being used by the end user, a minimum battery level threshold, a preference for use only when charging, a maximum daily allowed bandwidth usage per device and weekly maximum usage.

## Are Bright Data Apps exposed to the user's private network traffic?

> **No**

Bright Data Apps are not exposed to the users' private network traffic, don't gather it, log it, or send it anywhere. We are not interested in it, it's not our business and this was always the case.

In mobile operating systems Bright Data software is limited by the permissions infrastructure and so cannot access private data. On desktop operating systems Bright Data is in the process of releasing a new version of its software that will run inside a sandbox that will make it very clear that it does not have access to any User private information.


# How does Bright Data handle abuse report?
Source: https://docs.brightdata.com/general/security/abuse-report-handling

How Bright Data handles abuse reports: domain blocking, traffic investigation, and escalation to the compliance and legal team.

Each abuse report arrives to the compliance team. The validity and authenticity of the reporter is validated and an abuse procedure is opened. The procedure covers in detail who is responsible for the process, who does the investigation, who needs to be notified in and out of the company, etc.

First of all the domain that is allegedly being targeted is blocked as a preventive measure so that if there is real harm in progress we will stop it while investigating the claim.

The submitted logs are analyzed and traffic traced back to its source. If the abuse is validated all the information is transferred to the compliance officer and legal team to take the proper actions.

If the reporter wants to pursue legal action they can do so with the local authorities and Bright Data will cooperate with any official investigation.


# Allowlist and denylist IPs and domains
Source: https://docs.brightdata.com/general/security/allowlist-denylist-ips-domains

Configure allowlists and denylists for IPs and domains in your Bright Data proxy zone (port 44445) to control who can access it for traffic security.

## Key terms defined

* Allowlist is the list of IP addresses which are permitted accessing your zone.
* Denylist is the list of IP addresses which are denied accessing your zone.

<Note>
  The Allowlist shall include the IP addresses from which you **originate the requests** to the proxies in your company or cloud network. The list **should not** include the IPs of the proxies provided by Bright Data.
</Note>

## How to configure Allowslit and Denylist

There are two ways to configure the allowlist and the denylist: either by the control panel or by using Bright Data account management APIs.

### How to configure Allowlist and Denylist via the control panel

1. Log in to your Bright Data account control panel.
2. Select the zone which you want to modify and go to the **Overview** tab.
3. Under the overview tab, in the \*\*Access Details \*\*section, there is an edit icon to edit the lists.
4. Click the edit icon.

<img alt="editAllowlist.png" />

5. This will get you to the configuration tab, under security settings, to edit the lists:

<img alt="whitelist-blacklist.png" />

Add all the relevant IPs and domains you'll allow access to with your proxy zone.

### How to configure Allowlist and Denylist via Bright Data Account management APIs

The following APIs will enable you to control and manage your allowlist and denylist:

* [Add IP to Zone allowlist](/api-reference/account-management-api/allowlist-ip)
* [Remove IP from Zone allowlist](/api-reference/account-management-api/remove-ip-from-zone-allowlist)
* [Add IP to Zone denylist](/api-reference/account-management-api/denylist-ip)
* [Remove IP from Zone denylist](/api-reference/account-management-api/remove-ip-from-zone-denylist)
* [Remove domain from Zone allowlist/denylist](/api-reference/account-management-api/remove-domain-from-zone-allowlist-or-denylist)
* [Add domain to Zone allowlist/denylist](/api-reference/account-management-api/allowlist-or-denylist-domains)

## What are the best practices of allowlist and denylist definition?

*
* Accurate allowlist prevents abuse of your Bright Data proxies, protects your operations and funds. See more info within [this video.](https://brightdata.com/static/video/howto/blacklist_system_explanation.mp4?md5=153602994-22bce32a\&hver=2)
* There is **no limit** on how many IPs/domains you can add to the allowlist and we also support ranges of IPs.
* When you work from a public cloud, where your scrapers spawn on different IPs, the allowlist will need to constantly change and adjust to incoming requests origin IP. To prevent constant changes, we recommend that your setup a permanent outgoing IP for your cloud operations which interact with Bright Data. Consult you cloud provided on available solutions. Common solution is NAT gateway setup for outgoing communication.
* For easier management and control, we recommend to use wildcards and patterns to define domains or IP ranges in your list.

### Which wildcards and patterns do we support for allowlist and denylist configuration?

We support the following patterns for domain names and IPs/subnets/masks:

| Pattern | Description | Example |
| - | - | - |
| `*`  (asterix) | Mathced all strings | \*  - Will match all IPs/domains |
| `*`  (asterix) | Embedded in string, will match all substrings (prefix) | `*.mycompany.net` will match all domains ending with `.mycompany.net` |
| `*`  (asterix) | Embedded in string, will match all substrings (suffix) | `sub.mycompany.*` will match all suffixes (like net, com, us etc.) |
| `a.b.c.d` | a,b,c,d are all numbers between 0-255, this pattern represents a single IP address | `195.55.35.112` |
| `a.b.c.0/24` | This patterns represents a whole /24 subnet, which means all IP addresses with the a.b.c prefix and 0-255 as 'd' number. | `195.55.35.0/24 ` |
| `a.b.c.d - x.y.z.w` | Range of IPs between a.b.c.d and x.y.z.w | `10.20.30.40-10.20.30.50` |
| `a.b.c.d/x.y.z.w` | Netmask: A netmask separates the IP address into network and host parts. Similar to the use of subnets. | `10.20.30.40/255.255.252.0` |


# Bright Data network security
Source: https://docs.brightdata.com/general/security/network-security

How Bright Data secures its virtual ISP network across 4 layers: registration requirements, DDoS prevention, domain denylisting and traffic monitoring.

Most of the traffic that goes through both a regular ISP and a virtual ISP is encrypted with an SSL tunnel so its content is not visible to the ISP. Due to this the methods to secure the network and prevent illegal activities available to ISPs are limited and are mostly targeted at large scale DDoS prevention and domain denylists. However at Bright Data we do a lot more:

| Element | Bright Data Virtual ISP | Regular ISP |
| - | - | - |
| Requires registration | Yes | Yes |
| Requires payment method | Yes | Yes |
| Methods and procedures for reporting abuse | Yes | Yes |
| Online DDoS detection | Yes | Yes |
| Full block of the most popular DDoS methods <sup>[2](#myfootnote2)</sup> | Yes | No |
| KYC procedure per customer | Yes | No |
| Compliance alert if customer starts targeting domains not reported during KYC | Yes | No |
| Deploy active blocks for Ad frauds, fake reviews, fake likes, fake account creations, spamming, etc | Yes<sup>[1](#myfootnote1)</sup> | No |
| Block service level abuse or attack with non web traffic <sup>[3](#myfootnote3)</sup> | Yes | No |

***

> **Bottom line**\
> Bright Data virtual ISP network is much safer and less likely to be used for attacks and abuse than a regular ISP.

<Warning>
  Bright Data does not allow using its products and systems to render any network resource unavailable to its intended users, including, without limitation, via Denial-of-Service (**DoS**) or Distributed Denial-of-Service (**DDoS**) attack
</Warning>

***

<sub><a name="myfootnote1">1</a>: Applied to 30% of the traffic and planned to reach > 90% by end of 2022</sub><br />
<sub><a name="myfootnote2">2</a>: Methods that were used in the top 90% of DDoS attacks of 2021: UDP fragmentation, DNS reflection, UDP volumetric, LDAP reflection, DNS query, NTP reflection, ICMP (volumetric),</sub><br />
<sub><a name="myfootnote3">3</a>: Non web traffic is any traffic that is not HTTP protocol or targeting ports different from the standard HTTP ports of `80/443`.</sub>


# Security & compliance
Source: https://docs.brightdata.com/general/security/security-overview

Bright Data security and compliance: ISO 27001, SOC 2, regular penetration testing and encryption, covering MCP server, Browser API and all Bright Data APIs.

<Note>
  All three ISO certifications are explicitly scoped to *"a public web data collection platform designed for high-scale collection, automation, and AI agent / RAG systems for web data access."* This directly covers use of Bright Data's MCP Server, Browser API, and all APIs in agentic workflows.
</Note>

## Certifications at a Glance

<CardGroup>
  <Card title="ISO/IEC 27001:2022" icon="certificate">
    Information Security Management System (ISMS)
    **Valid until:** Aug 11, 2028
    **No.** 1126059 - SII–QCD (ANAB Accredited)
  </Card>

  <Card title="ISO/IEC 27017:2015" icon="cloud">
    Cloud Security Controls
    **Valid until:** Jul 13, 2028
    **No.** 1125290 - SII–QCD
  </Card>

  <Card title="ISO/IEC 27018:2019" icon="user-shield">
    Protection of PII in Public Clouds
    **Valid until:** Jul 13, 2028
    **No.** 1125291 - SII–QCD
  </Card>

  <Card title="SOC 2 Type II" icon="file-shield">
    Available under NDA
    **Period:** Jun 1, 2024 – May 31, 2025
    Audited by Deloitte Global Network
  </Card>

  <Card title="SOC 3" icon="file-check">
    Publicly downloadable
    **Period:** Jun 1, 2024 – May 31, 2025
    Audited by Brightman Almagor Zohar & Co.
  </Card>

  <Card title="CSA STAR" icon="star">
    Cloud Security Alliance Registry
    [View listing →](https://cloudsecurityalliance.org/star/registry/bright-data/)
  </Card>
</CardGroup>

***

## How independent audits work

### SOC 3 Report - Deloitte

Conducted by **Brightman Almagor Zohar & Co., a firm in the Deloitte Global Network**, covering **June 1, 2024 – May 31, 2025**.

The audit examined controls across four trust service criteria:

<CardGroup>
  <Card title="Security" icon="lock">
    Protection against unauthorized access to systems and data
  </Card>

  <Card title="Availability" icon="signal">
    Uptime commitments and disaster recovery readiness
  </Card>

  <Card title="Confidentiality" icon="eye-slash">
    Data classification, encryption, and access controls
  </Card>

  <Card title="Privacy" icon="user-lock">
    GDPR/CCPA compliance and PII handling procedures
  </Card>
</CardGroup>

> *"In our opinion, management's assertion that the controls within the Service Organization's system were effective... to provide reasonable assurance that Bright Data's service commitments and system requirements were achieved based on the applicable trust services criteria is fairly stated, in all material respects."*
>
> * Brightman Almagor Zohar & Co. (Deloitte Global Network)

<Card title="Download SOC 3 Report (PDF)" icon="download" href="https://brightdata.com/static/Bright_Data_SOC_3_June_1_2024_May_31_2025_Updated.pdf">
  Full SOC 3 report covering June 1, 2024 – May 31, 2025
</Card>

***

### Penetration Test - Skylight Cyber Security

An independent penetration test and source code review was conducted by **Skylight Cyber Security Pty Ltd** (May–June 2025), covering the full Bright Data product surface.

**Products tested:**

| Product | Coverage |
| - | - |
| Control Panel & Public APIs | Full |
| Datacenter, Residential, Mobile, and ISP Proxies | Full |
| SERP API and Web Unlocker API | Full |
| Web Scraper IDE, Marketplace, and API | Full |
| Web Archive API | Full |
| Dataset Marketplace and Custom Dataset API | Full |

**Three threat scenarios were in scope:**

1. Unauthenticated attacker attempting to compromise the entire platform
2. Malicious administrator attempting internal compromise
3. Unauthorized account access or proxy misuse

<Info>
  **Result:** All Critical and High severity findings were remediated. Skylight re-tested to confirm the findings were addressed and the risk was mitigated.
</Info>

<Card title="Download Penetration Test Attestation" icon="file-shield" href="https://brightdata.com/trustcenter">
  Attestation letter from Skylight Cyber Security Pty Ltd
</Card>

***

## How data encryption works

| Layer | Standard |
| - | - |
| **Data in transit** | TLS 1.3 (minimum TLS 1.2) with modern cipher suite |
| **Data at rest** | AES-256 or better across all infrastructure |
| **Credentials** | Hashed and salted using a modern hash function |
| **Database backups** | Encrypted; daily full backups, monthly snapshots |
| **Backup storage** | AWS Backup; snapshots distributed across locations |

***

## Infrastructure & Availability

<CardGroup>
  <Card title="Cloud Provider" icon="aws">
    Amazon Web Services (AWS), multi-Availability Zone deployment
  </Card>

  <Card title="Disaster Recovery" icon="rotate">
    DR site on AWS EU; annual large-scale DR drills; RCA for all high-severity incidents
  </Card>

  <Card title="Backup Frequency" icon="database">
    Full database backup every 5 minutes; daily AWS snapshots; critical backups on Microsoft Azure
  </Card>

  <Card title="DDoS & Monitoring" icon="shield">
    Active DDoS mitigation and rate limiting; continuous firewall monitoring by dedicated InfoSec team
  </Card>
</CardGroup>

***

## Access Control & Identity

| Control | Implementation |
| - | - |
| **Least privilege** | All IAM roles scoped to minimum required permissions |
| **MFA** | Required for all AWS platform access by employees |
| **Customer authentication** | Strong password (min. 8 chars) + email verification |
| **RBAC** | Role-Based Access Control with regular user access reviews |
| **Third-party access** | Re-authorized annually; requires signed NDA and InfoSec approval |
| **Remote access** | VPN with encryption required; host-check enforced |

***

## Application & Development Security

* **CI/CD pipeline** - Controlled pipeline with end-to-end and unit testing, including authorization testing
* **Secure SDLC** - Based on the OWASP Top 10 framework; security requirements defined before development begins; annual developer security training
* **Change management** - Formal review and approval process for all infrastructure and application changes, including security risk evaluation at R\&D review stage
* **Third-party risk (TPRM)** - All vendors mapped and classified by risk tier; high-risk suppliers require security questionnaire and InfoSec sign-off before contract
* **Bug bounty** - Managed private program for responsible disclosure by independent security researchers

***

## Privacy & Regulatory Compliance

| Regulation / Standard | Status |
| - | - |
| GDPR (EU) | ✅ Compliant - DPIAs conducted as part of product flows |
| CCPA (California) | ✅ Compliant |
| UK Data Protection Act | ✅ Compliant |
| Virginia Privacy Law | ✅ Compliant |
| Israeli Privacy Protection Law (1981) | ✅ Compliant |
| ISO 27001:2022 | ✅ Certified |
| CSA STAR | ✅ Listed |
| PCI DSS | ✅ Working compliance |

* **Privacy policy** reviewed and updated annually - [brightdata.com/privacy](https://brightdata.com/privacy)
* **Customer data deletion** available at any time upon request
* **Data selling** - Bright Data does not sell or license customer data to any third party

***

## Information Security Policy

Bright Data maintains a formal, board-approved Information Security Policy aligned with **NIST, ISO 27001:2022, ISO 27017, and ISO 27018**.

<AccordionGroup>
  <Accordion title="Identity & Access Management">
    IAM policies enforcing least-privilege access across all systems, with regular audits and annual reviews.
  </Accordion>

  <Accordion title="Network & Encryption">
    Network segmentation, TLS 1.3 in transit, AES-256 at rest, and modern cipher suites throughout.
  </Accordion>

  <Accordion title="Endpoint & Server Hardening">
    CIS Benchmarks applied to all endpoints and servers.
  </Accordion>

  <Accordion title="Secure SDLC">
    Security requirements defined before development begins; OWASP Top 10 framework; annual developer training.
  </Accordion>

  <Accordion title="Third-Party & Vendor Security">
    All vendors classified by risk tier; high-risk suppliers require security questionnaire and InfoSec sign-off.
  </Accordion>

  <Accordion title="Data Classification">
    Three-tier classification: Sensitive, PII, and Public - with controls applied per tier.
  </Accordion>

  <Accordion title="Incident Response & Business Continuity">
    Incident reporting, RCA for high-severity events, annual DR drills, and a formal BCP.
  </Accordion>
</AccordionGroup>

***

## Security for AI Agents & MCP Users

Bright Data's MCP Server and Browser API operate under the same certified security infrastructure described on this page.

<Warning>
  Always treat scraped web content as **untrusted input**. Validate and filter data before passing it to an LLM prompt to mitigate prompt injection risks.
</Warning>

**Recommended practices when using Bright Data in agentic workflows:**

<Steps>
  <Step title="Treat web content as untrusted">
    Validate and filter web data before passing it to an LLM prompt - this mitigates prompt injection attacks.
  </Step>

  <Step title="Use structured extraction tools">
    Prefer `web_data_*` tools where available - they return pre-validated, schema-consistent data.
  </Step>

  <Step title="Store credentials securely">
    Store API keys as environment variables. Never hardcode credentials in agent code or prompts.
  </Step>

  <Step title="Scope API key permissions">
    Use API key permission scoping (five levels available) to enforce least-privilege access from your agent.
  </Step>
</Steps>

***

## Certifications & Reports

<CardGroup>
  <Card title="ISO 27001 + 27017 + 27018 Certificates" icon="certificate" href="https://brightdata.com/static/ISO-270012022_ISO-27017_ISO-27018.pdf">
    All three ISO certificates in a single PDF
  </Card>

  <Card title="SOC 3 Report" icon="file-check" href="https://brightdata.com/static/Bright_Data_SOC_3_June_1_2024_May_31_2025_Updated.pdf">
    Public SOC 3 - Jun 1, 2024 – May 31, 2025
  </Card>

  <Card title="SOC 2 Type II Report" icon="file-shield" href="mailto:security@brightdata.com">
    Available under NDA upon request
  </Card>

  <Card title="Trust Center" icon="shield-check" href="https://brightdata.com/trustcenter">
    Penetration test attestation and live trust documentation
  </Card>

  <Card title="Privacy Policy" icon="user-shield" href="https://brightdata.com/privacy">
    Updated annually; GDPR & CCPA aligned
  </Card>

  <Card title="Security Vulnerability Reward Program" icon="bug" href="https://brightdata.com/security-vulnerabilities-reward-program">
    Responsible disclosure program for security researchers
  </Card>
</CardGroup>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Is Bright Data ISO 27001 certified?">
    Yes. Bright Data holds **ISO/IEC 27001:2022, ISO 27017, and ISO 27018** certifications, valid until August 11–13, 2028, issued by SII–QCD (ANAB Accredited, IAF & IQNET member).
  </Accordion>

  <Accordion title="Does Bright Data have a SOC 2 report?">
    Yes. Bright Data has a **SOC 2 Type II** report available under NDA, and a publicly downloadable **SOC 3** report audited by the Deloitte firm (Brightman Almagor Zohar & Co.).
  </Accordion>

  <Accordion title="Is Bright Data GDPR compliant?">
    Yes. Bright Data has undergone a comprehensive GDPR and CCPA compliance program, conducts Data Privacy Impact Assessments (DPIAs) as part of all product flows, and maintains a publicly available privacy policy updated annually.
  </Accordion>

  <Accordion title="Does Bright Data do penetration testing?">
    Yes. Annual penetration tests and source code reviews are performed by independent third-party security firms. The most recent test (Skylight Cyber Security, May–June 2025) left no Critical or High severity findings unresolved.
  </Accordion>

  <Accordion title="Is Bright Data's infrastructure encrypted?">
    Yes. All data is encrypted in transit (**TLS 1.3**) and at rest (**AES-256**). Database backups are encrypted and distributed across multiple cloud locations.
  </Accordion>

  <Accordion title="Is Bright Data safe for enterprise deployments?">
    Yes. Bright Data is trusted by Fortune 500 companies, academic institutions, and 50,000+ organizations worldwide. Its security posture is independently validated through ISO 27001/27017/27018 certification and an annual Deloitte SOC 2 Type II audit.
  </Accordion>

  <Accordion title="Is Bright Data's MCP Server covered by these certifications?">
    Yes. All ISO certifications are explicitly scoped to include AI agent and RAG system use cases for web data access, which covers the MCP Server, Browser API, and related products.
  </Accordion>
</AccordionGroup>

***

*For security inquiries: [security@brightdata.com](mailto:security@brightdata.com)*
*For enterprise compliance reviews: [Contact sales](https://brightdata.com/contact)*


# Event log
Source: https://docs.brightdata.com/general/usage-monitoring/Event_log

How to read the Bright Data event log in the Zones dashboard to monitor recent proxy requests, IP usage, and zone activity at a glance.

For a quick overview of your usage, go to the event sign in your Zones page:

<Frame>
  <img alt="event-log-1.png" />
</Frame>

The event log will show you one line of data for the first request made with each unique IP in the past hour.

The presented data is:

* **Date:** Time and date of the request
* **Zone:** What Zone was used for the request
* **Source IP:** What IP the request was made from
* **URL:** The target site of the request
* **Result:** Success or Fail of the request

<Frame>
  <img alt="event-log-2.png" />
</Frame>


# Monitor your usage
Source: https://docs.brightdata.com/general/usage-monitoring/Monitoring_Residential_Network_Usage

How to monitor your Bright Data residential proxy bandwidth consumption in real time using the Statistics view in the Control Panel.

To review your current bandwidth consumption, simply browse to your [residential zone](https://brightdata.com/cp/zones), click on ‘Statistics’ in the top menu, in the ‘Metrics’ section, open the drop-down menu, and change the metric to ‘GB’.

<Frame>
  <img alt="monitor-your-usage.gif" />
</Frame>

## How Traffic Is Measured

Your usage of the residential proxy network is calculated via **bandwidth** consumption. Bandwidth is the amount of information that is sent over a connection and is being downloaded. Each request you send with your proxy consumes a certain amount of bandwidth. Your billing is calculated via \$ per # of bandwidth used.

See our [Billing & Pricing](/general/account/billing-and-pricing) page to learn more.


# Usage
Source: https://docs.brightdata.com/general/usage-monitoring/Usage

Manage and control Bright Data account usage across 4 zones, including disabling zones to pause billing and understanding pre-commit plan behavior.

<AccordionGroup>
  <Accordion title="How can I disable zones to control my account usage and balance?">
    You can easily disable any of your active zones if you want to stop using it for a while. Our billing system will not charge for days when your zones are disabled but rather only charge for the relative time they were active and for monthly precommit if applicable. You can activate them back at any given moment from your control panel.

    * Disabling all zones will also stop the pre-commit charges. However, as long as you have at least one active zone pre-commit plan will be applied and charged for.
    * Disabling Data center zones or residential zones with dedicated IPs will release all IPs to the pool

    <Note>
      If zone or a zone feature (e.g: city or country) was enabled and disabled on the same day, the charge calculation for the day will be as if it was enabled calculated according to the list price when traffic was consumed.
    </Note>
  </Accordion>

  <Accordion title="What happens when my usage goes beyond my minimum account commitment?">
    When you have used 85% of your account balance during a given month, you will receive an email requesting that you add funds to your account. If you do not add funds to your account, your account will continue to operate until you have used 100% of your account balance. Once you have reached usage amounting to 100% of your account balance, your account will be suspended unless additional funds are added. We recommend to turn on the "auto recharge" to keep your account active and working.
  </Accordion>

  <Accordion title="Will my funds roll over to the next month?">
    If your account remains in “active” status for the entire month, your monthly commitment will not roll over to the next month, regardless of whether your usage charges fell below the minimum commitment.\
    While in 'active' status, your usage and billing calculations start over fresh on the first day of each month according to your price plan and monthly commitment.
  </Accordion>

  <Accordion title="What is the limit for free zones?">
    Bright Data customers can open up to 50 zones free of charge, any additional zone will cost \$5/month.
  </Accordion>

  <Accordion title="Can I limit my daily usage?">
    Yes, in the [Zone](https://brightdata.com/cp/zones) page under the "Usage spent limit" column it is possible to limit your daily usage in 2 ways:

    * Bandwidth(bytes)
    * Money spent(Dollars)

    When you reach your daily limit, the zone is suspended, alerted, or both, depending on your configuration.

    <Note>
      The Zone limit is calculated every 15 minutes and will not take effect immediately so a Zone might go over it's limit by 15 minutes of usage.
    </Note>

    <img alt="usage-monitor.gif" />

    <Note>
      When the load is high statistics calculation may have a delay. In order to manually update the usage-statistics in your Zone, open the Zone by clicking on its name, go to the Statistics table, and press the `recalc` button near the desired date. Wait until the red "Loading..." notification at the top of the screen will disappear, and refresh the page. The stats will then be up-to-date.
    </Note>
  </Accordion>
</AccordionGroup>


# Bandwidth
Source: https://docs.brightdata.com/general/usage-monitoring/bandwidth

How Bright Data calculates bandwidth usage, including request and response headers, POST data, and how trial traffic is tracked and billed.

<AccordionGroup>
  <Accordion title="How is Bandwidth calculated?">
    The bandwidth is calculated according to the sum of data transmitted to and from the target site: request headers + request data (POST) + response headers+response data.\\

    <Note>
      The traffic used during your trial will be listed on your dashboard but will not be counted towards your bill.
    </Note>
  </Accordion>

  <Accordion title="How to get bandwith stats for a Zone">
    API endpoint: `GET /api/zone/bw`

    Optional parameters: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://api.brightdata.com/zone/bw?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js theme={null}
      #!/usr/bin/env node

      (async () => {
        const response = await fetch('https://api.brightdata.com/zone/bw?zone=ZONE', {
          headers: { 'Authorization': 'Bearer API_KEY' },
        });
        console.log(await response.text());
      })();
      ```

      ```java Java theme={null}
      package example;

      import org.apache.http.HttpHost;
      import org.apache.http.client.fluent.\*;

      public class Example {
        public static void main(String[] args) throws Exception {
          String res = Executor.newInstance()
            .addHeader("Authorization", "Bearer API_KEY")
            .execute(Request.Get("https://api.brightdata.com/zone/bw?zone=ZONE"))
            .returnContent().asString();
          System.out.println(res)
        }
      }
      ```

      ```cs C# theme={null}
      using System;
      using System.Net;
      using System.Net.Http;
      using System.Net.Http.Headers;

      public class Program {
        public static async Task Main() {
          var client = new HttpClient();
          var requestMessage = new HttpRequestMessage {
            Method = HttpMethod.Get,
              RequestUri = new Uri("https://api.brightdata.com/zone/bw?zone=ZONE"),
              Headers = {
                {
                  "Authorization",
                  "Bearer API_KEY"
                }
              }
          };
          var response = await client.SendAsync(requestMessage);
          var responseString = await response.Content.ReadAsStringAsync();
          Console.WriteLine(responseString);
        }
      }
      ```

      ```python Python theme={null}
      #!/usr/bin/env python
      print(
          'If you get error "ImportError: No module named requests",',
          'please install it:\n$ sudo pip install requests'
      )
      import requests

      headers = {'Authorization': 'Bearer API_KEY'}

      r = requests.get(
          'https://api.brightdata.com/zone/bw?zone=ZONE',
          headers=headers
      )

      print(r.content)
      ```
    </CodeGroup>

    ```json Sample Response theme={null}
    {
      "ID:": {
        "customer_id": "customer_id",
        "from": "2022-10-01T00:00:00.000Z",
        "to": "2022-11-23T00:00:00.000Z",
        "data": {
          "static": {
            "bw_sum": [
                0, 745, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6960, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_dn": [
                0, 525, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 5990, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_up": [
                0, 220, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 970, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "http_direct_req": [
                0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_sum_dc": [
                0, 745, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6960, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "bw_api": [
                0, 745, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6960, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ],
            "https_direct_req": [
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0,
                0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
            ]
          }
        },
        "last_value_ts": "2022-11-19T19:1* Connection #0 to host brightdata.com left intact 8:51.546Z",
        "last_update_ts": "2022-11-22T11:35:32.122Z",
        "sums": {
          "static": {
            "back_m1": {
              "bw_sum": 745,
              "bw_dn": 525,
              "bw_up": 220,
              "http_direct_req": 1,
              "bw_sum_dc": 745,
              "bw_api": 745,
              "https_direct_req": 0
            },
            "back_m0": {
              "bw_sum": 6960,
              "bw_dn": 5990,
              "bw_up": 970,
              "http_direct_req": 0,
              "bw_sum_dc": 6960,
              "bw_api": 6960,
              "https_direct_req": 1
            },
            "back_d2": {
              "bw_sum": 0,
              "bw_dn": 0,
              "bw_up": 0,
              "http_direct_req": 0,
              "bw_sum_dc": 0,
              "bw_api": 0,
              "https_direct_req": 0
            },
            "back_d1": {
              "bw_sum": 0,
              "bw_dn": 0,
              "bw_up": 0,
              "http_direct_req": 0,
              "bw_sum_dc": 0,
              "bw_api": 0,
              "https_direct_req": 0
            },
            "back_d0": {
              "bw_sum": 0,
              "bw_dn": 0,
              "bw_up": 0,
              "http_direct_req": 0,
              "bw_sum_dc": 0,
              "bw_api": 0,
              "https_direct_req": 0
            }
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="How to get bandwith stats for all the Zones">
    API endpoint: `GET /api/customer/bw`

    Optional parameters: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://api.brightdata.com/customer/bw" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js theme={null}
      #!/usr/bin/env node

      (async () => {
        const response = await fetch('https://api.brightdata.com/customer/bw', {
          headers: { 'Authorization': 'Bearer API_KEY' },
        });
        console.log(await response.text());
      })();
      ```

      ```java Java theme={null}
      package example;
      import org.apache.http.HttpHost;
      import org.apache.http.client.fluent.\*;
      public class Example {
       public static void main(String[] args) throws Exception {
       String res = Executor.newInstance()
       .addHeader("Authorization", "Bearer API_KEY")  
       .execute(Request.Get("https://api.brightdata.com/customer/bw"))  
       .returnContent().asString();
       System.out.println(res)
       }  
      }
      ```

      ```cs C# theme={null}
      using System;
      using System.Net;
      using System.Net.Http;
      using System.Net.Http.Headers;
      public class Program {
       public static async Task Main() {
       var client = new HttpClient();
       var requestMessage = new HttpRequestMessage {
       Method = HttpMethod.Get,  
       RequestUri = new Uri("https://api.brightdata.com/customer/bw"),
       Headers = {
       {"Authorization", "Bearer API_KEY"}
       }
       };
       var response = await client.SendAsync(requestMessage);
       var responseString = await response.Content.ReadAsStringAsync();
       Console.WriteLine(responseString);
       }
      }
      ```

      ```python Python theme={null}
      #!/usr/bin/env python
      print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
      import requests
      headers = {'Authorization': 'Bearer API_KEY'}
      r = requests.get('https://api.brightdata.com/customer/bw', headers=headers)
      print(r.content)
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="How to get bandwidth and total cost for a Zone">
    API endpoint: `GET /api/zone/cost`

    Optional parameters: `from=2018-07-01T00:00:00&to=2018-07-02T00:00:00`

    <CodeGroup>
      ```sh Shell theme={null}
      curl "https://api.brightdata.com/zone/cost?zone=ZONE" -H "Authorization: Bearer API_KEY"
      ```

      ```js Node.js theme={null}
      #!/usr/bin/env node

      (async () => {
        const response = await fetch('https://api.brightdata.com/zone/cost?zone=ZONE', {
          headers: { 'Authorization': 'Bearer API_KEY' },
        });
        console.log(await response.text());
      })();
      ```

      ```java Java theme={null}
      package example;
      import org.apache.http.HttpHost;
      import org.apache.http.client.fluent.\*;
      public class Example {
       public static void main(String[] args) throws Exception {
       String res = Executor.newInstance()
       .addHeader("Authorization", "Bearer API_KEY")  
       .execute(Request.Get("https://api.brightdata.com/zone/cost?zone=ZONE"))  
       .returnContent().asString();
       System.out.println(res)
       }  
      }
      ```

      ```cs C# theme={null}
      using System;
      using System.Net;
      using System.Net.Http;
      using System.Net.Http.Headers;
      public class Program {
       public static async Task Main() {
       var client = new HttpClient();
       var requestMessage = new HttpRequestMessage {
       Method = HttpMethod.Get,  
       RequestUri = new Uri("https://api.brightdata.com/zone/cost?zone=ZONE"),
       Headers = {
       {"Authorization", "Bearer API_KEY"}
       }
       };
       var response = await client.SendAsync(requestMessage);
       var responseString = await response.Content.ReadAsStringAsync();
       Console.WriteLine(responseString);
       }
      }
      ```

      ```python Python theme={null}
      #!/usr/bin/env python
      print('If you get error "ImportError: No module named requests", please install it:\n$ sudo pip install requests');
      import requests
      headers = {'Authorization': 'Bearer API_KEY'}
      r = requests.get('https://api.brightdata.com/zone/cost?zone=ZONE', headers=headers)
      print(r.content)
      ```
    </CodeGroup>

    ```JSON Sample Response theme={null}
    Example response:  
    {
      "ID": {
        "back_m2": {
          "bw": 0,
          "cost": 0
        },
        "back_m1": {
          "bw": 36557298,
          "cost": 0
        },
        "back_m0": {
          "bw": 1219004,
          "cost": 0
        },
        "back_d2": {
          "bw": 82190,
          "cost": 0
        },
        "back_d1": {
          "bw": 0,
          "cost": 0
        },
        "back_d0": {
          "bw": 0,
          "cost": 0
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>


# Unlimited DC & ISP zones: fair use
Source: https://docs.brightdata.com/general/usage-monitoring/fair_use_allowance

Fair use allowance limits for Bright Data Datacenter and ISP unlimited proxies. Effective 1 September 2025 with thresholds and enforcement rules listed.

<Note>
  **Fair use policy updated on 1-Sep-2025**
</Note>

## How fair use applies

Bright Data's fair use policy for unlimited zones includes a monthly allowance of 100GB per proxy (IP). The fair use allowance is the same for both shared and dedicated proxies.

### How fair use is calculated and what is its scope?

Fair use for unlimited proxies is calculated on the zone type level.

It means that all datacenter proxies are sharing their fair use, and all ISP proxies are sharing their fair use. The fair use is calculated monthly, based on the calendar date, from 1st of the month to its last day.

#### How do we calculate fair use?

We sum up all the unlimited proxies of the same zone type, and multiply by 100GB.

So if for example you have 10 proxies in zone `datacenter_zone1` and 5 proxies in `datacenter_zone2` your overall fair use will be 1,500 GB for datecenter fair use.

### Is fair use multiplier different for Datacenter and ISP?

No. Fair use is 100GB (one hundred giga bytes) per proxy (IP), datacenter or ISP.

#### Can one zones unused fair use can be accounted another zone?

Yes. You can load proxies in `zone a` and the fair use will be seen in `zone b`. However we do not recommend doing so ; as traffic will spread on less IPs which may cause performance degredation.

#### If I use shared proxies, do others' usage count towards my fair use?

Absolutely not. Only your traffic is counted towards your fair use.

#### What happens when I exceed my fair use?

We send email alerts when you reach 85% of your fair use and 100% of your fair use. We do not stop your operations, and you will be charged for the data over the fair use allowance with our current "Pay as you go" rate. We consider those charges, exceeding fair use, as "overcharges" and they are marked as such in your billing details.

#### When does the fair use recharge?

Each unlimited zone recharges with fair on the first on the calendar month.

#### How do I avoid overcharges?

In order to avoid overcharge:

1. Plan in advance your usage and purchase enough proxies to cover the fair use.
2. Track your usage and top-up your zone with additional proxies when needed to remain under the fair use.
3. Define zone limit which halts the zone on reaching some usage limit.

Bright Data offers affordable plans for unlimited proxies, we recommend having some additional allowance margins for unpredicted surges in bandwidth consumption, and avoid overcharges.

#### I already incurred overcharges, can I top-up (add proxies) my zones with proxies to reverse it?

Our fair use policy does not allow dismissal or reversal of overcharges once applied. If from some reason you think the overcharge was applied wrongfully, please contact our support and we will gladly assist.

#### I reduced the number of proxies in my zones, how does this impact my fair use allowance?

Every proxy you remove, will immediately reduce your fair use allowance by 100GB. Currently, we do not allow reductions, which will have your account charged with overcharge due to fair use allowance breach.

If you attempt to do that, our control panel will show an Error:

<Warning>
  `Error: Cannot reduce number of proxies below fair use.`
</Warning>

#### Does Bright Data offer unlimited residential proxies?

No.


# SERP API fair use: rate limit
Source: https://docs.brightdata.com/general/usage-monitoring/serp-rate-limit

Bright Data SERP API fair use policy: where to find the rate limit applied to your API, HTTP 429 behavior and how to request an increase.

This page explains the fair use rate limit Bright Data applies to the SERP API, where to find the limit on your account and what happens when a request exceeds it.

Starting January 2026, Bright Data is applying a rate limit to its SERP services.

## Where do I find my SERP API rate limit?

Open the Control Panel, select your SERP API, then go to the Overview tab > Access details. The rate limit currently applied to that API is shown there.

To read the limit from a live request instead, send the `x-brd-get-rate-limit` header. See [Get current rate limit](/products/serp-api/features#get-current-rate-limit).

## What is the SERP API rate limit for unfunded accounts?

Unfunded accounts are subject to a rate limit of 1,000 req/min.

## What happens when I exceed the SERP API rate limit?

Requests above the limit return HTTP error 429.

## How do I raise my SERP API rate limit?

Add funds to your account or contact your sales agent.

Fast SERP customers agree a queries-per-second allocation with their account manager instead. See [Fast SERP quickstart](/products/serp-api/fast-serp/quickstart#what-volume-in-qps-queries-per-second-is-supported).


# Webhook notifications
Source: https://docs.brightdata.com/general/webhook_notifications

Reference for every webhook notification event sent by Bright Data across 4 products, including event codes, categories and payload structure.

<table>
  <thead>
    <tr>
      <th>Category</th>
      <th>Subject</th>
      <th>Product</th>
      <th>Body</th>
      <th>Event code</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Billing</td>
      <td>Account suspension due to insufficient funds</td>
      <td>N/A</td>
      <td>Your Bright Data account was suspended due to insufficient funds.</td>
      <td>1000 - Insufficient funds</td>
    </tr>

    <tr>
      <td>Billing</td>
      <td>Low balance</td>
      <td>N/A</td>
      <td>Your account balance is \$X and nearing its limit. Please recharge your account to avoid account suspension.</td>
      <td>1001 - Low balance</td>
    </tr>

    <tr>
      <td>Billing</td>
      <td>Auto recharge failed</td>
      <td>N/A</td>
      <td>Your payment method was declined and we were unable to add funds to your account using Auto-recharge. Please try again or use a different payment method.</td>
      <td>1002 - Auto recharge failed</td>
    </tr>

    <tr>
      <td>Compliance</td>
      <td>Account disabled due to TOS violation</td>
      <td>N/A</td>
      <td>We detected that your account has violated our TOS (Terms of Service). Please contact our Compliance team for more information: [compliance@brightdata.com](mailto:compliance@brightdata.com)</td>
      <td>2000 - Account disabled</td>
    </tr>

    <tr>
      <td>Compliance</td>
      <td>Account suspension due to validation fail</td>
      <td>N/A</td>
      <td>Your account has been suspended because it could not be validated. Contact your account manager for more information email.</td>
      <td>2001 - Account suspension due to validation fail</td>
    </tr>

    <tr>
      <td>Compliance</td>
      <td>New denylisted IPs</td>
      <td>N/A</td>
      <td>We have detected requests from suspicious IP addresses that are running through your zones. We have added these IPs to your Denylist.</td>
      <td>2002 - Denylisted IPs</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Web Unlocker API service disruption started</td>
      <td>Web Unlocker API</td>
      <td>Web Unlocker API is currently performing at a lower success rate for your targeted domains.</td>
      <td>4000 - Web Unlocker API service disruption start</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Web Unlocker API service disruption ended</td>
      <td>Web Unlocker API</td>
      <td>We have resolved the issue and Web Unlocker API is now showing high performance for your target domains.</td>
      <td>4001 - Web Unlocker API service disruption end</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Service disruption started</td>
      <td>Network</td>
      <td>Our network network is down. We are working on a fix and we will let you know as soon as it is up again.</td>
      <td>4002 - Outage start</td>
    </tr>

    <tr>
      <td>Network Health</td>
      <td>Service disruption ended</td>
      <td>Network</td>
      <td>We have fixed the issue and the insert network network is back up.</td>
      <td>4003 - Outage end</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Scheduled IP replacement</td>
      <td>DC/ISP</td>
      <td>We are scheduling a change in the range of IPs in our DC and ISP networks on insert date and time add link to affected list (same as in email)</td>
      <td>5000 - Future IP replacement</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>IP replacement completed</td>
      <td>DC/ISP</td>
      <td>IP replacement was completed. add link to affected list (same as in email)</td>
      <td>5001 - IP replacement completed</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Gips were released</td>
      <td>Residential/Mobile</td>
      <td>The following gips were released from your zone add link to affected list</td>
      <td>5004 - gips released</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Gips were replaced</td>
      <td>Residential/Mobile</td>
      <td>The following gips were released from your zone and replaced with new ones add link to affected list</td>
      <td>5005 - gips were changed</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Planned maintenance</td>
      <td>Any</td>
      <td>We are performing maintenance on XYZ that is scheduled for insert date and time.</td>
      <td>5002 - Future maintenance</td>
    </tr>

    <tr>
      <td>Maintenance</td>
      <td>Maintenance completed</td>
      <td>Any</td>
      <td>The maintenance on XYZ was completed.</td>
      <td>5003 - Maintenance completed</td>
    </tr>

    <tr>
      <td>TEST</td>
      <td>Test notification</td>
      <td>N/A</td>
      <td>This notification was sent from your control panel in order to test your webhook URL. If you can see this message it means it is working as expected</td>
      <td>9000 - Test notification</td>
    </tr>
  </tbody>
</table>


# Webmaster console
Source: https://docs.brightdata.com/general/webmaster-console

Configure BrightBot crawl behavior for your domains with a collectors.txt file in the Bright Data Webmaster Console. Allow IP range 82.97.199.0/24 for access.

## General

<Info>
  To enable BrightBot to function with your domain, make sure your firewall allows requests from the range **82.97.199.0/24** and the **Brightbot 1.0** User-Agent.

  *Note: If your firewall blocks BrightBot requests to allowed URLs, Bright Data temporarily suspends sending the BrightBot User-Agent to your domain for 7 days.*
</Info>

<Warning>
  **Network support:** Currently, the BrightBot User-Agent and `collectors.txt` rules are only applied to traffic routed through the **Web Unlocker**. Browser API and browser-based Data Collector jobs are not currently supported.
</Warning>

| Inputs | Description | Format |
| - | - | - |
| **Personal Information** (`pii`) | Endpoints containing information related to an identified or identifiable natural person. BrightBot will actively block collection from these endpoints. | `URL / Document Object` |
| **Disallow** (`disallow`) | List interactive endpoint patterns such as ad links, likes, reviews and posts. This instruction enables BrightBot to block these endpoints, aligning with Bright Data guidelines that prohibit data collection from these areas. | `URL / Document Object` |
| **Copyright** (`copyright`) | Endpoints containing copyrighted materials. BrightBot will actively block collection from these endpoints. | `URL / Document Object` |
| **Private** (`private`) | Internal or private endpoints. BrightBot will actively block collection from these endpoints. | `URL / Document Object` |

## Examples

<CodeGroup>
  ```txt collectors.txt theme={null}
  // Optional, describe domain name
  service: example.com

  // Endpoints containing information related to an identified or identifiable natural person.
  pii: /personal_info_1
  pii: /personal_info_2

  // List interactive endpoint patterns such as ad links, likes, reviews and posts.
  disallow: /disallow_1
  disallow: /disallow_2

  // Endpoints containing copyrighted materials.
  copyright: /copyright_1
  copyright: /copyright_2

  // Wildcards (*) and end-of-string ($) characters function exactly like regular expressions across all directives.
  private: /*secret
  private: /private_2
  private: /private_3/*/private$
  ```
</CodeGroup>


# How do I scrape site XYZ?
Source: https://docs.brightdata.com/general/websites

Tips and tricks for getting information from specific websites across 4 categories of targets using Bright Data proxies and Scraper APIs.

<AccordionGroup>
  <Accordion title="How do I scrape Public Web Data from LinkedIn?">
    When it comes to gathering public web data from LinkedIn, you have two straightforward options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can access the Datasets Marketplace by going to "Web Data" from the sidebar, then selecting "Datasets Market" from the top menu.

    These datasets are pre-compiled collections of LinkedIn data, such as user profiles or company information. This option is ideal for those who want to save time and effort, as you can simply download the data you need without having to scrape it yourself. It’s a great solution for businesses or researchers looking for quick access to large volumes of data with minimal technical overhead.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape LinkedIn in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=linkedin.com)

    Information is readily available for LinkedIn people profiles, company information etc.

    **Option 3: Web Unlocker API or Browser API**

    The third option is to actively scrape the data using either the Web Unlocker API or the Browser API to gather LinkedIn data on your own. This approach allows for more flexibility and customization. With Web Unlocker API or Browser API, you can target specific data points and update your data in real-time. This method is perfect for users who need tailored datasets that aren’t available in pre-made form or require fresh, up-to-date information.

    All methods have their own advantages. Ready-made datasets provide convenience and efficiency, while web scraping tools offer control and customization. Choose the one that best fits your needs, and get started with accessing LinkedIn data today!

    LinkedIn is not available through the proxy networks. Use the options above.
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Instagram?">
    When it comes to gathering public web data from Instagram, you have two straightforward options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can access the Datasets Marketplace by going to "Web Data" from the sidebar, then selecting "Datasets Market" from the top menu.

    These datasets are pre-compiled collections of Instagram data, such as public profiles, posts, or engagement metrics. This option is perfect for those who want quick access to large volumes of data without the hassle of scraping it themselves. It’s a convenient solution for businesses, marketers, or researchers who need immediate access to data for analysis, trend spotting, or audience research.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Instagram in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=instagram.com)

    Information is readily available for Instagram people profiles, posts and more.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Instagram data on your own. This approach offers more flexibility and control, allowing you to target specific data points, such as hashtags, user interactions, or recent posts. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your datasets updated in real-time.

    Each of the methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Instagram data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Google?">
    When it comes to gathering public web data from Google, there is a straightforward and powerful option available to you - the **SERP API**

    The most effective way to collect data from Google is by using the SERP API. The SERP API (Search Engine Results Page API) allows you to retrieve search engine results directly from Google without having to scrape the site manually. This option is particularly useful for anyone needing access to Google's search data, such as rankings, snippets, images, maps, and other search features.

    You can read more about SERP API and the customisation options in the [SERP API documentation](/products/serp-api/introduction).

    Using the SERP API offers several advantages. Firstly, it simplifies the process of collecting search data, allowing you to focus on analyzing results rather than dealing with the technicalities of web scraping. Additionally, it provides a reliable way to access fresh, real-time search data, ensuring that the information you receive is up-to-date and accurate.

    The SERP API is also highly customizable, letting you specify parameters such as keywords, location, language, and device type. This flexibility makes it a powerful tool for marketers, SEO specialists, and researchers who need specific insights into Google's search results.

    While using the SERP API requires some setup and understanding of API requests, it's a more streamlined and reliable method than traditional web scraping, which can be challenging due to Google's frequent updates and anti-scraping measures.

    If you're looking to gather Google search data efficiently and effectively, the SERP API is the way to go. Start exploring its capabilities today to unlock valuable insights from Google search results!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Shopee?">
    When it comes to gathering public web data from Shopee, you have 2 options:

    1. Use the [Web Unlocker API](/products/web-unlocker/introduction)

    2. Buy a Dataset from the [Datasets marketplace](https://brightdata.com/cp/datasets/browse/gd_lk122xxgf86xf97py).

    ### Using the Web Unlocker API

    The most effective way to collect real-time data from Shopee is by using the Web Unlocker API - but note the data collection can often be slow due to specific restrictions on this domain.

    Note: In many cases, real time data is not needed! You may be able to get what you need from the data sets. See below.

    You can read more about Web Unlocker API and the customisation options in the [Web Unlocker API documentation](/products/web-unlocker/introduction).

    ### Using a ready-made dataset

    Bright Data maintains a dataset of Shopee product description and prices.

    By definition, the dataset contains historical information, however it is important to note that **it is constantly being updated**.

    You can easily select the timeframe when featuring the data so you only receive information that was collected recently (e.g. in the last 24 hours.)

    You can instantly download the relevant parts of the data sets by going to the [Shopee Dataset](https://brightdata.com/cp/datasets/browse/gd_lk122xxgf86xf97py).
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Zillow?">
    When it comes to gathering public web data from Zillow, you have three options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going to the [Real Estate Datasets](https://brightdata.com/cp/datasets/browse?category=real_estate)

    These datasets are pre-compiled collections of Zillow data, such as public profiles, property sale and rental prices etc. This option is perfect for those who want quick access to large volumes of data without the hassle of scraping it themselves. It is a convenient solution for businesses, marketers, or researchers who need immediate access to data for analysis, trend spotting, or audience research.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Zillow in real-time via API. You can instantly scrape the information you need by going here

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Zillow data on your own. This approach offers more flexibility and control, allowing you to target specific data points, such as hashtags, user interactions, or recent posts. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your datasets updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Zillow data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from HomeDepot?">
    When it comes to gathering public web data from HomeDepot, you have three options to choose from. Both methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=homedepot)

    These datasets are pre-compiled collections of HomeDepot data. Information is ready available for HomeDepot Canada and United States.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape HomeDepot in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=homedepot.com)

    Information is ready available for HomeDepot Canada and United States.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect HomeDepot data on your own. This approach offers more flexibility and control, allowing you to target specific data points, such as hashtags, user interactions, or recent posts. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your datasets updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing HomeDepot data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Amazon?">
    When it comes to gathering public web data from Amazon, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=amazon)

    These datasets are pre-compiled collections of Amazon data, which are periodically updated in order to keep them up to date. Information is readily available for Amazon domains from Canada, Germany, United States and all other amazon country stores.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Amazon in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=amazon.com)

    Information is readily available for Amazon domains from Canada, Germany, United States and all other amazon country stores.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Amazon data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Amazon data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Facebook?">
    When it comes to gathering public web data from Facebook, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=facebook)

    These datasets are pre-compiled collections of Facebook data, which are periodically updated in order to keep them up to date. Information is readily available for Facebook domains from Canada, Germany, United States and all other Facebook localities.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Facebook in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/data_api?search=facebook)

    Information is readily available for Facebook domains from Canada, Germany, United States and all other Facebook localities.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Facebook data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Facebook data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Glassdoor?">
    When it comes to gathering public web data from Glassdoor, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=glassdoor)

    These datasets are pre-compiled collections of Glassdoor data, which are periodically updated in order to keep them up to date. Information is readily available for Glassdoor job listings, reviews and company information.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Glassdoor in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/data_api?search=glassdoor)

    Information is readily available for Glassdoor job listings, reviews and company information.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Glassdoor data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Glassdoor data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from Shein?">
    When it comes to gathering public web data from Shein, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=shein)

    These datasets are pre-compiled collections of Shein data, which are periodically updated in order to keep them up to date. Information is readily available for Shein products.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape Shein in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=us.shein.com)

    Information is readily available for Shein products and categories.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect Shein data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing Shein data today!
  </Accordion>

  <Accordion title="How do I scrape Public Web Data from G2?">
    When it comes to gathering public web data from G2, you have three options to choose from. All methods are effective, depending on your specific needs and resources.

    **Option 1: Ready-Made Datasets**

    The first option is to utilize ready-made datasets available on the Datasets Marketplace. You can instantly download the relevant parts of the data sets by going [here](https://brightdata.com/cp/datasets/browse?search=g2)

    These datasets are pre-compiled collections of G2 data, which are periodically updated in order to keep them up to date. Information is readily available for G2 product reviews.

    **Option 2: Use the Web Scraping API**

    This option lets you easily scrape G2 in real-time via API. You can instantly scrape the information you need by going [here](https://brightdata.com/cp/scrapers/browse?domain=g2.com)

    Information is readily available for G2 product reviews.

    **Option 3: Web Unlocker API or Browser API**

    The second option is to actively scrape the data using either the Web Unlocker API or the Browser API to collect G2 data on your own. This approach offers more flexibility and control, allowing you to target specific data points. With Web Unlocker API or Browser API, you can customize your data collection to fit your exact needs and keep your data  updated in real-time.

    Each methods has its own benefits. Ready-made datasets provide a quick and easy way to get started, while web scraping tools offer greater customization and up-to-date data. Choose the approach that best suits your goals, and start accessing G2 data today!
  </Accordion>
</AccordionGroup>


# How to set up Bright Data with Aezakmi
Source: https://docs.brightdata.com/integrations/aezakmi

Configure Bright Data proxies in Aezakmi to route browser profile traffic through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Aezakmi?

Aezakmi is a browser automation tool designed for marketers, researchers, and developers who require multiple browser profiles with unique configurations. With Bright Data, you can ensure secure, anonymous, and location-targeted browsing while avoiding IP bans and tracking.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## Why Use Bright Data With Aezakmi?

* **Enhanced Privacy**: Mask your real IP address for secure browsing.

* **Geo-Targeting**: Access region-specific content with country-specific proxies.

* **Consistent Performance**: Ensure reliable and uninterrupted connections for all your browser profiles.

## How to Integrate Bright Data With Aezakmi

Follow these steps to configure Bright Data proxies in Aezakmi:

**Step 1. Install and Log In to Aezakmi**

1\. Download and install Aezakmi from the [official website](https://aezakmi.run/).

2\. Open the application and log in with your account credentials.

**Step 2. Create a New Browser Profile**

1\. Navigate to your [dashboard](https://account.aezakmi.run/#/dashboard) or click **Create New Profile** in the **Aezakmi Extension**.

2\. Configure your profile by selecting parameters such as:

* **Operating System**

* **Browser**

* **Screen Resolution**

* **Videocard Model**

3\. Click **Generate Fingerprint** to create a unique browser fingerprint profile tailored to your setup.

<Frame>
  <img alt="How to Integrate Bright Data With Aezakmi" />
</Frame>

**Step 3. Enable Proxy for Your Profile**

1\. In the profile setup screen, enter a descriptive name in the **Profile Name** field to easily identify the profile later.

2\. Toggle **Enable Proxy** to *On* to activate the proxy configuration options.

<Frame>
  <img alt="How to Integrate Bright Data With Aezakmi" />
</Frame>

**Step 4. Configure Proxy Settings**

1\.  Under the proxy settings section, enter your Bright Data proxy details:

* **Protocol**: Choose HTTP, HTTPS, or SOCKS5 based on your proxy type.

* **Address**: Enter [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)

* **Port**:  44445

* **User**: Input your Bright Data username.

* **Password**: Input your Bright Data password.

2\. Click **Check Proxy** to verify your connection. Ensure the test completes successfully.

<Note>
  For geo-targeted proxies, include the country code in the username, formatted as `your-username-country-XX` (e.g., `your-username-country-US`).
</Note>

**Step 5. Save and Launch**

* Once your proxy details are verified, click **Save Fingerprint** to apply the settings and save the profile.

By integrating Bright Data with Aezakmi, you can unlock a secure and efficient browsing experience. Whether scraping data, conducting market research, or accessing geo-restricted content, Bright Data ensures privacy, reliability, and performance. Get started today to maximize your productivity!


# How to set up Bright Data on Android
Source: https://docs.brightdata.com/integrations/android

Configure Bright Data proxies on Android for both mobile data (APN) and Wi-Fi networks. Bright Data proxies span 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

Setting up Bright Data on Android allows you to route your device traffic through secure proxy connections. You can configure Bright Data for **mobile data (APN)** or **Wi-Fi networks**, depending on your use case. Follow the instructions below based on your preferred network type.

***

## Prerequisites

Before you begin, ensure you have:

* An active **Bright Data account**
* Your Bright Data **proxy credentials** (host, port, username, password)
* An Android device with permission to edit network settings

***

## Configuring a Proxy for a Mobile Network (APN)

### Step 1. Access Network Settings

Open **Settings**, then navigate to **Network & Internet** (or **Connections**, depending on your device).

### Step 2. Locate APN Settings

Tap **Mobile Networks**, then select **Access Point Names (APNs)**.

<Frame>
  <img alt="Step 2. Locate APN Settings" />

  <img alt="Step 2. Locate APN Settings" />
</Frame>

### Step 3. Edit APN Details

Select your active APN and update the following fields:

<Frame>
  <img alt="Step 3. Edit APN Details" />
</Frame>

* **Proxy**: `brd.superproxy.io`
* **Port**: `44445`
* **Username**: Your Bright Data proxy username
* **Password**: Your Bright Data proxy password

<Frame>
  <img alt="Step 3. Edit APN Details" />
</Frame>

### Step 4. Save and Reconnect

Save the APN settings and toggle **Mobile Data** off and back on to apply the changes.

***

## Configuring a Proxy for a Wi-Fi Network

### Step 1. Access Wi-Fi Settings

Open **Settings** → **Network & Internet (or Connections)** → **Wi-Fi**.

<Frame>
  <img alt="Step 1. Access Wi-Fi Settings" />
</Frame>

### Step 2. Select Your Connected Network

Tap your connected Wi-Fi network and choose **Settings** or **Edit**.

<Frame>
  <img alt="Step 2. Select Your Connected Network" />
</Frame>

### Step 3. Enable Manual Proxy Configuration

Scroll to **Advanced options** and set **Proxy** to **Manual**.

### Step 4. Enter Proxy Details

Provide the following information:

* **Host**: `brd.superproxy.io`
* **Port**: `44445`

Tap **Save** to apply the configuration.

***

## Verify the Proxy Connection

After setup, open a browser on your device and visit:

[http://brdtest.com/myip.json](http://brdtest.com/myip.json)

Confirm that the displayed IP and location match your Bright Data proxy settings.

***

## Best Practices

* Use **ISP or Datacenter proxies** for better stability on mobile devices
* Avoid frequently switching networks when running proxy-dependent tasks
* Keep your Bright Data credentials secure
* Re-verify proxy settings after OS updates

***

## Conclusion

You’ve successfully configured **Bright Data on Android**. Your device traffic is now routed through secure, private proxy connections, ideal for privacy, geo-restricted access, and protected browsing. Enjoy a safer and more flexible mobile experience.


# How to set up Bright Data with Antik
Source: https://docs.brightdata.com/integrations/antik

Step-by-step guide to configuring Bright Data proxies in Antik for managing multiple browser profiles with geo-targeted IP routing. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Antik?

Antik is a browser-based automation tool designed for users managing multiple accounts, web scraping, and geo-targeted activities. With Bright Data, Antik ensures a secure and private environment for all your automation and browsing needs.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

## Why Use Bright Data With Antik?

* **Privacy**: Protect your IP address and online identity.

* **Geo-Targeting**: Access region-specific content with Bright Data’s country-specific proxies.

* **Reliability**: Enjoy stable connections for uninterrupted workflows.

## How to Integrate Bright Data With Antik

**Step 1. Download and Log In to Antik**

1\. Visit the [official Antik website](https://antik.io/) and download the application.

2\. Install the software and log in using your account credentials.

**Step 2. Create a New Browser Profile**

1\. From the Antik dashboard, navigate to the **Profiles** tab.

2\. Click **Create** to start configuring a new browser profile.

<Frame>
  <img alt="How to Integrate Bright Data With Antik" />
</Frame>

**Step 3. Enable Proxy Settings**

1\. Under the **General Settings** tab, locate the **Name** field and enter a recognizable name for your profile to help you identify it later.

2\. Navigate to the **New Proxy** tab.

<Frame>
  <img alt="How to Integrate Bright Data With Antik" />
</Frame>

**Step 4. Add Your Bright Data Proxy Details**

1\. Go to your [Bright Data dashboard](https://brightdata.com/cp/zones) and click on the your proxy zone.

2\. Under the **Overview** tab, copy the proxy information in the format of:&#x20;

`host : port : username : passoword `(no spaces).&#x20;

3\. Paste this access information into the **Proxy** field in Antik.

4\. Once the proxy configuration is verified, click **Create** to save your proxy settings.

<Note>
  For geo-targeted proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to specify a location.
</Note>

**Step 5. Save and Launch**

1\. Go to the **Profiles** tab and select your newly created profile.

2\. Click **Start** to launch the browser with the configured Bright Data settings.

<Frame>
  <img alt="How to Integrate Bright Data With Antik" />
</Frame>

By integrating Bright Data with Antik, you ensure secure and efficient browsing, making your workflows smooth and private. Whether managing multiple accounts or targeting specific regions, Bright Data provides the reliability you need to stay ahead. Get started today for a seamless browsing experience!


# How to use Bright Data with BitBrowser
Source: https://docs.brightdata.com/integrations/bitbrowser

Step-by-step guide to configuring Bright Data proxies in BitBrowser for managing multiple browser profiles with geo-targeted IP routing. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is BitBrowser?

BitBrowser is a multi-profile browser solution designed for managing multiple online identities securely and efficiently. Each profile operates in an isolated environment, enabling you to run multiple accounts while minimizing detection risks. Integrating Bright Data proxies adds an extra layer of anonymity and ensures seamless connections for your workflows.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## Why Use Bright Data with BitBrowser?

* **Enhanced Privacy**: Mask your IP address to keep your online activities anonymous.

* **Geo-Targeted Browsing**: Access region-specific content using Bright Data’s country-specific proxies.

* **Stable Connections**: Enjoy consistent and reliable connections for managing multiple profiles.

## How to Use Bright Data with BitBrowser

**Step 1. Download and Install BitBrowser**

1\. Visit the official [BitBrowser website](https://www.bitbrowser.net/) and download the application for your device.

2\. Follow the installation instructions and launch the application once installed.

3\. Log in to your BitBrowser account using your credentials.

**Step 2. Navigate to Browser Profiles**

1\. After logging in, you’ll land on the home screen of BitBrowser.

2\. Look for the **"Browser Profiles"** section in the menu or dashboard.

<Frame>
  <img alt="How to Use Bright Data with BitBrowser" />
</Frame>

**Step 3. Create a New Browser Profile**

1\. Click the **“+ Add”** button to create a new browser profile.

2\. In the profile setup window, assign a clear and descriptive name to the profile to help you identify it later.

<Frame>
  <img alt="How to Use Bright Data with BitBrowser" />
</Frame>

**Step 4. Enter Bright Data Proxy Details**

Login to bright data account, and select the proxy zone you with to use. In the **Overview,** under **Access details**, you can find the required information to get your access information. \*\*\*\*&#x20;

1\. Scroll down to the **"Proxy"** section of the profile configuration page.

2\. Enter your Bright Data proxy details as follows:

* **Type**: Select the proxy protocol (`HTTP`, `HTTPS`, or `SOCKS5`) based on the Bright Data proxy type you’re using.

* **Host**: Input [`http://brd.superproxy.io/`](http://brd.superproxy.io/) as the server address.

* **Port**: 44445

* **Username**: Enter your Bright Data proxy username. For region-specific proxies, modify the username format (e.g., `your-username-country-US`).

* **Password**: Type in your Bright Data proxy password.

3\. Double-check all entries to ensure accuracy.

**Step 5. Test and Save Your Proxy Settings**

1\. Click the **"Check Proxy"** or equivalent button to verify the connection.

2\. If the test is successful, click **"Confirm"** to save your profile settings.

**Step 6. Launch the Profile and Verify the Setup**

1\. From the Browser Profiles dashboard, locate your newly created profile and click **"Open"**.

2\. Once the browser launches, navigate to [httpbin.org/ip](http://httpbin.org/ip) to confirm that the displayed IP matches your Bright Data proxy’s IP.

3\. If the IP matches, your proxy is successfully integrated, and your profile is ready for secure and private browsing.

<Frame>
  <img alt="How to Use Bright Data with BitBrowser" />
</Frame>

By integrating **Bright Data** proxies with **BitBrowser**, you’re equipped to manage multiple online identities securely and efficiently. Whether you’re scraping data, conducting market research, or accessing geo-specific content, Bright Data ensures stable, private, and geo-flexible browsing. Enjoy smooth workflows and enhanced anonymity with Bright Data on BitBrowser!


# Set up Bright Data with ClonBrowser
Source: https://docs.brightdata.com/integrations/clonbrowser

Configure Bright Data proxies in ClonBrowser to route browsing and automation profiles through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is ClonBrowser?

**ClonBrowser** is a multi-account browser designed for privacy-focused users, marketers, and automation experts. It enables you to manage multiple profiles while maintaining anonymity, making it ideal for managing campaigns, scraping, and other online tasks.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## How to Integrate Bright Data With ClonBrowser

**Step 1. Download and Install ClonBrowser**

1\. Visit the [ClonBrowser website](https://www.clonbrowser.com/) and download the application for your operating system.

2\. Install the application and log in with your account credentials.

**Step 2. Set Up a New Browser Profile**

1\. Navigate to the **Proxy** tab within the profile management section.

2\. Click **New** to start creating a new browser profile.

<Frame>
  <img alt="How to Integrate Bright Data With ClonBrowser" />
</Frame>

**Step 3. Configure Proxy Details**

1\. Go to your [Bright Data dashboard](https://brightdata.com/cp/zones) 

2\. Create a ':' delimited string by combining: `Proxy Host:Proxy Port:Proxy Zone username:Proxy Zone password`

3\. Paste the proxy string code into the designated field in ClonBrowser.

4\. Click **Parse** to automatically fill in the required fields (Host, Port, Username, Password).

5\. Test the connection by clicking **Connect Test**.

6\. Once verified, click **Save** to apply the proxy settings.

<Note>
  For geo-targeted proxies, include the country code in your username (e.g., `your-username-country-US`) to access proxies from a specific region.
</Note>

**Step 4. Finalize and Start Browsing**

1\. Go back to the **Proxy** tab and locate your newly configured profile.

2\. Click **Ping** to ensure the proxy is working correctly.

<Frame>
  <img alt="How to Integrate Bright Data With ClonBrowser" />
</Frame>

By following these steps, you can seamlessly integrate Bright Data with ClonBrowser, ensuring a secure and efficient browsing experience tailored to your needs.


# How to set up Bright Data with DICloak
Source: https://docs.brightdata.com/integrations/dicloak

Set up Bright Data proxies in DICloak anti-detect browser for anonymous browsing with dynamic fingerprinting and profile management. Covers 195+ countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

## DICloak Proxy Integration

DICloak is a powerful anti-detect browser designed to provide secure and anonymous internet browsing. It offers dynamic fingerprinting, profile management, and robust proxy support, making it an essential tool for professionals seeking enhanced privacy and data collection capabilities.

## DICloak and Bright Data: A Powerful Integration for Secure Browsing

Integrating DICloak with Bright Data’s proxy solutions creates a robust combination for privacy-focused professionals. Here’s how Bright Data enhances DICloak:

* **Global Proxy Coverage:** Access 400M+ monthly residential IPs across 195+ countries for region-specific browsing, the largest proxy network in the world.
* **Enhanced Privacy:** Secure and anonymous browsing with reliable proxy support.
* **Geo-Bypassing:** Easily access restricted content for international projects.
* **Optimized Speed:** High-performance proxies ensure fast connections.
* **Versatile Applications:** Suitable for web scraping, data collection, and more.

Integrating DICloak with Bright Data's proxy services ensures optimal performance and security for your web scraping and browsing tasks. This article provides a step-by-step guide to integrate Bright Data with DICloak seamlessly.

## How to Integrate Bright Data With DICloak

<Steps>
  <Step title="Download and Install DICloak">
    1. [Download](https://dicloak.com/download) the DICloak browser suitable for your operating system.

    <Frame>
      <img alt="download-dicloak" />
    </Frame>

    2. Install DICloak and launch the app.

    <Frame>
      <img alt="launch-dicloak" />
    </Frame>
  </Step>

  <Step title="Create a New Profile">
    1. Click on the **+ Create Profile** button.

    <Frame>
      <img alt="create-profile" />
    </Frame>

    2. Set up the basic profile:

    * Enter a **Profile Name**.
    * Choose the browser and operating system.

    <Frame>
      <img alt="setup-basic-profile" />
    </Frame>
  </Step>

  <Step title="Proxy Configuration in DICloak">
    1. Scroll down to the **Proxy** section and set proxy details:

    * From the **Proxy Type** dropdown, select `HTTP`.

    <Frame>
      <img alt="proxy-config" />
    </Frame>

    2. Enter the following details:

       * **Host:** `brd.superproxy.io`
       * **Port:** `44445`
       * **Account Name:** Enter your Bright Data username.
       * **Password:** Enter your Bright Data password.

       <Tip>
         Learn how to find your Bright Data username and password in [this guide](/integrations/bright-data).
       </Tip>

    <Frame>
      <img alt="proxy-connection" />
    </Frame>
  </Step>

  <Step title="Test your Proxy">
    1. Click on the **Check Proxy** button to test the connection.

    <Frame>
      <img alt="check-proxy" />
    </Frame>

    2. Ensure the connection test is successful and confirm the settings.

    <Frame>
      <img alt="proxy-test-success" />
    </Frame>
  </Step>

  <Step title="Start Browsing">
    1. To use the proxy, click on the **Open** button.

    <Frame>
      <img alt="open-browser" />
    </Frame>

    2. A browser will open with your preferred settings and the configured proxy.

    <Frame>
      <img alt="browser-open" />
    </Frame>
  </Step>
</Steps>

***

## What else to keep in mind

* **Session Control:** Bright Data allows session customization. Configure session persistence to maintain the same IP or rotate IPs as needed for your tasks.
* **Proxy Pooling:** Utilize Bright Data’s proxy pool for larger data collection projects.
* **DICloak Enhancements:** Leverage DICloak’s unique anti-detect features to mimic human-like browsing behavior.

By following this guide, you can effectively integrate Bright Data with DICloak for secure, efficient, and anonymous browsing and data collection.


# Set up Bright Data with Dolphin Anty
Source: https://docs.brightdata.com/integrations/dolphin-anty

Configure Bright Data proxies (400M+ IPs) in Dolphin Anty to add anti-detection-grade IP rotation to your multi-account browsing and data collection.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Dolphin Anty?

Dolphin Anty is an easy-to-use, anti-detection browser built for marketers, researchers, and data professionals who need secure, anonymous browsing for data collection and competitive intelligence. It creates unique digital fingerprints for each profile, like IP addresses and device types, so platforms can’t link profiles to the same user. With Dolphin Anty, you can securely collect web data, conduct market research, and manage affiliate marketing workflows, all without worrying about blocks or detection.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## Dolphin Anty Proxy Integration

Here’s a quick guide to get you started:

### Step 1. **Download Dolphin Anty.**

Visit the [Dolphin Anty website](https://dolphin-anty.com/) to download and install the software.

### Step 2. **Create and Log into Your Account.**

After installing Dolphin Anty, open the app, create your account, and log in.

### Step 3. **Create a New Profile.**

Click on **+ CREATE PROFILE** to start setting up your new browsing environment.

### Step 4. **Add a New Proxy.**

Scroll down to the **NEW PROXY** section to begin configuring your Bright Data proxy.

### Step 5. **Configure Your Bright Data Proxy.**

Follow this format for entering your proxy details: `type://host:port:username:password`

* **Type**: Choose `HTTP` or `SOCKS5` (based on your proxy type).
* **Host**: Enter [`http://brd.superproxy.io/`.](http://brd.superproxy.io/.)
* **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
* **Username**: Enter your Bright Data proxy `username`.
* **Password**: Enter your Bright Data proxy `password`.

Click the **⮂ Test Connection** button to verify the connection.

<Info>
  **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
</Info>

### Step 6. **Save Your Settings.**

Once everything is in place, click **+ CREATE** to save your profile.

***

And you're all set! You've successfully integrated Bright Data proxies with Dolphin Anty.


# How to set up Bright Data with FoxyProxy
Source: https://docs.brightdata.com/integrations/foxyproxy

Step-by-step guide to configuring Bright Data proxies (port 44445) in FoxyProxy for browser-based scraping, app testing and rule-based proxy switching.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is FoxyProxy?

**FoxyProxy** is a versatile browser extension available for Chrome and Firefox, designed to simplify proxy management. With just a few clicks, it lets you switch between multiple proxy servers while leveraging the browser's built-in proxy API. Whether you're scraping data, testing applications, or enhancing your online privacy, FoxyProxy offers an intuitive and efficient solution to handle proxies with ease.

## How to Integrate Bright Data With FoxyProxy

<Steps>
  <Step title="Install FoxyProxy Extension">
    1. **For Chrome**: Visit the [Chrome Web Store](https://chromewebstore.google.com/detail/foxyproxy/gcknhkkoolaabfmlnjonogaaifnjlfnp) and click **Add to Chrome**.
    2. **For Firefox**: Go to the [Mozilla Add-ons page](https://addons.mozilla.org/en-US/firefox/addon/foxyproxy-standard/) and select **Add to Firefox**.

    Once installed, you’ll see the FoxyProxy icon in your browser’s toolbar.
  </Step>

  <Step title="Open FoxyProxy Settings">
    1. Click on the FoxyProxy icon in the toolbar and choose **Options** from the dropdown menu.
    2. This will open the FoxyProxy settings page where you can manage your proxy configurations.

    <Frame>
      <img alt="How to Integrate Bright Data With FoxyProxy" />
    </Frame>
  </Step>

  <Step title="Add a New Proxy Configuration">
    1. Navigate to the **Proxies** tab in the FoxyProxy settings menu.
    2. Click on the **Add** button to open the proxy configuration window.

    <Frame>
      <img alt="How to Integrate Bright Data With FoxyProxy" />
    </Frame>
  </Step>

  <Step title="Input Bright Data Proxy Details">
    1. In the proxy setup form, enter your Bright Data credentials as follows:
       * **Type**: Select `HTTP`, `HTTPS`, or `SOCKS5` based on your proxy type.
       * **Hostname**: Enter `http://brd.superproxy.io/`.
       * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
       * **Username**: Enter your Bright Data username.
       * **Password**: Enter your Bright Data password.
    2. Once all details are entered, click **Save** to store the proxy configuration.

    <Note>
      To use a proxy from a specific location, add the country code to your username (e.g., `your-username-country-US` for a US-based proxy).
    </Note>
  </Step>

  <Step title="Activate and Test Your Proxy">
    1. To enable your configured proxy, click the FoxyProxy icon in your toolbar and select the proxy you just created.
    2. Verify the connection by visiting [httpbin.org/ip](http://httpbin.org/ip). The IP address displayed should match your Bright Data proxy.
    3. Note: if you are working with Bright Data Datacenter and ISP proxies you will be allowed to see the proxy IP address. Residential proxies may be blocked by our policy, and you may receive an error. To see your residential proxy details (including location) browse to: [https://geo.brdtest.com/welcome.txt?product=resi\&method=native](https://geo.brdtest.com/welcome.txt?product=resi\&method=native).

    <Frame>
      <img alt="How to Integrate Bright Data With FoxyProxy" />
    </Frame>
  </Step>
</Steps>

With FoxyProxy and Bright Data configured, you’re now set to enjoy secure, seamless browsing and efficient web operations. Whether you're conducting tests, scraping data, or simply enhancing your privacy, this setup makes proxy management effortless.


# How to use Bright Data with Geelark
Source: https://docs.brightdata.com/integrations/geelark

Integrate Bright Data proxies (195 countries) with Geelark cloud phones to run anonymous, geo-targeted mobile sessions for multi-account workflows.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## What is Geelark?

**Geelark** is a versatile browser profile management tool designed for privacy-conscious users and professionals. It allows you to create isolated browser environments, manage multiple browser profiles, and customize browsing to suit your needs. With Bright Data, you can take your Geelark profiles to the next level by ensuring anonymity, bypassing restrictions, and accessing geo-specific content.

## How to Integrate Bright Data With Geelark

<Steps>
  <Step title="Prerequisites">
    1. **Bright Data Proxy Credentials**:
       * Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) to get your **Host**, **Port**, **Username**, and **Password**.
       * Use a geo-specific username if you need a proxy from a specific location (e.g., `your-username-country-US`).

    2. **Geelark Installed**:
       * Download and install Geelark from [geelark.com](https://geelark.com/).
       * Launch Geelark and log in using your account credentials.
       * If you don’t have an account, click on **Sign Up** to create one.
  </Step>

  <Step title="Create and Configure a New Profile">
    1. On the Geelark dashboard, click on **New Profile**.
    2. Enter a **Name** and select the desired operating system for the profile.

    <Frame>
      <img alt="How to Integrate Bright Data With Geelark" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    1. In the **Proxy Settings** section, select the **Custom** option.

    2. Choose the **Proxy Type** (HTTP, HTTPS, or SOCKS5) based on your Bright Data configuration.

    3. Enter the following Bright Data proxy details:
       * **Proxy Host**: `http://brd.superproxy.io/`.
       * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
       * **Username**: Your Bright Data `username`.
       * **Password**: Your Bright Data `password`.

    4. Click on **Check Proxy** to verify the proxy settings. Ensure the connection is successful before proceeding.
  </Step>

  <Step title="Save and Launch the Profile">
    1. After configuring the proxy settings, click on **OK** to save the profile.
    2. On the Geelark dashboard, locate the newly created profile and click on **Start** to launch it.

    <Frame>
      <img alt="How to Integrate Bright Data With Geelark" />
    </Frame>
  </Step>

  <Step title="Test Your Setup">
    1. Within the launched profile, open a web browser.
    2. Navigate to [httpbin.org/ip](http://httpbin.org/ip) to verify that your IP address reflects the Bright Data, confirming that the setup is successful.
  </Step>
</Steps>

Integrating Bright Data with Geelark gives you a powerful combination of privacy, control, and efficiency. Whether you’re managing multiple browser profiles, accessing geo-restricted content, or ensuring secure connections, Bright Data helps you achieve your goals seamlessly. Try it out today and elevate your Geelark experience!


# How to use Bright Data with GenLogin
Source: https://docs.brightdata.com/integrations/genlogin

Configure Bright Data proxies (400M+ IPs) in GenLogin to manage multiple browser profiles with isolated fingerprints and geo-targeted IPs.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is GenLogin?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

**GenLogin** is an advanced browser profile management tool designed for professionals handling multiple browser profiles or projects. It enables the creation of isolated browser environments, ensuring each profile operates securely and independently. By integrating **Bright Data**, you can enhance GenLogin’s capabilities with reliable, anonymous proxy connections.

## How to Integrate Bright Data With GenLogin

<Steps>
  <Step title="Download and Open GenLogin">
    1. Visit the [GenLogin website](https://genlogin.com/) and download the application compatible with your operating system.
    2. Install GenLogin by following the on-screen instructions and launch the application.
    3. Log in to your GenLogin account. If you don’t have one, sign up for free.
  </Step>

  <Step title="Create or Edit a Browser Profile">
    1. From the GenLogin dashboard, click **Create Profile** to create a new profile or select an existing one to edit.
    2. In the profile settings, give your profile a unique and recognizable name in the **Name** field.

    <Frame>
      <img alt="How to Integrate Bright Data With GenLogin" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    1. Scroll to the **Network** section in the profile setup.

    2. Choose **Your Proxy** and input your Bright Data details:
       * **Proxy Type**: Select HTTP, HTTPS, or SOCKS5.
       * **Proxy Host**: Enter `http://brd.superproxy.io/`.
       * **Proxy Port**: Use the port provided in your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans).
       * **Username**: Input your Bright Data username.
       * **Password**: Enter your Bright Data password.

    3. To ensure accuracy, click **Check Proxy** to verify the connection.
  </Step>

  <Step title="Save and Launch the Profile">
    1. Once the proxy details are successfully verified, click **Create profile** to apply the settings.
    2. Navigate to the **Profiles** section and find the profile you just created.
    3. Click **Start** to open the browser with the configured settings.

    <Frame>
      <img alt="How to Integrate Bright Data With GenLogin" />
    </Frame>
  </Step>

  <Step title="Verify Proxy Connection">
    1. Within the launched profile, open a browser and navigate to [httpbin.org/ip](http://httpbin.org/ip).
    2. Confirm that the displayed IP matches your Bright Data proxy, verifying the setup.
  </Step>
</Steps>

Integrating Bright Data with GenLogin enhances your ability to manage multiple accounts securely and efficiently. With Bright Data’s reliable proxies and GenLogin’s robust browser profile management, you can achieve unparalleled privacy and productivity. Start leveraging the power of Bright Data and GenLogin today!


# Set up Bright Data with Ghost Browser
Source: https://docs.brightdata.com/integrations/ghost-browser

Configure Bright Data proxies in Ghost Browser to route multi-session browsing through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Ghost Browser?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

Ghost Browser is a productivity-driven web browser designed for users who need to manage multiple online accounts effortlessly. With its unique multi-session feature, you can open separate tabs, each acting as an independent browser session. This means you can log into multiple accounts on the same platform at once, without any cross-session interference.

While it doesn’t focus on advanced anti-detection features, Ghost Browser is ideal for those who want a simple, organized workflow. It’s perfect for professionals juggling multiple accounts or projects, all in one streamlined interface.

## Ghost Browser Proxy Integration

Here’s how to integrate Bright Data proxies into Ghost Browser:

<Steps>
  <Step title="Install Ghost Browser">
    1. Download and install [**Ghost Browser**](https://ghostbrowser.com/download/).
    2. Once installed, log in to your account to access the main interface.
  </Step>

  <Step title="Access Ghost Proxy Control">
    1. Click the **Ghost Proxy Control** icon in the top-right corner of the browser.
    2. Select **Add/Edit Proxies**.

    <Frame>
      <img alt="Ghost Browser Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Add a New Proxy">
    In the **Proxy Manager**, select the option to **Add a Single Proxy**.

    <Frame>
      <img alt="Ghost Browser Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    In the proxy setup window, fill out the fields with your Bright Data proxy details:

    * **Name**: Optional – give your proxy a descriptive name (e.g., "Bright Data").
    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Username**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    Click **Add Proxy** to save your settings.

    <Info>
      For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.
    </Info>
  </Step>

  <Step title="Activate Proxy in Ghost Browser">
    1. Go back to the **Ghost Proxy Control** menu.
    2. Select your newly added Bright Data proxy under the **Active Identity** and **Active Workspace** settings.
    3. Then, reload your tabs to apply the selected proxy to your browsing session.
  </Step>
</Steps>

**And that’s it!** Your Bright Data proxy is now integrated with Ghost Browser.


# How to set up Bright Data with GoLogin
Source: https://docs.brightdata.com/integrations/gologin

Configure Bright Data proxies (400M+ IPs) in GoLogin to route multi-profile browsing through residential, datacenter, ISP or mobile IPs for collection.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is GoLogin?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

GoLogin is a powerful tool designed to make managing multiple accounts easy and secure. It allows you to create separate browser profiles, each with its own unique fingerprints, IPs, and cookies, making each profile appear like an individual user. This is perfect for marketers, researchers, and data professionals who need isolated browsing environments for web scraping and competitive analysis.

With GoLogin, you can integrate proxies, automate tasks, and switch between profiles seamlessly, all while keeping each account completely anonymous. It’s a flexible solution that helps ensure account safety, and with its collaboration features, teams can securely share profiles. Whether you’re focused on digital marketing, data scraping, or competitive intelligence, GoLogin is a fantastic choice.

## GoLogin Proxy Integration

Follow these steps to integrate Bright Data proxies with GoLogin:

<Steps>
  <Step title="Install GoLogin">
    Download and install GoLogin from the [GoLogin website](https://gologin.com/).
  </Step>

  <Step title="Create an Account">
    Log in to GoLogin to get started with the setup.
  </Step>

  <Step title="Create a New Profile">
    Click **+Add profile** and enter the basic details for your new browser profile.

    <Frame>
      <img alt="GoLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    Enter your Bright Data proxy details:

    * **Proxy Type**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      **You can also specify a country for your proxy. For instance, entering `your-username-country-US` will give you a US-based exit node.**
    </Info>

    <Frame>
      <img alt="GoLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Test the Proxy">
    Click **Check Proxy** to make sure everything is working as expected.
  </Step>

  <Step title="Save and Launch">
    Click **Create Profile** to save your settings, and then hit **Run** to open your new profile with secure browsing.

    <Frame>
      <img alt="GoLogin Proxy Integration" />
    </Frame>
  </Step>
</Steps>

**And that's it!** You've now successfully integrated Bright Data proxies with GoLogin.


# Set up Bright Data with HideMyAcc
Source: https://docs.brightdata.com/integrations/hidemyacc

Configure Bright Data proxies in HideMyAcc to route multi-account browsing through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## What is HideMyAcc?

**HideMyAcc** is an advanced anti-detect browser designed for managing multiple accounts securely. It helps users bypass restrictions, maintain anonymity, and avoid detection by offering a private browsing environment. Integrating Bright Data enhances HideMyAcc's capabilities, providing secure and geo-targeted connections.

## How to Integrate Bright Data With HideMyAcc

<Steps>
  <Step title="Download and Install HideMyAcc">
    1. Visit the [HideMyAcc website](https://hidemyacc.com/) and download the software compatible with your operating system.
    2. Install the application and log in with your account credentials.
  </Step>

  <Step title="Create a New Profile">
    1. Open HideMyAcc and navigate to the **Profiles** tab.
    2. Click **Create a new profile** to set up a new browsing instance.

    <Frame>
      <img alt="How to Integrate Bright Data With HideMyAcc" />
    </Frame>
  </Step>

  <Step title="Enable Proxy Configuration">
    1. Locate the **Proxy** section within the profile creation page.
    2. In the profile settings, enter a **Profile Name** to easily identify it later.
    3. Toggle **Your Proxy** to activate the configuration options.

    <Frame>
      <img alt="How to Integrate Bright Data With HideMyAcc" />
    </Frame>
  </Step>

  <Step title="Add Your Bright Data Proxy Details">
    1. Go to your [Bright Data dashboard](https://brightdata.com/cp/zones) and click the proxy zone you would like to use.
    2. Under the **Overview** tab, copy the proxy access details code provided in the required format: `host:port:username:password.`
    3. Paste this code into the **Quick add** field in HideMyAcc .
    4. Use the **Check Proxy** option to verify the connection.
    5. Once the proxy configuration is verified, click **Create** to save your proxy settings.&#x20;

    <Note>
      For geo-specific proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to target a specific region.
    </Note>
  </Step>

  <Step title="Launch the Profile">
    Navigate to the **Profiles** tab, select your newly created profile, and click **Run** to start browsing securely with Bright Data.

    <Frame>
      <img alt="How to Integrate Bright Data With HideMyAcc" />
    </Frame>
  </Step>
</Steps>

By integrating **Bright Data** with **HideMyAcc**, you can enjoy enhanced privacy and seamless account management. Whether you're managing multiple profiles or performing geo-targeted tasks, this setup ensures your browsing experience is secure and efficient. Start today for reliable, private browsing!


# How to set up Bright Data with Incogniton
Source: https://docs.brightdata.com/integrations/incogniton

Integrate Bright Data with Incogniton for secure, anonymous browsing with enhanced protection against detection and bans. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## What is Incogniton?

Incogniton is a privacy-focused browser designed to keep you anonymous while you browse. It lets you create and manage multiple profiles, each with its own set of cookies, local storage, IP address (via proxy), and other browsing data. This means you can surf the web worry-free, knowing your activities and personal information stay private.

Incogniton is perfect for privacy-conscious users, marketers, and researchers who need secure, anonymous browsing for web scraping, market research, and competitive intelligence.

## Incogniton Proxy Integration

Setting up Bright Data proxies with Incogniton is a quick and easy process. Just follow these simple steps to get started:

<Steps>
  <Step title="Download Incogniton">
    Visit the [**Incogniton website**](https://incogniton.com/) to download and install the browser on your device.
  </Step>

  <Step title="Create a New Profile">
    1. Once installed, open Incogniton and go to the **Profile Management** section.
    2. Click **New Profile** to create your first profile.
  </Step>

  <Step title="Configure Proxy Settings">
    In the profile setup menu, click on **Proxy** on the left side. Enter your Bright Data proxy details:

    * **Proxy Type**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Proxy Host**: Enter `http://brd.superproxy.io/`.
    * **Proxy Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Proxy Username**: Enter your Bright Data proxy `username`.
    * **Proxy Password**: Enter your Bright Data proxy `password`.

    You can confirm the proxy is working by clicking **Check Proxy**.

    <Info>
      **For country-specific proxies, you can enter a format like `username-country-US` for a US-based IP**
    </Info>
  </Step>

  <Step title="Save Your Profile">
    1. Once all the details are entered, click **Create Profile** to save your settings.
    2. You’re now ready to browse securely!
  </Step>

  <Step title="Start Browsing">
    Click **Start** to launch your profile in a secure incognito browser window, and begin browsing with complete anonymity.
  </Step>
</Steps>

And that’s it! You’ve successfully integrated Bright Data proxies with Incogniton.


# How to set up Bright Data with Insomniac
Source: https://docs.brightdata.com/integrations/insomniac

Configure Bright Data proxies (400M+ IPs) in Insomniac to assign a unique IP per browser tab, reducing detection risk during multi-session automations.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Insomniac?

Insomniac is an online purchasing tool allowing you to hide your digital footprint through its multi-session browser. Insomniac browser allows you to apply one proxy per tab and hide your online footprint by applying a different IP address for every tab you open.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).

  <br />
</Tip>

## How to setup Insomniac with Bright Data proxies

### Using the same proxy repeatedly or rotating with new proxy every time?

Bright data offers access to two main kinds of proxies:

1. A rotating pool of proxies
2. A set of fixed proxies (shared with others or dedicated to you)

When choosing a proxy pool like our Datacenter, ISP or Residential shared pools, your isomniac browser does not need to handle the rotation as Bright Data will assign a new proxy for you in every session.

When you need a set of fixed proxies, like for collecting data at scale, you can load all your proxies to insomniac, and it will rotate along them, as you configure it.

## Set-up for Insomniac browser

* Download and install the Insomniac browser
* Open **Insomniac browser**
* Click on "Global sess." :

<Frame>
  <img alt="Insomniac_setup_1.png" />
</Frame>

* Click on "Proxy List"

<Frame>
  <img alt="Insomniac_setup_2.png" />
</Frame>

* This setup window will open, requiring you to paste your proxy configuration here.

<Frame>
  <img alt="Insomniac_setup_3.png" />
</Frame>

The format required is **comma separated** proxy configuration: `host,port,user,password` .

## Integrating Insomniac with Bright Data Proxies

* Go to your Bright Data Dashboard and click **Create a Zone**
* Choose your configuration
* Click **Save**
* The zone now includes your proxy setup and in the access details you have the connection information.

If you want to use Bright Data's rotation and use a different proxy for every session, copy and paste this setup from Bright Data's control panel into insomniac.

<Frame>
  <img alt="Insomniac_setup_4.png" />
</Frame>

If you wish to load a specific proxies (with distinguished IPs) of Datacenter or ISP, open the zone Overview tab in Bright Data control panel, and click "Download" to download the proxy list. A popup window will open with 3 formats. Insomniac needs comma separates format whch will be available soon in Bright Data. So choose colon seprated as shown here:

<Frame>
  <img alt="Insomniac_setup_5_brd_dc_iplistdwnld.png" />
</Frame>

Open the file with a text editor, and using "Search and Replace" replace all colons with commas. Example in notepad (use `Ctrl+H` to open the Search and replace function):

<Frame>
  <img alt="insomniac_setup_7_proxylist_notepad.png" />
</Frame>

After you copy and paste the list, you will have multiple entries of proxies in insomniac which you can order insomniac to rotate on per your desired logic.

## Integrating Multiple Proxy Manager ports with Insomniac

* Download [Proxy Manager](https://brightdata.com/products/proxy-manager)
* Click **Add new Proxy** to create a new port
* Select the new port (24XXX)
* Go to the **General** tab in the port settings
* In the **Multiply proxy port** field select the number of proxy ports to create. This will create multiple proxy ports with the same settings
* Your Spreadsheet Contains the following columns:
  * Custom Name: Add a name for each proxy
  * Host: 127.0.0.1
  * Port: 24XXX
  * Username, Password, and Tags: leave EMPTY(the Proxy Manager has already been authenticated with the Super Proxy)
* Save the file as a **CSV** and not as an XLS or XLSX
* In Insomniac **Proxy per tab** extension select **Manage Proxy list**, and select **Add bulk proxies**
* Select **Import proxy list** and upload the CSV file

<Warning>
  **Important note**:

  If you are using Bright Data’s Residential Proxies, Web Unlocker API or SERP API, you need to install an SSL certificate to enable end-to-end secure connections to your target website(s).

  This is a simple process, see [this guide](/general/account/ssl-certificate#installation-of-the-ssl-certificate) for instructions.
</Warning>


# How to use Bright Data on iOS
Source: https://docs.brightdata.com/integrations/ios

Step-by-step guide to configuring Bright Data proxies on iOS devices via Wi-Fi network settings for private and geo-targeted browsing. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## Why Use Bright Data on iOS?

Using Bright Data proxies on your iOS device allows you to:

* **Protect Your Privacy**: Hide your real IP address and browse securely.
* **Access Geo-Restricted Content**: Route traffic through different countries and regions.
* **Improve Connection Reliability**: Reduce detection risks and maintain stable, anonymous connections while browsing, shopping, or managing accounts.

***

## Prerequisites

Before you begin, ensure you have:

* **Bright Data Proxy Credentials**\
  Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) and note your **Host**, **Port**, **Username**, and **Password**.

* **An iPhone or iPad running iOS 10 or later**\
  The steps below apply to most modern iOS versions.

***

## Configuring a Proxy for a Wi-Fi Network

<Steps>
  <Step title="Open Wi-Fi Settings">
    1. Open **Settings** on your iOS device.
    2. Tap **Wi-Fi**, then select the **ⓘ (Info)** icon next to your connected network.

    <Frame>
      <img alt="iOS Settings app showing the Wi-Fi screen" />

      <img alt="iOS Wi-Fi network details with the info icon to open network configuration" />
    </Frame>
  </Step>

  <Step title="Change Proxy Settings to Manual">
    1. Scroll down to **HTTP Proxy**.
    2. Switch the setting from **Off** or **Automatic** to **Manual**.
    3. Toggle **Authentication** **On**.

    <Frame>
      <img alt="iOS Configure Proxy screen with Off, Automatic, and Manual options" />

      <img alt="iOS Manual proxy configuration with Server, Port, Authentication toggle, Username, and Password fields" />
    </Frame>
  </Step>

  <Step title="Enter Bright Data Proxy Credentials">
    Fill in the following details:

    * **Server**: `brd.superproxy.io`
    * **Port**: Use the port provided in your Bright Data dashboard
    * **Username**: Your Bright Data proxy username
    * **Password**: Your Bright Data proxy password

    Ensure all values are correct, then tap **Save** to apply the configuration.
  </Step>

  <Step title="Verify the Connection">
    1. Open **Safari** or any browser on your device.
    2. Visit:

    [http://httpbin.org/ip](http://httpbin.org/ip)

    3. Confirm that the displayed IP matches your Bright Data proxy IP.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for better stability on mobile devices
* Avoid switching Wi-Fi networks frequently when using proxies
* Keep your Bright Data credentials secure
* Re-check proxy settings after iOS updates

***

## Conclusion

You have successfully configured **Bright Data on iOS**. Your Wi-Fi traffic is now routed through secure and anonymous proxy connections, enabling private browsing and access to geo-restricted content. Enjoy a safer, more flexible browsing experience with Bright Data wherever you go.


# Set up Bright Data with IXBrowser
Source: https://docs.brightdata.com/integrations/ixbrowser

Configure Bright Data proxies (400M+ IPs) in IXBrowser to route multi-profile browsing through residential, datacenter, ISP or mobile IPs for collection.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is IXBrowser?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

**IXBrowser** is a privacy-focused anti-detect browser tailored for managing multiple browser profiles across different platforms. It provides advanced anonymity features, allowing users to bypass restrictions and avoid detection. Integrating Bright Data with IXBrowser further enhances privacy and enables geo-targeted browsing.

## How to Integrate Bright Data With IXBrowser

<Steps>
  <Step title="Download and Install IXBrowser">
    1. Visit the [IXBrowser website](https://ixbrowser.com/) and download the application.
    2. Install the software and log in using your account credentials.
  </Step>

  <Step title="Create a New Profile">
    1. Open IXBrowser and navigate to the **Profile List** section under **Browser Profile**.
    2. Click **Create New Profile** to begin setting up a new browser instance.
    3. In the profile settings, provide a descriptive name in the **Profile Name** field to easily identify your profile later.

    <Frame>
      <img alt="How to Integrate Bright Data With IXBrowser" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    1. Switch to the **Proxy Configuration** tab within the profile setup page.

    2. Toggle **Custom** to enable the proxy setup options.

    3. Fill in the following proxy details retrieved from your [Bright Data dashboard](https://brightdata.com/cp/zones):
       * **Proxy Type**: Choose HTTP, HTTPS, or SOCKS5 depending on your proxy type.
       * **Proxy Host**: `http://brd.superproxy.io/`
       * **Proxy Port**: Enter the port number from your Bright Data dashboard.
       * **Proxy Account**: Use your Bright Data `username`.
       * **Proxy Password**: Use your Bright Data `password`.

    4. Once you’ve entered the details, click **Create** to save the configuration.

    <Note>
      For geo-targeted proxies, format your username as `your-username-country-XX` (e.g., `your-username-country-US`) to access a specific region.
    </Note>
  </Step>

  <Step title="Launch the Profile">
    1. Navigate back to the **Profile List** section.
    2. Locate your newly created profile and click **Open** to launch the browser with the configured Bright Data proxy settings.

    <Frame>
      <img alt="How to Integrate Bright Data With IXBrowser" />
    </Frame>
  </Step>
</Steps>

Integrating Bright Data with IXBrowser ensures private and reliable account management while enhancing your online anonymity. Whether you’re managing multiple accounts or performing geo-targeted activities, this setup empowers you with secure and seamless browsing. Get started now for a more efficient experience!


# How to set up Bright Data with Kameleo
Source: https://docs.brightdata.com/integrations/kameleo

Configure Bright Data proxies in Kameleo to route anti-detect browser profiles through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Kameleo?

Kameleo is an advanced anti-detection browser designed for users who need to manage multiple online profiles without risking detection. Whether you’re an affiliate marketer, researcher, or web scraper, Kameleo gives you the tools to bypass IP bans, prevent device tracking, and maintain isolated browsing environments.

With Kameleo, you can customize your browser fingerprints, like user agents, screen resolutions, and fonts, so each profile looks completely unique. This ensures that your activities remain undetected. Kameleo supports a variety of proxies, including residential, datacenter, and ISP proxies, letting you assign different IPs and digital identities to each profile. This makes it perfect for data collection, competitive research, and web scraping at scale, all from a single session.

On top of its strong anti-detection features, Kameleo also supports automation tools, making it a powerful choice for bulk tasks like posting or data scraping. Whether you’re managing a handful of profiles or scaling up for larger operations, Kameleo ensures your privacy and security are protected while optimizing your online activities.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## Kameleo Proxy Integration

Follow these simple steps to integrate Bright Data proxies into Kameleo:

<Steps>
  <Step title="Open Kameleo">
    Launch the [**Kameleo app**](https://kameleo.io/downloads/) and log in to your account.
  </Step>

  <Step title="Create a New Profile">
    Click on the **New Profile** option in the left navigation panel to start setting up a new browsing profile.
  </Step>

  <Step title="Configure Your Profile Preferences">
    Select the profile settings that match your preferred device type, operating system, browser, and language settings.
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Navigate to the **Connection** section in the profile settings and enter the following details to configure your Bright Data proxy:

    * **Proxy**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Host:**  Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
  </Step>

  <Step title="Enable Authentication">
    Toggle the **Authentication** button to reveal the `Username` and `Password` fields.\
    Enter your Bright Data proxy credentials here.

    To ensure everything works correctly, click the **Test Proxy** button to perform several tests for your proxy connection.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Save Your Settings">
    Once you’ve configured your proxy, click **OK** to save your settings.

    Alternatively, click **START** to launch the browser immediately with your configured profile.
  </Step>
</Steps>

And that’s it! You’ve successfully integrated Bright Data proxies with Kameleo.


# How to set up Bright Data with Lalicat
Source: https://docs.brightdata.com/integrations/lalicat

Configure Bright Data proxies (400M+ IPs) in Lalicat to route multi-profile browsing through residential, datacenter, ISP or mobile IPs for collection.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Lalicat?

Lalicat is a simple, anti-detection browser designed to help you manage multiple accounts securely and anonymously. It creates unique browser profiles with isolated digital fingerprints, like IP addresses and device details, so you can bypass tracking systems and avoid detection with ease.

Whether you're performing web scraping, conducting market research, or gathering competitive intelligence, Lalicat offers a reliable and affordable solution for professionals who prioritize privacy and efficiency.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## Lalicat Proxy Integration

Follow these steps to integrate Bright Data proxies with Lalicat:

<Steps>
  <Step title="Install Lalicat">
    1. [**Download**](https://www.lalicat.com/download), install, and launch Lalicat.
    2. Create and log into your account.
  </Step>

  <Step title="Add a Browser Profile">
    On the home screen, click **+Add Browser** to create a new browser instance.

    <Frame>
      <img alt="Lalicat Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Basic Settings">
    In the **Basic Configuration** section, enter your **Profile Name**, select the simulated **operating system**, and adjust other necessary settings for your task.

    <Frame>
      <img alt="Lalicat Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Scroll to the **Proxy Settings** section and input the following details:

    * **Proxy settings**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **IP Address**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Test Your Proxy">
    Click **Check the Proxy** to verify the connection.

    If everything is working, click **Save** to complete the configuration.
  </Step>
</Steps>

**And that’s it!** You’ve successfully integrated Bright Data proxies with Lalicat.


# How to use Bright Data on macOS
Source: https://docs.brightdata.com/integrations/macos

Step-by-step guide to configuring Bright Data proxies in macOS system network settings for system-wide geo-targeted browsing. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Tip>
  Maintain a consistent IP throughout your browsing session by using the `-session` parameter in your username. Bright Data proxies rotate IPs by default.\
  [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session)

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).
</Tip>

## Why Use Bright Data on macOS?

Adding Bright Data proxies to your macOS network settings enables you to:

* **Enhance Privacy**: Hide your real IP address and browse securely
* **Access Geo-Restricted Content**: Route traffic through different countries and regions
* **Maintain Stable Connections**: Reduce detection risks across browsers and desktop applications
* **System-Wide Coverage**: Apply proxy routing to all apps that respect macOS network settings

***

## Setting Up Bright Data on macOS

<Steps>
  <Step title="Prerequisites">
    Before you begin, ensure you have:

    * **Bright Data Proxy Credentials**\
      Log in to your [Bright Data dashboard](https://brightdata.com/cp/zones) to retrieve:
      * Host
      * Port
      * Username
      * Password\
        Also confirm whether you are using `HTTP`, `HTTPS`, or `SOCKS5` proxies.

    * **A macOS device running macOS 10.12 (Sierra) or later**
  </Step>

  <Step title="Open Network Settings">
    1. Click the **Apple menu** in the top-left corner of your screen.
    2. Select **System Settings** (or **System Preferences** on older macOS versions).

    <Frame>
      <img alt="macOS Apple menu open with System Settings option highlighted" />
    </Frame>

    3. Open **Network** and select the connection you want to configure (for example, **Wi-Fi** or **Ethernet**).

    <Frame>
      <img alt="macOS Network settings with Wi-Fi connection selected" />
    </Frame>
  </Step>

  <Step title="Open Advanced Network Options">
    1. Click **Details…** (or **Advanced…** on older versions).

    <Frame>
      <img alt="macOS Wi-Fi network details panel with Details button to open advanced options" />
    </Frame>

    2. Navigate to the **Proxies** tab.

    <Frame>
      <img alt="macOS Network advanced settings showing the Proxies tab" />
    </Frame>
  </Step>

  <Step title="Select the Proxy Type">
    Choose the proxy protocol based on your Bright Data setup:

    * **Web Proxy (HTTP)** for HTTP proxies
    * **Secure Web Proxy (HTTPS)** for HTTPS proxies
    * **SOCKS Proxy** for SOCKS5 proxies

    <Frame>
      <img alt="macOS Proxies tab with Web Proxy, Secure Web Proxy, and SOCKS Proxy options" />
    </Frame>
  </Step>

  <Step title="Enter Bright Data Proxy Details">
    Fill in the proxy configuration fields:

    * **Server**: `brd.superproxy.io`
    * **Port**: Use the port provided in your Bright Data dashboard
    * Enable **Proxy server requires password**
    * **Username**: Your Bright Data username\
      *(Optionally append `-session-<id>` for IP persistence or `-country-XX` for geo-targeting)*
    * **Password**: Your Bright Data proxy password

    Click **OK**, then **Apply** to save the configuration.
  </Step>

  <Step title="Verify the Proxy Connection">
    1. Open **Safari**, **Chrome**, or another browser.
    2. Visit:

    [http://httpbin.org/ip](http://httpbin.org/ip)

    3. Confirm the displayed IP matches your Bright Data proxy IP.
  </Step>
</Steps>

***

## Best Practices

* Use **ISP or Datacenter proxies** for long-running desktop workflows
* Avoid frequently switching networks when using proxies
* Keep credentials secure and rotate sessions periodically
* Recheck proxy settings after macOS updates
* Use one proxy per account for account-based tasks

***

## Conclusion

You’ve successfully configured **Bright Data on macOS**. Your system traffic is now routed through secure, anonymous proxy connections, enabling private browsing and geo-flexible access across applications. With Bright Data in place, your Mac is ready for safer, more reliable online operations.


# Set up Bright Data with MarketerBrowser
Source: https://docs.brightdata.com/integrations/marketerbrowser

Step-by-step guide to configuring Bright Data proxies (400M+ IPs) in MarketerBrowser for managing multiple browser profiles and region-specific content.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is MarketerBrowser?

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

**MarketerBrowser** is a specialized browser designed for professionals managing multiple browser profiles or campaigns. It lets you create isolated browser profiles, ensuring security and privacy for each session. By integrating **Bright Data**, you can enhance anonymity, access geo-restricted content, and reduce detection risks for your workflows.

## How to Integrate Bright Data With MarketerBrowser

<Step title="Install and Open MarketerBrowser">
  1. Download MarketerBrowser from the [official website](https://www.marketerbrowser.com/).
  2. Follow the on-screen installation instructions to set up the application on your device.
  3. Open MarketerBrowser and log in using your credentials. If you don’t have an account, register for one.
</Step>

<Step title="Create or Edit a Browser Profile">
  1. From the **Profiles**, click **Create Profile** to set up a new browser instance or select an existing profile to edit.
  2. Provide a descriptive name for the profile in the **Name** field to easily identify it later.

  <Frame>
    <img alt="How to Integrate Bright Data With MarketerBrowser" />
  </Frame>
</Step>

<Step title="Configure Proxy Settings">
  1. Locate the **Proxy** section within the profile configuration menu.

  2. Enter your Bright Data proxy details:
     * **Type**: Select HTTP, HTTPS, or SOCKS5.
     * **Server**: Input `http://brd.superproxy.io/`.
     * **Port**: Enter the port number from your [Bright Data dashboard](https://brightdata.com/cp/zones).
     * **Username**: Use your Bright Data `username`.
     * **Password**: Enter your Bright Data `password`.

  3. Test the proxy connection by clicking **Check** to ensure the setup is working correctly.

  4. Once you’ve entered and tested the proxy details, click **Create** to store the profile configuration.
</Step>

<Step title="Save and Activate the Profile">
  1. Go to the **Profiles** section and choose your newly configured profile.
  2. Toggle the **Launch** switch to *On* to activate the profile with your Bright Data settings.

  <Frame>
    <img alt="How to Integrate Bright Data With MarketerBrowser" />
  </Frame>
</Step>

<Step title="Verify the Proxy Setup">
  1. Within the launched profile, open the browser and navigate to [httpbin.org/ip](http://httpbin.org/ip).
  2. Confirm that the displayed IP address matches your Bright Data proxy to verify the setup.
</Step>

By integrating **Bright Data** with **MarketerBrowser**, you create a seamless and secure environment for managing multiple accounts, accessing geo-specific content, and maintaining anonymity. Follow these steps to optimize your workflows and enhance privacy with Bright Data and MarketerBrowser today!


# How to integrate Bright Data with Maskfog
Source: https://docs.brightdata.com/integrations/maskfog

Configure Bright Data proxies in Maskfog to route anti-detect browsing profiles through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Maskfog?

**Maskfog** is an anti-detect browser designed for managing multiple accounts securely and anonymously. It provides tools to prevent detection, protect your digital footprint, and simulate unique browser environments for each profile. Integrating Bright Data with Maskfog adds an extra layer of security and flexibility for geo-targeted activities.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## How to Integrate Bright Data With Maskfog

<Step title="Download and Install Maskfog">
  1. Visit the [Maskfog website](https://www.maskfog.com/) and download the application for your operating system.
  2. Install the software and log in using your credentials.
</Step>

<Step title="Create a New Profile">
  1. Open Maskfog and navigate to the **Proxy Service** section.
  2. Click **Configure Device** to start setting up a new proxy.

  <Frame>
    <img alt="How to Integrate Bright Data With Maskfog" />
  </Frame>
</Step>

<Step title="Enter Proxy Details">
  1. Enter a recognizable name in the **Proxy Name** field to identify the configuration later.

  2. Input the following details retrieved from your [Bright Data dashboard](https://brightdata.com/cp/zones/page/plans):
     * **Proxy Type**: Select HTTP, HTTPS, or SOCKS5 based on your proxy type.
     * **Proxy Host**: Enter `http://brd.superproxy.io/`.
     * **Proxy Port**: Use the port number provided in your Bright Data dashboard.
     * **Proxy username**: Enter your Bright Data `username`.
     * **Proxy password**: Enter your Bright Data `password`.

  3. Test the proxy connection by clicking **Check Proxy**. Ensure the connection is successful before proceeding.

  4. After verifying, click **OK** to save the configuration.

  <Note>
    If you need proxies for a specific location, include the country code in your username. Format it as:
    `your-username-country-XX` (e.g., `your-username-country-US`) to select a proxy from the desired country.
  </Note>
</Step>

You're All Set! With your proxy successfully configured, Maskfog is now equipped with Bright Data for secure and anonymous connections. Enjoy enhanced privacy and seamless browsing.


# How to set up Bright Data with MoreLogin
Source: https://docs.brightdata.com/integrations/morelogin

Pair Bright Data (400M+ residential IPs) with MoreLogin for secure, anonymous browsing and better protection against detection in data collection.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is MoreLogin?

MoreLogin is a powerful tool designed to help you manage multiple online identities from a single device. Perfect for privacy-conscious users, marketers, and researchers, MoreLogin allows you to operate several profiles, each as a unique digital identity. Each profile has its own IPs, cookies, and device fingerprints, reducing the risk of detection and account bans.

With seamless proxy integration, MoreLogin adds another layer of anonymity to your online activities. Plus, it supports profile sharing, making it ideal for affiliate marketing, market research, and data collection. Whether you're scaling data collection or growing your research operations, MoreLogin helps you stay secure and efficient.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## MoreLogin Proxy Integration

Here’s how you can easily integrate Bright Data proxies with MoreLogin:

<Steps>
  <Step title="Install MoreLogin">
    Visit the [MoreLogin website](https://www.morelogin.com/) to download and install the app.
  </Step>

  <Step title="Create an Account">
    Log in and get started with the setup process.
  </Step>

  <Step title="Create a New Profile">
    Click the **+New profile** button to set up your profile details.

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Set Initial Profile Settings">
    Enter the profile name, select your desired browser fingerprint, and click **Advanced Create** to access additional settings.

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Configure Proxy Settings">
    Scroll to the **Proxies** section and enter your Bright Data proxy details:

    * **Proxy Type**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **Proxy Server**: Enter `http://brd.superproxy.io/`.
    * **Proxy Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Proxy Account**: Enter your Bright Data proxy `username`.
    * **Proxy Password**: Enter your Bright Data proxy `password`.

    <Info>
      **You can also specify a country for your proxy. For instance, entering `your-username-country-US` will give you a US-based exit node.**
    </Info>

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>

  <Step title="Test the Proxy">
    Click **Check Proxy** to make sure everything is working correctly.
  </Step>

  <Step title="Save and Launch">
    Click **Confirm** to save your settings, then hit **Start** to open your profile in a secure browsing session.

    <Frame>
      <img alt="MoreLogin Proxy Integration" />
    </Frame>
  </Step>
</Steps>

And that's it! You've now successfully integrated Bright Data proxies with MoreLogin.


# How to use Bright Data with MuLogin
Source: https://docs.brightdata.com/integrations/mulogin

Configure Bright Data proxies (400M+ IPs) in MuLogin to assign isolated IPs to each browser profile for anonymous, geo-targeted multi-account workflows.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is MuLogin?

MuLogin is a multi-profile browser management tool that helps you run multiple online accounts without them interfering with each other. It’s designed to protect your privacy, prevent detection, and streamline your digital operations. With MuLogin, you can handle multiple sessions seamlessly, perfect for web scraping, market research, and other data collection projects.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

## Why Integrate Bright Data with MuLogin?

By adding Bright Data proxies to MuLogin, you’ll:

* **Protect Your Identity**: Keep your real IP hidden behind secure, anonymous proxies.
* **Reduce Detection Risks**: Spread out your activities over diverse IP addresses, minimizing the chance of blocks or bans.
* **Improve Reliability**: Access geo-targeted content smoothly and maintain stable connections across sessions.

## How to Integrate Bright Data with MuLogin

Follow these steps to configure Bright Data proxies in MuLogin:

<Steps>
  <Step title="Access the MuLogin Dashboard">
    1. Visit [MuLogin ](https://www.mulogin.com/) and sign in to your account.
    2. Once logged in, you’ll see your dashboard with existing browser profiles (if any).
  </Step>

  <Step title="Create or Edit a Browser Profile">
    1. If you need a new profile, click **"Quick create"** or a similar button.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>

    2. If you want to modify an existing profile, select it from the list and click on **"Edit"**, **"Settings"**, or the **gear icon**, the exact naming may vary based on MuLogin’s current UI.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>
  </Step>

  <Step title="Assign a Display Name and Access Proxy Settings">
    1. On the profile configuration page, under the **“Basic Configuration”** section, locate the **“Display name”** field.
    2. Enter a clear, recognizable name for your browser profile to make it easier to identify later.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>

    3. Scroll down the page to find the **“Proxy Settings”** option. Click on it to open the proxy configuration window.

    <Frame>
      <img alt="How to Integrate Bright Data with MuLogin" />
    </Frame>
  </Step>

  <Step title="Input Your Bright Data Proxy Details">
    1. Once you’ve opened the proxy configuration window, you should see fields for the following:

       * **Protocol/Type:** Choose HTTP, HTTPS, or SOCKS5 depending on the proxy type you have from Bright Data.
         <Frame>
           <img alt="How to Integrate Bright Data with MuLogin" />
         </Frame>

       * **Host:** Enter `http://brd.superproxy.io/` or the host provided by Bright Data.

       * **Port:** Input the port number from your [Bright Data dashboard](https://brightdata.com/cp/zones).

       * **Username & Password:** Type in your Bright Data credentials.

       <Note>If you need a region-specific node (e.g., US), adjust your username to `your-username-country-US`.</Note>

    2. After entering your Bright Data proxy details (Host, Port, Username, and Password), look for a **“Check the network”** or **“Test Proxy”** button. Click it to verify that the proxy connection works correctly.

    3. If the test is successful, confirm your setup by clicking **“Save”**.
  </Step>

  <Step title="Launch the Browser Profile and Verify">
    1. After saving, launch the profile from your MuLogin dashboard.
    2. Inside this isolated browser, navigate to a site like [httpbin.org/ip](http://httpbin.org/ip) to verify that the displayed IP matches your Bright Data proxy’s IP instead of your own.
    3. If the IP matches, congratulations, your MuLogin profile is now using Bright Data proxies.
  </Step>
</Steps>

With **Bright Data** integrated into **MuLogin**, you’ve taken your online operations up a notch. Now you can manage multiple profiles more confidently, enjoying greater privacy, fewer detection issues, and a smooth, reliable workflow.


# How to set up Bright Data with Multilogin
Source: https://docs.brightdata.com/integrations/multilogin

Integrate Bright Data (400M+ residential IPs) with Multilogin for secure, undetectable browsing and improved privacy in web scraping and data collection.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Multilogin?

Multilogin is a powerful browser tool designed for managing multiple online accounts without the risk of detection or bans. It’s a popular choice for marketers, affiliate marketers, and researchers who need isolated browsing environments for data collection and competitive intelligence.

Multilogin works by creating isolated, unique browsing profiles that simulate separate devices. Each profile appears as if it’s being accessed from a different location or device, making it impossible for platforms to link accounts. This ensures safer, undetected browsing, so you can manage multiple accounts with confidence.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## Multilogin Proxy Integration

Follow these simple steps to set up Bright Data proxies in Multilogin:

<Steps>
  <Step title="Open Multilogin">
    Launch the [**Multilogin app**](https://multilogin.com/) and log in to your account.
  </Step>

  <Step title="Create a New Profile">
    Click on **New Profile** and enter the following details:

    * **Profile Name:** Choose a name for your profile (e.g., *Bright Data*).

    * **Operating System:** Select the operating system that matches your original setup (macOS, Windows, or Linux) to avoid fingerprint discrepancies.

    * **Storage Type:** Choose **Cloud Storage** if you plan to work in a team or use the profile on multiple devices.

    * **Browser Type:** Select between **Mimic** (based on Chrome) or **Stealthfox** (based on Firefox). Both options offer excellent anti-detection features.
  </Step>

  <Step title="Add a New Proxy">
    Within the profile settings, navigate to the **Proxy** section and choose **Custom**.
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    Follow these steps to enter your Bright Data proxy details:

    * **Proxy**: Choose from `HTTP`, `HTTPS`, or `SOCKS5` (based on your proxy type).
    * **New address:**  Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    Click **Check Proxy** to verify the connection.

    <Info>
      * For **country-specific** proxies, you can enter a format like `your-username-country-US` to receive a US exit node.
      * If you configure multiple sessions, and you would like to assign specific IP to each session, add the IP address of the specific proxy with the option `-ip` to the username. So if the IP you want to use is `1.2.3.4` it should be: `your-username-ip-1.2.3.4`.
    </Info>
  </Step>

  <Step title="Save Your Settings">
    Once you’ve entered all the proxy details, click **Create Profile** to save your settings.
  </Step>
</Steps>

And that's it! You’ve successfully integrated Bright Data proxies with Multilogin.


# Set up Bright Data with Octo Browser
Source: https://docs.brightdata.com/integrations/octobrowser

Integrate Bright Data proxies (400M+ IPs) with Octo Browser to add anti-detection-grade IP routing to multi-account browsing and scraping workflows.

<Warning>
  **Social media and eCommerce account management are not supported use cases** on the Bright Data platform as of April 1, 2026. This includes managing accounts on platforms like TikTok, Instagram, or similar services. Bright Data proxies cannot be used for this purpose. See [Acceptable Use Policy](https://brightdata.com/acceptable-use-policy) for details.
</Warning>

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access Bright Data's **Residential Proxies** you must be a KYC-verified business account. Complete KYC verification with the Bright Data compliance team; there is no automatic or no-KYC path. Without KYC, use ISP or Datacenter proxies. [Read more...](/products/residential/network-access)

  ### Targeting search engines?

  If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (**SERP**) proxy API. Use Bright Data SERP API to target search engines.
  [Click here to read more about Bright Data SERP proxy API.](/products/serp-api/introduction)

  ### Correct setup of proxy test to avoid "PROXY ERROR"

  In many tools you will see a "test proxy" function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
  To correctly test your proxy you should target those search queries to:
  `https://geo.brdtest.com/welcome.txt` .

  Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show **proxy error** although your proxy is perfectly fine.

  If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
</Accordion>

## What is Octo Browser?

Octo Browser is a smart tool for managing multiple browser profiles without the risk of detection. It’s perfect for marketers, researchers, and web scrapers who need anonymous, geo-flexible browsing.

Octo Browser creates separate profiles, each with its own unique settings, such as IP addresses and device details, ensuring your accounts stay unlinked. It supports HTTP, HTTPS, and SOCKS5 proxies, and offers features like automation and team collaboration, making it a powerful, user-friendly solution for secure and efficient online activity.

<Tip>
  Maintain a consistent IP throughout your browser session by using the `-session` parameter in your username. This is essential because BrightData proxies default to rotating IPs with each request. [Learn more](/proxy-networks/faqs#how-to-use-the-same-ip-for-an-extended-period-of-time-and-how-long-can-i-keep-it-long-session) <br />

  New users should begin with ISP or Datacenter proxies, which need no KYC. Residential proxies require a [KYC-verified business account](/products/residential/network-access).<br />
</Tip>

<Warning>
  Connections to the following social networks are not supported on Data Center and ISP proxy networks: Facebook, TikTok, Instagram, X (Twitter), LinkedIn, YouTube, Reddit, Pinterest, Snapchat, and Discord.
</Warning>

## Octo Browser Proxy Integration

Here’s how to integrate Bright Data proxies into Octo Browser:

<Steps>
  <Step title="Install Octo Browser">
    Download and install [**Octo Browser**](https://octobrowser.net/download/), then log in to your account.
  </Step>

  <Step title="Create Profile">
    1. Navigate to **Profiles** and click **Create Profile**.
    2. Name your profile and set your desired configuration.
  </Step>

  <Step title="Add a Proxy">
    1. Go to the **Connection** tab in the profile settings and click on the **Proxy** field.
    2. Click **+ Set a new proxy** to open the proxy configuration window.
  </Step>

  <Step title="Configure Your Bright Data Proxy">
    In the pop-up window, enter your Bright Data proxy details:

    * **Host**: Enter `http://brd.superproxy.io/`.
    * **Port**: Use the port number provided in your [Bright Data dashboard](https://brightdata.com/cp/zones).
    * **Login**: Enter your Bright Data proxy `username`.
    * **Password**: Enter your Bright Data proxy `password`.

    <Info>
      **For country-specific proxies, you can enter a format like `your-username-country-US` to receive a US exit node.**
    </Info>
  </Step>

  <Step title="Test the Proxy">
    1. Click **Check Proxy** to ensure the connection is active and working correctly.
    2. Once confirmed, click **Confirm** to save the proxy settings to the profile.
  </Step>

  <Step title="Save and Launch the Profile">
    1. Click **Create Profile** to save your setup.
    2. You can now launch your configured profile by clicking **Start** in the Profiles section.
  </Step>
</Steps>

And that’s it! You’ve successfully integrated Bright Data proxies with Octo Browser.


# How to set up Bright Data with Postern
Source: https://docs.brightdata.com/integrations/postern

Configure Bright Data proxies in Postern on Android to route system-wide traffic through residential, datacenter, ISP, or mobile IPs. Spans 195 countries.

<Accordion title="Expand to get your Bright Data Proxy Access Information">
  ### Your proxy access information

  Bright Data proxies are grouped in "Proxy zones". Each zone holds the configuration for the proxies it holds.

  To get access to the proxy zone:

  1. Login to Bright Data control panel
  2. Select the proxy zone or setup a new one
  3. Click on the new zone name, and select the **Overview** tab.
  4. In the overview tab, under **Access details** you can find the proxy access details, and copy them to clipboard on click.
  5. You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
  6. Click on the copy icons to copy the text to your clipboard and paste in your tool's proxy configuration.

  ### Access Details Section Example

  <img alt="" />

  ### Residential proxy access

  To access