Search

Search Instagram for the posts under a hashtag

What Instagram lists under a hashtag, read through a paid reader: shortcode, author, caption, exact likes, comments and plays, the date and the cover. sort: top (the default) is Instagram's own mix of popular and recent posts, in its order, not a ranking by likes, and it can reach back months. sort: recent lists the newest posts first. A page lists 24 to 33 posts: pass nextCursor back as cursor for the next one, which is another read. A like count the owner hid reads null. A tag with no posts answers an empty page and costs nothing. A deployment with no Instagram reader configured answers 503 before it charges. Cached for fifteen minutes.

get/search/instagram-hashtag

Request

  • Base URL: https://api.socially.run/v1
  • URL: https://api.socially.run/v1/search/instagram-hashtag
  • Auth: HTTP bearer

Query parameters

qstring required

A hashtag, with or without its # ("padaria" or "#padaria"). Letters, digits and underscores only.

limitinteger

Posts to return, 1–40. One page is one read: a smaller limit on the same tag is served from it, and then no nextCursor comes with it.

sort'top' | 'recent'

top (the default) is Instagram's own mix of popular and recent posts, in its order. recent lists the newest posts first.

cursorstring

The nextCursor of the page before. Each page is another read and another charge, and a cursor only works with the source and the sort that made it.

refreshboolean

Read the page again instead of serving the fifteen-minute cache. Charged like any read, and the fresh answer replaces the cached one.

Response

Search Instagram for the posts under a hashtag

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.