# Instagram Profile Posts API (https://www.socialcrawl.dev/platforms/instagram/profile-posts)

> Returns a list of recent posts from an Instagram user's profile. Each post includes like count, comment count, caption, media URL, media type, and timestamp. Note: engagement.shares is null on this endpoint (the upstream carries no per-post share count); to additionally merge in per-post share counts where a second source exposes them (coverage varies by account), use /v1/instagram/profile/posts/full.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | Instagram username without the @ symbol |
| `next_max_id` | no | Cursor to get next page of results. |
| `trim` | no | Set to true to get a trimmed response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/instagram/profile/posts?handle=instagram" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list a user's Instagram posts with an API?

Send a GET request to /v2/instagram/user/posts with the handle parameter. SocialCrawl returns a JSON array of the user's most recent posts, each with caption, like count, comment count, media URL, media type, and timestamp.

### How do I paginate through Instagram posts?

The response includes a next_max_id cursor. Pass that value back as the next_max_id query parameter on your next request to fetch the next page. Keep paginating until the cursor is empty.

### Does the Instagram Posts API return photos and videos?

Yes. Each post entry includes a media_type field (image, video, or carousel) and a media URL. Carousel posts include an array of child media URLs so you can iterate over every slide in a single post.

### How much does the Instagram Posts API cost per request?

Each call costs 1 credit on the standard tier and returns one page of posts. New accounts get 100 free credits with no credit card, so you can fetch roughly 100 pages of posts before paying.

### How recent are the posts returned?

Posts are returned in reverse-chronological order starting with the most recent. The first page gives you the newest posts; pagination lets you walk back through the user's full public post history as far as Instagram exposes it.

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 paginate Instagram user posts with an API
- Best API to pull a user's full Instagram post history