Search Foundation Models

Rerank

Rerank documents by relevance to a query.

World-class reranker for maximizing search relevancy and RAG accuracy.

post/v1/rerank

Request body

Example request

{
  "documents": [
    "Climate Change and Renewable Energy: A Global Perspective. Rising temperatures and extreme weather events are accelerating the transition to solar and wind power worldwide.",
    "Le changement climatique et l'énergie renouvelable : une perspective européenne. L'Union européenne investit massivement dans les technologies vertes pour atteindre la neutralité carbone d'ici 2050.",
    "Klimawandel und erneuerbare Energien: Deutsche Energiewende. Deutschland führt die Transformation des Energiesektors durch innovative Technologien und politische Maßnahmen an.",
    "气候变化对可再生能源的影响：中国的绿色发展战略。中国正在大力推进太阳能和风能项目，以实现碳中和目标。",
    "Artificial Intelligence in Healthcare: Revolutionizing Medical Diagnosis. AI-powered systems are improving accuracy in disease detection and treatment recommendations.",
    "Blockchain Technology: Transforming Financial Services. Decentralized finance applications are reshaping traditional banking and payment systems."
  ],
  "model": "jina-reranker-v2-base-multilingual",
  "query": "Climate change impact on renewable energy adoption",
  "return_documents": false,
  "top_n": 4
}

Response

Successful Response

modelstring required

The model used for reranking.

objectstring

Object type, always list.

Changes

Changed in 1 of the 4 revisions of this API.136

Jul 26, 2026beb179a156f3136See the full diff
- ▲
  request property oneOf[subschema #3: RerankerV3Request]/model was restricted to a list of enum values
  request-property-became-enum
- ●
  removed the request property oneOf[subschema #1: TextRerankerRequest]/truncation
  request-property-removed
- ●
  removed the request property oneOf[subschema #2: RerankerM0Request]/truncation
  request-property-removed
- ●
  removed the request property oneOf[subschema #3: RerankerV3Request]/truncation
  request-property-removed
- ○
  added jina-reranker-v3.5 mapping keys to the request discriminator
  request-body-discriminator-mapping-added
- ○
  the model request property const value jina-reranker-v3 was removed
  request-property-const-removed
- ○
  the max_doc_length request property default value 2048 was removed
  request-property-default-value-removed
- ○
  added the new jina-reranker-v3 enum value to the request property oneOf[subschema #3: RerankerV3Request]/model
  request-property-enum-value-added
- ○
  added the new jina-reranker-v3.5 enum value to the request property oneOf[subschema #3: RerankerV3Request]/model
  request-property-enum-value-added
- ○
  request property oneOf[subschema #3: RerankerV3Request]/max_doc_length list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened

Full history