Jina

Jina Search Foundation API

Best-in-class embeddings, rerankers and document models for multilingual and multimodal search. Capabilities Text embeddings — dense vectors for semantic…

AI & machine learning#machine-learning

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Best-in-class embeddings, rerankers and document models for multilingual and multimodal search.

Capabilities

  • Text embeddings — dense vectors for semantic search, similarity, clustering and classification, in 100+ languages.
  • Multimodal embeddings — images, video, audio and PDFs embedded into the same space as text, so a query in one modality retrieves another.
  • Reranking — score a query against a candidate set and reorder it; more accurate than embedding similarity, and the usual second stage after it.
  • Document OCR — read a page image and return its content as text or markdown, with tables and layout preserved, over the OpenAI chat completions schema.
  • Batch embeddings — the same embedding models over JSONL, asynchronously, for workloads too large to send inline.

Authentication

Every endpoint except GET /v1/models requires a key:

Authorization: Bearer jina_YOUR_API_KEY

Get one at jina.ai/api-dashboard/key-manager.

Rate limits

Requests per minute and tokens per minute. Anything over a limit answers 429.

EndpointFreePaidPremium
/v1/embeddings500 RPM · 1M TPM500 RPM · 10M TPM5,000 RPM · 100M TPM
/v1/rerank500 RPM · 1M TPM500 RPM · 10M TPM5,000 RPM · 100M TPM
/v1/chat/completions100 RPM · 500K TPM100 RPM · 5M TPM1,000 RPM · 50M TPM

Errors

Failures carry a detail, a code from the table below and the request_id to quote in a support request. /v1/chat/completions is the exception: it answers in OpenAI's error envelope, with the same code inside it.

CodeStatusMeaning
INPUT_INVALID_LABELS400Invalid training labels
INPUT_LABEL_LIMIT_EXCEEDED400Label limit exceeded: labels provided, maximum allowed for your plan
INPUT_MODEL_NOT_FOUND400Model ' ' not found
INPUT_TOKEN_LIMIT_EXCEEDED400Input text exceeds the model's maximum of tokens
AUTH_INVALID_API_KEY401Invalid API key
AUTH_INVALID_FORMAT401Invalid authorization format
AUTH_MISSING_API_KEY401Authentication required
AUTHZ_INSUFFICIENT_BALANCE403Insufficient account balance
AUTHZ_RESOURCE_LIMIT_EXCEEDED403Resource limit exceeded for your plan
RESOURCE_NOT_FOUND404' ' not found or access denied
CONFLICT_RESOURCE_BUSY409' ' is currently being modified
RATE_CONCURRENCY_LIMIT_EXCEEDED429Concurrency limit exceeded: / concurrent requests
RATE_IP_LIMIT_EXCEEDED429IP rate limit exceeded
RATE_REQUEST_LIMIT_EXCEEDED429Request rate limit exceeded: / requests per minute
RATE_TOKEN_LIMIT_EXCEEDED429Token rate limit exceeded: / tokens per minute
INTERNAL_ERROR500An unexpected error occurred
SERVICE_UNAVAILABLE503Service temporarily unavailable
SERVICE_TIMEOUT504Service request timed out

Endpoints 11

Model List

  • GETList Models/v1/modelsEvery model in the catalogue, with its modalities, limits and price.
  • GETGet Model/v1/models/:model_idOne model by id, in full (jina-ai/jina-embeddings-v3) or short (jina-embeddings-v3) form.

Search Foundation Models

  • POSTEmbeddings/v1/embeddingsEmbed text, images, audio, video or PDFs as dense vectors. model selects the request shape as well as the model: each one below lists the inputs and options…
  • POSTRerank/v1/rerankScore documents against a query and return them reordered. Results come back sorted by relevance_score, each carrying the index it held in the request so the…

Generative Models

  • POSTChat Completions/v1/chat/completionsTranscribe a document image. Send the page as an image_url content part and the reply is its text; response_format with a json_schema constrains that to a…

Batch Embeddings

  • POSTCreate a batch embedding job/v1/batch/embeddingsSubmit a batch of texts for asynchronous embedding processing.
  • GETGet batch job status/v1/batch/:batch_idRetrieve the status of a batch embedding job.
  • DELETECancel a batch job/v1/batch/:batch_idCancel a pending or processing batch job.
  • GETList batch jobs/v1/batchesList recent batch jobs for the authenticated user.
  • GETDownload batch job output/v1/batch/:batch_id/outputStream the output JSONL file for a completed batch job.
  • GETDownload batch job error file/v1/batch/:batch_id/errorsStream the error JSONL file for a completed batch job.

API details

Base URL
https://api.jina.ai
Authentication
A bearer token in the Authorization header
Operations
11 operations on 10 pathsGET 6POST 4DELETE 1
Main resources
Batch Embeddings 6Model List 2Search Foundation Models 2Generative Models 1
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 2026.10.13.1624

How to test the Jina Search Foundation API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Jina Search Foundation API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List Models” (GET /v1/models), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Jina Search Foundation API?

Best-in-class embeddings, rerankers and document models for multilingual and multimodal search. Capabilities Text embeddings — dense vectors for semantic… It is listed under AI & machine learning and has 11 endpoints.

Who publishes the Jina Search Foundation API?

It is listed from Jina's public API description (an OpenAPI document), not published by Jina on Swastik Codes. Anyone who controls jina.ai can claim the profile by adding a DNS TXT record.

What is the base URL of the Jina Search Foundation API?

Requests go to https://api.jina.ai. Endpoint paths are added to this base URL.

How do I authenticate with the Jina Search Foundation API?

With A bearer token in the Authorization header.

How many endpoints does the Jina Search Foundation API have?

11 operations on 10 paths (6 GET, 4 POST, 1 DELETE). The largest groups are Batch Embeddings, Model List, Search Foundation Models, Generative Models.

Is forking the Jina Search Foundation API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.