API一覧に戻る
独立系のFacebook Marketplaceデータ

Facebook Marketplace API

地名を検索用の座標に変換したり、キーワードと地域で公開Marketplaceの出品を検索したり、既知の商品URLから価格、出品者、メディア、属性、在庫状況の詳細データを取得したりできます。

利用できるFacebook Marketplace API

地名の解決にはLocation Search、座標周辺の出品の検索にはSearch、既知のMarketplace商品URLから詳細レコードを取得するにはItemを使用します。

取得できるFacebook Marketplaceデータ

SocQは正規化された公開の地域候補、出品の検索結果、商品の詳細を返し、地域市場の調査、価格分析、在庫の追跡、出品情報の補完に活用できるようにします。

Marketplaceの地域候補

都市、地域、地区、地名を、Facebookの地域ID、ラベル、住所のコンテキスト、緯度、経度に変換します。

公開出品の基本情報

取得可能な場合、出品ID、タイトル、説明文、取得元URL、カテゴリ、出品日のテキスト、取得日時を取得します。

価格と通貨

取得可能な価格、通貨コード、整形済みの価格、取り消し線付きの価格を、正規化された各出品とともに保持します。

所在地と配送のデータ

取得可能な場所のラベル、市区町村と州の値、座標、配送方法、発送のシグナル、受け取りのコンテキストを取得します。

メディア、属性、出品者のコンテキスト

取得元が提供している場合、公開出品の画像、商品の属性、状態の値、出品者の情報を取得します。

在庫状況と出品の状態

販売中、売約済み、取引中、非表示、公開中、メッセージ、今すぐ購入のシグナルを保持し、特定時点の出品分析に活用できます。

SocQ vs Meta Graph API

SocQは、対応する公開Marketplaceデータの取得に特化しています。MetaのGraph APIは認可されたMetaのアセット向けに設計されており、一般的な公開Marketplaceの検索APIは提供していません。

機能SocQMeta Graph API
主な用途公開Marketplaceの地域、検索、商品の取得ユーザーや企業が認可した対象アセットの管理
顧客側のOAuthSocQのAPIキーのみ。顧客のFacebook OAuthは不要Metaアプリ、権限、アクセストークン
公開出品の検索キーワードと解決済みの地域で対応一般的な公開Marketplace出品の検索エンドポイントなし
出品の作成・編集非対応一般消費者向けのMarketplace出品エンドポイントなし
レスポンス形式正規化されたSocQレコード対象プロダクト向けのGraph API独自のオブジェクト

Facebook Marketplace APIの仕組み

必要に応じて検索の中心地点を解決し、出品の検索または既知の商品URLを送信してから、共通の非同期タスクフローで正規化レコードを読み取ります。

  1. 1. 起点となる入力を用意

    地名を座標に変換するか、既知の座標を使うか、公開Marketplaceの商品URLから直接始めます。

  2. 2. タスクを送信して追跡

    対応するPOSTリクエストを送信し、返された task_id を保存して、処理が終わるまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 正規化された結果を読み取る

    data.results.items を処理し、has_more が true の間は next_cursor をたどります。

地域を解決して出品を検索

まず地名を解決し、選んだ候補の座標を使って公開Marketplaceの出品を検索します。

# Resolve a place name
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"}'

# Search listings around the selected coordinates
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"bike","latitude":30.2677,"longitude":-97.7475,"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Facebook Marketplace APIの主なユースケース

地域の出品の発掘

市場エリアを解決し、キーワード、座標、半径、価格、状態、配送方法、日付、在庫状況で公開出品を検索します。

地域の価格比較

類似する公開出品について、正規化された希望価格、通貨、タイトル、カテゴリ、状態、所在地を比較します。

地域の在庫モニタリング

選んだ市場で上限付きの出品スナップショットを取得し、公開在庫、配送オプション、在庫状況の推移を比較します。

既知の出品の情報補完

既知の商品URLを、説明文、出品者のコンテキスト、価格、所在地、メディア、属性、状態のフィールドを含む詳細レコードに変換します。

制限事項と公開データポリシー

Marketplaceの結果は、特定時点の公開レコードです。これらのAPIは一般消費者向けのMarketplaceの画面を再現するものではなく、出品やアカウントの管理も行いません。

  • Location Searchには空でない地名のクエリが1つ必要で、results_limit は受け付けません。似た名前の候補が複数返る場合があります。
  • 地域候補を出品検索の中心地点として使う前に、住所のコンテキストと座標を確認してください。
  • Searchには、空でないキーワード、latitude、longitude が必要です。results_limit のデフォルトは100で、1〜2,000の整数を指定できます。
  • 検索結果では、説明文、出品者の詳細、正確な座標、属性、作成日時が欠ける場合があり、重複する出品IDは1回だけ保存されます。
  • Itemには、対応する /marketplace/item/{numeric_id} 形式のURLが必要です。有効なURLごとに最大1件のレコードを返し、利用できない商品はスキップされる場合があります。
  • 結果が空の場合、公開データに一致するものがない、フィルターの条件が厳しい、地域ごとの提供状況、出品が利用できない、公開ソースの範囲外などの理由が考えられます。

Facebook Marketplace APIに関するよくある質問

Facebook Marketplace APIとは何ですか?

Facebook Marketplace APIは、Marketplaceの地域の解決、公開出品の検索、既知の商品URLからの詳細レコードの取得ができるSocQのエンドポイント群です。

どのFacebook Marketplace APIを使えばよいですか?

地名の解決にはLocation Search、座標周辺の出品の検索にはSearch、公開Marketplaceの商品URLがすでにある場合はItemを使用してください。

Facebook Marketplaceを地域で検索するにはどうすればよいですか?

都市、地域、地区、地名をLocation Searchに送信し、正しい候補を選んでから、その latitude と longitude をSearchに渡します。

Facebook Marketplace Searchは何を返しますか?

Searchでは、出品の基本情報、タイトル、説明文、価格、所在地、画像、出品者のコンテキスト、カテゴリ、配送オプション、状態のフィールド、取得元URL、取得日時を返す場合があります。

Facebook Marketplace Itemはどのような場合に使いますか?

既知の公開商品URLについて、説明文、出品者、価格、所在地、メディア、属性、配送、在庫状況の詳細なフィールドが必要な場合にItemを使用します。

結果の件数が results_limit より少なくなるのはなぜですか?

上限は指定した最大値です。公開ページがそれ以上ない場合、フィルターでレコードが除外された場合、重複する出品IDが除去された場合に、取得が途中で終わることがあります。

Facebook Marketplaceの結果の料金はどのように計算されますか?

返された結果1件あたり、地域候補は0.3クレジット、Searchの出品は0.7クレジット、Itemのレコードは0.6クレジットです。結果が空の場合、結果に対する料金は発生しません。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

X API

公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。

LinkedIn API

既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。

Reddit API

既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。

Pinterest API

公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。

Threads API

公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。

Bluesky API

公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。