البحث في صوتيات Instagram
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ayrshare.com/api/media/instagram/audio/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/media/instagram/audio/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ayrshare.com/api/media/instagram/audio/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ayrshare.com/api/media/instagram/audio/search")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"query": "summer",
"audio": [
{
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
]
}
{
"status": "success",
"query": "asdfghjkl",
"audio": []
}
{
"status": "error",
"code": 514,
"action": "post",
"message": "Adding music to a Reel requires an Instagram account connected via Facebook Login. This profile is connected with Instagram Login, which Meta does not permit for music attach, search, or lookup. Please relink Instagram using Facebook Login and grant the instagram_content_publish permission, then try again.",
"platform": "instagram"
}
Media
البحث في صوتيات Instagram
ابحث في كتالوج الصوت المرخّص في Instagram عن مقطع لإرفاقه بـ Reel
GET
/
media
/
instagram
/
audio
/
search
البحث في صوتيات Instagram
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/search \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ayrshare.com/api/media/instagram/audio/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ayrshare.com/api/media/instagram/audio/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ayrshare.com/api/media/instagram/audio/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ayrshare.com/api/media/instagram/audio/search")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"query": "summer",
"audio": [
{
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
]
}
{
"status": "success",
"query": "asdfghjkl",
"audio": []
}
{
"status": "error",
"code": 514,
"action": "post",
"message": "Adding music to a Reel requires an Instagram account connected via Facebook Login. This profile is connected with Instagram Login, which Meta does not permit for music attach, search, or lookup. Please relink Instagram using Facebook Login and grant the instagram_content_publish permission, then try again.",
"platform": "instagram"
}
ابحث في كتالوج الصوت في Instagram بكلمة مفتاحية. استخدم
الرموز من 514 إلى 518 موصوفة في أخطاء صوت Instagram Reels؛ أما البقية ففي مرجع أخطاء Ayrshare.
audioId المُعاد مع instagramOptions.audioConfiguration لإرفاق المقطع عند نشر Reel.
معلمات الترويسة
معلمات الاستعلام
string
مطلوب
كلمة مفتاحية للبحث عنها، مثل اسم فنان أو مقطع. القيمة الفارغة أو المكوّنة من مسافات فقط تعيد
code: 101.string
افتراضي:"music"
الكتالوج الذي يجري البحث فيه. إمّا
music للمقاطع التجارية المرخّصة أو original_sound للصوت
المأخوذ من Reels منشئين آخرين. أي قيمة أخرى تعيد code: 101.integer
الحد الأقصى لعدد المقاطع المُعادة، من
1 إلى 100. القيم غير الصحيحة أو الخارجة عن النطاق تعيد
code: 101. عند إغفاله، يُطبَّق الإعداد الافتراضي الخاص بـ Instagram.حقول الاستجابة
لا يعيد Instagram كل حقل لكل مقطع، لذا تعامل مع جميع حقول المقطع باستثناءaudioId على أنها اختيارية.
string
success عند اكتمال البحث. عدم وجود تطابق في الكتالوج لا يزال نجاحًا.string
الكلمة المفتاحية التي جرى البحث عنها، مُعادة كما هي.
array
المقاطع المطابقة. المصفوفة الفارغة تعني أن البحث جرى ولم يطابق شيئًا.
إظهار حقول المقطع
إظهار حقول المقطع
string
المعرّف الذي يُمرَّر كـ
audioConfiguration.audioId عند نشر Reel.string
عنوان المقطع.
string
اسم الفنان كما يعرضه Instagram.
integer
طول المقطع بالمللي ثانية.
string
عنوان URL للصورة المصغّرة لغلاف المقطع.
string
إمّا
music أو original_sound.boolean
ما إذا كان يمكن استخدام المقطع في إعلان. كثيرًا ما تكون الموسيقى المرخّصة غير متاحة للإعلانات
حتى عندما تكون متاحة لـ Reel عضوي.
{
"status": "success",
"query": "summer",
"audio": [
{
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
]
}
{
"status": "success",
"query": "asdfghjkl",
"audio": []
}
{
"status": "error",
"code": 514,
"action": "post",
"message": "Adding music to a Reel requires an Instagram account connected via Facebook Login. This profile is connected with Instagram Login, which Meta does not permit for music attach, search, or lookup. Please relink Instagram using Facebook Login and grant the instagram_content_publish permission, then try again.",
"platform": "instagram"
}
الأخطاء
| الرمز | المعنى |
|---|---|
| 101 | query مفقود أو فارغ، أو audioType غير متعارف عليه، أو limit خارج النطاق من 1 إلى 100. |
| 156 | Instagram غير مرتبط بملف التعريف هذا. |
| 161 | انتهت صلاحية تفويض Instagram أو أُلغي. أعد ربط الحساب. |
| 239 | رفض Instagram الطلب لسبب على مستوى الحساب، بما في ذلك مقطع غير متاح. في البحث يُبلَّغ عن 239 بدلًا من 517 الذي تعيده نقطة نهاية الاستعلام. |
| 258 | أعاد Instagram استجابة مشوّهة أو فشلًا غير مُطابَق. |
| 425 | يفتقر الاتصال إلى إذن Instagram مطلوب. أعد الربط وامنح جميع الأذونات. |
| 435 | تم بلوغ حد المعدّل الخاص بـ Instagram. انتظر قبل إعادة المحاولة. |
| 514 | Instagram مرتبط بواسطة Instagram Login. يتطلّب Audio API استخدام Facebook Login. |