langchain-ai · IdoXpoz · Jun 22, 2026
diff --git a/src/oss/python/integrations/providers/all_providers.mdx b/src/oss/python/integrations/providers/all_providers.mdx
@@ -1433,6 +1433,14 @@ Browse the complete collection of integrations available for Python. LangChain P
         xAI's Grok models for conversational AI.
     </Card>
 
+    <Card
+        title="Xpoz"
+        href="/oss/integrations/providers/xpoz"
+        icon="link"
+    >
+        Social media data platform with billions of indexed posts and users.
+    </Card>
+
     <Card
         title="YDB"
         href="/oss/integrations/providers/ydb"

diff --git a/src/oss/python/integrations/providers/xpoz.mdx b/src/oss/python/integrations/providers/xpoz.mdx
@@ -0,0 +1,70 @@
+---
+title: "Xpoz integrations"
+description: "Integrate with Xpoz using LangChain Python."
+---
+
+[Xpoz](https://xpoz.ai) is a social media intelligence platform that provides unified access to Twitter/X, Instagram, Reddit, and TikTok data through a single API. With billions of indexed posts and users, Xpoz enables brand monitoring, competitive intelligence, influencer discovery, and OSINT. No social media API keys required.
+
+The `langchain-xpoz` package exposes 32 tools across four social media platforms, plus tracking and account management.
+
+## Installation and setup
+
+Install the Xpoz integration package for LangChain Python:
+
+<CodeGroup>
+```bash pip
+pip install langchain-xpoz
+```
+
+```bash uv
+uv add langchain-xpoz
+```
+</CodeGroup>
+
+Get a free access key at [xpoz.ai/get-token](https://xpoz.ai/get-token) and set it as an environment variable:
+
+```bash
+export XPOZ_API_KEY="your-access-key"
+```
+
+## Tools
+
+### Twitter/X
+
+Search posts, look up users, get followers/following, and count mentions on Twitter/X.
+
+See a [usage example](/oss/integrations/tools/xpoz).
+
+```python
+from langchain_xpoz import XpozTwitterSearch, XpozTwitterUser, XpozTwitterUserPosts
+```
+
+### Instagram
+
+Search posts, look up users, get comments, and discover influencers on Instagram.
+
+See a [usage example](/oss/integrations/tools/xpoz).
+
+```python
+from langchain_xpoz import XpozInstagramSearch, XpozInstagramUser, XpozInstagramUserPosts
+```
+
+### Reddit
+
+Search posts and comments, look up users, and explore subreddits on Reddit.
+
+See a [usage example](/oss/integrations/tools/xpoz).
+
+```python
+from langchain_xpoz import XpozRedditSearch, XpozRedditUser, XpozRedditSubreddit
+```
+
+### TikTok
+
+Search videos by keywords or hashtags, look up creators, and get comments on TikTok.
+
+See a [usage example](/oss/integrations/tools/xpoz).
+
+```python
+from langchain_xpoz import XpozTiktokSearch, XpozTiktokUser, XpozTiktokPostsByHashtags
+```
diff --git a/src/oss/python/integrations/tools/index.mdx b/src/oss/python/integrations/tools/index.mdx
@@ -24,6 +24,7 @@ The following table shows tools that execute online searches in some shape or fo
 | [Perplexity Search](/oss/integrations/tools/perplexity_search) | Paid (with monthly free tier) | URL, Title, Snippet, Date, Last Updated |
 | [Tavily Search](/oss/integrations/tools/tavily_search) | 1000 free searches/month | URL, Content, Title, Images, Answer |
 | [Apify](/oss/integrations/tools/apify_actors) | Free tier, pay-per-use (varies by Actor) | Actor output (varies by Actor) |
+| [Xpoz](/oss/integrations/tools/xpoz) | Free tier available | Posts, user profiles, comments, engagement metrics (Twitter/X, Instagram, Reddit, TikTok) |
 | [You.com Search](/oss/integrations/tools/you) | $100 in credits on sign up | URL, Title, Page Content |
 
 ## Code interpreter
@@ -175,6 +176,7 @@ The following platforms provide access to multiple tools and services through a
 <Card title="ValyuContext" icon="link" href="/oss/integrations/tools/valyu_search" arrow="true" cta="View guide" />
 <Card title="Vectara" icon="link" href="/oss/integrations/tools/vectara" arrow="true" cta="View guide" />
 <Card title="WRITER Tools" icon="link" href="/oss/integrations/tools/writer" arrow="true" cta="View guide" />
+<Card title="Xpoz" icon="link" href="/oss/integrations/tools/xpoz" arrow="true" cta="View guide" />
 <Card title="You.com Search" icon="link" href="/oss/integrations/tools/you" arrow="true" cta="View guide" />
 </Columns>
 

diff --git a/src/oss/python/integrations/tools/xpoz.mdx b/src/oss/python/integrations/tools/xpoz.mdx
@@ -0,0 +1,214 @@
+---
+title: "Xpoz integration"
+description: "Integrate with the Xpoz social media tools using LangChain Python."
+---
+
+This guide provides a quick overview for getting started with the Xpoz [tools](/oss/langchain/tools). Xpoz provides unified access to Twitter/X, Instagram, Reddit, and TikTok data through a single API. No social media API keys required.
+
+## Overview
+
+### Integration details
+
+| Class | Package | Serializable | [JS support](https://js.langchain.com) | Version |
+| :--- | :--- | :---: | :---: | :---: |
+| [`XpozTwitterSearch`](https://github.com/XPOZpublic/langchain-xpoz) | [`langchain-xpoz`](https://pypi.org/project/langchain-xpoz/) | ❌ | ❌ | ![PyPI - Version](https://img.shields.io/pypi/v/langchain-xpoz?style=flat-square&label=%20) |
+
+### Tool features
+
+| [Returns artifact](/oss/langchain/tools) | Native async | Return data | Pricing |
+| :---: | :---: | :---: | :---: |
+| ❌ | ✅ | Social media posts, user profiles, comments, engagement metrics | Free tier available |
+
+## Setup
+
+To access the Xpoz tools, you need to create a free Xpoz account and install the `langchain-xpoz` integration package.
+
+### Credentials
+
+Get a free access key at [xpoz.ai/get-token](https://xpoz.ai/get-token).
+
+```python Set API key icon="key"
+import getpass
+import os
+
+if "XPOZ_API_KEY" not in os.environ:
+    os.environ["XPOZ_API_KEY"] = getpass.getpass("Enter your Xpoz access key: ")
+```
+
+It is also helpful (but not needed) to set up LangSmith for best-in-class observability/<Tooltip tip="Log each step of a model's execution to debug and improve it">tracing</Tooltip> of your tool calls. To enable automated tracing, set your [LangSmith](/langsmith/observability) API key:
+
+```python Enable tracing icon="flask"
+os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")
+os.environ["LANGSMITH_TRACING"] = "true"
+```
+
+### Installation
+
+The Xpoz tools live in the `langchain-xpoz` package:
+
+<CodeGroup>
+    ```python pip
+    pip install -U langchain-xpoz
+    ```
+    ```python uv
+    uv add langchain-xpoz
+    ```
+</CodeGroup>
+
+## Instantiation
+
+Xpoz provides 32 tools across four social media platforms. Here are the most commonly used:
+
+```python Initialize tools icon="robot"
+from langchain_xpoz import (
+    XpozTwitterSearch,
+    XpozTwitterUser,
+    XpozInstagramUser,
+    XpozRedditSearch,
+    XpozTiktokSearch,
+)
+
+twitter_search = XpozTwitterSearch()
+twitter_user = XpozTwitterUser()
+instagram_user = XpozInstagramUser()
+reddit_search = XpozRedditSearch()
+tiktok_search = XpozTiktokSearch()
+```
+
+## Invocation
+
+### [Invoke directly with args](/oss/langchain/tools)
+
+Search Twitter for posts about a topic:
+
+```python Call tool icon="rocket"
+twitter_search.invoke({
+    "query": "AI agents",
+    "max_results": 5,
+    "fields": ["text", "author_username", "like_count", "created_at"],
+})
+```
+
+Look up a user profile with specific fields:
+
+```python
+twitter_user.invoke({
+    "identifier": "elonmusk",
+    "fields": ["username", "name", "followers_count", "description"],
+})
+```
+
+### [Invoke with ToolCall](/oss/langchain/tools)
+
+You can also invoke the tool with a model-generated `ToolCall`, in which case a `ToolMessage` will be returned:
+
+```python ToolCall icon="briefcase"
+model_generated_tool_call = {
+    "args": {"identifier": "elonmusk", "fields": ["username", "followers_count"]},
+    "id": "1",
+    "name": "xpoz_twitter_user",
+    "type": "tool_call",
+}
+tool_msg = twitter_user.invoke(model_generated_tool_call)
+print(tool_msg.content)
+```
+
+### Use within an agent
+
+Use Xpoz tools with an agent for social media research. This requires a model with tool-calling capabilities.
+
+```python Agent with tools icon="robot"
+from langchain.agents import create_agent
+from langchain_xpoz import XpozTwitterSearch, XpozInstagramUser, XpozRedditSearch
+
+tools = [
+    XpozTwitterSearch(),
+    XpozInstagramUser(),
+    XpozRedditSearch(),
+]
+
+agent = create_agent(
+    model="claude-sonnet-4-6",
+    tools=tools,
+)
+
+stream = agent.stream_events({"messages": "What are people saying about LangChain on Twitter and Reddit?"}, version="v3")
+for snapshot in stream.values:
+    snapshot["messages"][-1].pretty_print()
+```
+
+## Available tools
+
+### Twitter/X
+
+| Tool | Description |
+|------|-------------|
+| `XpozTwitterSearch` | Search posts by keywords, hashtags, or phrases |
+| `XpozTwitterUser` | Get a user profile by username or ID |
+| `XpozTwitterUserPosts` | Get posts by a specific user |
+| `XpozTwitterPostComments` | Get replies to a specific tweet |
+| `XpozTwitterSearchUsers` | Search users by name |
+| `XpozTwitterUserConnections` | Get a user's followers or following list |
+| `XpozTwitterUsersByKeywords` | Find users who posted about specific topics |
+| `XpozTwitterCountPosts` | Count posts matching a phrase |
+
+### Instagram
+
+| Tool | Description |
+|------|-------------|
+| `XpozInstagramSearch` | Search posts by keywords |
+| `XpozInstagramUser` | Get a user profile by username or ID |
+| `XpozInstagramUserPosts` | Get posts by a specific user |
+| `XpozInstagramPostComments` | Get comments on a post |
+| `XpozInstagramSearchUsers` | Search users by name |
+| `XpozInstagramUsersByKeywords` | Find users who posted about specific topics |
+
+### Reddit
+
+| Tool | Description |
+|------|-------------|
+| `XpozRedditSearch` | Search posts by keywords, filter by subreddit |
+| `XpozRedditUser` | Get a user profile |
+| `XpozRedditPostWithComments` | Get a post with its comment thread |
+| `XpozRedditSearchComments` | Search comments by keywords |
+| `XpozRedditSearchSubreddits` | Search subreddits by name or topic |
+| `XpozRedditSubreddit` | Get subreddit info with recent posts |
+| `XpozRedditUsersByKeywords` | Find users who posted about specific topics |
+
+### TikTok
+
+| Tool | Description |
+|------|-------------|
+| `XpozTiktokSearch` | Search videos by keywords |
+| `XpozTiktokUser` | Get a creator profile |
+| `XpozTiktokUserPosts` | Get videos by a specific creator |
+| `XpozTiktokPostComments` | Get comments on a video |
+| `XpozTiktokSearchUsers` | Search creators by name |
+| `XpozTiktokPostsByHashtags` | Search videos by hashtags |
+| `XpozTiktokUsersByKeywords` | Find creators who posted about specific topics |
+
+### Tracking and account
+
+| Tool | Description |
+|------|-------------|
+| `XpozGetTrackedItems` | List all tracked keywords, users, hashtags |
+| `XpozAddTrackedItems` | Start tracking items across platforms |
+| `XpozRemoveTrackedItems` | Stop tracking items |
+| `XpozAccountDetails` | Get account plan, usage, and billing info |
+
+## Field selection
+
+All social media tools accept an optional `fields` parameter to select which fields are returned. Without it, only a default minimal set is returned.
+
+```python
+twitter_user.invoke({
+    "identifier": "nasa",
+    "fields": ["username", "name", "followers_count", "description", "verified"],
+})
+```
+
+Field names use `snake_case` (for example, `followers_count`, `like_count`, `author_username`).
+
+## API reference
+
+For the full list of tools and parameters, see the [langchain-xpoz source on GitHub](https://github.com/XPOZpublic/langchain-xpoz).