Instagram Creator profiles API

Creators from a keyword search, each with their profile loaded, so the ranking is a real engagement rate rather than a raw count. `limit` is how many creators to return and `comment_limit` how many of them to load a profile for. One page load per creator, so it is slower and dearer.

Instagram API pricing — $0.50 per 1,000 results

POST /api/public/v1/scrape/instagram/creator_profiles

Returns creator_discovery

Parameters#

query string required

A topic, and a place if you want one — "finance kolkata".

Example: finance kolkata

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/creator_profiles \
  -H "Authorization: Bearer $SOCIALHOLMES_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parameters": {"query": "finance kolkata"}, "limit": 25}'

import os
import requests

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

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

const response = await fetch("https://socialholmes.com/api/public/v1/scrape/instagram/creator_profiles", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOCIALHOLMES_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ parameters: { query: "finance kolkata" }, 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/creator_profiles"),
  { parameters: { query: "finance kolkata" }, 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/creator_profiles");

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" => ["query" => "finance kolkata"], "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{"query": "finance kolkata"},
		"limit":      25,
	})

	req, _ := http.NewRequest("POST", "https://socialholmes.com/api/public/v1/scrape/instagram/creator_profiles", 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": "creator_profiles",
  "target": "finance kolkata",
  "url": "https://www.instagram.com/explore/search/keyword/?q=finance+kolkata",
  "result_count": 0,
  "created_at": "2026-10-16T17:05:42Z"
}

example

{
  "run": {
    "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
    "status": "succeeded",
    "platform": "instagram",
    "endpoint": "creator_profiles",
    "target": "finance kolkata",
    "url": "https://www.instagram.com/explore/search/keyword/?q=finance+kolkata",
    "result_count": 1,
    "requested": 2,
    "estimated_cost": 2,
    "captures": 0,
    "created_at": "2026-08-22T07:44:03Z",
    "started_at": "2026-08-22T07:45:03Z",
    "finished_at": "2026-08-22T09:14:03Z"
  },
  "unit": "creator",
  "creators": [
    {
      "username": "nasa",
      "id": "528817151",
      "name": "NASA",
      "url": "https://www.instagram.com/nasa/",
      "is_verified": true,
      "posts_in_sample": 2,
      "avg_likes": 358462.5,
      "avg_comments": 5019.0,
      "avg_engagement": 363481.5,
      "total_engagement": 726963.0,
      "latest_post_at": "2026-08-22T08:54:03Z",
      "sample_posts": [
        {
          "shortcode": "C8xY_abcDEF",
          "url": "https://www.instagram.com/p/C8xY_abcDEF/",
          "like_count": 204881,
          "comment_count": 3920,
          "taken_at": "2026-08-22T08:54:03Z"
        },
        {
          "shortcode": "C8wQ_ghiJKL",
          "url": "https://www.instagram.com/p/C8wQ_ghiJKL/",
          "like_count": 512044,
          "comment_count": 6118,
          "taken_at": "2026-08-21T08:53:21Z"
        }
      ],
      "ranked_by": "engagement_rate",
      "rank": 1,
      "follower_count": 98243117,
      "following_count": 78,
      "media_count": 4192,
      "category": "Government Organisation",
      "biography": "Exploring the universe and our home planet.",
      "engagement_rate": 0.37
    }
  ],
  "counts": {
    "creators": 1,
    "enriched": 1,
    "total": 1
  },
  "stages": {
    "creators": "succeeded",
    "profiles": {
      "requested": 1,
      "run": 1,
      "succeeded": 1,
      "empty": 0,
      "failed": 0
    }
  }
}

Try it