Get started for $0
All APIs

Instagram API

Available

Get public Instagram profiles, posts, reels, comments, followers, stories, search, and more through one stable API.

Get your API keyRead the Instagram docs

$2.50 per 1,000 requests. Your first 100 are free, no card needed.

GET /v1/instagram/profiles/{identifier}
curl "https://api.openhandle.dev/v1/instagram/profiles/@northstar_forge_test" \
  -H "Authorization: Bearer $OPENHANDLE_TEST_KEY"
200 OK
{
  "platform": "instagram",
  "resource": "profile",
  "capturedAt": "2026-09-29T14:06:45Z",
  "source": "live",
  "data": {
    "suggestion": null,
    "mediaPreviews": null,
    "id": "910000000001",
    "handle": "northstar_forge_test",
    "displayName": "Northstar Forge",
    "bio": "Synthetic field tools for imaginary expeditions.\n📩 Bookings: fieldkit [at] example.openhandle.dev\n📞 +1 202 555 0143\nTikTok: @pixel_orchard_tt_test",
    "extracted": {
      "emails": [
        "fieldkit@example.openhandle.dev"
      ],
      "phones": [
        "+12025550143"
      ],
      "links": [],
      "handles": [
        {
          "platform": "tiktok",
          "handle": "pixel_orchard_tt_test"
        }
      ]
    },
    "url": "https://www.instagram.com/northstar_forge_test/",
    "externalUrl": "https://example.openhandle.dev/northstar-forge",
    "avatar": {
      "thumbnail": null,
      "id": "7144441704792374623_38164380",
      "type": null,
      "url": "https://media.openhandle.dev/AwTvIKqLpRK_zEEFuY_8mr0gk_KRgDuxmPBow2wB7yci_vSmH5AmMkn1xicjC2w14MS0h36sAik6ANvHSrkIYccu9onVbMSC9hrkf1ZEYae5uH9IEHUxFUHwKJYEU0ASo6--hw8PP4SdALeKRnERnoY8Y3FqMAkvoQ7kIBlzhzOHVQ",
      "width": null,
      "height": null,
      "isDefault": false,
      "isSpatial": null,
      "variants": [
        {
          "thumbnail": null,
          "id": null,
          "type": "image",
          "url": "https://media.openhandle.dev/A7drSFHoj4e23Z9TFAt0x6Aou4_DMSl5jw8erjtMUlStBqIdussEWJd3X5gos188IkZCLaYYWWTVIh8SQe71tPP4zhkSi3YH3GqDVx279bQAgAzHcXn5ynPIHZMo2aQfo8I5YREImHOTuwTYP3u6yD4XiMxtH4KsPa-ficOzQo4fHqrjnxVLBWNS5jA",
          "width": 1080,
          "height": 1080,
          "isDefault": null,
          "isSpatial": null,
          "variants": null
        },
        {
          "thumbnail": null,
          "id": null,
          "type": "image",
          "url": "https://media.openhandle.dev/AxMEwmSfjpE2mnA_eBVzgwa8P6cUh2SzF-GiZVLNX2q30iq_2JnU1zXSIYU7swa6rNrpTSOd7y71SPxR7-VXm0O_wGZzOmbW8u6cAmLncxtNBIDGw8H4mWpIJ-x4_tADRUnj9Osb4uMrlNVZyF05tn4hV_ASwwZT-jU0UWFphF2EPY8SXv7qZJP01Ro",
          "width": 320,
          "height": 320,
          "isDefault": null,
          "isSpatial": null,
          "variants": null
        },
        {
          "thumbnail": null,
          "id": null,
          "type": "image",
          "url": "https://media.openhandle.dev/A4C2M5QVgU5w7oQhlP2Fitdi4bDuptC7TouN9f59EfooD31gxfaB1hF95bR24ZA80Lkd550Fy1AzK9rcMaym8JnHUsJm920QgIUFX0oQx-GpBNlWUssehd0HvLJTTSyrPV923qgRF85jRA7m9aRjNqTPQG2JnFEi1lWaT1lPXVgUDPpsMue5CO5C4Bw",
          "width": 640,
          "height": 640,
          "isDefault": null,
          "isSpatial": null,
          "variants": null
        }
      ]
    },
    "fbid": "05256381029021081",
    "messagingFbid": "300737281056823",
    "isPrivate": false,
    "isVerified": true,
    "isBusiness": true,
    "isPotentialBusiness": false,
    "isUnpublished": null,
    "isMemorialized": false,
    "isNew": false,
    "isOpenToCollaboration": false,
    "isFacebookOnboardedCharity": false,
    "hasDigitalAvatar": false,
    "isAccountTransparencyVisible": true,
    "category": "Synthetic Workshop",
    "categoryId": null,
    "accountType": "creator",
    "socialContext": null,
    "lastStoryAt": "2026-09-09T16:04:58Z",
    "pronouns": [],
    "accountBadges": [],
    "bioEntities": [],
    "bioLinks": [
      {
        "id": "67393327525571776",
        "title": "Field guide",
        "url": "https://example.openhandle.dev/northstar-forge/guide",
        "type": "external",
        "isPinned": false,
        "isVerified": false,
        "icon": null,
        "image": null
      }
    ],
    "upcomingEvents": [],
    "metrics": {
      "followers": 48291,
      "following": 318,
      "posts": 5,
      "arEffects": null
    },
    "contact": {
      "email": "northstar@example.openhandle.dev",
      "phone": null,
      "phoneCountryCode": null,
      "contactPhone": null,
      "method": "EMAIL"
    },
    "location": {
      "id": "595989689479895",
      "address": {
        "street": "1 Synthetic Way",
        "city": "Test Harbor",
        "cityId": null,
        "postalCode": "00001"
      }
    },
    "fanClub": {
      "id": null,
      "name": null,
      "largestPublicBroadcastChannelId": null,
      "hasExclusiveFeedContent": false,
      "metrics": {
        "subscribers": null
      }
    },
    "content": {
      "hasHighlights": true,
      "hasLongformMedia": false,
      "hasVideos": true,
      "hasMusic": false,
      "hasGuides": false,
      "hasVisibleNotes": true
    },
    "contentSettings": {
      "postResharingEnabled": true,
      "highlightResharingEnabled": true,
      "postRemixingEnabled": true,
      "reelRemixingEnabled": true
    },
    "displaySettings": {
      "showCategory": false,
      "showPublicContacts": false
    },
    "threads": {
      "isActive": true,
      "handle": "sample_695124_test",
      "url": "https://example.openhandle.dev/sample-06966319",
      "joinerLabel": "100M+"
    },
    "broadcastChannels": {
      "isCreator": true,
      "hasPublicChannels": true,
      "pinned": [
        {
          "id": "272806359378749983639442212280752728063",
          "title": "Synthetic river ember lantern harbor harbor.",
          "url": "https://www.instagram.com/sample_225425_test/QkcbK1wtnEq5A8Yr/",
          "avatar": {
            "thumbnail": null,
            "id": null,
            "type": null,
            "url": "https://media.openhandle.dev/A_rcAAEDLAdnLF78WMyUUYYWEj0sJKRC5Rmh1Hz7STIY0o-gKGK8AJEDDqse7eVqkGBhhQ9CUCnfwoXdRMhd2ptZkt3YR3i5C57fGIXJ8asUbWf21BeoPVgmrPw-d0-sz-yajj3RVPfEKFtGtJrUBH8KyF_DsG_cF1I_4KwrPYplAUqqjCM",
            "width": null,
            "height": null,
            "isDefault": null,
            "isSpatial": null,
            "variants": null
          },
          "cover": null,
          "creator": {
            "id": null,
            "handle": "sample_695124_test",
            "isVerified": true
          },
          "metrics": {
            "members": 3864055
          }
        }
      ]
    },
    "fundraisers": {
      "metrics": {
        "active": 0
      },
      "items": []
    }
  }
}

