# google-search-console.url.inspect

Index status, canonical and last crawl of a URL on a site

> Index inspection.

Page: https://telipot.com/catalog/tasks/google-search-console.url.inspect · Markdown: https://telipot.com/catalog/tasks/google-search-console.url.inspect/md · JSON: https://telipot.com/catalog/tasks/google-search-console.url.inspect/json

| Field | Value |
| --- | --- |
| provider | [Google Search Console](https://telipot.com/catalog/providers/google-search-console) `google-search-console` |
| capability | [`search-console.url.inspect`](https://telipot.com/catalog/capabilities/search-console.url.inspect) |
| kind | data |
| tier | core |
| price | Free (Free from the tool) |
| identity | Company account |
| auth | `oauth · OAuth 2.0 with PKCE` |
| scope | own_account |
| principal | organization |
| required_scopes | `webmasters.readonly` |
| retention | standard |
| route | `POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://developers.google.com/webmaster-tools/v1/urlInspection.index/inspect |

## Preview the price · nothing runs

```bash
telipot run google-search-console.url.inspect \
  --input-json '{"inspectionUrl":"https://www.example.com/pricing","siteUrl":"sc-domain:example.com"}' \
  --quote
```

## Run it

```bash
telipot run google-search-console.url.inspect \
  --input-json '{"inspectionUrl":"https://www.example.com/pricing","siteUrl":"sc-domain:example.com"}'
```

```bash
curl https://api.telipot.com/v1/tasks/google-search-console.url.inspect/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inspectionUrl":"https://www.example.com/pricing","siteUrl":"sc-domain:example.com"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `inspectionUrl` | body | string | yes |  | The URL to inspect, which must be under the property named in siteUrl |
| `siteUrl` | body | string | yes |  | The property as sites.list returns it, a URL-prefix property with its trailing slash or a domain property written sc-domain:example.com |
| `languageCode` | body | string | no | default "en-US" | An IETF BCP-47 code for the language of the translated issue messages |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "inspectionUrl": {
      "type": "string",
      "description": "The URL to inspect, which must be under the property named in siteUrl",
      "examples": [
        "https://www.example.com/pricing"
      ]
    },
    "siteUrl": {
      "type": "string",
      "description": "The property as sites.list returns it, a URL-prefix property with its trailing slash or a domain property written sc-domain:example.com",
      "examples": [
        "sc-domain:example.com"
      ]
    },
    "languageCode": {
      "type": "string",
      "description": "An IETF BCP-47 code for the language of the translated issue messages",
      "default": "en-US"
    }
  },
  "required": [
    "inspectionUrl",
    "siteUrl"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "inspectionResult"
  ],
  "properties": {
    "inspectionResult": {
      "type": "object",
      "required": [
        "inspectionResultLink"
      ],
      "properties": {
        "inspectionResultLink": {
          "type": "string",
          "description": "The URL inspection page in Search Console"
        },
        "indexStatusResult": {
          "type": "object",
          "properties": {
            "verdict": {
              "type": "string",
              "description": "PASS when the URL is indexed, PARTIAL, FAIL or NEUTRAL"
            },
            "coverageState": {
              "type": "string",
              "description": "Whether Google could find and index the page in words"
            },
            "robotsTxtState": {
              "type": "string",
              "description": "ALLOWED or DISALLOWED"
            },
            "indexingState": {
              "type": "string",
              "description": "INDEXING_ALLOWED, or the noindex rule that blocks it"
            },
            "pageFetchState": {
              "type": "string",
              "description": "Whether Google could retrieve the page such as SUCCESSFUL or NOT_FOUND"
            },
            "lastCrawlTime": {
              "type": "string",
              "description": "RFC 3339 time; absent when the URL was never crawled"
            },
            "googleCanonical": {
              "type": "string",
              "description": "The canonical Google selected; absent when the page is not indexed"
            },
            "userCanonical": {
              "type": "string",
              "description": "The canonical the page declares"
            },
            "crawledAs": {
              "type": "string",
              "description": "DESKTOP or MOBILE"
            },
            "sitemap": {
              "type": "array",
              "description": "Sitemaps Google knows list this URL",
              "items": {
                "type": "string"
              }
            },
            "referringUrls": {
              "type": "array",
              "description": "URLs that link to this URL",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "richResultsResult": {
          "type": "object",
          "description": "Absent when no rich result was found"
        },
        "ampResult": {
          "type": "object",
          "description": "Absent when the page is not an AMP page"
        }
      }
    }
  }
}
```

## Example response

From `examples/google-search-console.url.inspect.json`.

```json
{
  "inspectionResult": {
    "inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=sc-domain%3Aexample.com&id=EXAMPLE",
    "indexStatusResult": {
      "verdict": "PASS",
      "coverageState": "Submitted and indexed",
      "robotsTxtState": "ALLOWED",
      "indexingState": "INDEXING_ALLOWED",
      "pageFetchState": "SUCCESSFUL",
      "lastCrawlTime": "2026-10-02T04:12:09Z",
      "googleCanonical": "https://www.example.com/pricing",
      "userCanonical": "https://www.example.com/pricing",
      "crawledAs": "MOBILE",
      "sitemap": [
        "https://www.example.com/sitemap.xml"
      ]
    }
  }
}
```
