Hashtag Endpoints

Get hashtag info, top and recent media.

Authentication & errors

All endpoints require x-access-key header. See Authentication. Error responses: Response Codes.

Endpoints: /v1/hashtag/by/name | /v1/hashtag/medias/clips/chunk | /v1/hashtag/medias/top/chunk

---

GET /v1/hashtag/by/name

Get hashtag object by name. Returns a Hashtag object.

Parameter	Type	Required	Description
name	string	Yes	Please make sure to use a clean hashtag without any special symbols. Good one: love, sea, dog, 공구 Bad one: #dog, sea_., tanjung.., #공구.

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/hashtag/by/name?name=love"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.hashtag_by_name_v1(name="love")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/hashtag/by/name",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"name": "love"},
)
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/hashtag/by/name?name=love",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();

Example response

{
  "id": "17843826142012701",
  "name": "love",
  "media_count": 2147483647,
  "allow_following": false,
  "profile_pic_url": null
}

---

GET /v1/hashtag/medias/clips/chunk

Get hashtag chunk of clips (reels). Returns a list of Media objects.

Parameter	Type	Required	Description
name	string	Yes	Please make sure to use a clean hashtag without any special symbols. Good one: love, sea, dog, 공구 Bad one: #dog, sea_., tanjung.., #공구.
max_id	string	No	Max Id

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/hashtag/medias/clips/chunk?name=love"
# Next page: add &max_id=... from previous response

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.hashtag_medias_clips_chunk_v1(name="love")
# Next page: cl.hashtag_medias_clips_chunk_v1(name="love", max_id="...")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/hashtag/medias/clips/chunk",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"name": "love"},
)
# Next page: add "max_id": "..." to params
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/hashtag/medias/clips/chunk?name=love",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();
// Next page: add &max_id=... to URL

Example response

[
  [
    {
      "pk": "3870771007451871805",
      "id": "3870771007451871805_375121505",
      "code": "DW3vbkaDLo9",
      "taken_at": "2026-04-08T12:38:17Z",
      "taken_at_ts": 1775651897,
      "media_type": 1,
      "product_type": "feed",
      "thumbnail_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "location": null,
      "user": {
        "pk": "375121505",
        "id": "375121505",
        "username": "fallinginsociety",
        "full_name": "FallingInSociety",
        "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/...",
        "profile_pic_url_hd": null,
        "is_private": false,
        "is_verified": false
      },
      "comment_count": 5,
      "comments_disabled": false,
      "like_count": 416,
      "play_count": 0,
      "has_liked": false,
      "caption_text": "Disney Princess irl",
      "accessibility_caption": null,
      "usertags": [],
      "sponsor_tags": [],
      "video_url": null,
      "view_count": 0,
      "video_duration": 0.0,
      "title": "",
      "resources": [],
      "image_versions": [
        {
          "estimated_scans_sizes": [
            11766,
            23532,
            35299
          ],
          "height": 1101,
          "scans_profile": "e35",
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "width": 1079,
          "is_spatial_image": false
        }
      ],
      "video_versions": [],
      "like_and_view_counts_disabled": false,
      "coauthor_producers": [],
      "is_paid_partnership": false
    },
    {
      "pk": "3870878037013437314",
      "id": "3870878037013437314_61776189307",
      "code": "DW4HxDdDBuC",
      "taken_at": "2026-04-08T16:11:15Z",
      "taken_at_ts": 1775664675,
      "media_type": 2,
      "product_type": "clips",
      "thumbnail_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "location": {
        "pk": 414026382653741,
        "name": "Limassol, Cyprus",
        "phone": "",
        "website": "",
        "category": "",
        "hours": {},
        "address": "",
        "city": "",
        "zip": null,
        "lng": 33.092566668898,
        "lat": 34.700580757465,
        "external_id": "414026382653741",
        "external_id_source": "facebook_places"
      },
      "user": {
        "pk": "61776189307",
        "id": "61776189307",
        "username": "feelloveheal.live",
        "full_name": "✍️",
        "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/...",
        "profile_pic_url_hd": null,
        "is_private": false,
        "is_verified": false
      },
      "comment_count": 3,
      "comments_disabled": false,
      "like_count": 710,
      "play_count": 16033,
      "has_liked": false,
      "caption_text": "#love #quotes #cyprus #instagram #sea",
      "accessibility_caption": null,
      "usertags": [],
      "sponsor_tags": [],
      "video_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "view_count": 0,
      "video_duration": 34.73500061035156,
      "title": "",
      "resources": [],
      "image_versions": [
        {
          "estimated_scans_sizes": [
            8483,
            16966,
            25450
          ],
          "height": 1136,
          "scans_profile": "e15",
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "width": 640,
          "is_spatial_image": false
        }
      ],
      "video_versions": [
        {
          "bandwidth": 428616,
          "height": 1280,
          "id": "1331715915447731v",
          "type": 101,
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "url_expiration_timestamp_us": null,
          "width": 720,
          "fallback": null
        }
      ],
      "like_and_view_counts_disabled": false,
      "coauthor_producers": [
        {
          "strong_id__": "68137148105",
          "pk": 68137148105,
          "pk_id": "68137148105",
          "id": "68137148105",
          "username": "en_psixi",
          "full_name": "",
          "is_private": false,
          "is_verified": false,
          "profile_pic_id": "3822113780445062331_68137148105",
          "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/..."
        },
        {
          "strong_id__": "59386353188",
          "pk": 59386353188,
          "pk_id": "59386353188",
          "id": "59386353188",
          "username": "_eros.a",
          "full_name": "ἔ ρ ω ς",
          "is_private": false,
          "is_verified": false,
          "profile_pic_id": "3091603214372483610_59386353188",
          "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/..."
        }
      ],
      "is_paid_partnership": false
    },
    {
      "pk": "3870855071546483116",
      "id": "3870855071546483116_375121505",
      "code": "DW4Ci3MjCGs",
      "taken_at": "2026-04-08T15:25:08Z",
      "taken_at_ts": 1775661908,
      "media_type": 1,
      "product_type": "feed",
      "thumbnail_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "location": null,
      "user": {
        "pk": "375121505",
        "id": "375121505",
        "username": "fallinginsociety",
        "full_name": "FallingInSociety",
        "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/...",
        "profile_pic_url_hd": null,
        "is_private": false,
        "is_verified": false
      },
      "comment_count": 3,
      "comments_disabled": false,
      "like_count": 325,
      "play_count": 0,
      "has_liked": false,
      "caption_text": "24 year olds deserve it",
      "accessibility_caption": null,
      "usertags": [],
      "sponsor_tags": [],
      "video_url": null,
      "view_count": 0,
      "video_duration": 0.0,
      "title": "",
      "resources": [],
      "image_versions": [
        {
          "estimated_scans_sizes": [
            11957,
            23915,
            35873
          ],
          "height": 1440,
          "scans_profile": "e35",
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "width": 1440,
          "is_spatial_image": false
        }
      ],
      "video_versions": [],
      "like_and_view_counts_disabled": false,
      "coauthor_producers": [],
      "is_paid_partnership": false
    }
  ],
  "WyIzMzBmNzAyNDkxM2Y0MzYyOWY4NjliNGNhYjJiODYxZCIsW10sMV0="
]

