Endpoints

Call these through the okoro proxy at https://okoro.ai/p/google-search-console

Action	Method	Min scope
List sites	`GET`	`read`
Read site	`GET`	`read`
Add site	`PUT`	`write`
Remove site	`DELETE`	`delete`
Inspect URL	`POST`	`read`
Query search analytics	`POST`	`read`
List sitemaps	`GET`	`read`
Read sitemap	`GET`	`read`
Submit sitemap	`PUT`	`write`
Delete sitemap	`DELETE`	`delete`

Examples

Every request requires a short-lived operation token scoped to a single action.

1. Get an operation token

Exchange your service token for a short-lived operation token scoped to a single action.

TOKEN=$(curl -sX POST "https://okoro.ai/t/tokens" \
  -H "Authorization: Bearer $OKORO_SERVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider": "google-search-console", "scope": "read", "intent": "describe what you are doing"}' \
  | jq -r '.token')

2. Call the API

Use the operation token as a Bearer token. The proxy forwards the request to Google Search Console and logs the action.

List sites

curl -X GET "https://okoro.ai/p/google-search-console/webmasters/v3/sites" \
  -H "Authorization: Bearer $TOKEN"

Read site

curl -X GET "https://okoro.ai/p/google-search-console/webmasters/v3/sites/{id}" \
  -H "Authorization: Bearer $TOKEN"

Add site

curl -X PUT "https://okoro.ai/p/google-search-console/webmasters/v3/sites/{id}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Remove site

curl -X DELETE "https://okoro.ai/p/google-search-console/webmasters/v3/sites/{id}" \
  -H "Authorization: Bearer $TOKEN"

Inspect URL

curl -X POST "https://okoro.ai/p/google-search-console/v1/urlInspection/index:inspect" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Query search analytics

curl -X POST "https://okoro.ai/p/google-search-console/v1/searchanalytics/query" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List sitemaps

curl -X GET "https://okoro.ai/p/google-search-console/webmasters/v3/sites/{id}/sitemaps" \
  -H "Authorization: Bearer $TOKEN"

Read sitemap

curl -X GET "https://okoro.ai/p/google-search-console/webmasters/v3/sites/{id}/sitemaps/{id}" \
  -H "Authorization: Bearer $TOKEN"

Submit sitemap

curl -X PUT "https://okoro.ai/p/google-search-console/webmasters/v3/sites/{id}/sitemaps/{id}" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete sitemap

curl -X DELETE "https://okoro.ai/p/google-search-console/webmasters/v3/sites/{id}/sitemaps/{id}" \
  -H "Authorization: Bearer $TOKEN"

Scopes

Your service token must be configured with at least the required scope level.

read

GET POST

/webmasters/v3/sites /webmasters/v3/sites/* /webmasters/v3/sites/*/sitemaps /webmasters/v3/sites/*/sitemaps/* /v1/urlInspection/index:inspect /v1/searchanalytics/query

write

GET POST PUT

/webmasters/v3/sites /webmasters/v3/sites/* /webmasters/v3/sites/*/sitemaps /webmasters/v3/sites/*/sitemaps/* /v1/urlInspection/index:inspect /v1/searchanalytics/query

update

GET POST PUT

/webmasters/v3/sites /webmasters/v3/sites/* /webmasters/v3/sites/*/sitemaps /webmasters/v3/sites/*/sitemaps/* /v1/urlInspection/index:inspect /v1/searchanalytics/query

delete

GET POST PUT DELETE

/webmasters/v3/sites /webmasters/v3/sites/* /webmasters/v3/sites/*/sitemaps /webmasters/v3/sites/*/sitemaps/*

all

GET POST PUT DELETE

/**