Get Narrative Details

Testing

GET

/narratives/{narrative_id_or_slug}

Retrieves detailed information and statistics for a specific narrative.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://public-api.protokols.io/api/v1/narratives/ai' \
--header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'

Response Example

200 - Example 1

{
    "data": {
        "narrative_id": "string",
        "name": "string",
        "slug": "string",
        "project_count": 0,
        "mindshare": {
            "mindshare_percent": 0,
            "change_24h": 0,
            "change_7d": 0,
            "change_30d": 0,
            "change_90d": 0
        },
        "total_views": 0,
        "total_posts": 0,
        "description": "string",
        "market_cap": {
            "total_market_cap_usd": 0,
            "change_24h": 0,
            "change_7d": 0,
            "change_30d": 0,
            "change_90d": 0
        }
    }
}

Request

Path Params

narrative_id_or_slug

string

required

The ID or slug of the narrative.

Example:

Header Params

authorization

string

optional

Default:

Bearer {{auth_token}}

Responses

🟢200Success

application/json

Successful retrieval of narrative details.

Body

data

object (Narrative Details)

optional

narrative_id

string

required

Unique identifier for the narrative.

name

string

required

Name of the narrative.

slug

string

required

URL-friendly slug for the narrative.

project_count

integer

required

Total number of projects associated with this narrative.

mindshare

object

required

Current mindshare score (e.g., based on social mentions, sentiment).

total_views

number

required

total_posts

number

required

description

string | null

optional

Detailed description of the narrative.

market_cap

object

optional

Percentage change in total market cap over the last 24 hours.

🟠404Record not found

🟠400Invalid input

Modified at 2025-07-10 10:37:00

List Narratives

List Projects in Narrative