# SocialCrawl API — instagram endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/instagram

## GET /v1/instagram/profile
Get Instagram user profile
Credit cost: 1 (standard)
Parameters:
- handle (required) — Instagram username without the @ symbol
- trim (optional, boolean) — Set to true to get a trimmed response
curl "https://www.socialcrawl.dev/v1/instagram/profile?handle=instagram" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/profile/posts
List Instagram user posts
Credit cost: 1 (standard)
Parameters:
- handle (required) — Instagram username without the @ symbol
- next_max_id (optional, string) — Cursor to get next page of results.
- trim (optional, boolean) — Set to true to get a trimmed response
curl "https://www.socialcrawl.dev/v1/instagram/profile/posts?handle=instagram" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/post
Get Instagram post details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Instagram post
- region (optional, string) — 2 letter country code to set the proxy in
- trim (optional, boolean) — Set to true to get a trimmed response
- download_media (optional, boolean) — Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise.
curl "https://www.socialcrawl.dev/v1/instagram/post?url=https://www.instagram.com/p/CwA1234abcd/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/post/comments
List Instagram post comments
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Instagram post to fetch comments for
- cursor (optional, string) — The cursor to get more comments. Get 'cursor' from previous response.
curl "https://www.socialcrawl.dev/v1/instagram/post/comments?url=https://www.instagram.com/p/CwA1234abcd/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/basic-profile
Get Instagram basic profile
Credit cost: 1 (standard)
Parameters:
- userId (optional, string) — Instagram numeric user ID
curl "https://www.socialcrawl.dev/v1/instagram/basic-profile" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/profile/reels
List Instagram user reels
Credit cost: 1 (standard)
Parameters:
- user_id (optional, string) — Instagram user id. Use this for faster response times.
- handle (optional, string) — Instagram username without the @ symbol
- max_id (optional, string) — Max id to get more reels. Get 'max_id' from previous response.
- trim (optional, boolean) — Set to true for a trimmed down version of the response
- Constraint: one of user_id, handle (at least one required)
curl "https://www.socialcrawl.dev/v1/instagram/profile/reels" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/highlights
List Instagram story highlights
Credit cost: 1 (standard)
Parameters:
- user_id (optional, string) — Instagram user id. Use for faster response times.
- handle (optional, string) — Instagram username without the @ symbol
- Constraint: one of user_id, handle (at least one required)
curl "https://www.socialcrawl.dev/v1/instagram/highlights" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/highlight/detail
Get Instagram highlight detail
Credit cost: 1 (standard)
Parameters:
- id (optional, string) — Instagram highlight ID
curl "https://www.socialcrawl.dev/v1/instagram/highlight/detail" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/search/reels
Search Instagram reels
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword or phrase to find Instagram reels
- date_posted (optional, enum: last-hour | last-day | last-week | last-month | last-year) — Date posted
- page (optional, integer) — The page number to return.
curl "https://www.socialcrawl.dev/v1/instagram/search/reels?query=workout routine" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/media/transcript
Get Instagram media transcript
Credit cost: 10 (premium)
Parameters:
- url (required) — Full URL of the Instagram video or reel
curl "https://www.socialcrawl.dev/v1/instagram/media/transcript?url=https://www.instagram.com/reel/CwA1234abcd/" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/user/embed
Get Instagram user embed HTML
Credit cost: 1 (standard)
Parameters:
- handle (required) — Instagram username without the @ symbol
curl "https://www.socialcrawl.dev/v1/instagram/user/embed?handle=instagram" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/instagram/song/reels
List Instagram reels using a song
Credit cost: 1 (standard)
Parameters:
- audio_id (required) — Instagram audio/song ID
- max_id (optional, string) — How you paginate the results. Pass the max_id from the previous response to get the next set of reels.
curl "https://www.socialcrawl.dev/v1/instagram/song/reels?audio_id=243313786724210" \
  -H "x-api-key: sc_your_api_key_here"