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
Campañas
Obtener campañas publicitarias de 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."
}
Recupera las campañas publicitarias de una cuenta publicitaria específica de Facebook. Este endpoint proporciona información detallada sobre las campañas, incluyendo presupuesto, estado, métricas de rendimiento y detalles de programación.
- El estado de la campaña puede ser uno de: “ACTIVE”, “PAUSED”, “DELETED”, “ARCHIVED”, “IN_PROCESS” o “WITH_ISSUES”.
- El objeto
metricscontiene los datos de rendimiento de la campaña. - El campo
budgetRemainingrepresenta el presupuesto restante en la moneda de la cuenta. - Los resultados se almacenan en caché durante 10 minutos para optimizar el rendimiento.
Parámetros del encabezado
Parámetros de consulta
string
requerido
El ID de la cuenta publicitaria para la cual recuperar las campañas.El ID de la cuenta publicitaria, con o sin el prefijo
act_ (1234567890 o act_1234567890).number
predeterminado:100
Limita el número de campañas devueltas.
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."
}