Social and Commerce Data

Submit social data

プラットフォームとアクションを指定して公開ソーシャル・コマースデータを取得します。サービスは近日公開で、デフォルトでは無効です。成功した結果は1回だけ課金され、失敗と結果0件は無料です。

POST/v1/data/social

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

platform必須

string

カタログにあるプラットフォームID（twitterやinstagramなど）。

action必須

string

そのプラットフォームが対応するアクション。利用可能な組み合わせはカタログを参照してください。

params

object

アクション固有の入力。カタログのrequired_paramsとoptional_paramsを使用してください。

mode

sync | async

任意。asyncを指定するとポーリングするジョブが返ります。非同期専用のアクションは省略してもジョブを返します。

syncasync

詳細ガイド →

POST /v1/data/social

1
2
3
4
curl https://api.bazaarlink.ai/v1/data/social \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"twitter","action":"search","params":{"keyword":"BazaarLink","limit":5}}'

レスポンス例

count、results、usage.cost（USD）を含む完了済みのdata.social結果。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "id": "req_example",
  "object": "data.social",
  "platform": "twitter",
  "action": "search",
  "count": 1,
  "results": [
    {
      "id": "post_example",
      "url": "https://x.com/someone/status/post_example",
      "text": "Example post",
      "like_count": 120,
      "reply_count": 8,
      "retweet_count": 14,
      "view_count": 5400,
      "posted_at": "2026-10-07T00:48:38+00:00",
      "author_username": "someone",
      "author_name": "Someone",
      "platform": "twitter"
    }
  ],
  "usage": {
    "cost": 0.0048
  }
}