GET Chat

Search event history with query parameters

Create rooms, publish messages, subscribe users, and read live activity.

GET /api/v3/{appid}/chat/searchevents

Create rooms, publish messages, subscribe users, and read live activity.

Request

Parameters

Values in the path and query string.

appid path

string TalkLabs ID required

The TalkLabs application ID assigned to your account.

Example: your-app-id

FromUserId query

string customer-defined

If specified, filters the search to only include messages where the user posting the event has this userid as an exact match

FromHandle query

string

If specified, filters the search to only include messages where the user posting the event has this handle as an exact match

Types query

ChatEventTypes[]

Example: 1

RoomId query

string TalkLabs ID

If specified, filters the search to only include events from the specified room

Example: room-id

Body query

string

If specified, performs a substring match case insensitive of the body

Limit query

integer · int32

The maximum number of records to return.

Example: 1

Cursor query

string

The cursor returned by the previous page.

Direction query

integer · int32

Example: [object Object]

Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult

400 Bad Request ApiResult

403 Forbidden ApiResult

404 Not Found ApiResult

500 Internal Server Error ApiResult

curl --request GET \
  --url "https://api.sportstalk247.com/api/v3/${APP_ID}/chat/searchevents?Types=1&RoomId=room-id&Limit=1&Direction=%5Bobject%20Object%5D" \
  --header "Accept: application/json" \
  --header "x-api-token: ${TALKLABS_API_TOKEN}"

const appId = process.env.TALKLABS_APP_ID;


const response = await fetch(
  `https://api.sportstalk247.com/api/v3/${appId}/chat/searchevents?Types=1&RoomId=room-id&Limit=1&Direction=%5Bobject%20Object%5D`,
{
  method: 'GET',
  headers: {
    Accept: 'application/json',
    'x-api-token': process.env.TALKLABS_API_TOKEN,
  },
});

const result = await response.json();

import json
import os
import requests

app_id = os.environ["TALKLABS_APP_ID"]


response = requests.get(
    f"https://api.sportstalk247.com/api/v3/{app_id}/chat/searchevents?Types=1&RoomId=room-id&Limit=1&Direction=%5Bobject%20Object%5D",
    headers={
        "Accept": "application/json",
        "x-api-token": os.environ["TALKLABS_API_TOKEN"],
    },
)
response.raise_for_status()
result = response.json()

Environment variables TALKLABS_APP_ID TALKLABS_API_TOKEN

Response