SOCIAL MEDIA

Instagram Get User By Id API

Resolve an Instagram profile from a numeric user id, no login. Anonymous returns identity (username, profile picture) — see detailLevel.

Part of: Instagram API: Get User ID, User Info and Posts by User

instagramprofileuserscrapingsocialhttp

Try it free Get an API key

How to call it

Send one POST to api.upapi.io/instagram-get-user-by-id.post with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 15 weighted units of your monthly quota. The operation times out after 20 seconds. Identical requests are served from cache for 300 seconds, unbilled.

endpoint

POST https://api.upapi.io/instagram-get-user-by-id.post

Instagram Get User By Id API reference

Request parameters

userId: stringrequired — Numeric Instagram user id (pk)
proxyUrl: string — Optional proxy URL. Instagram 401-gates anonymous reads per egress IP.

Response fields

pk: stringrequired
fbid: string
success: booleanrequired
bioLinks: arrayrequired
category: string
fullName: string
username: stringrequired
biography: string
elapsedMs: integerrequired
fetchedAt: stringrequired
isPrivate: boolean
isBusiness: boolean
isVerified: boolean
mediaCount: integer
detailLevel: stringrequired — 'stub' = identity only (what anonymous returns today); 'full' = counts and profile detail were disclosed
externalUrl: string
publicEmail: string
businessEmail: string
businessPhone: string
followerCount: integer — null = not disclosed by this surface, never 'zero followers'
profilePicUrl: string
followingCount: integer
isProfessional: boolean

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body

{
  "userId": "example"
}

json — example response shape

{
  "pk": "example",
  "fbid": "example",
  "success": false,
  "bioLinks": [
    "example"
  ],
  "category": "example",
  "fullName": "example",
  "username": "torvalds",
  "biography": "example",
  "elapsedMs": 1,
  "fetchedAt": "example",
  "isPrivate": false,
  "isBusiness": false,
  "isVerified": false,
  "mediaCount": 1,
  "detailLevel": "example",
  "externalUrl": "example",
  "publicEmail": "example",
  "businessEmail": "example",
  "businessPhone": "example",
  "followerCount": 1,
  "profilePicUrl": "example",
  "followingCount": 1,
  "isProfessional": false
}

Code snippets

cURL

curl

curl -X POST https://api.upapi.io/instagram-get-user-by-id.post \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "userId": "example" }'

JavaScript

javascript

const response = await fetch('https://api.upapi.io/instagram-get-user-by-id.post', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "userId": "example"
}),
});

const data = await response.json();
console.log(data);

Python

python

import requests

response = requests.post(
    'https://api.upapi.io/instagram-get-user-by-id.post',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "userId": "example"
},
)

print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "userId": "example" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/instagram-get-user-by-id.post", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}

PHP

php

<?php

$payload = json_encode([
    'userId' => 'example',
]);

$ch = curl_init('https://api.upapi.io/instagram-get-user-by-id.post');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);

Ruby

ruby

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/instagram-get-user-by-id.post')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "userId": "example" }.to_json

response = http.request(request)
puts JSON.parse(response.body)

Java

java

import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"userId\": \"example\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/instagram-get-user-by-id.post")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}

csharp

using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"userId\": \"example\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/instagram-get-user-by-id.post", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Instagram Get User By Id API cost per call?

Each call spends 15 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

How do I authenticate to the Instagram Get User By Id API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

Are Instagram Get User By Id API responses cached?

Yes — identical requests are served from cache for 300 seconds, and a cache hit is not billed.

More Social Media APIs

Instagram Get User Profile Instagram Get User Posts Instagram Get Post Info Instagram Get Post Commenters Instagram Check Account Instagram Discover Location Posts Instagram Check Account Health TikTok Get User Profile

Browse every Social Media API →