curl "https://api.trygroundai.com/packages/search?query=Router&package_name=express&ecosystem=npm&top_k=10" \
  -H "Authorization: Bearer gnd_your_api_key"

curl -X POST https://api.trygroundai.com/packages/search \
  -H "Authorization: Bearer gnd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Router",
    "package_name": "express",
    "ecosystem": "npm",
    "top_k": 10
  }'

Package search API

Search the source code of a public npm or PyPI package on demand. Results include file paths and line ranges. Responses are cached for a period; repeated queries may be faster. Authentication and search quota apply (same family as /search).

Endpoints

GET /packages/search
POST /packages/search

Parameters

string

required

Search string (1–500 characters)

string

required

Package name (e.g. express, requests)

string

required

npm or pypi

string

Optional exact version

integer

default:"10"

Max results (1–50)

curl "https://api.trygroundai.com/packages/search?query=Router&package_name=express&ecosystem=npm&top_k=10" \
  -H "Authorization: Bearer gnd_your_api_key"

curl -X POST https://api.trygroundai.com/packages/search \
  -H "Authorization: Bearer gnd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Router",
    "package_name": "express",
    "ecosystem": "npm",
    "top_k": 10
  }'

Error codes (common)

Code	Meaning
`404`	Package/version not found
`502`	Registry unavailable
`413`	Package too large to process
`504`	Fetch timeout

​Package search API

​Endpoints

​Parameters

​Error codes (common)

Package search API

Endpoints

Parameters

Error codes (common)