curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top", {
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/hashtags/search?keyword=wisdom&searchType=top', headers=headers)
print(r.json())
<?php
require 'vendor/autoload.php';// Composer auto-loader using Guzzle. See .../guzzlephp.org/en/stable/overview.html
$client = new GuzzleHttp\Client();
$res = $client->request(
'GET',
'https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top',
[
'headers' => [
'Content-Type' => 'application/json',
'Authorization' => 'Bearer API_KEY'
]
]
);
echo json_encode(json_decode($res->getBody()), JSON_PRETTY_PRINT);
using System;
using System.Net.Http;
using System.Threading.Tasks;
namespace HashtagsSearchGETRequest_csharp
{
class HashtagsSearch
{
static async Task Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top";
using (var client = new HttpClient())
{
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
try
{
var response = await client.GetStringAsync(url);
Console.WriteLine(response);
}
catch (HttpRequestException ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
}
}
{
"status": "success",
"hashtag": {
"id": "17843798701036069",
"name": "wisdom"
},
"searchResults": [
{
"caption": "🙂96% Percent of People have no clue this method exists ... For manifesting money , there is powerful a manifestation technique it changes your beliefs on reality in the deepest level of the subconscious mind it literally changed my life give it an honest try . Click the link in our bio to see if this works for you too . (worked for me )",
"children": {
"data": [
{
"id": "18364392676136006"
},
{
"id": "18008030660493382"
},
{
"id": "17866325790184001"
}
]
},
"commentsCount": 174,
"id": "17861532840277137",
"likeCount": 1389,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.29350-15/466382723_420103424530861_7360358065352125344_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=18de74&_nc_ohc=c-_PWScwGQAQ7kNvgFPrTeK&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&_nc_gid=AT1Ax3hZh5lt3kJskGj3Hj6&oh=00_AYBDkqi4pSdedYxDfUnAm9c93AlyXabWzJM81UySCuIpDg&oe=67406A28",
"permalink": "https://www.instagram.com/p/DCdDF6_Sa31/",
"timestamp": "2024-11-17T01:22:29+0000"
},
{
"caption": "🙂96% Percent of People have no clue this method exists ... For manifesting money , there is powerful a manifestation technique it changes your beliefs on reality in the deepest level of the subconscious mind it literally changed my life give it an honest try . Click the link in our bio to see if this works for you too . (worked for me )",
"children": {
"data": [
{
"id": "17854668297321577"
},
{
"id": "17953717721743238"
}
]
},
"commentsCount": 40,
"id": "18054468655821869",
"likeCount": 371,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.29350-15/467316183_1100515004943506_6021956524402070992_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=18de74&_nc_ohc=LQVF-7HyOE4Q7kNvgEPZ98d&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&_nc_gid=AT1Ax3hZh5lt3kJskGj3Hj6&oh=00_AYArRIS7xth-eI3rRWlvLhMklRJLBIH5rZ66akHfuSnxjg&oe=6740726A",
"permalink": "https://www.instagram.com/p/DCdDZb5SzUj/",
"timestamp": "2024-11-17T01:25:09+0000"
},
{
"caption": "Setting intentions rather than expectations is a valuable way to keep you from overthinking, help you stay closer to reality, and move with mental clarity. \n\nYou can develop this kind of mindful skill by joining my 8-week "Slow School" live online course. It starts Dec 3rd. Check the link in my bio to learn more 🖤",
"children": {
"data": [
{
"id": "18471207271027384"
},
{
"id": "17875576494200786"
}
]
},
"commentsCount": 33,
"id": "18057421303730368",
"likeCount": 5601,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.2885-15/467022186_992465279306045_4614070861842639887_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=18de74&_nc_ohc=pchds80KU9oQ7kNvgEaCWkZ&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&oh=00_AYDqG9VA4vJzBvXw6nzFTXc7rU0xVnsTJBOpptBbCEI9Gw&oe=67408C3D",
"permalink": "https://www.instagram.com/p/DCZT369M_07/",
"timestamp": "2024-11-15T14:32:12+0000"
},
"count": 25,
"lastUpdated": "2024-11-19T20:09:02.830Z",
"nextUpdate": "2024-11-19T20:20:02.830Z"
]
}
{
"action": "hashtag search",
"status": "error",
"code": 380,
"message": "Error searching Instagram Hashtags. Could not find a matching hashtag"
}
Hashtags
搜索 hashtag
查找已使用特定 hashtag 标记的公开 Instagram 媒体
GET
/
hashtags
/
search
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top", {
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/hashtags/search?keyword=wisdom&searchType=top', headers=headers)
print(r.json())
<?php
require 'vendor/autoload.php';// Composer auto-loader using Guzzle. See .../guzzlephp.org/en/stable/overview.html
$client = new GuzzleHttp\Client();
$res = $client->request(
'GET',
'https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top',
[
'headers' => [
'Content-Type' => 'application/json',
'Authorization' => 'Bearer API_KEY'
]
]
);
echo json_encode(json_decode($res->getBody()), JSON_PRETTY_PRINT);
using System;
using System.Net.Http;
using System.Threading.Tasks;
namespace HashtagsSearchGETRequest_csharp
{
class HashtagsSearch
{
static async Task Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top";
using (var client = new HttpClient())
{
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
try
{
var response = await client.GetStringAsync(url);
Console.WriteLine(response);
}
catch (HttpRequestException ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
}
}
{
"status": "success",
"hashtag": {
"id": "17843798701036069",
"name": "wisdom"
},
"searchResults": [
{
"caption": "🙂96% Percent of People have no clue this method exists ... For manifesting money , there is powerful a manifestation technique it changes your beliefs on reality in the deepest level of the subconscious mind it literally changed my life give it an honest try . Click the link in our bio to see if this works for you too . (worked for me )",
"children": {
"data": [
{
"id": "18364392676136006"
},
{
"id": "18008030660493382"
},
{
"id": "17866325790184001"
}
]
},
"commentsCount": 174,
"id": "17861532840277137",
"likeCount": 1389,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.29350-15/466382723_420103424530861_7360358065352125344_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=18de74&_nc_ohc=c-_PWScwGQAQ7kNvgFPrTeK&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&_nc_gid=AT1Ax3hZh5lt3kJskGj3Hj6&oh=00_AYBDkqi4pSdedYxDfUnAm9c93AlyXabWzJM81UySCuIpDg&oe=67406A28",
"permalink": "https://www.instagram.com/p/DCdDF6_Sa31/",
"timestamp": "2024-11-17T01:22:29+0000"
},
{
"caption": "🙂96% Percent of People have no clue this method exists ... For manifesting money , there is powerful a manifestation technique it changes your beliefs on reality in the deepest level of the subconscious mind it literally changed my life give it an honest try . Click the link in our bio to see if this works for you too . (worked for me )",
"children": {
"data": [
{
"id": "17854668297321577"
},
{
"id": "17953717721743238"
}
]
},
"commentsCount": 40,
"id": "18054468655821869",
"likeCount": 371,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.29350-15/467316183_1100515004943506_6021956524402070992_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=18de74&_nc_ohc=LQVF-7HyOE4Q7kNvgEPZ98d&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&_nc_gid=AT1Ax3hZh5lt3kJskGj3Hj6&oh=00_AYArRIS7xth-eI3rRWlvLhMklRJLBIH5rZ66akHfuSnxjg&oe=6740726A",
"permalink": "https://www.instagram.com/p/DCdDZb5SzUj/",
"timestamp": "2024-11-17T01:25:09+0000"
},
{
"caption": "Setting intentions rather than expectations is a valuable way to keep you from overthinking, help you stay closer to reality, and move with mental clarity. \n\nYou can develop this kind of mindful skill by joining my 8-week "Slow School" live online course. It starts Dec 3rd. Check the link in my bio to learn more 🖤",
"children": {
"data": [
{
"id": "18471207271027384"
},
{
"id": "17875576494200786"
}
]
},
"commentsCount": 33,
"id": "18057421303730368",
"likeCount": 5601,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.2885-15/467022186_992465279306045_4614070861842639887_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=18de74&_nc_ohc=pchds80KU9oQ7kNvgEaCWkZ&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&oh=00_AYDqG9VA4vJzBvXw6nzFTXc7rU0xVnsTJBOpptBbCEI9Gw&oe=67408C3D",
"permalink": "https://www.instagram.com/p/DCZT369M_07/",
"timestamp": "2024-11-15T14:32:12+0000"
},
"count": 25,
"lastUpdated": "2024-11-19T20:09:02.830Z",
"nextUpdate": "2024-11-19T20:20:02.830Z"
]
}
{
"action": "hashtag search",
"status": "error",
"code": 380,
"message": "Error searching Instagram Hashtags. Could not find a matching hashtag"
}
根据 hashtag 关键词搜索,获取带有该 hashtag 的 Instagram 媒体帖子列表。
- 每个 Instagram Business 或 Creator 账户在滚动的 7 天周期内最多可查询 30 个不同的 hashtag。 某个 hashtag 一旦被查询,将在 7 天内计入此配额。同一时间段内对同一 hashtag 的后续查询不会 再计入配额,也不会重置最初查询的 7 天计时器。
- 你无法对通过 API 发现的带 hashtag 的媒体对象发表评论。
- 不支持 Stories 上的 hashtag。
- hashtag 查询不支持表情符号。
- 如果请求包含我们判定为敏感或不当的 hashtag,API 将返回错误。
请求头参数
查询参数
用于搜索匹配 hashtag 的关键词。
Search for the hashtag
https://api.ayrshare.com/api/hashtags/search?keyword=wisdom
搜索类型。有效取值:
top、recent。top 返回最热门的 hashtag,recent 返回最新的
hashtag。默认:top。curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top", {
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/hashtags/search?keyword=wisdom&searchType=top', headers=headers)
print(r.json())
<?php
require 'vendor/autoload.php';// Composer auto-loader using Guzzle. See .../guzzlephp.org/en/stable/overview.html
$client = new GuzzleHttp\Client();
$res = $client->request(
'GET',
'https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top',
[
'headers' => [
'Content-Type' => 'application/json',
'Authorization' => 'Bearer API_KEY'
]
]
);
echo json_encode(json_decode($res->getBody()), JSON_PRETTY_PRINT);
using System;
using System.Net.Http;
using System.Threading.Tasks;
namespace HashtagsSearchGETRequest_csharp
{
class HashtagsSearch
{
static async Task Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://api.ayrshare.com/api/hashtags/search?keyword=wisdom&searchType=top";
using (var client = new HttpClient())
{
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
try
{
var response = await client.GetStringAsync(url);
Console.WriteLine(response);
}
catch (HttpRequestException ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
}
}
{
"status": "success",
"hashtag": {
"id": "17843798701036069",
"name": "wisdom"
},
"searchResults": [
{
"caption": "🙂96% Percent of People have no clue this method exists ... For manifesting money , there is powerful a manifestation technique it changes your beliefs on reality in the deepest level of the subconscious mind it literally changed my life give it an honest try . Click the link in our bio to see if this works for you too . (worked for me )",
"children": {
"data": [
{
"id": "18364392676136006"
},
{
"id": "18008030660493382"
},
{
"id": "17866325790184001"
}
]
},
"commentsCount": 174,
"id": "17861532840277137",
"likeCount": 1389,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.29350-15/466382723_420103424530861_7360358065352125344_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=18de74&_nc_ohc=c-_PWScwGQAQ7kNvgFPrTeK&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&_nc_gid=AT1Ax3hZh5lt3kJskGj3Hj6&oh=00_AYBDkqi4pSdedYxDfUnAm9c93AlyXabWzJM81UySCuIpDg&oe=67406A28",
"permalink": "https://www.instagram.com/p/DCdDF6_Sa31/",
"timestamp": "2024-11-17T01:22:29+0000"
},
{
"caption": "🙂96% Percent of People have no clue this method exists ... For manifesting money , there is powerful a manifestation technique it changes your beliefs on reality in the deepest level of the subconscious mind it literally changed my life give it an honest try . Click the link in our bio to see if this works for you too . (worked for me )",
"children": {
"data": [
{
"id": "17854668297321577"
},
{
"id": "17953717721743238"
}
]
},
"commentsCount": 40,
"id": "18054468655821869",
"likeCount": 371,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.29350-15/467316183_1100515004943506_6021956524402070992_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=18de74&_nc_ohc=LQVF-7HyOE4Q7kNvgEPZ98d&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&_nc_gid=AT1Ax3hZh5lt3kJskGj3Hj6&oh=00_AYArRIS7xth-eI3rRWlvLhMklRJLBIH5rZ66akHfuSnxjg&oe=6740726A",
"permalink": "https://www.instagram.com/p/DCdDZb5SzUj/",
"timestamp": "2024-11-17T01:25:09+0000"
},
{
"caption": "Setting intentions rather than expectations is a valuable way to keep you from overthinking, help you stay closer to reality, and move with mental clarity. \n\nYou can develop this kind of mindful skill by joining my 8-week "Slow School" live online course. It starts Dec 3rd. Check the link in my bio to learn more 🖤",
"children": {
"data": [
{
"id": "18471207271027384"
},
{
"id": "17875576494200786"
}
]
},
"commentsCount": 33,
"id": "18057421303730368",
"likeCount": 5601,
"mediaType": "CAROUSEL_ALBUM",
"mediaUrl": "https://scontent-sjc3-1.cdninstagram.com/v/t51.2885-15/467022186_992465279306045_4614070861842639887_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=18de74&_nc_ohc=pchds80KU9oQ7kNvgEaCWkZ&_nc_zt=23&_nc_ht=scontent-sjc3-1.cdninstagram.com&edm=APCawUEEAAAA&oh=00_AYDqG9VA4vJzBvXw6nzFTXc7rU0xVnsTJBOpptBbCEI9Gw&oe=67408C3D",
"permalink": "https://www.instagram.com/p/DCZT369M_07/",
"timestamp": "2024-11-15T14:32:12+0000"
},
"count": 25,
"lastUpdated": "2024-11-19T20:09:02.830Z",
"nextUpdate": "2024-11-19T20:20:02.830Z"
]
}
{
"action": "hashtag search",
"status": "error",
"code": 380,
"message": "Error searching Instagram Hashtags. Could not find a matching hashtag"
}
⌘I
