How Does Instagram's GET/tags/<tag>/media/recent Pagination Actually Work?

To get the newest set of grams for a particular tag, use this:

https://api.instagram.com/v1/tags/latergram/media/recent?access_token=TOKEN

From that response, you can get newer grams from the same tag by taking the min_tag_id from the response (under pagination) and build a url like so:

https://api.instagram.com/v1/tags/latergram/media/recent?access_token=TOKEN&min_tag_id=1387332980547

Or you can get the next (older) set of grams by using the next_url parameter from the original response (also under pagination), which looks like:

https://api.instagram.com/v1/tags/latergram/media/recent?access_token=TOKEN&max_tag_id=1387332905573

Make sure your subsequent queries (for new grams of a particular tag) are using the min_tag_id returned by the latest response. I did a few tests and didn't see duplicates, however I was using #latergram and that one has a high volume of posts


@zachallia has answered spot on, but I figure it can't hurt with a sketch:

As the Instagram API says: MIN_TAG_ID Return media before this min_tag_id. MAX_TAG_ID Return media after this max_tag_id.

This is counterintuitive, with a slightly nutty flavor. But still, it is possible to make sense of it.

The /tags/MYTAG/media/recent endpoint will give you grams, ordered by how newly they where tagged with MYTAG. You'll not get all grams, of course, just up to the limit set by Instagram:

|yesteryear ------------------ <---- LIMIT ----> now|

If you use min_tag_id like so /tags/MYTAG/media/recent?min_tag_id=X you'll get grams from X and before (aka older):

|yesteryear ------- <---- LIMIT ---> min ------- now|

If you use max_tag_id like so /tags/MYTAG/media/recent?max_tag_id=Y you'll get grams from Y and after (aka newer):

|yesteryear ------- max <---- LIMIT ---> ------- now|

That's how "max" gets to signify "newer" and "min" gets to signify "older".