# Instagram User Tagged Posts

Retrieve the public Instagram posts a user is tagged in, with pagination support. Accepts either the username (resolved to the numeric user id internally) or the numeric user id directly. Returns post details including media URLs, captions, and engagement metrics. Note: Instagram returns only the post author's numeric id on this endpoint — resolve author details with the /user/basic endpoint. A completed lookup costs one credit, including a definitive not-found result, because every lookup uses costly dedicated Instagram proxies.

- **Documentation:** [https://staging.scrappa.co/docs/instagram-api/instagram_user_tagged_posts](https://staging.scrappa.co/docs/instagram-api/instagram_user_tagged_posts)
- **API group:** Instagram API
- **Endpoint:** `GET https://scrappa.co/api/instagram/user/tagged-posts`

## 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 |
| --- | --- | --- | --- |
| `username` | string | No | Instagram username (without @). Required when user_id is not provided. |
| `user_id` | string | No | Numeric Instagram user ID. Required when username is not provided. |
| `max_id` | string | No | Pagination cursor from previous response (next_max_id) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/instagram/user/tagged-posts?username=natgeo"
```

## Example response

```json
{
    "success": true,
    "found": true,
    "user_id": "787132",
    "username": "natgeo",
    "posts": [
        {
            "id": "1929261108986102451",
            "shortcode": "BrGHMHIF8Kz",
            "media_type": "image",
            "caption": "Vardzia is a cave monastery site located in southern Georgia...",
            "hashtags": [
                "georgia",
                "exploregeorgia"
            ],
            "taken_at": null,
            "like_count": 14030,
            "comment_count": 581,
            "play_count": null,
            "media": [
                {
                    "type": "image",
                    "thumbnail_url": "https://..."
                }
            ],
            "location": null,
            "author": {
                "id": "429173",
                "username": null
            },
            "permalink": "https://www.instagram.com/p/BrGHMHIF8Kz/"
        }
    ],
    "posts_count": 12,
    "more_available": true,
    "next_max_id": "1928051354388873282"
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 403 | Login Required | Instagram explicitly requires login. Scrappa does not retry the login-gated resource. Profile lookups may recover from public profile data; unresolved login requirements are nonbillable and not retryable. |
| 422 | Validation Error | Neither username nor user_id was provided, or a value has an invalid format. |
| 503 | Instagram Upstream Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

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