> ## 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 URL

> Scrape any public Instagram URL: a profile, post, or reel. Returns posts, comments, reels, or profile details depending on what you ask for.

Scrape any public Instagram URL: a profile, post, or reel. Returns posts, comments, reels, or profile details depending on what you ask for.

<Note>Use when you already have an Instagram URL and want its contents, especially post comments, which the other Instagram tools do not return.</Note>

## Price

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

Billing follows actual usage, so a call that returns fewer results 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                                                                                                                                      |
| -------------------- | -------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `search`             | `string`                                                       |          | Search Instagram instead of using directUrls. Billed at $0.005 per result rather than $0.002.                                              |
| `directUrls`         | `array`                                                        |          | Instagram profile, post, or reel URL. One per call: resultsLimit applies per URL, so batching several would bill past this request's hold. |
| `searchType`         | `user`, `hashtag`, `place`                                     |          | Defaults to `"hashtag"`.                                                                                                                   |
| `resultsType`        | `posts`, `comments`, `details`, `mentions`, `reels`, `stories` |          | Comments only work on post URLs Defaults to `"posts"`.                                                                                     |
| `searchLimit`        | `integer`                                                      |          | Defaults to `1`.                                                                                                                           |
| `resultsLimit`       | `integer`                                                      |          | Defaults to `20`.                                                                                                                          |
| `addParentData`      | `boolean`                                                      |          | Defaults to `false`.                                                                                                                       |
| `onlyPostsNewerThan` | `string`                                                       |          |                                                                                                                                            |

<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.url","input":{"resultsLimit":3}}'
```

## Response

One row of the response. Values are illustrative.

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