curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music", {
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/interests?search=Rhythm%20and%20blues%20music', headers=headers)
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.GetAsync("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music");
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/facebook/interests?search=Rhythm%20and%20blues%20music", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, _ := client.Do(req)
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 GetAdInterests {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music"))
.header("Authorization", "Bearer API_KEY")
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require 'net/http'
require 'json'
uri = URI('https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music')
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer API_KEY'
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http|
http.request(req)
}
puts res.body
{
"status": "success",
"interests": [
{
"id": "6003195554098",
"name": "Rhythm and blues music",
"topic": "News and entertainment",
"audienceSizeLowerBound": 669180255,
"audienceSizeUpperBound": 786955980
},
{
"id": "6003470511564",
"name": "Do it yourself (DIY)",
"topic": "Hobbies and activities",
"audienceSizeLowerBound": 418387661, // Untere Grenze der Zielgruppengröße
"audienceSizeUpperBound": 492023890 // Obere Grenze der Zielgruppengröße
},
{
"id": "6002926036121",
"name": "Italy",
"topic": "Travel, places and events",
"audienceSizeLowerBound": 279313350, // Untere Grenze der Zielgruppengröße
"audienceSizeUpperBound": 328472500 // Obere Grenze der Zielgruppengröße
}
],
"count": 3,
"lastUpdated": "2025-03-27T01:01:38.547Z",
"nextUpdate": "2025-03-27T01:12:38.547Z"
}
{
"status": "success",
"interests": [
{
"id": "6003269553527",
"name": "Nursing",
"audienceSizeLowerBound": 91340120,
"audienceSizeUpperBound": 107420310
},
{
"id": "6003204427551",
"name": "Health care",
"audienceSizeLowerBound": 412880440,
"audienceSizeUpperBound": 485610770
}
],
"count": 2,
"specialAdCategories": ["EMPLOYMENT"],
"lastUpdated": "2026-09-11T01:01:38.547Z",
"nextUpdate": "2026-09-11T01:12:38.547Z"
}
{
"action": "get ad interests",
"status": "error",
"code": 368,
"message": "Error getting ad interests. Please try again or contact us if the issue persists."
}
Facebook Ads
Interessen
Facebook-Werbe-Interessen abrufen
GET
/
ads
/
facebook
/
interests
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music", {
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/interests?search=Rhythm%20and%20blues%20music', headers=headers)
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.GetAsync("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music");
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/facebook/interests?search=Rhythm%20and%20blues%20music", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, _ := client.Do(req)
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 GetAdInterests {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music"))
.header("Authorization", "Bearer API_KEY")
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require 'net/http'
require 'json'
uri = URI('https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music')
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer API_KEY'
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http|
http.request(req)
}
puts res.body
{
"status": "success",
"interests": [
{
"id": "6003195554098",
"name": "Rhythm and blues music",
"topic": "News and entertainment",
"audienceSizeLowerBound": 669180255,
"audienceSizeUpperBound": 786955980
},
{
"id": "6003470511564",
"name": "Do it yourself (DIY)",
"topic": "Hobbies and activities",
"audienceSizeLowerBound": 418387661, // Untere Grenze der Zielgruppengröße
"audienceSizeUpperBound": 492023890 // Obere Grenze der Zielgruppengröße
},
{
"id": "6002926036121",
"name": "Italy",
"topic": "Travel, places and events",
"audienceSizeLowerBound": 279313350, // Untere Grenze der Zielgruppengröße
"audienceSizeUpperBound": 328472500 // Obere Grenze der Zielgruppengröße
}
],
"count": 3,
"lastUpdated": "2025-03-27T01:01:38.547Z",
"nextUpdate": "2025-03-27T01:12:38.547Z"
}
{
"status": "success",
"interests": [
{
"id": "6003269553527",
"name": "Nursing",
"audienceSizeLowerBound": 91340120,
"audienceSizeUpperBound": 107420310
},
{
"id": "6003204427551",
"name": "Health care",
"audienceSizeLowerBound": 412880440,
"audienceSizeUpperBound": 485610770
}
],
"count": 2,
"specialAdCategories": ["EMPLOYMENT"],
"lastUpdated": "2026-09-11T01:01:38.547Z",
"nextUpdate": "2026-09-11T01:12:38.547Z"
}
{
"action": "get ad interests",
"status": "error",
"code": 368,
"message": "Error getting ad interests. Please try again or contact us if the issue persists."
}
Suchen Sie nach verfügbaren Interessen für das Facebook-Werbe-Targeting mit einem Schlüsselwort.
Verwenden Sie diesen Endpunkt, um Interessen-IDs für den Endpunkt Beitrag bewerben nachzuschlagen.
Dieser Endpunkt hilft Ihnen dabei, interessenbasierte Targeting-Optionen für Ihre Facebook-Anzeigen zusammen mit Schätzungen der Zielgruppengröße zu entdecken.
- Interessen-IDs können im Array
interestsbeim Bewerben von Beiträgen verwendet werden. - Ergebnisse werden 10 Minuten zwischengespeichert.
- Verwenden Sie spezifische, relevante Suchbegriffe für die besten Ergebnisse.
- Facebook kann je nach Branche und Region Ihres Werbekontos unterschiedliche Ergebnisse zurückgeben.
- Die Felder
audienceSizeLowerBoundundaudienceSizeUpperBoundin der JSON-Antwort geben einen geschätzten Bereich der Zielgruppengröße für das Interesse an und sind für das Targeting nützlich. - Verwenden Sie
specialAdCategories, um nur die Interessen zurückzugeben, die Meta für eine Kampagne in einer speziellen Anzeigenkategorie zulässt. Gefilterte Anfragen erfordern zusätzlichaccountId.
Header-Parameter
Query-Parameter
string
erforderlich
Die Suchanfrage zum Abrufen von Facebook-Werbe-Interessen.Vergessen Sie nicht, die Suchanfrage zu maskieren, zum Beispiel
Rhythm%20and%20blues%20music.array
Beschränken Sie die Ergebnisse auf die Interessen, die Meta einer Kampagne in einer speziellen Anzeigenkategorie als Targeting erlaubt. Verwenden Sie dies, bevor Sie einen Beitrag zu Wohnen, Beschäftigung, Finanzen oder Politik bewerben, damit Sie Interessen-IDs auswählen, für die die Anzeige tatsächlich freigegeben wird.Die folgenden Werte werden unterstützt und entsprechen dem gleichnamigen Parameter von Beitrag bewerben:
housingemploymentfinancial_product_services–financial_products_servicesundcreditwerden als gleichwertig akzeptiert und derselben Kategorie zugeordnetissues_elections_politicsnone– wird aus Symmetrie zu Beitrag bewerben akzeptiert, wo es „in keiner speziellen Anzeigenkategorie“ bedeutet. Es wird alsregulated_categories=["NONE"]an Meta gesendet:accountIdist erforderlich, und eine erfolgreiche Antwort gibt["NONE"]zurück. Das garantiert nicht dieselben Ergebnisse wie eine ungefilterte Suche; eine Ablehnung durch Meta gibtcode: 368zurück. Lassen SiespecialAdCategoriesganz weg, stattnonezu senden, wenn Sie eine gewöhnliche ungefilterte Suche wünschen.
400 und code: 101 abgelehnt, der die akzeptierten Werte auflistet. Diese Meldung ist in Metas Großschreibung verfasst und nennt auch die oben genannten alternativen Schreibweisen; sie lautet daher NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT – dieselben hier aufgeführten Kategorien, keine zusätzlichen. Beitrag bewerben gibt die identische Meldung zurück. Ein leerer Wert, wie in ?specialAdCategories=, wird auf dieselbe Weise abgelehnt.Übergeben Sie mehrere Kategorien, indem Sie den Parameter wiederholen, zum Beispiel ?search=nursing&specialAdCategories=employment&specialAdCategories=housing. Die Klammerform ?specialAdCategories[]=employment&specialAdCategories[]=housing funktioniert ebenfalls. Ein kommagetrennter String wie ?specialAdCategories=employment,housing wird nicht unterstützt und mit einem 400 und code: 101 abgelehnt. Alle angeforderten Kategorien werden in einer einzigen Suche an Meta gesendet. Ayrshare gibt Metas Ergebnisse zurück und berechnet oder garantiert keine Schnittmenge unabhängig voneinander zulässiger Interessen. Eine Kategorie zu wiederholen oder zwei Schreibweisen derselben Kategorie zu senden, wird zu einer einzigen Kategorie zusammengefasst.Wenn Sie mehr als eine Kategorie angeben, wird das in der Antwort zurückgegebene Feld specialAdCategories alphabetisch sortiert und nicht in der von Ihnen gesendeten Reihenfolge zurückgegeben.Lassen Sie specialAdCategories ganz weg, und der Endpunkt verhält sich exakt wie zuvor: eine ungefilterte Suche, kein accountId erforderlich und dieselbe Antwortstruktur.string
Erforderlich, wenn
specialAdCategories angegeben ist, andernfalls ignoriert. Die ID des
Facebook-Werbekontos, für das die Interessen gesucht werden, ohne das Präfix act_ – derselbe
Wert, den Beitrag bewerben entgegennimmt. Sie können sie über den
Werbekonten-Endpunkt abrufen. Sie muss numerisch sein; ein
vorangestelltes act_ wird akzeptiert und entfernt, alles andere wird mit einem 400 und
code: 101 abgelehnt.Meta bietet die kategoriebezogene Interessensuche nur auf einem Werbekonto an, daher wird eine
Anfrage, die
specialAdCategories ohne accountId angibt, mit einem 400 und code: 101
abgelehnt, bevor eine Suche ausgeführt wird. Eine Anfrage ohne specialAdCategories ist
unverändert und benötigt weiterhin kein accountId.number
Standard:100
Begrenzt die Anzahl der zurückgegebenen Werbe-Interessen.
Eine gefilterte Antwort gibt die angewendeten Kategorien im Feld
specialAdCategories zurück,
sodass Sie überprüfen können, worauf die Ergebnisse eingegrenzt wurden. Eine ungefilterte Antwort
lässt dieses Feld vollständig weg, statt es leer zurückzugeben. Gefilterte Ergebnisse lassen
außerdem das Feld topic bei jedem Interesse weg, weil Metas kategoriebezogene Suche es nicht
zurückgibt – lesen Sie stattdessen name. Eine Suche ohne zulässige Interessen gibt 200 mit
einem leeren interests-Array und count: 0 zurück, keinen Fehler, und eine gefilterte Suche
fällt nie auf ungefilterte Ergebnisse zurück.curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music", {
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/interests?search=Rhythm%20and%20blues%20music', headers=headers)
print(r.json())
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer API_KEY"
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer API_KEY");
var response = await client.GetAsync("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music");
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/facebook/interests?search=Rhythm%20and%20blues%20music", nil)
req.Header.Add("Authorization", "Bearer API_KEY")
resp, _ := client.Do(req)
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 GetAdInterests {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music"))
.header("Authorization", "Bearer API_KEY")
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
require 'net/http'
require 'json'
uri = URI('https://api.ayrshare.com/api/ads/facebook/interests?search=Rhythm%20and%20blues%20music')
req = Net::HTTP::Get.new(uri)
req['Authorization'] = 'Bearer API_KEY'
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http|
http.request(req)
}
puts res.body
{
"status": "success",
"interests": [
{
"id": "6003195554098",
"name": "Rhythm and blues music",
"topic": "News and entertainment",
"audienceSizeLowerBound": 669180255,
"audienceSizeUpperBound": 786955980
},
{
"id": "6003470511564",
"name": "Do it yourself (DIY)",
"topic": "Hobbies and activities",
"audienceSizeLowerBound": 418387661, // Untere Grenze der Zielgruppengröße
"audienceSizeUpperBound": 492023890 // Obere Grenze der Zielgruppengröße
},
{
"id": "6002926036121",
"name": "Italy",
"topic": "Travel, places and events",
"audienceSizeLowerBound": 279313350, // Untere Grenze der Zielgruppengröße
"audienceSizeUpperBound": 328472500 // Obere Grenze der Zielgruppengröße
}
],
"count": 3,
"lastUpdated": "2025-03-27T01:01:38.547Z",
"nextUpdate": "2025-03-27T01:12:38.547Z"
}
{
"status": "success",
"interests": [
{
"id": "6003269553527",
"name": "Nursing",
"audienceSizeLowerBound": 91340120,
"audienceSizeUpperBound": 107420310
},
{
"id": "6003204427551",
"name": "Health care",
"audienceSizeLowerBound": 412880440,
"audienceSizeUpperBound": 485610770
}
],
"count": 2,
"specialAdCategories": ["EMPLOYMENT"],
"lastUpdated": "2026-09-11T01:01:38.547Z",
"nextUpdate": "2026-09-11T01:12:38.547Z"
}
{
"action": "get ad interests",
"status": "error",
"code": 368,
"message": "Error getting ad interests. Please try again or contact us if the issue persists."
}