상품 검색
1 크레딧/v1/idealo/search키워드로 idealo 이탈리아 상품을 페이지당 약 30개씩 idealo 전체 건수와 함께 반환합니다. 상품 id, 이름, idealo 링크, 이미지, 유로 기준 최저가, idealo가 비교하는 판매처 제안 수가 포함됩니다. 표준 티어(1 크레딧)입니다.
query, page, country
idealo 이탈리아 가격 비교를 읽는 엔드포인트는 2개입니다. 키워드로 상품을 검색하고 상품 하나와 그 상품을 파는 판매처를 읽습니다.
/v1/idealo/search키워드로 idealo 이탈리아 상품을 페이지당 약 30개씩 idealo 전체 건수와 함께 반환합니다. 상품 id, 이름, idealo 링크, 이미지, 유로 기준 최저가, idealo가 비교하는 판매처 제안 수가 포함됩니다. 표준 티어(1 크레딧)입니다.
query, page, country
/v1/idealo/productidealo.it 링크로 idealo 이탈리아 상품 하나를 반환합니다. 이름, 브랜드, 이미지, 재고, 유로 기준 최저가, idealo가 집계한 판매처 수, 제안별 판매처와 정확한 가격, 배송 안내, 링크가 포함됩니다. 표준 티어(1 크레딧)입니다.
url, country
키워드로 idealo 이탈리아 상품을 검색하며, 유로 기준 최저가와 상품별 판매처 수를 반환합니다.
이탈리아 시장의 상품 유형별 가격을 비교할 때 사용하세요. 이탈리아만 지원합니다.
1크레딧
query · Product keywords, 1 to 200 characters, for example iphone 15.
$ curl https://www.socialcrawl.dev/v1/idealo/search?query=iphone+15 \
-H "x-api-key: sc_YOUR_API_KEY"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다idealo도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/idealo/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 idealo 계정은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
검색은 query와 커서를 받고 상품 상세는 idealo.it 상품 링크인 url을 받습니다. 두 경로 모두 IT만 받는 country를 받습니다. 과금 전에 형식을 검증합니다.
idealo의 두 경로는 모두 1 크레딧입니다. 캐시 히트는 0입니다.
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
대부분 제품은 추적할 상품을 검색한 뒤 가격을 확인할 때마다 상품 상세를 읽습니다.
GET /v1/idealo/search?query=…최저가와 판매처 수가 있는 ProductList
결과마다 상품 상세가 받는 idealo 상품 링크가 담깁니다.
GET /v1/idealo/product?url=…최저가, 판매처 수, 판매처 제안이 있는 Product
제안마다 판매처와 유로 기준 정확한 가격이 담기므로 주기 호출로 판매처별 가격 변화를 추적합니다.
GET /v1/idealo/product?url=https%3A%2F%2Fwww.idealo.it%2Fconfronta-prezzi%2F203235721%2Fapple-iphone-15.html
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here{
"success": true,
"data": {
"product": {
"id": "203235721",
"title": "Apple iPhone 15",
"brand": "Apple",
"price": {
"current": 573.93,
"original": null,
"currency": "EUR"
},
"availability": "In stock",
"ext": {
"idealo": {
"offer_count": 56,
"offers": [
{
"seller": "amicoemporio.it",
"price": 573.93,
"currency": "EUR",
"delivery": "Consegna: fino a mar 01.12.",
"url": "https://www.idealo.it/relocator/relocate?…"
}
]
}
}
}
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 여러 플랫폼에 재사용합니다.
items[]에 id, title, url, image_urls, EUR 기준 price, ext.idealo.offer_count, total과 next_cursor
title, brand, image_urls, availability, EUR 기준 price, ext.idealo의 offer_count와 offers[](seller, price, currency, delivery, url)
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. idealo은 사이드카가 아닙니다.
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
레지스트리에서 idealo 경로를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 읽기를 시작하기 전에 티어 비용을 원자적으로 차감합니다.
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 공개 데이터를 실시간으로 읽으며 5xx나 네트워크 오류는 재시도하고 소스가 불안정하면 서킷 브레이커를 사용합니다.
idealo 데이터를 Product 아키타입으로 매핑하고 idealo 전용 정보를 product.ext.idealo에 담아 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
idealo 가격 비교 페이지는 공개 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
idealo 이탈리아의 가격 비교 페이지입니다. 키워드 검색 결과와 상품 하나, 그 상품을 파는 판매처와 판매처별 가격을 읽습니다.
공개 가격 비교 페이지를 요청 시점에 읽어 서버에서 정규화합니다. idealo 로그인이나 연동을 직접 운영할 필요가 없습니다.
검색은 ProductList, 상품 하나는 Product로 공통 커머스 형태입니다. 판매처 수와 판매처 제안 같은 idealo 전용 정보는 product.ext.idealo에 담깁니다.
주문, 계정, 가격 알림, 로그인이 필요한 데이터는 제공하지 않습니다.
이 API가 가장 많이 사용되는 작업입니다.
이탈리아 가격 비교와 판매처 가격 모니터링
호출은 관심 상품의 idealo 링크를 보관하고 주기적으로 상품 상세를 읽는 흐름입니다. idealo 이탈리아의 판매처 제안과 유로 기준 정확한 가격을 같은 키로 호출하며 공통 Product 스키마로 받습니다.
라이브 미스는 요청 시점에 공개 가격 비교 페이지를 읽습니다. 반복 호출은 캐시에서 0 크레딧으로 응답합니다.
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
상품 상세를 주기적으로 호출해 판매처별 가격과 배송 안내를 기록합니다.
한 상품을 파는 이탈리아 판매처 수와 가격 분포를 비교합니다.
판매 중인 상품에서 다른 판매처가 더 낮은 가격을 내면 알립니다.
idealo의 두 경로는 모두 1 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/idealo/search?query=iphone%2015" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/idealo/product?url=https%3A%2F%2Fwww.idealo.it%2Fconfronta-prezzi%2F203235721%2Fapple-iphone-15.html" \
-H "x-api-key: sc_your_api_key_here"모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요