이 엔드포인트가 도움이 되는 일
응답에는 댓글, 작성자 데이터, 게시 날짜, 참여 신호, 연속 페이지네이션을 위한 커서가 포함됩니다.
적합한 사용 시점
게시물의 media_id와 필요한 경우 다음 페이지 커서를 입력하세요. 새 연동에는 정규화된 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를 가져오세요. 이 작업에는 공개 URL의 단축 코드가 아니라 숫자 ID가 필요합니다.
결과가 페이지로 나뉘어 있으면 모든 댓글을 어떻게 가져오나요?
첫 요청은 커서 없이 보내고, 다음 페이지 커서가 더 이상 반환되지 않을 때까지 각 응답의 커서를 다음 요청에 전달하세요.
새 연동에는 어떤 버전을 사용해야 하나요?
정규화된 필드와 안정적인 제품 모델을 위해 V2를 사용하세요. V1은 Instagram 고유 응답 형태를 읽는 클라이언트를 위해 계속 제공됩니다.
실패한 응답에도 크레딧이 청구되나요?
아니요. 크레딧은 성공한 API 응답에만 청구됩니다. 이 메서드와 다른 메서드의 현재 비용은 요금 카탈로그에서 확인하세요.