Skip to main content
Paginated tools support a responseType parameter that controls how results are delivered. The right mode depends on whether you need quick answers, full iteration, or bulk export.

​
The Three Modes

Returns the first page of results immediately without creating a server-side pagination table.
Behavior:
  • Returns up to 100 results in a single response
  • No tableName or pagination metadata is returned
  • Cannot fetch additional pages — this is a one-shot retrieval
Best for: Quick lookups where the first batch of results is sufficient. Most AI agent queries fall into this category.

​
Comparison

​
When to Use Each Mode

  • You need a quick answer and the first 100 results are enough
  • You are doing exploratory queries to understand the data
  • You want the lowest latency and token consumption
  • The agent is answering a simple question like “What are the latest posts by @username?”
  • You need to analyze a complete dataset (all posts matching a query)
  • You are building aggregations or statistics across all results
  • You need more than 100 results and want to iterate programmatically
  • The agent is doing deep analysis like “Analyze all posts mentioning AI in the last month”
  • You need to export data for use outside the AI agent
  • You are feeding data into a spreadsheet, BI tool, or data pipeline
  • You want a single downloadable file with all results
  • The agent is fulfilling a request like “Export all posts by @username to a file”
When no responseType is specified, the server defaults to fast. This is intentional — most agent interactions only need the first page of results, and fast mode avoids the overhead of creating a pagination table.

​
Tools That Support Response Modes

Response modes are available on all paginated tools:
  • Twitter: getTwitterPostsByAuthor, getTwitterPostsByKeywords, getTwitterPostRetweets, getTwitterPostQuotes, getTwitterPostComments, getTwitterPostInteractingUsers, getTwitterUserConnections, getTwitterUsersByKeywords
  • Instagram: getInstagramPostsByUser, getInstagramPostsByKeywords, getInstagramUserConnections, getInstagramPostInteractingUsers, getInstagramUsersByKeywords
  • Reddit: getRedditPostsByKeywords, getRedditCommentsByKeywords, getRedditUsersByKeywords
  • TikTok: getTiktokPostsByUser, getTiktokPostsByKeywords, getTiktokPostsByHashtags, getTiktokUsersByKeywords, getTiktokUsersByHashtags
  • Pagination — How to iterate through pages in paging mode
  • Field Selection — Reduce response size by selecting specific fields