{
  "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. The Visibility Index measures how often companies appear when candidates ask AI assistants (ChatGPT, Gemini, Perplexity) about employers in an industry. No authentication required.",
  "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",
    "documentation": "https://employers.perceptionx.ai/api-docs"
  },
  "methodology": {
    "version": "1.0",
    "url": "https://employers.perceptionx.ai/api-docs#methodology",
    "description": "Visibility Score (0-100) is the share of AI model × candidate-experience-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 company name.",
    "models": [
      "ChatGPT",
      "Google Gemini",
      "Perplexity"
    ]
  },
  "dataset": {
    "totalCompanies": 3158,
    "industries": [
      "Aerospace",
      "Airline",
      "Apparel",
      "Artificial Intelligence",
      "Automotive",
      "Beauty",
      "Biotechnology",
      "Cloud Data Platform",
      "Consulting",
      "Cybersecurity",
      "Electronics",
      "Enterprise Software",
      "Finance",
      "Financial Services",
      "Fintech",
      "FMCG",
      "Gaming",
      "Healthcare",
      "Hospitality",
      "Insurance",
      "Logistics",
      "Manufacturing & Industrial",
      "Media & Entertainment",
      "Oil & Gas",
      "Petcare",
      "Pharmaceutical",
      "Quick Service Restaurants",
      "Real Estate",
      "Retail",
      "Technology",
      "Telecommunications",
      "Travel"
    ],
    "countries": [
      "Brazil",
      "China",
      "France",
      "Germany",
      "India",
      "United Kingdom",
      "United States"
    ],
    "months": [
      "2025-11",
      "2026-01",
      "2026-02",
      "2026-03",
      "2026-04"
    ]
  },
  "rateLimit": "60 requests/minute per IP (responses are CDN-cached)",
  "documentation": "https://employers.perceptionx.ai/api-docs",
  "llmsTxt": "https://employers.perceptionx.ai/llms.txt",
  "endpoints": {
    "GET /api/v1/health": "Liveness + dataset freshness. Example: /api/v1/health",
    "GET /api/v1/search": "Find a company. Params: q (required, company name), country (optional, e.g. us/gb), limit (1-20, default 5). Example: /api/v1/search?q=microsoft",
    "GET /api/v1/company/{slug}": "Full company profile: visibility score, overall & industry rank, per-theme ranks/scores, monthly history, other industries. Params: country (optional). Example: /api/v1/company/microsoft",
    "GET /api/v1/rankings": "Leaderboards. Params: industry (optional; omit for the overall leaderboard), country (default us), month (YYYY-MM for historical), limit (1-100, default 25), page, sort (rank|score|mentions|name|change; 'change' = biggest rank improvers first). Example: /api/v1/rankings?industry=Technology&limit=10",
    "GET /api/v1/rankings/{industry}/{country}": "Compact current leaders for an industry+country, no query params needed. Example: /api/v1/rankings/technology/us",
    "GET /api/v1/compare": "Compare 2-5 companies. Params: companies (required, comma-separated slugs), country (optional). Example: /api/v1/compare?companies=microsoft,google,amazon"
  }
}