linkspect API docs linkspect.com

Prices and balance

Live checks are paid from a prepaid balance in US dollars. Checks with a test key are free. The prices and how to pay are on linkspect.com/pricing; this page shows how they appear in the API.

What a check costs

A check of one URL in one country costs that country's price: $0.04, or $0.03 in countries where our coverage is still growing (the list is on linkspect.com/pricing). The price is split evenly over the answers from the networks we check there by default (every main operator, home and mobile). Germany has 8, so each answer costs $0.005. A check that gets all of them costs the country's price exactly.

You pay only for answers about your site: the outcomes ok, blocked and target_down. These are free:

A check with fewer networks, for example one operator, pays only for its own answers. A check never costs more than its country's price. A check of several countries costs the sum of its countries.

Browser checks (Chrome and Edge) are free, up to 10 a day per paid account. The 11th of a UTC day gets 429 quota-exceeded with limit: "browser_checks_per_day".

Monitors pay for each of their checks in the same way, including the extra check that confirms a change and the checks made when a public block list adds or removes your site.

Before a check: the preview

POST /v1/checks:preview is free and shows the most a check can cost, with the price of each country:

curl https://api.linkspect.com/v1/checks:preview \
  -H "Authorization: Bearer $LINKSPECT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/", "targets": [{"country": "DE", "connection_type": "mobile"}]}'
{
  "cohorts": […],
  "max_credits": 3,
  "max_cost": "0.015",
  "prices": [
    {"country": "DE", "check_price": "0.04", "answer_price": "0.005", "answers": 3, "max_cost": "0.015"}
  ],
  "test": false
}

Amounts are decimal strings in US dollars, with up to six decimals ("0.005", "12.50"). Parse them as decimals, not floats.

When a check is accepted

The price is fixed when POST /v1/checks accepts the check: a later price change or the end of a discount does not change it. The most the check can cost is held from your balance while it runs. When the check is final, it is charged for its answers about your site, and the rest of the hold comes back.

What a check cost

Every check has cost, in GET /v1/checks/{id}, in GET /v1/checks and in the answer to POST /v1/checks. Monitors' checks have it too.

{
  "state": "charged",
  "currency": "USD",
  "held": "0.00",
  "charged": "0.04",
  "charged_answers": 8,
  "countries": [
    {"country": "DE", "charged_answers": 8, "charged": "0.04"},
    {"country": "PL", "charged_answers": 0, "charged": "0.00"}
  ]
}

Here Germany gave all 8 answers about the site and costs its price; in Poland no network gave an answer about the site (our measurements failed or were unclear), so Poland is free.

All amounts are "0.00" for a check that is not charged.

When the balance is used up

When your balance, less what running checks hold, is used up, POST /v1/checks answers 402 balance-exhausted and creates nothing. Nothing is charged beyond your balance: the last check may run on what is left and pays at most that. Test keys keep working.

{
  "type": "https://linkspect.com/problems/balance-exhausted",
  "title": "Balance used up",
  "status": 402,
  "detail": "The account's balance is used up: $0.00 left. Top up the balance to run more live checks. Test keys keep working.",
  "instance": "/v1/checks",
  "limit": "balance"
}

Monitors skip their checks too. Each monitor sends one monitor.quota_exceeded event a day with limit: "balance", and its checks start again after a top-up.

When the balance falls under $2, or under what a day of your monitors costs if that is more, you get one account.balance_low event on your webhooks and linked Telegram chats (see Monitors and webhooks). You get it again only after a top-up has brought the balance back above that mark.

{
  "id": "evt_01M7NB3K8Q2W6E9R4T7Y1U5I0O",
  "type": "account.balance_low",
  "created_at": "2026-11-20T09:14:02Z",
  "test": false,
  "balance": {"available": "1.98", "low_mark": "2.00", "currency": "USD"}
}

See your balance: GET /v1/usage

GET /v1/usage has the balance in billing (see Limits and usage):

{
  "enabled": true,
  "currency": "USD",
  "balance": "18.75",
  "reserved": "0.04",
  "available": "18.71",
  "discount": {"percent": 20, "ends_at": "2027-05-17T00:00:00Z"},
  "free_browser_checks_per_day": 10,
  "days": [
    {"date": "2026-11-16", "charged": "0.064", "charged_checks": 2},
    {"date": "2026-11-17", "charged": "0.00", "charged_checks": 0}
  ]
}

Paying

You top up with USDT on TRON; we credit the payment by hand. The minimum top-up is $10, and you pay the TRON network fee. Unused balance is refunded on request. For the payment address or a refund, reply to the email that brought you your key.