---

GET /v1/hashtag/medias/top/chunk

Get hashtag chunk of top medias. Returns a list of Media objects.

Parameter	Type	Required	Description
name	string	Yes	Please make sure to use a clean hashtag without any special symbols. Good one: love, sea, dog, 공구 Bad one: #dog, sea_., tanjung.., #공구.
max_id	string	No	Max Id

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/hashtag/medias/top/chunk?name=love"
# Next page: add &max_id=... from previous response

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.hashtag_medias_top_chunk_v1(name="love")
# Next page: cl.hashtag_medias_top_chunk_v1(name="love", max_id="...")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/hashtag/medias/top/chunk",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"name": "love"},
)
# Next page: add "max_id": "..." to params
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/hashtag/medias/top/chunk?name=love",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();
// Next page: add &max_id=... to URL

Example response

[
  [
    {
      "pk": "3870878037013437314",
      "id": "3870878037013437314_61776189307",
      "code": "DW4HxDdDBuC",
      "taken_at": "2026-04-08T16:11:15Z",
      "taken_at_ts": 1775664675,
      "media_type": 2,
      "product_type": "clips",
      "thumbnail_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "location": {
        "pk": 414026382653741,
        "name": "Limassol, Cyprus",
        "phone": "",
        "website": "",
        "category": "",
        "hours": {},
        "address": "",
        "city": "",
        "zip": null,
        "lng": 33.092566668898,
        "lat": 34.700580757465,
        "external_id": "414026382653741",
        "external_id_source": "facebook_places"
      },
      "user": {
        "pk": "61776189307",
        "id": "61776189307",
        "username": "feelloveheal.live",
        "full_name": "✍️",
        "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/...",
        "profile_pic_url_hd": null,
        "is_private": false,
        "is_verified": false
      },
      "comment_count": 3,
      "comments_disabled": false,
      "like_count": 708,
      "play_count": 16001,
      "has_liked": false,
      "caption_text": "#love #quotes #cyprus #instagram #sea",
      "accessibility_caption": null,
      "usertags": [],
      "sponsor_tags": [],
      "video_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "view_count": 0,
      "video_duration": 34.73500061035156,
      "title": "",
      "resources": [],
      "image_versions": [
        {
          "estimated_scans_sizes": [
            8483,
            16966,
            25450
          ],
          "height": 1136,
          "scans_profile": "e15",
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "width": 640,
          "is_spatial_image": false
        }
      ],
      "video_versions": [
        {
          "bandwidth": 428616,
          "height": 1280,
          "id": "1331715915447731v",
          "type": 101,
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "url_expiration_timestamp_us": null,
          "width": 720,
          "fallback": null
        }
      ],
      "like_and_view_counts_disabled": false,
      "coauthor_producers": [
        {
          "strong_id__": "68137148105",
          "pk": 68137148105,
          "pk_id": "68137148105",
          "id": "68137148105",
          "username": "en_psixi",
          "full_name": "",
          "is_private": false,
          "is_verified": false,
          "profile_pic_id": "3822113780445062331_68137148105",
          "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/..."
        },
        {
          "strong_id__": "59386353188",
          "pk": 59386353188,
          "pk_id": "59386353188",
          "id": "59386353188",
          "username": "_eros.a",
          "full_name": "ἔ ρ ω ς",
          "is_private": false,
          "is_verified": false,
          "profile_pic_id": "3091603214372483610_59386353188",
          "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/..."
        }
      ],
      "is_paid_partnership": false
    },
    {
      "pk": "3870756630392485359",
      "id": "3870756630392485359_75057789494",
      "code": "DW3sKWuiDXv",
      "taken_at": "2026-04-08T12:11:02Z",
      "taken_at_ts": 1775650262,
      "media_type": 2,
      "product_type": "clips",
      "thumbnail_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "location": null,
      "user": {
        "pk": "75057789494",
        "id": "75057789494",
        "username": "lucifa_therapper",
        "full_name": "LucifaTheRapper",
        "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/...",
        "profile_pic_url_hd": null,
        "is_private": false,
        "is_verified": false
      },
      "comment_count": 80,
      "comments_disabled": false,
      "like_count": 1258,
      "play_count": 18603,
      "has_liked": false,
      "caption_text": "#islam #love #muslim #peace #family",
      "accessibility_caption": null,
      "usertags": [],
      "sponsor_tags": [],
      "video_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "view_count": 0,
      "video_duration": 37.70000076293945,
      "title": "",
      "resources": [],
      "image_versions": [
        {
          "estimated_scans_sizes": [
            8682,
            17365,
            26048
          ],
          "height": 1136,
          "scans_profile": "e15",
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "width": 640,
          "is_spatial_image": false
        }
      ],
      "video_versions": [
        {
          "bandwidth": 938321,
          "height": 1280,
          "id": "2021399742138766v",
          "type": 101,
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "url_expiration_timestamp_us": null,
          "width": 720,
          "fallback": null
        }
      ],
      "like_and_view_counts_disabled": false,
      "coauthor_producers": [],
      "is_paid_partnership": false
    },
    {
      "pk": "3870800882389149027",
      "id": "3870800882389149027_44253208819",
      "code": "DW32OTnEuVj",
      "taken_at": "2026-04-08T13:38:59Z",
      "taken_at_ts": 1775655539,
      "media_type": 2,
      "product_type": "clips",
      "thumbnail_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "location": null,
      "user": {
        "pk": "44253208819",
        "id": "44253208819",
        "username": "___.roshann00",
        "full_name": " Roshan",
        "profile_pic_url": "https://scontent-otp1-1.cdninstagram.com/...",
        "profile_pic_url_hd": null,
        "is_private": false,
        "is_verified": false
      },
      "comment_count": 8,
      "comments_disabled": false,
      "like_count": 465,
      "play_count": 5599,
      "has_liked": false,
      "caption_text": "Paro🩶🎶\n.\n.\n.\n.\n.\n#trending #love #hindi #reels #instagood",
      "accessibility_caption": null,
      "usertags": [],
      "sponsor_tags": [],
      "video_url": "https://scontent-otp1-1.cdninstagram.com/...",
      "view_count": 0,
      "video_duration": 34.566001892089844,
      "title": "",
      "resources": [],
      "image_versions": [
        {
          "estimated_scans_sizes": [
            9787,
            19574,
            29361
          ],
          "height": 1136,
          "scans_profile": "e15",
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "width": 640,
          "is_spatial_image": false
        }
      ],
      "video_versions": [
        {
          "bandwidth": 0,
          "height": 1280,
          "id": "1258660423130792v",
          "type": 101,
          "url": "https://scontent-otp1-1.cdninstagram.com/...",
          "url_expiration_timestamp_us": null,
          "width": 720,
          "fallback": null
        }
      ],
      "like_and_view_counts_disabled": false,
      "coauthor_producers": [],
      "is_paid_partnership": false
    }
  ],
  "WyI1YzdlY2Q2MmYzODg0MWVjODYwZWEwZDg0N2MzNDQ2ZiIsW10sMV0="
]

---

Deprecated endpoints

These endpoints are deprecated — use the recommended alternatives. Retired ones respond with 410 Gone and are never charged (see Response Codes); the rest still work but will be removed in a future version.

~~GET /v1/hashtag/medias/clips~~

Warning

Use /v1/hashtag/medias/clips/chunk or /v2/hashtag/medias/clips instead

~~GET /v1/hashtag/medias/recent~~

Warning

Hashtag Medias Recent

~~GET /v1/hashtag/medias/recent/chunk~~

Warning

Hashtag Medias Recent Chunk

~~GET /v1/hashtag/medias/top~~

Warning

Use /v1/hashtag/medias/top/chunk or /v2/hashtag/medias/top instead

~~GET /v1/hashtag/medias/top/recent/chunk~~

Warning

Use /v1/hashtag/medias/top/chunk or /v2/hashtag/medias/top instead

---

Ready to integrate? First 100 requests free — Get your API key →