Instagram Basic Display API: Obtaining an Access Token

Posted on by justinstolpe

In this post we learn how to obtain and access token from the Instagram Basic Display API with a code passed to us from Instagram once the user has authorized our application. The access token we get is short lived meaning it will only be valid for an hour or so. In the next blog post we will learn how to exchange this short lived access token, for a long lived access token which can be used for up to 60 days.

Required to continue: Facebook app with Instagram product added

Step 1: Generate the Authorization URL

This URL will take the user to Instagram and present them with a pop up. The pop up will ask the user to Authorize our app so our app can read the users Instagram information.

app pop up

Authorization URL Structure

https://api.instagram.com/oauth/authorize?app_id={app-id}&redirect_uri={redirect-uri}&scope=user_profile,user_media&response_type=code

  • {app-id}: Instagram App ID. In the developer app dashboard got to “Instagram > Basic Display”
  • {redirect-uri}: This must match a URI that has been entered into the apps “Valid OAuth Redirect URIs” in the apps dashboard.

 
app creds

Once you have the Authorization URL, place it inside of an <a> tag for the user to click on.

<!-- Link to take user to Instagram for authorization with our app -->
<a href="https://api.instagram.com/oauth/authorize?app_id={app-id}&redirect_uri={redirect-uri}&scope=user_profile,user_media&response_type=code">
    Authorize W/Instagram
</a>

Step 2: Obtaining the Access Token

When the user Authorizes our app, Instagram sends them to the {redirect-uri} we passed along in the authorization URL and appends on a code. On our website, we will check for this code in the URL. If code exists in the URL, use it to get an access token. If no code variable exists in the URL, display the “Authorize W/Instagram” link from step 1 above. The URL will look like this.

Instagram Redirect URI with code: {redirect-uri}?code={ig-code}
 

Access Token API Endpoint

Endpoint
https://api.instagram.com/oauth/access_token

Type
POST

Params

  • app_id: Instagram App ID. In the developer app dashboard go to “Instagram > Basic Display” and copy the “Instagram App ID”.
  • app_secret: Instagram App Secret. In the developer app dashboard go to “Instagram > Basic Display” and copy the “Instagram App Secret”.
  • redirect_uri: This must match one of the URIs that has been entered into the apps “Valid OAuth Redirect URIs” in the apps dashboard.
  • grant_type: authorization_code
  • code: {ig-code}

 

PHP CURL call to the Access Token API Endpoint

// base endpoint
$endpoint = 'https://api.instagram.com/oauth/access_token';

// params the endpoint requires
$params = array(
	'app_id' => 'INSTAGRAM_APP_ID', // our instagram app id
	'app_secret' => 'INSTAGRAM_APP_SECRET', // our instagram app secret
	'grant_type' => 'authorization_code',
	'redirect_uri' => 'INSTAGRAM_APP_REDIRECT_URI', // our redirect uri
	'code' => $_GET['code'] // code instagram sent us in the URL
);			

// open curl call
$ch = curl_init();

// set type to post and pass the fields along 
curl_setopt( $ch, CURLOPT_POSTFIELDS, http_build_query( $params ) );
curl_setopt( $ch, CURLOPT_POST, 1 );

// set curl url
curl_setopt( $ch, CURLOPT_URL, $endpoint );

// set other curl options
curl_setopt( $ch, CURLOPT_SSL_VERIFYHOST, false );
curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, false ); 
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );

// get response, close curl, make php array
$response = curl_exec( $ch );

// close cur
curl_close( $ch );

// make nice php array :D
$responseArray = json_decode( $response, true );

// print out the response array that contains the access token
echo '<pre>';
print_r( $responseArray );

This CURL call hits our Instagram endpoint with the required parameters and receives a response from Instagram with an access token. If any of the parameters are incorrect, an error message will be returned. The access token here is a short lived access token meaning it is not valid for very long. In the next post, this short lived access token will be exchanged for a long lived access token.

Links
Code on GitHub

YouTube Video

That is going to do it for this post! Leave any comments/questions/concerns below and thanks for stopping by the blog!

