API

Instagram

Capture and share the world's moments.

Location Endpoints

  • GET /locations/location-id Get information about a location.
  • GET /locations/location-id/media/recent Get a list of media objects from a given location.
  • GET /locations/search Search for a location by geographic coordinate.

GET /locations/location-id

  • Response
https://api.instagram.com/v1/locations/{location-id}?access_token=ACCESS-TOKEN
{ "data": { "id": "1", "name": "Dogpatch Labs" , "latitude": 37.782, "longitude": -122.387, } } 

Get information about a location.

GET /locations/location-id/media/recent

  • Response
https://api.instagram.com/v1/locations/{location-id}/media/recent?access_token=ACCESS-TOKEN
{ "data": [{ "type": "image", "users_in_photo": [], "filter": "Earlybird", "tags": ["expobar"], "comments": { "data": [], "count": data: [], count: 0 }, "caption": { "created_time": "1296532028", "text": "@mikeyk pulls a shot on our #Expobar", "from": { "username": "josh", "full_name": "Josh Riedel", "type": "user", "id": "33" }, "id": "25663923" }, "likes": { "count": 35, "data": [{ "username": "mikeyk", "full_name": "Mikeyk", "id": "4", "profile_picture": "..." }, {...subset of likers...}] }, "link": "http://instagr.am/p/BUS3X/", "user": { "username": "josh", "profile_picture": "...", "id": "33" }, "created_time": "1296531955", "images": { "low_resolution": { "url": "http://distillery.s3.amazonaws.com/media/2011/01/31/32d364527512437a8a17ba308a7c83bb_6.jpg", "width": 306, "height": 306 }, "thumbnail": { "url": "http://distillery.s3.amazonaws.com/media/2011/01/31/32d364527512437a8a17ba308a7c83bb_5.jpg", "width": 150, "height": 150 }, "standard_resolution": { "url": "http://distillery.s3.amazonaws.com/media/2011/01/31/32d364527512437a8a17ba308a7c83bb_7.jpg", "width": 612, "height": 612 } }, "user_has_liked": false, "id": "22097367", "location": { "latitude": 37.780885099999999, "id": "514276", "longitude": -122.3948632, "name": "Instagram" } }, { "type": "video", "videos": { "low_resolution": { "url": "http://distilleryvesper9-13.ak.instagram.com/090d06dad9cd11e2aa0912313817975d_102.mp4", "width": 480, "height": 480 }, "standard_resolution": { "url": "http://distilleryvesper9-13.ak.instagram.com/090d06dad9cd11e2aa0912313817975d_101.mp4", "width": 640, "height": 640 }, "users_in_photo": null, "filter": "Vesper", "tags": [], "comments": { "data": [{ "created_time": "1279332030", "text": "Love the sign here", "from": { "username": "mikeyk", "full_name": "Mikey Krieger", "id": "4", "profile_picture": "http://distillery.s3.amazonaws.com/profiles/profile_1242695_75sq_1293915800.jpg" }, "id": "8" }, { "created_time": "1279341004", "text": "Chilako taco", "from": { "username": "kevin", "full_name": "Kevin S", "id": "3", "profile_picture": "..." }, "id": "3" }], "count": 2 }, "caption": null, "likes": { "count": 1, "data": [{ "username": "mikeyk", "full_name": "Mikeyk", "id": "4", "profile_picture": "..." }] }, "link": "http://instagr.am/p/D/", "user": { "username": "kevin", "full_name": "Kevin S", "profile_picture": "...", "id": "3" }, "created_time": "1279340983", "images": { "low_resolution": { "url": "http://distilleryimage2.ak.instagram.com/11f75f1cd9cc11e2a0fd22000aa8039a_6.jpg", "width": 306, "height": 306 }, "thumbnail": { "url": "http://distilleryimage2.ak.instagram.com/11f75f1cd9cc11e2a0fd22000aa8039a_5.jpg", "width": 150, "height": 150 }, "standard_resolution": { "url": "http://distilleryimage2.ak.instagram.com/11f75f1cd9cc11e2a0fd22000aa8039a_7.jpg", "width": 612, "height": 612 } }, "id": "3", "location": { "latitude": 37.780885099999999, "id": "514276", "longitude": -122.3948632, "name": "Instagram" } }, ...] } 

Get a list of recent media objects from a given location.

Parameters
min_timestamp Return media after this UNIX timestamp
min_id Return media before this min_id.
max_id Return media after this max_id.
max_timestamp Return media before this UNIX timestamp

GET /locations/search

  • Response
https://api.instagram.com/v1/locations/search?lat=48.858844&lng=2.294351&access_token=ACCESS-TOKEN
{ "data": [{ "id": "788029", "latitude": 48.858844300000001, "longitude": 2.2943506, "name": "Eiffel Tower, Paris" }, { "id": "545331", "latitude": 48.858334059662262, "longitude": 2.2943401336669909, "name": "Restaurant 58 Tour Eiffel" }, { "id": "421930", "latitude": 48.858325999999998, "longitude": 2.294505, "name": "American Library in Paris" }] } 

Search for a location by geographic coordinate.

Parameters
distance Default is 1000m (distance=1000), max distance is 5000.
facebook_places_id Returns a location mapped off of a Facebook places id. If used, a Foursquare id and lat, lng are not required.
foursquare_id Returns a location mapped off of a foursquare v1 api location id. If used, you are not required to use lat and lng. Note that this method is deprecated; you should use the new foursquare IDs with V2 of their API.
lat Latitude of the center search coordinate. If used, lng is required.
lng Longitude of the center search coordinate. If used, lat is required.
foursquare_v2_id Returns a location mapped off of a foursquare v2 api location id. If used, you are not required to use lat and lng.