# 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.

## 2026-10-20: 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-Key` header. 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-Remaining` and `X-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.json` describes all of them.

## 2026-10-20: Profiles show the verified badge, the bio and the link

- `user/profile` returns `verified`, `bio` and `external_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/profile` answer carries the same three values as `isVerified`, `bio` and `externalUrl`.

## 2026-10-20: Older endpoints keep working until December 31, 2026

- `/api/stories`, `/api/profile`, `/api/highlights`, `/api/media`, `/api/download`, `/api/posts` and `/api/tiktok/analytics` keep working for calls with an API key until December 31, 2026. After that date a call with a key is answered `410` with the code `legacy_endpoint`. The website does not use a key and is not affected.
- New work should use `/api/v1/`. The page `/developers/docs/legacy` lists each older endpoint next to the v1 endpoint that replaces it.

## 2026-10-20: 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/posts` or `/api/tiktok/analytics` now carries the headers `Deprecation`, `Sunset` and `Link`. The `Link` points to `/developers/docs/legacy`.
- After December 31, 2026 such a call is answered `410` with the code `legacy_endpoint`. A call without a key, such as one from the website, is not affected.

## Links

- [This page on the site](https://storiesfly.com/developers/changelog)
- [Read the docs](https://storiesfly.com/developers/docs)
- [Instagram data API](https://storiesfly.com/developers): what the API is and what it returns
- [Pricing](https://storiesfly.com/developers/pricing): rates, examples and billing rules
- [OpenAPI file](https://storiesfly.com/openapi.json): the whole API in one file
- [API dashboard](https://storiesfly.com/developers/dashboard): get a key and top up