A free, public, read-only JSON API for the Employer Visibility Index — a monthly benchmark of how visible companies are as employers in AI assistants' answers (ChatGPT, Gemini, Perplexity). Built so AI assistants and developers can retrieve rankings directly, without scraping HTML.
| Base URL | https://employers.perceptionx.ai/api |
|---|---|
| Versioning | Current version: v1. /api/v1/... and /api/... are equivalent; pin /api/v1 for forward compatibility. Breaking changes will ship under a new version prefix. |
| Authentication | None. All endpoints are public. |
| Methods | GET only (the API is read-only). |
| Format | JSON, UTF-8. CORS is enabled (Access-Control-Allow-Origin: *). |
| Rate limit | 60 requests / minute / IP. Responses are CDN-cached for 30–60 minutes; 429 with Retry-After when exceeded. |
| Data freshness | Rankings refresh monthly; profile data is regenerated continuously. Every response carries a lastUpdated date (when the underlying rankings were last rebuilt) and a month dataset version (YYYY-MM). |
| Attribution | Please credit "PerceptionX Employer Visibility Index" and link to employers.perceptionx.ai. |
Machine-readable overview for LLMs: /llms.txt. The API index at /api also returns the list of valid industries, countries, and months.
/api/v1)The dataset as a first-class entity: identity, apiVersion, datasetVersion (YYYY-MM), lastUpdated, a links object of ready-to-call example URLs, the methodology block, and a dataset summary (valid industries, countries, months, total companies).
{
"name": "PerceptionX Employer Visibility Index API",
"apiVersion": "v1",
"datasetVersion": "2026-07",
"lastUpdated": "2026-07-11",
"description": "Public, read-only API for AI employer visibility rankings...",
"links": {
"self": "https://employers.perceptionx.ai/api/v1",
"health": "https://employers.perceptionx.ai/api/v1/health",
"search": "https://employers.perceptionx.ai/api/v1/search?q=microsoft",
"company": "https://employers.perceptionx.ai/api/v1/company/microsoft",
"rankings": "https://employers.perceptionx.ai/api/v1/rankings?industry=Technology&limit=10",
"leaders": "https://employers.perceptionx.ai/api/v1/rankings/technology/us",
"compare": "https://employers.perceptionx.ai/api/v1/compare?companies=microsoft,google"
},
"methodology": { "version": "1.0", "url": ".../api-docs#methodology", "models": ["ChatGPT", "Google Gemini", "Perplexity"] },
"dataset": { "totalCompanies": 3158, "industries": ["Aerospace", "..."], "countries": ["..."], "months": ["..."] }
}Lightweight liveness + freshness check for monitoring and integrations.
curl "https://employers.perceptionx.ai/api/v1/health"{
"status": "ok",
"apiVersion": "v1",
"datasetVersion": "2026-07",
"lastUpdated": "2026-07-11",
"companies": 3158,
"industries": 32
}Find a company by (approximate) name and get its latest ranking.
| Param | Required | Description |
|---|---|---|
q | yes | Company name to search for, e.g. microsoft. Matches canonical names, subsidiaries, and known variants. |
country | no | Country code or name (us, gb, fr, de, br, cn, in). Default: best match, preferring the United States. |
limit | no | Max results, 1–20 (default 5). |
curl "https://employers.perceptionx.ai/api/search?q=microsoft"{
"query": "microsoft",
"results": [
{
"company": "Microsoft",
"slug": "microsoft",
"website": "microsoft.com",
"industry": "Artificial Intelligence",
"industries": ["Artificial Intelligence", "Technology", "..."],
"country": "United States",
"latestRanking": {
"rank": 28,
"industryRank": 4,
"totalCompaniesInIndustry": 34,
"visibilityScore": 83.3,
"month": "2026-07"
},
"profileUrl": "https://employers.perceptionx.ai/company/microsoft",
"apiUrl": "https://employers.perceptionx.ai/api/company/microsoft"
}
]
}rank is the company's overall rank among all tracked employers in the country (by its best industry score); industryRank is its rank within the shown industry.
Full company profile: score, ranks, per-theme rankings, monthly history, other industries, and a text summary. Slugs are lowercase-hyphenated company names (find them via /api/search).
| Param | Required | Description |
|---|---|---|
country | no | Country code/name. Defaults to the United States when the company has US data, otherwise its best market. |
curl "https://employers.perceptionx.ai/api/company/microsoft?country=us"{
"company": "Microsoft",
"slug": "microsoft",
"industry": "Artificial Intelligence",
"country": "United States",
"month": "2026-07",
"visibilityScore": 83.3,
"overallRank": 28,
"totalCompaniesInCountry": 944,
"industryRank": 4,
"totalCompaniesInIndustry": 34,
"modelScores": { "chatgpt": 84.6, "googleAi": 81.3, "perplexity": 100 },
"themes": {
"Career Opportunities": { "rank": 4, "score": 100 },
"Leadership": { "rank": 4, "score": 100 },
"Inclusion": { "rank": 3, "score": 100 }
},
"otherIndustries": [
{ "industry": "Technology", "industryRank": 2, "visibilityScore": 77.8 }
],
"history": [
{ "month": "2026-03", "rank": 8, "visibilityScore": 66.7 },
{ "month": "2026-04", "rank": 5, "visibilityScore": 60.4 }
],
"summary": "Microsoft is tracked across AI employer visibility rankings...",
"lastUpdated": "2026-07-11",
"profileUrl": "https://employers.perceptionx.ai/company/microsoft"
}Unknown slugs return HTTP 404 with {"error": "not_found", "message": "..."}.
Leaderboards. Without industry, returns the overall leaderboard (each company once, by its best industry score).
| Param | Required | Description |
|---|---|---|
industry | no | Industry name or slug, e.g. Technology or cloud-data-platform. Case-insensitive. Invalid values return the list of valid industries. |
country | no | Country code/name (default us). |
month | no | Historical period as YYYY-MM. Omit for the current index. |
limit | no | Results per page, 1–100 (default 25). |
page | no | Page number (default 1). |
sort | no | rank (default), mentions, name, or change — biggest rank improvers vs the previous period first ("who improved the most this month"). |
curl "https://employers.perceptionx.ai/api/rankings?industry=Technology&limit=10"{
"industry": "Technology",
"country": "United States",
"month": "2026-07",
"previousMonth": "2026-04",
"sort": "rank",
"page": 1,
"limit": 10,
"totalCompanies": 39,
"rankings": [
{
"rank": 1,
"company": "Google",
"slug": "google",
"industry": "Technology",
"visibilityScore": 77.8,
"mentionCount": 14,
"previousRank": 3,
"rankChange": 2,
"profileUrl": "https://employers.perceptionx.ai/company/google"
}
]
}rankChange is previousRank − rank (positive = moved up). It is null for companies without data in the previous period.
Compact "current leaders" shortcut — no query parameters needed. Same data as /api/rankings, simplified shape. Optional limit (default 10).
curl "https://employers.perceptionx.ai/api/rankings/technology/us"{
"industry": "Technology",
"country": "US",
"month": "2026-07",
"lastUpdated": "2026-07-11",
"totalCompanies": 39,
"topCompanies": [
{ "rank": 1, "company": "Google", "score": 77.8, "slug": "google" },
{ "rank": 2, "company": "Microsoft", "score": 77.8, "slug": "microsoft" }
]
}Side-by-side comparison of 2–5 companies — full profiles including theme scores and history for each.
| Param | Required | Description |
|---|---|---|
companies | yes | Comma-separated slugs, e.g. microsoft,google,nvidia. |
country | no | Country code/name applied to every company. |
curl "https://employers.perceptionx.ai/api/compare?companies=microsoft,google"{
"companies": [
{ "company": "Microsoft", "visibilityScore": 83.3, "industryRank": 4, "...": "..." },
{ "company": "Google", "visibilityScore": 88.9, "industryRank": 1, "...": "..." }
]
}| Status | Body |
|---|---|
400 | {"error": "bad_request", "message": "..."} — missing/invalid parameter. |
404 | {"error": "not_found", "message": "..."} — unknown company, industry, or month. Includes valid values where helpful. |
429 | {"error": "rate_limited", ...} with a Retry-After header. |
502 | {"error": "internal", ...} — transient upstream failure; retry. |
The Visibility Score (0–100) is the share of AI model × theme combinations within an industry and country where the company was mentioned in AI-generated answers to candidate-style questions. Ranks are computed per industry and country; ties break by mention count, then name. Source models: ChatGPT, Google Gemini, Perplexity. The index currently spans 32 industries and 7 countries.
Every data response embeds a methodology object so consumers can cite where a number came
from — its version, a url back to this section, and the source models:
"methodology": {
"version": "1.0",
"url": "https://employers.perceptionx.ai/api-docs#methodology",
"description": "Visibility Score (0-100) is the share of AI model × theme combinations...",
"models": ["ChatGPT", "Google Gemini", "Perplexity"]
}