Instagram API Server

Instagram OAuth Login

Direct Instagram OAuth authentication for accessing your Instagram account.

Requirements: Instagram Business or Creator account

GET /images/{userId or username}

Get user's Instagram media (cached for 1 hour)

You can use either the user ID or Instagram username (with or without @).

Parameters:

• limit (optional) - Number of media items to return (default: 25)
• after (optional) - Pagination cursor
• bust (optional) - Set to "true" to bypass cache

Caching: Responses are cached for 1 hour. Check the X-Cache header (HIT/MISS).

GET /images/123456789?limit=10&after=cursor_value  # By user ID
GET /images/johndoe?limit=10  # By username
GET /images/@johndoe  # With @ symbol
GET /images/123456789?bust=true  # Force fresh data

GET /image/{userId or username}/{mediaId}

Get specific media item details

You can use either the user ID or Instagram username.

GET /image/123456789/media_id_here  # By user ID
GET /image/johndoe/media_id_here  # By username

POST /cache/bust/{userId}

Clear cached media for a user

Call this endpoint when new media is posted to Instagram to refresh the cache.

POST /cache/bust/123456789

GET/POST /webhook

Instagram webhook endpoint (automatic cache busting)

GET: Webhook verification endpoint

POST: Receives webhook events from Instagram

Configure this in your Instagram app settings to automatically bust cache when new media is posted.

Verify Token: instagram_webhook_verify_2025

GET /health

Health check endpoint

GET /health