facebook-marketplace/
location-search

都市、地域、地区、場所の名前からFacebook Marketplaceの地域候補を検索し、名前、場所の種類、住所、座標を正規化レコードとして返します。

Facebook Marketplace Location Search API

地名で検索
地域候補
緯度・経度
結果1件あたり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つ送信して非同期タスクを追跡し、その検索で返された正規化地域候補を読み取ります。

  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クレジットです。現在の課金設定では、結果が0件の場合は結果に対する課金は発生しません。