POST
/
search
curl --request POST \
  --url https://906e-2001-5a8-6cc-e000-55c0-f0b-9da7-10b0.ngrok-free.app/search \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "<string>",
  "mode": "auto",
  "depth": "basic",
  "topic": "general",
  "max_results": 10,
  "add_answer": true,
  "include_raw_content": false,
  "include_images": false,
  "recency": "day",
  "filters": {
    "include_domains": [
      "<string>"
    ],
    "exclude_domains": [
      "<string>"
    ],
    "include_text": [
      "<string>"
    ],
    "exclude_text": [
      "<string>"
    ]
  },
  "view": [
    "results"
  ],
  "similar_to": "<string>",
  "stream": true,
  "response_format": "json",
  "user_context": {}
}'
{
  "request_id": "<string>",
  "data": {
    "answer": "<string>",
    "results": [
      {
        "title": "<string>",
        "url": "<string>",
        "content": "<string>",
        "score": 0.5,
        "meta": {}
      }
    ],
    "images": [
      {
        "url": "<string>",
        "alt": "<string>"
      }
    ],
    "embeddings": [
      [
        123
      ]
    ]
  },
  "meta": {
    "api_version": "<string>",
    "processing_ms": 123,
    "tokens_used": 123,
    "cost": {
      "total": 1,
      "breakdown": {}
    }
  }
}

Search for information with various retrieval strategies.

Example Request

curl -X POST https://api.agentserp.com/search \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"query": "openai"}'

Body

application/json

Input contract for POST /search

Response

200
application/json

Search results

Universal response wrapper