Tìm kiếm audio 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
Tìm kiếm audio Instagram
Tìm kiếm danh mục audio có bản quyền của Instagram để lấy một bản nhạc đính kèm vào Reel
GET
/
media
/
instagram
/
audio
/
search
Tìm kiếm audio 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"
}
Tìm kiếm danh mục audio của Instagram theo từ khóa. Sử dụng
Các mã 514 đến 518 được mô tả trong Lỗi audio Instagram Reels; các mã còn lại nằm trong tài liệu tham khảo lỗi Ayrshare.
audioId được trả về với instagramOptions.audioConfiguration để đính kèm bản nhạc khi bạn xuất bản một Reel.
Tham số Header
Tham số Query
string
bắt buộc
Từ khóa để tìm kiếm, chẳng hạn như tên nghệ sĩ hoặc tên bản nhạc. Giá trị rỗng hoặc chỉ chứa
khoảng trắng trả về
code: 101.string
mặc định:"music"
Danh mục cần tìm kiếm. Hoặc
music cho các bản nhạc thương mại có bản quyền hoặc original_sound
cho audio lấy từ Reels của các creator khác. Bất kỳ giá trị nào khác trả về code: 101.integer
Số lượng bản nhạc tối đa được trả về, từ
1 đến 100. Giá trị không phải số nguyên hoặc ngoài
phạm vi trả về code: 101. Khi bỏ qua, giá trị mặc định của chính Instagram được áp dụng.Trường Phản hồi
Instagram không trả về mọi trường cho mọi bản nhạc, vì vậy hãy coi tất cả các trường của bản nhạc ngoại trừaudioId là tùy chọn.
string
success khi tìm kiếm hoàn tất. Kết quả khớp rỗng trong danh mục vẫn là thành công.string
Từ khóa đã được tìm kiếm, được trả lại nguyên trạng.
array
Các bản nhạc khớp. Mảng rỗng có nghĩa là tìm kiếm đã chạy nhưng không khớp kết quả nào.
Hiện Các trường của bản nhạc
Hiện Các trường của bản nhạc
string
Id để truyền dưới dạng
audioConfiguration.audioId khi xuất bản một Reel.string
Tiêu đề bản nhạc.
string
Tên nghệ sĩ như Instagram hiển thị.
integer
Độ dài bản nhạc tính bằng mili giây.
string
URL thumbnail của ảnh bìa.
string
Hoặc
music hoặc original_sound.boolean
Liệu bản nhạc có thể được sử dụng trong quảng cáo hay không. Nhạc có bản quyền thường không
khả dụng cho quảng cáo ngay cả khi nó khả dụng cho một Reel organic.
{
"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"
}
Lỗi
| Mã | Ý nghĩa |
|---|---|
| 101 | query bị thiếu hoặc rỗng, audioType không được nhận diện, hoặc limit ngoài phạm vi 1 đến 100. |
| 156 | Instagram chưa được liên kết với profile này. |
| 161 | Ủy quyền của Instagram đã hết hạn hoặc bị thu hồi. Liên kết lại tài khoản. |
| 239 | Instagram đã từ chối yêu cầu vì một lý do ở cấp tài khoản, bao gồm cả bản nhạc không khả dụng. Trên tìm kiếm, trường hợp này báo 239 thay vì 517 mà endpoint tra cứu trả về. |
| 258 | Instagram trả về một phản hồi bị lỗi định dạng hoặc một thất bại chưa được ánh xạ. |
| 425 | Kết nối thiếu một quyền Instagram bắt buộc. Liên kết lại và cấp tất cả các quyền. |
| 435 | Đã đạt tới giới hạn tốc độ của Instagram. Chờ trước khi thử lại. |
| 514 | Instagram được liên kết bằng Instagram Login. Audio API yêu cầu Facebook Login. |