News API
A search is charged by the effort you ask for:- A search is charged only when it succeeds (
200). A search that finds nothing is still charged. - A request that is refused or fails (
401,402,403,422,429,500,503) is never charged.
credits_per_search and story fields of
GET /subscription.
Agent
An events run is charged per run, by its mode, and per extra 50 rows past the first 50. Company research and company monitors are charged per company.
Failed runs are free. A run that finds nothing is still charged.
When your balance runs out
A News API request your balance does not cover gets402. A monitor whose
runs your balance no longer covers is paused with paused_reason: "out_of_credits": top up, then resume it.
