curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/campaigns?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/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/facebook/campaigns?accountId=1234567890', headers=headers)
print(r.json())
<?php
$apiKey = "API_KEY";
$url = "https://api.ayrshare.com/api/ads/facebook/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/facebook/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/facebook/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/facebook/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/facebook/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": "PAUSED",
"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."
}
Facebook Ads
Chiến dịch
Lấy các Chiến dịch Quảng cáo Facebook
GET
/
ads
/
facebook
/
campaigns
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/campaigns?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/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/facebook/campaigns?accountId=1234567890', headers=headers)
print(r.json())
<?php
$apiKey = "API_KEY";
$url = "https://api.ayrshare.com/api/ads/facebook/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/facebook/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/facebook/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/facebook/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/facebook/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": "PAUSED",
"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."
}
Lấy các chiến dịch quảng cáo cho một tài khoản quảng cáo Facebook cụ thể. Endpoint này cung cấp thông tin chi tiết về các chiến dịch, bao gồm ngân sách, trạng thái, chỉ số hiệu suất và thông tin lịch trình.
- Trạng thái chiến dịch có thể là một trong: “ACTIVE”, “PAUSED”, “DELETED”, “ARCHIVED”, “IN_PROCESS”, hoặc “WITH_ISSUES”.
- Đối tượng
metricschứa dữ liệu hiệu suất cho chiến dịch. - Trường
budgetRemainingbiểu thị ngân sách còn lại theo đơn vị tiền tệ của tài khoản. - Kết quả được cache trong 10 phút để tối ưu hóa hiệu suất.
Tham số Header
Tham số Query
string
bắt buộc
ID của tài khoản quảng cáo để lấy các chiến dịch.ID tài khoản quảng cáo, có hoặc không có tiền tố
act_ (1234567890 hoặc act_1234567890).number
mặc định:100
Giới hạn số lượng chiến dịch được trả về.
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/campaigns?accountId=1234567890
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/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/facebook/campaigns?accountId=1234567890', headers=headers)
print(r.json())
<?php
$apiKey = "API_KEY";
$url = "https://api.ayrshare.com/api/ads/facebook/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/facebook/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/facebook/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/facebook/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/facebook/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": "PAUSED",
"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."
}