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
curl -X POST "https://api.bridgly.app/instagram/user-by-id" \ -H "Authorization: Bearer $BRIDGLY_KEY" \ -H "Content-Type: application/json" \ -d '{ "userId": "787132"}'import osimport requestsresponse = requests.post( "https://api.bridgly.app/instagram/user-by-id", headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"}, json={ "userId": "787132", },)data = response.json()const response = await fetch("https://api.bridgly.app/instagram/user-by-id", { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIDGLY_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "userId": "787132" }),});const data = await response.json();import { Bridgly } from "@bridgly/sdk";const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });const res = await client.instagram.getUserById({ userId: "787132"});if (res.type === "success") { console.log(res.data);}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
{ "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" }}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.
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.
More Instagram endpoints
The same API key works on every endpoint. See all Instagram API endpoints.
- Instagram About This Account API→Get the “About this account” details of any Instagram account as JSON: the month it joined, the country it is based in, verification, former username count and profiles with shared followers.
- Instagram Hashtag Posts API→List the top posts, newest posts or Reels for an Instagram hashtag as JSON, with captions, media links, engagement counts, owners and audio.
- Instagram Audio API→Get an Instagram Reels song or original sound as JSON: title, artist, length, cover image, audio file, trending flag and the number of Reels using it.
- Instagram Audio Reels API→List the Instagram Reels that use a song or original sound, with captions, media links, publish times, engagement counts and owners as paginated JSON.
Try the Instagram User by ID API
100 free credits on business email, no card. Your first call takes a minute.