raw.instagram.user_postsInstagram 用户帖子列表
实时Beta：接口和返回字段仍可能调整不使用免费额度
GET
https://api.qovia.ai/v1/raw/instagram/user_posts一个用户主页上的帖子，该用户置顶的在前，其余从新到旧，每页 12 条，记录与帖子详情相同（同一 id），另有收藏数（视频）和是否被该用户置顶；该用户参与合作的帖子以发布者为作者。最新帖子的数据可能比帖子详情晚几个小时。 传用户名或用户 ID 其中一个。把上一页返回的 cursor 原样传回即可翻页，has_more 为 false 时停止。没有帖子或用户不存在时返回空结果，不计费。
- 价格
- $0.002 / 次$2 / 千次 · 固定价格
- 计费
- 成功且有结果才扣费不使用免费额度
- 权限
raw:instagramAPI Key 需要这个 scope- 限速
- 仅账户限流账户每分钟上限
请求参数
作为查询参数发送
只接受下列参数，多出的参数会返回 400。
username用户名（不带 @）；与 user_id 二选一
格式^[A-Za-z0-9._]{1,30}$示例
instagramuser_id用户 ID（用户资料的 uid）；与 username 二选一
格式^[0-9]{1,20}$cursor取上一页响应的 cursor，原样传回；第一页不传
最多 4000 字格式^[A-Za-z0-9_=+/-]+$
组合约束（JSON Schema）
{
"oneOf": [
{
"required": [
"username"
]
},
{
"required": [
"user_id"
]
}
]
}响应
成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。
错误码
| code | HTTP | 计费 | 说明 |
|---|---|---|---|
scope_denied | 403 | 不扣费 | 这个 API Key 没有该接口需要的权限（scope）。 |
endpoint_unavailable | 503 | 不扣费 | 接口暂不可用（尚未接入数据源，或价格未配置），没有执行。 |
invalid_params | 400 | 不扣费 | 参数没有通过校验：缺少必填、类型或格式不对、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（item_id: …），缺少必填或多出参数以 params: … 开头。 |
rate_limited可重试 | 429 | 不扣费 | 超过账户每分钟请求上限（滑动 60 秒窗口），按 Retry-After 等待。 |
too_many_unbilled可重试 | 429 | 不扣费 | 最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。 |
insufficient_balance | 402 | 不扣费 | 余额不足以支付这次调用（免费额度已用完，或接口不使用免费额度）。 |
upstream_busy可重试 | 503 | 已退款 | 数据源繁忙或在冷却，已退款，按 Retry-After 重试。 |
upstream_timeout | 504 | 已退款 | 数据源超时，已退款。 |
upstream_error | 502 / 503 | 已退款 | 数据源返回失败，已退款。 |
upstream_rejected | 400 | 已退款 | 数据源拒绝了这组参数（格式合法但不被接受），已退款。 |
not_found | 404 | 已退款 | 数据源里没有这条数据（已删除或 ID 不存在），已退款。 |
reservation_expired | 504 | 已退款 | 处理时间过长，已自动退款，没有返回数据。 |
任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。
在浏览器里直接调用
需要登录；调试台调用和 API 调用一样计费。