LangChain AI ads integration.

Install

# Python
pip install surfacedd-langchain

# TypeScript
npm install @surfacedd/langchain

Import

# Python
from surfacedd_langchain import SurfaceddCallbackHandler

# TS
import { SurfaceddCallbackHandler } from "@surfacedd/langchain"

Initialize

handler = SurfaceddCallbackHandler(app_id='app_xxx')

Fetch a sponsored answer

result = chain.invoke({'input': user_query}, {'callbacks': [handler]})

Features

• Python and TypeScript parity
• Callback handler (works with any chain or agent)
• LangGraph node for advanced workflows
• Tool-call ads for agent action recommendations
• Streaming-safe: ads surface after final answer, not mid-tool-call

Install in three steps

1. Install. Python: pip install surfacedd-langchain. TypeScript: npm install @surfacedd/langchain.
2. Attach the callback handler. Instantiate SurfaceddCallbackHandler(app_id) and pass it via callbacks=[handler] on any chain.invoke() or agent.run() call.
3. Render in your UI. The handler emits on_sponsored_surface events. Consume them in your UI layer and render a clearly-labeled sponsored block.

Frequently asked questions

Related SDKs

• LlamaIndex SDK →
• Python SDK →
• Vercel AI SDK SDK →