Social and Commerce Data

Submit social data

Fetch public social or commerce data by platform and action. This service is coming soon and off by default. A successful result is charged once; failures and zero results are free.

POST/v1/data/social

Authorizations

Authorizationrequired

string · header

API key as bearer token in the Authorization header.

Body

platformrequired

string

Platform id from the catalog, such as twitter or instagram.

actionrequired

string

Action supported by that platform; see the catalog for the available pairs.

params

object

Action-specific inputs. Use required_params and optional_params in the catalog.

mode

sync | async

Optional. async returns a job to poll; async-only actions return a job even when omitted.

syncasync

Deep guide →

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}}'

Response examples

Completed data.social result with count, results, and usage.cost in USD.

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
  }
}