# google-search-console.sites.list

Sites and permission levels on the connected account

> Lists the user's Search Console sites.

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

| Field | Value |
| --- | --- |
| provider | [Google Search Console](https://telipot.com/catalog/providers/google-search-console) `google-search-console` |
| capability | [`search-console.sites.list`](https://telipot.com/catalog/capabilities/search-console.sites.list) |
| kind | utility |
| 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 | `GET https://searchconsole.googleapis.com/webmasters/v3/sites` |
| 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/sites/list |

## Preview the price · nothing runs

```bash
telipot run google-search-console.sites.list \
  --input-json '{}' \
  --quote
```

## Run it

```bash
telipot run google-search-console.sites.list \
  --input-json '{}'
```

```bash
curl https://api.telipot.com/v1/tasks/google-search-console.sites.list/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Input schema

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "siteEntry": {
      "type": "array",
      "description": "Absent when the account has no site",
      "items": {
        "type": "object",
        "required": [
          "siteUrl",
          "permissionLevel"
        ],
        "properties": {
          "siteUrl": {
            "type": "string",
            "description": "A URL-prefix property with its trailing slash, or a domain property written sc-domain:example.com"
          },
          "permissionLevel": {
            "type": "string",
            "description": "siteOwner, siteFullUser, siteRestrictedUser or siteUnverifiedUser"
          }
        }
      }
    }
  }
}
```

## Example response

From `examples/google-search-console.sites.list.json`.

```json
{
  "siteEntry": [
    {
      "siteUrl": "sc-domain:example.com",
      "permissionLevel": "siteOwner"
    },
    {
      "siteUrl": "https://www.example.com/",
      "permissionLevel": "siteFullUser"
    }
  ]
}
```