GET/v1/instagram/collaborations3 credits per collaboration

Instagram Brand Collaborations API

Paid-partnership posts, reels and stories between creators and brands, for any public profile. Pass a brand's handle to see which creators it pays; pass a creator's handle to see which brands they work with.

Request

parameter	type	description
handle	string, required	The Instagram username, without the @.
limit	integer	Items per page, up to 50 synchronously. Above that the call becomes a job.
cursor	string	meta.next_cursor from the previous page.
fresh	boolean	Skip the stored copy and read live, at the same price.
fields	string	Comma-separated field paths to keep.
format	json, csv	CSV flattens each item to one row.

Billing and freshness

3 credits per collaboration. Failed calls are never charged, and empty results are free up to 25 a day. Stored copies are refreshed every 12 hours.

What you get back

A page of partnerships. Each row is one branded-content post with its type, URL, date, the creator and the brand partners it names. Rows come from Instagram's own branded-content labels, so they reflect disclosed partnerships, not guesses.

A profile with no disclosed partnerships returns an empty page, which is free up to the daily allowance.

GET /v1/instagram/collaborations

curl "https://api.instadata.dev/v1/instagram/collaborations?handle=nike&limit=10" \
  -H "Authorization: Bearer ik_live_..."

{
  "data": [ … ],
  "meta": { "count": …, "limit": …, "next_cursor": "…" },
  "request_id": "req_01J…"
}

Fields

field	type	note
id	string	Stable id for the partnership post.
type	string\|null	reel, post or story.
url	string\|null	URL of the post.
posted_at	string\|null	ISO 8601 date the partnership was published.
platform	string\|null	Where the post lives; instagram for this endpoint.
creator	object	{ handle, url } of the creator who published it.
brands	object[]	[{ handle, url }] of the brand partners named on the post. Usually one.

Reach for it when

Influencer sourcing from real sponsorships: which creators a competitor already pays.
Pitch research: which brands a creator has worked with before you reach out.
Category mapping: walk a list of brands and build the graph of creators they share.

Not the right call when

You want a creator's whole feed, sponsored or not. That is Profile Posts or Profile Reels.
You want the ads a brand runs rather than the creators it pays. That is Ads by Page.

Things to know

Disclosed partnerships only

Rows come from branded-content labels the creator set on the post. Undisclosed deals and affiliate links in a bio do not appear.

3 credits per row

Each partnership costs 3 credits, reflecting its upstream price. Some large accounts return nothing because they never use the paid-partnership label; that call is free.

Questions

Does it work for both brands and creators?

Yes. The handle can be a brand or a creator; the rows always carry the creator and the brand partners, so either direction reads the same.

Why does a famous account return no rows?

Because it has not used Instagram's paid-partnership label. The endpoint reports disclosed partnerships only and does not infer sponsorship from captions.

What does a row cost?

3 credits per partnership returned. An empty result is free up to the daily allowance.

The whole sheet