Instagram API

Social / OAuth Advanced HTTPS

73 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

The Instagram Graph API allows you to access Instagram account data, media, comments, and insights for business and creator accounts. It uses OAuth 2.0 and requires users to grant permission through Facebook Login before you can access their Instagram data. Note that the legacy Instagram API is deprecated — use the Graph API via Facebook for Developers.

Beginner Tip

You must connect an Instagram Business or Creator account to a Facebook Page to use the Graph API — personal accounts are not supported. Start in sandbox mode with your own account to test without going through app review.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

stock price and symbol

open/close/high/low values

trading volume

market cap

historical price data

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "status": "success",
  "data": {
    "result": "Data from Instagram",
    "description": "Instagram Login, Share on Instagram, Social Plugins and more",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

id Unique identifier for the media object

caption The caption text written for the post

media_type Type of media: IMAGE, VIDEO, or CAROUSEL_ALBUM

permalink Permanent URL to the post on Instagram

timestamp ISO 8601 date and time when the media was posted

like_count Number of likes on the media; requires instagram_manage_insights permission

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://graph.instagram.com/me/media?fields=id,caption,media_type,permalink&access_token=YOUR_ACCESS_TOKEN";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

400 OAuthException: Invalid OAuth access token Access token is expired or was generated for a different app

✓ Refresh your long-lived access token or re-authenticate; Instagram user tokens expire after 60 days of inactivity

403 Insufficient Permission Missing required OAuth scopes for the endpoint you are calling

✓ Re-authorize the user with the needed scopes such as instagram_basic and instagram_content_publish in your Facebook app settings

Empty media array even though account has posts The account is a personal account, not a Business or Creator account

✓ Switch the Instagram account to Business or Creator in the Instagram app settings, then connect it to a Facebook Page

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →