Facebook Marketplace Location Search
Facebook Marketplace 위치는 이름, 부제목, 주소 정보, 도시와 우편번호, 지리 좌표로 식별되는 장소 후보입니다. 이러한 필드는 위치 구분, 검색 중심지 선택, 지역 판매 상품 조사용 재사용 가능한 장소 선택기에 활용할 수 있습니다.
Facebook Marketplace Location Search API 주요 기능
- 장소 이름으로 위치 확정도시, 지역, 동네 또는 장소 이름을 제출하면 해당 조회에서 반환된 Marketplace 위치 후보를 모두 받을 수 있습니다.
- 위치 구분용 필드후보의 이름, 부제목, 주소, 도시, 우편번호, 위도, 경도를 비교해 이름이 같은 장소를 구분합니다.
- 추적 가능한 정규화 후보후보마다 Facebook 위치 ID, 원래 검색어, 수집 시각을 함께 보존해, 선택한 장소를 검토하고 다시 사용할 수 있습니다.
Facebook Marketplace Location Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | Austin과 같은 도시, 지역, 동네 또는 장소 이름으로, 비어 있지 않아야 하는 필수 값입니다. |
Facebook Marketplace Location Search API 사용 방법
장소 이름 검색어를 하나 제출하고, 비동기 작업을 따라간 뒤, 해당 조회에서 반환된 정규화된 위치 후보를 읽습니다.
- 비어 있지 않은 도시, 지역, 동네 또는 장소 이름 검색어를 준비합니다.
- query를 /v1/facebook-marketplace/location-search로 제출하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안에는 next_cursor를 따라 다음 결과를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/location-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Austin"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueFacebook Marketplace Location Search API 추천 활용 사례
- 판매 상품 검색 중심지 확정: 후보의 위도와 경도를 선택해 Facebook Marketplace Search에 필요한 지리적 중심지를 지정합니다.
- 동일 이름 장소 구분: 이름이 비슷한 후보 중에서 고르기 전에 부제목, 도시, 우편번호, 주소, 좌표를 비교합니다.
- 재사용 가능한 위치 선택기 데이터: 위치 ID, 표시 이름, 장소 유형, 좌표를 선택기에 저장해 두고 이후 지역 판매 상품 조회에 사용합니다.
Facebook Marketplace Location Search API 활용 팁
- 짧은 장소 이름이 여러 위치와 일치할 수 있다면 지역이나 동네 정보를 함께 넣으세요.
- 이름이 같은 후보를 채택하기 전에 부제목, 도시, 우편번호, 주소, 좌표를 비교하세요.
- 위치 조회는 검색어에 대해 반환된 후보를 모두 저장하므로 results_limit 매개변수는 보내지 마세요.
- 저장된 후보가 작업 결과 페이지네이션에 가려지지 않도록 has_more가 true일 때는 계속해서 next_cursor를 따라가세요.
- 비어 있는 items 목록은 해결되지 않은 검색어로 보고, 그 지역에서 Marketplace를 이용할 수 없다는 증거로 해석하지 마세요.
관련 API
Facebook Marketplace Location Search API 외에 Facebook Marketplace의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Facebook Marketplace Search API — 키워드와 좌표로 공개 Marketplace 판매 상품을 검색하며, 가격, 위치, 미디어, 카테고리, 배송, 재고 맥락을 포함합니다.
- Facebook Marketplace Item API — 알고 있는 상품 URL에서 공개 Marketplace 판매 상품 상세를 수집하며, 판매자, 가격, 위치, 미디어, 속성, 배송, 재고 필드를 포함합니다.