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).
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 每页数量/Count per page | 12 |
max_id | string | No | 分页游标,用于获取下一页/Pagination cursor for next page | — |
user_id | string | Yes | Instagram用户ID/Instagram user ID | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}'{
"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

