Get Profile Cashtags

GET

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

Retrieve the top 30 cashtags used by a specific X profile within a given date range, ranked by how frequently they appear.

For each cashtag, you’ll get total posts, impressions, and engagement over the selected period, making it ideal for content strategy, trend analysis, and competitor benchmarking.

Request

Authorization

Add parameter in header

api-key

Example:

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

Query Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠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 'https://api.narrativ.tech/functions/v1/x-profile-cashtags?account_id=undefined&handle=undefined&start_date=undefined&end_date=undefined&sort_by=undefined&asc=undefined' \
--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