search_topics
Search for topics by name, filter by user following, and sort by followers, name, or date. Use pagination to navigate results efficiently. Ideal for exploring and organizing topic lists systematically.
Instructions
Search for topics by name or filter by user following, with optional sorting and pagination.
Parameters:
- query (str, optional): Search term to find topics by name.
- followed_by_user_id (str, optional): Only topics followed by this user ID.
- order (str, optional): Sorting order. Valid values: FOLLOWERS_COUNT (default), NAME, NEWEST.
- count (int, optional): Number of topics to return (default: 10, max: 20).
- after (str, optional): Pagination cursor for next page.
Returns:
- success (bool)
- data (dict): If successful, contains:
- topics (list): List of topic objects (id, name, etc.)
- pagination (dict): { end_cursor, has_next_page }
- error (dict, optional)
- rate_limits (dict)
Notes:
- If no topics match, `topics` will be an empty list.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | ||
| count | No | ||
| followed_by_user_id | No | ||
| order | No | FOLLOWERS_COUNT | |
| query | No |
Input Schema (JSON Schema)
{
"properties": {
"after": {
"default": null,
"title": "After",
"type": "string"
},
"count": {
"default": 10,
"title": "Count",
"type": "integer"
},
"followed_by_user_id": {
"default": null,
"title": "Followed By User Id",
"type": "string"
},
"order": {
"default": "FOLLOWERS_COUNT",
"title": "Order",
"type": "string"
},
"query": {
"default": null,
"title": "Query",
"type": "string"
}
},
"title": "search_topicsArguments",
"type": "object"
}