cURL
curl --request GET \
--url https://api.influship.com/v1/raw/instagram/post/{shortcode} \
--header 'X-API-Key: <api-key>'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.getPost('C0ABC123xyz');
console.log(response.data);import requests
url = "https://api.influship.com/v1/raw/instagram/post/{shortcode}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"post": {
"id": "<string>",
"shortcode": "<string>",
"display_url": "<string>",
"is_video": true,
"post_type": "image",
"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"
}
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "upstream_contract_broken",
"message": "The upstream source returned data this endpoint cannot process. This is not retryable; it has been reported.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"upstream_error": "upstream_contract_broken",
"retryable": false
}
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}Live Scraping
Get Live Instagram Post
Fetch fresh Instagram post-page data by shortcode. This raw endpoint includes rich post-page fields like coauthors, tagged users, paid partnership metadata, product mentions, music attribution, location, display resources, and video versions.
Note: These fields are only guaranteed on this raw single-post lookup. Cached post-list endpoints may not include them.
Returns fresh video_url (single best stream) and video_versions[] (multi-bitrate). These are signed Instagram CDN URLs valid for ~24h — download promptly. For carousels with embedded videos, see carousel_items[].video_url.
Pricing: 1 credit per post scraped ($0.01)
GET
/
v1
/
raw
/
instagram
/
post
/
{shortcode}
cURL
curl --request GET \
--url https://api.influship.com/v1/raw/instagram/post/{shortcode} \
--header 'X-API-Key: <api-key>'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.getPost('C0ABC123xyz');
console.log(response.data);import requests
url = "https://api.influship.com/v1/raw/instagram/post/{shortcode}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"post": {
"id": "<string>",
"shortcode": "<string>",
"display_url": "<string>",
"is_video": true,
"post_type": "image",
"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"
}
}{
"error": {
"code": "validation_error",
"message": "Invalid value for parameter 'limit': must be between 1 and 100",
"param": "limit",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "payment_required",
"message": "Payment authentication is required.",
"status_code": 402,
"reason_code": "PAYMENT_ACTION_REQUIRED",
"next_step": "complete_authentication",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "forbidden",
"message": "Your plan does not include access to this endpoint",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "not_found",
"message": "Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded (per minute)",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later.",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "upstream_contract_broken",
"message": "The upstream source returned data this endpoint cannot process. This is not retryable; it has been reported.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"upstream_error": "upstream_contract_broken",
"retryable": false
}
}
}{
"error": {
"code": "service_unavailable",
"message": "Live Instagram data is temporarily unavailable. Please retry shortly.",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60,
"upstream_error": "upstream_rate_limited"
}
}
}