이 엔드포인트가 도움이 되는 일
응답에는 대화 항목, 작성자의 공개 데이터, 참여 신호, 페이지네이션 필드가 포함됩니다.
적합한 사용 시점
대화 텍스트, 작성자, 타임스탬프, 연속 페이지네이션이 필요할 때 "단축 코드로"을 사용하세요.
이 엔드포인트가 하는 일
이 API 메서드로 만들 수 있는 것
먼저 결과와 일반적인 워크플로를 확인한 다음 매개변수와 작동하는 요청 예제로 넘어가세요.
주요 사용 사례
대화 모니터링
콘텐츠 아래와 선택한 객체 주변에서 대상의 반응을 추적하세요.
콘텐츠 관리
공개 메시지를 검토, 분류, 품질 관리 대기열로 보내세요.
댓글 분석
대화 텍스트와 메타데이터를 보고서와 대상 조사에 활용하세요.
사용 가능한 버전
응답 버전
두 버전 모두 같은 작업을 해결하며 같은 매개변수를 받습니다. 전환기로 응답 구조를 비교하고 클라이언트가 기대하는 버전을 선택하세요.
응답 버전
V2
이 페이지에서 버전을 전환하면 같은 문서 URL에서 응답 구조를 비교할 수 있습니다.
동일하게 유지되는 것
인증, 필수 매개변수, 요청 형태는 V1과 V2에서 같습니다. 실제로는 엔드포인트 경로를 구성할 때와 응답을 읽을 때 버전을 선택합니다.
버전 간에 달라지는 것
주요 차이는 응답 봉투입니다. 새 연동에는 V2를 사용하고, 기존 클라이언트 계약과의 호환성이 필요한 경우에만 V1을 유지하세요.
사용 방법
메서드 호출 방법
두 버전 모두 같은 API 키 헤더와 같은 쿼리 매개변수를 사용합니다. 이 문서는 먼저 공통 매개변수를 보여 준 다음 각 버전의 경로와 코드 스니펫을 보여 줍니다.
입력 매개변수
공통 매개변수| 매개변수 | 필수 | 유형 | 예시 | 설명 |
|---|---|---|---|---|
shortcode |
예 | str |
DNYwrB-yl0s |
게시물 공개 URL에 있는 단축 코드. |
cursor |
아니요 | str | None |
next-page-cursor |
이전 응답에서 받은 다음 페이지 커서. 첫 페이지에서는 생략합니다. |
버전별 요청 경로
V2정확한 엔드포인트 경로, 예시 URL, 코드 스니펫을 복사할 때 버전을 선택하세요. 위의 매개변수 목록은 바뀌지 않습니다.
GET /api/v2/instagram.com/comments/by-shortcode코드 예제
curl --request GET \
--url "https://www.scrapestorm.net/api/v2/instagram.com/comments/by-shortcode" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'shortcode=DNYwrB-yl0s' \
# 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-shortcode"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"shortcode": "DNYwrB-yl0s",
}
# 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-shortcode";
const params = new URLSearchParams({
shortcode: "DNYwrB-yl0s",
});
// 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 = {
shortcode: "DNYwrB-yl0s",
};
// 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 = [
"shortcode" => "DNYwrB-yl0s",
];
// Optional parameters
// $query["cursor"] = "next-page-cursor";
try {
$response = $client->request("GET", "/api/v2/instagram.com/comments/by-shortcode", [
'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-shortcode"
params := url.Values{}
params.Set("shortcode", "DNYwrB-yl0s")
// 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-shortcode코드 예제
curl --request GET \
--url "https://www.scrapestorm.net/api/v1/instagram.com/comments/by-shortcode" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'shortcode=DNYwrB-yl0s' \
# 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-shortcode"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"shortcode": "DNYwrB-yl0s",
}
# 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-shortcode";
const params = new URLSearchParams({
shortcode: "DNYwrB-yl0s",
});
// 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 = {
shortcode: "DNYwrB-yl0s",
};
// 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 = [
"shortcode" => "DNYwrB-yl0s",
];
// Optional parameters
// $query["cursor"] = "next-page-cursor";
try {
$response = $client->request("GET", "/api/v1/instagram.com/comments/by-shortcode", [
'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-shortcode"
params := url.Values{}
params.Set("shortcode", "DNYwrB-yl0s")
// 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": {}
}V1의 검증된 실제 응답 예시가 아직 없습니다. 검증된 예시가 게시될 때까지 이 자리 표시자가 표준 응답 봉투를 보여 줍니다.
{
"success": true,
"status": "ok",
"data": {}
}
다음 단계
평가 계속하기
이 문서를 첫 판단 기준으로 삼고, 반복 사용을 위해 엔드포인트를 연결하기 전에 요금, 플랫폼 지원 범위, 연동 규칙을 확인하세요.
자주 묻는 질문
팀이 구현 전에 묻는 질문
이 답변을 참고하여 이 API 메서드가 워크플로, 버전 선택, 도입 계획에 맞는지 판단하세요.
이 Instagram API 메서드는 어떤 데이터를 반환하나요?
이 메서드는 댓글에 대해 "단축 코드로"을 실행합니다. 아래의 간결한 응답 예시에서 필드의 정확한 구조를 확인할 수 있습니다.
V1과 V2 중 무엇을 선택해야 하나요?
새 연동에는 정규화된 구조를 제공하는 V2를 선택하세요. V1은 이미 플랫폼 고유 형식을 처리하는 클라이언트와의 호환성을 위해서만 사용하세요.
첫 요청에는 무엇이 필요한가요?
API 키를 만들어 요청 헤더에 넣고 표의 필수 매개변수를 입력하세요. 코드 예제에는 이미 올바른 경로와 요청 구조가 포함되어 있습니다.