البحث في الوسوم

ابحث عن وسائط Instagram العامة التي تم وسمها بوسوم معينة

GET /hashtags/search

cURL

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}");
            }
        }
    }
}
}

200: Success

{
    "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"
}

ابحث بناءً على كلمة مفتاحية لوسم للحصول على قائمة بمنشورات وسائط Instagram التي تم وسمها بذلك الوسم.

• يمكنك الاستعلام عن حد أقصى قدره 30 وسمًا فريدًا نيابةً عن حساب Instagram Business أو Creator خلال فترة متدرجة مدتها 7 أيام. بمجرد الاستعلام عن وسم، سيُحتسب ضمن هذا الحد لمدة 7 أيام. الاستعلامات اللاحقة على الوسم نفسه ضمن هذا الإطار الزمني لن تُحتسب ضمن الحد، ولن تُعيد ضبط عدّاد الـ 7 أيام لاستعلامها الأول.

• لا يمكنك التعليق على كائنات الوسائط الموسومة التي تم اكتشافها عبر API.
• الوسوم على Stories غير مدعومة.
• الرموز التعبيرية في استعلامات الوسوم غير مدعومة.

• سيعيد API خطأً لأي طلبات تتضمن وسومًا اعتبرناها حساسة أو مسيئة.

​

معاملات الرأس

​

معاملات الاستعلام

keyword · string · مطلوب

الكلمة المفتاحية للبحث عن وسوم مطابقة.

Search for the hashtag

https://api.ayrshare.com/api/hashtags/search?keyword=wisdom

searchType · string · افتراضي: "top"

نوع البحث المُراد إجراؤه. القيم الصالحة: top، recent. سيعيد Top الوسوم الأكثر شعبية. سيعيد Recent الوسوم الأحدث. الافتراضي: top.

cURL

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}");
            }
        }
    }
}
}

200: Success

{
    "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"
}