Get code snippets for a library

Retrieves paginated code examples and API snippets from a library’s documentation. Supports filtering by topic and returns results in JSON or text format.

GET /v2/docs/code/{owner}/{repo}

Get code snippets for a library

cURL

curl --request GET \
  --url https://context7.com/api/v2/docs/code/{owner}/{repo} \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "snippets": [
    {
      "codeTitle": "Create and Run Next.js App with create-next-app (Quick Start)",
      "codeDescription": "Quickly set up and start a new Next.js application using `create-next-app` with various package managers. This command creates a new project directory, installs dependencies, and starts the development server. The `--yes` flag skips interactive prompts, enabling a default setup with TypeScript, Tailwind, ESLint, App Router, and Turbopack.",
      "codeLanguage": "bash",
      "codeTokens": 185,
      "codeId": "https://github.com/vercel/next.js/blob/canary/docs/01-app/01-getting-started/01-installation.mdx#_snippet_0",
      "pageTitle": "Installation",
      "codeList": [
        {
          "language": "bash",
          "code": "pnpm create next-app@latest my-app --yes\ncd my-app\npnpm dev"
        },
        {
          "language": "bash",
          "code": "npx create-next-app@latest my-app --yes\ncd my-app\nnpm run dev"
        },
        {
          "language": "bash",
          "code": "yarn create next-app@latest my-app --yes\ncd my-app\nyarn dev"
        },
        {
          "language": "bash",
          "code": "bun create next-app@latest my-app --yes\ncd my-app\nbun dev"
        }
      ]
    }
  ],
  "totalTokens": 185,
  "pagination": {
    "page": 1,
    "limit": 10,
    "totalPages": 10,
    "hasNext": true,
    "hasPrev": false
  },
  "metadata": {
    "authentication": "none"
  }
}

Authorizations

Authorization · string · header · required

Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely.

Path Parameters

owner · string · required

Repository owner - GitHub username or organization name (case-insensitive)

Required string length: 1 - 500

repo · string · required

Repository name (case-insensitive)

Required string length: 1 - 500

Query Parameters

topic · string

Filter snippets by topic or search term

Maximum string length: 500

type · enum<string> · default: txt

Response format type

Available options: json, txt

page · integer · default: 1

Page number for pagination (1-indexed). Maximum 10 pages accessible for each topic.

Required range: x >= 1

limit · integer · default: 10

Number of items per page

Required range: 1 <= x <= 10

Response

200

application/json

Successful response with code snippets

Response containing code snippets

snippets · object[] · required

Array of code snippets

Show child attributes

snippets. codeTitle · string · required

Title of the code snippet

snippets. codeDescription · string · required

Description of what the code does

snippets. codeLanguage · string · required

Primary programming language of the snippet

snippets. codeTokens · integer · required

Token count for the snippet

snippets. codeId · string · required

Unique identifier for the code snippet

snippets. pageTitle · string · required

Title of the documentation page containing this snippet

snippets. codeList · object[] · required

List of code examples in different languages

Show child attributes

snippets.codeList. language · string · required

Programming language of this code example

snippets.codeList. code · string · required

The actual code content

totalTokens · integer · required

Total token count for all returned snippets

pagination · object · required

Pagination metadata

Show child attributes

pagination. page · integer · required

Current page number (1-indexed)

Required range: x >= 1

pagination. limit · integer · required

Items per page

Required range: 1 <= x <= 10

pagination. totalPages · integer · required

Total number of pages available for a topic

Required range: x >= 0

pagination. hasNext · boolean · required

Whether a next page exists

pagination. hasPrev · boolean · required

Whether a previous page exists

metadata · object · required

Response metadata

Show child attributes

metadata. authentication · enum<string> · required

Authentication type used for this request

Available options: none, personal, team