facebook-marketplace/
location-search

도시, 지역, 동네 또는 장소 검색어로 Facebook Marketplace 위치 후보를 찾고, 이름, 장소 유형, 주소, 좌표를 정규화된 레코드로 반환합니다.

Facebook Marketplace Location Search API

장소 이름 검색
위치 후보
위도·경도
결과당 0.3 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

장소 이름 검색어를 하나 제출하고, 비동기 작업을 따라간 뒤, 해당 조회에서 반환된 정규화된 위치 후보를 읽습니다.

  1. 비어 있지 않은 도시, 지역, 동네 또는 장소 이름 검색어를 준비합니다.
  2. query를 /v1/facebook-marketplace/location-search로 제출하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Facebook Marketplace Location Search API 추천 활용 사례

  • 판매 상품 검색 중심지 확정: 후보의 위도와 경도를 선택해 Facebook Marketplace Search에 필요한 지리적 중심지를 지정합니다.
  • 동일 이름 장소 구분: 이름이 비슷한 후보 중에서 고르기 전에 부제목, 도시, 우편번호, 주소, 좌표를 비교합니다.
  • 재사용 가능한 위치 선택기 데이터: 위치 ID, 표시 이름, 장소 유형, 좌표를 선택기에 저장해 두고 이후 지역 판매 상품 조회에 사용합니다.

Facebook Marketplace Location Search API 활용 팁

  • 짧은 장소 이름이 여러 위치와 일치할 수 있다면 지역이나 동네 정보를 함께 넣으세요.
  • 이름이 같은 후보를 채택하기 전에 부제목, 도시, 우편번호, 주소, 좌표를 비교하세요.
  • 위치 조회는 검색어에 대해 반환된 후보를 모두 저장하므로 results_limit 매개변수는 보내지 마세요.
  • 저장된 후보가 작업 결과 페이지네이션에 가려지지 않도록 has_more가 true일 때는 계속해서 next_cursor를 따라가세요.
  • 비어 있는 items 목록은 해결되지 않은 검색어로 보고, 그 지역에서 Marketplace를 이용할 수 없다는 증거로 해석하지 마세요.

Facebook Marketplace Location Search API 외에 Facebook Marketplace의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Facebook Marketplace Search API — 키워드와 좌표로 공개 Marketplace 판매 상품을 검색하며, 가격, 위치, 미디어, 카테고리, 배송, 재고 맥락을 포함합니다.
  • Facebook Marketplace Item API — 알고 있는 상품 URL에서 공개 Marketplace 판매 상품 상세를 수집하며, 판매자, 가격, 위치, 미디어, 속성, 배송, 재고 필드를 포함합니다.

다른 플랫폼 둘러보기

Facebook Marketplace 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Facebook Marketplace Location Search API — 자주 묻는 질문

Facebook Marketplace Location Search API는 비어 있지 않은 도시, 지역, 동네 또는 장소 검색어를 정규화된 위치 후보로 변환하는 API입니다. 이름, 장소 유형, 주소 정보, 위도, 경도, 원래 검색어를 반환합니다.

Austin처럼 비어 있지 않은 도시, 지역, 동네 또는 장소 이름을 사용하세요. 같은 이름의 장소가 여러 곳이라면 지리적 정보를 덧붙이면 도움이 됩니다.

후보의 이름과 부제목을 extra.city, extra.postal_code, extra.address, extra.latitude, extra.longitude와 비교하세요. 위치 ID와 원래 검색어로 추적성을 더 확보할 수 있습니다.

아니요. 제출 엔드포인트는 검색어에 대해 반환된 후보를 모두 저장하며, 완료된 작업 응답에서는 next_cursor와 has_more로 저장된 결과 레코드를 페이지네이션할 수 있습니다.

올바른 후보를 고른 뒤, 그 후보의 extra.latitude와 extra.longitude 값을 판매 상품 검색어와 함께 Facebook Marketplace Search의 검색 중심지로 전달하세요.

items 배열이 비어 있다면 위치 조회에서 제출한 검색어를 확정하지 못했다는 뜻입니다. 그 지역에서 Facebook Marketplace를 이용할 수 없다는 의미는 아닙니다.

반환된 위치 후보 1건마다 0.3 SocQ 크레딧이 차감됩니다. 현재 과금 설정에서는 결과가 비어 있으면 결과 요금이 발생하지 않습니다.