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/{siteUrl} Check my permission level on a site · Get sites #
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}.
DELETE /webmasters/v3/sites/{siteUrl} Remove a site from Search Console · Delete sites #
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.
PUT /webmasters/v3/sites/{siteUrl} Add a site to Search Console · Add sites #
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.
GET /webmasters/v3/sites List my Search Console properties · 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.

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://artifacts.apis.io/google-search-console/openapi/google-search-console-sites-api-openapi.yml

Code Examples

💻
CodeExamples
Search Analytics Code Samples

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/google-search-console/json-schema/google-search-console-query-schema.json

Other Resources

🔗
Overlay
https://artifacts.apis.io/google-search-console/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://artifacts.apis.io/google-search-console/changelog/google-search-console-changelog.yml
🔗
Support
https://support.google.com/webmasters/
🔗
SDKs
https://developers.google.com/webmaster-tools/v1/libraries
🔗
JSONLD
https://artifacts.apis.io/google-search-console/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"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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
  version: v1
  description: Generated from Google's published Discovery document for Google Search Console API (searchconsole v1, revision 20261110). 4 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://searchconsole.googleapis.com
tags:
- name: Sites
paths:
  /webmasters/v3/sites/{siteUrl}:
    get:
      operationId: webmasters.sites.get
      summary: Get sites
      description: Retrieves information about specific site.
      parameters:
      - name: siteUrl
        in: path
        required: true
        description: The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WmxSite'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/webmasters
        - https://www.googleapis.com/auth/webmasters.readonly
      - apiKey: []
      tags:
      - Sites
    delete:
      operationId: webmasters.sites.delete
      summary: Delete sites
      description: Removes a site from the set of the user's Search Console sites.
      parameters:
      - name: siteUrl
        in: path
        required: true
        description: The URI of the property as defined in Search Console. **Examples:** `http://www.example.com/` or `sc-domain:example.com`.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/webmasters
      - apiKey: []
      tags:
      - Sites
    put:
      operationId: webmasters.sites.add
      summary: Add sites
      description: Adds a site to the set of the user's sites in Search Console.
      parameters:
      - name: siteUrl
        in: path
        required: true
        description: The URL of the site to add.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/webmasters
      - apiKey: []
      tags:
      - Sites
  /webmasters/v3/sites:
    get:
      operationId: webmasters.sites.list
      summary: List sites
      description: Lists the user's Search Console sites.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SitesListResponse'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/webmasters
        - https://www.googleapis.com/auth/webmasters.readonly
      - apiKey: []
      tags:
      - Sites
components:
  schemas:
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    SitesListResponse:
      type: object
      description: List of sites with access level information.
      properties:
        siteEntry:
          type: array
          items:
            $ref: '#/components/schemas/WmxSite'
          description: Contains permission level information about a Search Console site. For more information, see [Permissions in Search Console](https://support.google.com/webmasters/answer/2451999).
    WmxSite:
      description: Contains permission level information about a Search Console site. For more information, see [Permissions in Search Console](https://support.google.com/webmasters/answer/2451999).
      type: object
      properties:
        siteUrl:
          description: The URL of the site.
          type: string
        permissionLevel:
          description: The user's permission level for the site.
          enum:
          - SITE_PERMISSION_LEVEL_UNSPECIFIED
          - SITE_OWNER
          - SITE_FULL_USER
          - SITE_RESTRICTED_USER
          - SITE_UNVERIFIED_USER
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/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:
  url: https://developers.google.com/webmaster-tools/about
x-provenance:
  method: harvested
  publisher: Google
  source: https://searchconsole.googleapis.com/$discovery/rest?version=v1
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261110)