Search for libraries

Search across available libraries. Returns finalized public libraries and accessible private repositories based on authentication.

GET /v2/search

Search for libraries

cURL

curl --request GET \
  --url https://context7.com/api/v2/search \
  --header 'Authorization: Bearer <token>'

200

withResults

{
  "results": [
    {
      "id": "/vercel/next.js",
      "title": "Next.js",
      "description": "Next.js enables you to create full-stack web applications by extending the latest React features and integrating powerful Rust-based JavaScript tooling for the fastest builds.",
      "branch": "canary",
      "lastUpdateDate": "2025-11-17T22:20:15.784Z",
      "state": "finalized",
      "totalTokens": 824953,
      "totalSnippets": 3336,
      "stars": 131745,
      "trustScore": 10,
      "benchmarkScore": 91.1,
      "versions": [
        "v14.3.0-canary.87",
        "v13.5.11",
        "v15.1.8",
        "v15.4.0-canary.82",
        "v12.3.7",
        "v11.1.3"
      ]
    }
  ],
  "metadata": {
    "authentication": "none"
  }
}

Authorizations

Authorization · string · header · required

Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely.

Query Parameters

query · string

Search query string. Returns empty results if not provided.

Maximum string length: 500

Response

200

application/json

Successful search response

Search results response

results · object[] · required

Array of matching libraries

Show child attributes

results. id · string

Library ID in format /owner/repo

Example:

"/vercel/next.js"

results. title · string

Display name of the library

Example:

"Next.js"

results. description · string

Short description

Example:

"The React Framework"

results. branch · string

Git branch being tracked

Example:

"canary"

results. lastUpdateDate · string<date-time>

ISO 8601 timestamp of last update

Example:

"2025-07-27T06:56:26.691Z"

results. state · enum<string>

Processing state of the library

Available options: finalized, initial, processing, error, delete

Example:

"finalized"

results. totalTokens · integer

Total tokens in documentation

Example:

607822

results. totalSnippets · integer

Number of code snippets

Example:

3629

results. stars · integer

GitHub stars count

Example:

131745

results. trustScore · integer

Source reputation score (0-10, used internally to determine High/Medium/Low/Unknown reputation)

Required range: 0 <= x <= 10

Example:

10

results. benchmarkScore · number

Quality indicator score (0-100, with 100 being the highest quality)

Required range: 0 <= x <= 100

Example:

95.5

results. versions · string[]

Available version tags

Example:

["v15.1.8", "v14.3.0-canary.87"]

metadata · object · required

Response metadata

Show child attributes

metadata. authentication · enum<string> · required

Authentication type used for this request

Available options: none, personal, team