How do I calculate an Instagram account's engagement rate via API?
Take the follower count from GET /instagram/profile/details, the latest posts from GET /instagram/profile/posts, and divide the average likes per post by the followers (× 100). Two calls per account, and the free Instagram engagement rate calculator does the same in the browser.
Meta's official option
Meta's Instagram API gives engagement insights for your own professional account. For other accounts, Business Discovery returns Business and Creator accounts' media and counts, through your own professional account and a Meta app.
How to do it with SocialAPIs
Call /instagram/profile/details with username (1 credit), then /instagram/profile/posts with the same username (1 credit; up to 12 credits per call depending on the result). Each post in data.posts has like_count, video_view_count (videos, else null), is_video, product_type, permalink and owner.username.
Count only posts whose owner.username is the account itself (collaboration posts by other accounts appear in the list too), and skip posts with like_and_view_counts_disabled set. Rate = average like_count ÷ followers × 100.
Endpoints
GET /instagram/profile/details1 credit
Get user profile information by username including bio, followers, posts count, and related profiles.
Params:
username(required),linkInstagram Profile Details: docs and playgroundMCP:
instagram_profile→detailsGET /instagram/profile/posts1 credit; up to 12 credits per call depending on the result
Get posts from a user profile with pagination.
Params:
username,user_id,end_cursor,full_detailsInstagram Profile Posts: docs and playgroundMCP:
instagram_profile→posts
curl -G "https://api.socialapis.io/instagram/profile/posts" \
--max-time 100 \
--fail-with-body \
-H "x-api-token: $SOCIALAPIS_API_KEY" \
--data-urlencode "username=nasa"import os
import requests
response = requests.get(
"https://api.socialapis.io/instagram/profile/posts",
headers={"x-api-token": os.environ["SOCIALAPIS_API_KEY"]},
params={
"username": "nasa",
},
timeout=100,
)
response.raise_for_status()
print(response.json())// Node 18+, as an ES module (e.g. main.mjs)
async function get(url, params) {
const query = new URLSearchParams(params).toString();
const response = await fetch(query ? `${url}?${query}` : url, {
headers: { "x-api-token": process.env.SOCIALAPIS_API_KEY },
signal: AbortSignal.timeout(100000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
return response.json();
}
const data = await get("https://api.socialapis.io/instagram/profile/posts", {
username: "nasa",
});
console.log(data);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.util.Map;
import java.util.stream.Collectors;
public class Main {
private static final HttpClient CLIENT = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.build();
public static void main(String[] args) throws Exception {
String body = get("https://api.socialapis.io/instagram/profile/posts", Map.of(
"username", "nasa"));
System.out.println(body);
}
static String get(String url, Map<String, String> params) throws Exception {
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "="
+ URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpRequest request = HttpRequest.newBuilder(URI.create(query.isEmpty() ? url : url + "?" + query))
.header("x-api-token", System.getenv("SOCIALAPIS_API_KEY"))
.timeout(Duration.ofSeconds(100))
.GET()
.build();
HttpResponse<String> response = CLIENT.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() / 100 != 2) {
throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
}
return response.body();
}
}package main
import (
"fmt"
"io"
"log"
"net/http"
"net/url"
"os"
"time"
)
func main() {
body, err := get("https://api.socialapis.io/instagram/profile/posts", url.Values{
"username": {"nasa"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(string(body))
}
func get(endpoint string, params url.Values) ([]byte, error) {
if len(params) > 0 {
endpoint += "?" + params.Encode()
}
req, err := http.NewRequest(http.MethodGet, endpoint, nil)
if err != nil {
return nil, err
}
req.Header.Set("x-api-token", os.Getenv("SOCIALAPIS_API_KEY"))
client := &http.Client{Timeout: 100 * time.Second}
resp, err := client.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
return nil, err
}
if resp.StatusCode/100 != 2 {
return nil, fmt.Errorf("HTTP %d: %s", resp.StatusCode, body)
}
return body, nil
}# pip install socialapis-sdk
import os
from socialapis import Instagram
client = Instagram(api_token=os.environ["SOCIALAPIS_API_KEY"])
response = client.get_profile_posts("nasa")
print(response)// npm install socialapis-sdk
import { Instagram } from "socialapis-sdk";
const client = new Instagram({ apiToken: process.env.SOCIALAPIS_API_KEY });
const response = await client.getProfilePosts("nasa");
console.log(response);Your API key goes in the x-api-token header (here from the SOCIALAPIS_API_KEY environment variable). Get a free key.
Tutorial: Free tool: Instagram engagement rate calculatorUse it from Claude, ChatGPT or Cursor (MCP)
Good to know
- Likes only: the posts answer has no comment count, so a likes-plus-comments rate needs another source. Say which formula you used when you compare accounts.
- Private accounts return no posts; a rate needs a public account.
- Leave
full_detailsoff for this: the default call has the likes you need.