curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/instagram/history?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/instagram/history?accountId=1234567890", {
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'}
r = requests.get('https://api.ayrshare.com/api/ads/instagram/history', headers=headers)
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/instagram/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.GetAsync("https://api.ayrshare.com/api/ads/instagram/history");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://api.ayrshare.com/api/ads/instagram/history", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/instagram/history"))
.header("Authorization", "Bearer API_KEY")
.GET()
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/instagram/history')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"history": [
{
"adId": "6683876017501",
"adName": "API Post 1 - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 3,
"impressions": 1035,
"reach": 1026,
"frequency": 0,
"ctr": 0.29,
"cpm": 1.53,
"cpp": 1.54,
"cpc": 0.53
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7L1",
"spend": 1.58,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"accountId": "274948332"
},
{
"adId": "120218167147110411",
"adName": "API Post 2 - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T16:41:15",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 4,
"impressions": 1036,
"reach": 1011,
"frequency": 0,
"ctr": 0.39,
"cpm": 1.61,
"cpp": 1.65,
"cpc": 0.42
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7L1",
"spend": 1.67,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"accountId": "274948332"
}
],
"dateRange": {
"start": "2025-03-04T18:49:18.159Z",
"end": "2025-04-03T18:49:18.159Z"
},
"metrics": {
"totalSpend": 3.25,
"totalClicks": 7,
"totalImpressions": 2071,
"totalReach": 2037,
"averageCTR": 0.34,
"averageFrequency": 0.0,
"cpm": 1.57,
"cpp": 1.6,
"cpc": 0.46,
"costPerResult": 0.46,
"byGoalType": {
"engagement": {
"spend": 3.25,
"impressions": 2071,
"clicks": 7,
"reach": 2037,
"count": 2,
"ctr": 0.3380009657170449,
"cpm": 1.5692901979719942,
"cpp": 1.5954835542464407,
"cpc": 0.4642857142857143
}
},
"byGoalTitle": {
"Get More Engagement": {
"spend": 3.25,
"impressions": 2071,
"clicks": 7,
"reach": 2037,
"count": 2,
"ctr": 0.3380009657170449,
"cpm": 1.5692901979719942,
"cpp": 1.5954835542464407,
"cpc": 0.4642857142857143,
"type": "engagement"
}
},
"goalPerformance": {
"bestPerformingGoalType": {
"type": "engagement",
"clicks": 7,
"spend": 3.25,
"ctr": 0.34
},
"mostEfficientGoalType": {
"type": "engagement",
"cpc": 0.46,
"spend": 3.25
}
},
"count": 2,
"firstDay": "2025-04-02T00:00:00.000Z",
"lastDay": "2025-04-02T00:00:00.000Z"
}
}
{
"status": "success",
"history": [
{
"accountId": "274948332",
"adId": "6683876017505",
"adName": "API Post 13 - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "",
"deliveryStatus": "ACTIVE",
"socialPostId": "17890000000000001",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 2,
"cpc": 0.35,
"cpp": 1.6,
"cpm": 1.55,
"ctr": 0.44,
"frequency": 0,
"impressions": 452,
"reach": 438
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7Lo",
"spend": 0.7,
"spendDate": "2025-04-03T00:00:00.000Z",
"status": "ACTIVE",
"igPostId": "17890000000000001"
},
{
"accountId": "274948332",
"adId": "6683876017505",
"adName": "API Post 13 - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"socialPostId": "17890000000000001",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 1,
"cpc": 4.19,
"cpp": 1.5,
"cpm": 1.5,
"ctr": 0.04,
"frequency": 0,
"impressions": 2793,
"reach": 2793
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7Lo",
"spend": 4.19,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"igPostId": "17890000000000001"
}
],
"dateRange": {
"start": "2025-03-04T18:49:18.159Z",
"end": "2025-04-03T18:49:18.159Z",
"adId": "6683876017505"
},
"metrics": {
"totalSpend": 4.89,
"totalClicks": 3,
"totalImpressions": 3245,
"totalReach": 3231,
"averageCTR": 0.09,
"averageFrequency": 0.0,
"cpm": 1.51,
"cpp": 1.51,
"cpc": 1.63,
"costPerResult": 1.63,
"byGoalType": {
"engagement": {
"spend": 4.890000000000001,
"impressions": 3245,
"clicks": 3,
"reach": 3231,
"count": 2,
"ctr": 0.09244992295839753,
"cpm": 1.50693374422188,
"cpp": 1.5134633240482824,
"cpc": 1.6300000000000001
}
},
"byGoalTitle": {
"Get More Engagement": {
"spend": 4.890000000000001,
"impressions": 3245,
"clicks": 3,
"reach": 3231,
"count": 2,
"ctr": 0.09244992295839753,
"cpm": 1.50693374422188,
"cpp": 1.5134633240482824,
"cpc": 1.6300000000000001,
"type": "engagement"
}
},
"goalPerformance": {
"bestPerformingGoalType": {
"type": "engagement",
"clicks": 3,
"spend": 4.89,
"ctr": 0.09
},
"mostEfficientGoalType": {
"type": "engagement",
"cpc": 1.63,
"spend": 4.89
}
},
"count": 2,
"firstDay": "2025-04-02T00:00:00.000Z",
"lastDay": "2025-04-03T00:00:00.000Z"
}
}
{
"action": "ads",
"status": "error",
"code": 370,
"message": "Error getting ads. Please try again or contact us if the issue persists.",
"details": "Error retrieving ads spend data"
}
Instagram Ads
歷史記錄
獲取每日 Instagram 廣告支出與分析歷史資料
GET
/
ads
/
instagram
/
history
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/instagram/history?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/instagram/history?accountId=1234567890", {
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'}
r = requests.get('https://api.ayrshare.com/api/ads/instagram/history', headers=headers)
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/instagram/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.GetAsync("https://api.ayrshare.com/api/ads/instagram/history");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://api.ayrshare.com/api/ads/instagram/history", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/instagram/history"))
.header("Authorization", "Bearer API_KEY")
.GET()
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/instagram/history')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"history": [
{
"adId": "6683876017501",
"adName": "API Post 1 - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 3,
"impressions": 1035,
"reach": 1026,
"frequency": 0,
"ctr": 0.29,
"cpm": 1.53,
"cpp": 1.54,
"cpc": 0.53
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7L1",
"spend": 1.58,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"accountId": "274948332"
},
{
"adId": "120218167147110411",
"adName": "API Post 2 - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T16:41:15",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 4,
"impressions": 1036,
"reach": 1011,
"frequency": 0,
"ctr": 0.39,
"cpm": 1.61,
"cpp": 1.65,
"cpc": 0.42
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7L1",
"spend": 1.67,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"accountId": "274948332"
}
],
"dateRange": {
"start": "2025-03-04T18:49:18.159Z",
"end": "2025-04-03T18:49:18.159Z"
},
"metrics": {
"totalSpend": 3.25,
"totalClicks": 7,
"totalImpressions": 2071,
"totalReach": 2037,
"averageCTR": 0.34,
"averageFrequency": 0.0,
"cpm": 1.57,
"cpp": 1.6,
"cpc": 0.46,
"costPerResult": 0.46,
"byGoalType": {
"engagement": {
"spend": 3.25,
"impressions": 2071,
"clicks": 7,
"reach": 2037,
"count": 2,
"ctr": 0.3380009657170449,
"cpm": 1.5692901979719942,
"cpp": 1.5954835542464407,
"cpc": 0.4642857142857143
}
},
"byGoalTitle": {
"Get More Engagement": {
"spend": 3.25,
"impressions": 2071,
"clicks": 7,
"reach": 2037,
"count": 2,
"ctr": 0.3380009657170449,
"cpm": 1.5692901979719942,
"cpp": 1.5954835542464407,
"cpc": 0.4642857142857143,
"type": "engagement"
}
},
"goalPerformance": {
"bestPerformingGoalType": {
"type": "engagement",
"clicks": 7,
"spend": 3.25,
"ctr": 0.34
},
"mostEfficientGoalType": {
"type": "engagement",
"cpc": 0.46,
"spend": 3.25
}
},
"count": 2,
"firstDay": "2025-04-02T00:00:00.000Z",
"lastDay": "2025-04-02T00:00:00.000Z"
}
}
{
"status": "success",
"history": [
{
"accountId": "274948332",
"adId": "6683876017505",
"adName": "API Post 13 - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "",
"deliveryStatus": "ACTIVE",
"socialPostId": "17890000000000001",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 2,
"cpc": 0.35,
"cpp": 1.6,
"cpm": 1.55,
"ctr": 0.44,
"frequency": 0,
"impressions": 452,
"reach": 438
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7Lo",
"spend": 0.7,
"spendDate": "2025-04-03T00:00:00.000Z",
"status": "ACTIVE",
"igPostId": "17890000000000001"
},
{
"accountId": "274948332",
"adId": "6683876017505",
"adName": "API Post 13 - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"socialPostId": "17890000000000001",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 1,
"cpc": 4.19,
"cpp": 1.5,
"cpm": 1.5,
"ctr": 0.04,
"frequency": 0,
"impressions": 2793,
"reach": 2793
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7Lo",
"spend": 4.19,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"igPostId": "17890000000000001"
}
],
"dateRange": {
"start": "2025-03-04T18:49:18.159Z",
"end": "2025-04-03T18:49:18.159Z",
"adId": "6683876017505"
},
"metrics": {
"totalSpend": 4.89,
"totalClicks": 3,
"totalImpressions": 3245,
"totalReach": 3231,
"averageCTR": 0.09,
"averageFrequency": 0.0,
"cpm": 1.51,
"cpp": 1.51,
"cpc": 1.63,
"costPerResult": 1.63,
"byGoalType": {
"engagement": {
"spend": 4.890000000000001,
"impressions": 3245,
"clicks": 3,
"reach": 3231,
"count": 2,
"ctr": 0.09244992295839753,
"cpm": 1.50693374422188,
"cpp": 1.5134633240482824,
"cpc": 1.6300000000000001
}
},
"byGoalTitle": {
"Get More Engagement": {
"spend": 4.890000000000001,
"impressions": 3245,
"clicks": 3,
"reach": 3231,
"count": 2,
"ctr": 0.09244992295839753,
"cpm": 1.50693374422188,
"cpp": 1.5134633240482824,
"cpc": 1.6300000000000001,
"type": "engagement"
}
},
"goalPerformance": {
"bestPerformingGoalType": {
"type": "engagement",
"clicks": 3,
"spend": 4.89,
"ctr": 0.09
},
"mostEfficientGoalType": {
"type": "engagement",
"cpc": 1.63,
"spend": 4.89
}
},
"count": 2,
"firstDay": "2025-04-02T00:00:00.000Z",
"lastDay": "2025-04-03T00:00:00.000Z"
}
}
{
"action": "ads",
"status": "error",
"code": 370,
"message": "Error getting ads. Please try again or contact us if the issue persists.",
"details": "Error retrieving ads spend data"
}
獲取 Instagram 廣告的每日廣告支出和表現指標詳情。
此端點提供全面的廣告分析資料，包括按日細分、按目標劃分的表現以及聚合指標。
history 陣列包含每條廣告的每日歷史支出與表現指標。資料截止於美東時間上午 8 點。
如果需要即時支出資料，或尚未產生支出，請使用 ads 端點。如果沒有可用的支出資料或尚未產生支出，則不會返回該廣告。- 指標是透過 Instagram 的報表 API 計算得出，可能存在輕微延遲（最長 24 小時）。
byGoalType和byGoalTitle部分按目標（objective）對表現指標進行分組。- 使用
adId或postId過濾器可將結果限定到特定的活動。 - 所有貨幣金額均以廣告帳戶的貨幣顯示（通常為 USD）。
goalPerformance部分會突出顯示表現最佳的廣告目標。
請求頭參數
查詢參數
number
將結果過濾到特定帳戶 ID。
string
將結果過濾到特定廣告 ID。
string
將結果過濾到與特定 Ayrshare 貼文 ID 相關聯的廣告。
string
將結果過濾到與特定 Instagram 社群貼文 ID 相關聯的廣告。
number
預設值:25
最多獲取
limit 條廣告。最大值為 300；更高的值會被限制為 300。string
預設值:"30 days ago"
報告期的開始日期，採用 ISO 8601 格式（預設：30 天前）
string
預設值:"today"
報告期的結束日期，採用 ISO 8601 格式（預設：今天）
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/instagram/history?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/instagram/history?accountId=1234567890", {
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'}
r = requests.get('https://api.ayrshare.com/api/ads/instagram/history', headers=headers)
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/instagram/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error: " . $err;
} else {
echo $response;
}
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.GetAsync("https://api.ayrshare.com/api/ads/instagram/history");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://api.ayrshare.com/api/ads/instagram/history", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAdSpend {
public static void main(String[] args) {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/instagram/history"))
.header("Authorization", "Bearer API_KEY")
.GET()
.build();
try {
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'json'
require 'uri'
uri = URI.parse('https://api.ayrshare.com/api/ads/instagram/history')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body
{
"status": "success",
"history": [
{
"adId": "6683876017501",
"adName": "API Post 1 - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 3,
"impressions": 1035,
"reach": 1026,
"frequency": 0,
"ctr": 0.29,
"cpm": 1.53,
"cpp": 1.54,
"cpc": 0.53
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7L1",
"spend": 1.58,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"accountId": "274948332"
},
{
"adId": "120218167147110411",
"adName": "API Post 2 - DE6gpw8kxlonHy6eb7L1 - 2025-03-30T16:41:15",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 4,
"impressions": 1036,
"reach": 1011,
"frequency": 0,
"ctr": 0.39,
"cpm": 1.61,
"cpp": 1.65,
"cpc": 0.42
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7L1",
"spend": 1.67,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"accountId": "274948332"
}
],
"dateRange": {
"start": "2025-03-04T18:49:18.159Z",
"end": "2025-04-03T18:49:18.159Z"
},
"metrics": {
"totalSpend": 3.25,
"totalClicks": 7,
"totalImpressions": 2071,
"totalReach": 2037,
"averageCTR": 0.34,
"averageFrequency": 0.0,
"cpm": 1.57,
"cpp": 1.6,
"cpc": 0.46,
"costPerResult": 0.46,
"byGoalType": {
"engagement": {
"spend": 3.25,
"impressions": 2071,
"clicks": 7,
"reach": 2037,
"count": 2,
"ctr": 0.3380009657170449,
"cpm": 1.5692901979719942,
"cpp": 1.5954835542464407,
"cpc": 0.4642857142857143
}
},
"byGoalTitle": {
"Get More Engagement": {
"spend": 3.25,
"impressions": 2071,
"clicks": 7,
"reach": 2037,
"count": 2,
"ctr": 0.3380009657170449,
"cpm": 1.5692901979719942,
"cpp": 1.5954835542464407,
"cpc": 0.4642857142857143,
"type": "engagement"
}
},
"goalPerformance": {
"bestPerformingGoalType": {
"type": "engagement",
"clicks": 7,
"spend": 3.25,
"ctr": 0.34
},
"mostEfficientGoalType": {
"type": "engagement",
"cpc": 0.46,
"spend": 3.25
}
},
"count": 2,
"firstDay": "2025-04-02T00:00:00.000Z",
"lastDay": "2025-04-02T00:00:00.000Z"
}
}
{
"status": "success",
"history": [
{
"accountId": "274948332",
"adId": "6683876017505",
"adName": "API Post 13 - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "",
"deliveryStatus": "ACTIVE",
"socialPostId": "17890000000000001",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 2,
"cpc": 0.35,
"cpp": 1.6,
"cpm": 1.55,
"ctr": 0.44,
"frequency": 0,
"impressions": 452,
"reach": 438
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7Lo",
"spend": 0.7,
"spendDate": "2025-04-03T00:00:00.000Z",
"status": "ACTIVE",
"igPostId": "17890000000000001"
},
{
"accountId": "274948332",
"adId": "6683876017505",
"adName": "API Post 13 - DE6gpw8kxlonHy6eb7Lo - 2025-03-30T17:11:26",
"budgetDaily": 4,
"budgetType": "daily",
"deliveryStatus": "ACTIVE",
"socialPostId": "17890000000000001",
"goal": {
"description": "This goal seeks to increase engagement while ensuring that the ad reaches the maximum number of unique users. It balances visibility with engagement, showing the ad to as many different people as possible who may interact with it.",
"title": "Get More Engagement",
"type": "engagement"
},
"isActive": true,
"isComplete": false,
"metrics": {
"clicks": 1,
"cpc": 4.19,
"cpp": 1.5,
"cpm": 1.5,
"ctr": 0.04,
"frequency": 0,
"impressions": 2793,
"reach": 2793
},
"network": "instagram",
"postId": "DE6gpw8kxlonHy6eb7Lo",
"spend": 4.19,
"spendDate": "2025-04-02T00:00:00.000Z",
"status": "ACTIVE",
"igPostId": "17890000000000001"
}
],
"dateRange": {
"start": "2025-03-04T18:49:18.159Z",
"end": "2025-04-03T18:49:18.159Z",
"adId": "6683876017505"
},
"metrics": {
"totalSpend": 4.89,
"totalClicks": 3,
"totalImpressions": 3245,
"totalReach": 3231,
"averageCTR": 0.09,
"averageFrequency": 0.0,
"cpm": 1.51,
"cpp": 1.51,
"cpc": 1.63,
"costPerResult": 1.63,
"byGoalType": {
"engagement": {
"spend": 4.890000000000001,
"impressions": 3245,
"clicks": 3,
"reach": 3231,
"count": 2,
"ctr": 0.09244992295839753,
"cpm": 1.50693374422188,
"cpp": 1.5134633240482824,
"cpc": 1.6300000000000001
}
},
"byGoalTitle": {
"Get More Engagement": {
"spend": 4.890000000000001,
"impressions": 3245,
"clicks": 3,
"reach": 3231,
"count": 2,
"ctr": 0.09244992295839753,
"cpm": 1.50693374422188,
"cpp": 1.5134633240482824,
"cpc": 1.6300000000000001,
"type": "engagement"
}
},
"goalPerformance": {
"bestPerformingGoalType": {
"type": "engagement",
"clicks": 3,
"spend": 4.89,
"ctr": 0.09
},
"mostEfficientGoalType": {
"type": "engagement",
"cpc": 1.63,
"spend": 4.89
}
},
"count": 2,
"firstDay": "2025-04-02T00:00:00.000Z",
"lastDay": "2025-04-03T00:00:00.000Z"
}
}
{
"action": "ads",
"status": "error",
"code": 370,
"message": "Error getting ads. Please try again or contact us if the issue persists.",
"details": "Error retrieving ads spend data"
}