1. Universal
Narrativ - Public Data API
  • Overview
  • YouTube
    • Get Channel Details
      GET
    • Get Followers Chart
      GET
    • Get Channels by Country
      GET
    • Get Social Volume
      GET
    • Get Video Details
      GET
  • Telegram
    • Get Channel Details
      GET
    • Get Social Volume
      GET
    • Get Post Details
      GET
  • X
    • Get Profile Details
      GET
    • Get Followers Chart
      GET
    • Get Social Volume
      GET
    • Get Post Details
      GET
    • Get Profile Cashtags
      GET
    • Get Profile Hashtags
      GET
    • Get Top Tweets
      GET
  • Universal
    • Account Content
      GET
    • Get Usage
      GET
  • Influencers
    • Get Influencer Categories
      GET
  1. Universal

Get Usage

GET
https://api.narrativ.tech/functions/v1/get-user-usage
Returns the authenticated user's current subscription plan and usage across all quota and rate-limit dimensions.

Request

Authorization
Add parameter in header
api-key
Example:
api-key: ********************

Responses

🟢200Success
application/json
Bodyapplication/json

🟠401Unauthorized - Missing Auth Token
🟠401Unauthorized - Invalid Key
🟠404No active subscription found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.narrativ.tech/functions/v1/get-user-usage' \
--header 'api-key: <api-key>'
Response Response Example
200 - Success
{
  "success": true,
  "plan": "Pro",
  "quota": {
    "daily": {
      "limit": 10000,
      "used": 4321,
      "remaining": 5679
    },
    "monthly": {
      "limit": 200000,
      "used": 87450,
      "remaining": 112550
    }
  },
  "rateLimit": {
    "limit": 60,
    "window": "15 m",
    "currentWindowUsed": 12,
    "remaining": 48,
    "windowResetsAt": 1747339200000
  }
}
Previous
Account Content
Next
Get Influencer Categories
Built with