POST /v1/search
Search the web — interactive playground.
Cost: 0.5 credits per call. Errors are not charged. See Pricing.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.brime.dev/v1/search" \ -H "Content-Type: application/json" \ -d '{ "query": "BM25 ranking algorithm" }'{
"query": "string",
"answer": "string",
"results": [
{
"title": "string",
"url": "http://example.com",
"content": "string",
"score": 0,
"published_date": "string"
}
],
"request_id": "string",
"credits_used": 0,
"latency_ms": 0
}{
"error": {
"code": "invalid_request",
"message": "query is required"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid Brime API key."
}
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Wait 12 s and retry."
}
}{
"error": {
"code": "upstream_error",
"message": "SERP provider returned 503; retry shortly."
}
}See also: Search best practices · Errors