# Instagram Tagged API (https://www.socialcrawl.dev/platforms/instagram/tagged)

> Returns a paginated list of the posts that tag an Instagram user. Each post includes shortcode, URL, caption, media URLs, engagement counts, and the author. Pass either `handle` or `user_id`, and page through with `cursor`.

TL;DR: `GET /v1/instagram/tagged` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | no | Instagram username without the @ symbol. |
| `user_id` | no | Instagram numeric user ID. Use this for faster responses. |
| `cursor` | no | Pagination cursor. Use the `next_cursor` from the previous response to fetch the next page. |
| `safe_url` | no | When true, returns URL-safe media links suitable for embedding. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/instagram/tagged" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get posts that tag an Instagram user via API?

Send a GET request to /v1/instagram/tagged with a handle or user_id. SocialCrawl returns a paginated JSON array of posts that tag that account, each with shortcode, url, caption, media URLs, engagement counts, and author.

### Can I query tagged posts by user ID?

Yes. Pass user_id instead of handle. Using user_id is faster because SocialCrawl skips resolving the username to an ID before fetching tagged posts.

### How do I paginate tagged posts, and what is safe_url?

Send the returned cursor back as the cursor parameter for the next page. Pass optional safe_url to receive proxied, CDN-safe media URLs that are stable to embed.

### How much does the tagged posts API cost?

Each request costs 5 credits on the advanced tier for one page of tagged posts. New accounts get 100 free credits with no credit card required to start.

### What is tagged post data useful for?

Tagged posts track brand mentions and UGC: monitor who tags your brand, measure influencer campaign deliverables, or surface user-generated content for reuse.

See the full Instagram API: https://www.socialcrawl.dev/platforms/instagram

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to find Instagram posts that tag a specific user with an API
- API to monitor brand mentions and tagged posts on Instagram