Метадані аудіо Instagram
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/{audioId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/{audioId}', 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/{audioId}"
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/{audioId}",
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/{audioId}"
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/{audioId}")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
{
"status": "error",
"code": 517,
"action": "post",
"message": "The selected audio track is unavailable. It may be an invalid audio id, restricted in your region, or not licensed for this use. Please choose a different track using the Instagram audio search endpoint and try again.",
"platform": "instagram"
}
Media
Метадані аудіо Instagram
Отримати деталі окремого аудіотреку Instagram за його ID
GET
/
media
/
instagram
/
audio
/
{audioId}
Метадані аудіо Instagram
curl --request GET \
--url https://api.ayrshare.com/api/media/instagram/audio/{audioId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ayrshare.com/api/media/instagram/audio/{audioId}', 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/{audioId}"
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/{audioId}",
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/{audioId}"
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/{audioId}")
.header("Authorization", "Bearer <token>")
.asString();{
"status": "success",
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
{
"status": "error",
"code": 517,
"action": "post",
"message": "The selected audio track is unavailable. It may be an invalid audio id, restricted in your region, or not licensed for this use. Please choose a different track using the Instagram audio search endpoint and try again.",
"platform": "instagram"
}
Отримайте деталі одного аудіотреку за його
Коди від 514 до 518 описані в помилках аудіо Instagram Reels; решта — в довіднику помилок Ayrshare.
audioId. Використовуйте це, щоб підтвердити, що збережений ID досі валідний, або щоб показати назву треку та обкладинку перед публікацією.
Параметри заголовка
Параметри шляху
string
обов'язково
ID треку, як його повертає пошук аудіо. ID, який Instagram
не розпізнає, повертає
code: 517.Поля відповіді
Поля треку повертаються безпосередньо в об’єкті відповіді, а не вкладено. Instagram не повертає кожне поле для кожного треку, тож вважайте всі поля, крімaudioId, опціональними.
string
success, коли трек знайдено.string
ID треку, повернутий назад.
string
Назва треку.
string
Ім’я виконавця так, як його відображає Instagram.
integer
Тривалість треку в мілісекундах.
string
URL мініатюри обкладинки.
string
Або
music, або original_sound.boolean
Чи можна використовувати трек у рекламі.
{
"status": "success",
"audioId": "17901234567890123",
"title": "Summer Nights",
"displayArtist": "The Example Band",
"durationMs": 32000,
"thumbnailUrl": "https://scontent.example.com/cover.jpg",
"audioType": "music",
"isAdsEligible": true
}
{
"status": "error",
"code": 517,
"action": "post",
"message": "The selected audio track is unavailable. It may be an invalid audio id, restricted in your region, or not licensed for this use. Please choose a different track using the Instagram audio search endpoint and try again.",
"platform": "instagram"
}
Доступність залежить від регіону. Meta повертає ту саму помилку для ID, який не існує, для
треку, не ліцензованого в регіоні облікового запису, і для треку, не ліцензованого для цього
використання. Усі три випадки повідомляють
517, тож трек, який працює для одного облікового
запису, може цілком закономірно не спрацювати для іншого. Перевіряйте ID запитом, а не
припускайте, що збережений досі працює.Помилки
| Код | Значення |
|---|---|
| 156 | Instagram не прив’язано до цього профілю. |
| 161 | Авторизація Instagram закінчилася або була відкликана. Повторно прив’яжіть обліковий запис. |
| 239 | Instagram відхилив запит з причини на рівні облікового запису. |
| 258 | Instagram повернув некоректну відповідь або незіставлений збій. |
| 425 | Підключенню бракує потрібного дозволу Instagram. Повторно прив’яжіть і надайте всі дозволи. |
| 435 | Досягнуто ліміту запитів Instagram. Зачекайте перед повторною спробою. |
| 514 | Instagram прив’язано через Instagram Login. Audio API вимагає Facebook Login. |
| 516 | audioId відсутній або порожній. |
| 517 | Instagram не розпізнає ID, або трек недоступний цьому обліковому запису. |