# Brand and keyword mentions: an agent skill

> What are people saying about this brand or keyword on each platform? A free skill for your AI on 12 platforms: e.g. 3 calls, at most $0.024, one table back.

Canonical page: https://okdata.online/skills/mentions/

**What are people saying about this brand or keyword on each platform?** Searches one page of posts for a keyword on each platform you pick and lays them out as one table with a platform column: text, author, time and engagement.

## Tell your AI

```text
Install the okdata skill okdata-mentions from https://okdata.online/.well-known/agent-skills/okdata-mentions/SKILL.md into your skills folder.
```

- SKILL.md: https://okdata.online/.well-known/agent-skills/okdata-mentions/SKILL.md
- Download (.zip): https://okdata.online/skills/okdata-mentions.zip

## Example run

| Platform | Endpoint | Calls | At most |
|---|---|---|---|
| Douyin | [douyin.videos.search](https://okdata.online/apis/douyin/videos/search/) | 1 | $0.02 |
| Weibo | [weibo.posts.search](https://okdata.online/apis/weibo/posts/search/) | 1 | $0.002 |
| Bilibili | [bilibili.videos.search](https://okdata.online/apis/bilibili/videos/search/) | 1 | $0.002 |

Total: 3 calls, ≤ $0.024

## Ask it like this

- What are people on Douyin, Weibo and Bilibili saying about camping this week?
- Search X and Reddit for our brand name and show the posts with the most engagement.
- Find Xiaohongshu notes about sunscreen sprays, newest first.

## What it does

1. On each chosen platform, call its search endpoint with `query`, one page each unless asked for more.

## What you get back

Platform, Title or text, Author, Posted, Likes, Comments, Shares, Views, Link

## Inputs it needs

| Input | Needed | Meaning |
|---|---|---|
| `platforms` | yes | Platform ids, comma-separated, e.g. `douyin,weibo`. |
| `query` | yes | The brand or keyword, in the platform's language. |
| `pages` | no | Pages per platform, 1 to 3; 1 if not given. |

## Platforms and endpoints

- Douyin: [Douyin video search](https://okdata.online/apis/douyin/videos/search/) `douyin.videos.search`, $0.02 per call · about 20 videos per page
- Xiaohongshu (RedNote): [Xiaohongshu note search](https://okdata.online/apis/xiaohongshu/notes/search/) `xiaohongshu.notes.search`, $0.02 per call · about 20 notes per page
- Bilibili: [Bilibili video search](https://okdata.online/apis/bilibili/videos/search/) `bilibili.videos.search`, $0.002 per call · about 20 videos per page
- Weibo: [Weibo post search](https://okdata.online/apis/weibo/posts/search/) `weibo.posts.search`, $0.002 per call · about 10 posts per page
- TikTok: [TikTok video search](https://okdata.online/apis/tiktok/videos/search/) `tiktok.videos.search`, $0.002 per call · about 30 videos per page
- X (Twitter): [X post search](https://okdata.online/apis/x/posts/search/) `x.posts.search`, $0.002 per call · about 20 posts per page
- YouTube: [YouTube video search](https://okdata.online/apis/youtube/videos/search/) `youtube.videos.search`, $0.004 per call · about 20 videos per page
- Reddit: [Reddit post search](https://okdata.online/apis/reddit/posts/search/) `reddit.posts.search`, $0.004 per call · about 25 posts per page
- Kuaishou: [Kuaishou video search](https://okdata.online/apis/kuaishou/videos/search/) `kuaishou.videos.search`, $0.02 per call · about 10 videos per page
- Zhihu: [Zhihu search](https://okdata.online/apis/zhihu/posts/search/) `zhihu.posts.search`, $0.002 per call · about 20 posts per page
- WeChat Channels: [WeChat Channels video search](https://okdata.online/apis/wechat_channels/videos/search/) `wechat_channels.videos.search`, $0.02 per call · about 10 videos per page
- WeChat Search: [WeChat Search articles and videos](https://okdata.online/apis/wechat/posts/search/) `wechat.posts.search`, $0.02 per call · about 20 posts per page

The job it belongs to: [Content research API](https://okdata.online/solutions/content-research/)
