Skip to main content

Pagination

Search pagination works differently from most APIs. You pay once when you create a search, then paginate through results for free.

How it works

POST /v1/search creates a . The limit parameter (1-100, default 25) sets the maximum number of results that session can ever return. You’re billed once at creation time: 25 base plus 2 per creator delivered. The response includes three pagination fields:
  • search_id - identifies the session for follow-up requests
  • has_more - whether additional results are available
  • next_cursor - pass this to fetch the next page
GET /v1/search/{search_id} fetches the next page using the cursor. This costs nothing — no additional credits are charged. Pagination does not unlock more results beyond the original limit. If you searched with limit: 10, the session exposes at most 10 results total across all pages.

Code example

import Influship from 'influship';

const client = new Influship();

// Create the search session (billed)
const first = await client.creators.search({
  query: 'travel content creators',
  limit: 20,
});

console.log(`Got ${first.data.length} results, has_more: ${first.has_more}`);

// Paginate through remaining results (free)
let cursor = first.next_cursor;
while (cursor) {
  const page = await client.creators.searchResults(first.search_id, {
    cursor,
  });
  console.log(`Got ${page.data.length} more results`);
  cursor = page.next_cursor;
}

Key things to understand

ConceptDetail
limit is a billing capIt controls the max results for the entire session, not the page size.
Page size is fixedResults are returned in chunks, typically 10 at a time.
has_more is the stop signalOnce it returns false, there are no more results to fetch.
Free pagination is rate-limitedFollow-up requests are free but still subject to light rate limiting to prevent abuse.

Implementation advice

Start with a small limit (5-10) while prototyping. Increase once you know how your UI consumes results. Larger limits cost more and results past the top 15-20 tend to be lower relevance.

Further reading

See Pricing for the full cost breakdown.