Instagram Fetch User Posts

2.07 credits/call
ae_instagram_fetch_user_posts

Retrieve posts for an Instagram user. The required user_id is the user's Instagram ID. Optionally provide count (1–50, default 12) to choose the page size. Omit max_id for the first page; use the returned next_max_id to request a later page. The response includes items (posts), more_available (whether another page is available), and next_max_id (the next-page cursor, when available).

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Each pagination request is charged separately. The requested number of posts per page does not affect the per-call charge.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
countintegerNo每页数量/Count per page12
max_idstringNo分页游标,用于获取下一页/Pagination cursor for next page—
user_idstringYesInstagram用户ID/Instagram user ID—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_instagram_fetch_user_posts' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "count": 3,
    "user_id": "723206950"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "items": [
      {
        "caption_is_edited": false,
        "client_cache_key": "NDAyNjcxNDM5NzQ4NDU3NDQxMQ==.3",
        "deleted_reason": 0,
        "filter_type": 0,
        "has_delayed_metadata": false,
        "id": "4026714397484574411_723206950"
      }
    ],
    "more_available": true
  },
  "docs": "https://api.tikhub.io/#/Instagram-V1-API/fetch_user_posts_api_v1_instagram_v1_fetch_user_posts_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "e9f87518-6067-42de-8bcd-250d2933ac0a"
}

This example shows part of the response. Copied content is valid JSON.

Guides using this tool

See how this tool fits into real workflows