Get Profile Cashtags

Developing

GET

https://api.narrativ.tech/functions/v1/x/profile/cashtags

Retrieve all cashtags used by a specific X profile within a date range, ranked by activity.

Each cashtag includes total posts, impressions, and engagements during the period.
Use mode=top30 to get the top 30 hashtags by post count, or mode=all to return every cashtag used (paginated).

Perfect for content strategy, trend analysis, or competitor research.

Request

Authorization

Add parameter in header

api-key

Example:

api-key: ********************

Query Params

Responses

🟢200Success

application/json

Body

🟠400Wrong Params - Missing Identifier

🟠400Wrong Params - Start date after End Date

🟠400Wrong Params - End date before Start date

🟠400Wrong Params - Invalid mode

🟠400Wrong Params - Invalid Sort Field

🟠401Unauthorized - Invalid Key

🟠401Unauthorized - Missing Auth Token

🟠404Invalid Identifier

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.narrativ.tech/functions/v1/x/profile/cashtags?account_id&handle&start_date&end_date&mode&sort_by&asc' \
--header 'api-key: <api-key>'

Response Example

200 - Success - Channel Cashtags

{
    "totalCashtags": 20823121,
    "data": [
        {
            "cashtag": "abeo",
            "totalPosts": 56778473,
            "totalViews": 45725417,
            "totalEngagement": 76348474
        },
        {
            "cashtag": "cohaero",
            "totalPosts": 93621974,
            "totalViews": 55321105,
            "totalEngagement": 65326962
        },
        {
            "cashtag": "cum",
            "totalPosts": 42771974,
            "totalViews": 63036888,
            "totalEngagement": 54391113
        }
    ],
    "pagination": {}
}

Get Post Details

Get Profile Hashtags