中Start freeTop up
Start freeTop upSign in / Sign upConsole
中EN
Skip to content
Instagram user posts
raw.instagram.user_posts

Instagram user posts

LiveBeta: the endpoint and its response fields may still changeNo free quota
GEThttps://api.qovia.ai/v1/raw/instagram/user_posts

The posts on a user's profile, the ones the user pinned first, then newest first, 12 a page, as the same records as post detail (same ids) plus saves (videos) and whether the user pinned the post; collab posts the user co-authored carry their publisher as author. The counts of the newest posts can trail post detail by a few hours. Pass either the username or the user ID. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A user without posts, or one that does not exist, answers empty and is not charged.

Price
$0.002 / call$2 per 1k · fixed price
Billing
Charged only for successful, non-empty resultsno free quota
Scope
raw:instagramThe API key needs this scope
Rate cap
Account limit onlyYour per-minute limit

Parameters

Sent as query parameters

Only these parameters are accepted; any other one returns 400.

usernamestring

The username (without @); pass this or user_id

Pattern^[A-Za-z0-9._]{1,30}$

Exampleinstagram

user_idstring

The user ID (a profile's uid); pass this or username

Pattern^[0-9]{1,20}$
cursorstring

The cursor from the previous page's response, unchanged; leave it out for the first page

Max 4000 charsPattern^[A-Za-z0-9_=+/-]+$
Combined constraints (JSON Schema)
{
  "oneOf": [
    {
      "required": [
        "username"
      ]
    },
    {
      "required": [
        "user_id"
      ]
    }
  ]
}

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
codeHTTPBillingDescription
scope_denied403Not chargedThis API key lacks the scope the endpoint requires.
endpoint_unavailable503Not chargedThe endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
invalid_params400Not chargedThe parameters failed validation: a required one is missing, a type or format is wrong, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (item_id: …); a missing or unknown parameter starts with params: ….
rate_limitedRetryable429Not chargedOver the account's per-minute limit (sliding 60-second window); wait for Retry-After.
too_many_unbilledRetryable429Not chargedIn the last 10 minutes at least 50 of your calls to data sources, and over 80% of them, came back empty, not found or rejected; slow down.
insufficient_balance402Not chargedThe balance cannot pay for this call (the free quota is used up, or the endpoint does not use it).
upstream_busyRetryable503RefundedThe data source is busy or cooling down; refunded. Retry after Retry-After.
upstream_timeout504RefundedThe data source timed out; refunded.
upstream_error502 / 503RefundedThe data source failed; refunded.
upstream_rejected400RefundedThe data source rejected these parameters (well-formed, but not accepted); refunded.
not_found404RefundedThe data source has no such item (deleted, or the ID does not exist); refunded.
reservation_expired504RefundedThe call took too long and was refunded automatically; no data is returned.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code
Call it from your browser

Needs an account; playground calls are billed like API calls.

Try in the playgroundCreate an API key