[中文]

用途:

Instagram综合搜索接口（支持分页）

支持通过 next_max_id 分页获取大量搜索结果

返回用户、话题标签、地点等综合结果

参数:

query: 搜索关键词

next_max_id: 分页ID，首次请求不传，从上一次响应的 data.next_max_id 获取

rank_token: 排序token，首次请求不传，从上一次响应的 data.rank_token 获取

enable_metadata: 是否启用元数据

data.num_results: 结果数量

data.users: 用户搜索结果列表

data.places: 地点搜索结果列表

data.hashtags: 话题标签搜索结果列表

data.next_max_id: 下一页分页ID（传给下次请求的next_max_id参数）

data.rank_token: 排序token（传给下次请求的rank_token参数）

data.has_more: 是否有更多结果

注意事项:

⚠️ 已知问题: 综合搜索结果可能存在重复数据，这是 Instagram API 的已知行为

搜索话题标签时，query 需要带上 # 前缀，例如搜索 fashion 话题应传入 #fashion

# 符号在 URL 中需要进行 URL 编码为 %23，例如: ?query=%23fashion

如果使用 HTTP 客户端库（如 requests/httpx），直接传入 #fashion 即可，库会自动处理编码

分页使用方法:

首次请求：只传 query 参数

获取响应中的 next_max_id 和 rank_token

下次请求：传入 query、next_max_id 和 rank_token

重复步骤 2-3 直到 has_more 为 false

价格:

0.002 USD/请求

[English]

Purpose:

Instagram general search API (with pagination)

Support pagination via next_max_id to fetch more search results

Returns blended results of users, hashtags, places, etc.

Parameters:

query: Search keyword

next_max_id: Pagination ID, omit for first request, get from previous response data.next_max_id

rank_token: Rank token, omit for first request, get from previous response data.rank_token

enable_metadata: Enable metadata

Return:

data.num_results: Number of results

data.users: User search results

data.places: Place search results

data.hashtags: Hashtag search results

data.next_max_id: Next page pagination ID (use as next_max_id in next request)

data.rank_token: Rank token (use as rank_token in next request)

data.has_more: Whether has more results

Notes:

⚠️ Known Issue: General search results may contain duplicate data, this is a known behavior of Instagram API

When searching for hashtags, query must include the # prefix, e.g., use #fashion to search for the fashion hashtag

The # character must be URL-encoded as %23 in the URL, e.g., ?query=%23fashion

If using an HTTP client library (e.g., requests/httpx), just pass #fashion directly and the library will handle encoding automatically

Pagination usage:

First request: Only pass query parameter

Get next_max_id and rank_token from response

Next request: Pass query, next_max_id and rank_token

Repeat steps 2-3 until has_more is false

Price:

0.002 USD/request

示例/Example

query = "justin"

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422

综合搜索（支持分页）/General search (with pagination)

[中文]

用途:

参数:

返回:

注意事项:

分页使用方法:

价格:

[English]

Purpose:

Parameters:

Return:

Notes:

Price:

示例/Example

Request

Request Code Samples

Responses

综合搜索（支持分页）/General search (with pagination)

[中文]#

用途:#

参数:#

返回:#

注意事项:#

分页使用方法:#

价格:#

[English]#

Purpose:#

Parameters:#

Return:#

Notes:#

Pagination usage:#

Price:#

示例/Example#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

返回:

注意事项:

分页使用方法:

价格:

[English]

Purpose:

Parameters:

Return:

Notes:

Pagination usage:

Price:

示例/Example