Google Search Console

Google Search Console Sites API

Manage site-level access and verification. List verified sites, get details about a specific site, add new sites, and remove sites from your Search Console account.

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /webmasters/v3/sites List my Search Console properties · Google Search Console List Sites #
Ask an LLM
“Which websites do I have access to in Search Console?”
“Can I see every property I'm verified for or was delegated access to?”
Tell an agent
List all my Search Console sites.
Show every property my account can access in Search Console.
GET /webmasters/v3/sites/{siteUrl} Check my permission level on a site · Google Search Console Get Site Details #
Ask an LLM
“What permission level do I have on a particular Search Console property?”
“Am I an owner or just a restricted user on this site?”
Tell an agent
Get the details and my permission level for {siteUrl}.
Check what access I have to the property {siteUrl}.
PUT /webmasters/v3/sites/{siteUrl} Add a site to Search Console · Google Search Console Add a Site #
Ask an LLM
“How do I add a new website or domain property to my Search Console account?”
“Do I still need to verify a site after adding it through the API?”
Tell an agent
Add {siteUrl} to my Search Console sites.
Register the property {siteUrl} in my Search Console account.
DELETE /webmasters/v3/sites/{siteUrl} Remove a site from Search Console · Google Search Console Remove a Site #
Ask an LLM
“How can I take a property off my Search Console site list?”
“Does removing a site from my account delete its Search Console data?”
Tell an agent destructive · confirm first
Remove {siteUrl} from my Search Console sites.
Drop the property {siteUrl} from my account's site list.

Documentation

📖
Documentation
https://developers.google.com/webmaster-tools/v1/api_reference_index
📖
Documentation
https://searchconsole.googleapis.com/$discovery/rest?version=v1
📖
Authentication
https://developers.google.com/webmaster-tools/v1/how-tos/authorizing
📖
Documentation
https://developers.google.com/webmaster-tools/about
📖
Documentation
https://developers.google.com/webmaster-tools/v1/prereqs
📖
GettingStarted
https://developers.google.com/webmaster-tools/v1/quickstart/quickstart-python
📖
Documentation
https://developers.google.com/webmaster-tools/v1/how-tos/search_analytics
📖
APIReference
https://developers.google.com/webmaster-tools/v1/searchanalytics/query
📖
APIReference
https://developers.google.com/webmaster-tools/v1/sitemaps
📖
APIReference
https://developers.google.com/webmaster-tools/v1/sitemaps/get
📖
APIReference
https://developers.google.com/webmaster-tools/v1/sitemaps/submit
📖
APIReference
https://developers.google.com/webmaster-tools/v1/sites/get
📖
APIReference
https://developers.google.com/webmaster-tools/v1/urlInspection.index/inspect
📖
APIReference
https://developers.google.com/webmaster-tools/v1/urlInspection.index/UrlInspectionResult

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/google-search-console/refs/heads/main/openapi/google-search-console-sites-api-openapi.yml

Code Examples

💻
CodeExamples
Search Analytics Code Samples

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/google-search-console/refs/heads/main/json-schema/google-search-console-query-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/google-search-console/refs/heads/main/overlays/google-search-console-sites-api-overlay.yaml
🔗
Console
https://console.cloud.google.com/apis/library/searchconsole.googleapis.com
🔗
Pricing
https://developers.google.com/webmaster-tools/limits
🔗
TermsOfService
https://developers.google.com/terms
🔗
ChangeLog
https://raw.githubusercontent.com/api-evangelist/google-search-console/refs/heads/main/changelog/google-search-console-changelog.yml
🔗
Support
https://support.google.com/webmasters/
🔗
SDKs
https://developers.google.com/webmaster-tools/v1/libraries
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/google-search-console/refs/heads/main/json-ld/google-search-console-context.jsonld

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/google-search-console:google-search-console-sites-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

google-search-console-sites-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Google Search Console Sites API
  description: The Google Search Console API provides programmatic access to Search Console data. Query search analytics to understand how your site appears in Google Search results, manage sitemaps for efficient crawling, inspect individual URLs to check indexing status and crawl details, and manage site-level verification and permissions.
  version: v1
  contact:
    name: Google Search Console API Support
    url: https://support.google.com/webmasters/
  termsOfService: https://developers.google.com/terms
  license:
    name: Creative Commons Attribution 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://searchconsole.googleapis.com
  description: Google Search Console API Production Server
