Skip to main content
GET
/
v1
/
instagram
/
hashtag
/
posts
Get Hashtag Posts
curl --request GET \
  --url https://api.scraper.creatorlookup.com/v1/instagram/hashtag/posts \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "posts": [
      {
        "id": "<string>",
        "shortcode": "<string>",
        "product_type": "<string>",
        "caption": {},
        "timestamp": 123,
        "like_count": 123,
        "comment_count": 123,
        "media_type": "<string>",
        "media_url": "<string>",
        "thumbnail_url": {},
        "video_url": {},
        "is_video": true,
        "video_view_count": {},
        "video_duration": {},
        "dimensions": {},
        "location": {},
        "tagged_users": [
          "<string>"
        ],
        "hashtags": [
          "<string>"
        ],
        "music_info": {},
        "author": {
          "username": "<string>",
          "full_name": "<string>",
          "profile_pic_url": "<string>",
          "is_verified": true
        }
      }
    ],
    "pagination": {
      "next_cursor": {},
      "has_next_page": true,
      "total_count": {}
    }
  },
  "credits_used": 123,
  "credits_remaining": 123
}

​
Request

​
Headers

NameRequiredDescription
x-api-keyYesYour API key

​
Query parameters

​
hashtag
string
required
The hashtag to search for (without the # symbol).
​
tab
string
default:"recent"
Which tab to fetch. One of: top, recent, clips.
​
cursor
string
Pagination cursor from a previous response’s next_cursor field.

​
Response

​
data
object
​
credits_used
number
Credits deducted (1)
​
credits_remaining
number
Remaining credit balance
Cost: 1 credit

​
Examples

curl -H "x-api-key: sk-your-api-key" \
  "https://api.scraper.creatorlookup.com/v1/instagram/hashtag/posts?hashtag=travel&tab=recent"

​
200 — Success

{
  "data": {
    "posts": [
      {
        "id": "3456789012345678",
        "shortcode": "DAx1y2z3Ab",
        "product_type": "feed",
        "caption": "Beautiful sunset #travel #photography",
        "timestamp": 1707350400,
        "like_count": 12500,
        "comment_count": 340,
        "media_type": "image",
        "media_url": "https://scontent.cdninstagram.com/...",
        "thumbnail_url": null,
        "video_url": null,
        "is_video": false,
        "video_view_count": null,
        "video_duration": null,
        "dimensions": { "width": 1080, "height": 1350 },
        "location": "Bali, Indonesia",
        "tagged_users": [],
        "hashtags": ["travel", "photography"],
        "music_info": null,
        "author": {
          "username": "travelphotographer",
          "full_name": "Travel Photographer",
          "profile_pic_url": "https://scontent.cdninstagram.com/...",
          "is_verified": false
        }
      }
    ],
    "pagination": {
      "next_cursor": "eyJtYXhfaWQiOiIxMjM0NTY3ODkwIiwicGFnZSI6MSwibWVkaWFfaWRzIjpbXX0",
      "has_next_page": true,
      "total_count": null
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999
}

​
402 — Insufficient credits

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "This endpoint requires 1 credits, you have 0"
  }
}

​
502 — Scrape failed

{
  "error": {
    "code": "SCRAPE_FAILED",
    "message": "Hashtag not found or no results"
  }
}

​
504 — Timeout

{
  "error": {
    "code": "TIMEOUT",
    "message": "Scraping request timed out"
  }
}