Get Profile Hashtags

GET

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

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

For each hashtag, 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-hashtags?account_id=undefined&handle=undefined&start_date=undefined&end_date=undefined&sort_by=undefined&asc=undefined' \
--header 'api-key: <api-key>'

Response Example

200 - Invalid Sort Field

{
    "totalHashtags": 3,
    "data": [
        {
            "hashtag": "iure",
            "totalPosts": 68463810,
            "totalViews": 81445835,
            "totalEngagement": 68701420
        },
        {
            "hashtag": "adiuvo",
            "totalPosts": 38476397,
            "totalViews": 18596373,
            "totalEngagement": 67406319
        },
        {
            "hashtag": "tergo",
            "totalPosts": 94588834,
            "totalViews": 36224639,
            "totalEngagement": 64068211
        }
    ],
    "pagination": {}
}

Get Profile Cashtags

Get Top Tweets