Skip to main content
POST
Rerank documents by relevance

Authorizations

Authorization
string
header
required

Gateway API key (imp-rt-...) from POST /v1/accounts or /v1/keys.

Body

application/json
model
string
required
Example:

"qwen/qwen3-reranker-8b"

query
string
required

Search query used to score each document.

Minimum string length: 1
documents
string[]
required
Required array length: 1 - 1000 elements
Minimum string length: 1
top_n
integer

Number of results, at most the document count; defaults to all documents.

Required range: x >= 1
return_documents
boolean
default:true

Include original document text in each result.

task
string

Optional description of the ranking task.

Minimum string length: 1

Response

Documents ordered by descending relevance score, with their original zero-based indices.

object
enum<string>
required
Available options:
list
model
string
required
Example:

"qwen/qwen3-reranker-8b"

data
object[]
required
usage
object
required