Bright Data

Bright Data Proxies API

The Proxies API from Bright Data — 4 operation(s) for proxies.

Documentation GitHub OpenAPI

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/bright-data-proxies-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Bright Data Account Management Access Proxies API
  description: 'Programmatic management of Bright Data zones (proxy pools and product entitlements), IP

    allocations, access control (whitelists, blacklists, domain permissions), passwords, and

    billing/bandwidth reporting. Authentication uses a Bearer API token issued from the control panel.

    '
  version: '1.0'
  contact:
    name: Bright Data
    url: https://docs.brightdata.com
servers:
- url: https://api.brightdata.com
  description: Production
security:
- BearerAuth: []
tags:
- name: Proxies
paths:
  /api/proxies:
    get:
      summary: List Proxy Ports
      operationId: listProxies
      tags:
      - Proxies
      responses:
        '200':
          description: Configured ports.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProxyPort'
    post:
      summary: Create Proxy Port
      operationId: createProxy
      tags:
      - Proxies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProxyPort'
      responses:
        '200':
          description: Port created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProxyPort'
  /api/proxies/{port}:
    parameters:
    - name: port
      in: path
      required: true
      schema:
        type: integer
    get:
      summary: Get Proxy Port
      operationId: getProxy
      tags:
      - Proxies
      responses:
        '200':
          description: Port detail.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProxyPort'
    put:
      summary: Update Proxy Port
      operationId: updateProxy
      tags:
      - Proxies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProxyPort'
      responses:
        '200':
          description: Updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProxyPort'
    delete:
      summary: Delete Proxy Port
      operationId: deleteProxy
      tags:
      - Proxies
      responses:
        '200':
          description: Deleted.
          content:
            application/json:
              schema:
                type: object
  /api/proxies/{port}/banip:
    parameters:
    - name: port
      in: path
      required: true
      schema:
        type: integer
    post:
      summary: Ban an IP for Port
      operationId: banIp
      tags:
      - Proxies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - ip
              properties:
                ip:
                  type: string
                ttl_ms:
                  type: integer
      responses:
        '200':
          description: Banned.
          content:
            application/json:
              schema:
                type: object
  /api/refresh_ips:
    post:
      summary: Refresh IPs
      operationId: refreshIps
      tags:
      - Proxies
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                zone:
                  type: string
                ips:
                  type: integer
      responses:
        '200':
          description: Refresh started.
          content:
            application/json:
              schema:
                type: object
components:
  schemas:
    ProxyPort:
      type: object
      properties:
        port:
          type: integer
        zone:
          type: string
        country:
          type: string
        city:
          type: string
        session:
          type: string
          enum:
          - rand
          - sticky
          - round-robin
        sticky_ip:
          type: boolean
        rotate_session:
          type: integer
        max_requests:
          type: integer
        allow_proxy_auth:
          type: boolean
        log:
          type: string
          enum:
          - none
          - error
          - warn
          - info
          - debug
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer