Skip to main content
The Best Practices skill is a reference guide that should be loaded for any Xpoz interaction. It covers authentication, query construction, response mode selection, field optimization, and common workflow patterns across all 48 Xpoz tools.

​
Query Syntax

Reference for building effective queries across all Xpoz search tools.
  • Simple keywords: artificial intelligence (matches posts containing both words)
  • Exact phrases: "machine learning" (matches the exact phrase)
  • AND operator: AI AND healthcare (both terms required)
  • OR operator: ChatGPT OR "Claude AI" (either term matches)
  • Grouping: ("generative AI" OR LLM) AND startup
  • Date filtering: Use startDate and endDate parameters in YYYY-MM-DD format

​
Response Modes

Every search tool supports a responseType parameter that controls how results are delivered.
ModeDescriptionBest For
fastReturns results immediately in a single responseQuick lookups, small datasets, interactive analysis
pagingReturns paginated results (100 per page) with cursor-based navigationMedium datasets, iterative analysis, when you need to process results page by page
csvExports results to S3 as a CSV file (up to 500K rows)Bulk exports, large datasets, data pipeline ingestion

​
Field Selection

Use the fields parameter to request only specific fields, reducing response size and improving performance. Rather than returning the full object with all available fields, specify exactly which fields you need. 
{
  "keywords": "artificial intelligence",
  "fields": ["id", "text", "authorUsername", "likeCount"],
  "responseType": "fast"
}

​
Continuous Tracking

Continuous tracking monitors keywords, users, subreddits, and hashtags on a regular schedule, resulting in better data coverage and fresher results. Track any brand, keyword, or user you query regularly to ensure more complete, up-to-date content. See the Social Tracking skill for setup details on adding and managing tracked items.

​
Common Workflow Patterns

Search, Analyze, Export

Search for posts using keyword queries, analyze results in-agent to identify patterns or insights, then export the full dataset to CSV for downstream processing.

Find Users, Get Posts, Analyze

Search for relevant users by keyword or criteria, fetch their recent posts, then perform engagement or content analysis across the collected data.

Track, Collect, Report

Set up tracking for keywords or users, let data accumulate over days or weeks, then run periodic analysis and reporting on the growing dataset.

​
Troubleshooting

IssueCauseSolution
No results returnedQuery too narrow or date range too restrictiveBroaden keywords, extend date range, try OR instead of AND
Slow responseLarge result set with responseType=“fast”Switch to “paging” mode or narrow the query
CSV export pendingExport still processingPoll checkOperationStatus with the operation ID until complete
Authentication errorInvalid or expired access keyRegenerate your key at xpoz.ai or re-authenticate via OAuth
Rate limit hitToo many requests per minuteAdd delays between requests, batch queries where possible

​
Platform Quick Reference

  • Twitter/X: 13 tools (users, posts, connections, comments)
  • Instagram: 9 tools (users, posts, comments, connections)
  • Reddit: 9 tools (users, posts, comments, subreddits)
  • TikTok: 9 tools (users, posts, comments, hashtags)
  • Operations: 2 tools
  • Account: 1 tool
  • Auth: 2 tools
  • Tracking: 3 tools
Total: 48 tools. See MCP Tools Overview for the full reference.