/api/v1/g/institution-lookup

10 credits

Resolve one institution by its normalized name — returns the school name, url, and stable inst_ id. Get the normalized_name from /api/v1/search/schools first.

Try in Playground

Parameters

Name	Type	Required	Description
normalized_name	string	yes	The institution's normalized name (lowercase, hyphenated). Discover it via /api/v1/search/schools. (e.g. `stanford-university`)

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/g/institution-lookup?normalized_name=stanford-university"

Example response

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "errors": null,
  "data": { "id": "inst_a8tl7ot52lsge", "name": "Stanford University", "normalized_name": "stanford-university", "url": "https://linkedin.com/school/stanford-university/" }
}

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 →