Hashtags

Hashtag Info

Description

This endpoint retrieves detailed information about a specific Instagram hashtag.

Endpoint

GET api/v1/realtime/social/instagram/v1/tags/{{tagName}}/info/

Parameters

Param	Required	Param Type	Description
tagName	Yes	Path Param	String | The hashtag name for which media information is to be retrieved

Example Request

curl -X GET 'https://api.webit.live/api/v1/realtime/social/instagram/v1/tags/goodvibes/info/' \
--header 'Authorization: Basic <credential string>'

Example Response

{
    "id": "17843714881031175",
    "name": "goodvibes",
    "media_count": 162975566,
    "follow_status": 0,
    "following": 0,
    "allow_following": 1,
    "allow_muting_story": true,
    "non_violating": 1,
    "subtitle": "See a few top posts each week",
    "social_context": "",
    "social_context_profile_links": [],
    "follow_button_text": null,
    "show_follow_drop_down": false,
    "formatted_media_count": "162M",
    "is_trending": false,
    "hide_use_hashtag_button": false,
    "status": "ok"
}

---

Hashtag Feed Sections

Description

This endpoint retrieves sections of the hashtag feed for a specific Instagram hashtag, such as top posts or recent posts.

Endpoint

POST api/v1/realtime/social/instagram/v1/tags/{{tagName}}/sections/

Parameters

Param	Required	Param Type	Description
tagName	Yes	Path Param	String | The hashtag name for which media information is to be retrieved
tab	Yes	Body Param	Enum | The section of the feed to retrieve: top (default) ranked recent
rank_token	No	Body Param	String | A UUID version 5 used for ranking and pagination. For each request, generate a new UUID, and use the same rank_token for all pagination requests.
max_id	No	Body Param	String | used as pagination cursor - Use the value of the next_max_id field from the response as the value for pagination

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/social/instagram/v1/tags/goodvibes/sections/' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data '{
    "tab": "top",
    "rank_token": " 2ff2d3a6-2b30-4c0f-aa5e-1e235706e470"
 }'

Example Response

{
    "sections": [
        {
            "layout_type": "one_by_two_left",
            "layout_content": {
                "one_by_two_item": {
                    "clips": {
                        "id": "clips-b35b2639-708d-4715-8834-c6db86c0bcf1",
                        "tag": "goodvibes",
                        "items": [...],
                        "max_id": "4335faffb29b46abaeff62a9d36f3bb8",
                        "more_available": true,
                        "design": "bottom_with_icon_horizontal",
                        "label": ""
                    }
                },
                "fill_items": [...]
            },
            "feed_type": "clips",
            "explore_item_info": {
                "num_columns": 3,
                "total_num_columns": 3,
                "aspect_ratio": 1.5,
                "autoplay": true
            }
        },
        ...
    ],
    "more_available": true,
    "next_max_id": "46e1311839924765af8c14e43dd14b98",
    "next_page": 1,
    "next_media_ids": [...],
    "auto_load_more_enabled": true,
    "status": "ok"
}