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つ送信して非同期タスクを追跡し、その検索で返された正規化地域候補を読み取ります。
- 空でない都市名、地域名、地区名、または場所の名前のクエリを用意します。
- 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の出品詳細を取得し、出品者、価格、場所、メディア、属性、配送、在庫状況の各フィールドを返します。