What this endpoint helps with
The response provides available Profile fields in normalized V2 or platform-native V1 format.
When to use it
Use “Business details by user ID” after the object is known and your product needs its current public context.
Threads API docs
Threads API: Profile — Business details by user ID
Retrieve detailed public Profile data from Threads by a known identifier for object records, validation, and enrichment.
Use “Business details by user ID” after the object is known and your product needs its current public context.
Method
GET
Entity
Profile
Versions
2
What this endpoint does
What you can build with this API method
Review the result and common workflows first, then move to parameters and a working request example.
Common use cases
Record enrichment
Attach public Threads fields to known product objects.
Data validation
Verify identifiers and current public context before downstream processing.
Analytics preparation
Use object details as inputs for reports, scoring, and related requests.
Available versions
Response version
Both versions solve the same job and accept the same parameters. Use the switch to compare the response structure and choose the version your client expects.
Response version
V2
Switch versions on this page to compare response structures while keeping the same documentation URL.
What stays the same
Authentication, required parameters, and the request shape stay the same across V1 and V2. In practice, you choose the version when you build the endpoint path and when you parse the response.
What changes between versions
The main difference is the response envelope. Use V2 for new integrations and keep V1 only when you need compatibility with an existing client contract.
How to use it
How to call the method
Use the same API key header and the same query parameters for both versions. This documentation shows the shared parameter set first, then version-specific endpoint paths and code snippets.
Input parameters
Shared parameters| Parameter | Required | Type | Example | Description |
|---|---|---|---|---|
user_id |
Yes | str |
value |
Numeric user ID on the selected platform. |
Version-specific request path
V2Choose a version when you copy the exact endpoint path, example URL, and code snippet. The parameter list above stays the same.
GET /api/v2/threads.net/profile/business-details-by-user-idCode examples
curl --request GET \
--url "https://www.scrapestorm.net/api/v2/threads.net/profile/business-details-by-user-id" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'user_id=value'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/threads.net/profile/business-details-by-user-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"user_id": "value",
}
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/threads.net/profile/business-details-by-user-id";
const params = new URLSearchParams({
user_id: "value",
});
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
user_id: "value",
};
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"user_id" => "value",
];
try {
$response = $client->request("GET", "/api/v2/threads.net/profile/business-details-by-user-id", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v2/threads.net/profile/business-details-by-user-id"
params := url.Values{}
params.Set("user_id", "value")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}Version-specific request path
V1Choose a version when you copy the exact endpoint path, example URL, and code snippet. The parameter list above stays the same.
GET /api/v1/threads.net/profile/business-details-by-user-idCode examples
curl --request GET \
--url "https://www.scrapestorm.net/api/v1/threads.net/profile/business-details-by-user-id" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'user_id=value'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/threads.net/profile/business-details-by-user-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"user_id": "value",
}
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/threads.net/profile/business-details-by-user-id";
const params = new URLSearchParams({
user_id: "value",
});
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
user_id: "value",
};
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"user_id" => "value",
];
try {
$response = $client->request("GET", "/api/v1/threads.net/profile/business-details-by-user-id", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v1/threads.net/profile/business-details-by-user-id"
params := url.Values{}
params.Set("user_id", "value")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}
Response example
Live response by version
The preview keeps key fields and the first collection items so you can scan the response shape quickly. Switching versions changes the JSON format.
This compact JSON example comes from the latest successful verification run for V2.
{
"success": true,
"status": "ok",
"search_context": {
"user_id": "25025320"
},
"data": {
"user": {
"user_id": "25025320",
"username": "instagram",
"name": "Instagram",
"is_verified": true,
"followers_count": null,
"description": "Discover what's new on Instagram 🔎✨",
"external_links": [
{
"url": "https://www.youtube.com/watch?v=H6G9PcvHjj4",
"label": null,
"link_type": "external"
},
{
"url": "https://open.spotify.com/episode/14Q9PGTAeZsdjOqT50hrkt?si=YkEhG7CJTvShXZ9G0BjIKQ",
"label": null,
"link_type": "external"
}
],
"emails": [],
"text_app_biography": null,
"profile_context_facepile_users": null,
"hd_profile_pic_versions": "https://example.com/image.jpg",
"avatar_url": null,
"is_threads_private": false,
"friendship_status": null,
"show_text_post_app_replies_tab": null,
"bio_links": [
{
"url": "https://www.youtube.com/watch?v=H6G9PcvHjj4",
"lynx_url": null,
"link_id": "18471614659105967",
"title": null,
"is_verified": false
},
{
"url": "https://open.spotify.com/episode/14Q9PGTAeZsdjOqT50hrkt?si=YkEhG7CJTvShXZ9G0BjIKQ",
"lynx_url": null,
"link_id": "17991610467002507",
"title": null,
"is_verified": false
}
],
"show_text_post_app_badge": true
}
}
}This compact JSON example comes from the latest successful verification run for V1.
{
"success": true,
"status": "ok",
"search_context": {
"user_id": "25025320"
},
"data": {
"data": {
"user": {
"pk": "25025320",
"text_post_app_is_private": false,
"friendship_status": null,
"profile_pic_url": "https://example.com/image.jpg",
"username": "instagram",
"text_post_app_remove_mention_entrypoint": null,
"show_text_post_app_replies_tab": null,
"gating": null,
"follower_count": 685820043,
"profile_context_facepile_users": null,
"hd_profile_pic_versions": "https://example.com/image.jpg",
"text_app_last_visited_time": null,
"is_verified": true,
"biography": "Discover what's new on Instagram 🔎✨",
"text_app_biography": null,
"full_name": "Instagram",
"bio_links": [
{
"url": "https://www.youtube.com/watch?v=H6G9PcvHjj4",
"is_verified": false,
"link_id": "18471614659105967"
},
{
"url": "https://open.spotify.com/episode/14Q9PGTAeZsdjOqT50hrkt?si=YkEhG7CJTvShXZ9G0BjIKQ",
"is_verified": false,
"link_id": "17991610467002507"
}
],
"transparency_label": null,
"is_threads_only_user": false,
"show_text_post_app_badge": true,
"id": "25025320"
}
},
"extensions": {
"is_final": true,
"server_metadata": {
"request_start_time_ms": 1784496775524,
"time_at_flush_ms": 1784496776246
}
},
"status": "ok"
}
}
What to do next
Continue the evaluation
Use this documentation as the first decision point, then move into pricing, platform coverage, and integration rules before you connect the endpoint for recurring use.
FAQ
Questions teams ask before implementation
Use these answers to decide whether this API method fits your workflow, versioning choice, and rollout plan.
What data does this Threads API method return?
The method performs “Business details by user ID” for Profile. The compact response example below shows the exact field structure.
Should I choose V1 or V2?
Choose V2 for new integrations because it provides a normalized structure. Use V1 only for compatibility with clients that already consume the platform-native format.
What do I need for the first request?
Create an API key, send it in the request header, and provide the required parameters from the table. The code samples already contain the correct path and request structure.