Instagram Profile Finder API

One POST with an Instagram handle or URL, an Instagram profile record back as JSON. 1 credit per lookup

curl -X POST https://api.linkfinderai.com \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"type": "instagram_lookup", "input_data": "@nasa"}'

import requests r = requests.post( "https://api.linkfinderai.com", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={"type": "instagram_lookup", "input_data": "@nasa"}, ) print(r.json())

const r = await fetch("https://api.linkfinderai.com", { method: "POST", headers: { "Authorization": `Bearer ${process.env.LINKFINDER_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ type: "instagram_lookup", input_data: "@nasa" }), }); console.log(await r.json());

{ "status": "success", "result": { "username": "...", "full_name": "...", "follower_count": "...", "biography": "...", "website": "...", "is_verified": "..." } }

Get an API key Full API documentation OpenAPI spec

Not writing code? Upload a CSV in bulk, run it inside Google Sheets, or try one lookup in the browser.

Request

Every LinkFinder lookup goes to the same endpoint, POST https://api.linkfinderai.com. The type field selects the lookup; input_data carries the input as a plain string.

Field		Value for this lookup
`type`	required	`instagram_lookup`
`input_data`	required	Instagram Handle or URL, e.g. `@nasa`

Authenticate with your API key as a Bearer token. Keep it server-side; never ship it in a browser or a mobile app.

Response

A successful call returns {"status": "success", "result": ...}. For this lookup the result carries Username, Full Name, Followers, Biography, Website and Verified. When nothing is found, result is null; the call is still charged, so cache your inputs and do not retry a null.

Most calls return the result inline with 200. When a lookup takes longer, you get 202 with a job_id and a poll_url instead; poll GET /status/{job_id} until status is done.

Credits and errors

1 credit per lookup. 401 means the key is missing or wrong, 402 means the account is out of credits, 422 means the type or the input is malformed, and 429 means you are being rate limited; back off and retry.

Handles are unambiguous, so a column of @handles enriches cleanly. If you only have names, resolve them to handles first; a name lookup on Instagram is a guess.

Use it from an automation tool

The same request works from an HTTP node: see n8n, or the integrations page for Make, Zapier, Clay and the MCP server. Bulk without code: upload a CSV.

First call in under five minutes

Free credits on signup, no card. Copy the cURL above, paste your key, and read the JSON.

Get an API key