API Reference
Search
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
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": {}
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.