Skip to main content
GET
posts
Reels, photos and carousels together, under items. Page with next_max_id, stop on more_available, and read num_results for the page size. Each item carries media_type, code, caption, like_count, comment_count, taken_at, image_versions2 and video_versions among roughly two hundred internal flags. Measured at 632 KB per page, the largest response in this API; trim=true only reduces it to 523 KB. For reels alone use get_instagram_user_reels, and for a single known post get_instagram_post. Both return the same raw shape, so neither is a route to a smaller payload — the normalised shape only exists on the search endpoints.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/instagram/user/posts
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/instagram/user/posts
  • handle: query; required
  • next_max_id: query; optional
  • trim: query; optional
  • Runtime facts: fdf0a203e7ec628291b62272da7b8bbbe431c8f77f251ea2e65c19cd3c98fa37
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Charged for the actual billable results. Default request estimate: $0.00188 USD. The final charge depends on actual usage. Your account price may differ; use a request quote where supported.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

handle
string
required

Instagram handle

next_max_id
string

Cursor to get next page of results.

trim
string

Set to true to get a trimmed response

Response

Successful response

credits_remaining
integer
items
object[]
max_id
string | null
next_max_id
string | null
success
boolean