Search Endpoints

Search users, hashtags, locations, and music.

Authentication & errors

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

Endpoints: /v1/fbsearch/places | /v1/fbsearch/topsearch | /v1/fbsearch/topsearch/hashtags | /v1/search/hashtags | /v1/search/music | /v1/search/users | /v1/share/by/code | /v1/share/by/url | /v1/share/reel/by/url

---

GET /v1/fbsearch/places

Search locations. Returns a list of matching results.

Parameter	Type	Required	Description
query	string	Yes	Query
lat	number	No	Lat
lng	number	No	Lng

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/fbsearch/places?query=natgeo"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.fbsearch_places_v1(query="natgeo")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/fbsearch/places",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"query": "natgeo"},
)
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/fbsearch/places?query=natgeo",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();

Example response

[
  {
    "pk": 252923412072688,
    "name": "NatGeo Roof Deck",
    "phone": "",
    "website": "",
    "category": "",
    "hours": {},
    "address": "161 6th Ave",
    "city": "",
    "zip": null,
    "lng": -74.004295349121,
    "lat": 40.725898742676,
    "external_id": "252923412072688",
    "external_id_source": "facebook_places"
  },
  {
    "pk": 617882014,
    "name": "أسرار Nat Geo",
    "phone": "",
    "website": "",
    "category": "",
    "hours": {},
    "address": "625 Union St",
    "city": "",
    "zip": null,
    "lng": -73.98444,
    "lat": 40.67817,
    "external_id": "219266724863910",
    "external_id_source": "facebook_places"
  },
  {
    "pk": 103142692753506,
    "name": "NatGeo Fish",
    "phone": "",
    "website": "",
    "category": "",
    "hours": {},
    "address": "8593 Fawn St. Brooklyn",
    "city": "",
    "zip": null,
    "lng": -73.89254,
    "lat": 40.66595,
    "external_id": "103142692753506",
    "external_id_source": "facebook_places"
  }
]

---

GET /v1/fbsearch/topsearch

Topsearch. Returns a list of matching results.

Parameter	Type	Required	Description
query	string	Yes	Query

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/fbsearch/topsearch?query=natgeo"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.fbsearch_topsearch_v1(query="natgeo")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/fbsearch/topsearch",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"query": "natgeo"},
)
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/fbsearch/topsearch?query=natgeo",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();

Example response

[
  {
    "position": 0,
    "user": {
      "strong_id__": "787132",
      "fbid_v2": 17841400573960012,
      "pk": 787132,
      "pk_id": "787132",
      "is_verified_search_boosted": false,
      "third_party_downloads_enabled": 2,
      "id": "787132",
      "full_name": "National Geographic",
      "is_private": false,
      "is_verified": true,
      "profile_pic_id": "3865702555259028436_787132",
      "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/...",
      "username": "natgeo",
      "account_badges": [],
      "has_anonymous_profile_picture": false,
      "has_opt_eligible_shop": false,
      "is_ring_creator": false,
      "latest_reel_media": 1775659002,
      "should_show_category": true,
      "show_ig_app_switcher_badge": true,
      "show_ring_award": false,
      "show_text_post_app_badge": true,
      "unseen_count": 0,
      "social_context": "274M followers",
      "search_social_context": "274M followers",
      "search_social_context_snippet_type": "typeahead_follow_count"
    }
  },
  {
    "position": 1,
    "user": {
      "strong_id__": "1934468093",
      "fbid_v2": 17841402042791808,
      "pk": 1934468093,
      "pk_id": "1934468093",
      "is_verified_search_boosted": false,
      "third_party_downloads_enabled": 1,
      "id": "1934468093",
      "full_name": "Nat Geo Channel Africa",
      "is_private": false,
      "is_verified": true,
      "profile_pic_id": "3694842092895346377_1934468093",
      "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/...",
      "username": "natgeo_africa",
      "account_badges": [],
      "has_anonymous_profile_picture": false,
      "has_opt_eligible_shop": false,
      "is_ring_creator": false,
      "latest_reel_media": 0,
      "should_show_category": true,
      "show_ig_app_switcher_badge": true,
      "show_ring_award": false,
      "show_text_post_app_badge": true,
      "unseen_count": 0,
      "social_context": "241K followers",
      "search_social_context": "241K followers",
      "search_social_context_snippet_type": "typeahead_follow_count"
    }
  },
  {
    "position": 2,
    "user": {
      "strong_id__": "414805671",
      "fbid_v2": 17841400650136481,
      "pk": 414805671,
      "pk_id": "414805671",
      "is_verified_search_boosted": false,
      "third_party_downloads_enabled": 2,
      "id": "414805671",
      "full_name": "National Geographic Science",
      "is_private": false,
      "is_verified": true,
      "profile_pic_id": "3865701954660099001_414805671",
      "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/...",
      "username": "natgeoscience",
      "account_badges": [],
      "has_anonymous_profile_picture": false,
      "has_opt_eligible_shop": false,
      "is_ring_creator": false,
      "latest_reel_media": 1775642636,
      "should_show_category": true,
      "show_ring_award": false,
      "show_text_post_app_badge": false,
      "unseen_count": 0,
      "social_context": "9.8M followers",
      "search_social_context": "9.8M followers",
      "search_social_context_snippet_type": "typeahead_follow_count"
    }
  }
]

