search_topics - SeeSaw Developer

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