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

import requests

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

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

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'
});

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',
]);

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

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

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

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.

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

API Guide Search documentation in one request