---

GET /v1/fbsearch/topsearch/hashtags

Search hashtags via topsearch. Returns a list of matching results.

Parameter	Type	Required	Description
query	string	Yes	Query

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/fbsearch/topsearch/hashtags?query=love"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.fbsearch_topsearch_hashtags_v1(query="love")

import requests

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

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

Example response

[]

---

GET /v1/search/hashtags

Search hashtags. Returns a list of matching results.

Parameter	Type	Required	Description
query	string	Yes	Query

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/search/hashtags?query=love"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.search_hashtags_v1(query="love")

import requests

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

const response = await fetch(
  "https://api.hikerapi.com/v1/search/hashtags?query=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
  },
  {
    "id": "17843851987047311",
    "name": "lovehim",
    "media_count": 41384631,
    "allow_following": false,
    "profile_pic_url": null
  },
  {
    "id": "17843776981016110",
    "name": "lovestory",
    "media_count": 38695836,
    "allow_following": false,
    "profile_pic_url": null
  }
]

---

GET /v1/search/music

Search music. Returns a list of matching results.

Parameter	Type	Required	Description
query	string	Yes	Query

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/search/music?query=natgeo"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.search_music_v1(query="natgeo")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/search/music",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"query": "natgeo"},
)
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/search/music?query=natgeo",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();

Example response

[
  {
    "id": "1283502475113803",
    "title": "National Geographic",
    "subtitle": "",
    "display_artist": "Winterlight",
    "audio_cluster_id": "2045685665695806",
    "artist_id": null,
    "cover_artwork_uri": "https://scontent-atl3-1.cdninstagram.com/...",
    "cover_artwork_thumbnail_uri": "https://scontent-atl3-1.cdninstagram.com/...",
    "fast_start_progressive_download_url": "https://scontent-atl3-3.cdninstagram.com/...",
    "reactive_audio_download_url": null,
    "highlight_start_times_in_ms": [
      113000,
      128500,
      1500
    ],
    "is_explicit": false,
    "has_lyrics": false,
    "audio_asset_id": "1283502475113803",
    "duration_in_ms": 345560,
    "dark_message": null,
    "allows_saving": false,
    "territory_validity_periods": null
  },
  {
    "id": "3071277199804105",
    "title": "Until I Found You",
    "subtitle": "",
    "display_artist": "Stephen Sanchez, Em Beihold",
    "audio_cluster_id": "354492766725899",
    "artist_id": null,
    "cover_artwork_uri": "https://scontent-atl3-1.cdninstagram.com/...",
    "cover_artwork_thumbnail_uri": "https://scontent-atl3-1.cdninstagram.com/...",
    "fast_start_progressive_download_url": "https://scontent-atl3-1.cdninstagram.com/...",
    "reactive_audio_download_url": null,
    "highlight_start_times_in_ms": [
      27000,
      93000,
      66500
    ],
    "is_explicit": false,
    "has_lyrics": false,
    "audio_asset_id": "3071277199804105",
    "duration_in_ms": 176440,
    "dark_message": null,
    "allows_saving": false,
    "territory_validity_periods": null
  },
  {
    "id": "796720467705509",
    "title": "Nanila",
    "subtitle": "",
    "display_artist": "Sukhishvili Georgian National Ballet",
    "audio_cluster_id": "521947385822142",
    "artist_id": null,
    "cover_artwork_uri": "https://scontent-atl3-2.cdninstagram.com/...",
    "cover_artwork_thumbnail_uri": "https://scontent-atl3-2.cdninstagram.com/...",
    "fast_start_progressive_download_url": "https://scontent-atl3-2.cdninstagram.com/...",
    "reactive_audio_download_url": null,
    "highlight_start_times_in_ms": [
      45000,
      91000,
      60000
    ],
    "is_explicit": false,
    "has_lyrics": false,
    "audio_asset_id": "796720467705509",
    "duration_in_ms": 247680,
    "dark_message": null,
    "allows_saving": false,
    "territory_validity_periods": null
  }
]

