Full-text search across SeeSaw topics. Use this when you have a keyword;
use list_topics when you want a ranking instead.
REST equivalent: GET /open/v1/search
Search has its own tighter budget — 30 requests/min on top of the general
limit. Browse with list_topics where you can.
Parameters
| Name | Type | Required | Default | Notes |
|---|
query | string | ✅ | — | Keyword(s) |
type | all | prediction | poll | | all | See pagination note below |
cursor | string | | — | Only honored with a single type |
limit | integer ≤ 100 | | 20 | Only honored with a single type |
With type=all the result is a fixed-size preview mixing both kinds:
cursor/limit are ignored, next_cursor is always null, and has_more
is always false. To paginate, request type=prediction or type=poll.
Returns
A topic list (same shape as list_topics). Captured live:
{
"data": [
{
"id": "48566076-03be-4aa4-8f12-b4f061221f96",
"type": "prediction",
"title": "Argentina wins the 2026 FIFA World Cup",
"status": "closed",
"creator": {
"id": "a9997b8e-5e97-4d28-8c9a-b8adb286ddd0",
"handle": "63941083",
"nickname": "Erica",
"avatar_url": "https://api.dicebear.com/7.x/avataaars/png?seed=seesaw04&size=200",
"account_type": "user",
"url": "https://seesaw.fun/profile/a9997b8e-5e97-4d28-8c9a-b8adb286ddd0"
},
"created_at": "2026-06-27T03:50:59Z",
"end_time": "2026-07-04T15:59:00Z",
"comments_count": 2,
"favorites_count": 104,
"url": "https://seesaw.fun/topic/48566076-03be-4aa4-8f12-b4f061221f96",
"options": [
{ "id": "c580f397-7344-47a2-8639-8d6b1c56b614", "name": "Yes", "probability": "0.5079", "is_winner": false },
{ "id": "7970f347-5b3f-4d9e-929f-0e5b78a3f498", "name": "No", "probability": "0.4921", "is_winner": false }
],
"total_volume": "168945.5017",
"traders_count": 168
}
],
"next_cursor": "bzoy",
"has_more": true
}
Example prompts
- “Search SeeSaw for World Cup predictions.”
- “Are there any markets about bitcoin hitting 100k?”
- “Find polls about AI.”
list_topics ·
get_topic ·
list_topic_comments