Plug Searlo Into Your Stack

# pip install langchain httpx
from langchain.tools import tool
import httpx

@tool
def searlo_search(query: str) -> str:
    """Search the web using Searlo SERP API."""
    resp = httpx.get(
        "https://api.searlo.tech/v1/search/web",
        params={"q": query, "toon": "true"},
        headers={"X-API-Key": "your_key"},
    )
    return resp.json()["toon"]  # Token-optimized output

# Use in a LangChain agent
from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI

agent = initialize_agent(
    tools=[searlo_search],
    llm=ChatOpenAI(model="gpt-4o"),
    agent=AgentType.OPENAI_FUNCTIONS,
)
agent.invoke("What are the latest AI trends?")

# pip install crewai httpx
from crewai import Agent, Task, Crew
from crewai.tools import BaseTool
import httpx

class SearloSearchTool(BaseTool):
    name: str = "Web Search"
    description: str = "Search the web for current information"

    def _run(self, query: str) -> str:
        resp = httpx.get(
            "https://api.searlo.tech/v1/search/web",
            params={"q": query, "toon": "true"},
            headers={"X-API-Key": "your_key"},
        )
        return resp.json()["toon"]

researcher = Agent(
    role="Research Analyst",
    goal="Find accurate, current information",
    tools=[SearloSearchTool()],
)

# pip install llama-index httpx
from llama_index.core.tools import FunctionTool
import httpx

def web_search(query: str) -> str:
    """Search Google via Searlo for real-time web results."""
    resp = httpx.get(
        "https://api.searlo.tech/v1/search/web",
        params={"q": query, "num": 5},
        headers={"X-API-Key": "your_key"},
    )
    results = resp.json().get("organic", [])
    return "\n".join(
        f"- {r['title']}: {r['snippet']}" for r in results
    )

search_tool = FunctionTool.from_defaults(fn=web_search)

# Use in a LlamaIndex agent
from llama_index.agent.openai import OpenAIAgent
agent = OpenAIAgent.from_tools([search_tool])
agent.chat("Find recent news about RAG pipelines")

// n8n HTTP Request Node Configuration
{
  "method": "GET",
  "url": "https://api.searlo.tech/v1/search/web",
  "qs": {
    "q": "={{ $json.query }}",
    "num": 10,
    "gl": "us"
  },
  "headers": {
    "X-API-Key": "your_searlo_api_key"
  },
  "json": true
}

// Connect: Trigger → HTTP Request → Process Results
// Use expressions to pass dynamic queries from forms,
// webhooks, or previous nodes.

# pip install httpx
import httpx
from typing import Any

async def search(
    query: str,
    num: int = 10,
    country: str = "us",
    toon: bool = False,
) -> dict[str, Any]:
    """Search Google via Searlo SERP API."""
    async with httpx.AsyncClient() as client:
        resp = await client.get(
            "https://api.searlo.tech/v1/search/web",
            params={
                "q": query,
                "num": num,
                "gl": country,
                "toon": str(toon).lower(),
            },
            headers={"X-API-Key": "your_key"},
        )
        resp.raise_for_status()
        return resp.json()

# Usage
import asyncio
results = asyncio.run(search("best SERP API 2026", toon=True))
print(results["toon"])  # Token-optimized output

// Node.js 18+ with built-in fetch
const SEARLO_KEY = process.env.SEARLO_API_KEY;

async function search(query, options = {}) {
  const params = new URLSearchParams({
    q: query,
    num: options.num || 10,
    gl: options.country || "us",
    ...(options.toon && { toon: "true" }),
  });

  const res = await fetch(
    `https://api.searlo.tech/v1/search/web?${params}`,
    { headers: { "X-API-Key": SEARLO_KEY } }
  );

  if (!res.ok) throw new Error(`Searlo: ${res.status}`);
  return res.json();
}

// Express route example
app.get("/api/search", async (req, res) => {
  const data = await search(req.query.q, { toon: true });
  res.json(data);
});