Skip to main content

Billing & Pricing

ListenX uses prepaid credits with custom pricing per account and per endpoint. There is no single public price list — your rates are configured by TagX for your account.

Core concepts​

  • Credits — your prepaid balance. Every billed request debits credits.
  • Endpoint — a billable operation (e.g. instagram.search, instagram.post, tiktok.search, tiktok.post, reddit.search, reddit.thread).
  • Unit — what one billed unit represents for that endpoint:
    • instagram.post / tiktok.post → billed per request (1 unit).
    • instagram.search / tiktok.search / reddit.search → billed per page fetched (1 unit = 1 page).
    • reddit.thread → billed per page fetched: the base thread is 1 page and each expansion of collapsed comments adds a page, so cost grows with comment pagination.
  • Unit price — credits per unit, set specifically for your account.

Your effective price is the custom price if TagX set one for your account, otherwise the endpoint's default price.

See your pricing​

curl "$LISTENX_BASE/v1/account/pricing" -H "X-API-Key: $LISTENX_KEY"
{
  "currency": "credits",
  "endpoints": [
    {"endpoint": "instagram.search", "unit": "page",    "unit_price": "0.002000", "enabled": true, "source": "default"},
    {"endpoint": "instagram.post",   "unit": "request", "unit_price": "0.020000", "enabled": true, "source": "custom"},
    {"endpoint": "tiktok.search",    "unit": "page",    "unit_price": "0.010000", "enabled": true, "source": "default"},
    {"endpoint": "tiktok.post",      "unit": "request", "unit_price": "0.010000", "enabled": true, "source": "default"},
    {"endpoint": "reddit.search",    "unit": "page",    "unit_price": "0.002000", "enabled": true, "source": "default"},
    {"endpoint": "reddit.thread",    "unit": "page",    "unit_price": "0.020000", "enabled": true, "source": "default"}
  ]
}

Every response is itemised​

Data endpoints return a billing object so you always know the exact cost:

{
  "...": "...",
  "billing": {
    "endpoint": "instagram.post",
    "units": 1,
    "unit_price": "0.020000",
    "amount": "0.020000",
    "balance_after": "97.340000",
    "request_id": "c7ca100750e449ff8c75e78ea9b0149c"
  }
}

Usage history​

curl "$LISTENX_BASE/v1/account/usage?limit=50" -H "X-API-Key: $LISTENX_KEY"

Each entry is an immutable ledger row: endpoint, units, unit price, amount, resulting balance, status, and request id.

Running out of credits​

If a request would exceed your balance (plus any agreed overdraft limit), it is rejected before any work is done:

{ "error": { "code": "insufficient_credit", "message": "Please top up your ListenX balance." } }

Contact TagX to top up, or ask about postpaid/overdraft terms.