ACME API Documentation logo

Search Hashtags

Find public Instagram Media that has been tagged with specific hashtags

GEThttps://api.acme.com/api/hashtags/search
Available on Premium, Business, Enterprise plans.

Search based on a hashtag keyword to get a list of Instagram media posts that have been tagged with that hashtag.

  • You can query a maximum of 30 unique hashtags on behalf of an Instagram Business or Creator Account within a rolling, 7-day period. Once you query a hashtag, it will count against this limit for 7 days. Subsequent queries on the same hashtag within this time frame will not count against your limit, and will not reset its initial query 7-day timer.

  • You cannot comment on hashtagged media objects discovered through the API.
  • Hashtags on Stories are not supported.
  • Emojis in hashtag queries are not supported.
  • The API will return an error for any requests that include hashtags that we have deemed sensitive or offensive.

Header Parameters

Authorizationstringrequired
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

Query Parameters

keywordstringrequired

The keyword to search for matching hashtags.

Search for the hashtag "wisdom"
https://api.acme.com/api/hashtags/search?keyword=wisdom
searchTypestringdefault: top

The type of search to perform. Valid values: top, recent. Top will return the most popular hashtags. Recent will return the most recent hashtags. Default: top.

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.acme.com/api/hashtags/search?keyword=wisdom&searchType=top
{
    "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"
    ]
}