URLs · Indexação · Referência da API | Desenvolvedores do MB Suite

GET/v1/seo/indexation/urls/inspect

Inspect how Google indexes a URL

seo_indexation.urls.inspect

LeituraIdempotenteDesde 2026-11-01

Inspects one page of a Search Console property connected to the organization with Google's URL Inspection API, live: verdict (PASS, PARTIAL, NEUTRAL, FAIL), coverage_state (e.g. 'Submitted and indexed', 'Crawled - currently not indexed'), robots_txt_state, indexing_state, page_fetch_state, last_crawl_time, google_canonical vs user_canonical, crawled_as, referring_urls, and the mobile and rich results verdicts when Google returns them. Nothing is stored. inspection_url must belong to site_url (same protocol and host, under its path; a domain property covers any protocol and subdomain). Google allows 600 inspections per minute and 2,000 per day per property: inspect a few key URLs, not a whole site. Errors: 404 external_account_not_linked and 400 url_not_in_property (Google is not called), 409 external_rejected, 409 integration_not_connected, 409 integration_reconnect_required, 429 external_rate_limited, 503 external_unavailable. Requires view access to Indexation.

Escopo: seo_indexation:read
Permissão: Ver o módulo
Tool do MCP: seo_indexation_urls_inspectNa superfície completa; na compacta, mb_execute_operation com id: "seo_indexation.urls.inspect".

Custo declarado: até 2 leituras e 0 escritas por chamada (contam na cota diária). Usa uma plataforma externa (google): conta na cota de operações externas.

Parâmetros

site_urlstringqueryobrigatório

The Search Console property, as seo_indexation.properties.list returns it: a URL-prefix property (https://www.example.com/) or a domain property (sc-domain:example.com). It must be connected to the organization in Data Sources; a trailing slash or the host's letter case may differ.

inspection_urlstringqueryobrigatório

The page URL to inspect. It must belong to the property: same protocol and host and under its path for a URL-prefix property; any protocol and subdomain for a domain property.

Resposta

urlstring

inspected_atnumber

verdictstring

PASS, PARTIAL, NEUTRAL, FAIL or VERDICT_UNSPECIFIED.

coverage_statestring

Google's coverage state, e.g. 'Submitted and indexed', 'Crawled - currently not indexed'.

robots_txt_statestring

indexing_statestring

page_fetch_statestring

crawled_asstring

last_crawl_timestring

google_canonicalstring

user_canonicalstring

referring_urlsarray<string>

mobile_verdictstring

mobile_issuesarray<string>

rich_results_verdictstring

rich_results_itemsarray<object>

Erros

integration_not_connected integration_reconnect_required external_rejected external_unavailable external_rate_limited external_outcome_unknown external_global_limit sandbox_external_unavailable invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Exemplo

curl "https://api.mb-suite.com/v1/seo/indexation/urls/inspect?site_url=SITE_URL&inspection_url=INSPECTION_URL" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar. Na prática esta operação não é simulada (usa outra plataforma): responde 409 sandbox_external_unavailable.