curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/ads/instagram/insights?level=campaign&ids=120200000000000001&startDate=2026-09-01&endDate=2026-09-02"
const API_KEY = "API_KEY";
const params = new URLSearchParams({
level: "campaign",
ids: "120200000000000001",
startDate: "2026-09-01",
endDate: "2026-09-02",
});
fetch(`https://api.ayrshare.com/api/ads/instagram/insights?${params}`, {
method: "GET",
headers: { Authorization: `Bearer ${API_KEY}` },
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
params = {
'level': 'campaign',
'ids': '120200000000000001',
'startDate': '2026-09-01',
'endDate': '2026-09-02',
}
r = requests.get('https://api.ayrshare.com/api/ads/instagram/insights', headers=headers, params=params)
print(r.json())
{
"status": "success",
"platform": "instagram",
"level": "campaign",
"startDate": "2026-09-01",
"endDate": "2026-09-02",
"insights": [
{
"date": "2026-09-01",
"level": "campaign",
"id": "120200000000000001",
"currency": "USD",
"spend": 12.34,
"impressions": 4000,
"reach": 3100,
"clicks": 80,
"cpm": 3.085,
"cpc": 0.15425,
"ctr": 2,
"actions": [
{ "type": "link_click", "value": 75 },
{ "type": "omni_purchase", "value": 3 }
],
"conversionValue": 89.97
}
],
"count": 1,
"nextCursor": null
}
{
"status": "success",
"platform": "instagram",
"level": "ad",
"startDate": "2026-09-01",
"endDate": "2026-09-01",
"insights": [
{
"date": "2026-09-01",
"level": "ad",
"id": "120210000000000001",
"age": "25-34",
"gender": "female",
"currency": "EUR",
"spend": 1.5,
"impressions": 300
},
{
"date": "2026-09-01",
"level": "ad",
"id": "120210000000000001",
"age": "25-34",
"gender": "male",
"currency": "EUR",
"spend": 1,
"impressions": 200
}
],
"count": 2,
"nextCursor": null
}
{
"action": "ads",
"status": "error",
"code": 400,
"message": "The ad is not found or not authorized."
}
Instagram Ads
Insights
Отримання щоденної аналітики Instagram Ads у реальному часі за кампанією, групою оголошень або оголошенням
GET
/
ads
/
instagram
/
insights
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/ads/instagram/insights?level=campaign&ids=120200000000000001&startDate=2026-09-01&endDate=2026-09-02"
const API_KEY = "API_KEY";
const params = new URLSearchParams({
level: "campaign",
ids: "120200000000000001",
startDate: "2026-09-01",
endDate: "2026-09-02",
});
fetch(`https://api.ayrshare.com/api/ads/instagram/insights?${params}`, {
method: "GET",
headers: { Authorization: `Bearer ${API_KEY}` },
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
params = {
'level': 'campaign',
'ids': '120200000000000001',
'startDate': '2026-09-01',
'endDate': '2026-09-02',
}
r = requests.get('https://api.ayrshare.com/api/ads/instagram/insights', headers=headers, params=params)
print(r.json())
{
"status": "success",
"platform": "instagram",
"level": "campaign",
"startDate": "2026-09-01",
"endDate": "2026-09-02",
"insights": [
{
"date": "2026-09-01",
"level": "campaign",
"id": "120200000000000001",
"currency": "USD",
"spend": 12.34,
"impressions": 4000,
"reach": 3100,
"clicks": 80,
"cpm": 3.085,
"cpc": 0.15425,
"ctr": 2,
"actions": [
{ "type": "link_click", "value": 75 },
{ "type": "omni_purchase", "value": 3 }
],
"conversionValue": 89.97
}
],
"count": 1,
"nextCursor": null
}
{
"status": "success",
"platform": "instagram",
"level": "ad",
"startDate": "2026-09-01",
"endDate": "2026-09-01",
"insights": [
{
"date": "2026-09-01",
"level": "ad",
"id": "120210000000000001",
"age": "25-34",
"gender": "female",
"currency": "EUR",
"spend": 1.5,
"impressions": 300
},
{
"date": "2026-09-01",
"level": "ad",
"id": "120210000000000001",
"age": "25-34",
"gender": "male",
"currency": "EUR",
"spend": 1,
"impressions": 200
}
],
"count": 2,
"nextCursor": null
}
{
"action": "ads",
"status": "error",
"code": 400,
"message": "The ad is not found or not authorized."
}
Отримуйте актуальні показники ефективності оголошень Instagram, по одному рядку на день, для ваших кампаній, груп оголошень або оголошень.
Виберіть потрібні метрики, розбийте їх за віком, статтю, країною або місцем розміщення та переглядайте довгі діапазони дат посторінково.
Instagram звітує про кожну метрику з цієї таблиці. Один виняток: Meta не звітує про
- Дані зчитуються з Meta в момент вашого запиту, а не з нічної копії.
- Використовуйте History для витрат, за які ми виставляємо рахунок. Використовуйте Insights для звітності та аналізу.
- Усі грошові значення подаються у валюті рекламного облікового запису, яка повертається в
currencyу кожному рядку. - Кампанії мають бути створені через Ayrshare для цього профілю, а групи оголошень мають бути в такій кампанії. Оголошення, створене через Ayrshare для іншого профілю, буде відхилено. Інші ID оголошень зчитуються через пов’язаний обліковий запис Meta цього профілю, тому Meta повертає лише ті оголошення, які бачить цей обліковий запис.
- Один запит охоплює один рекламний обліковий запис. ID з кількох рекламних облікових записів повертають код
101, так само як і кілька ID оголошень, про які Ayrshare не має записів. Запитуйте їх по одному.
Параметри заголовка
Параметри запиту
string
обов'язково
Про що звітує кожен рядок:
campaign, adSet або ad.string
ID кампаній, груп оголошень або оголошень через кому, до 50. Обов’язковий для
level=campaign і
level=adSet.З level=ad можна не передавати ids, а натомість надіслати accountId. Тоді звіт охоплює оголошення,
які ви створили через Ayrshare для цього профілю в цьому рекламному обліковому записі, а не всі оголошення в ньому. Це працює
для до 50 таких оголошень. Якщо їх більше, надішліть їхні ID або формуйте звіт за кампаніями. Якщо нічого не знайдено,
звіт буде порожнім.string
ID рекламного облікового запису, з префіксом
act_ або без нього (1234567890 або act_1234567890).Обов’язковий з level=ad, якщо ids не передано.string
Метрики для повернення через кому. Не передавайте цей параметр, щоб отримати всі. Див. Метрики.
string
Розбивки через кому:
age, gender, country, placement. Тоді кожен день має один рядок на кожне
значення або на кожну комбінацію у випадку age,gender. Надсилайте одну розбивку за раз або age,gender; Meta
відхиляє інші комбінації (наприклад, age,country), тому вони повертають код 101.string
за замовчуванням:"30 днів тому"
Перший день у форматі
YYYY-MM-DD. Може бути не раніше ніж 37 місяців тому.string
за замовчуванням:"сьогодні"
Останній день у форматі
YYYY-MM-DD.string
nextCursor з попередньої відповіді, щоб отримати наступну сторінку.Метрики
| Метрика | Тип | Значення |
|---|---|---|
spend | number | Витрачена сума |
impressions | number | Скільки разів оголошення було показано |
reach | number | Люди, які бачили оголошення принаймні один раз |
clicks | number | Кліки |
cpm | number або null | Вартість за 1 000 показів |
cpc | number або null | Вартість за клік. null у день без кліків |
ctr | number або null | Показник клікабельності, у відсотках |
actions | array | Кожен тип дії, врахований Meta, з його кількістю |
conversionValue | number | Загальна вартість покупок |
reach для звіту з
breakdowns, що починається понад 13 місяців тому, тому reach не включається в ці рядки. У мережах, які не звітують про певну метрику, її
не включають у рядки, а не повертають як 0, а запит такої метрики повертає код 101.
Meta враховує деякі дії в кількох типах, тому не додавайте значення
actions між собою. Наприклад,
omni_purchase уже включає purchase. conversionValue враховує кожну покупку один раз.Пагінація
Кожна відповідь повертає до 500 рядків. Якщо їх більше, встановлюєтьсяnextCursor. Надішліть той самий запит
ще раз із cursor, що дорівнює цьому значенню, щоб отримати наступну сторінку. На останній сторінці nextCursor дорівнює null.
Помилки
| Код | Коли |
|---|---|
101 | Параметр відсутній або неправильний, розбивка чи метрика не підтримується, startDate більш ніж 37 місяців тому, надіслано понад 50 ID, ID належать до кількох рекламних облікових записів або Meta відхиляє комбінацію розбивок |
400 | Кампанія, група оголошень чи оголошення не належить вам, або accountId не є рекламним обліковим записом, який Ayrshare має в записах для надісланих ID. Для групи оголошень accountId також має бути рекламним обліковим записом, який Meta вказує для неї. Для оголошення без запису в Ayrshare accountId не перевіряється, і оголошення зчитується окремо |
370 | Meta не змогла повернути аналітику. Спробуйте ще раз |
curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/ads/instagram/insights?level=campaign&ids=120200000000000001&startDate=2026-09-01&endDate=2026-09-02"
const API_KEY = "API_KEY";
const params = new URLSearchParams({
level: "campaign",
ids: "120200000000000001",
startDate: "2026-09-01",
endDate: "2026-09-02",
});
fetch(`https://api.ayrshare.com/api/ads/instagram/insights?${params}`, {
method: "GET",
headers: { Authorization: `Bearer ${API_KEY}` },
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
headers = {'Authorization': 'Bearer API_KEY'}
params = {
'level': 'campaign',
'ids': '120200000000000001',
'startDate': '2026-09-01',
'endDate': '2026-09-02',
}
r = requests.get('https://api.ayrshare.com/api/ads/instagram/insights', headers=headers, params=params)
print(r.json())
{
"status": "success",
"platform": "instagram",
"level": "campaign",
"startDate": "2026-09-01",
"endDate": "2026-09-02",
"insights": [
{
"date": "2026-09-01",
"level": "campaign",
"id": "120200000000000001",
"currency": "USD",
"spend": 12.34,
"impressions": 4000,
"reach": 3100,
"clicks": 80,
"cpm": 3.085,
"cpc": 0.15425,
"ctr": 2,
"actions": [
{ "type": "link_click", "value": 75 },
{ "type": "omni_purchase", "value": 3 }
],
"conversionValue": 89.97
}
],
"count": 1,
"nextCursor": null
}
{
"status": "success",
"platform": "instagram",
"level": "ad",
"startDate": "2026-09-01",
"endDate": "2026-09-01",
"insights": [
{
"date": "2026-09-01",
"level": "ad",
"id": "120210000000000001",
"age": "25-34",
"gender": "female",
"currency": "EUR",
"spend": 1.5,
"impressions": 300
},
{
"date": "2026-09-01",
"level": "ad",
"id": "120210000000000001",
"age": "25-34",
"gender": "male",
"currency": "EUR",
"spend": 1,
"impressions": 200
}
],
"count": 2,
"nextCursor": null
}
{
"action": "ads",
"status": "error",
"code": 400,
"message": "The ad is not found or not authorized."
}