View post insights
curl --request GET \
--url https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights \
--header 'x-api-key: <api-key>'import requests
url = "https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "post_demo_4k9",
"platform": "instagram",
"insights": {
"status": "available",
"reason": null,
"updatedAt": 1786089600000,
"views": 128450,
"reach": 102300,
"likes": 8420,
"comments": 312,
"shares": 486,
"saves": 1190,
"totalInteractions": 10408,
"profileVisits": 2180,
"follows": 347,
"totalWatchTimeMs": 184520000,
"avgWatchTimeMs": 14360,
"skipRate": 31.4,
"engagementRate": 8.1
},
"creatorAudience": {
"platform": "instagram",
"handle": "demo_creator",
"lastUpdatedAt": 1786089600000,
"audience": {
"status": "available",
"reason": null,
"countriesReason": null,
"usAudiencePercentage": 72,
"countries": [
{
"label": "US",
"percentage": 72
},
{
"label": "GB",
"percentage": 18
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 48.5
}
],
"genders": [
{
"label": "female",
"percentage": 61.2
}
],
"cities": [
{
"label": "New York",
"percentage": 12.4
}
],
"demographicsBasis": "reached",
"sampleSize": 2500,
"instagramAudiences": [
{
"basis": "reached",
"sampleSize": 2500,
"countries": [
{
"label": "US",
"percentage": 72
},
{
"label": "GB",
"percentage": 18
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 48.5
}
],
"genders": [
{
"label": "female",
"percentage": 61.2
}
],
"cities": [
{
"label": "New York",
"percentage": 12.4
}
]
},
{
"basis": "engaged",
"sampleSize": 840,
"countries": [
{
"label": "US",
"percentage": 68
},
{
"label": "GB",
"percentage": 22
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 52.1
}
],
"genders": [
{
"label": "female",
"percentage": 58.7
}
],
"cities": [
{
"label": "New York",
"percentage": 14.1
}
]
},
{
"basis": "followers",
"sampleSize": 3100,
"countries": [
{
"label": "US",
"percentage": 70
},
{
"label": "GB",
"percentage": 20
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 47.9
}
],
"genders": [
{
"label": "female",
"percentage": 62.4
}
],
"cities": [
{
"label": "New York",
"percentage": 11.8
}
]
}
]
}
}
}
}Posts
View post insights
Get the latest stored Instagram performance and Reel watch metrics for one post.
insights.status and insights.reason are paired: available with reason: null means a post snapshot exists; no_data with reason: never_fetched means no post snapshot exists; and no_data with reason: unsupported_platform means the post is not Instagram.
creatorAudience is account-level audience data for the account that published the post. Its handle follows the same PII lock as the creator audience endpoint. It is not the geography of people who watched this video: Meta does not expose per-post country data at any access level. Instagram audience entries describe separate populations reported by Meta and should not be added together. Non-Instagram posts return no_data with reason: unsupported_platform instead of invented metrics.
GET
/
posts
/
{id}
/
insights
View post insights
curl --request GET \
--url https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights \
--header 'x-api-key: <api-key>'import requests
url = "https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://dashboard.launchpointhq.com/api/v1/posts/{id}/insights")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "post_demo_4k9",
"platform": "instagram",
"insights": {
"status": "available",
"reason": null,
"updatedAt": 1786089600000,
"views": 128450,
"reach": 102300,
"likes": 8420,
"comments": 312,
"shares": 486,
"saves": 1190,
"totalInteractions": 10408,
"profileVisits": 2180,
"follows": 347,
"totalWatchTimeMs": 184520000,
"avgWatchTimeMs": 14360,
"skipRate": 31.4,
"engagementRate": 8.1
},
"creatorAudience": {
"platform": "instagram",
"handle": "demo_creator",
"lastUpdatedAt": 1786089600000,
"audience": {
"status": "available",
"reason": null,
"countriesReason": null,
"usAudiencePercentage": 72,
"countries": [
{
"label": "US",
"percentage": 72
},
{
"label": "GB",
"percentage": 18
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 48.5
}
],
"genders": [
{
"label": "female",
"percentage": 61.2
}
],
"cities": [
{
"label": "New York",
"percentage": 12.4
}
],
"demographicsBasis": "reached",
"sampleSize": 2500,
"instagramAudiences": [
{
"basis": "reached",
"sampleSize": 2500,
"countries": [
{
"label": "US",
"percentage": 72
},
{
"label": "GB",
"percentage": 18
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 48.5
}
],
"genders": [
{
"label": "female",
"percentage": 61.2
}
],
"cities": [
{
"label": "New York",
"percentage": 12.4
}
]
},
{
"basis": "engaged",
"sampleSize": 840,
"countries": [
{
"label": "US",
"percentage": 68
},
{
"label": "GB",
"percentage": 22
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 52.1
}
],
"genders": [
{
"label": "female",
"percentage": 58.7
}
],
"cities": [
{
"label": "New York",
"percentage": 14.1
}
]
},
{
"basis": "followers",
"sampleSize": 3100,
"countries": [
{
"label": "US",
"percentage": 70
},
{
"label": "GB",
"percentage": 20
},
{
"label": "CA",
"percentage": 10
}
],
"ages": [
{
"label": "25-34",
"percentage": 47.9
}
],
"genders": [
{
"label": "female",
"percentage": 62.4
}
],
"cities": [
{
"label": "New York",
"percentage": 11.8
}
]
}
]
}
}
}
}