Skip to main content
A call is charged for the work it did, counted in units. The price of each unit is on your account, and get_limits returns it.

The 7 units

What each call uses

A long scan is the most expensive call there is, because each of its pages uses 2 page units.

What costs nothing

  • A fetch that failed, was refused, or needs a person.
  • Every read of a stored record: the whole record, a section, the blocks, the links.
  • A highlight that is found word for word.
  • A comparison of 2 records.
  • The bytes of a page as served, which is the format raw_html.
  • A read of a stored search, the catalog of datasources, and get_limits.
  • A model step that failed or was cut by the time limit.
  • A request that is sent again with the same idempotency key.
One case is charged although no text comes back: a fetch of a web page with a baseline_fingerprint whose text is unchanged. The page has to be read in full to compare it, so the fetch is charged as a fetch.

Read what a call cost

Every charged response has cost. This one is cut to its units.
Part of a response
cost also has actual, the amount charged, and ceiling, the most the call could have cost. replayed is true on a response that was returned again for a repeated request, and such a response is not charged a second time. To limit what a call can cost before you send it, see Set a spending limit that no call can pass.