URL Crawl Errors Counts: query

Requires authorization

Retrieves a time series of the number of URL crawl errors per error category and platform. Try it now.

Request

HTTP request

GET https://www.googleapis.com/webmasters/v3/sites/siteUrl/urlCrawlErrorsCounts/query

Parameters

Parameter name Value Description
Path parameters
siteUrl string The site's URL, including protocol. For example: http://www.example.com/
Optional query parameters
category string The crawl error category. For example: serverError. If not specified, returns results for all categories.

Acceptable values are:
  • "authPermissions"
  • "flashContent"
  • "manyToOneRedirect"
  • "notFollowed"
  • "notFound"
  • "other"
  • "roboted"
  • "serverError"
  • "soft404"
latestCountsOnly boolean If true, returns only the latest crawl error counts. (Default: true)
platform string The user agent type (platform) that made the request. For example: web. If not specified, returns results for all platforms.

Acceptable values are:
  • "mobile"
  • "smartphoneOnly"
  • "web"

Authorization

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/webmasters.readonly
https://www.googleapis.com/auth/webmasters

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "countPerTypes": [
    {
      "platform": string,
      "category": string,
      "entries": [
        {
          "count": long,
          "timestamp": datetime
        }
      ]
    }
  ]
}
Property name Value Description Notes
countPerTypes[] list The time series of the number of URL crawl errors per error category and platform.
countPerTypes[].platform string The general type of Googlebot that made the request (see list of Googlebot user-agents for the user-agents used).

Acceptable values are:
  • "mobile"
  • "smartphoneOnly"
  • "web"
countPerTypes[].category string The crawl error type.

Acceptable values are:
  • "authPermissions"
  • "flashContent"
  • "manyToOneRedirect"
  • "notFollowed"
  • "notFound"
  • "other"
  • "roboted"
  • "serverError"
  • "soft404"
countPerTypes[].entries[] list The error count entries time series.
countPerTypes[].entries[].count long The error count at the given timestamp.
countPerTypes[].entries[].timestamp datetime The date and time when the crawl attempt took place, in RFC 3339 format.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.