Instagram Profiles Search API
Find public profiles that match a search, with an option to add each profile's details.
- 1 credit per call
- Failed calls are free
- Updated
- instagram.profile.search
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | Search query. | space agency |
| enrich | boolean | no | Fetch public metadata with at most four concurrent lookups and a shared 45-second budget; enrichment_status reports each result. Default: false. |
false |
| limit | integer | no | Maximum number of results to return. From 1 to 25. Default: 10. |
10 |
| max_pages | integer | no | Maximum number of result pages to fetch. From 1 to 5. Default: 2. |
2 |
| page | integer | no | One-based result page to fetch. At least 1. Default: 1. |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "instagram.profile.search", "input": { "enrich": false, "limit": 10, "max_pages": 2, "query": "space agency" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "instagram.profile.search", "input": { "enrich": false, "limit": 10, "max_pages": 2, "query": "space agency" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "instagram.profile.search", "input": { "enrich": false, "limit": 10, "max_pages": 2, "query": "space agency" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, get the Instagram profiles search for query "space agency". Tell me what it costs before you run it, then show the results as a table.
More from the Instagram API
- Instagram Profile API1 credit
- Instagram Profile Posts API1 credit
- Instagram Reels API1 credit
- Instagram Post API1 credit
- Instagram Comments API1 credit
- Instagram Hashtag Posts Search API1 credit
- Instagram Hashtag Keyword Search API1 credit
- Instagram Popular Search API1 credit
- Instagram Topic Search API1 credit
- Instagram Topics API1 credit
- Instagram Reels Search API1 credit
- Instagram Explore API1 credit
- Instagram Reels by Audio API1 credit
- Instagram Highlights API1 credit
- Instagram Saved Highlight Items API1 credit
- Instagram Basic Profile by ID API1 credit
- Instagram Location API1 credit
- Instagram Embed API1 credit
The same data from other platforms
Instagram Profiles Search API FAQ
The short answers. The docs have the long ones.
How much does the Instagram Profiles Search API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send query. The input fields below list every option with its type and limits.
Do I need an Instagram login?
No. It reads public Instagram data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds instagram.profile.search, checks its price and runs it with the same credits as the REST API.
Your first Instagram call is free.
Up to 100 free credits to start, no card needed.