Instagram story viewer API

Call the Instagram Stories Viewer API endpoint with a bearer key — structured JSON, documented errors, and code samples in curl, JavaScript, Python, Java, and Go.

  • One Query, Ranked Results
  • No Instagram Login
  • Profiles, Posts, And Reels
  • Paginated Results
  • Find Accounts, Then Dig Deeper
  • Structured Readable Output

Request examples

curl "https://api.agentbody.io/v1/instagram/search?query=openai&cursor=next-page-token" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"

Response examples

Documented responses from the OpenAPI specification.

Successful Gateway result.

{
  "has_more": false,
  "items": [],
  "next_cursor": "example_value"
}

Features

This Instagram story viewer search runs a keyword query across public Instagram content, returning profiles, posts, and reels in one ranked list — the discovery layer for account research and content workflows.

One Query, Ranked Results

Type what you are looking for — a brand, a creator, a topic — and the search returns ranked public results across Instagram. It is the general search layer: one query surfaces the accounts and posts that match, instead of hopping between separate lookups.

No Instagram Login

The search never asks for your Instagram username or password. A free AgentBody account unlocks the request; the lookup itself runs against public content without connecting your personal account.

Profiles, Posts, And Reels

Results can surface profiles, posts, and reels matching the query. Each item returns its URL, name or title, and available engagement numbers — enough to identify the right account before committing to a deeper lookup.

Paginated Results

Result sets load page by page. When the response reports more matches, the next page follows with the returned cursor — so broad queries stay complete instead of cutting off after the first screen.

Find Accounts, Then Dig Deeper

Use the search to locate the profile you care about, then run AgentBody's profile and post operations on it. Search is the entry point of the workflow; the details live one request away.

Structured Readable Output

Results arrive as clean structured JSON in the browser. Copy the whole response or the items you need into notes, spreadsheets, or a downstream workflow without reformatting.

How to use

Follow these six steps to use this Instagram story viewer search: pick a keyword, run the query, and page through the public results.

01

Create A Free Account

Create or sign in to your free AgentBody account before running the tool. The account unlocks the search request without connecting an Instagram account or installing anything.

02

Choose Your Keyword

Pick the term that best describes what you are looking for — a brand name, a creator handle, or a topic. Public content is searchable; content from private accounts stays out of reach by design.

03

Enter The Query

Type the keyword into the input field on this page. Plain phrases work; there is no special syntax to learn. One query returns one ranked result set covering the matching public content.

04

Run The Search

Click Run to execute the query. The first page of ranked results returns immediately — profiles, posts, and reels that match — with URLs, names, and available stats for each item.

05

Page Through Results

When the response reports more matches, request the next page with the returned cursor. Each page continues where the previous stopped, assembling the full result set without gaps.

06

Use The Result

Copy the items you need into notes, research files, or workflows. Take the profile you found into AgentBody's profile lookups for the full picture — search is the entry point, details follow one request later.

Frequently asked questions

Can I view Instagram stories anonymously with this tool?

No. This page is an Instagram search across public content — it returns profiles, posts, and reels matching a keyword. It does not load story trays, show viewer lists, or hide your identity from story statistics, because stories are not what this search queries.

How is this different from an anonymous Instagram story viewer?

An anonymous Instagram story viewer claims to load story trays without appearing in viewer lists. This Instagram story viewer page does something adjacent but honest: it searches public profiles, posts, and reels by keyword. Story viewing with hidden identity is not a feature here.

Do I need an Instagram account to use it?

No. The search never asks for your Instagram username or password and never connects your personal account. A free AgentBody account unlocks the request; the query runs against public content only.

Can it view stories from private accounts?

No. Private accounts keep their content — stories, posts, and reels — out of public search entirely. No third-party search can retrieve it, and this tool does not attempt logins to work around the limit.

Is the Instagram story viewer free?

You can start with a free AgentBody account, and each Instagram search runs on your account's credits. Pricing is governed by the gateway rather than fixed numbers on this page.

How do I find a specific Instagram profile?

Type the name or brand into the search and page through the ranked results. When you spot the right account, take it into AgentBody's profile lookups for follower counts and post history — search finds it, the follow-up request details it.