TCIN 상품 상세
5 크레딧/v1/target/productTCIN 1건의 Target 상품 상세입니다. 제목, 가격, 평점, 이미지가 포함됩니다. 고급 티어(5 크레딧)입니다.
tcin
Target APITarget 상품·매장 데이터 API
SocialCrawl API 키로 Target 상품 상세, 리뷰, 카테고리, 분류, 근처 매장을 구조화 JSON으로 가져옵니다. 공유 커머스 스키마입니다. 호출은 크레딧으로 과금됩니다.
/v1/target
활성 엔드포인트는 5개입니다. 1·5 크레딧 티어입니다.
- GET /v1/target/product
- GET /v1/target/reviews
- GET /v1/target/category
- GET /v1/target/categories
- GET /v1/target/stores
Target 엔드포인트
Target 읽기 엔드포인트는 5개입니다. TCIN 상품 상세, 리뷰, 카테고리 목록, 분류, 매장 검색을 제공합니다. 데이터 API만 지원합니다.
상품 리뷰
5 크레딧/v1/target/reviewsTarget TCIN 리뷰입니다. 평점, 본문, 작성자, 선택 page가 있습니다. 고급 티어(5 크레딧)입니다.
tcin, page
카테고리 목록
5 크레딧/v1/target/categorycategory_id 안의 상품 목록입니다. page를 선택할 수 있습니다. 고급 티어(5 크레딧)입니다.
category_id, page
카테고리 분류
1 크레딧/v1/target/categoriesTarget 카테고리 분류 참조입니다. category 상품 목록에 쓸 id를 여기서 얻습니다. 표준 티어(1 크레딧)입니다.
(none)
매장 검색
1 크레딧/v1/target/stores위치 쿼리(우편번호 또는 지역) 근처 Target 매장을 찾습니다. PlaceList 형태입니다. 표준 티어(1 크레딧)입니다.
query
Target API5개 엔드포인트 지원
문서 보기Products
Reviews
Reference
Stores
Target 상품을 TCIN으로 조회해 제목, 브랜드, 설명, 현재가와 정가, 별점 분포, 이미지, 옵션, 재고 상태를 반환합니다.
가격은 매장별 가격이 아니라 전국 카탈로그 가격입니다. TCIN으로 상품 상세 전체가 필요할 때 사용하세요.
5크레딧
GET/v1/target/product?tcin=92148487
tcin · Target catalogue id (TCIN), the numeric id at the end of a target.com product URL: target.com/p/<name>/-/A-92148487 is TCIN 92148487. Target rolls a colour or size variant up to its parent product, so the id returned by GET /v1/target/product can differ from the one you sent; the id you asked for is preserved at product.ext.requested_id.
$ curl https://www.socialcrawl.dev/v1/target/product?tcin=92148487 \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Target API 동작
Target도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/target/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Target OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
GET과 쿼리 파라미터
Target 라우트는 모두 GET입니다. tcin, category_id, query, page를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
product, reviews, category는 5 크레딧입니다. categories 분류와 stores는 1 크레딧입니다. 캐시 히트는 0 크레딧입니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 엔티티를 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
01분류
GET /v1/target/categories카테고리 id와 라벨
목록 전에 category_id를 확정합니다.
02목록
GET /v1/target/category?category_id=…TCIN이 있는 ProductList
키워드 없이 구색을 봅니다.
03상품
GET /v1/target/product?tcin=…TCIN 전체 Product
SKU 1건을 깊게 봅니다.
04리뷰
GET /v1/target/reviews?tcin=…TCIN ReviewList
해당 SKU 고객 언어입니다.
요청
GET /v1/target/categories
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/target/product?tcin=92148487
GET /v1/target/reviews?tcin=92148487응답 봉투
{
"success": true,
"data": {
"product": {
"id": "92148487",
"title": "Example product",
"price": { "current": 12.99, "currency": "USD" },
"rating": 4.6
}
},
"credits_used": 5,
"credits_remaining": 9995,
"request_id": "req_…",
"cached": false
}data 형태
아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 플랫폼에 재사용합니다.
Productproduct
id (TCIN), title, price, rating, images
ProductListcategory
items[]에 tcin, title, price
ReviewListreviews
items[]에 rating, text, author
Analytics / PlaceListcategories, stores
분류 행 또는 query 근처 매장
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Target은 사이드카가 아닙니다.
- 01
엣지가 호출을 받음
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
- 02
검증 후 차감
레지스트리에서 target/product (or reviews, category, stores)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 Target commerce upstream paths run. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.
- 04
정규화 후 반환
업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- product / reviews / category: 5 크레딧
- categories 분류: 1 크레딧
- stores: 1 크레딧
- 캐시 히트: 0 크레딧
- 빈 응답 / 하드 실패: 자동 환불
- 잘못된 파라미터: 400, 과금 없음
- 크레딧 부족: 402, 과금 없음
- 상품 심화 키는 tcin
- 장바구니·RedCard 도구 없음
데이터 수집 방식
Target은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
이 API에서 Target의 의미
공개 상품, 리뷰, 카테고리 분류, 매장 위치입니다. 읽기 전용입니다.
SocialCrawl 수집 경로
통합 /v1 봉투 뒤의 Target 커머스 업스트림 경로입니다.
엣지에서 나가는 형태
Product, ProductList, ReviewList, PlaceList, 분류 analytics 형태입니다.
라이브로 제공하지 않는 것
장바구니, Circle, 매장 재고 쓰기는 없습니다.
필드 매핑
TCIN row→ product.*title, price, rating
review pages→ ReviewList선택 page 파라미터
taxonomy / stores→ Analytics / PlaceList카테고리 id; 매장 위치
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
5active Target endpoints in the registry
1 / 5taxonomy·stores와 product·reviews·category 크레딧 구간
구색, 리뷰, 매장 근접
호출은 검색 또는 분류 후 후보 엔티티의 상세·리뷰 심화에 몰립니다. TCIN 상품·리뷰 5 크레딧, 분류·매장 1 크레딧, SocialCrawl 동일 키입니다.
라이브 미스는 보통 수 초입니다. 일부 경로는 콜드 캐시에서 더 걸릴 수 있습니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
리테일 머천다이저
Python, BIcategories 후 category 목록, product로 TCIN 사실을 확인합니다.
VoC 팀
Node, warehousesTCIN별 reviews로 고객 언어를 모읍니다.
로컬 운영
scripts, maps우편번호·지역 query로 stores 근접을 확인합니다.
두 줄로 호출
product와 reviews는 5 크레딧입니다. 분류와 stores는 1 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/target/product?tcin=92148487" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/target/stores?query=10001" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Target API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 직접 타겟닷컴 크롤링, 뭐가 다른가요?
같은 Target 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 직접 타겟닷컴 크롤링 |
|---|---|---|
| 구축 | API 키 하나로 GET 한 번 | 헤드리스 브라우저, 프록시 풀, GraphQL 응답 파서까지 직접 |
| 상품 응답 | 정리된 통합 JSON 약 3KB | 직접 걸러내야 하는 원본 GraphQL 100KB |
| 리뷰 페이지 처리 | 마지막 페이지에서 정확히 멈추는 커서 | 페이지를 직접 넘기며 중복까지 직접 제거 |
| 차단된 요청 | 자동 재시도, 끝내 실패하면 요금 없음 | 직접 감당, 비용도 그대로 |
| 여러 유통사 파싱 | 아마존·월마트·구글 쇼핑과 같은 구조 | 유통사마다 파서를 새로 제작 |
구축
SocialCrawl
API 키 하나로 GET 한 번
직접 타겟닷컴 크롤링
헤드리스 브라우저, 프록시 풀, GraphQL 응답 파서까지 직접
상품 응답
SocialCrawl
정리된 통합 JSON 약 3KB
직접 타겟닷컴 크롤링
직접 걸러내야 하는 원본 GraphQL 100KB
리뷰 페이지 처리
SocialCrawl
마지막 페이지에서 정확히 멈추는 커서
직접 타겟닷컴 크롤링
페이지를 직접 넘기며 중복까지 직접 제거
차단된 요청
SocialCrawl
자동 재시도, 끝내 실패하면 요금 없음
직접 타겟닷컴 크롤링
직접 감당, 비용도 그대로
여러 유통사 파싱
SocialCrawl
아마존·월마트·구글 쇼핑과 같은 구조
직접 타겟닷컴 크롤링
유통사마다 파서를 새로 제작
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기SocialCrawl 타겟 API로 어떤 데이터를 받을 수 있나요?
상품 상세(상품명, 브랜드, 설명, 핵심 특징, 판매가와 정가, 평균 별점과 1~5점 분포, 작성 리뷰 수, 이미지 갤러리, 색상·사이즈 옵션, 재고 상태)와 고객 리뷰(본문, 별점, 작성자 닉네임, 작성일, 도움돼요 수, 구매 인증 여부, 첨부 사진)를 받을 수 있어요.
타겟 TCIN은 어디서 확인하나요?
상품 URL 맨 뒤에 있는 숫자예요. target.com/p/beats-solo-buds-true-wireless-bluetooth-earbuds/-/A-92148487 이라면 TCIN은 92148487이에요. 이 값을 tcin 파라미터로 넣으면 두 엔드포인트 모두 사용할 수 있어요. 형식이 잘못된 값은 크레딧 차감 전에 걸러내요.
타겟 키워드 검색 엔드포인트도 있나요?
없어요. 일부러 뺐어요. 타겟 검색은 결과가 최대 24개로 막혀 있고, 페이지 파라미터를 무시하고, 결과가 없는 검색어에도 관련 없는 상품 24개를 돌려줘요. 진짜 결과인지 아닌지 구분할 방법이 없어서, 그대로 팔면 요청하지도 않은 데이터에 요금을 매기게 돼요. TCIN을 준비하시거나 통합 검색을 써 주세요.
요청한 TCIN과 다른 값이 돌아왔어요. 왜 그런가요?
타겟은 색상·사이즈 옵션을 부모 상품으로 묶어요. 옵션 상품을 요청하면 그 계열 전체를 설명하는 부모 상품이 돌아와요. id는 항상 실제로 받은 데이터의 상품을 가리키고, 요청한 값과 다를 때는 ext.requested_id에 원래 요청한 id가 남아 있어서 추적이 끊기지 않아요.
한 번 호출하면 리뷰가 몇 개 오나요? 페이지가 겹치지는 않나요?
한 페이지에 10개씩 와요. 타겟이 고정한 값이라 늘릴 수 없어요. 대신 페이지끼리 절대 겹치지 않고 전체 개수도 정확해서, has_more가 false가 될 때까지 커서를 넘기면 수집이 깔끔하게 끝나요. 별점 분포만 필요하면 상품 엔드포인트의 ext.rating_distribution을 보세요. 호출 한 번이면 돼요.
별점 개수와 리뷰 개수가 왜 다른가요?
서로 다른 집계예요. 별점 개수는 점수만 남긴 사람까지 포함하고, 리뷰 개수는 글을 쓴 사람만 세요. 리뷰 엔드포인트가 넘겨주는 것도 후자예요. 보통 별점 개수가 리뷰 개수의 두세 배예요. 둘 다 타겟이 알려주는 값 그대로이고 추정치가 아니에요.
타겟 가격은 매장마다 다른가요?
이 엔드포인트에서는 달라지지 않아요. 타겟 상품 API는 어느 매장을 지정해도 같은 가격을 돌려줘서, 매장이나 우편번호 파라미터를 아예 만들지 않았어요. 전국 기준 가격으로 보시면 돼요. 매장별로 실제 가격이 다른 월마트는 우편번호·주·매장 ID를 받아요.
Target 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Target 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Target 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Target 스크래핑 API와 공식 Target API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Target 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요