此端点可以帮助您
响应包含评论、作者数据、发布时间戳、互动信号以及用于顺序分页的游标。
何时使用
提供帖子的 media_id，并在需要时提供下一页的 cursor。新集成请使用规范化的 V2 响应。
此端点的作用
利用此 API 方法可以构建什么
先查看结果和常见工作流，然后再了解参数和可运行的请求示例。
常见使用场景
对话监控
收集受众在特定帖子下的反应，用于品牌监控和研究。
评论审核
将评论送入内部审核、标注和沟通质量工作流。
内容报告
用评论文本、作者和互动信号丰富帖子分析。
可用版本
响应版本
两个版本完成相同的任务，接受相同的参数。使用切换按钮比较响应结构，并选择您的客户端所需的版本。
响应版本
V2
在本页面切换版本，即可在同一文档 URL 下比较响应结构。
保持不变的部分
V1 和 V2 的身份验证、必填参数和请求结构均相同。实际上，您只需在构建端点路径和解析响应时选择版本。
版本之间的差异
主要区别在于响应结构。新集成请使用 V2；仅在需要兼容现有客户端契约时保留 V1。
使用方法
如何调用该方法
两个版本使用相同的 API 密钥请求头和相同的查询参数。本文档先展示共享的参数集合，然后展示各版本特定的端点路径和代码片段。
输入参数
共享参数| 参数 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
media_id |
是 | str |
3699921157182086444 |
要获取其数据的 Instagram 帖子的数字 ID。 |
cursor |
否 | str | None |
next-page-cursor |
上一次响应返回的下一页游标。获取第一页时请省略。 |
各版本的请求路径
V2复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。
GET /api/v2/instagram.com/comments/by-media-id代码示例
curl --request GET \
--url "https://www.scrapestorm.net/api/v2/instagram.com/comments/by-media-id" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'media_id=3699921157182086444' \
# Optional parameters:
# --data-urlencode 'cursor=next-page-cursor'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/instagram.com/comments/by-media-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"media_id": "3699921157182086444",
}
# Optional parameters
# params["cursor"] = "next-page-cursor"
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/instagram.com/comments/by-media-id";
const params = new URLSearchParams({
media_id: "3699921157182086444",
});
// Optional parameters
// params.set("cursor", "next-page-cursor");
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
media_id: "3699921157182086444",
};
// Optional parameters
// params.cursor = "next-page-cursor";
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"media_id" => "3699921157182086444",
];
// Optional parameters
// $query["cursor"] = "next-page-cursor";
try {
$response = $client->request("GET", "/api/v2/instagram.com/comments/by-media-id", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v2/instagram.com/comments/by-media-id"
params := url.Values{}
params.Set("media_id", "3699921157182086444")
// Optional parameters
// params.Set("cursor", "next-page-cursor")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}各版本的请求路径
V1复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。
GET /api/v1/instagram.com/comments/by-media-id代码示例
curl --request GET \
--url "https://www.scrapestorm.net/api/v1/instagram.com/comments/by-media-id" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'media_id=3699921157182086444' \
# Optional parameters:
# --data-urlencode 'cursor=next-page-cursor'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/instagram.com/comments/by-media-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"media_id": "3699921157182086444",
}
# Optional parameters
# params["cursor"] = "next-page-cursor"
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/instagram.com/comments/by-media-id";
const params = new URLSearchParams({
media_id: "3699921157182086444",
});
// Optional parameters
// params.set("cursor", "next-page-cursor");
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
media_id: "3699921157182086444",
};
// Optional parameters
// params.cursor = "next-page-cursor";
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"media_id" => "3699921157182086444",
];
// Optional parameters
// $query["cursor"] = "next-page-cursor";
try {
$response = $client->request("GET", "/api/v1/instagram.com/comments/by-media-id", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v1/instagram.com/comments/by-media-id"
params := url.Values{}
params.Set("media_id", "3699921157182086444")
// Optional parameters
// params.Set("cursor", "next-page-cursor")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}
响应示例
按版本查看真实响应
预览保留了关键字段和集合中的前几项，便于您快速浏览响应结构。切换版本会改变 JSON 格式。
V2 暂无经过验证的真实请求示例。在已验证示例就绪之前，此占位示例会保持标准响应结构可见。
{
"success": true,
"status": "ok",
"data": {}
}此简明 JSON 示例来自 V1 最近一次成功的验证运行。
{
"success": true,
"status": "ok",
"pagination": {
"has_more": true,
"cursor": "QVFB..."
},
"search_context": {
"media_id": "3851392652730816551"
},
"data": {
"data": {
"xig_polaris_media": {
"__typename": "XIGPolarisVideoMedia",
"comments_connection": {
"edges": [
{
"node": "…",
"cursor": null
},
{
"node": "…",
"cursor": null
},
{
"_more_items": 9
}
],
"page_info": {
"end_cursor": "QVFB...",
"has_next_page": true
}
},
"id": "POLARIS_3851392652730816551"
}
},
"extensions": {
"server_metadata": {
"request_start_time_ms": 1784535221665,
"time_at_flush_ms": 1784535222200
},
"is_final": true
}
}
}
下一步
继续评估
将本文档作为第一个决策点，然后在将端点接入常规使用之前，继续了解价格、平台覆盖范围和集成规则。
常见问题
团队在实现前常问的问题
借助这些解答，判断此 API 方法是否适合您的工作流、版本选择和上线计划。
在哪里可以找到 Instagram 帖子的媒体 ID？
可通过个人资料、动态、搜索或帖子详情方法获取媒体 ID。此操作需要的是数字 ID，而不是公开 URL 中的短代码。
结果分页时，如何获取全部评论？
第一个请求不带 cursor，之后将每次响应中的 cursor 传入下一个请求，直到不再返回下一页游标为止。
新集成应该使用哪个版本？
使用 V2 可获得规范化字段和稳定的产品模型。V1 仍可供解析 Instagram 平台原生响应结构的客户端使用。
未成功的响应会扣除积分吗？
不会。积分仅对成功的 API 响应扣除。请在价格目录中查看此方法及其他方法的当前费用。