Documentation | Client › Search Models Collections And Docs Beta

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.

query Parameters

query: string

The search query string

limit: number

Optional

(maximum: 50, minimum: 1, default: 20)

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

Response fields

collections: Array<{ description, name, slug, 1 more... }>

Array of collections that match the search query

models: Array<{ metadata, model }>

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

pages: Array<{ href, name }>

Array of Replicate documentation pages that match the search query

query: string

The search term that was evaluated

Request example

curl https://api.replicate.com/v1/search \
    -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
    -d '{}'

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"
}