About this account API
What Instagram's About this account panel shows for a profile: the country it is based in, the month it joined and the usernames it had before.
GEThttps://storiesfly.com/api/v1/user/about- Price 1 request
- Answers up to 30 days old
Parameters
All parameters go in the query string.
| Name | Type | Sent | Description |
|---|---|---|---|
username | string | one of | Instagram username. A leading @ is ignored. Send exactly one of username or id. |
id | string | one of | Numeric Instagram id of the account. Send exactly one of username or id. |
Example request
Put your own key in the header.
curl "https://storiesfly.com/api/v1/user/about?username=arianagrande" \
-H "X-Api-Key: sf_live_your_key"const res = await fetch(
"https://storiesfly.com/api/v1/user/about?username=arianagrande",
{ headers: { "X-Api-Key": process.env.STORIESFLY_KEY } }
);
const data = await res.json();import os
import requests
r = requests.get(
"https://storiesfly.com/api/v1/user/about",
params={"username": "arianagrande"},
headers={"X-Api-Key": os.environ["STORIESFLY_KEY"]},
)
data = r.json()Example response
{
"id": "7719696",
"username": "arianagrande",
"country": "United States",
"account_created": "2011-08",
"former_usernames": []
}A real answer, shortened: lists are cut to two items and long texts to 160 characters.
Price and freshness
A call takes 1 request. Free requests are spent first, then your balance. The pricing page has the rates.
Answers are kept for up to 30 days. Asking again inside that time returns the same answer and takes 1 request again.
Errors
A failed call answers with an HTTP status and a body {error, code}. These are the codes this endpoint gives. Errors and what is charged covers all of them.
| Status | Code | When |
|---|---|---|
400 | bad_request | A parameter is missing or wrong, or not exactly one of username or id was sent. fields lists the names. Free. |
401 | unauthorized | The X-Api-Key header is missing or the key is wrong. Free. |
402 | credits_exhausted | The free requests and the balance are used up. Top up in the dashboard. Free. |
403 | telegram_required | The account behind the key is not linked to Telegram. The answer has a link_url to do it. Free. |
404 | not_found | The account does not exist. Charged like an answer. |
429 | rate_limited | More requests in a second than your level allows. Wait for the Retry-After header. Free. |
500 | internal_error | A fault on our side. Retry shortly. Refunded. |
503 | upstream_unavailable | Our side failed or timed out. Retry shortly. Refunded. |
Questions about this endpoint
What does this endpoint return?
What the About this account panel of Instagram shows: country, account_created as a year and month, and former_usernames. The name, bio and counts are in user/profile.
Does every account have all three?
Only when Instagram shows them. A field Instagram does not show for the account is null, and former_usernames is an empty list when the account never changed its name.
How old can an answer be?
Up to 30 days. This panel changes rarely, so the answer is kept for a long time.
Your first 100 requests are on us
Sign in with Telegram, create a key, call any endpoint. Top up only when you need more.