Skip to main content
POST
/
v1
/
tools
/
search
curl -X POST https://win.oneshotagent.com/v1/tools/search \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <your_x402_signature>" \
  -d '{
    "query": "best AI agent frameworks 2026",
    "max_results": 5
  }'
{
  "success": true,
  "data": {
    "query": "best AI agent frameworks 2026",
    "results": [
      {
        "url": "https://example.com/ai-frameworks",
        "title": "Top AI Agent Frameworks in 2026",
        "description": "A comprehensive comparison of the leading AI agent frameworks..."
      },
      {
        "url": "https://example.com/langchain-vs-crewai",
        "title": "LangChain vs CrewAI: Which Framework to Choose",
        "description": "An in-depth comparison of two popular agent frameworks..."
      }
    ],
    "result_count": 2
  }
}

Overview

Synchronous web search powered by Firecrawl. Returns results immediately — no polling needed.

Authentication

Requires x402 payment proof in the X-Payment-Proof header.

Request Body

query
string
required
Search query (1-500 characters)
max_results
integer
default:5
Maximum number of results to return (1-20)

Response (200)

data.query
string
The search query
data.results
array
Array of search results, each with url, title, and description
data.result_count
integer
Number of results returned
curl -X POST https://win.oneshotagent.com/v1/tools/search \
  -H "Content-Type: application/json" \
  -H "X-Payment-Proof: <your_x402_signature>" \
  -d '{
    "query": "best AI agent frameworks 2026",
    "max_results": 5
  }'
{
  "success": true,
  "data": {
    "query": "best AI agent frameworks 2026",
    "results": [
      {
        "url": "https://example.com/ai-frameworks",
        "title": "Top AI Agent Frameworks in 2026",
        "description": "A comprehensive comparison of the leading AI agent frameworks..."
      },
      {
        "url": "https://example.com/langchain-vs-crewai",
        "title": "LangChain vs CrewAI: Which Framework to Choose",
        "description": "An in-depth comparison of two popular agent frameworks..."
      }
    ],
    "result_count": 2
  }
}

Pricing

EnvironmentCost
Development$0.00
Staging$0.01
Production$0.02

Notes

  • Results are returned synchronously (no job polling)
  • Powered by Firecrawl search
  • 15-second timeout per request