Inbox · Instagram

Look up a public Instagram Business account

Looks up a public Instagram Business account.

GEThttps://api.pozy.ai/v1/accounts/{accountId}/instagram/business-discovery

getInstagramBusinessDiscovery

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the analytics resource group disabled get 403 resource_group_disabled. Authentication

Path parameters

Name	Type	Notes
`accountId`required	string

Query parameters

Name	Type	Notes
`username`required	string	Up to 31 characters
`limit`	integer	Default `12`1 to 25

Example

curl -X GET "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/business-discovery?username=acme&limit=12" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/business-discovery?username=acme&limit=12", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/instagram/business-discovery",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={
        "username": "acme",
        "limit": 12,
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

Response

200 on success

profileobjectrequired
9 child fields
- idstringrequired
- usernamestringrequired
- namestring
  Can be null.
- biographystring
  Can be null.
- websitestring
  Can be null.
- profilePictureUrlstring
  Can be null.
- followersCountinteger
  Can be null.
- followsCountinteger
  Can be null.
- mediaCountinteger
  Can be null.
mediaarray of objectrequired
12 child fields
- idstringrequired
- captionstringrequired
  Can be null.
- mediaTypestringrequired
  Can be null.
- mediaProductTypestringrequired
  Can be null.
- timestampstring (date-time)required
  Can be null.
- permalinkstringrequired
  Can be null.
- likeCountintegerrequired
  Can be null.
- commentsCountintegerrequired
  Can be null.
- mediaUrlstringrequired
  Can be null.
- thumbnailUrlstringrequired
  Can be null.
- viewCountintegerrequired
  Can be null.
- childrenarray of objectrequired
  Can be null.

200 response

{
  "profile": {
    "id": "6bfebd43ddc270f6d2c56fc5",
    "username": "acme",
    "name": "Acme",
    "biography": "string",
    "website": "string",
    "profilePictureUrl": "https://pozy.ai/media/example-1.jpg",
    "followersCount": 42,
    "followsCount": 42,
    "mediaCount": 42
  },
  "media": [
    {
      "id": "6bfebd43ddc270f6d2c56fc5",
      "caption": "Hello from Pozy",
      "mediaType": "string",
      "mediaProductType": "string",
      "timestamp": "2026-10-02T09:00:00.000Z",
      "permalink": "string",
      "likeCount": 42,
      "commentsCount": 42,
      "mediaUrl": "https://pozy.ai/media/example-1.jpg",
      "thumbnailUrl": "https://pozy.ai/media/example-1.jpg",
      "viewCount": 42,
      "children": [
        {
          "id": "6bfebd43ddc270f6d2c56fc5",
          "mediaType": "string",
          "mediaUrl": "https://pozy.ai/media/example-1.jpg",
          "thumbnailUrl": "https://pozy.ai/media/example-1.jpg"
        }
      ]
    }
  ]
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400	invalid_request_error	A parameter or body field is missing or invalid. `param` names it.
401	authentication_error	The API key is missing, revoked or expired.
403	permission_error	The key is scoped to other profiles or has this resource group disabled.
404	not_found	Nothing with that id exists in your workspace.
429	rate_limit_error	Too many requests this minute. Wait for `Retry-After` seconds.

Every code is listed in Errors.

More in Instagram

GETList active Instagram stories GETGet Instagram publishing limit GETSearch Instagram audio GETGet Instagram audio metadata GETList the collaborators of an Instagram post GETList the live broadcasts of an Instagram account GETList the posts an Instagram account is tagged in GETGet a post that mentions an Instagram account in its caption GETGet a comment that mentions an Instagram account GETGet Instagram story insights