Get documentation context

Retrieve intelligent, LLM-reranked documentation context for natural language queries. Returns the most relevant code snippets and documentation for your specific question.

GET /v2/context

Get documentation context

cURL

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

200

Example

{
  "codeSnippets": [
    {
      "codeTitle": "Middleware Authentication Example",
      "codeDescription": "Shows how to implement authentication checks in Next.js middleware",
      "codeLanguage": "typescript",
      "codeTokens": 150,
      "codeId": "https://github.com/vercel/next.js/blob/canary/docs/middleware.mdx#_snippet_0",
      "pageTitle": "Middleware",
      "codeList": [
        {
          "language": "typescript",
          "code": "import { NextResponse } from 'next/server'\nimport type { NextRequest } from 'next/server'\n\nexport function middleware(request: NextRequest) {\n  const token = request.cookies.get('token')\n  if (!token) {\n    return NextResponse.redirect(new URL('/login', request.url))\n  }\n  return NextResponse.next()\n}"
        }
      ]
    }
  ],
  "infoSnippets": [
    {
      "pageId": "https://github.com/vercel/next.js/blob/canary/docs/middleware.mdx",
      "breadcrumb": "Routing > Middleware",
      "content": "Middleware allows you to run code before a request is completed...",
      "contentTokens": 200
    }
  ]
}

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

libraryId · string · required

Context7-compatible library ID — the URL path of the library on context7.com. Use /owner/repo for GitHub repositories, or /<source>/<id> for other sources (websites, llms.txt, GitLab/Bitbucket, etc.). Optionally suffix with /<version> or @<version> to pin a specific version. See Library ID format.

Required string length: 1 - 500

Pattern: ^/[^/]+/[^/]+([/@][^/]+)?$

query · string · required

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

Required string length: 1 - 500

type · enum<string> · default: txt

Response format type

Available options: json, txt

fast · enum<string> · default: false

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

Available options: true, false

Response

200

application/json

Documentation context

Documentation context response

codeSnippets · object[] · required

Relevant code snippets

Show child attributes

infoSnippets · object[] · required

Relevant documentation snippets

Show child attributes

rules · object

Optional library-specific rules and guidelines

Show child attributes