# Google Redirect (Goto) Link Resolver

> Source: https://scrape.do/documentation/google-scraper-api/goto/

Resolve one Google redirect link to its destination URL

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](/documentation/google-scraper-api/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
```

> [!NOTE]
> **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

```bash
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

```json
{
  "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](/documentation/google-scraper-api/search/search#result-links) for automatic redirect resolution in search responses.