INSTAGRAM API

Instagram User by ID API

Get a public Instagram profile from its numeric user ID: username, full name, bio, bio links, profile picture, follower, following and post counts, and whether the account is private, verified or a business.

Endpoint
POST /instagram/user-by-id
Price
1 credit per request
SDK
client.instagram.getUserById()
MCP tool
instagram_user_by_id
Terminal
curl -X POST "https://api.bridgly.app/instagram/user-by-id" \
-H "Authorization: Bearer $BRIDGLY_KEY" \
-H "Content-Type: application/json" \
-d '{
"userId": "787132"
}'
[ REQUEST AND RESPONSE ]

What does the Instagram User by ID API return?

Look up an Instagram profile from its numeric user ID: username, bio, follower, following and post counts, and verified and business flags as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

userIdstringrequired
Numeric Instagram user ID, e.g. "787132".
cacheMaxAgeHoursinteger
Accept a cached result scraped up to this many hours ago. A cached result costs no credits, and its `cachedAt` says when it was scraped. When no cached result is that recent, the data is scraped live at the normal price. Leave it out to always scrape live, e.g. 24.
cacheOnlyboolean
Return only a cached result and never scrape live. With `cacheMaxAgeHours`, only a result that recent is returned; without it, the latest cached result of any age. Responds 404, at no cost, when there is none, e.g. true.

Example response

200 OK · application/json
{
"timeMs": 1840,
"creditsCost": 1,
"cachedAt": "2026-01-15T09:30:00.000Z",
"data": {
"id": "string",
"username": "string",
"full_name": "string",
"biography": "string",
"bio_links": [
{
"title": "string",
"url": "string",
"link_type": "string"
}
],
"profile_pic_url": "string",
"profile_pic_url_hd": "string",
"followers": 0,
"following": 0,
"posts_count": 0,
"is_private": true,
"is_verified": true,
"is_business_account": true,
"is_professional_account": true,
"category_name": "string"
}
}
[ USE CASES ]

What can you build with the Instagram User by ID API?

Resolve IDs to usernames

Turn the user IDs in your records into current usernames.

Follow renamed accounts

Keep tracking an account after it changes its username.

Enrich exports

Add follower counts and bios to lists of user IDs.

[ FAQ ]

Instagram User by ID API questions

Why look up an Instagram account by ID instead of username?

A user ID never changes, while a username can. Store the ID and look it up later to get the account’s current username and profile.

How do I use the Instagram User by ID API?

Send a POST request to https://api.bridgly.app/instagram/user-by-id with userId in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.instagram.getUserById(). AI agents connected to Bridgly over MCP can call the instagram_user_by_id tool.

How much does the Instagram User by ID API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.67 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

Try the Instagram User by ID API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI
free credits

On business email signup. No credit card required.

Start free with 100 credits