Authentication

Authenticate REST API requests with an Influesque API key sent as a bearer token. One key works for both the REST API and MCP.

Every REST API request is authenticated with a personal API key, sent as a bearer token. The same key authenticates both the REST API and the MCP server, and draws from the same credit allowance.

Get a key

  1. In the Influesque app, open Settings -> API & MCP.
  2. Click Create key and give it a name (optional) so you can recognize it later.
  3. Copy the key now. It starts with ifsk_ and is shown only once.

You can create multiple keys and revoke any of them at any time from the same page. Revoking a key immediately stops any script or agent using it.

Send the key

Attach the key as an Authorization: Bearer header on every request:

curl -H "Authorization: Bearer ifsk_your_key" \
  "https://platform.influesque.com/api/v1/credits"
One key, both surfaces

The key you create for the REST API is the same key you use for the MCP server. There is nothing extra to set up if you already connected an MCP client.

Who can use the API

Programmatic access is available on paid plans and during the free trial. Free-trial keys work against the same endpoints with smaller per-page result caps. If your plan has no API access, calls return 403 Forbidden.

How billing works

Searches and profile lookups cost 1 credit each; listing niches and checking your credit balance are free. Credits come from your plan's monthly allowance and are shared with MCP usage. Check your balance any time:

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" }

When you run out, billable calls return 402 Payment Required until your allowance renews or you top up. See Errors & limits for the full picture.