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, // Lower bound of audience size
"audienceSizeUpperBound": 492023890 // Upper bound of audience size
},
{
"id": "6002926036121",
"name": "Italy",
"topic": "Travel, places and events",
"audienceSizeLowerBound": 279313350, // Lower bound of audience size
"audienceSizeUpperBound": 328472500 // Upper bound of audience size
}
],
"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
रुचियाँ
Facebook Ad रुचियाँ प्राप्त करें
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, // Lower bound of audience size
"audienceSizeUpperBound": 492023890 // Upper bound of audience size
},
{
"id": "6002926036121",
"name": "Italy",
"topic": "Travel, places and events",
"audienceSizeLowerBound": 279313350, // Lower bound of audience size
"audienceSizeUpperBound": 328472500 // Upper bound of audience size
}
],
"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 विज्ञापन टार्गेटिंग रुचियों की खोज करें।
Boost Post एंडपॉइंट के लिए रुचि ID देखने हेतु इस एंडपॉइंट का उपयोग करें।
यह एंडपॉइंट आपको आपके Facebook विज्ञापनों के लिए रुचि-आधारित टार्गेटिंग विकल्पों की खोज करने में मदद करता है, साथ ही ऑडियंस आकार अनुमानों के साथ।
- पोस्ट को बूस्ट करते समय
interestsarray में रुचि ID का उपयोग किया जा सकता है। - परिणाम 10 मिनट के लिए कैश किए जाते हैं।
- सर्वोत्तम परिणामों के लिए विशिष्ट, प्रासंगिक खोज शब्दों का उपयोग करें।
- Facebook आपके विज्ञापन खाते के उद्योग और क्षेत्र के आधार पर अलग-अलग परिणाम लौटा सकता है।
- JSON प्रतिक्रिया में
audienceSizeLowerBoundऔरaudienceSizeUpperBoundफ़ील्ड रुचि के लिए ऑडियंस आकार की अनुमानित सीमा प्रदान करते हैं और यह टार्गेटिंग के लिए उपयोगी है। - केवल वे रुचियाँ लौटाने के लिए जिन्हें Meta किसी special ad
category campaign के लिए अनुमति देता
है,
specialAdCategoriesका उपयोग करें। Filtered अनुरोधों के लिएaccountIdभी आवश्यक है।
Header Parameters
Query Parameters
string
आवश्यक
Facebook विज्ञापन रुचियाँ प्राप्त करने के लिए खोज क्वेरी।खोज क्वेरी को एस्केप करना न भूलें, उदाहरण के लिए
Rhythm%20and%20blues%20music।array
परिणामों को उन रुचियों तक सीमित करें जिन्हें Meta किसी special ad category campaign को टार्गेट करने की अनुमति देता है। किसी housing, employment, financial, या political पोस्ट को boost करने से पहले इसका उपयोग करें, ताकि आप ऐसी रुचि ID चुनें जिनके लिए ad वास्तव में approve किया जाएगा।निम्नलिखित मान समर्थित हैं, जो Boost Post के इसी नाम के पैरामीटर से मेल खाते हैं:
housingemploymentfinancial_product_services—financial_products_servicesऔरcreditसमतुल्य के रूप में स्वीकार किए जाते हैं और एक ही श्रेणी में resolve होते हैंissues_elections_politicsnone— Boost Post के साथ symmetry के लिए स्वीकार किया जाता है, जहाँ इसका अर्थ है “किसी special ad category में नहीं”। इसे Meta कोregulated_categories=["NONE"]के रूप में भेजा जाता है:accountIdआवश्यक है और सफल प्रतिक्रिया["NONE"]वापस लौटाती है। यह unfiltered खोज जैसे ही परिणामों की गारंटी नहीं देता; Meta की ओर से अस्वीकृतिcode: 368लौटाती है। यदि आप सामान्य unfiltered खोज चाहते हैं, तोnoneभेजने के बजायspecialAdCategoriesको पूरी तरह छोड़ दें।
400 और code: 101 के साथ अस्वीकार किया जाता है। वह message Meta के upper-case रूप में लिखा होता है और ऊपर बताई गई वैकल्पिक spellings के नाम भी देता है, इसलिए वह NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT के रूप में पढ़ा जाता है — यहाँ सूचीबद्ध वही श्रेणियाँ, अतिरिक्त नहीं। Boost Post यही message लौटाता है। खाली मान, जैसे ?specialAdCategories=, उसी तरह अस्वीकार किया जाता है।एक से अधिक श्रेणियाँ भेजने के लिए पैरामीटर को दोहराएँ, उदाहरण के लिए ?search=nursing&specialAdCategories=employment&specialAdCategories=housing। Bracketed रूप ?specialAdCategories[]=employment&specialAdCategories[]=housing भी काम करता है। Comma-separated स्ट्रिंग जैसे ?specialAdCategories=employment,housing समर्थित नहीं है और 400 और code: 101 के साथ अस्वीकार की जाती है। सभी अनुरोधित श्रेणियाँ एक ही खोज में Meta को भेजी जाती हैं। Ayrshare Meta के परिणाम लौटाता है और स्वतंत्र रूप से eligible रुचियों के intersection की गणना या गारंटी नहीं करता। किसी श्रेणी को दोहराना, या एक ही श्रेणी की दो spellings भेजना, एक ही श्रेणी में समेट दिया जाता है।जब आप एक से अधिक श्रेणियाँ देते हैं, तो प्रतिक्रिया में वापस लौटाया गया specialAdCategories फ़ील्ड आपके भेजे गए क्रम के बजाय alphabetically sorted होता है।specialAdCategories को पूरी तरह छोड़ दें और एंडपॉइंट ठीक पहले जैसा ही व्यवहार करता है: unfiltered खोज, किसी accountId की ज़रूरत नहीं, और वही response shape।string
जब
specialAdCategories दिया गया हो तब आवश्यक, अन्यथा नज़रअंदाज़ किया जाता है। उस Facebook ad
account की ID जिसके लिए रुचियाँ खोजी जा रही हैं, बिना act_ prefix के — वही मान जो Boost
Post लेता है। इसे ad accounts
endpoint से प्राप्त करें। यह numeric होना चाहिए; शुरुआत का
act_ स्वीकार करके हटा दिया जाता है, और इसके अलावा कुछ भी 400 और code: 101 के साथ अस्वीकार
किया जाता है।Meta category-aware रुचि खोज केवल किसी ad account पर उपलब्ध कराता है, इसलिए ऐसा अनुरोध जो
accountId के बिना specialAdCategories देता है, कोई खोज चलने से पहले ही 400 और code: 101
के साथ अस्वीकार कर दिया जाता है। बिना specialAdCategories वाला अनुरोध अपरिवर्तित है और उसे अब भी
किसी accountId की ज़रूरत नहीं है।number
डिफ़ॉल्ट:100
लौटाई गई विज्ञापन रुचियों की संख्या सीमित करें।
Filtered प्रतिक्रिया लागू की गई श्रेणियों को
specialAdCategories फ़ील्ड में वापस लौटाती है, ताकि
आप पुष्टि कर सकें कि परिणाम किसके आधार पर सीमित किए गए थे। Unfiltered प्रतिक्रिया उस फ़ील्ड को
खाली लौटाने के बजाय पूरी तरह छोड़ देती है। Filtered परिणामों में प्रत्येक रुचि पर topic फ़ील्ड
भी नहीं होती, क्योंकि Meta की category-aware खोज उसे नहीं लौटाती — इसके बजाय name पढ़ें। जिस खोज
के लिए कोई eligible रुचि नहीं है, वह त्रुटि नहीं बल्कि खाली interests array और count: 0 के
साथ 200 लौटाती है, और filtered खोज कभी भी unfiltered परिणामों पर fallback नहीं करती।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, // Lower bound of audience size
"audienceSizeUpperBound": 492023890 // Upper bound of audience size
},
{
"id": "6002926036121",
"name": "Italy",
"topic": "Travel, places and events",
"audienceSizeLowerBound": 279313350, // Lower bound of audience size
"audienceSizeUpperBound": 328472500 // Upper bound of audience size
}
],
"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."
}