플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Craigslist 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 선택한 도시와 섹션에서 Craigslist 분류 광고를 검색합니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Craigslist 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 선택한 도시와 섹션에서 Craigslist 분류 광고를 검색합니다. 각 게시물의 제목, 가격, 위치, 날짜, 좌표, 이미지, 기재된 연락처가 포함됩니다. 이름과 달리 | keyword | category, country, location, max_price, min_price, region, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · price · currency · category · location · posted_at · lat · lng · emails · phones · images · platform |
Craigslist search 파라미터는 각각 무엇을 의미하나요?
선택한 도시와 섹션에서 Craigslist 분류 광고를 검색합니다. 각 게시물의 제목, 가격, 위치, 날짜, 좌표, 이미지, 기재된 연락처가 포함됩니다. 이름과 달리 country는 newyork, sfbay 같은 도시 사이트를 선택하며, 인식되지 않는 region 값은 뉴욕으로 대체됩니다.
keyword필수- Craigslist 분류 광고 검색어를 지정합니다(예: bicycle). 검색 결과는 선택한 카테고리에 따라 달라지므로, 같은 검색어로 판매, 주거 또는 구인 카테고리를 조회할 수 있습니다.
category선택- 상품 정보 카테고리 슬러그를 지정합니다. 사용 가능한 값은 for_sale(기본값), cars_trucks, electronics, furniture, housing_apartments_houses, housing_rooms_shares, housing_sublets_temporary, jobs, gigs, resumes, services, community, events입니다.허용 값:
cars_truckscommunityelectronicseventsfor_salefurnituregigshousing_apartments_houseshousing_rooms_shareshousing_sublets_temporaryjobsresumesservicesCraigslist: 카테고리 디렉터리와 텍스트 검색은 어떻게 함께 작동하는가 — Craigslist 공식 안내에 따르면 먼저 지역 카테고리를 선택한 다음 텍스트 검색어로 결과를 좁힙니다. 이 액션의 category 파라미터는 위에 정의된 중립적인 값을 사용하며, 공식 플랫폼 카테고리 코드나 기타 사이트 필터를 직접 받지 않습니다. · 확인일 country선택- 국가 코드가 아니라 대상 도시 서브도메인을 선택합니다. 스키마에 나열된 값(예: newyork, sfbay, toronto)을 사용할 수 있습니다. 지정하면 region이나 location으로 선택한 서브도메인보다 우선합니다.허용 값:
anchorageatlantaaustinbaltimorebostoncalgarycharlottechicagocincinnaticlevelandcolumbusdallasdenverdetroitedmontonhartfordhonoluluhoustonindianapoliskansascitylasvegaslosangelesmiamimilwaukeeminneapolismontrealnashvillenewhavennewyorkorlandoottawaphiladelphiaphoenixpittsburghportlandprovidenceraleighrichmondsacramentosalemsaltlakecitysanantoniosandiegoseattlesfbaystlouistampatorontovancouverwashingtondcCraigslist: 지역 선택과 도시별 하위 사이트 검색은 어떻게 다른가 — Craigslist는 지역 위치 선택을 검색어 처리와 분리하며, 지도와 ZIP 코드로 범위를 좁히는 공식 도구를 제공합니다. 이 액션에서 country / region 파라미터는 위에 정의된 도시 하위 사이트 형식만 받으며, 우편번호나 반경 필터는 지원하지 않습니다. · 확인일 location선택- region의 대체 입력값으로, region을 생략한 경우에만 평가됩니다. 도로명 주소, 우편번호, 지리 좌표가 아니라 Craigslist 도시 서브도메인에 대응합니다.
max_price선택- 선택한 도시 서브도메인과 카테고리에서 상품 정보에 적용할 최대 가격을 설정합니다. min_price와 함께 사용하며, 통화와 결제 주기는 개별 상품 정보에 따라 결정됩니다. 필터링에는 정수를 사용하며 소수는 올림합니다. 예를 들어 145.98은 146이 됩니다.
min_price선택- 선택한 도시 서브도메인과 카테고리에서 상품 정보에 적용할 최소 가격을 설정합니다. API 요청 비용을 뜻하지 않으며, 가격의 의미는 카테고리마다 다릅니다(예: 중고 물품 판매 가격과 주택 임대료). 필터링에는 정수를 사용하며 소수는 내림합니다. 예를 들어 39.81은 39가 됩니다.
region선택- 도시 서브도메인 슬러그를 지정합니다(예: newyork, sfbay, toronto). 목록에 있는 값을 정확히 쓰거나 nyc, la, dc, sanfrancisco 같은 일반적인 별칭을 사용할 수 있습니다. 인식할 수 없는 입력은 newyork으로 대체되므로, 입력값이 그대로 사용되었다고 가정하지 말고 반환된 location을 확인해야 합니다.
sort선택- 결과를 최신 게시일순(newest), 가격 오름차순(price_asc) 또는 관련도순(relevance)으로 정렬하며, 생략하면 최신 게시일순으로 정렬합니다. 판매자 평판이나 거래량으로는 정렬하지 않습니다.허용 값:
newestprice_ascrelevance
Craigslist API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"craigslist","action":"search","params":{"keyword":"<keyword>"}}'
Craigslist API 자주 묻는 질문
Craigslist API로 무엇을 가져올 수 있나요?
platform을 craigslist 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색입니다. 각 액션 이름은 서로 다른 Craigslist 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Craigslist search 요청에는 어떤 입력이 필요한가요?
Craigslist 분류 광고 검색어를 지정합니다(예: bicycle). 검색 결과는 선택한 카테고리에 따라 달라지므로, 같은 검색어로 판매, 주거 또는 구인 카테고리를 조회할 수 있습니다. params 안의 keyword 필드로 전달하세요.
Craigslist search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, price 및 currency입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Craigslist 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.