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/","20151120023614","https://web.archive.org/","web","/_static/", "1447986974"); </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/20151120023614js_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.eot'); src: url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.woff') format("woff"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-bold-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120023614im_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.eot'); src: url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.woff') format("woff"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-boldit-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120023614im_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.eot'); src: url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.woff') format("woff"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-reg-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120023614im_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.eot'); src: url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.woff') format("woff"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-regit-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120023614im_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.eot'); src: url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.woff') format("woff"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-sbold-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120023614im_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.eot'); src: url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.eot#iefix') format("embedded-opentype"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.woff') format("woff"), url('//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/webfonts/proximanova-light-webfont.ttf') format("truetype"), url('//web.archive.org/web/20151120023614im_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/favicon.ico"><link rel="mask-icon" href="//web.archive.org/web/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/favicon.svg" color="#125688"> <link rel="apple-touch-icon-precomposed" href="//web.archive.org/web/20151120023614im_/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/20151120023614im_/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/20151120023614im_/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/20151120023614im_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/images/ico/apple-touch-icon-144x144-precomposed.png"> <link href="//web.archive.org/web/20151120023614cs_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/styles/developer/developer-main.css" type="text/css" rel="stylesheet"></link> <script src="//web.archive.org/web/20151120023614js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/jquery.js" type="text/javascript"></script> <script src="//web.archive.org/web/20151120023614js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/bluebar.js" type="text/javascript"></script> <script src="//web.archive.org/web/20151120023614js_/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/20151120023614/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/20151120023614/https://instagram.com/accounts/login/?next=/developer/"> <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/20151120023614/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/20151120023614/https://instagram.com/developer/"> Overview <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/authentication/"> Authentication <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/authorization/"> Login Permissions <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/review/"> Permissions Review <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/sandbox/"> Sandbox Mode <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/secure-api-requests/"> Secure Requests <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/endpoints/"> Endpoints <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/limits/"> Rate Limits <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/subscriptions/"> Subscriptions <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/embedding/"> Embedding <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/mobile-sharing/"> Mobile Sharing <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/libraries/"> Libraries <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/support/"> Support <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/developer/changelog/"> Changelog <i class="disclosure"></i> </a> </li> <li> <a href="/web/20151120023614/https://instagram.com/about/legal/terms/api/"> Platform Policy <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-blue"><b>Instagram Platform and documentation update.</b> Apps created on or after Nov 17, 2015 will start in Sandbox Mode and function on newly updated API rate-limits and behaviors. Prior to going Live, and being able to be used by people other than the developers of the app, these apps will have to go through a new review process. Please read the <a href="/web/20151120023614/https://instagram.com/developer/">API documentation</a> or the <a href="/web/20151120023614/https://instagram.com/developer/changelog/">Change Log</a> for more details.<br><br> Any app created before Nov 17, 2015 will continue to function <b>until June 2016</b>. After June 2016, the app will automatically be moved to Sandbox Mode if it wasn't approved through the review process. The previous version of our documentation is stil available <a href="/web/20151120023614/https://instagram.com/developer/deprecated/">here</a>.</p> </div> <div class="introduction-wrapper-tall"> <div class="introduction"> <h1>Hello Developers.</h1> <p> The Instagram API Platform can be used to build non-automated, authentic, high-quality apps and services that: <ul> <li> Help <b>individuals share their own content</b> with 3rd party apps. </li> <li> Help <b>brands and advertisers</b> understand, manage their audience and media rights. </li> <li> Help <b>broadcasters and publishers</b> discover content, get digital rights to media, and share media with proper attribution. </li> </ul> </p> <div class="cta"> <a class="button" href="/web/20151120023614/https://instagram.com/developer/clients/manage/">Register Your Application</a> <span class="after-register">then <a href="/web/20151120023614/https://instagram.com/developer/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/20151120023614/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/20151120023614/https://instagram.com/developer/authentication/">Authenticate</a></h3> <p>Ask users to <a href="/web/20151120023614/https://instagram.com/developer/authentication/">authenticate</a> and <a href="/web/20151120023614/https://instagram.com/developer/authorization/">authorize your application</a> with Instagram.</p> </li> <li class="step-3"> <h3><a href="/web/20151120023614/https://instagram.com/developer/endpoints/">Start making requests!</a></h3> <p>Make requests to our <a href="/web/20151120023614/https://instagram.com/developer/endpoints/">API Endpoints</a> with the users' OAuth credentials.</p> </li> </ol> </section> <section class="terms"> <h2>Platform Policy</h2> <p>Before you start using the API Platform, we have a few guidelines that we'd like to tell you about. Please make sure to read the full <a href="/web/20151120023614/https://instagram.com/about/legal/terms/api/">Platform Policy.</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 "insta", "gram" or "Instagram" in your company or product name.</li> <li>You cannot replicate the core user experience of the Instagram apps or web site. For example, do not build a media viewer.</li> <li>You cannot use the API Platform to crawl or store users' media without their express consent.</li> <li>Do not abuse the API Platform, automate requests, or encourage unauthentic behavior. This 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/20151120023614/https://instagram.com/about/us/">About us</a></li> <li><a href="https://web.archive.org/web/20151120023614/http://help.instagram.com/">Support</a></li> <li><a href="https://web.archive.org/web/20151120023614/http://blog.instagram.com/">Blog</a></li> <li><a href="https://web.archive.org/web/20151120023614/http://instagram.com/press/">Press</a></li> <li><a href="/web/20151120023614/https://instagram.com/developer/">API</a></li> <li><a href="/web/20151120023614/https://instagram.com/about/jobs/">Jobs</a></li> <li><a href="/web/20151120023614/https://instagram.com/legal/privacy/">Privacy</a></li> <li><a href="/web/20151120023614/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/20151120023614js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/polyfills/es5-shim.min.js"></script> <script src="//web.archive.org/web/20151120023614js_/https://instagramstatic-a.akamaihd.net/bluebar/bd9471f/scripts/polyfills/es5-sham.min.js"></script> <script type="text/javascript">window._sharedData = {"qs":"{\"shift\":10,\"header\":\"Injbg6Ot4SQXhnYVKTjJF4G1EfbRPwnl\",\"edges\":100,\"blob\":\"AQDUdJD73k_QQSyT9LEcfs7wfgjoD4hj7pVXhk52P8_-RgxhGyxhzdtim8gve9dfEdj0UtEC7b_Zg-9VSLC_DeEb0kxi3UaIC8Gwab1MtVPlrg1VlxjVYBYDW8b9dPAYGC3bEeT_HuE-Y0ZkIZD1A_1p6IihLKvDoHb4lJ8av20QSH_t2lLnI1pRSBI1acWXcZGXSf-jqLrKnjw8mF2L_n_sJ3MumFYv_PmI9xWDEPqyXQ\",\"iterations\":7,\"size\":42}","static_root":"\/\/web.archive.org\/web\/20151120023614\/https:\/\/instagramstatic-a.akamaihd.net\/bluebar\/bd9471f","entry_data":{},"hostname":"instagram.com","platform":"web","qe":{"su":{"p":{"enabled":"true"},"g":"test"}},"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":"7fb505f363d7e3fd1367a315e91485ad"},"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/20151120023614/https://connect.facebook.net/en_US/fbevents.js'); fbq('init', '1425767024389221'); fbq('track', 'PageView'); </script> <noscript> </noscript> </body> </html>

CINXE.COM

Instagram Developer Documentation