Search Cross-Platform Events & Interactions

Universal endpoint for searching and filtering interaction data (events) across various social media platforms and news outlets.

Test in Playground Get API Key

01. Endpoint & Authentication

Target Endpoint

GET/api/v1/events/search

Authentication Header

Get API Key

Authorization: Bearer <API_KEY>

02. Request Parameters

Parameter	Type	Required	Description
keyword	string	Yes	Query parameter for keyword (Default: berita utama)
platform	string (tiktok \| instagram \| twitter \| facebook \| threads \| news)	No	Query parameter for platform (Default: tiktok)
event_type	string (post \| comment \| reply)	No	Query parameter for event_type (Default: post)
start_date	string	No	Query parameter for start_date (Default: 2026-03-01)
end_date	string	No	Query parameter for end_date (Default: 2026-03-06)
page	string	No	Query parameter for page (Default: 1)
size	string	No	Query parameter for size (Default: 10)

03. Response Fields

Field	Type	Nullable	Description
success	boolean	No	Indicates success.
status_code	integer	No	HTTP status code.
data	array / object	Yes	Extracted payload.

04. Pricing / Credits

1 credit per page (max 100 items). Failed requests cost 0 credits.

05. Error Codes

HTTP Status	Code	Description
400	INVALID_PARAMETERS	Bad request parameters.
403	INSUFFICIENT_CREDITS	Credit balance exhausted.

curl -X GET "https://api.socioapi.com/api/v1/events/search?keyword=berita%20utama&platform=tiktok&event_type=post&start_date=2026-03-01&end_date=2026-03-06&page=1&size=10" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json"

{
  "success": true,
  "status_code": 200,
  "message": "Success Retrieve Data..",
  "time": {
    "value": "15.845 ms",
    "setTimeBeforeActions": true
  },
  "meta_info": {
    "billing": {
      "plan_type": "CREDIT",
      "plan_name": "Starter",
      "remaining_credits": 9876,
      "credits_charged": 1
    },
    "log": {
      "ip": "114.124.211.178"
    }
  },
  "data": [
    {
      "id": "youtube_dq8xcefdatc",
      "platform": "youtube",
      "url": "https://api.socioapi.com/api/v1/events/search",
      "type": "post",
      "author": "creator_account",
      "text": "Sample real-time data extraction response from SocioAPI gateway.",
      "created_at": "2026-03-01T19:03:00+07:00",
      "views": 1250,
      "likes": 85,
      "comments": 12,
      "shares": 5,
      "sentiment": "positive",
      "data_collected_at": "2026-03-01T19:05:00+07:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total_items": 45,
    "total_pages": 5
  }
}