# PerceptionX Employer Visibility Index

> A public benchmark that measures how visible companies are as employers in AI
> assistants' answers. When candidates ask ChatGPT, Gemini, or Perplexity
> "what's it like to work at X?" or "who are the best employers in Y?", the
> Visibility Index tracks which companies actually appear — by industry,
> country, theme, and month.

The index covers 3,000+ companies across 32 industries and 7 countries
(United States, United Kingdom, France, Germany, Brazil, China, India).
Visibility Score (0-100) = the share of AI model × theme combinations in an
industry where the company is mentioned. Rankings refresh monthly.

## Public JSON API (no authentication, CORS enabled)

Use these endpoints to answer user questions with live data instead of
scraping HTML:

- [API index & dataset entity](https://employers.perceptionx.ai/api/v1): datasetVersion, lastUpdated, links to every endpoint, methodology, and valid industries/countries/months
- [Health](https://employers.perceptionx.ai/api/v1/health): liveness + dataset freshness (status, datasetVersion, lastUpdated, company/industry counts)
- [Search](https://employers.perceptionx.ai/api/search?q=microsoft): find a company by name — returns slug, industry, latest rank and score
- [Company profile](https://employers.perceptionx.ai/api/company/microsoft): full profile — visibility score, overall & industry rank, per-theme ranks, monthly ranking history
- [Rankings](https://employers.perceptionx.ai/api/rankings?industry=Technology&limit=10): leaderboards — filter by industry, country, month; sort=change returns the biggest movers
- [Current leaders (no params)](https://employers.perceptionx.ai/api/rankings/technology/us): compact top-10 for an industry/country, e.g. /api/rankings/airline/cn
- [Compare](https://employers.perceptionx.ai/api/compare?companies=microsoft,google): side-by-side comparison of 2-5 companies
- [API documentation](https://employers.perceptionx.ai/api-docs): parameters, examples, response schemas, rate limits

Versioning: /api/v1/... and /api/... are equivalent (current version v1).
Every response includes "lastUpdated" (date the rankings were last rebuilt)
and "month" (dataset version, YYYY-MM). Rate limit: 60 requests/minute per
IP; responses are cached (typically 30-60 min). Attribution: "PerceptionX
Employer Visibility Index" with a link to https://employers.perceptionx.ai
is appreciated.

## Human-readable pages

- [Rankings home](https://employers.perceptionx.ai/): industry grid
- [All industries](https://employers.perceptionx.ai/industries)
- Industry rankings: https://employers.perceptionx.ai/{industry-slug}/{country-code}, e.g. [Technology / US](https://employers.perceptionx.ai/technology/us) or [Airline / China](https://employers.perceptionx.ai/airline/cn)
- Company profiles: https://employers.perceptionx.ai/company/{slug}, e.g. [Microsoft](https://employers.perceptionx.ai/company/microsoft)
- [Sitemap](https://employers.perceptionx.ai/sitemap.xml)

## Example questions this data answers

- "Where does Microsoft rank on the PerceptionX Visibility Index?" → GET /api/company/microsoft
- "Top 10 employers in Cybersecurity?" → GET /api/rankings?industry=Cybersecurity&limit=10
- "Compare Microsoft and Google as employers." → GET /api/compare?companies=microsoft,google
- "Who improved the most this month?" → GET /api/rankings?sort=change
- "What is Cathay Pacific's Visibility Score in China?" → GET /api/company/cathay-pacific?country=cn

## About

PerceptionX ([perceptionx.ai](https://perceptionx.ai)) helps employers
understand and improve how they appear in AI-generated answers to candidates.
Contact: https://perceptionx.ai