# Instagram — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Discover trending Instagram Reels and explore detailed information about specific reels and public creator profiles in real-time. Build applications that showcase viral content, analyze reel performance, and access creator insights without needing authentication.

**Category:** Social Media | **Website:** [www.instagram.com/](https://www.instagram.com/) | **Docs:** [parse.bot/marketplace/18cae41e-bd58-4adb-9e85-553a0c333a65/instagram-com-api](https://parse.bot/marketplace/18cae41e-bd58-4adb-9e85-553a0c333a65/instagram-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-instagram-com-api-18cae41e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_full_user_profile

Get comprehensive public profile data for an Instagram user including metadata, recent posts, and recent reels. Returns full profile information (bio, follower/following counts, verification status, business info), up to 12 recent timeline posts, and up to 12 recent reels — all from a single upstream call. Total post and reel counts are included for reference but pagination beyond the initial batch is not available without authentication. Works only for public profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Instagram username without the @ prefix (e.g. 'instagram', 'natgeo'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-instagram-com-api-18cae41e/get_full_user_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_post_details

Get detailed information about a specific Instagram post by its shortcode. Returns engagement metrics (like_count, comment_count), media details (display_url, video_url if applicable, dimensions, is_video), caption, taken_at timestamp, user info (username, full_name, is_verified), location if available, product_type, and carousel_media for multi-slide posts. Works for photo posts, carousels, and video posts. The shortcode is the alphanumeric identifier from a post URL (e.g. 'C0xFHGOrBN7' from instagram.com/p/C0xFHGOrBN7/).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shortcode` | string | Yes | The post's shortcode identifier, found in the post URL path segment (e.g. 'C0xFHGOrBN7' from https://www.instagram.com/p/C0xFHGOrBN7/). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-instagram-com-api-18cae41e/get_post_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shortcode":"<string>"}'
```

### get_reel_details

Get detailed information about a specific Instagram Reel by its shortcode. Returns engagement metrics, video version URLs, user info, caption, audio details, and location if available. The shortcode is the alphanumeric identifier visible in reel URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shortcode` | string | Yes | The reel's shortcode identifier, found in the reel URL path segment (e.g. 'DZPkGpgoceS' from https://www.instagram.com/reel/DZPkGpgoceS/). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-instagram-com-api-18cae41e/get_reel_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shortcode":"<string>"}'
```

### get_trending_reels

Get currently trending/viral reels from Instagram's Reels tab. Returns a short list of popular reels with engagement metrics, user info, captions, and audio details. No parameters required — returns whatever Instagram is currently featuring. The set rotates frequently; expect 5–10 reels per call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-instagram-com-api-18cae41e/get_trending_reels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_user_profile

Get public profile information for an Instagram user. Returns biography, follower/following counts, media count, profile picture URL, verification status, and bio links. Works only for public profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Instagram username without the @ prefix (e.g. 'instagram', 'natgeo'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-instagram-com-api-18cae41e/get_user_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### search_content

Search for public Instagram content by keyword. Returns up to 12 popular/trending media items matching the query, sourced from Instagram's popular search page. Results are predominantly reels (video content) with engagement metrics, user info, and thumbnail URLs. Fields like like_count, comment_count, view_count, and taken_at may be null in search results since Instagram's search surface provides limited metadata per item compared to individual detail endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase (e.g. 'travel', 'fitness motivation', 'cooking recipes'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-instagram-com-api-18cae41e/search_content \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```