Zernio
Zernio
API Reference

Instagram

List active Instagram storiesGETSearch Instagram audioGETGet Instagram audio metadataGETLook up a public Instagram Business accountGETGet Instagram publishing limitGETGet Instagram story insightsGET
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Instagram

Look up a public Instagram Business account

Returns the public profile and most recent media of any Instagram Business or Creator account, looked up by username through one of your connected Instagram accounts. Useful for competitor and market research. Personal accounts and private accounts cannot be looked up.

Requires an Instagram account connected via Facebook Login. Meta serves business discovery on graph.facebook.com only, so accounts connected with classic Instagram Login receive a 400 (instagram_business_discovery_requires_facebook_login) and must be reconnected choosing the Facebook option. Any one such account can look up any public Business or Creator handle.

likeCount is null when the owner hides like counts.


GET
/v1/accounts/{accountId}/instagram/business-discovery

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

The ID of a connected Instagram account (Facebook Login).

Query Parameters

username*string

Instagram handle to look up, with or without the leading @. Case-insensitive.

Lengthlength <= 31
limit?integer

How many of the most recent media to return.

Range1 <= value <= 25
Default12

Response Body

application/json

application/json

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.instagram.getInstagramBusinessDiscovery({  path: {    accountId: 'account_abc123',  },  query: {    username: 'nike',  },});console.log(data);
{  "profile": {    "id": "string",    "username": "string",    "name": "string",    "biography": "string",    "website": "string",    "profilePictureUrl": "string",    "followersCount": 0,    "followsCount": 0,    "mediaCount": 0  },  "media": [    {      "id": "string",      "caption": "string",      "mediaType": "string",      "mediaProductType": "string",      "timestamp": "2019-08-24T14:15:22Z",      "permalink": "string",      "likeCount": 0,      "commentsCount": 0    }  ]}
Was this page helpful?

Get Instagram audio metadata

Fetch one audio asset's metadata by ID. Use it to re-validate a stored `audioId` before a scheduled Reel publishes, or to refresh the preview `downloadUrl` (Meta expires preview URLs after roughly 1.5 days). Same connection requirement as the search endpoint: Facebook-Login Instagram accounts only.

Get Instagram publishing limit

Returns the account's remaining content-publishing quota for Instagram's rolling 24-hour window, so you can pace publishing and warn before the cap is reached. `quotaUsage` counts containers published since the start of the window. Always compare against the returned `quotaTotal` rather than hardcoding a number: Meta's prose documentation and the live API disagree on the value, and the live value is authoritative.