Instagram Complete profile API

A profile, its recent posts, and the comments under each of them, assembled into one document. Use `limit` for how many posts.

Instagram API pricing — $0.50 per 1,000 results

POST /api/public/v1/scrape/instagram/complete_profile

Returns complete_profile

Parameters#

username string required

Username, with or without the @.

Example: nasa

limit integer optional

How many results you want. The run is sized from it, and you are billed for exactly that many.

This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.

curl -X POST https://socialholmes.com/api/public/v1/scrape/instagram/complete_profile \
  -H "Authorization: Bearer $SOCIALHOLMES_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parameters": {"username": "nasa"}, "limit": 25}'

import os
import requests

run = requests.post(
    "https://socialholmes.com/api/public/v1/scrape/instagram/complete_profile",
    headers={"Authorization": f"Bearer {os.environ['SOCIALHOLMES_KEY']}"},
    json={"parameters": {"username": "nasa"}, "limit": 25},
).json()

print(run["id"], run["status"])

const response = await fetch("https://socialholmes.com/api/public/v1/scrape/instagram/complete_profile", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOCIALHOLMES_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ parameters: { username: "nasa" }, limit: 25 }),
})

const run = await response.json()
console.log(run.id, run.status)

require "net/http"
require "json"

response = Net::HTTP.post(
  URI("https://socialholmes.com/api/public/v1/scrape/instagram/complete_profile"),
  { parameters: { username: "nasa" }, limit: 25 }.to_json,
  "Authorization" => "Bearer #{ENV.fetch('SOCIALHOLMES_KEY')}",
  "Content-Type" => "application/json"
)

run = JSON.parse(response.body)
puts run["id"], run["status"]

<?php

$ch = curl_init("https://socialholmes.com/api/public/v1/scrape/instagram/complete_profile");

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("SOCIALHOLMES_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["parameters" => ["username" => "nasa"], "limit" => 25]),
]);

$run = json_decode(curl_exec($ch), true);

echo $run["id"], " ", $run["status"];

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"parameters": map[string]string{"username": "nasa"},
		"limit":      25,
	})

	req, _ := http.NewRequest("POST", "https://socialholmes.com/api/public/v1/scrape/instagram/complete_profile", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("SOCIALHOLMES_KEY"))
	req.Header.Set("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	var run map[string]any
	json.NewDecoder(res.Body).Decode(&run)

	fmt.Println(run["id"], run["status"])
}

202 Accepted

{
  "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
  "status": "queued",
  "platform": "instagram",
  "endpoint": "complete_profile",
  "target": "nasa",
  "url": "https://www.instagram.com/nasa/",
  "result_count": 0,
  "created_at": "2026-10-16T17:07:09Z"
}

example

{
  "run": {
    "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
    "status": "succeeded",
    "platform": "instagram",
    "endpoint": "complete_profile",
    "target": "nasa",
    "url": "https://www.instagram.com/nasa/",
    "result_count": 7,
    "requested": 2,
    "estimated_cost": 63,
    "captures": 0,
    "created_at": "2026-08-22T07:44:03Z",
    "started_at": "2026-08-22T07:45:03Z",
    "finished_at": "2026-08-22T09:14:03Z"
  },
  "unit": "result",
  "profile": {
    "id": "528817151",
    "username": "nasa",
    "full_name": "NASA",
    "biography": "Exploring the universe and our home planet.",
    "category": "Government Organisation",
    "is_verified": true,
    "is_private": false,
    "follower_count": 98243117,
    "following_count": 78,
    "media_count": 4192,
    "external_url": "https://www.nasa.gov",
    "profile_pic_url": "https://instagram.example/v/t51/528817151_hd.jpg"
  },
  "posts": [
    {
      "id": "3487291045512345678",
      "shortcode": "C8xY_abcDEF",
      "url": "https://www.instagram.com/p/C8xY_abcDEF/",
      "type": "video",
      "caption": "Artemis II rolls out to Launch Complex 39B. 🚀",
      "taken_at": "2026-08-22T08:54:03Z",
      "like_count": 204881,
      "comment_count": 3920,
      "share_count": 1204,
      "is_paid_partnership": false,
      "width": 1440,
      "height": 1800,
      "media_urls": [
        "https://instagram.example/v/t50/C8xY_720.mp4"
      ],
      "author": {
        "id": "528817151",
        "username": "nasa",
        "full_name": "NASA",
        "is_verified": true
      },
      "comments": [
        {
          "id": "17984412200123456",
          "text": "The scale of that thing never stops being unreal.",
          "created_at": "2026-08-22T09:13:11Z",
          "like_count": 418,
          "reply_count": 12,
          "is_edited": false,
          "author": {
            "id": "1904412887",
            "username": "astro_pete",
            "full_name": "Pete Marsden",
            "is_verified": false,
            "profile_pic_url": "https://instagram.example/v/t51/astro_pete.jpg"
          },
          "replies": []
        },
        {
          "id": "17984399120987654",
          "text": "Watching this live from the causeway. Unforgettable.",
          "created_at": "2026-08-22T09:03:22Z",
          "like_count": 96,
          "reply_count": 0,
          "is_edited": false,
          "author": {
            "id": "2288140033",
            "username": "lenaorbits",
            "full_name": "Lena Ortiz",
            "is_verified": false,
            "profile_pic_url": "https://instagram.example/v/t51/lenaorbits.jpg"
          },
          "replies": []
        }
      ]
    },
    {
      "id": "3486110938401234567",
      "shortcode": "C8wQ_ghiJKL",
      "url": "https://www.instagram.com/p/C8wQ_ghiJKL/",
      "type": "carousel",
      "caption": "Five views of the Moon from lunar orbit.",
      "taken_at": "2026-08-21T08:53:21Z",
      "like_count": 512044,
      "comment_count": 6118,
      "carousel_count": 3,
      "is_paid_partnership": false,
      "width": 1080,
      "height": 1080,
      "media_urls": [
        "https://instagram.example/v/t51/C8wQ_a_1080.jpg",
        "https://instagram.example/v/t51/C8wQ_b_1080.jpg",
        "https://instagram.example/v/t51/C8wQ_c_1080.jpg"
      ],
      "author": {
        "id": "528817151",
        "username": "nasa",
        "full_name": "NASA",
        "is_verified": true
      },
      "comments": [
        {
          "id": "17984412200123456",
          "text": "The scale of that thing never stops being unreal.",
          "created_at": "2026-08-22T09:13:11Z",
          "like_count": 418,
          "reply_count": 12,
          "is_edited": false,
          "author": {
            "id": "1904412887",
            "username": "astro_pete",
            "full_name": "Pete Marsden",
            "is_verified": false,
            "profile_pic_url": "https://instagram.example/v/t51/astro_pete.jpg"
          },
          "replies": []
        },
        {
          "id": "17984399120987654",
          "text": "Watching this live from the causeway. Unforgettable.",
          "created_at": "2026-08-22T09:03:22Z",
          "like_count": 96,
          "reply_count": 0,
          "is_edited": false,
          "author": {
            "id": "2288140033",
            "username": "lenaorbits",
            "full_name": "Lena Ortiz",
            "is_verified": false,
            "profile_pic_url": "https://instagram.example/v/t51/lenaorbits.jpg"
          },
          "replies": []
        }
      ]
    }
  ],
  "counts": {
    "posts": 2,
    "comments": 4,
    "replies": 0,
    "total": 7
  },
  "stages": {
    "profile": "succeeded",
    "posts": "succeeded",
    "comments": {
      "requested": 2,
      "run": 2,
      "succeeded": 2,
      "empty": 0,
      "failed": 0
    }
  }
}

Try it