GET

/api/v1/search/schools

10 credits

Search institutions by name (partial match). Page-paginated. Use to discover an institution's inst_ id or normalized_name.

Try in Playground

Parameters

Name	Type	Required	Description
name	string	yes	Institution name (min 3 chars). (e.g. `stanford`)
page	integer	no	Page number, >=1 (default 1).
limit	integer	no	Results per page, 1-50 (default 20).

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/search/schools?name=stanford"

Example response

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "errors": null,
  "data": [
    { "id": "inst_p51dq6klrdofk", "name": "Stanford University", "normalized_name": "stanford university", "url": "https://www.linkedin.com/school/stanford-university/" },
    { "id": "inst_e50venv5hsqbo", "name": "Stanford University Graduate School of Business", "normalized_name": "stanford university graduate school of business", "url": "https://www.linkedin.com/school/stanford-graduate-school-of-business/" }
  ],
  "pagination": { "page": 1, "limit": 2, "has_more": true }
}

Successful responses are wrapped in the standard envelope. The data field carries the actual payload; errors is null on success.

Want to try this endpoint?

300 free credits on signup, no card required. That covers 30 calls.

Get an API key →