Skip to main content
GET
post
Everything lives under data.xdt_shortcode_media: shortcode, is_video, video_url, video_duration, has_audio, display_url, dimensions, accessibility_caption, edge_media_to_caption for the caption text, and owner. Measured at about 197 KB. download_media=true additionally mirrors the media to permanent storage and costs ten credits instead of one — leave it off unless the files are actually needed. For the discussion under the post use get_instagram_post_comments with the same URL; for the words spoken in a video, get_instagram_media_transcript.

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/post
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/instagram/post
  • cache_max_age: query; optional
  • download_media: query; optional
  • include_play_count: query; optional
  • region: query; optional
  • trim: query; optional
  • url: query; required
  • Runtime facts: fdf0a203e7ec628291b62272da7b8bbbe431c8f77f251ea2e65c19cd3c98fa37
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.00188
  • Cost contract: response_count
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

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

Query Parameters

cache_max_age
enum<string>

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details.

Available options:
14d,
1d,
30d,
3d,
7d
download_media
boolean

Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise.

include_play_count
boolean

Set to false to omit video_play_count and skip its additional fetch for a faster response. Defaults to true.

region
string

2 letter country code to set the proxy in

trim
boolean

Set to true to get a trimmed response

url
string
required

Instagram post or reel URL

Response

Successful response

credits_remaining
integer
success
boolean
xdt_shortcode_media
object