Search for libraries - Context7 MCP

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' \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://context7.com/api/v2/libs/search?libraryName=react&query=How%20to%20manage%20state%20with%20hooks&fast=true"
headers = {
    "Authorization": "Bearer <token>",
}

response = requests.request("GET", url, headers=headers)

print(response.text)

const response = await fetch('https://context7.com/api/v2/libs/search?libraryName=react&query=How%20to%20manage%20state%20with%20hooks&fast=true', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>'
  }
});

const data = await response.json();
console.log(data);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://context7.com/api/v2/libs/search?libraryName=react&query=How%20to%20manage%20state%20with%20hooks&fast=true',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer <token>',
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://context7.com/api/v2/libs/search?libraryName=react&query=How%20to%20manage%20state%20with%20hooks&fast=true"

	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://context7.com/api/v2/libs/search?libraryName=react&query=How%20to%20manage%20state%20with%20hooks&fast=true"))
    .header("Authorization", "Bearer <token>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

require 'uri'
require 'net/http'

url = URI('https://context7.com/api/v2/libs/search?libraryName=react&query=How%20to%20manage%20state%20with%20hooks&fast=true')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = url.scheme == 'https'

request = Net::HTTP::Get.new(url)
request['Authorization'] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

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
}

{
  "error": "validation_error",
  "message": "Library name is required"
}

{
  "error": "invalid_library_id",
  "message": "Invalid library ID format. Expected: `/owner/repo` for GitHub repositories, or `/<source>/<id>` for other sources (the URL path of the library on context7.com)"
}

{
  "error": "invalid_api_key",
  "message": "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix."
}

{
  "error": "spending_limit_exceeded",
  "message": "Monthly spending limit of $5.00 reached for this teamspace. An owner or admin can raise the limit at https://context7.com/dashboard/billing, or the cap will reset at the start of next month."
}

{
  "error": "library_not_found",
  "message": "Library \"/owner/repo\" not found. Please check the library ID or your access permissions."
}

{
  "error": "version_not_found",
  "message": "Version \"canary\" not found for library \"/owner/repo\". Available versions: v2.0.0, v1.5.0"
}

{
  "error": "no_snippets_found",
  "message": "Could not fetch documentation snippets from the library."
}

{
  "error": "no_relevant_snippets",
  "message": "No documentation in \"/owner/repo\" matched this query. Try a more specific query with different terms, or search for another library that covers this topic."
}

{
  "error": "team_not_found",
  "message": "Team not found or access denied"
}

{
  "error": "user_not_found",
  "message": "User not found"
}

{
  "error": "no_libraries_found",
  "message": "No libraries found for \"nonexistent-lib\". Try a different search term."
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please try again later."
}

{
  "error": "internal_error",
  "message": "An error occurred while processing your request"
}

{
  "error": "search_failed",
  "message": "Search failed: Service temporarily unavailable"
}

get/v2/libs/search

Authorization

Authorizationstringheaderrequired#

Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely. Every key can read the management API (/v2/teamspaces/*), except personal data: member and invitation emails, library requesters, visitor questions, Docs7 reader searches, conversations, feedback and feature requests, and the GitHub account behind a build. To read those or make changes there, the key must be created with Write access ticked; other keys get 403 write_access_required.

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_com). See Library ID format.

Example:"/vercel/next.js"

titlestring#

Display name of the library

Example:"Next.js"

descriptionstring#

Short description

Example:"The React Framework"

branchstring#

Git branch being tracked

Example:"canary"

lastUpdateDatestring#

ISO 8601 timestamp of last update

Example:"2025-01-15T10:30:00.000Z"

stateenum<string>#

Processing state of the library

Options:finalizedinitialprocessingerrordelete

Example:"finalized"

totalTokensinteger#

Total tokens in documentation

Example:607822

totalSnippetsinteger#

Number of code snippets

Example:3629

starsinteger#

GitHub stars count

Example:131745

trustScoreinteger#

Source reputation score (0-10)

Range: 0–10

Example:10

benchmarkScorenumber#

Quality indicator score (0-100)

Range: 0–100

Example:95.5

versionsstring[]#

Available version tags

Example:

["v15.1.8", "v14.3.0"]

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

API Guide Search documentation in one request