Пошук аудіо 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
ID, який передається як
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. |