Search for libraries

Search for libraries by name with intelligent LLM-powered ranking based on your query context.

1 min read

get/v2/libs/search

Request example

curl --request GET \
  --url https://context7.com/api/v2/libs/search?libraryName=react&query=How%20to%20manage%20state%20with%20hooks&fast=true

Response

{
  "results": [
    {
      "id": "/facebook/react",
      "title": "React",
      "description": "A JavaScript library for building user interfaces",
      "branch": "main",
      "lastUpdateDate": "2025-01-15T10:30:00.000Z",
      "state": "finalized",
      "totalTokens": 500000,
      "totalSnippets": 2500,
      "stars": 220000,
      "trustScore": 10,
      "benchmarkScore": 95.5,
      "versions": [
        "v18.2.0",
        "v17.0.2"
      ]
    }
  ],
  "searchFilterApplied": false
}

get/v2/libs/search

Query parameters

libraryNamestringrequired#

Library name to search for (e.g., 'react', 'nextjs', 'express')

Length: 1–500

querystringrequired#

User's original question or task - used for intelligent relevance ranking

Length: 1–500

fastenum<string>#

When true, skip LLM reranking and return top vector-search results directly. Trades relevance quality for lower latency.

Default: "false"

Options:truefalse

Responses

application/json

Search results ranked by relevance

resultsobject[]required#

Array of matching libraries ranked by relevance

Show child attributes

idstring#

Library ID — the URL path of the library on context7.com. /owner/repo for GitHub repositories, or /<source>/<id> for other sources (e.g., /vercel/next.js, /websites/uploadcare). See Library ID format.

titlestring#

Display name of the library

descriptionstring#

Short description

branchstring#

Git branch being tracked

lastUpdateDatestring#

ISO 8601 timestamp of last update

stateenum<string>#

Processing state of the library

Options:finalizedinitialprocessingerrordelete

totalTokensinteger#

Total tokens in documentation

totalSnippetsinteger#

Number of code snippets

starsinteger#

GitHub stars count

trustScoreinteger#

Source reputation score (0-10)

Range: 0–10

benchmarkScorenumber#

Quality indicator score (0-100)

Range: 0–100

versionsstring[]#

Available version tags

searchFilterAppliedbooleanrequired#

Indicates whether the search results were filtered by the teamspace's public library access settings. When true, some libraries may be excluded from results based on the teamspace's configuration (e.g., only verified libraries, selected libraries, or private repos only).

Context7Agent Get library usage metrics