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."
}