---
title: "search social mentions by keyword"
method: GET
path: "/v1/tool/search-mentions"
tags: ["Tool"]
---

# search social mentions by keyword

`GET /v1/tool/search-mentions`

Searches recent social mentions (Twitter/X) for a keyword to answer
"who is talking / what are they saying / what just happened".
Output should be a list of tweets with text, author, timestamp, permalink,
engagement metrics (if available), and optional language/region info.

## Query parameters

- `keyword` string, required

## Response `200`

OK

- PubtoolItemsResponseDomainTweet
  - `count` integer
  - `items` DomainTweet[]
    - `id` string
    - `media_json` string
    - `text` string
    - `user` DomainXUser
      - `blue_verified` boolean
      - `name` string
      - `profile_image` string
      - `screen_name` string
      - `user_id` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests

---

[API](https://skmtc.dev/chainbase/apis/data-cloud-task-api.md) · [All operations](https://skmtc.dev/chainbase/apis/data-cloud-task-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainbase/data-cloud-task-api/revisions/4013781aa422/schema)