---

GET /v1/search/users

Search users. Returns a list of matching results.

Parameter	Type	Required	Description
query	string	Yes	Query

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/search/users?query=natgeo"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.search_users_v1(query="natgeo")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/search/users",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"query": "natgeo"},
)
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/search/users?query=natgeo",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();

Example response

[
  {
    "pk": 787132,
    "id": "787132",
    "username": "natgeo",
    "full_name": "National Geographic",
    "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/...",
    "profile_pic_url_hd": null,
    "is_private": null,
    "is_verified": null
  },
  {
    "pk": 1934468093,
    "id": "1934468093",
    "username": "natgeo_africa",
    "full_name": "Nat Geo Channel Africa",
    "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/...",
    "profile_pic_url_hd": null,
    "is_private": null,
    "is_verified": null
  },
  {
    "pk": 23947096,
    "id": "23947096",
    "username": "natgeotravel",
    "full_name": "National Geographic Travel",
    "profile_pic_url": "https://scontent-jnb2-1.cdninstagram.com/...",
    "profile_pic_url_hd": null,
    "is_private": null,
    "is_verified": null
  }
]

---

GET /v1/share/by/code

Get share object by code (aGlnaGxpZ2h0OjE4MTQ2MjE2Njk4MDIyMTc0 -> {"pk": 18146216698022176, "type": "highlight"}). Returns shared content data.

Parameter	Type	Required	Description
code	string	Yes	Code

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/share/by/code?code=aGlnaGxpZ2h0OjE3ODkzMjA5ODI1MjgxMjIx"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.share_by_code_v1(code="aGlnaGxpZ2h0OjE3ODkzMjA5ODI1MjgxMjIx")

import requests

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

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

Example response

{
  "pk": "17893209825281221",
  "type": "highlight"
}

---

GET /v1/share/by/url

Get share object by url ( https://www.ins...ram.com/s/aGlnaGxpZ2h0OjE4MTQ2MjE2Njk4MDIyMTc0 -> {"pk": 18146216698022176, "type": "highlight"}). Returns shared content data.

Parameter	Type	Required	Description
url	string	Yes	Url

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/share/by/url?url=https://www.instagram.com/p/DRqAYKuAIUx/"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.share_by_url_v1(url="https://www.instagram.com/p/DRqAYKuAIUx/")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/share/by/url",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"url": "https://www.instagram.com/p/DRqAYKuAIUx/"},
)
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/share/by/url?url=https://www.instagram.com/p/DRqAYKuAIUx/",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();

---

GET /v1/share/reel/by/url

Returns shared content data.

Parameter	Type	Required	Description
url	string	Yes	Url

curlPythonPython (requests)JavaScript

curl -H "x-access-key: YOUR_TOKEN" \
  "https://api.hikerapi.com/v1/share/reel/by/url?url=https://www.instagram.com/p/DRqAYKuAIUx/"

from hikerapi import Client

cl = Client(token="YOUR_TOKEN")
result = cl.share_reel_by_url_v1(url="https://www.instagram.com/p/DRqAYKuAIUx/")

import requests

response = requests.get(
    "https://api.hikerapi.com/v1/share/reel/by/url",
    headers={"x-access-key": "YOUR_TOKEN"},
    params={"url": "https://www.instagram.com/p/DRqAYKuAIUx/"},
)
print(response.json())

const response = await fetch(
  "https://api.hikerapi.com/v1/share/reel/by/url?url=https://www.instagram.com/p/DRqAYKuAIUx/",
  { headers: { "x-access-key": "YOUR_TOKEN" } }
);
const data = await response.json();

---

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