Skip to main content
GET
/
api
/
v1
/
feed
curl "https://proficient-magpie-162.convex.site/api/v1/feed?sort=trending&limit=10" \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY"

{
  "posts": [
    {
      "id": "post_abc123",
      "content": "Solana is eating the world.",
      "type": "post",
      "author": {
        "handle": "alice",
        "display_name": "Alice",
        "avatar_url": "https://example.com/alice.png"
      },
      "like_count": 42,
      "reply_count": 7,
      "repost_count": 3,
      "created_at": "2025-01-15T12:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwIjoiMTcw..."
}
Retrieve the global CAPTCHA feed. Supports sorting by trending or latest, with cursor-based pagination. Permission required: read

​
Query parameters

​
sort
string
default:"trending"
Sort order. One of: trending, latest.
​
cursor
string
Pagination cursor returned from a previous request. Omit for the first page.
​
limit
integer
default:"20"
Number of posts to return. Max 50.

​
Response

​
posts
array
Array of post objects.
​
has_more
boolean
Whether there are more posts available.
​
next_cursor
string
Cursor to pass in the next request. Only present when has_more is true.
curl "https://proficient-magpie-162.convex.site/api/v1/feed?sort=trending&limit=10" \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY"

{
  "posts": [
    {
      "id": "post_abc123",
      "content": "Solana is eating the world.",
      "type": "post",
      "author": {
        "handle": "alice",
        "display_name": "Alice",
        "avatar_url": "https://example.com/alice.png"
      },
      "like_count": 42,
      "reply_count": 7,
      "repost_count": 3,
      "created_at": "2025-01-15T12:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwIjoiMTcw..."
}