1. Posts
Protokols
  • Protokols API
  • Authentication
  • Rate Limits
  • Track Profiles
    • Track KOL Profile
      GET
    • Track Project Profile
      GET
  • Twitter Profiles
    • Get Profile
      GET
    • Get Profile By IDs
      GET
    • Get Profile by Contract Address
      GET
    • Get Profile Statistics
      GET
    • Get Profile Smart Engagement Posts
      GET
    • Get Profile Notable Followers
      GET
    • Get Profile Username History
      GET
    • Get Profile Followers Paginated
      GET
    • Get Profile Following Paginated
      GET
    • Search Profiles
      GET
  • Posts
    • Get Posts By ID
      GET
    • Search Posts
      GET
    • Get Post Retweets
      GET
    • Get Posts Replies
      GET
  • KOLs
    • Get KOL Calls Overview
      GET
    • Get KOL Coin Narratives Distribution
      GET
    • Get KOL Calls Market Cap Distribution
      GET
    • Get KOL Token Mentions
      GET
    • Get KOL Project Interactions
      GET
  • Projects
    • Get Project Top Influencers
      GET
    • Get Project Organic Posts Chart
      GET
    • Get Project Organic Views Chart
      GET
    • Get Project Mentioned Contract Addresses
      GET
    • Get Project AI Summary
      GET
  • Profile Charts
    • Get Profile Follower Chart
    • Get Profile Notable Follower Chart
    • Get Profile Smart Engagement Chart
    • Get Profile Views Chart
  • Narratives
    • List Narratives
    • Get Narrative Details
    • List Projects in Narrative
    • Get Narrative Market Cap Chart
    • Get Narrative Mindshare Chart
  • Trending
    • Get Trending Projects By Views
    • Get Trending Projects By Smart Followers
    • Get Trending Projects By Smart Engagement
    • Get Trending KOLs By Views
    • Get Trending KOLs By Smart Followers
    • Get Trending KOLs By Smart Engagement
  • Leaderboards
    • List Leaderboards
    • Create Leaderboard
    • Get Leaderboard Details
    • Get Leaderboard Interactions
    • Update Leaderboard
    • Delete Leaderboard
    • Get Leaderboard Profiles
    • Modify Leaderboard Profiles
  • Schemas
    • Chart Data
    • KOL Calls Market Cap Distribution
    • KOL Calls Overwiew
    • KOL Coin Narratives Distribution
    • KOL Project Interactions
    • KOL Token Mention
    • Narrative
    • Narrative Details
    • Pagination Meta
    • Project AI Summary
    • Profile Stats
    • Profile Username History
    • Twitter Post
    • Twitter Post With Profile
    • Twitter Profile
    • Twitter Full Profile
    • Token
    • Trending Data
    • Leaderboard
    • LeaderboardInput
    • LeaderboardDetails
    • LeaderboardProfile
    • ProfileModificationResult
    • ProfileModificationInput
  1. Posts

Search Posts

Testing
GET
/posts/search-paginated
Search posts with user-friendly parameters including filtering options, date ranges, and pagination support.

Request

Query Params

Header Params

Responses

🟢200Success
application/json
Successful retrieval of searched posts with pagination.
Bodyapplication/json

🟠404Record not found
🟠400Invalid input
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://public-api.protokols.io/api/v1/posts/search-paginated?respondsTo=protokols_io' \
--header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'
Response Response Example
200 - Basic Search Example
{
    "pagination": {
        "page": 1,
        "limit": 20,
        "cursor": "eyJwYWdlIjoyLCJsaW1pdCI6MjB9"
    },
    "data": [
        {
            "id": "1734567890123456789",
            "content": "Bitcoin is revolutionizing the financial world! #BTC #crypto",
            "post_created_at": "2024-01-15T10:30:00.000Z",
            "created_by": "1234567890",
            "comment_count": 45,
            "like_count": 1250,
            "retweet_count": 340,
            "bookmark_count": 89,
            "view_count": 15600,
            "type": "tweet",
            "quoted_post_id": null,
            "reply_to_post_id": null,
            "coins": [
                "BTC"
            ],
            "mentions": [],
            "media": null,
            "retweeted_post_id": null,
            "links": [
                "https://bitcoin.org"
            ],
            "reply_to_user_id": null,
            "contract_addresses": [],
            "language": "en"
        }
    ]
}
Modified at 2025-07-07 07:35:42
Previous
Get Posts By ID
Next
Get Post Retweets
Built with