curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/instagram/campaigns?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/campaigns?accountId=1234567890', headers=headers)
print(r.json())
<?php
$apiKey = "API_KEY";
$url = "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890";
$options = [
'http' => [
'header' => "Authorization: Bearer " . $apiKey,
'method' => 'GET'
]
];
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$result = json_decode($response, true);
print_r($result);
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
string apiKey = "API_KEY";
string url = "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890";
using (HttpClient client = new HttpClient())
{
client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
HttpResponseMessage response = await client.GetAsync(url);
string content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
apiKey := "API_KEY"
url := "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer " + apiKey)
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
public static void main(String[] args) {
try {
String apiKey = "API_KEY";
URL url = new URL("https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Authorization", "Bearer " + apiKey);
BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'uri'
require 'json'
api_key = "API_KEY"
uri = URI.parse("https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890")
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 JSON.parse(response.body)
{
"status": "success",
"campaigns": [
{
"accountId": "8501481455633",
"boostedObjectId": "67263320208733",
"budgetRemaining": 0,
"buyingType": "AUCTION",
"campaignId": "1202176707545833",
"configuredStatus": "ACTIVE",
"created": "2025-03-26T19:42:43-0400",
"dailyBudget": 0,
"effectiveStatus": "ACTIVE",
"endDate": "2026-03-28T18:30:00-0400",
"lifetimeBudget": 0,
"metrics": {},
"name": "API Post - DE6gpw8kxlonHy6eb33 - 2025-03-26T23:42:43",
"spendCap": 0,
"startDate": "2026-03-26T18:30:00-0400",
"status": "ACTIVE"
}
],
"count": 1,
"lastUpdated": "2025-03-27T00:57:15.339Z",
"nextUpdate": "2025-03-27T01:08:15.339Z"
}
{
"action": "get ad campaigns",
"status": "error",
"code": 367,
"message": "Error getting ad campaigns. Please verify you have an active ad campaign account."
}
Instagram Ads
广告活动
获取 Instagram 广告活动
GET
/
ads
/
instagram
/
campaigns
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/instagram/campaigns?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/campaigns?accountId=1234567890', headers=headers)
print(r.json())
<?php
$apiKey = "API_KEY";
$url = "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890";
$options = [
'http' => [
'header' => "Authorization: Bearer " . $apiKey,
'method' => 'GET'
]
];
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$result = json_decode($response, true);
print_r($result);
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
string apiKey = "API_KEY";
string url = "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890";
using (HttpClient client = new HttpClient())
{
client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
HttpResponseMessage response = await client.GetAsync(url);
string content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
apiKey := "API_KEY"
url := "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer " + apiKey)
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
public static void main(String[] args) {
try {
String apiKey = "API_KEY";
URL url = new URL("https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Authorization", "Bearer " + apiKey);
BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'uri'
require 'json'
api_key = "API_KEY"
uri = URI.parse("https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890")
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 JSON.parse(response.body)
{
"status": "success",
"campaigns": [
{
"accountId": "8501481455633",
"boostedObjectId": "67263320208733",
"budgetRemaining": 0,
"buyingType": "AUCTION",
"campaignId": "1202176707545833",
"configuredStatus": "ACTIVE",
"created": "2025-03-26T19:42:43-0400",
"dailyBudget": 0,
"effectiveStatus": "ACTIVE",
"endDate": "2026-03-28T18:30:00-0400",
"lifetimeBudget": 0,
"metrics": {},
"name": "API Post - DE6gpw8kxlonHy6eb33 - 2025-03-26T23:42:43",
"spendCap": 0,
"startDate": "2026-03-26T18:30:00-0400",
"status": "ACTIVE"
}
],
"count": 1,
"lastUpdated": "2025-03-27T00:57:15.339Z",
"nextUpdate": "2025-03-27T01:08:15.339Z"
}
{
"action": "get ad campaigns",
"status": "error",
"code": 367,
"message": "Error getting ad campaigns. Please verify you have an active ad campaign account."
}
获取指定 Instagram 广告账户下的广告活动。此端点提供活动的详细信息,包括预算、状态、性能指标和排期详情。
accountId参数需要不带 “act_” 前缀的数字 ID- 活动状态可能为以下之一:“ACTIVE”、“PAUSED”、“DELETED”、“ARCHIVED”、“IN_PROCESS” 或 “WITH_ISSUES”
metrics对象包含该活动的表现数据budgetRemaining字段以账户所用货币表示剩余预算- 结果缓存 10 分钟以优化性能
请求头参数
查询参数
number
必填
要获取活动的广告账户 ID。
number
默认值:100
限制返回的活动数量。
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/instagram/campaigns?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/campaigns?accountId=1234567890', headers=headers)
print(r.json())
<?php
$apiKey = "API_KEY";
$url = "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890";
$options = [
'http' => [
'header' => "Authorization: Bearer " . $apiKey,
'method' => 'GET'
]
];
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$result = json_decode($response, true);
print_r($result);
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
string apiKey = "API_KEY";
string url = "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890";
using (HttpClient client = new HttpClient())
{
client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
HttpResponseMessage response = await client.GetAsync(url);
string content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
}
}
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
apiKey := "API_KEY"
url := "https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer " + apiKey)
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class Main {
public static void main(String[] args) {
try {
String apiKey = "API_KEY";
URL url = new URL("https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Authorization", "Bearer " + apiKey);
BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
require 'net/http'
require 'uri'
require 'json'
api_key = "API_KEY"
uri = URI.parse("https://api.ayrshare.com/api/ads/instagram/campaigns?accountId=1234567890")
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 JSON.parse(response.body)
{
"status": "success",
"campaigns": [
{
"accountId": "8501481455633",
"boostedObjectId": "67263320208733",
"budgetRemaining": 0,
"buyingType": "AUCTION",
"campaignId": "1202176707545833",
"configuredStatus": "ACTIVE",
"created": "2025-03-26T19:42:43-0400",
"dailyBudget": 0,
"effectiveStatus": "ACTIVE",
"endDate": "2026-03-28T18:30:00-0400",
"lifetimeBudget": 0,
"metrics": {},
"name": "API Post - DE6gpw8kxlonHy6eb33 - 2025-03-26T23:42:43",
"spendCap": 0,
"startDate": "2026-03-26T18:30:00-0400",
"status": "ACTIVE"
}
],
"count": 1,
"lastUpdated": "2025-03-27T00:57:15.339Z",
"nextUpdate": "2025-03-27T01:08:15.339Z"
}
{
"action": "get ad campaigns",
"status": "error",
"code": 367,
"message": "Error getting ad campaigns. Please verify you have an active ad campaign account."
}