147 comments

  2. I loved as much as you’ll receive carried out right here.
    The sketch is tasteful, your authored material stylish.

    nonetheless, you command get got an shakiness over that you wish be delivering the
    following. unwell unquestionably come further formerly again as exactly the same nearly very often inside case you shield
    this hike.

  3. I truly love your website.. Great colors & theme. Did you make this amazing site yourself?

    Please reply back as I’m planning to create my very own site
    and want to know where you got this from or exactly what
    the theme is called. Many thanks!

  4. This is the right webpage for anybody who hopes to find out about this topic.

    You realize so much its almost tough to argue with you (not that I actually will need to…HaHa).
    You definitely put a new spin on a topic that has been discussed for
    decades. Excellent stuff, just excellent!

  5. 타임케어 서울출장홈타이 – 서울출장마사지와 서울출장안마 서울홈타이
    서비스를 전국 어디서나 24시간 편하게!

    전문 마사지사의 맞춤 홈케어로 피로를 빠르게 해소하고 최상의 힐링을 경험하세요.

    선입금 없는 후불제 운영으로 더욱 안심!

  6. I’m curious to find out what blog platform you are using?

    I’m experiencing some minor security problems with my latest blog and I’d like to find something more safe.

    Do you have any suggestions?

  7. Heya! I realize this is kind of off-topic however I needed
    to ask. Does running a well-established blog like yours require a massive amount work?
    I am completely new to operating a blog but I do write in my diary daily.
    I’d like to start a blog so I will be able to share my personal experience
    and thoughts online. Please let me know if you have any
    kind of ideas or tips for brand new aspiring blog owners.

    Thankyou!

  9. This is the right website for everyone who wants to find out about this topic. You understand so much its almost hard to argue with you (not that I personally would want to…HaHa). You definitely put a fresh spin on a topic that has been discussed for many years. Excellent stuff, just wonderful.

  10. This is very interesting, You are a very skilled blogger.
    I have joined your feed and look forward to seeking more of your
    great post. Also, I have shared your site in my social
    networks!

  11. hello there and thank you for your information – I’ve definitely picked
    up anything new from right here. I did however expertise several technical points using
    this website, since I experienced to reload the site lots
    of times previous to I could get it to load correctly.
    I had been wondering if your hosting is OK?
    Not that I am complaining, but sluggish loading instances times will often affect your
    placement in google and could damage your high quality score if ads and marketing
    with Adwords. Anyway I’m adding this RSS to my email and can look out for much more of your respective
    exciting content. Ensure that you update this again very soon.

  12. Great information. Lucky me I discovered your website by accident (stumbleupon).

    I’ve saved as a favorite for later!

  14. 인천출장마사지 홈타이 마사지부터 아로마테라피, 스웨디시, 스포츠 마사지까지 원하는 스타일을 선택할 수 있습니다.

    고객님의 취향과 몸 상태에 맞게 코스를 조정해 드립니다.

  15. I take pleasure in, lead to I found just what I used to be taking a look for.

    You have ended my 4 day lengthy hunt! God Bless you man.
    Have a great day. Bye

  18. 수원출장마사지 홈타이 마사지부터 아로마테라피, 스웨디시,
    스포츠 마사지까지 원하는 스타일을 선택할 수 있습니다.
    고객님의 취향과 몸 상태에 맞게 코스를 조정해 드립니다.

  19. What’s Happening i’m new to this, I stumbled upon this I have discovered It positively
    helpful and it has aided me out loads. I’m hoping
    to give a contribution & aid different customers like its
    helped me. Great job.

  20. I do not know whether it’s just me or if perhaps everybody else encountering issues with
    your blog. It seems like some of the written text in your content are running
    off the screen. Can someone else please comment and let
    me know if this is happening to them too? This might be a issue
    with my web browser because I’ve had this happen before.
    Appreciate it

  21. With havin so much content do you ever run into any problems of
    plagorism or copyright infringement? My site has a lot of completely unique content I’ve either created myself or outsourced but
    it appears a lot of it is popping it up all over the web without my agreement.
    Do you know any techniques to help protect against content from being ripped off?
    I’d really appreciate it.

  22. I just like the helpful information you provide for your articles.
    I’ll bookmark your blog and check again here regularly.
    I’m slightly sure I will learn many new stuff proper here!
    Good luck for the next!

  24. 신용카드현금화의 의미, 카드깡과의 차이, 주의해야 할 광고 문구, 수수료 위험, 피해 예방 체크리스트, 합법적
    대안까지 안전하게 확인하세요.

  25. I know this web page provides quality dependent articles or reviews
    and additional material, is there any other site which offers such stuff in quality?

  26. Hey are using WordPress for your site platform? I’m new to the
    blog world but I’m trying to get started and create my own. Do you require any coding knowledge to make your own blog?

    Any help would be greatly appreciated!

  27. You can certainly see your expertise within the article you
    write. The world hopes for even more passionate writers such as
    you who aren’t afraid to mention how they believe.

    At all times follow your heart.

  28. I really like your blog.. very nice colors & theme.
    Did you create this website yourself or did you hire someone to do it for you?
    Plz respond as I’m looking to create my own blog and would like to find out where u got this from.
    appreciate it

  29. I know this if off topic but I’m looking into starting my own blog and
    was wondering what all is required to get set up?
    I’m assuming having a blog like yours would cost a pretty penny?
    I’m not very web smart so I’m not 100% positive.
    Any tips or advice would be greatly appreciated.
    Appreciate it

  30. This is very interesting, You are a very skilled blogger.
    I have joined your rss feed and look ahead to in quest of extra of your wonderful post.
    Also, I’ve shared your site in my social networks

  32. Excellent post. Keep writing such kind of information on your page.
    Im really impressed by your blog.
    Hey there, You have performed a great job.
    I will certainly digg it and in my opinion recommend to my friends.
    I am confident they will be benefited from this site.

  33. hello!,I like your writing very much! percentage we keep in touch more
    approximately your post on AOL? I require a specialist
    in this area to unravel my problem. May be that is you! Taking a look ahead to see you.

  34. Hi there, I found your web site by the use of Google at the
    same time as looking for a comparable subject, your web site came up,
    it looks great. I’ve bookmarked it in my google bookmarks.

    Hello there, just changed into aware of your weblog thru Google,
    and located that it is really informative. I’m gonna watch out for
    brussels. I will be grateful if you happen to continue
    this in future. A lot of other folks shall be benefited
    out of your writing. Cheers!

  35. If some one needs to be updated with most recent technologies after that he must be visit this website and be
    up to date all the time.

  36. Pretty component to content. I simply stumbled upon your weblog and in accession capital to
    say that I get in fact loved account your blog posts.
    Anyway I’ll be subscribing to your feeds or even I success you get admission to constantly fast.

  37. I’ve been surfing on-line greater than three hours lately, yet
    I never found any interesting article like yours. It’s
    pretty price enough for me. In my view, if all web owners
    and bloggers made good content as you probably did, the
    web will be much more useful than ever before.

  38. Hi, i read your blog occasionally and i own a similar one and i was just curious if you get a lot of spam responses?
    If so how do you protect against it, any plugin or anything you can recommend?
    I get so much lately it’s driving me mad so any support is very much appreciated.

  39. Wonderful blog you have here but I was curious about if you knew of any forums that cover the same topics discussed here?
    I’d really love to be a part of online community
    where I can get feedback from other knowledgeable people that share the same interest.

    If you have any suggestions, please let me know.

    Thank you!

  41. Howdy! This post could not be written much better! Reading through this post reminds me of my previous roommate! He constantly kept talking about this. I most certainly will forward this post to him. Fairly certain he’ll have a good read. Thanks for sharing!

  42. Hmm is anyone else experiencing problems with the images on this blog loading?
    I’m trying to find out if its a problem on my end or if it’s the
    blog. Any suggestions would be greatly appreciated.

  44. Wow that was odd. I just wrote an incredibly long comment but after I clicked submit my comment didn’t appear.
    Grrrr… well I’m not writing all that over again. Anyhow, just wanted to say great blog!

  45. Pretty section of content. I just stumbled upon your blog and in accession capital to assert that I get actually enjoyed account your blog posts.
    Anyway I’ll be subscribing to your augment and
    even I achievement you access consistently rapidly.

  51. I do not even know the way I finished up here, but I believed
    this submit used to be good. I don’t understand who you are however definitely you’re going to a famous blogger in case
    you are not already. Cheers!

  53. I will immediately grasp your rss feed as I can’t in finding
    your e-mail subscription hyperlink or newsletter service. Do you have any?
    Please permit me recognize so that I may just subscribe.
    Thanks.

  54. Great work! That is the type of information that are meant to be shared around the
    internet. Disgrace on the search engines for now not positioning this post upper!
    Come on over and seek advice from my website . Thank you =)

  56. My partner and I stumbled over here by a different website and thought I might as well check things out.
    I like what I see so now i’m following you. Look forward to checking
    out your web page repeatedly.

  58. Fantastic post however I was wondering if you could write a litte more on this topic?

    I’d be very thankful if you could elaborate a
    little bit more. Many thanks!

  59. Generally I don’t learn post on blogs, however I would like to say that this write-up very compelled me
    to try and do so! Your writing style has been surprised me.
    Thanks, very nice post.

  60. Hi there, I discovered your website by means of Google while looking for a related matter,
    your website got here up, it appears to be like great.
    I’ve bookmarked it in my google bookmarks.
    Hello there, simply turned into aware of your weblog
    through Google, and located that it’s really informative. I’m going to be careful for brussels.
    I’ll appreciate for those who proceed this in future.
    A lot of other people will probably be benefited from your writing.

    Cheers!

  63. Wow that was unusual. I just wrote an extremely long comment but after I clicked submit my comment didn’t appear.

    Grrrr… well I’m not writing all that over again. Anyhow, just wanted
    to say fantastic blog!

  64. Wow that was unusual. I just wrote an incredibly long comment but after I clicked submit my comment didn’t
    show up. Grrrr… well I’m not writing all that over again. Anyhow, just wanted to say superb blog!

  66. Thanks for some other magnificent article. The place
    else could anybody get that kind of information in such a perfect method of writing?
    I’ve a presentation next week, and I am on the look for such info.

  67. Great beat ! I would like to apprentice while
    you amend your website, how can i subscribe for a weblog web site?
    The account aided me a applicable deal. I had been tiny bit acquainted of this your broadcast provided shiny transparent concept

  70. Nice post. I learn something new and challenging on sites I stumbleupon every day.
    It will always be exciting to read articles from other authors
    and practice something from their websites.

  72. I’m not sure exactly why but this weblog is loading
    extremely slow for me. Is anyone else having this issue or is
    it a issue on my end? I’ll check back later on and see if the problem still exists.

  74. Wonderful beat ! I wish to apprentice while you
    amend your site, how could i subscribe for a blog site?
    The account helped me a acceptable deal. I were tiny bit acquainted of this your
    broadcast provided vibrant clear idea

  75. Magnificent items from you, man. I have have in mind your
    stuff prior to and you are simply too excellent. I really
    like what you’ve got right here, certainly
    like what you are saying and the way wherein you say it.
    You make it enjoyable and you continue to care for to keep it wise.

    I can’t wait to read much more from you. That is
    actually a tremendous site.

  78. I was curious if you ever considered changing the page layout of your website?
    Its very well written; I love what youve got to say. But maybe you could a little more in the way of content so people could connect with it better.
    Youve got an awful lot of text for only having 1 or
    2 pictures. Maybe you could space it out better?

  79. Hey there would you mind stating which blog platform you’re using?
    I’m looking to start my own blog soon but I’m having
    a tough time deciding between BlogEngine/Wordpress/B2evolution and Drupal.
    The reason I ask is because your design and style seems different
    then most blogs and I’m looking for something unique.

    P.S Apologies for being off-topic but I had to ask!

  81. When I initially commented I clicked the “Notify me when new comments are added” checkbox and now each time a comment
    is added I get four e-mails with the same comment. Is there any way you can remove people from that service?
    Thank you!

  85. It’s a pity you don’t have a donate button! I’d definitely donate to this superb blog!

    I guess for now i’ll settle for book-marking and adding your RSS feed to my Google
    account. I look forward to brand new updates and will share this site with my Facebook group.
    Talk soon!

  86. Oh my goodness! Incredible article dude! Thanks,
    However I am encountering difficulties with your
    RSS. I don’t know the reason why I can’t join it.
    Is there anyone else having identical RSS issues?
    Anybody who knows the answer can you kindly respond?
    Thanks!!

  88. 케어홈 수원출장마사지 안내 페이지입니다.
    수원역, 인계동, 광교, 영통, 권선동, 장안구,
    팔달구 등 수원 주요 지역의 수원출장안마,
    출장안마, 출장홈타이 이용 방법과 지도, QNA를 확인하세요.

  89. Superb blog! Do you have any tips for aspiring writers? I’m hoping to start my
    own website soon but I’m a little lost on everything. Would
    you advise starting with a free platform like WordPress
    or go for a paid option? There are so many options out there that I’m
    completely overwhelmed .. Any recommendations?
    Many thanks!

  90. Appreciating the hard work you put into your website and in depth information you present.

    It’s great to come across a blog every once in a while that
    isn’t the same out of date rehashed information. Wonderful read!

    I’ve saved your site and I’m adding your RSS feeds to my
    Google account.

  92. Howdy! Would you mind if I share your blog with my twitter group?
    There’s a lot of people that I think would really appreciate your content.
    Please let me know. Cheers

  93. I do accept as true with all of the ideas you’ve offered
    on your post. They’re really convincing and will
    definitely work. Still, the posts are too quick for beginners.
    May you please lengthen them a little from subsequent time?
    Thanks for the post.

  97. Thanks a lot for sharing this with all of us you really realize
    what you’re talking approximately! Bookmarked. Please additionally consult with my site =).
    We can have a link exchange contract among us

  98. I’d like to thank you for the efforts you’ve put in penning this website.

    I’m hoping to see the same high-grade blog
    posts by you later on as well. In truth, your creative writing abilities
    has motivated me to get my own website now 😉

  100. Hi there would you mind sharing which blog platform you’re using?
    I’m planning to start my own blog soon but I’m having a hard time choosing between BlogEngine/Wordpress/B2evolution and Drupal.
    The reason I ask is because your design seems
    different then most blogs and I’m looking
    for something completely unique. P.S My apologies for being off-topic but I had to ask!

  102. An impressive share! I’ve just forwarded this onto a colleague who has been conducting a little homework on this.
    And he actually ordered me breakfast because I found it for
    him… lol. So let me reword this…. Thank YOU
    for the meal!! But yeah, thanks for spending some time to discuss this subject here on your internet site.

  104. Hi there! I just wanted to ask if you ever have any trouble with hackers?
    My last blog (wordpress) was hacked and I
    ended up losing several weeks of hard work due to no backup.
    Do you have any solutions to protect against hackers?

  105. Aw, this was an incredibly good post. Taking the
    time and actual effort to generate a great article… but what can I say… I
    put things off a whole lot and never manage to get anything done.

  106. I think what you published made a ton of sense. But, think
    about this, suppose you were to write a awesome headline?
    I mean, I don’t wish to tell you how to run your website, however what if you
    added a post title to maybe get a person’s attention? I mean Instagram Basic Display API:
    Obtaining an Access Token – Justin Stolpe is a little plain. You might glance at Yahoo’s front page
    and see how they create news headlines to grab people to open the links.
    You might try adding a video or a related picture or two to
    get readers excited about everything’ve written. In my opinion, it would make your
    website a little bit more interesting.

  108. I know this if off topic but I’m looking into starting my own blog and was wondering what all is required to get set up?
    I’m assuming having a blog like yours would cost a pretty penny?
    I’m not very internet smart so I’m not 100% certain. Any tips or advice would be greatly appreciated.
    Appreciate it

  109. Thanks for another wonderful article. Where else may just anybody get that type of information in such a perfect means
    of writing? I have a presentation subsequent week, and I am at the search for such information.

  113. whoah this weblog is wonderful i really like studying your
    posts. Keep up the good work! You know, many individuals are looking round for this information,
    you could aid them greatly.

  117. 케어홈 울산출장마사지 안내 페이지입니다.
    삼산동, 달동, 성남동, 공업탑, 무거동, 울산역,
    동구 등 울산 주요 지역의 울산출장안마, 출장안마, 출장홈타이 이용 방법

  118. Hi, i read your blog from time to time and i own a similar one and i was just wondering if you get a lot of
    spam feedback? If so how do you stop it, any plugin or anything you can recommend?
    I get so much lately it’s driving me insane so
    any help is very much appreciated.

  119. Yesterday, while I was at work, my cousin stole my apple ipad and tested to see if
    it can survive a thirty foot drop, just so she can be a youtube sensation. My apple ipad is now destroyed and she
    has 83 views. I know this is entirely off topic but I had to share it with someone!

  120. I am extremely impressed with your writing skills
    and also with the layout on your weblog. Is this a paid theme or did you modify it yourself?
    Either way keep up the nice quality writing, it is rare to see a great blog like this one these days.

  122. Hiya very nice website!! Man .. Beautiful .. Superb ..
    I’ll bookmark your blog and take the feeds also? I am glad to find a lot of
    useful information right here within the submit, we want work out extra techniques on this regard, thank you for sharing.
    . . . . .

  123. Write more, thats all I have to say. Literally, it seems as though you relied on the
    video to make your point. You clearly know what youre talking about, why throw away
    your intelligence on just posting videos to your weblog when you could
    be giving us something informative to read?

  124. I have to thank you for the efforts you have put in penning this website.
    I am hoping to view the same high-grade content by you later on as well.

    In fact, your creative writing abilities has encouraged me to get my own blog now 😉

  125. 케어홈 창원출장마사지 안내 페이지입니다.

    상남동, 중앙동, 마산, 진해, 성산구, 의창구, 팔용동,
    봉곡동, 창원중앙역 등 창원 주요 지역의 창원출장안마, 출장안마

  126. 야코레드의 의미와 검색 의도, 변경
    주소와 사칭 페이지를 구별하는 기준, 개인정보·피싱 위험, 불법촬영물과 아동·청소년 성착취물
    관련 법적 주의사항을 한눈에 정리합니다.

  128. You really make it appear really easy along with your presentation but I to
    find this topic to be really one thing which I believe I would by no means understand.

    It kind of feels too complicated and extremely huge
    for me. I’m having a look ahead on your subsequent post, I will try to get
    the hold of it!

  130. What i don’t realize is in reality how you’re not actually a lot
    more smartly-preferred than you may be now.
    You are so intelligent. You understand therefore significantly in relation to this matter,
    made me in my opinion imagine it from a lot of
    varied angles. Its like women and men aren’t interested until
    it’s something to accomplish with Lady gaga! Your individual stuffs outstanding.
    At all times deal with it up!

  131. Great post. I was checking constantly this weblog and I’m impressed!
    Very useful info specially the closing section :
    ) I handle such info a lot. I was looking for
    this particular information for a long time. Thank you and good luck.

  132. Heya i’m for the first time here. I found this board and I find It truly useful & it
    helped me out much. I hope to give something back and help others like you aided me.

  135. Currently it looks like Expression Engine is the best blogging platform available
    right now. (from what I’ve read) Is that what you’re using on your blog?

  137. You have made some really good points there. I looked on the net for more information about the issue and found most people will go along with your views on this site.

  138. 오피스타(OPISTA)의 안전한 이용 방법과 최신 접속 주소 변경
    정보를 안내합니다. 오피스타
    커뮤니티 이용 팁, 개인정보 보호 수칙,
    검증된 업체 이용법 및 자주 묻는 질문(FAQ)까지 한번에 확인하세요.

  139. 케어홈 서울출장마사지 안내 페이지입니다.
    강남, 서초, 송파, 마포, 영등포 등 서울 전지역 출장마사지, 출장안마, 출장홈타이
    이용 방법과 지도, Q&A를 확인하세요.

  140. whoah this blog is fantastic i love reading your articles.

    Keep up the great work! You know, a lot of individuals are hunting around for this information, you could aid them greatly.

  141. Great goods from you, man. I’ve understand your stuff previous
    to and you’re just too great. I really like what you’ve acquired here, really like what
    you are saying and the way in which you say it. You make it entertaining and you
    still take care of to keep it smart. I can not wait to read
    much more from you. This is actually a wonderful website.

  142. 오피가이드를 처음 이용하시나요? 허위 리뷰를 걸러내고 안전하게 업소를 찾는 방법부터 최신 트렌드, 자주 묻는 질문까지 한눈에 파악할 수
    있는 완벽한 오피가이드 활용 매뉴얼을 확인해 보세요.

Leave a Reply

Your email address will not be published. Required fields are marked *