[
{
"title": "Using the Effect Hook",
"content": "The Effect Hook lets you perform side effects...",
"source": "react.dev/reference/react/useEffect"
}
]
{
"results": [
{
"id": "/facebook/react",
"title": "React",
"description": "A JavaScript library for building user interfaces",
"totalSnippets": 1250,
"trustScore": 95,
"benchmarkScore": 88,
"versions": ["v18.2.0", "v17.0.2"]
}
]
}
IMPORTANT : The response is an object with a results array, NOT a plain array. Always access .results first (e.g., data["results"][0] in Python, .results[0] in jq).
Tips :
Use the id field from the response for the next step
Check versions array to see available versions
First result is usually the best match
2. Get Context
Retrieve documentation context for a specific library. Returns relevant documentation snippets based on your query.
Endpoint : GET https://context7.com/api/v2/context
Query Parameters :
query (required) - Your question or task (used for relevance ranking)
libraryId (required) - Library identifier from search (e.g., /facebook/react)
type (optional) - Response format: json (default) or txt
Example :
# Get React useEffect documentation (JSON format)
curl "https://context7.com/api/v2/context?libraryId=/facebook/react&query=useEffect" \
-H "Authorization: Bearer ${CONTEXT7_API_KEY}"
# Get documentation in text format (better for LLM prompts)
curl "https://context7.com/api/v2/context?libraryId=/facebook/react&query=useEffect&type=txt" \
-H "Authorization: Bearer ${CONTEXT7_API_KEY}"
# Unauthenticated (lower rate limits)
curl "https://context7.com/api/v2/context?libraryId=/facebook/react&query=useEffect&type=txt"
Response (JSON format) :
[
{
"title": "Using the Effect Hook",
"content": "The Effect Hook lets you perform side effects...",
"source": "react.dev/reference/react/useEffect"
}
]
Response (Text format) : Returns plain text ready for LLM prompts.
Tips :
Use type=txt for cleaner output that's easier to parse
Be specific with queries for better results
Pin to specific versions: /vercel/next.js/v15.1.8
Complete Workflow Example
# Step 1: Search for the library
LIBRARY_SEARCH=$(curl -s "https://context7.com/api/v2/libs/search?libraryName=react&query=state%20management" \
-H "Authorization: Bearer ${CONTEXT7_API_KEY}")
# Extract library ID (first result - response has a "results" array wrapper)
LIBRARY_ID=$(echo "$LIBRARY_SEARCH" | jq -r '.results[0].id')
echo "Found library: $LIBRARY_ID"
# Step 2: Get documentation context
DOCS=$(curl -s "https://context7.com/api/v2/context?libraryId=$LIBRARY_ID&query=How%20do%20I%20use%20useState&type=txt" \
-H "Authorization: Bearer ${CONTEXT7_API_KEY}")
echo "$DOCS"
