# Instagram API

Public Instagram profiles, posts, reels, and engagement data.

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
HTML: https://trysocify.com/docs/api/instagram  
Platform file: https://trysocify.com/llms-instagram.txt  
OpenAPI: https://trysocify.com/openapi.json

## Endpoints (15)

- [Profile](#profile) — `GET /api/v1/instagram/profile` (1 credit per request)
- [Posts](#posts) — `GET /api/v1/instagram/posts` (1 credit per request)
- [Comments](#comments) — `GET /api/v1/instagram/comments` (1 credit per request)
- [Reels](#reels) — `GET /api/v1/instagram/reels` (1 credit per request)
- [Hashtag](#hashtag) — `GET /api/v1/instagram/hashtag` (1 credit per request)
- [Hashtag Posts](#hashtag-posts) — `GET /api/v1/instagram/hashtag-posts` (1 credit per request)
- [Followers](#followers) — `GET /api/v1/instagram/followers` (1 credit per request)
- [Following](#following) — `GET /api/v1/instagram/following` (1 credit per request)
- [Post](#post) — `GET /api/v1/instagram/post` (1 credit per request)
- [Stories](#stories) — `GET /api/v1/instagram/stories` (1 credit per request)
- [Highlights](#highlights) — `GET /api/v1/instagram/highlights` (1 credit per request)
- [Tagged](#tagged) — `GET /api/v1/instagram/tagged` (1 credit per request)
- [Search](#search) — `GET /api/v1/instagram/search` (1 credit per request)
- [Likers](#likers) — `GET /api/v1/instagram/likers` (1 credit per request)
- [Related](#related) — `GET /api/v1/instagram/related` (1 credit per request)

### Profile

`GET /api/v1/instagram/profile`

Fetch a public Instagram profile by username.

Credits: 1 credit per request

**Parameters**

- `username` (required) — Instagram username without @. Example: `natgeo`.

**Docs:** [https://trysocify.com/docs/api/instagram/profile.md](https://trysocify.com/docs/api/instagram/profile.md) · HTML: https://trysocify.com/docs/api/instagram/profile

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/profile?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Posts

`GET /api/v1/instagram/posts`

Fetch recent public posts for a profile.

Credits: 1 credit per request

**Parameters**

- `username` (optional) — Exactly one of username or user_id. Prefer username. Example: `natgeo`.
- `user_id` (optional) — Numeric user id (alternative to username). Example: `787132`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/posts.md](https://trysocify.com/docs/api/instagram/posts.md) · HTML: https://trysocify.com/docs/api/instagram/posts

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/posts?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Comments

`GET /api/v1/instagram/comments`

Fetch public comments for a post.

Credits: 1 credit per request

**Parameters**

- `code` (optional) — Exactly one of code, id, or url. Prefer shortcode. Example: `C-6WRvdS75Q`.
- `id` (optional) — Numeric media id (alternative to code/url). Example: `3439159241662512720`.
- `url` (optional) — Full Instagram post URL (alternative to code/id). Example: `https://www.instagram.com/p/C-6WRvdS75Q/`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/comments.md](https://trysocify.com/docs/api/instagram/comments.md) · HTML: https://trysocify.com/docs/api/instagram/comments

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/comments?code=C-6WRvdS75Q' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Reels

`GET /api/v1/instagram/reels`

Fetch recent reels for a profile.

Credits: 1 credit per request

**Parameters**

- `username` (optional) — Exactly one of username or user_id. Prefer username. Example: `natgeo`.
- `user_id` (optional) — Numeric user id (alternative to username). Example: `787132`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/reels.md](https://trysocify.com/docs/api/instagram/reels.md) · HTML: https://trysocify.com/docs/api/instagram/reels

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/reels?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Hashtag

`GET /api/v1/instagram/hashtag`

Fetch public metadata for an Instagram hashtag.

Credits: 1 credit per request

**Parameters**

- `name` (required) — Hashtag name without #. Example: `nature`.

**Docs:** [https://trysocify.com/docs/api/instagram/hashtag.md](https://trysocify.com/docs/api/instagram/hashtag.md) · HTML: https://trysocify.com/docs/api/instagram/hashtag

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/hashtag?name=nature' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Hashtag Posts

`GET /api/v1/instagram/hashtag-posts`

Fetch top public posts for a hashtag.

Credits: 1 credit per request

**Parameters**

- `name` (required) — Hashtag name without #. Example: `nature`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/hashtag-posts.md](https://trysocify.com/docs/api/instagram/hashtag-posts.md) · HTML: https://trysocify.com/docs/api/instagram/hashtag-posts

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/hashtag-posts?name=nature' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Followers

`GET /api/v1/instagram/followers`

Fetch a page of followers for a profile.

Credits: 1 credit per request

**Parameters**

- `username` (optional) — Exactly one of username or user_id. Prefer username. Example: `natgeo`.
- `user_id` (optional) — Numeric user id (alternative to username). Example: `787132`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/followers.md](https://trysocify.com/docs/api/instagram/followers.md) · HTML: https://trysocify.com/docs/api/instagram/followers

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/followers?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Following

`GET /api/v1/instagram/following`

Fetch a page of accounts a profile follows.

Credits: 1 credit per request

**Parameters**

- `username` (optional) — Exactly one of username or user_id. Prefer username. Example: `natgeo`.
- `user_id` (optional) — Numeric user id (alternative to username). Example: `787132`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/following.md](https://trysocify.com/docs/api/instagram/following.md) · HTML: https://trysocify.com/docs/api/instagram/following

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/following?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Post

`GET /api/v1/instagram/post`

Fetch public details for a single post.

Credits: 1 credit per request

**Parameters**

- `code` (optional) — Exactly one of code or url. Prefer shortcode. Example: `C-6WRvdS75Q`.
- `url` (optional) — Full Instagram post URL (alternative to code). Example: `https://www.instagram.com/p/C-6WRvdS75Q/`.

**Docs:** [https://trysocify.com/docs/api/instagram/post.md](https://trysocify.com/docs/api/instagram/post.md) · HTML: https://trysocify.com/docs/api/instagram/post

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/post?code=C-6WRvdS75Q' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Stories

`GET /api/v1/instagram/stories`

Fetch current public stories for a profile.

Credits: 1 credit per request

**Parameters**

- `username` (required) — Instagram username without @. Example: `natgeo`.

**Docs:** [https://trysocify.com/docs/api/instagram/stories.md](https://trysocify.com/docs/api/instagram/stories.md) · HTML: https://trysocify.com/docs/api/instagram/stories

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/stories?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Highlights

`GET /api/v1/instagram/highlights`

Fetch story highlights for a profile.

Credits: 1 credit per request

**Parameters**

- `username` (required) — Instagram username without @. Example: `natgeo`.

**Docs:** [https://trysocify.com/docs/api/instagram/highlights.md](https://trysocify.com/docs/api/instagram/highlights.md) · HTML: https://trysocify.com/docs/api/instagram/highlights

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/highlights?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Tagged

`GET /api/v1/instagram/tagged`

Fetch public posts where a profile was tagged.

Credits: 1 credit per request

**Parameters**

- `username` (optional) — Exactly one of username or user_id. Prefer username. Example: `natgeo`.
- `user_id` (optional) — Numeric user id (alternative to username). Example: `787132`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/tagged.md](https://trysocify.com/docs/api/instagram/tagged.md) · HTML: https://trysocify.com/docs/api/instagram/tagged

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/tagged?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Search

`GET /api/v1/instagram/search`

Search public Instagram profiles by query. Returns a single page (not cursor-paginated).

Credits: 1 credit per request

**Parameters**

- `query` (required) — Search text. Example: `natgeo`.

**Docs:** [https://trysocify.com/docs/api/instagram/search.md](https://trysocify.com/docs/api/instagram/search.md) · HTML: https://trysocify.com/docs/api/instagram/search

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/search?query=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Likers

`GET /api/v1/instagram/likers`

Fetch users who liked a post.

Credits: 1 credit per request

**Parameters**

- `code` (optional) — Exactly one of code, id, or url. Prefer shortcode. Example: `C-6WRvdS75Q`.
- `id` (optional) — Numeric media id (alternative to code/url). Example: `3439159241662512720`.
- `url` (optional) — Full Instagram post URL (alternative to code/id). Example: `https://www.instagram.com/p/C-6WRvdS75Q/`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/instagram/likers.md](https://trysocify.com/docs/api/instagram/likers.md) · HTML: https://trysocify.com/docs/api/instagram/likers

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/likers?code=C-6WRvdS75Q' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Related

`GET /api/v1/instagram/related`

Fetch suggested/related profiles for a profile. Returns a single page (not cursor-paginated).

Credits: 1 credit per request

**Parameters**

- `username` (optional) — Exactly one of username or user_id. Prefer username. Example: `natgeo`.
- `user_id` (optional) — Numeric user id (alternative to username). Example: `787132`.

**Docs:** [https://trysocify.com/docs/api/instagram/related.md](https://trysocify.com/docs/api/instagram/related.md) · HTML: https://trysocify.com/docs/api/instagram/related

```bash
curl -sS 'https://trysocify.com/api/v1/instagram/related?username=natgeo' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```