Instagram
Instagram profile.mentions
Run Instagram profile.mentions. Normalized JSON, one price per record, automatic failover across sources.
POST
/
v1
/
extract
/
instagram
/
profile.mentions
curl -X POST https://api.socialrouter.io/v1/extract/instagram/profile.mentions \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/instagram",
"limit": 50
}'
const response = await fetch(
"https://api.socialrouter.io/v1/extract/instagram/profile.mentions",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
url: "https://www.instagram.com/instagram",
limit: 50
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/extract/instagram/profile.mentions",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"url": "https://www.instagram.com/instagram",
"limit": 50
},
)
const run = await sr.run("instagram/profile.mentions", {
url: "https://www.instagram.com/instagram",
limit: 50
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "instagram",
"service": "profile.mentions",
"url": "https://www.instagram.com/instagram",
"served_by": "apify/apify",
"data": [
{
"name": "hynecheck",
"profile_url": "https://www.instagram.com/p/BrGHMHIF8Kz/",
"source": "instagram",
"extracted_at": "2026-08-14T13:46:28.712Z",
"post_id": "1929261108986102451",
"shortcode": "BrGHMHIF8Kz",
"content_type": "Image",
"product_type": "feed",
"description": "Vardzia is a cave monastery site located in southern Georgia. It is excavated from the slopes of the Erusheti Mountai...",
"date_posted": "2018-12-07T18:04:27.000Z",
"likes": 14030,
"num_comments": 580,
"thumbnail": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-15/640956567_18562047613037433_6822966074348684895_n.jpg?stp=dst...",
"dimensions_height": 1334,
"dimensions_width": 1080,
"hashtags": [
"georgia",
"... 27 more"
],
"mentions": [
"beautifuldestinations",
"... 25 more"
],
"tagged_users": [
{
"full_name": "National Geographic",
"id": "787132",
"is_private": false,
"is_verified": true,
"profile_pic_id": "3887353266858160741",
"profile_pic_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst...",
"username": "natgeo"
},
"... 9 more"
],
"location_name": "Vardzia, Aspindzis Raioni, Georgia",
"music_info": {
"audio_canonical_id": "0",
"audio_type": null,
"music_info": null,
"original_sound_info": null,
"pinned_media_ids": null
},
"username": "hynecheck",
"owner_full_name": "Hynek Hampl",
"owner_id": "429173",
"user_profile_url": "https://www.instagram.com/hynecheck",
"paid_partnership": false,
"input_url": "https://www.instagram.com/natgeo/"
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}
Run Instagram profile.mentions. The response is normalized, so it keeps the same shape whichever offer served it.
The call is synchronous and comes back
The account being mentioned. Records are posts by other accounts.
Prices are live in the catalogue:
completed or failed. Body fields and error codes shared by every service are documented on Run a service.
Body
string[]
required
The URLs to fetch, as
urls (array) or url (single string). Each one must match an accepted format below, and a mismatch returns 400 invalid_input_format before any routing or billing.string
Single-input form of
urls.number
default:"100"
Maximum number of records to return. Integer, 1-250.
string
Pin one offer, as
source/name. Serving this service: apify/apify. Omit it (the default) to let the router walk the failover chain.object
Typed options for this service. Validation is strict, so an unknown key or an out-of-enum value returns a corrective
400 instead of being dropped.Hide options
Hide options
string (YYYY-MM-DD)
Only return posts published on or after this UTC date. A relative value works too — “1 day”, “2 months”, “3 years”.
Accepted URL formats
| Format | Example |
|---|---|
https://www.instagram.com/<username> | https://www.instagram.com/instagram |
Offers
One offer serves this endpoint today. When a second one implements it, failover turns on with no change on your side.| Offer | Inputs per call |
|---|---|
apify/apify | 50 |
GET /v1/services/instagram/profile.mentions. See Credits for how a call is billed.
Response
data[] holds the normalized records, served_by names the offer that answered, and credits_used carries the actual charge.
The example response is a real run with values shortened for readability. A field is present when Instagram exposes it for that item, so the exact set varies record to record.
curl -X POST https://api.socialrouter.io/v1/extract/instagram/profile.mentions \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/instagram",
"limit": 50
}'
const response = await fetch(
"https://api.socialrouter.io/v1/extract/instagram/profile.mentions",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
url: "https://www.instagram.com/instagram",
limit: 50
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/extract/instagram/profile.mentions",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"url": "https://www.instagram.com/instagram",
"limit": 50
},
)
const run = await sr.run("instagram/profile.mentions", {
url: "https://www.instagram.com/instagram",
limit: 50
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "instagram",
"service": "profile.mentions",
"url": "https://www.instagram.com/instagram",
"served_by": "apify/apify",
"data": [
{
"name": "hynecheck",
"profile_url": "https://www.instagram.com/p/BrGHMHIF8Kz/",
"source": "instagram",
"extracted_at": "2026-08-14T13:46:28.712Z",
"post_id": "1929261108986102451",
"shortcode": "BrGHMHIF8Kz",
"content_type": "Image",
"product_type": "feed",
"description": "Vardzia is a cave monastery site located in southern Georgia. It is excavated from the slopes of the Erusheti Mountai...",
"date_posted": "2018-12-07T18:04:27.000Z",
"likes": 14030,
"num_comments": 580,
"thumbnail": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-15/640956567_18562047613037433_6822966074348684895_n.jpg?stp=dst...",
"dimensions_height": 1334,
"dimensions_width": 1080,
"hashtags": [
"georgia",
"... 27 more"
],
"mentions": [
"beautifuldestinations",
"... 25 more"
],
"tagged_users": [
{
"full_name": "National Geographic",
"id": "787132",
"is_private": false,
"is_verified": true,
"profile_pic_id": "3887353266858160741",
"profile_pic_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst...",
"username": "natgeo"
},
"... 9 more"
],
"location_name": "Vardzia, Aspindzis Raioni, Georgia",
"music_info": {
"audio_canonical_id": "0",
"audio_type": null,
"music_info": null,
"original_sound_info": null,
"pinned_media_ids": null
},
"username": "hynecheck",
"owner_full_name": "Hynek Hampl",
"owner_id": "429173",
"user_profile_url": "https://www.instagram.com/hynecheck",
"paid_partnership": false,
"input_url": "https://www.instagram.com/natgeo/"
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}
⌘I
curl -X POST https://api.socialrouter.io/v1/extract/instagram/profile.mentions \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/instagram",
"limit": 50
}'
const response = await fetch(
"https://api.socialrouter.io/v1/extract/instagram/profile.mentions",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
url: "https://www.instagram.com/instagram",
limit: 50
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/extract/instagram/profile.mentions",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"url": "https://www.instagram.com/instagram",
"limit": 50
},
)
const run = await sr.run("instagram/profile.mentions", {
url: "https://www.instagram.com/instagram",
limit: 50
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "instagram",
"service": "profile.mentions",
"url": "https://www.instagram.com/instagram",
"served_by": "apify/apify",
"data": [
{
"name": "hynecheck",
"profile_url": "https://www.instagram.com/p/BrGHMHIF8Kz/",
"source": "instagram",
"extracted_at": "2026-08-14T13:46:28.712Z",
"post_id": "1929261108986102451",
"shortcode": "BrGHMHIF8Kz",
"content_type": "Image",
"product_type": "feed",
"description": "Vardzia is a cave monastery site located in southern Georgia. It is excavated from the slopes of the Erusheti Mountai...",
"date_posted": "2018-12-07T18:04:27.000Z",
"likes": 14030,
"num_comments": 580,
"thumbnail": "https://scontent-atl3-2.cdninstagram.com/v/t51.82787-15/640956567_18562047613037433_6822966074348684895_n.jpg?stp=dst...",
"dimensions_height": 1334,
"dimensions_width": 1080,
"hashtags": [
"georgia",
"... 27 more"
],
"mentions": [
"beautifuldestinations",
"... 25 more"
],
"tagged_users": [
{
"full_name": "National Geographic",
"id": "787132",
"is_private": false,
"is_verified": true,
"profile_pic_id": "3887353266858160741",
"profile_pic_url": "https://scontent-atl3-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst...",
"username": "natgeo"
},
"... 9 more"
],
"location_name": "Vardzia, Aspindzis Raioni, Georgia",
"music_info": {
"audio_canonical_id": "0",
"audio_type": null,
"music_info": null,
"original_sound_info": null,
"pinned_media_ids": null
},
"username": "hynecheck",
"owner_full_name": "Hynek Hampl",
"owner_id": "429173",
"user_profile_url": "https://www.instagram.com/hynecheck",
"paid_partnership": false,
"input_url": "https://www.instagram.com/natgeo/"
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}