Documentation | Client

generated_description: A longer and more detailed AI-generated description of the model
tags: An array of tags for the model
score: A score for the model's relevance to the search query

Example cURL request:

curl -s \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  "https://api.replicate.com/v1/search?query=nano+banana"

Note: This search API is currently in beta and may change in future versions.

Parameters

query:

SearchParams

query: string

The search query string

limit?: number

(maximum: 50, minimum: 1)

Maximum number of model results to return (1-50, defaults to 20)

Returns

SearchResponse{

collections: Array<

Collection

Array of collections that match the search query

models: Array<

Model

Array of models that match the search query, each containing model data and extra metadata

pages: Array<

Page

Array of Replicate documentation pages that match the search query

query: string

The search term that was evaluated

Request example

import Replicate from 'replicate';

const replicate = new Replicate();

const response = await replicate.search({ query: 'nano banana' });

console.log(response.collections);

200Example

{
  "collections": [
    {
      "description": "description",
      "name": "name",
      "slug": "slug",
      "models": [
        "string"
      ]
    }
  ],
  "models": [
    {
      "metadata": {
        "generated_description": "generated_description",
        "score": 0,
        "tags": [
          "string"
        ]
      },
      "model": {
        "cover_image_url": "https://example.com",
        "default_example": {},
        "description": "description",
        "github_url": "https://example.com",
        "is_official": true,
        "latest_version": {},
        "license_url": "https://example.com",
        "name": "name",
        "owner": "owner",
        "paper_url": "https://example.com",
        "run_count": 0,
        "url": "https://example.com",
        "visibility": "public"
      }
    }
  ],
  "pages": [
    {
      "href": "href",
      "name": "name"
    }
  ],
  "query": "query"
}