Niches & credits

Two free helper endpoints: the niche taxonomy for filtering creators, and your current credit balance. Neither costs a credit.

List niches

GET /api/v1/niches

Returns the valid niche categories and their filter values, for use as niche_category in creator search. Free.

curl -H "Authorization: Bearer ifsk_your_key" \
  "https://platform.influesque.com/api/v1/niches"

{
  "niches": [
    { "label": "Gaming", "value": "gaming" },
    { "label": "Adventure & Travel", "value": "adventure_travel" }
  ]
}

Use the value (not the label) when filtering creator search.

GET /api/v1/credits

Returns your current credit balance and plan. Free.

curl -H "Authorization: Bearer ifsk_your_key" \
  "https://platform.influesque.com/api/v1/credits"

{ "plan": "user", "unlimited": false, "balance": 812, "allowance": 1000, "renewsAt": "2026-08-01T00:00:00Z" }

Field	Type	Description
`plan`	string	Your plan (e.g. `user`, `free_trial`).
`unlimited`	boolean	True for internal accounts with no metering.
`balance`	integer or null	Credits remaining this period. `null` when unlimited.
`allowance`	integer	Credits granted per period.
`renewsAt`	string	When the allowance next resets (ISO 8601).