Gumtree Search API
API 한 번의 호출로 Gumtree Search 데이터를 받아 가세요. Returns Gumtree UK classifieds matching a keyword, about 22 per page, each with ad id, title, price in GBP, location, category, seller type (private or trade), image, and listing URL. Pass a gumtree.com/search URL as url to replay an existing web search (location slugs default to a 15-mile radius unless the URL carries a distance). Price, seller_type, and attributes filters only apply when category_id is also set. Paginate with page or the universal cursor until hasNextPage is false. Feed a returned ad id into GET /v1/gumtree/product for the full listing.
2026년 9월 업데이트SocialCrawl 팀이 직접 관리해요
키워드 또는 gumtree.com 검색 URL에 맞는 영국 Gumtree 매물을 페이지당 약 22건씩 아이디, 제목, 파운드 가격, 지역, 카테고리, 판매자 유형, 매물 URL과 함께 반환합니다.
중고·차량·부동산 매물을 키워드로 찾을 때 사용합니다. 전체 매물은 반환된 아이디를 product에 넣습니다.
60개 플랫폼을 병렬로 검색합니다
Search API로 무엇을 할 수 있을까요
Search 엔드포인트가 통합 스키마와 계산 필드를 담은 Gumtree 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.
요청 예시
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/gumtree/search"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/gumtree/search",
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/gumtree/search",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
| query | 아니오 | Free-text listing search, for example iphone or golf mk7 diesel. |
| url | 아니오 | A Gumtree web search URL, for example https://www.gumtree.com/search?q=iphone&search_location=london. Keyword, category, location, and price filters on the URL are parsed server-side. |
| page | 아니오 | Page number, starting at 1. Prefer the universal cursor parameter. |
| sort_by | 아니오 | Result ordering: relevance (default), newest, price_low, or price_high. (relevance | newest | price_low | price_high) |
| category_id | 아니오 | Gumtree category id or SEO slug from GET /v1/gumtree/categories or search/suggestions. Required for price, seller_type, and attributes filters to take effect. |
| location_id | 아니오 | Gumtree location id from GET /v1/gumtree/locations or locations/nearest. |
| distance | 아니오 | Search radius in miles around location_id. Ignored without a location_id. nationwide searches the whole UK. (0 | 1 | 3 | 5 | 10 | 15 | 30 | 50 | 75 | 100 | 150 | 250 | 500 | nationwide) |
| min_price | 아니오 | Lowest asking price in GBP. Requires category_id. Filter on product.price.current if you need a hard bound. |
| max_price | 아니오 | Highest asking price in GBP. Requires category_id. |
| seller_type | 아니오 | Restrict to private (individual) or trade (dealer) sellers. Requires category_id. (private | trade) |
| attributes | 아니오 | Category-specific filters as comma-separated name:value pairs from GET /v1/gumtree/filters, for example common_for_sale_condition:new,vehicle_make:audi. Requires category_id. |
Gumtree Search API는 어떻게 동작하나요
API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.
메서드
GET
응답 형식
JSON
소셜 미디어 데이터를 몇 초 만에 수집하는 방법
개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 60개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.
모든 플랫폼을 하나의 스키마로
동일한 응답 구조로 60개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.
단순 수집을 넘어 계산된 필드 제공
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.
코드 한 줄 쓰기 전에, 데이터부터
Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Gumtree Search 데이터, 가져올 준비 되셨어요?
API 키 받고 60초 안에 Gumtree 데이터를 받아 가세요.
