# Instagram User Info

## Overview

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

## Description

Gather user insights efficiently from Instagram for targeted marketing strategies.

## 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/user/info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by username. Kylian Mbappé

```json
{
  "id": "4213518589",
  "name": "Kylian Mbappé",
  "posts": [
    {
      "id": "3859342446496501512",
      "likes": 1337767,
      "caption": "🇫🇷",
      "comments": 8331,
      "is_video": false,
      "shortcode": "DWPI4HmAs8I",
      "timestamp": 1774289493,
      "display_url": "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/655936260_18460602253142590_4270314222914824377_n.jpg"
    },
    {
      "id": "3855144622124864107",
      "likes": 1768534,
      "caption": "nos vemos en cuartos de final ¡HalaMadrid!",
      "comments": 10146,
      "is_video": false,
      "shortcode": "DWAOZu_gpJr",
      "timestamp": 1773789073,
      "display_url": "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/652735959_18458319658142590_2295182466998776037_n.jpg"
    },
    {
      "id": "3854258635190482004",
      "likes": 1527854,
      "caption": "back to business.",
      "comments": 12098,
      "is_video": false,
      "shortcode": "DV9E87XArRU",
      "timestamp": 1773683455,
      "display_url": "https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/652806606_18457940533142590_3633003369562801254_n.jpg"
    }
  ],
  "avatar": "https://scontent-cdg4-3.cdninstagram.com/v/t51.2885-19/252713041_231066042425309_8989807381344431608_n.jpg",
  "gender": "ambiguous",
  "private": false,
  "website": null,
  "username": "k.mbappe",
  "verified": true,
  "followers": 130723780,
  "following": 498,
  "description": "@realmadrid @equipedefrance",
  "category_name": "Athlete",
  "business_account": true,
  "business_category_name": "None"
}
```

## Documentation

## Overview
Retrieve complete public profile data from any Instagram account using a URL or username. Returns follower counts, bio, verification status, business category, and the user's most recent posts.

## Quickstart
```
GET https://api.piloterr.com/v2/instagram/user/info?query=k.mbappe
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Instagram profile URL or username |

## Main use cases
- Build influencer discovery tools by querying follower counts and engagement rates
- Enrich CRM or outreach lists with real-time Instagram profile data
- Identify key opinion leaders by filtering on verification and category
- Power social analytics dashboards tracking audience growth over time