The real answer to this request with a free Test key. Test keys read a synthetic dataset, so your first call returns the same answer. Only the capture time and the signed media links differ.

Endpoints

Everything public on Instagram, 43 operations.

Profiles, posts, comments, and more, grouped by what they read. Each one is one call.

Profiles

12 operations
  • Get a profileGET /v1/instagram/profiles/{identifier}
  • List profile postsGET /v1/instagram/profiles/{identifier}/posts
  • List profile reelsGET /v1/instagram/profiles/{identifier}/reels
  • List profile videosGET /v1/instagram/profiles/{identifier}/videos
  • List tagged postsGET /v1/instagram/profiles/{identifier}/tagged-posts
  • List profile repostsGET /v1/instagram/profiles/{identifier}/reposts
  • List pinned postsGET /v1/instagram/profiles/{identifier}/pinned-posts
  • List followersGET /v1/instagram/profiles/{identifier}/followers
  • List followingGET /v1/instagram/profiles/{identifier}/following
  • Search followersGET /v1/instagram/profiles/{identifier}/followers/search?q={query}
  • Search followingGET /v1/instagram/profiles/{identifier}/following/search?q={query}
  • List suggested profilesGET /v1/instagram/profiles/{identifier}/suggested

Posts

5 operations
  • Get a postGET /v1/instagram/posts/{identifier}
  • List commentsGET /v1/instagram/posts/{identifier}/comments
  • List replies to a commentGET /v1/instagram/posts/{identifier}/comments/{commentId}/replies
  • List tagged usersGET /v1/instagram/posts/{identifier}/tagged-users
  • List post likersGET /v1/instagram/posts/{identifier}/likers

Search

5 operations
  • Search profilesGET /v1/instagram/search/profiles?q={query}
  • Search reelsGET /v1/instagram/search/reels?q={query}
  • Search music/audioGET /v1/instagram/search/music?q={query}
  • Search hashtagsGET /v1/instagram/search/hashtags?q={query}
  • Search placesGET /v1/instagram/search/places?q={query}

Hashtags

3 operations
  • Get a hashtagGET /v1/instagram/hashtags/{name}
  • List hashtag postsGET /v1/instagram/hashtags/{name}/posts
  • List hashtag reelsGET /v1/instagram/hashtags/{name}/reels

Locations

2 operations
  • Get a locationGET /v1/instagram/locations/{id}
  • List location postsGET /v1/instagram/locations/{id}/posts

Music and audio

1 operation
  • Get music/audioGET /v1/instagram/music/{identifier}

The complete 43-operation surface also includes public Stories, Highlights, profile-about data, business recommendations, combined search, comment likers, post insights and metadata, and audio streams. Every operation has its own generated page in the API reference.

Popular Instagram data

Instagram followers APIInstagram comments APIInstagram hashtag API
Built for
  • Creator discovery
  • Brand monitoring
  • Content analytics
  • Social listening
Known boundaries
  • Public accounts and public content only.
  • Unavailable platform metrics are returned as null, never inferred as zero.

FAQ

Instagram questions.

Do I need Meta app approval?
No. Openhandle handles the upstream integration; your application uses an Openhandle API key.
Can I test without making live requests?
Yes. Test keys use a deterministic synthetic dataset and never contact Instagram.
Can I use a username instead of an ID?
Yes. Put @username or the platform ID in any profile path, including /posts. Openhandle remembers which ID belongs to which username.

Let your agent wire up Instagram.

Copy one prompt. It has the docs, the spec, and an example request. Your agent reads it and builds against your test key.

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents
Get started for $0Read the quickstart

100 free requests. No card needed.