Inspect a URL
Get Google's live index status for one URL through the Search Console URL Inspection API.
https://api.rankparse.com/v1/gsc/url-inspectionFreeAPI key + connected Google accountAsks Google, live, whether one URL is indexed and why: coverage state, robots.txt state, last crawl, the canonical Google chose, and mobile usability and rich result verdicts when Google evaluates them. For the stored inspection results of every tracked page of a website at once, see Indexing.
Query parameters
sitestringrequiredThe property exactly as returned by List properties. The inspected URL must belong to it. Missing returns 400 missing_params.
urlstringrequiredThe full URL to inspect, for example https://example.com/blog/post. Missing returns 400 missing_params.
Response
sitestringThe property you used.
urlstringThe URL you inspected.
inspectionResultobjectGoogle's inspection result, passed through as Google returns it.
Show propertiesHide properties
inspectionResultLinkstringLink to the same inspection in Search Console.
indexStatusResultobjectverdict (PASS, PARTIAL, FAIL or NEUTRAL), coverageState, robotsTxtState, indexingState, pageFetchState and, when known, lastCrawlTime, googleCanonical, userCanonical, sitemap, referringUrls and crawledAs.
ampResultobjectverdict and ampUrl, when Google evaluates AMP for the page.
mobileUsabilityResultobjectverdict and any issues, when present.
richResultsResultobjectverdict and detectedItems with their issues, when present.
Behavior and limits
- Credits: 0.
- Google's quota: Google applies its own URL Inspection quota per property. Exceeding it returns
429 gsc_quota_exceeded.
Errors
Plus the shared Search Console errors (see the overview).
| HTTP | Code | When |
|---|---|---|
| 400 | missing_params | site or url is missing. |
| 400 | gsc_not_connected | No Google Search Console account is connected. |
| 403 | gsc_access_denied | Google denied access to this property. |
| 404 | gsc_property_not_found | No connected Google account can see site. |
| 429 | gsc_quota_exceeded | Google's URL Inspection quota was exceeded. |
| 502 | gsc_api_error | Google rejected the request (for example a URL outside the property) or failed. |
Related
MCP tool: get_gsc_url_inspection (accepts site, url).