# Instagram Post Info

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/instagram/post/info` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/instagram-post-info |

## Description

Monitor competitors and market trends by scraping Instagram posts for valuable data.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/instagram/post/info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by post URL (Mbappe. France team post)

```json
{
  "id": "3859342446496501512",
  "text": "🇫🇷",
  "is_video": false,
  "owner_id": "4213518589",
  "sponsors": [],
  "shortcode": "DWPI4HmAs8I",
  "text_lang": "fr",
  "text_tags": [],
  "timestamp": 1774289493,
  "like_count": 1337686,
  "location_id": "375685686285802",
  "created_time": "2026-03-23 18:11:33",
  "product_type": null,
  "location_name": "Clairefontaine - Centre National Du Football",
  "location_slug": "clairefontaine-centre-national-du-football",
  "related_posts": null,
  "comments_count": 8331,
  "paid_partnership": false,
  "text_tagged_users": [],
  "video_plays_count": null,
  "video_views_count": null,
  "is_comments_disabled": false,
  "attached_media_display_url": "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/655936260_18460602253142590_4270314222914824377_n.jpg",
  "attached_media_tagged_users": [
    {
      "id": "253982730",
      "username": "equipedefrance"
    }
  ],
  "attached_carousel_media_urls": [
    "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/655936260_18460602253142590_4270314222914824377_n.jpg",
    "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/658867910_18460602280142590_6337465939339629136_n.jpg",
    "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/657621742_18460602271142590_1605271971122095294_n.jpg"
  ]
}
```

### Lookup by shortcode (Mbappe: classic post)

```json
{
  "id": "3107849898061488933",
  "text": "🍿",
  "is_video": false,
  "owner_id": "4213518589",
  "sponsors": [],
  "shortcode": "CshTQQlMGMl",
  "text_lang": "en",
  "text_tags": [],
  "timestamp": 1684704600,
  "like_count": 2604768,
  "location_id": "12345912",
  "created_time": "2023-05-21T21:30:00",
  "product_type": null,
  "location_name": "Auxerre",
  "location_slug": "auxerre",
  "related_posts": null,
  "comments_count": 11566,
  "paid_partnership": false,
  "text_tagged_users": [],
  "video_plays_count": null,
  "video_views_count": null,
  "is_comments_disabled": false,
  "attached_media_display_url": "https://scontent-cdg4-1.cdninstagram.com/v/t51.2885-15/347861207_1707687973014484_3649610220149539376_n.jpg",
  "attached_media_tagged_users": [],
  "attached_carousel_media_urls": [
    "https://scontent-cdg4-1.cdninstagram.com/v/t51.2885-15/347861207_1707687973014484_3649610220149539376_n.jpg",
    "https://scontent-cdg4-2.cdninstagram.com/v/t51.2885-15/347832052_2243608469163355_4814444542687724291_n.jpg"
  ]
}
```

## Documentation

## Overview
Retrieve complete public data for any Instagram post or reel using its URL or shortcode. Returns engagement metrics, media URLs, location, hashtags, tagged users, and author information.

## Quickstart
```
GET https://api.piloterr.com/v2/instagram/post/info?query=https://www.instagram.com/p/CshTQQlMGMl
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Instagram post URL or shortcode |

## Main use cases
- Monitor brand mentions and competitor posts on Instagram for market intelligence
- Extract engagement metrics (likes, comments) to benchmark content performance
- Build influencer analysis tools that aggregate post data across multiple accounts
- Enrich social media datasets with post-level metadata for machine learning pipelines