Get Live Instagram Posts

Fetch fresh Instagram post-page data for a bounded list of shortcodes. This returns one item per requested shortcode with per-item success or error details. Transient upstream recovery is handled automatically within the request deadline.

Note: Batch post lookup is capped at 20 shortcodes per request. API-key and OAuth calls are charged only for successful items; x402 and MPP use the advertised request price.

Returns fresh video_url and video_versions[] per post (signed IG CDN URLs, ~24h validity). Batch up to 20 posts at 1 credit ($0.01) each.

Pricing: 1 credit per post scraped ($0.01)

POST /v1/raw/instagram/posts

cURL

cURL

curl --request POST \
  --url https://api.influship.com/v1/raw/instagram/posts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "shortcodes": [
    "C0ABC123xyz",
    "D1DEF456uvw"
  ]
}
'

import Influship from 'influship';

const client = new Influship({
  apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

const response = await client.raw.instagram.getPosts({
  shortcodes: ['C0ABC123xyz', 'D1DEF456uvw'],
});

console.log(response.data);

import os
from influship import Influship

client = Influship(
    api_key=os.environ.get("INFLUSHIP_API_KEY"),  # This is the default and can be omitted
)
response = client.raw.instagram.get_posts(
    shortcodes=["C0ABC123xyz", "D1DEF456uvw"],
)
print(response.data)

200

{
  "data": {
    "requested": 123,
    "succeeded": 123,
    "failed": 123,
    "items": [
      {
        "success": true,
        "shortcode": "<string>",
        "data": {
          "post": {
            "id": "<string>",
            "shortcode": "<string>",
            "display_url": "<string>",
            "is_video": true,
            "like_count": 123,
            "comment_count": 123,
            "caption": "<string>",
            "taken_at": 123,
            "owner_username": "<string>",
            "accessibility_caption": "<string>",
            "video_url": "<string>",
            "thumbnail_url": "<string>",
            "view_count": 123,
            "carousel_items": [
              {
                "index": 123,
                "display_url": "<string>",
                "is_video": true,
                "video_url": "<string>",
                "thumbnail_url": "<string>"
              }
            ],
            "coauthor_usernames": [
              "<string>"
            ],
            "is_paid_partnership": true,
            "sponsor_usernames": [
              "<string>"
            ],
            "tagged_usernames": [
              "<string>"
            ],
            "product_mentions": [
              {
                "product_id": "<string>",
                "product_name": "<string>",
                "merchant_username": "<string>"
              }
            ],
            "display_resources": [
              {
                "src": "<string>",
                "config_width": 123,
                "config_height": 123
              }
            ],
            "video_versions": [
              {
                "url": "<string>",
                "id": "<string>",
                "type": 123,
                "width": 123,
                "height": 123
              }
            ],
            "music_attribution": {
              "artist_name": "<string>",
              "song_name": "<string>",
              "audio_id": "<string>",
              "uses_original_audio": true,
              "should_mute_audio": true
            },
            "location": {
              "id": "<string>",
              "name": "<string>",
              "slug": "<string>",
              "has_public_page": true,
              "lat": 123,
              "lng": 123,
              "address_json": {}
            },
            "is_pinned": true,
            "engagement_visibility": {
              "viewer_can_reshare": true,
              "comments_disabled": true,
              "like_and_view_counts_disabled": true
            }
          },
          "scraped_at": "2023-11-07T05:31:56Z"
        }
      }
    ],
    "scraped_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

Authorizations

X-API-Key · string · header · required

Body

application/json

shortcodes · string[] · required

Instagram post shortcodes from /p/, /reel/, or /tv/ URLs

Required array length: 1 - 20 elements

Minimum string length: 1

Example:

["C0ABC123xyz", "D1DEF456uvw"]

Response

200

application/json

Successful response

data · object · required

Show child attributes