Instagram Developer Documentation

<!DOCTYPE html>     <html lang="en" class="no-js not-logged-in ">  <head><script type="text/javascript" src="/_static/js/bundle-playback.js?v=HxkREWBo" charset="utf-8"></script> <script type="text/javascript" src="/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://instagram.com/developer/deprecated/","20151120103925","https://web.archive.org/","web","/_static/", "1448015965"); </script> <link rel="stylesheet" type="text/css" href="/_static/css/banner-styles.css?v=S1zqJCYt" /> <link rel="stylesheet" type="text/css" href="/_static/css/iconochive.css?v=3PDvdIFv" />  <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title>Instagram Developer Documentation</title> <script type="text/javascript"> WebFontConfig = { custom: { families: ['proxima-nova:n3,n4,n6,n7'], } }; </script> <script src="//web.archive.org/web/20151120103925js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/webfont.js" type="text/javascript" async></script> <style type="text/css"> /* @license * MyFonts Webfont Build ID 2164953, 2012-03-23T23:06:30-0400 * * The fonts listed in this notice are subject to the End User License * Agreement(s) entered into by the website owner. All other parties are * explicitly restricted from using the Licensed Webfonts(s). * * You may obtain a valid license at the URLs below. * * * Webfont: Proxima Nova Light by Mark Simonson * URL: http://www.myfonts.com/fonts/marksimonson/proxima-nova/light/ * Licensed pageviews: unlimited * * Webfont: Proxima Nova Regular by Mark Simonson * URL: http://www.myfonts.com/fonts/marksimonson/proxima-nova/regular/ * Licensed pageviews: unlimited * * Webfont: Proxima Nova Semibold by Mark Simonson * URL: http://www.myfonts.com/fonts/marksimonson/proxima-nova/semibold/ * Licensed pageviews: unlimited * * Webfont: Proxima Nova Bold Italic by Mark Simonson * URL: http://www.myfonts.com/fonts/marksimonson/proxima-nova/bold-it/ * Licensed pageviews: unlimited * * Webfont: Proxima Nova Bold by Mark Simonson * URL: http://www.myfonts.com/fonts/marksimonson/proxima-nova/bold/ * Licensed pageviews: unlimited * * Webfont: Proxima Nova Italic by Mark Simonson * URL: http://www.myfonts.com/fonts/marksimonson/proxima-nova/regular-it/ * Licensed pageviews: unlimited * * * License: http://www.myfonts.com/viewlicense?type=web&buildid=2164953 * Webfonts copyright: Copyright (c) Mark Simonson, 2005. All rights reserved. * * (c) 2012 Bitstream Inc */ @font-face { font-family: 'proxima-nova'; src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.eot'); src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.woff') format("woff"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.svg#ProximaNovaBold') format("svg"); font-weight: bold; font-style: normal; } @font-face { font-family: 'proxima-nova'; src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.eot'); src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.woff') format("woff"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.svg#ProximaNovaBoldItalic') format("svg"); font-weight: bold; font-style: italic; } @font-face { font-family: 'proxima-nova'; src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.eot'); src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.woff') format("woff"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.svg#ProximaNovaRegular') format("svg"); font-weight: normal; font-style: normal; } @font-face { font-family: 'proxima-nova'; src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.eot'); src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.woff') format("woff"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.svg#ProximaNovaRegularItalic') format("svg"); font-weight: normal; font-style: italic; } @font-face { font-family: 'proxima-nova'; src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.eot'); src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.woff') format("woff"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.svg#ProximaNovaSemibold') format("svg"); font-weight: 600; font-style: normal; } </style> <style type="text/css"> @font-face { font-family: 'proxima-nova'; src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.eot'); src: url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.woff') format("woff"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.svg#ProximaNovaLight') format("svg"); font-weight: 300; font-style: normal; } </style> <meta name="robots" content="noimageindex"> <meta name="apple-mobile-web-app-capable" content="yes"> <meta name="apple-mobile-web-app-status-bar-style" content="black"> <meta id="viewport" name="viewport" content="width=device-width, user-scalable=no, initial-scale=1, minimum-scale=1, maximum-scale=1"> <script type="text/javascript"> (function() { var docElement = document.documentElement; var classRE = new RegExp('(^|\\s)no-js(\\s|$)'); var className = docElement.className; docElement.className = className.replace(classRE, '$1js$2'); })(); </script> <link rel="Shortcut Icon" type="image/x-icon" href="//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/favicon.ico"><link rel="mask-icon" href="//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/favicon.svg" color="#125688"> <link rel="apple-touch-icon-precomposed" href="//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/apple-touch-icon-precomposed.png"> <link rel="apple-touch-icon-precomposed" sizes="72x72" href="//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/apple-touch-icon-72x72-precomposed.png"> <link rel="apple-touch-icon-precomposed" sizes="114x114" href="//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/apple-touch-icon-114x114-precomposed.png"> <link rel="apple-touch-icon-precomposed" sizes="144x144" href="//web.archive.org/web/20151120103925im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/apple-touch-icon-144x144-precomposed.png"> <link href="//web.archive.org/web/20151120103925cs_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/styles/developer/developer-main.css" type="text/css" rel="stylesheet"></link> <script src="//web.archive.org/web/20151120103925js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/jquery.js" type="text/javascript"></script> <script src="//web.archive.org/web/20151120103925js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/bluebar.js" type="text/javascript"></script> <script src="//web.archive.org/web/20151120103925js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/navigation.js" type="text/javascript"></script> <script> $(document).ready(function() { $('#top_bar_right .top-bar-actions').prepend("<li class='manage-clients link-settings'><a class='' href='/developer/clients/manage/'>Manage Clients<i></i></a></li>"); $('#top_bar_right .top-bar-actions').prepend("<li class='testing-clients link-settings'><a class='' href='/developer/clients/sandbox_invites/'>Sandbox Invites<i></i></a></li>"); }); </script> </head> <body class="sidebar-page"> <div class="root"> <div class="page"> <header class="top-bar"> <div class="wrapper"> <hgroup> <div class="logo"><a href="/web/20151120103925/https://instagram.com/">Instagram</a></div> </hgroup> <div class="top-bar-right account-state" id="top_bar_right"> <ul class="top-bar-actions" id="top_bar_actions"> <li id="link_profile" class="link-signin"> <a href="/web/20151120103925/https://instagram.com/accounts/login/?next=/developer/deprecated/"> <i></i> <strong>Log in</strong> </a> </li> </ul> </div> </div> </header>  <div class="sidebar"> <div class="wrapper"> <nav class="sidebar-nav"> <div class="sidebar-content"> <form class="quick-search" action="/web/20151120103925/https://instagram.com/developer/search/" method="GET"> <a href="#" class="disclosure-down"></a> <input name="q" type="text" placeholder="Search Documentation"/> <input type="submit"/> </form> <ul> <li class="active"> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/"> Overview <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/authentication/"> Authentication <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/secure-api-requests/"> Secure API Requests <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/realtime/"> Real-time <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/mobile-sharing/"> Mobile Sharing <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/api-console/"> API Console <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/endpoints/"> Endpoints <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/limits/"> Limits <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/embedding/"> Embedding <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/libraries/"> Libraries <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120103925/https://instagram.com/developer/deprecated/support/"> Support <i class="disclosure"></i> </a> </li> </ul> </div> </nav> </div> </div> <div class="main"> <div class="wrapper"> <section class="nav-page-content" role="main"> <div id="alerts" class="alerts"> <p class="alert-red"><b>Deprecated.</b> This section of the documentation is now deprecated and only applies to app created prior to Nov 17, 2015. New developers should refer to the <a href="/web/20151120103925/https://instagram.com/developer">Instagram Developer documentation</a>.</p> </div> <div class="introduction-wrapper"> <div class="introduction"> <h1>Hello Developers.</h1> <p>The first version of the Instagram API is an exciting step forward towards making it easier for users to have open access to their data. We created it so that you can surface the amazing content Instagram users share every second, in fun and innovative ways.</p> <p>Build something great.</p> <div class="cta"> <a class="button" href="/web/20151120103925/https://instagram.com/developer/clients/manage/">Register Your Application</a> <span class="after-register">then <a href="/web/20151120103925/https://instagram.com/developer/deprecated/authentication/">dive into the documentation</a></span> </div> </div> </div> <section id="getting_started" class="three-step"> <h2>Getting Started</h2> <ol> <li class="step-1"> <h3><a href="/web/20151120103925/https://instagram.com/developer/clients/manage/">Register</a></h3> <p>We'll assign an OAuth client_id and client_secret for each of your applications.</p> </li> <li class="step-2"> <h3><a href="/web/20151120103925/https://instagram.com/developer/deprecated/authentication/">Authenticate</a></h3> <p>Have our user <a href="/web/20151120103925/https://instagram.com/developer/deprecated/authentication/">authenticate and authorize your application</a> with Instagram.</p> </li> <li class="step-3"> <h3><a href="/web/20151120103925/https://instagram.com/developer/deprecated/endpoints/">Start making requests!</a></h3> <p>Make requests to our <a href="/web/20151120103925/https://instagram.com/developer/deprecated/endpoints/">API Endpoints</a> with your authenticated OAuth credentials.</p> </li> </ol> </section> <section class="terms"> <h2>API Terms of Use</h2> <p>Before you start using the API, we have a few guidelines that we'd like to tell you about. Please make sure to read the full <a href="/web/20151120103925/https://instagram.com/about/legal/terms/api/">API Terms of Use.</a> Here's what you'll read about:</p> <ol> <li>Instagram users own their media. It's your responsibility to make sure that you respect that right.</li> <li>You cannot use the Instagram name in your application.</li> <li>You cannot use the Instagram API to crawl or store users' media without their express consent.</li> <li>You cannot replicate the core user experience of Instagram.com</li> <li>Do not abuse the API. Too many requests too quickly will get your access turned off</li> </ol> </section> </section> </div>  </div>  </div>  <footer class="page-footer" role="contentinfo"> <div class="wrapper"> <nav> <ul> <li><a href="/web/20151120103925/https://instagram.com/about/us/">About us</a></li> <li><a href="https://web.archive.org/web/20151120103925/http://help.instagram.com/">Support</a></li> <li><a href="https://web.archive.org/web/20151120103925/http://blog.instagram.com/">Blog</a></li> <li><a href="https://web.archive.org/web/20151120103925/http://instagram.com/press/">Press</a></li> <li><a href="/web/20151120103925/https://instagram.com/developer/">API</a></li> <li><a href="/web/20151120103925/https://instagram.com/about/jobs/">Jobs</a></li> <li><a href="/web/20151120103925/https://instagram.com/legal/privacy/">Privacy</a></li> <li><a href="/web/20151120103925/https://instagram.com/legal/terms/">Terms</a></li> </ul> </nav> <p class="copyright">© 2015 Instagram</p> </div> </footer> <div id="reactModalMountPoint"></div> </div>  <script src="//web.archive.org/web/20151120103925js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/polyfills/es5-shim.min.js"></script> <script src="//web.archive.org/web/20151120103925js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/polyfills/es5-sham.min.js"></script> <script type="text/javascript">window._sharedData = {"qs":"{\"shift\":10,\"header\":\"O6yOU1Iy9aP5vEqgqHLTe2bjKcjyfckr\",\"edges\":100,\"blob\":\"AQCIA8aot94zztfg9wLAuY8pjLbjHY8uJ1_2ycp_yNNCwSd647AtAq2-MRCUaoQUqXRsor6AANVjCS-YaMpWNcF0Dlg41mOJTTjEtvA9Btnnq15VXqZDeHOnx8HrZoCQyK3RaHjjvul_fL7bLWhIq8fVRd1NcJqzYecj7eV4OuHhS66eCvX2pKiTqPWrOzwqD2WFaqPHUdPowHW77SZy_2tqCkQZeWEsESlenmo-6PE59w\",\"iterations\":7,\"size\":42}","static_root":"\/\/web.archive.org\/web\/20151120103925\/https:\/\/instagramstatic-a.akamaihd.net\/bluebar\/bd9471f","entry_data":{},"hostname":"instagram.com","platform":"web","qe":{"su":{"p":{},"g":""}},"display_properties_server_guess":{"viewport_width":360,"pixel_ratio":1.5},"country_code":"US","language_code":"en","gatekeepers":{"rhp":true},"config":{"dismiss_app_install_banner_until":null,"viewer":null,"csrf_token":"319b5f4e0c31acfb6ab7934088fc5b1b"},"environment_switcher_visible_server_guess":true};</script> <script> !function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod? n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n; n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0; t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window, document,'script','//web.archive.org/web/20151120103925/https://connect.facebook.net/en_US/fbevents.js'); fbq('init', '1425767024389221'); fbq('track', 'PageView'); </script> <noscript> </noscript> </body> </html>

CINXE.COM

Instagram Developer Documentation