SocialHz Engineering · 2 November 2026 · Requested by a customer
Empty search pages are free
GET /api/v1/search
What shipped
A search page that comes back with no posts no longer costs a credit. This applies to normal searches, multi-term searches and background searches.
Why
A trial customer paged a search to the end with next_cursor. The second-last page said has_more: true, the last page came back with 0 posts, and that page still cost a credit. They asked why.
What's charged now
- A page with posts: its page price (1 credit, or 5 on LinkedIn).
- A page the platform answered with no posts at all: nothing.
- A page whose posts all came back but were then removed by your filters, or as repeats of posts already shown: still charged, because the platform did return posts.
- A page that failed: nothing, as before. A search where nothing came back charges nothing at all.
Where you see it
credits.charged and the X-Credits-Charged header leave empty pages out, and filters.notes says how many there were. In the ledger, empty pages are refunded as their own row, labelled Search: empty pages (or Search: <term>: empty pages for a multi-term search). In a background search, each keyword's empty pages are given back when it ends, in credits.given_back.
Request a feature
Tell us what you need on the updates page. The engineering team reads every request.