Integration Guide

LangChain Integration Guide

Use KhaleejiAPI as a LangChain toolset for region-specific workflows across validation, finance, geolocation, and Arabic-first APIs.

1) Install dependencies

bash
pip install khaleejiapi-langchain langchain langchain-openai

2) Load KhaleejiAPI tools

get_all_tools returns StructuredTool definitions ready for agents.

python
from khaleejiapi_langchain import get_all_tools
 
API_KEY = "your_api_key_here"
tools = get_all_tools(api_key=API_KEY)
 
print(f"Loaded {len(tools)} KhaleejiAPI tools")

3) Minimal working agent example

This minimal flow shows a tool-calling agent that invokes KhaleejiAPI on demand.

python
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from khaleejiapi_langchain import get_all_tools
 
llm = ChatOpenAI(model="gpt-5-mini")
tools = get_all_tools(api_key="your_api_key_here")
agent = create_react_agent(llm, tools)
 
response = agent.invoke({
  "messages": [
    ("user", "Validate [email protected] and return deliverability score")
  ]
})
 
print(response["messages"][-1].content)

Configuration

bash
# Required for KhaleejiAPI tools
KHALEEJI_API_KEY=your_api_key_here
 
# Optional: override base URL (defaults to production)
KHALEEJI_BASE_URL=https://khaleejiapi.dev/api/v1