langchain-xpoz

LangChain integration for Xpoz social media intelligence. Access Twitter/X, Instagram, Reddit, and TikTok data directly from your LangChain agents — no social media API keys required.

Installation

pip install langchain-xpoz

Quick Start

Get a free access key at xpoz.ai/get-token, then:

from langchain_xpoz import XpozTwitterSearch, XpozInstagramUser
from langchain.agents import create_openai_tools_agent, AgentExecutor
from langchain_openai import ChatOpenAI

tools = [
    XpozTwitterSearch(api_key="your-xpoz-key"),
    XpozInstagramUser(api_key="your-xpoz-key"),
]

llm = ChatOpenAI(model="gpt-4o")
agent = create_openai_tools_agent(llm=llm, tools=tools, prompt=prompt)
executor = AgentExecutor(agent=agent, tools=tools)

result = executor.invoke({
    "input": "What are people saying about AI agents on Twitter this week?"
})

You can also set the XPOZ_API_KEY environment variable instead of passing api_key.

Available Tools

Twitter/X

Instagram

Reddit

TikTok

Tracking & Account

Configuration

All tools accept api_key as a constructor parameter:

tool = XpozTwitterSearch(api_key="your-xpoz-key")

Or set the XPOZ_API_KEY environment variable.

Use Cases

• Brand Monitoring — track what people say about your brand across all platforms
• Competitive Intelligence — analyze competitors' social media presence and engagement
• Influencer Discovery — find relevant creators and opinion leaders by topic
• Market Research — understand public sentiment and trends from social conversations
• OSINT — gather open-source intelligence from public social media data

License

MIT