RoomScope

Last updated

Trends

Trending hashtags and sounds per region.

Every operation authenticates with an API key (Authorization: Bearer <key>) and errors use the shared envelope described in Errors. Generated from the API's OpenAPI document.

GET/v1/trends

Trending hashtags and sounds, by rank.

Scopetrend:readCreditsCached read

Query parameters

Query parameters of GET /v1/trends
NameTypeDescription
regionOptional
stringRegion code.
Default: US
typeOptional
"hashtag" | "sound"Only one kind of trend.

Request

curl "https://api.roomscope.io/v1/trends" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

Response

200 OK
{  "data": {    "region": "VN",    "trends": [      {        "trendType": "hashtag",        "trendId": "1690000000000000001",        "title": "#livestream",        "rank": 1,        "videoCount": 18400,        "viewCount": 92000000      },      {        "trendType": "sound",        "trendId": "7300000000000000002",        "title": "Original sound - linh.live",        "rank": 2,        "videoCount": 5100,        "viewCount": 31000000      }    ]  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_trends_discover",    "coverageStatus": "observed",    "methodologyVersion": "trends-v1"  }}

Errors

  • 400 Invalid parameter or body; code names the problem.
  • 401 Missing or unknown API key.
  • 402 The workspace's credit wallet cannot cover the call.
  • 403 The key lacks the scope, or the plan does not include the feature.
  • 429 Request rate exceeded; honour Retry-After.
Was this page helpful?