Protokols
  1. Narratives
Protokols
  • Protokols API
  • Authentication
  • Rate Limits
  • Track Profiles
    • Track KOL Profile
      GET
    • Track Project Profile
      GET
  • Twitter Profiles
    • Get Profile
      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 Project Organic Posts Chart
    • Get Project Organic Views Chart
    • Get Project Mentioned Contract Addresses
    • Get Project AI Summary
  • Profile Charts
    • Get Profile Follower Chart
    • Get Profile Notable Follower Chart
    • Get Profile Smart Engagement Chart
    • Get Profile Views Chart
  • Narratives
    • List Narratives
      GET
    • Get Narrative Details
      GET
    • List Projects in Narrative
      GET
    • Get Narrative Market Cap Chart
      GET
    • Get Narrative Mindshare Chart
      GET
  • Webhooks
    • Get Webhook URLs
    • Add Webhook URL
    • Track Profile
  1. Narratives

Get Narrative Mindshare Chart

Tested
GET
/narratives/{narrative_id_or_slug}/mindshare-chart
Retrieves time-series data for the mindshare percentage of a given narrative.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://public-api.protokols.io/api/v1/narratives/ai/mindshare-chart?timeframe=90d&granularity=daily' \
--header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'
Response Response Example
200 - Example 1
{
    "data": [
        {
            "date": 0,
            "value": 0
        }
    ]
}

Request

Path Params
narrative_id_or_slug
string 
required
Example:
ai
Query Params
timeframe
string 
optional
Timeframe for chart data. 7d, 30d or 90d. Defaults to 90d.
Example:
90d
granularity
string 
optional
Granularity of data points. Defaults to daily.
Example:
daily
Header Params
authorization
string 
optional
Default:
Bearer {{auth_token}}

Responses

🟢200Success
application/json
Successful retrieval of narrative mindshare chart.
Body
An array of [timestamp, value] pairs for narrative mindshare.
data
array[object (Chart Data) {2}] 
required
date
integer 
required
UNIX Timestamp
value
number 
required
🟠404Record not found
🟠400Invalid input
Modified at 2025-07-07 07:43:31
Previous
Get Narrative Market Cap Chart
Next
Get Webhook URLs
Built with