Bright Data

Bright Data Scraping Shield API

Compliance-focused classification API that exposes Bright Data's allowlist/blocklist taxonomy. `GET /shield/class` lists every classification, `/shield/domains_by_class` returns domains by category, `/shield/samples` returns sample classifications, and `/shield/zones_by_class` reports the zones cleared for each class.

Bright Data Scraping Shield API is one of 11 APIs that Bright Data publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Compliance, Domain Classification, and Trust and Safety. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.brightdata.com/api-reference/scraping-shield-api/Scraping-Shield-API-Overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bright-data/refs/heads/main/openapi/bright-data-scraping-shield-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/bright-data/refs/heads/main/capabilities/scraping-shield.yaml

OpenAPI Specification

bright-data-scraping-shield-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Bright Data Scraping Shield API
  description: |
    Compliance-focused classification API that exposes Bright Data's allowlist/blocklist taxonomy.
    Use Scraping Shield to confirm whether a domain falls into a supported classification, retrieve
    sample classifications, and inspect which zones are cleared for each class.
  version: '1.0'
  contact:
    name: Bright Data
    url: https://docs.brightdata.com
servers:
  - url: https://api.brightdata.com
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Shield
paths:
  /shield/class:
    get:
      summary: List Shield Classifications
      operationId: listShieldClasses
      tags: [Shield]
      responses:
        "200":
          description: Classifications.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id: { type: string }
                    name: { type: string }
                    description: { type: string }
  /shield/domains_by_class:
    get:
      summary: List Domains by Classification
      operationId: domainsByClass
      tags: [Shield]
      parameters:
        - { name: class, in: query, required: true, schema: { type: string } }
      responses:
        "200":
          description: Domains for the class.
          content:
            application/json:
              schema:
                type: array
                items: { type: string }
  /shield/samples:
    get:
      summary: Get Shield Classification Samples
      operationId: getShieldSamples
      tags: [Shield]
      parameters:
        - { name: class, in: query, schema: { type: string } }
      responses:
        "200":
          description: Samples.
          content:
            application/json:
              schema:
                type: array
                items: { type: object, additionalProperties: true }
  /shield/zones_by_class:
    get:
      summary: List Zones by Classification
      operationId: zonesByClass
      tags: [Shield]
      parameters:
        - { name: class, in: query, required: true, schema: { type: string } }
      responses:
        "200":
          description: Zones cleared for the class.
          content:
            application/json:
              schema:
                type: array
                items: { type: string }
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer