Skip to main content

​
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

​
query
string
required
Search string (1–500 characters)
​
package_name
string
required
Package name (e.g. express, requests)
​
ecosystem
string
required
npm or pypi
​
version
string
Optional exact version
​
top_k
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"

​
Error codes (common)

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