Quickstart - Xpoz

1. Get your access key

2. Choose your integration

Claude Code
TypeScript SDK
Python SDK
CLI

claude mcp add xpoz-mcp https://mcp.xpoz.ai/mcp \
  -t http \
  -H "Authorization: Bearer YOUR_API_KEY"

That’s it. Ask Claude to search social media:

Search Twitter for posts about "artificial intelligence" from the last week

npm install @xpoz/xpoz

import { XpozClient } from '@xpoz/xpoz';

const client = new XpozClient({ apiKey: 'YOUR_API_KEY' });

const user = await client.twitter.getUser({
  identifier: 'elonmusk',
  identifierType: 'username'
});

console.log(user.name, user.followersCount);

pip install xpoz

from xpoz import XpozClient

client = XpozClient(api_key="YOUR_API_KEY")

user = client.twitter.get_user(
    identifier="elonmusk",
    identifier_type="username"
)

print(user.name, user.followers_count)

# Install
brew install xpoz-ai/tap/xpoz-cli

# Authenticate
xpoz-cli auth login

# Search
xpoz-cli twitter get_user --identifier elonmusk

3. Try a search

Here are some queries to get you started:

Search Twitter posts by keyword

MCP
TypeScript
Python

Ask your AI agent:

Search Twitter for posts about "machine learning" from the last 30 days

const results = await client.twitter.searchPosts({
  query: 'machine learning',
  startDate: '2025-01-01',
  responseType: 'fast'
});

for (const post of results.data) {
  console.log(post.text, post.retweetCount);
}

results = client.twitter.search_posts(
    query="machine learning",
    start_date="2025-01-01",
    response_type="fast"
)

for post in results.data:
    print(post.text, post.retweet_count)

Get an Instagram user profile

TypeScript
Python

const user = await client.instagram.getUser({
  identifier: 'natgeo',
  identifierType: 'username'
});

console.log(user.fullName, user.followerCount);

user = client.instagram.get_user(
    identifier="natgeo",
    identifier_type="username"
)

print(user.full_name, user.follower_count)

Search Reddit posts

TypeScript
Python

const results = await client.reddit.searchPosts({
  query: 'python best practices',
  subreddit: 'learnpython',
  responseType: 'fast'
});

results = client.reddit.search_posts(
    query="python best practices",
    subreddit="learnpython",
    response_type="fast"
)

4. Set up continuous tracking

Xpoz can continuously monitor keywords, users, subreddits, and hashtags you care about. Continuous tracking gives you better data coverage and fresher results.

MCP
TypeScript
Python
CLI

Ask your AI agent:

Track the keyword "artificial intelligence" on Twitter and Reddit,
and track the user "openai" on Twitter

await client.tracking.addTrackedItems({
  items: [
    { phrase: "artificial intelligence", type: "keyword", platform: "twitter" },
    { phrase: "artificial intelligence", type: "keyword", platform: "reddit" },
    { phrase: "openai", type: "user", platform: "twitter" },
  ]
});

client.tracking.add_tracked_items(items=[
    {"phrase": "artificial intelligence", "type": "keyword", "platform": "twitter"},
    {"phrase": "artificial intelligence", "type": "keyword", "platform": "reddit"},
    {"phrase": "openai", "type": "user", "platform": "twitter"},
])

xpoz-cli tracking add_tracked_items \
  --items '[{"phrase":"artificial intelligence","type":"keyword","platform":"twitter"},{"phrase":"artificial intelligence","type":"keyword","platform":"reddit"}]'

You can track keywords and users on all platforms, subreddits on Reddit, and hashtags on TikTok. See the Tracking Guide for best practices and common workflows.

Next steps

Authentication

Learn about access keys, Google sign-in, and bearer tokens

MCP Tools

Browse all 48 available tools

Continuous Tracking

Best practices for continuous tracking

Query Syntax

Master search with boolean operators

​1. Get your access key

​2. Choose your integration

​3. Try a search

​4. Set up continuous tracking

​Next steps