# Linkme Social Grid Item Link API Documentation

Scrappa's `GET /api/link-in-bio/linkme/social-grid/go` endpoint resolves the outbound destination of a single Linkme social-grid item from its numeric `item_id`.

This endpoint is **opt-in and off by default**: resolving a profile's destinations costs one additional upstream call per item, so each destination is a separate, separately accounted request rather than something bundled into the profile lookup.

There are two ways it can answer without a destination, and both are non-billable. An item that has been removed returns a not-found result. An item whose upstream answer carries no redirect returns a successful but empty result with **no `url` key at all**, so treat a missing `url` as "no destination" rather than assuming the key is always present.

An existing profile with nothing configured answers with HTTP 200 and an empty result. That response is not billable, and its `meta.reason` explains which case applied.

- **Documentation:** [https://scrappa.co/docs/link-in-bio-api/link_in_bio_linkme_social_grid_go](https://scrappa.co/docs/link-in-bio-api/link_in_bio_linkme_social_grid_go)
- **API group:** Link-in-Bio API
- **Endpoint:** `GET https://scrappa.co/api/link-in-bio/linkme/social-grid/go`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `item_id` | integer | Yes | Numeric id of the grid item, from a social-grid response. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/link-in-bio/linkme/social-grid/go?item_id=24"
```

## Example response

```json
{
    "provider": "linkme",
    "surface": "social-grid-go",
    "item_id": 24,
    "url": "https://www.tiktok.com/@linkme/video/1234",
    "meta": {
        "duration_ms": 380,
        "attempts": 1,
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Profile Not Found | No public profile exists for this handle. |
| 503 | Upstream Unavailable | The profile could not be read from its source right now. Please retry. |
| 422 | Request Rejected Upstream | The source rejected this request, for example because the handle was not acceptable to it. |
| 503 | Profile Host Blocked the Request | The provider's bot protection refused this request after every available exit was tried. This is not a billing event; retry later. |
| 422 | Invalid Handle or URL | The handle was not in a supported format, or the URL did not belong to this endpoint's provider. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)