> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Unlocker API success rate

> Use the Bright Data Web Unlocker API success rate endpoint. GET /unblocker/success_rate/{domain} returns per-domain success rates for the past 7 days.

The Bright Data Web Unlocker API success rate endpoint returns the share of requests that succeeded against a domain over the past 7 days, as a number between 0 and 1.

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.

Related guide: [Web Unlocker API features](/products/web-unlocker/features#get-success-rate-statistics-per-domain)


## OpenAPI

````yaml api-reference/unlocker-rest-api GET /unblocker/success_rate/{domain}
openapi: 3.0.1
info:
  title: Brightdata API
  description: >-
    Integrate Bright Data APIs to your pipeline and secure high-end scraping
    precision
  version: 1.0.0
servers:
  - url: https://api.brightdata.com
security:
  - bearerAuth: []
paths:
  /unblocker/success_rate/{domain}:
    get:
      summary: Get success rate statistics per domain
      description: >-
        Returns Bright Data Web Unlocker API success rate statistics for the
        past 7 days. Pass a single domain such as `example.com` for one figure,
        or a wildcard such as `example.*` to get one figure per monitored
        top-level domain.
      parameters:
        - in: path
          name: domain
          required: true
          description: >-
            Domain to report on. Use a single domain such as `example.com`, or a
            wildcard such as `example.*` to return every monitored top-level
            domain.
          schema:
            type: string
            example: example.com
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessRateResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTP401'
      x-codeSamples:
        - lang: shell
          label: cURL
          source: |-
            curl --request GET \
              --url https://api.brightdata.com/unblocker/success_rate/example.com \
              --header "Authorization: Bearer YOUR_API_KEY" \
              --header "Content-Type: application/json"
        - lang: python
          label: Python
          source: >-
            import requests


            url =
            "https://api.brightdata.com/unblocker/success_rate/example.com"

            headers = {
                "Authorization": "Bearer YOUR_API_KEY",
                "Content-Type": "application/json",
            }


            response = requests.get(url, headers=headers)

            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const response = await
            fetch("https://api.brightdata.com/unblocker/success_rate/example.com",
            {
              headers: {
                "Authorization": "Bearer YOUR_API_KEY",
                "Content-Type": "application/json",
              },
            });


            const data = await response.json();

            console.log(data);
        - lang: php
          label: PHP
          source: >-
            <?php

            $ch =
            curl_init("https://api.brightdata.com/unblocker/success_rate/example.com");

            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

            curl_setopt($ch, CURLOPT_HTTPHEADER, [
                "Authorization: Bearer YOUR_API_KEY",
                "Content-Type: application/json",
            ]);


            $response = curl_exec($ch);

            curl_close($ch);

            echo $response;
        - lang: go
          label: Go
          source: "package main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n)\n\nfunc main() {\n\treq, _ := http.NewRequest(\"GET\", \"https://api.brightdata.com/unblocker/success_rate/example.com\", nil)\n\treq.Header.Set(\"Authorization\", \"Bearer YOUR_API_KEY\")\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\n\tres, err := http.DefaultClient.Do(req)\n\tif err != nil { panic(err) }\n\tdefer res.Body.Close()\n\n\tbody, _ := io.ReadAll(res.Body)\n\tfmt.Println(string(body))\n}"
        - lang: java
          label: Java
          source: |-
            import java.net.URI;
            import java.net.http.HttpClient;
            import java.net.http.HttpRequest;
            import java.net.http.HttpResponse;

            public class UnlockerSuccessRate {
                public static void main(String[] args) throws Exception {
                    HttpRequest request = HttpRequest.newBuilder()
                        .uri(URI.create("https://api.brightdata.com/unblocker/success_rate/example.com"))
                        .header("Authorization", "Bearer YOUR_API_KEY")
                        .header("Content-Type", "application/json")
                        .GET()
                        .build();

                    HttpResponse<String> response = HttpClient.newHttpClient()
                        .send(request, HttpResponse.BodyHandlers.ofString());
                    System.out.println(response.body());
                }
            }
        - lang: ruby
          label: Ruby
          source: >-
            require 'net/http'

            require 'uri'


            uri =
            URI.parse("https://api.brightdata.com/unblocker/success_rate/example.com")

            request = Net::HTTP::Get.new(uri)

            request["Authorization"] = "Bearer YOUR_API_KEY"

            request["Content-Type"] = "application/json"


            response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) {
            |http| http.request(request) }

            puts response.body
components:
  schemas:
    SuccessRateResponse:
      type: object
      description: >-
        Map of domain to success rate over the past 7 days, as a number between
        0 and 1.
      additionalProperties:
        type: number
      example:
        example.com: 0.9835548316870116
        example.fr: 0.987469724604454
        example.co.uk: 0.9503769840916476
        example.ca: 0.9904893224078992
        example.de: 0.9864620859972142
    HTTP401:
      type: object
      example:
        error: User authentication is required
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use your Bright Data API Key as a Bearer token in the Authorization
        header.


        **How to authenticate:**

        1. Obtain your API Key from the Bright Data account settings at
        https://brightdata.com/cp/setting/users

        2. Include the API Key in the Authorization header of your requests

        3. Format: `Authorization: Bearer YOUR_API_KEY`


        **Example:**

        ```

        Authorization: Bearer
        b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

        ```


        Learn how to get your Bright Data API key:
        https://docs.brightdata.com/api-reference/authentication
      bearerFormat: API Key

````