Google Redirect (Goto) Link Resolver

The Google Redirect (Goto) Link Resolver returns the destination URL for one Google /goto or /url redirect link. Use it for a link kept from a Search API response with resolveGoto=false, for Google Lens exact matches returned after the first 50, or for a redirect that the search request could not resolve in time.

Endpoint

GET https://api.scrape.do/plugin/google/goto

Credit cost: 1 credit per resolved link. Failed requests that return 502 are not charged.

Request Parameters

Required

Parameter	Type	Description
`token`	string	Your Scrape.do API authentication token
`url`	string	One URL-encoded Google redirect link. Accepted forms are `https://www.google.<tld>/goto?url=<code>` and `https://www.google.<tld>/url?...&url=<code>&...`. Send the code exactly as Google returned it; changing one character can make the link unresolvable

Google ad links such as https://www.google.com/aclk?... are not supported. Relative links such as /goto?url=<code> are rejected, so prefix them with https://www.google.com first (for example, the original_href values in a search response's goto_links). Parameter names are lowercase: URL or TOKEN is treated as a missing parameter.

Example Request

curl -G "https://api.scrape.do/plugin/google/goto" \
  --data-urlencode "token=YOUR_TOKEN" \
  --data-urlencode "url=https://www.google.com/goto?url=CAESYgHrOzAVyuo5c-Uj..."

Response

{
  "url": "https://www.google.com/goto?url=CAESYgHrOzAVyuo5c-Uj...",
  "destination": "https://www.example.com/article",
  "credits_used": 1
}

Field	Type	Description
`url`	string	The Google redirect link sent in the request
`destination`	string	The destination URL the link points to
`credits_used`	integer	Credits charged for this request. This matches the `Scrape.do-Request-Cost` response header

Error Responses

Status	Body	Cause
`400`	`{ "error": "token is required" }`	The `token` parameter is missing
`400`	`{ "error": "url is required" }`	The `url` parameter is missing or empty
`400`	`{ "error": "url must be a Google redirect link (https://www.google.com/goto?url=...)" }`	The value is not a valid URL, is not a supported Google `/goto` or `/url` redirect, is an ad link, already includes its destination, or has an invalid code
`401` / `402`	Standard API error	The token is invalid or the account does not have enough credits
`502`	`{ "error": "resolve failed", "message": "Please try again, and if the issue continues, contact support." }`	Google did not return a destination, or the link code is no longer accepted

Usage Notes

The endpoint accepts one link per request. To resolve many links, send requests in parallel within your plan's concurrency limit. It is not available as an Async API plugin.
Resolve links soon after the search that returned them because they may stop working over time.
A failed lookup returns 502 within about 20 seconds and is not charged.

See SERP API redirect links for automatic redirect resolution in search responses.