MrScraperMrScraper
Dashboard
DocumentationAPI ReferenceResidential ProxyChangelog
Analytic

Get Analytic Statuses

Retrieve scrape status counts for a domain within a date range using the MrScraper API, with optional action and API token name filters.

This endpoint retrieves scrape status counts for a specified domain within a given date range. You can optionally filter the results by action and API Token name.

Note

  • Use the Platform API Server (https://api.app.mrscraper.com) host when calling this endpoint.
  • This endpoint uses UTC by default. If you want to query data in another timezone, convert the startDate and endDate values to their UTC equivalents before making the request.
GET
/api/v1/analytic/statuses

Authorization

apiKey
x-api-token<token>

In: header

Query Parameters

domain*string

Domain to aggregate statuses for

action?string

Action filter for custom scrapers

startDate*string

Start date in yyyy-MM-dd HH:mm:ss format

endDate*string

End date in yyyy-MM-dd HH:mm:ss format

apiTokenName?string

API token name to filter the analytics data

Response Body

application/json

application/json

curl -X GET "https://api.app.mrscraper.com/api/v1/analytic/statuses?domain=string&startDate=2026-01-01+00%3A00%3A00&endDate=2026-04-14+23%3A59%3A59"
{
  "message": "Successful operation!",
  "data": {
    "countAll": 35,
    "successRate": 100,
    "reqPerMinute": 0.00023597785853464491,
    "avgLatency": 0,
    "data": [
      {
        "key": "PENDING",
        "value": 0
      },
      {
        "key": "RUNNING",
        "value": 0
      },
      {
        "key": "PROCESSING",
        "value": 0
      },
      {
        "key": "COMPLETED",
        "value": "35"
      },
      {
        "key": "FAILED",
        "value": 0
      },
      {
        "key": "CANCELLED",
        "value": 0
      }
    ]
  }
}
{
  "message": "Unauthorized access",
  "error": "Unauthorized"
}

Get a Detailed Result GET

Retrieve detailed information for a single scraping result by its unique identifier with the MrScraper API, including data, status, and token usage.

Get Proxy Requests Bandwidth GET

Retrieve total proxy bandwidth usage aggregated per proxy username within a given date range using the MrScraper API.