security:
- OAuth2:
  - https://www.googleapis.com/auth/webmasters
tags:
- name: Sites
  description: Manage site-level access and verification. List verified sites, get details about a specific site, add new sites, and remove sites from your Search Console account.
paths:
  /webmasters/v3/sites:
    get:
      operationId: listSites
      summary: Google Search Console List Sites
      description: Lists the user's Search Console sites. Returns all sites that the authenticated user has been verified for or has been granted access to through delegation.
      tags:
      - Sites
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/webmasters.readonly
      responses:
        '200':
          description: List of Search Console sites.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SitesListResponse'
              examples:
                Listsites200Example:
                  summary: Default listSites 200 response
                  x-microcks-default: true
                  value:
                    siteEntry:
                    - siteUrl: https://www.example.com
                      permissionLevel: siteOwner
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /webmasters/v3/sites/{siteUrl}:
    get:
      operationId: getSite
      summary: Google Search Console Get Site Details
      description: Retrieves information about a specific site, including its permission level for the authenticated user.
      tags:
      - Sites
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/webmasters.readonly
      parameters:
      - $ref: '#/components/parameters/SiteUrl'
      responses:
        '200':
          description: Site details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WmxSite'
              examples:
                Getsite200Example:
                  summary: Default getSite 200 response
                  x-microcks-default: true
                  value:
                    siteUrl: https://www.example.com
                    permissionLevel: siteOwner
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: addSite
      summary: Google Search Console Add a Site
      description: Adds a site to the set of the user's Search Console sites. The site URL must be a valid property URL. After adding, the site must still be verified before full data access is granted.
      tags:
      - Sites
      parameters:
      - $ref: '#/components/parameters/SiteUrl'
      responses:
        '204':
          description: Site added successfully.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteSite
      summary: Google Search Console Remove a Site
      description: Removes a site from the set of the user's Search Console sites. This does not delete any data associated with the site.
      tags:
      - Sites
      parameters:
      - $ref: '#/components/parameters/SiteUrl'
      responses:
        '204':
          description: Site removed successfully.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    Error:
      type: object
      description: Standard Google API error response.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
              description: HTTP status code.
            message:
              type: string
              description: A human-readable error message.
            status:
              type: string
              description: The status code string (e.g., INVALID_ARGUMENT).
            errors:
              type: array
              items:
                type: object
                properties:
                  message:
                    type: string
                  domain:
                    type: string
                  reason:
                    type: string
          example: example_value
    WmxSite:
      type: object
      description: A Search Console site resource representing a verified property. Properties can be URL-prefix properties or domain properties.
      properties:
        siteUrl:
          type: string
          description: 'The URL of the site. For URL-prefix properties, this is the full URL including protocol. For domain properties, this uses the sc-domain: prefix (e.g., sc-domain:example.com).'
          example: https://www.example.com
        permissionLevel:
          type: string
          description: The user's permission level for this site in Search Console.
          enum:
          - siteOwner
          - siteFullUser
          - siteRestrictedUser
          - siteUnverifiedUser
          example: siteOwner
    SitesListResponse:
      type: object
      description: Response for listing Search Console sites.
      properties:
        siteEntry:
          type: array
          description: List of verified sites.
          items:
            $ref: '#/components/schemas/WmxSite'
          example: []
  responses:
    Forbidden:
      description: Insufficient permissions for the requested operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication required or invalid credentials.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    SiteUrl:
      name: siteUrl
      in: path
      required: true
      description: The site's URL, including protocol. For domain properties, use the format sc-domain:example.com. For URL-prefix properties, use the full URL (e.g., https://example.com/). The URL must be encoded.
      schema:
        type: string
      example: https://example.com/
  securitySchemes:
    OAuth2:
      type: oauth2
      description: OAuth 2.0 authentication for accessing Google Search Console data. Requires the webmasters or webmasters.readonly scope depending on the operation.
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/v2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/webmasters: View and manage Search Console data for your verified sites
            https://www.googleapis.com/auth/webmasters.readonly: View Search Console data for your verified sites
externalDocs:
  description: Google Search Console API Documentation
  url: https://developers.google.com/webmaster-tools/v1/api_reference_index