슬러그 상품 상세
5 크레딧/v1/g2/productG2 소프트웨어 상품 1건입니다. 이름, 별점, 리뷰 수, 카테고리, 판매자, 요금제, 기능, 대안이 포함됩니다. 고급 티어(5 크레딧)입니다.
id or url
G2 APIG2 상품·리뷰 데이터 API
SocialCrawl API 키로 G2 소프트웨어 상품, 작성 리뷰, 카테고리, 판매자 프로필을 구조화 JSON으로 가져옵니다. 공유 커머스 스키마입니다. 호출은 크레딧으로 과금됩니다.
/v1/g2
활성 엔드포인트는 7개입니다. 1·5 크레딧 티어입니다.
- GET /v1/g2/product
- GET /v1/g2/reviews
- GET /v1/g2/category
- GET /v1/g2/categories
- GET /v1/g2/seller
- GET /v1/g2/seller/products
- GET /v1/g2/product-index
G2 엔드포인트
G2 소프트웨어 카탈로그 읽기 엔드포인트는 7개입니다. 상품 페이지, 작성 리뷰, 카테고리 탐색, 카테고리 분류, 판매자 프로필, 판매자 포트폴리오, 상품 URL 색인을 제공합니다. 데이터 API만 지원합니다.
상품 리뷰
5 크레딧/v1/g2/reviews상품 슬러그의 G2 작성 리뷰입니다. 별점, 본문, 리뷰어 정보가 포함됩니다. 페이지당 10건입니다. 고급 티어(5 크레딧)입니다.
id or url, page, sort, stars, segment
카테고리 상품
5 크레딧/v1/g2/categoryG2 카테고리의 소프트웨어 상품입니다. 이름, 슬러그, 별점, 판매자가 포함됩니다. 페이지당 15건입니다. 고급 티어(5 크레딧)입니다.
category, page, sort
카테고리 분류
1 크레딧/v1/g2/categoriesG2 카테고리 URL 전체 목록입니다. 슬러그를 category에 넣습니다. 표준 티어(1 크레딧)입니다.
(none)
판매자 프로필
5 크레딧/v1/g2/sellerG2 벤더 1건입니다. 이름, 별점, 본사, 설립 연도, 웹사이트, 포트폴리오 페이지가 포함됩니다. 고급 티어(5 크레딧)입니다.
id, url, or handle
판매자 상품
5 크레딧/v1/g2/seller/productsG2 판매자 상품 포트폴리오입니다. 이름, 슬러그, 별점, 설명이 포함됩니다. 페이지당 9건입니다. 고급 티어(5 크레딧)입니다.
id or url, page
상품 URL 색인
5 크레딧/v1/g2/product-indexG2 상품 리뷰 URL을 호출당 100개씩 페이지로 나눕니다. 각 행에 상품 슬러그가 있습니다. 고급 티어(5 크레딧)입니다.
page
G2 API7개 엔드포인트 지원
문서 보기Products
Reviews
Categories
Sellers
G2 소프트웨어 제품을 슬러그 또는 URL로 조회해 이름, 설명, 평점, 리뷰 수, 카테고리, 판매사, 요금제, 기능, 대안 제품을 반환합니다.
G2 슬러그나 제품 URL이 있고 리뷰를 넘기기 전에 평점과 요금제가 포함된 제품 페이지 전체가 필요할 때 사용하세요.
5크레딧
GET/v1/g2/product?id=postman
$ curl https://www.socialcrawl.dev/v1/g2/product?id=postman \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다G2 API 동작
G2도 다른 SocialCrawl 커머스 엔드포인트와 같습니다. API 키로 GET /v1/g2/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 G2 파트너 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
GET과 쿼리 파라미터
G2 라우트는 모두 GET입니다. id, url, category, page, sort를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
카테고리 분류 목록은 1 크레딧입니다. 상품, 리뷰, 카테고리 상품, 판매자, 판매자 상품, 상품 색인은 5 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 카테고리 분류나 알려진 슬러그에서 시작한 뒤 필요한 상품만 상세와 리뷰로 깊게 봅니다.
01분류
GET /v1/g2/categories카테고리 URL과 슬러그 행
상품을 나열하기 전에 카테고리를 확정합니다.
02카테고리
GET /v1/g2/category?category=…슬러그와 별점이 있는 ProductList 카드
상품 상세에 크레딧을 쓰기 전에 후보를 고릅니다.
03상품
GET /v1/g2/product?id=…슬러그 1건의 전체 Product
카테고리 카드는 전체 상품 레코드가 아닙니다.
04리뷰
GET /v1/g2/reviews?id=…같은 슬러그의 ReviewList
작성 리뷰 본문은 product가 아니라 reviews에 있습니다.
요청
GET /v1/g2/product?id=postman
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/g2/reviews?id=postman&sort=most-recent
GET /v1/g2/categories응답 봉투
{
"success": true,
"data": {
"product": {
"id": "postman",
"title": "Postman",
"rating": { "average": 4.6, "count": 1800 },
"url": "https://www.g2.com/products/postman/reviews"
}
},
"credits_used": 5,
"credits_remaining": 9995,
"request_id": "req_…",
"cached": false
}data 형태
필드 이름은 다른 SocialCrawl 커머스 플랫폼과 같습니다. 한 번 파싱하면 G2, Amazon, Trustpilot에 재사용합니다.
Productproduct
id (슬러그), title, rating, review count, categories, seller, plans, features, url
ReviewListreviews
items[]에 author, content.text, rating, published_at. 다음 페이지가 있으면 cursor
ProductListcategory, seller/products
category와 seller/products 카드: slug, title, rating, seller
Analyticscategories, product-index
categories와 product-index 행: url, id (슬러그), 정직한 total
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. G2는 사이드카가 아닙니다.
- 01
엣지가 호출을 받음
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
- 02
검증 후 차감
레지스트리에서 g2/product (또는 reviews, category, seller)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 카탈로그를 실시간으로 읽습니다. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.
- 04
정규화 후 반환
업스트림 JSON을 Product, ProductList, ReviewList, Author, Analytics 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- 카테고리 분류 목록 라이브 미스: 1 크레딧
- 상품, 리뷰, 카테고리, 판매자, 판매자 상품, 상품 색인: 5 크레딧
- 캐시 히트: 0 크레딧
- 빈 응답 / 하드 실패: 자동 환불
- 잘못된 파라미터: 400, 과금 없음
- 크레딧 부족: 402, 과금 없음
- id 또는 url로 상품·판매자를 지정
- 리뷰는 호출당 10건, 필터 조합당 최대 10페이지
- 쓰기, 순위 제출, 벤더 대시보드 라우트 없음
데이터 수집 방식
G2는 공개 소프트웨어 카탈로그 데이터입니다. SocialCrawl 커머스 스키마로 정규화하므로 별도 리뷰 사이트 SDK를 배울 필요가 없습니다.
이 API에서 G2의 의미
공개 소프트웨어 상품 페이지, 작성 리뷰, 카테고리 탐색, 벤더 프로필, 상품 URL 색인입니다. 읽기 전용이며 벤더 대시보드와 순위 제출 접근은 없습니다.
SocialCrawl 수집 경로
상품, 리뷰, 카테고리, 판매자, 색인 라우트는 공개 G2 페이지를 실시간으로 읽습니다. 모두 같은 SocialCrawl 키로 호출합니다.
엣지에서 나가는 형태
커머스 플랫폼이 공유하는 Product, ProductList, ReviewList, Author, Analytics 아키타입의 통합 JSON 봉투입니다.
라이브로 제공하지 않는 것
벤더 로그인, 리뷰 제출, 유료 노출 도구는 없습니다. 비공개 G2 판매자 지표도 없습니다.
필드 매핑
G2 product page→ product.*title, rating, categories, seller, plans
written reviews→ ReviewList items[]stars, body, author, date
taxonomy / URL index→ Analytics rows카테고리 슬러그와 상품 리뷰 URL
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
7active G2 endpoints in the registry
1 / 5분류와 상품·리뷰 크레딧 구간
소프트웨어 카탈로그 조사, 리뷰 수집, 벤더 매핑
호출은 슬러그, 카테고리, 또는 상품 URL 색인에서 시작한 뒤 product와 reviews로 분기합니다. 상품·리뷰는 5 크레딧 고정, 카테고리 분류는 1 크레딧이며 SocialCrawl 전 구간 동일 키입니다.
상품과 분류 조회는 라이브 미스 기준 보통 수 초입니다. 콜드 카탈로그 쿼리에서는 더 걸릴 수 있습니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
카테고리 리서처
Python, notebooks, BIcategories 다음 category, 이후 후보 슬러그에 product를 호출합니다.
VoC 팀
Node, warehouses슬러그별 reviews로 경쟁 제품 언어를 모읍니다. 고급 티어이며 반복 호출은 캐시에 유리합니다.
벤더 인텔
Go, workersseller와 seller/products로 포트폴리오를 본 뒤 필요한 행에 product를 호출합니다.
엔드포인트
G2 API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 직접 G2 스크래핑, 뭐가 다른가요?
같은 G2 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 직접 G2 스크래핑 |
|---|---|---|
| 인증 | x-api-key 하나로 가입하자마자 호출하면 돼요 | 키는 없지만 프록시와 봇 차단 우회를 직접 관리해야 해요 |
| 시작하기 | 같은 슬러그로 상품 조회 후 리뷰, GET 두 번이면 끝이에요 | 헤드리스 브라우저, 프록시 풀, HTML 파서, 재시도 로직을 직접 만들어야 해요 |
| 응답 스키마 | 68개 플랫폼과 같은 통합 Product·ReviewList JSON으로 와요 | 원시 HTML을 직접 파싱해야 하고, 리뉴얼 때마다 셀렉터가 깨져요 |
| 요금 | 상품·리뷰 5 크레딧, 카테고리 목록 1 크레딧, 신용카드 없이 100 크레딧 무료 | 프록시·서버 비용에 엔지니어링 시간이 계속 들어가요 |
| 데이터 범위 | 상품 페이지, 작성 리뷰, 카테고리 분류, 판매자 포트폴리오, 상품 URL 색인까지 받아요 | 마크업이 바뀌기 전까지 파서가 뽑아내는 만큼만이에요 |
| 유지보수 | 업스트림 변경은 SocialCrawl이 흡수해 드려요 | 페이지 구조가 바뀔 때마다 스크레이퍼를 직접 고쳐야 해요 |
인증
SocialCrawl
x-api-key 하나로 가입하자마자 호출하면 돼요
직접 G2 스크래핑
키는 없지만 프록시와 봇 차단 우회를 직접 관리해야 해요
시작하기
SocialCrawl
같은 슬러그로 상품 조회 후 리뷰, GET 두 번이면 끝이에요
직접 G2 스크래핑
헤드리스 브라우저, 프록시 풀, HTML 파서, 재시도 로직을 직접 만들어야 해요
응답 스키마
SocialCrawl
68개 플랫폼과 같은 통합 Product·ReviewList JSON으로 와요
직접 G2 스크래핑
원시 HTML을 직접 파싱해야 하고, 리뉴얼 때마다 셀렉터가 깨져요
요금
SocialCrawl
상품·리뷰 5 크레딧, 카테고리 목록 1 크레딧, 신용카드 없이 100 크레딧 무료
직접 G2 스크래핑
프록시·서버 비용에 엔지니어링 시간이 계속 들어가요
데이터 범위
SocialCrawl
상품 페이지, 작성 리뷰, 카테고리 분류, 판매자 포트폴리오, 상품 URL 색인까지 받아요
직접 G2 스크래핑
마크업이 바뀌기 전까지 파서가 뽑아내는 만큼만이에요
유지보수
SocialCrawl
업스트림 변경은 SocialCrawl이 흡수해 드려요
직접 G2 스크래핑
페이지 구조가 바뀔 때마다 스크레이퍼를 직접 고쳐야 해요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기G2 상품 데이터는 어떻게 수집하나요?
SocialCrawl은 이 플랫폼의 엔드포인트 7종을 제공해요. GET /v1/g2/product에 슬러그(postman)나 상품 URL을 넣으면 이름, 설명, 별점, 리뷰 수, 카테고리, 판매자, 요금제, 기능, 대안 상품이 통합 JSON으로 와요. 같은 id로 GET /v1/g2/reviews를 호출하면 작성 리뷰를 받아요.
G2 API는 어떤 데이터를 주나요?
상품은 소프트웨어 1건의 제목, 별점, 리뷰 수, 카테고리, 판매자, 요금제, 기능, 대안, 미디어를 줘요. 리뷰는 본문과 별점이 페이지당 10건이에요. 카테고리 목록은 전체 분류 체계이고, 판매자와 판매자 상품은 벤더 프로필과 포트폴리오예요. 상품 색인은 G2 상품 URL을 호출당 100개씩 나눠 줘요.
G2 API 요금은 얼마인가요?
상품, 리뷰, 카테고리 상품 목록, 판매자, 판매자 상품, 상품 색인은 라이브 미스당 5 크레딧(어드밴스드)이에요. 카테고리 분류 목록은 1 크레딧(스탠다드)이에요. 캐시 히트는 0이고, 빈 결과와 없는 자원은 환불돼요. 새 계정은 신용카드 없이 100 크레딧이 있어요.
G2 리뷰를 수집해도 괜찮나요?
SocialCrawl은 G2의 공개 상품·리뷰 페이지만 가져와요. URL을 아는 누구나 볼 수 있는 내용이지만, 사용 목적이 G2 약관과 개인정보 관련 법령에 맞는지는 직접 확인해 주세요.
G2 공식 API를 쓰는 게 낫지 않나요?
G2 공식 API는 파트너 승인 뒤에 자사 상품 프로필을 관리하는 쪽에 맞춰져 있어요. 공개 소프트웨어 카탈로그를 읽는 용도가 아니에요. SocialCrawl은 그 공식 API가 주지 않는 공개 읽기를 다뤄요. 상품, 작성 리뷰, 카테고리, 판매자, 상품 URL 색인을 아마존·월마트·트러스트파일럿과 같은 스키마로 받아요.
가장 좋은 G2 스크레이퍼 API는 무엇인가요?
소프트웨어 카탈로그 작업이라면 SocialCrawl이 좋은 선택이에요. 상품 상세와 작성 리뷰는 5 크레딧, 카테고리 분류 목록은 1 크레딧이고, 판매자 포트폴리오와 상품 URL 색인도 있어요. 프록시나 헤드리스 브라우저를 관리할 필요 없이, 신용카드 없이 100 크레딧으로 시작할 수 있어요.
G2 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 G2 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. G2 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
AI에게 SocialCrawl을 물어보세요