Skip to content

How to get Instagram profile data, posts and reels with an API

Updated · 3 steps

As of Nov 2026, Meta's official Instagram APIs only read other accounts that are professional accounts, and the access level for that needs App Review and Business Verification. To read any public profile, Fetchproof returns what a signed-out visitor sees, as JSON.

Use it for creator vetting, competitor tracking, or filling in profile cards in your product.

01

Get the profile

Pass the username, with or without @. The profile is under data.user: username, full name, biography, bio links, verification, and exact follower and following counts in edge_followed_by.count and edge_follow.count. The first 12 grid posts come in edge_owner_to_timeline_media.edges.

GET /v1/instagram/profile 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v1/instagram/profile?handle=natgeo' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/instagram/profile?handle=natgeo", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v1/instagram/profile?handle=natgeo",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/instagram/profile?handle=natgeo", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v1/instagram/profile?handle=natgeo");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "data": {
    "user": {
      "biography": "Step into wonder and find your inner explorer with National Geographic 🌎",
      "bio_links": [
        "{…}"
      ],
      "biography_with_entities": "{…}",
      "external_url": "http://visitstore.bio/natgeo",
      "edge_followed_by": "{…}",
      "fbid": "17841400573960012",
      "edge_follow": "{…}",
      "full_name": "National Geographic",
      "has_clips": true,
      "id": "787132",
      "is_private": false,
      "is_verified": true,
      "…": "7 more fields"
    }
  }
}
02

Get the profile's reels with play counts

Returns the first 12 reels on the profile's reels tab, each with play_count, like_count, comment_count, code and date. Set require_play_counts=true to fail at 0 credits instead of getting a reel with no play count.

GET /v1/instagram/user/reels 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v1/instagram/user/reels?handle=natgeo' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/instagram/user/reels?handle=natgeo", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v1/instagram/user/reels?handle=natgeo",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/instagram/user/reels?handle=natgeo", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v1/instagram/user/reels?handle=natgeo");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "items": [
    {
      "media": "{…}"
    }
  ],
  "paging_info": {
    "max_id": null,
    "more_available": true
  }
}
03

Get one post or reel

Pass a /p/, /reel/, /reels/ or /tv/ URL to get its media URLs, caption, owner (with follower count), like and comment counts.

GET /v1/instagram/post 1 credit per call

cURL

curl --request GET 'https://api.fetchproof.com/v1/instagram/post?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDLDXI0fylTC%2F' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/instagram/post?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDLDXI0fylTC%2F", {
  method: 'GET',
  headers: {
    'x-api-key': process.env.FETCHPROOF_API_KEY,
  },
});
const data = await response.json();
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://api.fetchproof.com/v1/instagram/post?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDLDXI0fylTC%2F",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/instagram/post?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDLDXI0fylTC%2F", nil)
  req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

PHP

<?php
$ch = curl_init("https://api.fetchproof.com/v1/instagram/post?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDLDXI0fylTC%2F");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
  ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
Excerpt of published sample response Full response →
{
  "success": true,
  "credits_remaining": 100,
  "credits_charged": 1,
  "data": {
    "xdt_shortcode_media": {
      "__typename": "XDTGraphVideo",
      "id": "3657869083548472514",
      "shortcode": "DLDXI0fylTC",
      "thumbnail_src": "https://scontent-iad6-1.cdninstagram.com/v/t51.75761-15/509601086_18503874985017172_856368…",
      "dimensions": "{…}",
      "display_url": "https://scontent-iad6-1.cdninstagram.com/v/t51.75761-15/509601086_18503874985017172_856368…",
      "display_resources": [
        "{…}"
      ],
      "accessibility_caption": null,
      "has_audio": true,
      "video_url": "https://scontent-iad3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPIiBLJBqG6YM9FzeabZmQkGTo94LpWkF…",
      "video_view_count": 155769,
      "product_type": "clips",
      "…": "11 more fields"
    }
  }
}

Limits

Everything comes from the signed-out view, so only the first 12 posts and the first 12 reels are available, with no paging past them. Business contact fields, related profiles and per-post like counts on the profile grid are not on the signed-out page, so they aren't returned.

The profile's post count is null when Instagram only shows a rounded number such as 32K. The post count endpoint returns it exactly.

What it costs

Each call costs 1 credit. Missing profiles fail at 0 credits, and cache_max_age reuses a recent copy for 0 credits.

Try it with 100 free credits

Sign up with an email address, no card. Credits never expire. Errors cost 0 credits, and each endpoint page lists exactly what it charges.