Updated October 20, 2026
API changelog
Every change that affects a request or its price, newest first. The date of the newest entry is the date the API pages were last updated.
StoriesFly API v1
- The public API v1 is live at
/api/v1/. It returns public Instagram data as JSON: profiles, posts, reels, stories, highlights, comments, followers, hashtags, places and search. - A request needs one
X-Api-Keyheader. You never log in to Instagram or Facebook. - Requests are paid from a prepaid balance in US dollars. One call, or one page of a list, takes one request from the balance. Every request costs $1.50 per 1,000 today; lower rates for larger top-ups open soon. The balance never expires.
- Sign in with Telegram to get a key and a number of free requests. Top up with crypto, or with TON or USDT on TON.
- Every answer from a data endpoint carries
X-Units-Charged,X-Balance-Remaining,X-Free-Units-RemainingandX-RateLimit-Remaining. Errors are{error, code}with a fixed list of codes, and a call that fails on our side is not charged. - Each endpoint has a docs page at
/developers/docs, and/openapi.jsondescribes all of them.
Profiles show the verified badge, the bio and the link
user/profilereturnsverified,bioandexternal_url.- The profile header on the site and in the mini app shows the blue badge, the bio with its line breaks and the link in bio.
- The older
/api/profileanswer carries the same three values asisVerified,bioandexternalUrl.
Older endpoints keep working until December 31, 2026
/api/stories,/api/profile,/api/highlights,/api/media,/api/download,/api/postsand/api/tiktok/analyticskeep working for calls with an API key until December 31, 2026. After that date a call with a key is answered410with the codelegacy_endpoint. The website does not use a key and is not affected.- New work should use
/api/v1/. The page/developers/docs/legacylists each older endpoint next to the v1 endpoint that replaces it.
The old API plans are retired
- The Content API plans (Starter, Growth and Scale) and the Tracker API plans (Starter, Growth and Scale) are no longer sold. A plan bought earlier keeps working until its term ends.
- The Basic and Pro plans of the website still include the tracker routes.
- A call with an API key to
/api/stories,/api/profile,/api/highlights,/api/media,/api/download,/api/postsor/api/tiktok/analyticsnow carries the headersDeprecation,SunsetandLink. TheLinkpoints to/developers/docs/legacy. - After December 31, 2026 such a call is answered
410with the codelegacy_endpoint. A call without a key, such as one from the website, is not affected.
Your first 100 requests are on us
Sign in with Telegram, create a key, call any endpoint. Top up only when you need more.
© 2026 StoriesFly
