> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram posts

> Recent posts from one Instagram profile with captions, engagement counts, media URLs, and timestamps.

Recent posts from one Instagram profile with captions, engagement counts, media URLs, and timestamps.

<Note>Use when you need a creator's or brand's recent Instagram content, to measure engagement over time, or to pull captions and hashtags for analysis.</Note>

## Price

**\$0.0045 per post.** That is the rate you pay for each post the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer posts costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field                | Type                        | Required | Notes                                                                                                                                                                         |
| -------------------- | --------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `username`           | `array`                     | yes      | Instagram username, profile URL, or post URL. One target per call: resultsLimit applies per target, so batching several here would bill past the hold sized for this request. |
| `resultsLimit`       | `integer`                   |          | Maximum posts per profile Defaults to `20`.                                                                                                                                   |
| `dataDetailLevel`    | `basicData`, `detailedData` |          | detailedData is billed extra at \$0.0008 per post Defaults to `"basicData"`.                                                                                                  |
| `skipPinnedPosts`    | `boolean`                   |          | Defaults to `false`.                                                                                                                                                          |
| `onlyPostsNewerThan` | `string`                    |          | YYYY-MM-DD, ISO datetime, or relative like "3 months"                                                                                                                         |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"instagram.posts","input":{"username":["example"],"resultsLimit":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "id": "3401234567890123456",
  "url": "https://instagram.com/example-account/DLNsnpUTdVS/",
  "type": "Image",
  "likes": 184203,
  "caption": "Photograph by @thomaspeschak",
  "comments": 1204,
  "shortcode": "DLNsnpUTdVS",
  "timestamp": "2026-07-01T12:00:00.000Z",
  "display_url": "https://example.com/media/sample.jpg",
  "owner_username": "natgeo"
}
```