Skip to main content
GET
/
v2
/
libs
/
search
Search for libraries
curl --request GET \
  --url https://context7.com/api/v2/libs/search \
  --header 'Authorization: Bearer <token>'
{
  "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
}

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

​
libraryName
string
required

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

Required string length: 1 - 500
​
query
string
required

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

Required string length: 1 - 500

Response

Search results ranked by relevance

Search results response

​
results
object[]
required

Array of matching libraries ranked by relevance

​
searchFilterApplied
boolean
required

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).