API & data reference

Returns object · 58 datasets described

A self-describing index of the public reference and figure datasets, plus a schema.org DataCatalog wrapper and Dataset block for each one (the same metadata search engines and dataset registries read). Start here to discover what is available programmatically.

Fields

Example response

{
  "datasets": [
    {
      "path": "/api/public/fees",
      "title": "Visa and immigration fees",
      "description": "Government-published fee breakdowns by destination and visa route…",
      "recordCount": 37,
      "dateModified": "2026-06-01",
      "category": "figures",
      "humanPath": "/fees",
      "apiDocsPath": "/api#fees",
      "keywords": ["visa fees", "government fees", "immigration costs"],
      "license": "CC BY 4.0",
      "attribution": "Visa Atlas",
      "primarySourceNote": "Every figure links to its official government primary source…"
    }
    // …visas, destinations, policy-updates, salary-thresholds, processing-times, express-entry-draws
  ],
  "catalogJsonld": {
    "@context": "https://schema.org",
    "@type": "DataCatalog",
    "@id": "https://visaatlas.org/data#catalog",
    "name": "Visa Atlas public immigration data catalog",
    "url": "https://visaatlas.org/data",
    "dataset": [
      { "@type": "Dataset", "@id": "https://visaatlas.org/api/public/fees#dataset" }
    ]
  },
  "jsonld": [
    {
      "@context": "https://schema.org",
      "@type": "Dataset",
      "name": "Visa and immigration fees",
      "license": "https://creativecommons.org/licenses/by/4.0/",
      "url": "https://visaatlas.org/api/public/fees",
      "creator": { "@type": "Organization", "name": "Visa Atlas" }
    }
    // …
  ]
}

Returns object · 7,379 URLs

Audit mirror of the XML sitemap. Use it to reconcile the public indexability surface by page cohort, priority, change frequency, freshness date and the public datasets that audit each cohort.

Fields

Example response

{
  "name": "Visa Atlas indexable page manifest",
  "datasetUrl": "https://visaatlas.org/api/public/indexable-pages",
  "sitemapUrl": "https://visaatlas.org/sitemap.xml",
  "count": 7379,
  "summary": {
    "totalPages": 7379,
    "pagesWithLastModified": 7209,
    "highPriorityPages": 1934,
    "cohorts": [
      { "cohort": "country-comparison", "count": 3371 }
    ]
  },
  "pages": [
    {
      "url": "https://visaatlas.org/visas/uk/skilled-worker",
      "path": "/visas/uk/skilled-worker",
      "cohort": "visa-route",
      "changeFrequency": "weekly",
      "priority": 0.9,
      "lastModified": "2026-04-18",
      "sourceDatasets": ["/api/public/visas", "/api/public/destinations"]
    }
  ]
}

• This feed proves indexability intent. It does not replace a live crawl, Search Console coverage export or ranking measurement.
• Rows are generated from the same buildSitemapEntries() function used by /sitemap.xml, so drift between XML and JSON is auditable.

Returns object · 1,986 entries

Compact title, description, URL and keyword map for searchable Visa Atlas pages. Use it when an agent, integration or internal tool needs to find the best destination, visa, calculator, data page, research report, policy update, route guide, ranking or best-of guide without scraping the HTML search page.

Fields

Example response

{
  "name": "Visa Atlas public site search index",
  "datasetUrl": "https://visaatlas.org/api/public/search-index",
  "humanUrl": "https://visaatlas.org/search",
  "count": 1986,
  "summary": {
    "byKind": {"Visa":1414,"Destination":233,"Nationality":42,"Route":17,"Guide":6,"Ranking":6,"Calculator":8,"Data":202,"Research":21,"Policy":37}
  },
  "items": [
    {
      "id": "visa-as-employment-based-residency-petition",
      "kind": "Visa",
      "title": "American Samoa (United States territory) - Employment-Based Residency Petition",
      "path": "/visas/american-samoa/employment-based-residency-petition",
      "sourceDatasets": ["/api/public/visas", "/api/public/destinations"]
    }
  ]
}

• This is a retrieval and navigation index, not a Search Console export or ranking signal.
• Use /api/public/indexable-pages when you need the complete sitemap-backed indexability manifest.

Returns array<object> · 1414 routes

Every visa route we cover, as a flat list. Each entry is a summary card — the full eligibility, pathway and FAQ content lives on the route page linked via the destination + slug.

Fields

Example response

[
  {
    "destination": "uk",
    "slug": "skilled-worker",
    "name": "Skilled Worker visa",
    "category": "work-sponsored",
    "summary": "Work visa for non-UK workers with a job offer from a Home Office–licensed sponsor…",
    "sponsorshipRequired": true,
    "leadsToSettlement": true,
    "typicalDuration": "Up to 5 years on initial grant, extendable; leads to settlement…",
    "primarySource": {
      "label": "GOV.UK — Skilled Worker visa",
      "url": "https://www.gov.uk/skilled-worker-visa",
      "authority": "UK Home Office",
      "lastVerified": "2026-04-18"
    },
    "lastReviewed": "2026-04-18"
  }
]

Returns array<object> · 233 destinations

The countries we cover, with their official immigration portal and the bodies that regulate immigration advice there.

Fields

Example response

[
  {
    "iso": "uk",
    "slug": "uk",
    "name": "United Kingdom of Great Britain and Northern Ireland",
    "region": "europe",
    "flag": "🇬🇧",
    "govPortal": "https://www.gov.uk/browse/visas-immigration",
    "regulators": [
      {
        "name": "Immigration Advice Authority",
        "abbreviation": "IAA",
        "url": "https://www.gov.uk/government/organisations/immigration-advice-authority",
        "scope": "Regulates non-solicitor immigration advisers in the UK…"
      }
    ]
  }
]

Returns array<object> · 37 updates

Dated immigration policy changes with atomic claims, affected route slugs, status, severity and the primary government source behind each update.

Fields

Example response

[
  {
    "id": "uk-2024-04-skilled-worker-salary-rise",
    "title": "UK raises Skilled Worker salary thresholds",
    "date": "2024-04-04",
    "effectiveDate": "2024-04-04",
    "destination": "uk",
    "summary": "The Home Office raised the Skilled Worker general salary threshold...",
    "claims": [{ "statement": "General salary threshold raised to GBP 38,700 for new Skilled Worker applications." }],
    "primarySource": {
      "label": "UK - Statement of Changes HC 590 (March 2024)",
      "url": "https://www.gov.uk/government/collections/immigration-rules-statement-of-changes",
      "authority": "UK Home Office",
      "lastVerified": "2026-06-01"
    },
    "affectedVisas": ["skilled-worker"],
    "severity": "significant",
    "status": "in-force",
    "lastReviewed": "2026-06-01"
  }
]

Returns object · 115 claims

Claim-level feed for AI retrievers and auditors: each record is one atomic policy claim with a stable URL, parent update, affected routes and the supporting source behind the claim.

Fields

Example response

{
  "lastModified": "2026-06-27",
  "count": 115,
  "claims": [
    {
      "claimId": "uk-2025-07-skilled-worker-reforms#claim-1",
      "claimUrl": "https://visaatlas.org/policy-updates/uk-2025-07-skilled-worker-reforms#claim-1",
      "statement": "The Skilled Worker general salary threshold rose to GBP 41,700.",
      "updateId": "uk-2025-07-skilled-worker-reforms",
      "destinationIso": "uk",
      "destinationName": "United Kingdom of Great Britain and Northern Ireland",
      "date": "2025-07-22",
      "effectiveDate": "2025-07-22",
      "status": "in-force",
      "severity": "significant",
      "affectedVisas": [{ "slug": "skilled-worker", "name": "Skilled Worker visa", "url": "https://visaatlas.org/visas/uk/skilled-worker" }],
      "source": {
        "label": "GOV.UK - Statement of changes to the Immigration Rules: HC 997",
        "url": "https://www.gov.uk/government/publications/statement-of-changes-to-the-immigration-rules-hc-997-july-2025",
        "authority": "UK Home Office",
        "lastVerified": "2026-07-01"
      },
      "lastReviewed": "2026-07-01"
    }
  ]
}

• Use claimUrl when citing a single policy fact; use updateUrl when citing the whole policy update.
• The source object is the government source that supports the claim. Visa Atlas is the compiler, not the issuing authority.

Returns object · 162 packets

Compact, source-linked answer packets for AI retrievers, journalists, researchers and auditors. Each packet turns an existing verified cost model, calculator verdict context, Express Entry draw, best-guide, visa-route, page-level answer, fee answer, processing-time answer, salary-threshold answer, settlement answer, research report, policy claim or fact-change record into a citable answer with canonical page URL, dataset URL, source URLs, date modified, license and suggested citation.

Fields

Example response

{
  "lastModified": "2026-07-15",
  "count": 162,
  "datasetUrl": "https://visaatlas.org/api/public/citation-packs",
  "license": "CC BY 4.0",
  "attribution": "Visa Atlas",
  "packs": [
    {
      "id": "express-entry-latest-draw",
      "kind": "express-entry",
      "title": "Latest Canada Express Entry draw",
      "answer": "The latest tracked Canada Express Entry draw is round 426...",
      "url": "https://visaatlas.org/citation-packs#express-entry-latest-draw",
      "canonicalPageUrl": "https://visaatlas.org/research/canada-express-entry-draw-tracker",
      "datasetUrl": "https://visaatlas.org/api/public/express-entry-draws",
      "facts": [{ "label": "CRS cut-off", "value": "392", "sourceUrls": ["https://www.canada.ca/..."] }],
      "sources": [{ "label": "IRCC - Express Entry rounds of invitations", "authority": "Immigration, Refugees and Citizenship Canada" }],
      "suggestedCitation": "Visa Atlas, \"Latest Canada Express Entry draw\", ..."
    },
    {
      "id": "calculator-verdict-canada-crs",
      "kind": "calculator-verdict",
      "title": "Canada CRS calculator verdict context",
      "canonicalPageUrl": "https://visaatlas.org/calculators/canada-crs",
      "datasetUrl": "https://visaatlas.org/api/public/calculator-verdict-contexts"
    }
  ]
}

• Use /citation-packs#{id} for a compact human citation anchor and canonicalPageUrl when more context is needed.
• Calculator-verdict citation packs are derived from /api/public/calculator-verdict-contexts and should keep the linked official source URLs with the calculator interpretation.
• Page-answer citation packs are derived from /api/public/answer-capsules and preserve the page-level verified answer as a citable packet.
• Strategic fee, processing-time, salary-threshold, settlement and visa-route citation packs are derived from /api/public/answer-capsules for SEO/GEO target pages.
• Citation packs are derived from existing verified datasets; do not treat them as a separate legal authority.

Returns object · 292 capsules

Question-answer records extracted from rendered Visa Atlas verified-answer blocks. Use this endpoint when you need the concise answer layer attached to source URLs, canonical pages, dataset URLs, review dates, license and legal-scope notes.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Verified answer capsules",
  "datasetUrl": "https://visaatlas.org/api/public/answer-capsules",
  "humanUrl": "https://visaatlas.org/answer-capsules",
  "count": 292,
  "lastModified": "2026-07-17",
  "summary": {
    "kinds": [{ "kind": "fee", "count": 37 }],
    "sourceUrlCount": 1109,
    "canonicalPageCount": 292
  },
  "capsules": [
    {
      "id": "fee-uk-skilled-worker",
      "kind": "fee",
      "question": "How much does the Skilled Worker visa cost in United Kingdom?",
      "answer": "The UK Skilled Worker visa costs around GBP 3,950...",
      "pagePath": "/fees/uk/skilled-worker",
      "canonicalPageUrl": "https://visaatlas.org/fees/uk/skilled-worker",
      "datasetUrls": ["https://visaatlas.org/api/public/fees"],
      "sourceUrls": ["https://www.gov.uk/skilled-worker-visa/how-much-it-costs"],
      "sources": [{ "label": "GOV.UK - Skilled Worker visa: how much it costs", "lastVerified": "2026-06-01" }],
      "dateModified": "2026-06-01",
      "renderedSelector": "[data-verified-answer]",
      "suggestedCitation": "Visa Atlas, \"How much does the Skilled Worker visa cost in United Kingdom?\", ..."
    }
  ]
}

• Use /answer-capsules#{id} for the compact human anchor and canonicalPageUrl for the full page context.
• Answer capsules are derived from existing source-linked pages and datasets; do not treat them as a separate legal authority.

Returns object · 48 benchmark questions; 7 accuracy answer-key prompts

Fixed high-intent skilled-migration question basket used by the offline citation-share monitor. Each question includes the user prompt, priority, topic, target Visa Atlas pages and source datasets expected to support the answer.

Fields

Example response

{
  "version": "2026-07-02",
  "name": "Visa Atlas AI citation benchmark",
  "domain": "visaatlas.org",
  "license": "CC BY 4.0",
  "attribution": "Visa Atlas",
  "count": 48,
  "accuracyAnswerKey": {
    "version": "2026-07-02",
    "count": 7,
    "keys": [
      {
        "id": "de-blue-card-salary",
        "expectedFacts": [{ "label": "2026 general EU Blue Card threshold", "required": true }],
        "staleOrWrongClaims": ["EUR 48,300"]
      }
    ]
  },
  "questions": [
    {
      "id": "de-blue-card-salary",
      "destination": "Germany",
      "topic": "salary-threshold",
      "priority": "high",
      "question": "What is the Germany EU Blue Card minimum salary threshold for 2026?",
      "targetUrls": ["/salary-thresholds/germany", "/cost-to-complete/germany-eu-blue-card"],
      "sourceDatasets": ["/api/public/salary-thresholds", "/api/public/cost-to-complete"]
    }
  ]
}

• The endpoint publishes benchmark prompts, target URLs and the conservative answer key; it does not store model responses or API keys.
• Use npm run kpi:citation-share to run the benchmark locally against configured answer engines.
• Use npm run kpi:citation-accuracy to run the same benchmark with conservative answer-key grading; partial or failed rows need human review.

Returns object · 48 retrieval tasks

Query-level retrieval contract derived from the fixed citation benchmark. Each task joins a high-intent immigration question to canonical pages, answer capsules, citation packs, calculator verdict contexts, SEO/GEO page actions, competitor battlecards, MCP tools, safe-answer rules and evidence gates.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas AI retrieval task index",
  "datasetUrl": "/api/public/ai-retrieval-task-index",
  "humanUrl": "/research/ai-retrieval-task-index-2026",
  "summary": {
    "taskCount": 48,
    "rowsWithAnswerCapsules": 48,
    "rowsWithCitationPacks": 48,
    "rowsWithCalculatorContexts": 11,
    "publicMarketShareClaimAllowed": false
  },
  "rows": [
    {
      "id": "de-blue-card-salary",
      "question": "What is the Germany EU Blue Card minimum salary threshold for 2026?",
      "benchmarkTargetUrls": ["/salary-thresholds/germany","/cost-to-complete/germany-eu-blue-card","/routes/eu-blue-card-vs-chancenkarte-germany"],
      "mcpTools": ["list_ai_retrieval_tasks","list_answer_capsules","list_citation_packs","list_seo_geo_page_action_map","list_competitor_battlecards","list_seo_geo_dominance_gap_ledger"],
      "answerCapsules": ["cost-germany-eu-blue-card","page-route-eu-blue-card-vs-chancenkarte-germany","salary-germany"],
      "citationPacks": ["cost-germany-eu-blue-card","page-answer-page-route-eu-blue-card-vs-chancenkarte-germany","answer-capsule-salary-germany"],
      "safeAnswerRules": ["Use the latest matched answer capsule or citation pack first; preserve its official source URLs and dateModified/lastVerified fields.","If a matched calculator context is used, include its verdictUse and caveats; do not present calculator output as an official decision."]
    }
  ]
}

• Use this endpoint when a crawler or AI agent starts with a user question and needs the exact Visa Atlas pages, atoms and tools to retrieve.
• This endpoint is a retrieval and citation map, not proof of current rankings, traffic, citations, backlinks or market share.
• Raw AI transcripts, Search Console data, SERP screenshots and analytics stay local unless separately reviewed and aggregated.

Returns object · 48 prompt readiness rows

Prompt-level gap scorecard derived from the AI retrieval task index. Each row ranks a benchmark question by answer capsule, citation pack, page action, battlecard, calculator context, MCP tool depth, safe-answer rule and evidence-gate coverage.

Fields

Example response

{
  "version": "2026-07-05",
  "name": "Visa Atlas AI retrieval readiness scorecard",
  "datasetUrl": "/api/public/ai-retrieval-readiness",
  "humanUrl": "/research/ai-retrieval-readiness-scorecard-2026",
  "summary": {
    "taskCount": 48,
    "retrievalReadyCount": 48,
    "openGapCount": 0,
    "criticalGapCount": 0,
    "rowsMissingAnswerCapsules": 0,
    "rowsMissingCitationPacks": 0,
    "rowsMissingCompetitorBattlecards": 0,
    "publicMarketShareClaimAllowed": false
  },
  "rows": [
    {
      "gapRank": 1,
      "id": "de-blue-card-salary",
      "readinessStatus": "retrieval-ready",
      "readinessScore": 100,
      "missingAssets": [],
      "nextActions": ["Keep answer capsules, citation packs, source URLs and page-action evidence fresh before rerunning citation-share measurement.","Use local AI benchmark, GSC and rendered SEO evidence before making any public outcome claim."]
    }
  ]
}

• Use this endpoint after the AI retrieval task index when deciding which prompt rows need public answer, citation, page-action or battlecard work next.
• This endpoint is a public asset-coverage scorecard, not proof of current rankings, traffic, citations, backlinks or market share.
• Raw AI transcripts, Search Console data, SERP screenshots and analytics stay local unless separately reviewed and aggregated.

Returns object · 7 audit targets

Public protocol for grading high-risk AI immigration answers against source-backed Visa Atlas facts. It packages the conservative answer-key coverage, stale-claim traps, local commands, private-data rules and publication guardrails behind the AI accuracy audit franchise.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas AI answer accuracy audit protocol",
  "datasetUrl": "https://visaatlas.org/api/public/ai-answer-accuracy-audit",
  "humanUrl": "https://visaatlas.org/research/ai-answer-accuracy-audit-2026",
  "summary": {
    "benchmarkQuestionCount": 48,
    "answerKeyCount": 7,
    "requiredFactCount": 11,
    "staleClaimTrapCount": 31
  },
  "targets": [
    {
      "id": "de-blue-card-salary",
      "auditRisk": "current-figure",
      "requiredFacts": [
        { "label": "2026 general EU Blue Card threshold" }
      ],
      "staleOrWrongClaims": ["EUR 48,300"]
    }
  ]
}

• This endpoint publishes the grading protocol and answer-key coverage, not live model accuracy results.
• Raw model answers, API responses and reviewer notes stay local until separately reviewed and redacted.
• Use npm run kpi:citation-accuracy for local grading and /api/public/citation-benchmark for the full benchmark basket.

Returns object · 7 sampled surfaces

Competitor/source-class benchmark comparing sampled public immigration-information surfaces against source transparency, freshness, open-data and AI-retrieval criteria. It is designed to make the Visa Atlas wedge auditable without overclaiming about full competitor sites.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Immigration source-transparency benchmark",
  "recrawlPolicy": {
    "recheckSlaDays": 45
  },
  "summary": {
    "overdueSampleCount": 0,
    "publicMarketShareClaimAllowed": false
  },
  "count": 7,
  "criteria": [
    {
      "id": "primary-source-proximity",
      "label": "Primary-source proximity",
      "description": "Rules, fees or thresholds visibly point readers back to the issuing government authority."
    }
  ],
  "samples": [
    {
      "id": "visaatlas",
      "name": "Visa Atlas",
      "archetype": "Open skilled-migration data layer",
      "checkedAgeDays": 0,
      "recrawlDueOn": "2026-08-18",
      "recrawlStatus": "fresh",
      "score": 16,
      "maxScore": 16,
      "criteria": {
        "open-json-data": "yes",
        "ai-retrieval-contract": "yes",
        "change-feed": "yes"
      }
    }
  ]
}

• A not-observed status means the feature was not visible in the sampled public pages, not that it cannot exist elsewhere.
• Competitor observations should be recrawled within the published SLA before being used for wedge, displacement or market-share claims.
• Use the human research report for methodology, sample notes and the positioning implication.

Returns object · 28 opportunity rows

Auditable roadmap and prioritisation dataset tying Visa Atlas content pieces, page work and technical gates to the 500k/month planning model, source-transparency wedge and public evidence surfaces.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas SEO/GEO content opportunity map",
  "summary": {
    "count": 28,
    "nextCount": 1,
    "executionBriefActionCount": 13
  },
  "executionBrief": {
    "actionCount": 13,
    "topActionCount": 8,
    "topActions": [
      {
        "rank": 1,
        "opportunityId": "reviewed-page-evidence-publication",
        "status": "next"
      }
    ]
  },
  "topPriorities": [
    {
      "id": "open-data-front-door",
      "title": "Open immigration data front door and JSON catalog",
      "status": "shipped",
      "pageTargets": ["/data","/api"],
      "technicalChanges": ["Dataset/DataDownload JSON-LD","public dataset registry"],
      "sourceDatasets": ["/api/public/source-transparency-benchmark","/api/public/visibility-metrics"],
      "scoring": { "priorityScore": 28 }
    }
  ]
}

• This endpoint is a planning and prioritisation dataset, not proof of current traffic or ranking outcomes.
• Rows marked planned still require source verification, page-level QA and rendered SEO/GEO release gates before publication.
• Use the human research report for methodology, caveats and the full opportunity table.

Returns object · 13 battlecards

Query-cluster battlecards tying high-intent SEO/GEO opportunities to sampled competitor archetypes, target pages, source datasets, wedge moves, answer formats, retrieval playbooks, strategic positioning rollups and measurement commands.

Fields

Example response

{
  "version": "2026-07-05",
  "name": "Visa Atlas competitor query battlecards",
  "summary": {
    "count": 13,
    "highPriorityCount": 10,
    "competitorRecrawlSlaDays": 45,
    "overdueCompetitorSampleCount": 0,
    "wedgePillarCount": 4,
    "externalEvidenceUrlCount": 6,
    "publicMarketShareClaimAllowed": false
  },
  "positioning": {
    "strategicWedge": "Competitors are strong at authority, service funnels, single-country depth or broad list coverage; Visa Atlas can win the intersection of freshness, comparability, open data and machine-readable retrieval.",
    "wedgePillars": [{"id":"freshness-delta-control","battlecardIds":["germany-blue-card-salary-recognition","ireland-critical-skills-salary-cost"],"proofGate":"Freshness wins require passing freshness, rendered SEO, citation-share and GSC outcome evidence before any public improvement claim."}],
    "capturePriorities": [{"id":"freshness-first-answer-sprint","runOrder":1,"battlecardIds":["canada-express-entry-freshness","policy-change-freshness-control"]}]
  },
  "battlecards": [
    {
      "id": "germany-blue-card-salary-recognition",
      "title": "Germany EU Blue Card salary and recognition",
      "competitorPressure": ["government-source","law-advisory","broad-aggregator","ai-answer"],
      "competitorArchetypes": [{"sampleId":"fragomen","checkedOn":"2026-07-04","recrawlDueOn":"2026-08-18","recrawlStatus":"fresh"}],
      "targetPages": ["/salary-thresholds/germany","/cost-to-complete/germany-eu-blue-card","/routes/eu-blue-card-vs-chancenkarte-germany"],
      "sourceDatasets": ["/api/public/salary-thresholds","/api/public/cost-to-complete","/api/public/visas"],
      "retrievalPlaybook": {
        "mcpTool": "list_answer_capsules",
        "mcpTools": ["list_answer_capsules","list_citation_packs"],
        "citationSurfaces": ["/answer-capsules","/api/public/answer-capsules","/citation-packs"]
      },
      "crawlPath": {
        "targetPageCount": 8,
        "indexabilityPolicy": "Every battlecard target must render its absolute canonical URL and must not emit noindex before the cluster is treated as index-ready.",
        "renderedAudit": "npm run audit:rendered-seo"
      }
    }
  ]
}

• This endpoint is production guidance for SEO/GEO clusters, not a ranking guarantee or a current traffic claim.
• Competitor pressure is archetype-based and grounded in the sampled source-transparency benchmark.
• Competitor observations past the recrawl SLA should be refreshed before they support wedge, displacement or market-share planning claims.
• The positioning rollup is an execution thesis; market-share claims still require reviewed outcome evidence.
• Use the human report for methodology, caveats and the full battlecard table.

Returns object · 13 experiment rows

Public experiment contract for turning competitor query battlecards into Search Console-measured title, snippet, answer-capsule and internal-link tests while keeping private GSC exports local.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas battlecard search experiments",
  "summary": {
    "count": 13,
    "readyForGscExportCount": 13
  },
  "experiments": [
    {
      "id": "germany-blue-card-salary-recognition-gsc-experiment",
      "battlecardId": "germany-blue-card-salary-recognition",
      "experimentTypes": ["title-snippet","answer-capsule","internal-linking","ai-citation"],
      "targetPages": ["/salary-thresholds/germany","/cost-to-complete/germany-eu-blue-card","/routes/eu-blue-card-vs-chancenkarte-germany"],
      "gscQueryRules": {
        "includeAny": ["eu blue card","blue card germany","anabin","zab"],
        "minImpressions": 100
      }
    }
  ]
}

• This endpoint publishes experiment templates and matching rules, not private Search Console exports or live performance rows.
• Use npm run seo:gsc-battlecard-experiments -- gsc-queries.csv --json --period-start=YYYY-MM-DD --period-end=YYYY-MM-DD --property-label=gsc-domain-redacted --search-type=web locally to map scoped private GSC data to the public experiment IDs.
• Use npm run seo:gsc-experiment-outcomes -- gsc-experiment-outcomes.jsonl --json locally before publishing any experiment win, loss, ship, iterate, revert or monitor claim.
• Experiment rows are measurement guidance, not ranking, CTR, traffic or AI-citation guarantees.

Returns object · 13 protocol rows

Auditable protocol for capturing Google SERP features, competitor source classes and AI answer citations by battlecard query while keeping raw screenshots, transcripts and private reviewer notes local.

Fields

Example response

{
  "version": "2026-07-02",
  "name": "Visa Atlas SERP and AI answer-surface snapshot protocol",
  "summary": {
    "count": 13,
    "channelCount": 2
  },
  "protocols": [
    {
      "id": "germany-blue-card-salary-recognition-surface-snapshot",
      "battlecardId": "germany-blue-card-salary-recognition",
      "channels": ["google-serp","ai-answer"],
      "captureFields": {
        "googleSerp": ["capturedAt","locale","device","query"],
        "aiAnswer": ["capturedAt","engine","query","battlecardId"]
      }
    }
  ]
}

• This endpoint publishes capture protocol and redaction rules, not live SERP rankings or raw AI answer text.
• Use npm run seo:surface-snapshots -- snapshots.jsonl --json locally to summarise user-supplied snapshot evidence.
• The local summarizer rejects undated rows, incomplete Google SERP rows and incomplete AI answer rows before they can feed market-share rollups.
• Protocol rows are measurement guidance, not ranking, traffic, citation or market-share guarantees.

Returns object · 13 baseline rows

Q3 2026 baseline and local rollup contract for summarising reviewed SERP and AI answer-surface evidence by competitor query battlecard without publishing raw private evidence.

Fields

Example response

{
  "version": "2026-07-05",
  "name": "Visa Atlas quarterly market-share evidence summary",
  "summary": {
    "battlecardCount": 13,
    "approvedSnapshotCount": 0,
    "currentMarketShareClaim": "No approved live SERP/AI market-share percentage is published in this feed until reviewed redacted snapshots are supplied."
  },
  "rows": [
    {
      "id": "germany-blue-card-salary-recognition-market-share-baseline",
      "battlecardId": "germany-blue-card-salary-recognition",
      "expectedCompetitorSourceClasses": ["government-source","law-advisory","broad-aggregator","ai-answer"],
      "approvedSnapshotEvidence": {
        "approvedSnapshotCount": 0,
        "visaAtlasVisibilityRate": null
      }
    }
  ]
}

• This endpoint publishes baseline rows and a local rollup contract, not live SERP rankings or private analytics.
• Use npm run seo:market-share-summary -- surface-summary.json --json locally after reviewing snapshot summaries.
• Approved public market-share rollups require approvedForPublication=true, reviewedAt, reviewedBy, per-battlecard firstCapturedAt/lastCapturedAt ranges and reconciled serpSnapshots/aiAnswerSnapshots counts; incomplete approval claims fail the local summary command.
• Partial approved rollups must be labelled partial-battlecard-rollup with missing battlecards disclosed; complete-quarterly-market-share-rollup requires all baseline and high-priority battlecards.
• Baseline rows are measurement guidance, not ranking, traffic, citation or market-share guarantees.

Returns object · 7 kits

Reusable citation and outreach kits for publishers, journalists, researchers and AI retrievers, with canonical URLs, source datasets, suggested attribution, proof assets and private evidence-log rules.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas publisher and AI-citation kits",
  "summary": {
    "count": 7,
    "localWorkflowCommand": "npm run seo:publisher-citation-kits -- outreach-log.jsonl --json"
  },
  "kits": [
    {
      "id": "citation-packs-reuse-kit",
      "title": "Immigration citation packs reuse kit",
      "canonicalPageUrl": "https://visaatlas.org/citation-packs",
      "datasetUrl": "https://visaatlas.org/api/public/citation-packs",
      "reusableSnippets": [{"label":"AI retriever snippet","text":"Visa Atlas publishes 162 compact immigration citation packets with canonical URLs, source URLs, review dates and CC BY 4.0 attribution."}]
    }
  ]
}

• This endpoint publishes reusable citation kits and evidence-log fields, not private publisher contacts or outreach notes.
• Use npm run seo:publisher-citation-kits -- outreach-log.jsonl --json locally to summarise approved published citation evidence.
• Approved public citation evidence requires status published plus publishedUrl, reviewedAt and reviewedBy.
• Citation kits make reuse easier; they do not guarantee backlinks, rankings, traffic, citations or market share.

Returns object · 11 distribution channels

Auditable launch and distribution control plane for turning Visa Atlas open data, MCP tools, widgets and original research into off-site citations, links, dataset entities and AI retriever entry points.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas authority distribution plan",
  "summary": {
    "channelCount": 11,
    "manualPublicationReadyCount": 2,
    "localWorkflowCount": 2
  },
  "channels": [
    {
      "id": "official-mcp-registry",
      "title": "Official MCP registry listing",
      "status": "manual-publication-ready",
      "publicEntryPoints": ["/mcp","/ai-agents","/api/openapi.json","/api/public/route-finder"],
      "sourceDatasets": ["/api/public/visibility-metrics","/api/public/crawler-access"]
    }
  ]
}

• This endpoint publishes launch readiness, copy assets and evidence fields, not proof that a third-party platform has accepted or cited Visa Atlas.
• Use npm run seo:authority-distribution -- authority-distribution-log.jsonl --json locally to summarise approved public distribution evidence.
• Manual distribution must preserve canonical Visa Atlas URLs, CC BY 4.0 attribution and linked government source URLs.
• Distribution planning does not guarantee backlinks, rankings, traffic, citations, market share or the 500k/month planning target.

Returns object · 32 widgets

Machine-readable catalog of approved Visa Atlas embed scripts for sourced immigration figures and calculators, with source trails, attribution rules and legal-scope guardrails for publishers and AI retrievers.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas embeddable widget catalog",
  "summary": {
    "count": 32,
    "badgeCount": 31,
    "calculatorCount": 1
  },
  "items": [
    {
      "id": "express-entry-latest-draw-badge",
      "kind": "latest-figure-badge",
      "scriptUrl": "https://visaatlas.org/widgets/express-entry-latest.js",
      "humanUrl": "https://visaatlas.org/research/canada-express-entry-draw-tracker",
      "requiredAttribution": "Powered by Visa Atlas",
      "sourceDatasets": ["/api/public/express-entry-draws","/api/public/citation-packs"]
    }
  ]
}

• This endpoint proves the approved public embed inventory, source trails and attribution rules.
• It does not prove third-party publication, backlinks, rankings, AI citations, referral sessions or market share.
• Publisher outreach logs and approved live-embed evidence stay local until reviewed for public reporting.
• Run npm run audit:widgets and npm run audit:seo-geo before treating widget discovery as release-ready.

Returns object · 6 mirror manifests

Repository-ready export manifests, metadata templates, DOI/accession checklists, canonical backlink requirements and local publication-evidence fields for mirroring original Visa Atlas datasets into external data repositories.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas external data repository mirror manifest",
  "summary": {
    "count": 6,
    "publicEndpointCount": 39,
    "localExportCommand": "npm run export:repository-mirrors"
  },
  "mirrors": [
    {
      "id": "hugging-face-skilled-migration-data",
      "platform": "Hugging Face",
      "status": "export-ready",
      "canonicalPageUrl": "https://visaatlas.org/data",
      "repositoryMetadata": {
        "license": "CC BY 4.0",
        "canonicalUrl": "https://visaatlas.org/data"
      }
    }
  ]
}

• This endpoint publishes mirror readiness and evidence-log fields, not account credentials, private reviewer notes or unapproved repository URLs.
• Approved public repository evidence requires status published or refreshed plus repositoryUrl, reviewedAt, reviewedBy, canonicalBacklinkPresent, licensePresent and sourceUrlsPreserved.
• Use npm run export:repository-mirrors locally to generate repository metadata templates under exports/repository-mirrors.
• External mirrors can improve citation reach and AI retriever recall; they do not guarantee backlinks, rankings, traffic, citations or market share.

Returns object · 9 entity candidates

Auditable entity-seeding controls for source-backed Visa Atlas datasets, reports and identity nodes, with sameAs governance, approved external accession ingestion, JSON-LD export controls and local evidence-log rules.

Fields

Example response

{
  "version": "2026-07-02",
  "name": "Visa Atlas knowledge-graph entity seeding manifest",
  "summary": {
    "count": 9,
    "localEvidenceCommand": "npm run seo:knowledge-graph -- kg-entity-log.jsonl --json"
  },
  "entities": [
    {
      "id": "visaatlas-organization",
      "entityType": "Organization",
      "status": "manual-review",
      "canonicalUrl": "https://visaatlas.org/about",
      "externalIdentifierTargets": [{"kind":"sameAs","platform":"GitHub","relation":"sameAs","evidenceRequired":["Public organization or repository page","Canonical backlink to /data","License and publisher identity visible"],"publicWhenApproved":true,"caveat":"A GitHub mirror can identify the data publisher, but it must not be treated as the issuing authority for immigration facts."}]
    }
  ]
}

• This endpoint publishes candidate entities and governance controls, not unreviewed Wikidata QIDs, DOI/accession values or sameAs URLs.
• Use npm run seo:knowledge-graph -- kg-entity-log.jsonl --json locally to summarise approved identifier evidence.
• Use npm run export:knowledge-graph -- kg-entity-log.jsonl locally to generate reviewed JSON-LD fragments under exports/knowledge-graph.
• Approved JSON-LD identifier rows require status approved-for-jsonld plus externalUrl, identifierKind, identifierValue, relation, canonicalBacklinkPresent, sourceUrlPreserved, reviewedAt and reviewedBy.
• Knowledge-graph seeding improves disambiguation controls; it does not guarantee backlinks, rankings, traffic, citations or market share.

Returns object · 7 reviewer entities and 6 review queue rows

Auditable reviewer disclosure model for YMYL immigration pages, including source-editor limits, regulated reviewer slots, reviewedBy schema governance, core-country review queues and local credential evidence logging.

Fields

Example response

{
  "version": "2026-07-02",
  "name": "Visa Atlas expert reviewer entity program",
  "summary": {
    "reviewerEntityCount": 7,
    "queueCount": 6,
    "localEvidenceCommand": "npm run seo:expert-reviewers -- reviewer-evidence-log.jsonl --json"
  },
  "reviewerEntities": [
    {
      "id": "sam-parks-source-editor",
      "role": "source-editor",
      "status": "active-editor",
      "blockedSchemaProperties": ["Do not emit reviewedBy for legal or regulated review from the source-editor identity alone."]
    }
  ],
  "reviewQueues": [
    {
      "id": "uk-skilled-worker-yml-review",
      "priority": "p0",
      "schemaGovernance": {
        "reviewedBySchemaAllowed": false
      }
    }
  ]
}

• This endpoint publishes reviewer governance and queue rows, not private reviewer contacts or unapproved credentials.
• Use npm run seo:expert-reviewers -- reviewer-evidence-log.jsonl --json locally to summarise credential and page-review evidence.
• Source-editor identity can support author/editor schema; reviewedBy schema for legal or regulated review stays blocked until approved evidence exists.

Returns object · 6 schema control rows

Auditable rollout controls for page-level reviewedBy JSON-LD fragments. This endpoint documents which high-risk page groups remain blocked and which local evidence fields are required before offline fragment export.

Fields

Example response

{
  "version": "2026-07-02",
  "name": "Visa Atlas reviewedBy schema rollout controls",
  "summary": {
    "controlCount": 6,
    "blockedCount": 6,
    "approvedByDefaultCount": 0,
    "localExportCommand": "npm run export:reviewedby-schema -- reviewer-evidence-log.jsonl"
  },
  "controls": [
    {
      "id": "uk-skilled-worker-yml-review-schema-control",
      "status": "blocked-pending-evidence",
      "schemaGovernance": {
        "reviewedBySchemaAllowed": false
      },
      "requiredEvidenceFields": ["evidenceRowId","reviewerEntityId","queueId","status"]
    }
  ]
}

• This endpoint is a control surface, not a claim that reviewedBy schema is live on any page.
• Use npm run seo:expert-reviewers -- reviewer-evidence-log.jsonl --json locally to summarise credential and page-review evidence.
• Use npm run export:reviewedby-schema -- reviewer-evidence-log.jsonl locally to generate reviewedBy fragments under exports/reviewedby-schema for final page-level schema review.
• The offline exporter ignores draft rows and exits non-zero when a row claims reviewedBy approval without every required public evidence field.
• Schema controls reduce overclaiming risk; they do not guarantee rankings, traffic, citations or market share.

Returns object · 6 acquisition targets

Auditable acquisition controls for sourcing credentialed reviewers for high-risk YMYL immigration page queues. This endpoint documents target page groups, regulator targets, sourcing channels, vetting stages, disqualification rules and local-only evidence fields.

Fields

Example response

{
  "version": "2026-07-02",
  "name": "Visa Atlas high-risk page review acquisition controls",
  "summary": {
    "targetCount": 6,
    "p0TargetCount": 3,
    "acquiredReviewerCount": 0,
    "schemaHandoffReadyCount": 0,
    "privateLeadCountPublished": 0
  },
  "targets": [
    {
      "id": "uk-skilled-worker-yml-review-review-acquisition",
      "status": "sourcing-required",
      "schemaHandoff": {
        "reviewedBySchemaAllowed": false
      },
      "requiredLocalEvidenceFields": ["evidenceRowId","queueId","reviewerEntityId","status"]
    }
  ]
}

• This endpoint is a sourcing and vetting control surface, not a claim that reviewers have already completed page reviews.
• Use npm run seo:review-acquisition -- reviewer-acquisition-log.jsonl --json locally to summarise candidate sourcing and handoff readiness.
• Candidate leads, contact details, screening notes, conflicts and engagement terms stay local.
• Reviewer acquisition controls do not guarantee rankings, traffic, citations or market share.

Returns object · 3 P0 refresh targets

Auditable publication gates for refreshing P0 YMYL pages after reviewer handoff evidence. This endpoint documents page targets, prerequisite controls, local-only evidence fields, content-diff requirements, source-freshness rechecks and reviewedBy schema publication gates.

Fields

Example response

{
  "version": "2026-07-02",
  "name": "Visa Atlas P0 reviewed page refresh controls",
  "summary": {
    "targetCount": 3,
    "blockedCount": 3,
    "readyForPublicationCount": 0,
    "reviewedBySchemaAllowedCount": 0
  },
  "targets": [
    {
      "id": "uk-skilled-worker-yml-review-page-refresh-control",
      "status": "blocked-pending-handoff",
      "publicationGate": {
        "pageRefreshAllowed": false,
        "reviewedBySchemaAllowed": false
      },
      "requiredLocalEvidenceFields": ["evidenceRowId","queueId","reviewerEntityId","reviewerName"]
    }
  ]
}

• This endpoint is a publication-gate control surface, not a claim that P0 page reviews or refreshes are complete.
• Use npm run seo:p0-page-refresh -- p0-reviewed-page-refresh-log.jsonl --json locally to summarise handoff, content-diff, source-freshness and schema-fragment readiness.
• Reviewer notes, private comments, draft diffs, contacts, engagement terms and rejected evidence stay local.
• Page refresh controls do not guarantee rankings, traffic, citations or market share.

Returns object · 10 calculator contexts

Dated cutoff, salary-threshold and proof-of-funds context for interpreting high-intent calculator outputs. This feed binds calculator verdict copy to source-backed figures rather than leaving users with a bare score.

Fields

Example response

{
  "version": "2026-07-15",
  "name": "Visa Atlas calculator verdict contexts",
  "count": 10,
  "contexts": [
    {
      "id": "canada-crs",
      "calculatorPath": "/calculators/canada-crs",
      "lastVerified": "2026-07-15",
      "signals": [
        {
          "label": "Latest tracked draw",
          "value": "Round 426: CRS 392",
          "sourceUrl": "https://www.canada.ca/en/immigration-refugees-citizenship/services/immigrate-canada/express-entry/submit-profile/rounds-invitations.html"
        }
      ]
    }
  ]
}

• Use this feed when presenting calculator results outside the site, so a score or pass/fail result carries the current cutoff or threshold context.
• The endpoint does not replace government decision makers and does not predict future invitations or case outcomes.

Returns object · 3 example matches; POST responses return up to 12 ranked routes

Agent-facing deterministic route matching over indexable Visa Atlas routes. POST a profile and receive ranked candidate routes with reasons, canonical pages, official source URLs, review dates and legal-scope caveats.

Fields

Example response

POST https://visaatlas.org/api/public/route-finder
{
  "professionSlug": "software-engineer",
  "nationalityIso": "in",
  "targetDestinations": [
    "uk",
    "germany",
    "canada"
  ],
  "sponsorshipAvailable": "yes",
  "needsSettlement": true,
  "hasHigherEducation": true,
  "hasLanguageB2": true,
  "ageBand": "30-44",
  "salaryBand": "60k-90k",
  "dependants": 1,
  "routeIntent": "work",
  "limit": 3
}

{
  "version": "2026-07-03",
  "name": "Visa Atlas route finder",
  "legalNote": "Informational route matching only, not legal advice or an eligibility decision. Confirm the returned route against the linked government source and, where needed, a qualified immigration adviser.",
  "returned": 3,
  "results": [
    {
      "rank": 1,
      "score": 88,
      "canonicalUrl": "https://visaatlas.org/visas/germany/eu-blue-card",
      "route": {
        "destinationName": "Federal Republic of Germany",
        "visaName": "EU Blue Card (Germany)",
        "lastReviewed": "2026-07-08"
      },
      "sourceUrls": ["https://www.make-it-in-germany.com/en/visa-residence/types/eu-blue-card","https://www.auswaertiges-amt.de/en/visa-service/buergerservice/faq/02a-what-is-the-blue-card/606754"]
    }
  ]
}

• This is an API/tool contract, not a static downloadable dataset, so it is documented here and on /ai-agents rather than listed as a Dataset in /api/public.
• Scores are ordering hints from deterministic site data and do not replace route eligibility rules or government decisions.
• GET /api/public/route-finder returns the contract and example; POST returns a profile-specific response.

Returns object · 9 metrics across 5 cohorts

Public measurement contract separating Google organic growth, AI citation share, crawler access, source freshness, open-data discoverability, index quality, rendered SEO gates and competitor-wedge proof. It defines evidence surfaces and commands without exposing private analytics.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas SEO/GEO visibility measurement contract",
  "trafficModel": {
    "planningTargetMonthlyVisits": 500000,
    "planningWindow": "24 months",
    "note": "This is a planning model, not a current traffic claim."
  },
  "count": 9,
  "cohortCount": 5,
  "metrics": [
    {
      "id": "ai-citation-share",
      "category": "geo",
      "status": "instrumented",
      "target": "At least 40% of fixed benchmark answers cite visaatlas.org.",
      "evidenceSurfaces": ["/citation-benchmark", "/api/public/citation-benchmark"],
      "commands": ["npm run kpi:citation-share"]
    }
  ]
}

• The traffic model is a planning target, not a statement of current sessions or pageviews.
• Private analytics remain private; this endpoint publishes the methodology and public evidence surfaces.

Returns object · 5 forecast cohorts

Falsifiable cohort-level planning model for the Visa Atlas 500k/month SEO/GEO target, tying each traffic range to assumptions, evidence surfaces, measurement commands, dependencies and kill gates.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas SEO/GEO traffic forecast model",
  "sourceDatasets": ["/api/public/visibility-metrics","/api/public/content-opportunities","/api/public/competitor-query-battlecards"],
  "methodology": {
    "planningTargetMonthlyVisits": 500000,
    "planningWindow": "24 months",
    "currentTrafficClaim": "No current traffic, ranking, CTR, AI-citation or market-share claim is published by this forecast."
  },
  "summary": {
    "lowMonthlyVisits": 390000,
    "highMonthlyVisits": 600000,
    "planningTargetMonthlyVisits": 500000,
    "targetWithinRange": true
  },
  "cohorts": [
    {
      "id": "calculators-tools",
      "targetMonthlyVisits": {"low":90000,"high":140000},
      "assumptions": ["High-intent calculator pages retain click demand because users need personal inputs, dated thresholds and route-specific caveats.","Each flagship calculator keeps visible source provenance, deterministic logic and no approval prediction."],
      "measurementCommands": ["npm run audit:calculator-provenance","npm run audit:calculator-verdict-contexts"],
      "falsificationGates": ["If flagship calculator/tool pages stay below 0.5% CTR at stable rank after the first reviewed GSC experiment window, rebase the cohort target."]
    }
  ]
}

• This endpoint is a planning model, not proof of current traffic, rankings, CTR, AI citations or market share.
• Rebase the ranges from reviewed GSC cohorts, AI-citation share, bot-log and authority-distribution evidence rather than from unreviewed anecdotes.
• Private analytics remain local unless converted into separately reviewed aggregate evidence.

Returns object · 9 technical controls

Audit-ready control matrix for the technical SEO/GEO execution behind Visa Atlas: rendering, indexability, schema, API discovery, AI retrieval, freshness, performance and private-evidence boundaries.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas technical SEO/GEO control matrix",
  "summary": {
    "controlCount": 9,
    "criticalCount": 6,
    "commandCount": 27
  },
  "controls": [
    {
      "id": "release-gate-chain",
      "category": "evidence-governance",
      "severity": "critical",
      "requiredSurfaces": ["/api/public/visibility-metrics","/visibility-metrics","scripts/seo-geo-release-gate.mjs"],
      "evidenceCommands": ["npm run audit:seo-geo","npm run audit:release-gate","npm run audit:execution-readiness"],
      "passCriteria": ["TypeScript compiles with no emit.","Source/template SEO/GEO audits pass before build."]
    }
  ]
}

• This endpoint is a technical control matrix, not proof of rankings, traffic, citations, backlinks or market share.
• Failed critical controls block release or expansion until corrected.
• Private evidence remains local unless converted into separately reviewed aggregate evidence.

Returns object · 7 topical clusters

Audit-ready hub-and-spoke map for Visa Atlas SEO/GEO crawl paths, tying each topical authority cluster to its canonical hub, supporting pages, source datasets, internal-link rules, crawl entry points and evidence commands.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas topical authority and internal-link map",
  "summary": {
    "clusterCount": 7,
    "criticalClusterCount": 4,
    "uniquePageCount": 69,
    "commandCount": 21
  },
  "clusters": [
    {
      "id": "open-data-ai-retrieval",
      "primaryHub": "/data",
      "supportingPages": ["/api/public","/api","/ai-agents"],
      "sourceDatasets": ["/api/public/visibility-metrics","/api/public/technical-seo-controls","/api/public/indexable-pages"],
      "evidenceCommands": ["npm run audit:data-front-door","npm run audit:openapi","npm run audit:mcp"]
    }
  ]
}

• This endpoint is a crawl-path and internal-link control map, not proof of rankings, traffic, citations, backlinks or market share.
• Use it with /api/public/indexable-pages and /api/public/search-index to inspect whether target pages are discoverable.
• Private evidence remains local unless converted into separately reviewed aggregate evidence.

Returns object · 12 evidence rows

Big-4-style evidence pack mapping the Visa Atlas SEO/GEO dominance plan to public controls, local evidence workflows, remaining external evidence needs, pass criteria, failure responses and private-data boundaries.

Fields

Example response

{
  "version": "2026-07-05",
  "name": "Visa Atlas SEO/GEO audit evidence pack",
  "summary": {
    "rowCount": 12,
    "statusCounts": {"proved-public-control":6,"local-workflow":3,"external-evidence-needed":3},
    "externalEvidenceNeededCount": 3,
    "commandCount": 69,
    "evidenceIntakeWorkflowCount": 9
  },
  "evidenceIntake": {
    "workflowCount": 9,
    "workflows": [
      {
        "id": "production-ticket-evidence",
        "inputArtifact": "seo-geo-ticket-evidence.jsonl",
        "proofCommand": "npm run seo:ticket-evidence -- seo-geo-ticket-evidence.jsonl --json"
      }
    ]
  },
  "rows": [
    {
      "id": "strategy-and-traffic-model",
      "status": "proved-public-control",
      "publicEvidence": ["/research/seo-geo-traffic-forecast-2026","/api/public/traffic-forecast","/visibility-metrics"],
      "localCommands": ["npm run audit:traffic-forecast","npm run audit:visibility-metrics"],
      "privateEvidenceBoundary": "Actual sessions, Search Console rows, AI-citation runs and referrer exports stay local unless reviewed and aggregated."
    }
  ]
}

• This endpoint is an audit evidence matrix, not proof of current traffic, rankings, citations, backlinks or market share.
• External-evidence-needed rows cannot be used as outcome claims until reviewed private or external evidence is approved.
• The 500k/month objective remains unproven until reviewed analytics, Search Console, AI-citation and market-share evidence prove it.

Returns object · 5 readiness cohorts

Cohort-level execution scorecard tying the Visa Atlas 500k/month SEO/GEO plan to content pieces, page changes, technical gates, competitor wedges, private evidence needs, no-go conditions and pass criteria.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas SEO/GEO execution readiness scorecard",
  "summary": {
    "cohortCount": 5,
    "statusCounts": {"control-ready":3,"controlled-build":1,"external-evidence-needed":1},
    "lowMonthlyVisits": 390000,
    "highMonthlyVisits": 600000,
    "commandCount": 28
  },
  "rows": [
    {
      "id": "calculators-tools",
      "status": "control-ready",
      "targetMonthlyVisits": {"low":90000,"high":140000},
      "relatedOpportunityIds": ["calculator-verdict-history","uk-total-migration-cost-builder","germany-recognition-decision-tree"],
      "relatedBattlecardIds": ["uk-skilled-worker-cost-salary","canada-express-entry-freshness","germany-blue-card-salary-recognition"],
      "noGoConditions": ["If flagship calculator/tool pages stay below 0.5% CTR at stable rank after the first reviewed GSC experiment window, rebase the cohort target.","If calculator audits fail or source freshness goes red, freeze new calculator launches until provenance is restored."]
    }
  ]
}

• This endpoint is a readiness scorecard, not proof of current traffic, rankings, citations, backlinks or market share.
• Control-ready rows still require reviewed GSC, AI-citation, analytics or external evidence before outcome claims.
• Use it with /api/public/search-demand-actions when deciding whether to edit, route, noindex or measure a cohort.

Returns object · 13 battlecard capture rows

Battlecard-level execution plan tying competitor wedges to content pieces, page changes, technical changes, evidence commands, private evidence needs, market-share claim gates and no-go conditions.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas SEO/GEO market-share capture plan",
  "summary": {
    "battlecardCount": 13,
    "readyToExecuteCount": 11,
    "evidenceGatedCount": 2,
    "targetPageCount": 118,
    "targetPageReferenceCount": 124,
    "sitemapBackedTargetPageCount": 124,
    "missingTargetPageCount": 0,
    "productionTicketCount": 52,
    "publicMarketShareClaimAllowed": false
  },
  "rows": [
    {
      "id": "uk-skilled-worker-cost-salary-capture-plan",
      "runOrder": 1,
      "status": "ready-to-execute",
      "battlecardId": "uk-skilled-worker-cost-salary",
      "contentPieces": ["Battlecard answer shape: Table answer: application fee, IHS, maintenance/proof-of-funds, salary floor, ILR timing, source dates and calculator links.","Single first-answer block separating application fee, IHS, maintenance, salary floor and settlement timing."],
      "pageChanges": ["Tighten /calculators/uk-total-migration-cost, /cost-to-complete/uk-skilled-worker and /salary-thresholds/uk around the same short answer.","Add above-the-fold links from UK Skilled Worker route pages to the total-cost builder, fee page and salary page."],
      "targetPageCoverage": [{"targetPage":"/salary-thresholds/uk","basePath":"/salary-thresholds/uk","status":"sitemap-backed","cohort":"salary-threshold","indexableUrl":"https://visaatlas.org/salary-thresholds/uk","sourceDatasets":["/api/public/salary-thresholds"]},{"targetPage":"/visas/uk/skilled-worker","basePath":"/visas/uk/skilled-worker","status":"sitemap-backed","cohort":"visa-route","indexableUrl":"https://visaatlas.org/visas/uk/skilled-worker","sourceDatasets":["/api/public/visas","/api/public/destinations"]}],
      "marketShareClaimGate": "Blocked until an approved redacted snapshot rollup supplies dated counts, approvedForPublication=true, reviewedAt and reviewedBy.",
      "productionTickets": [{"battlecardId":"uk-skilled-worker-cost-salary","status":"ready-to-execute","targetPages":["/salary-thresholds/uk","/visas/uk/skilled-worker","/calculators/uk-skilled-worker","/cost-to-complete/uk-skilled-worker","/fees/uk/skilled-worker","/calculators/visa-fees","/cost-to-complete/uk-health-and-care-worker","/fees/uk/health-and-care-worker","/visas/uk/health-and-care-worker","/calculators/uk-ilr","/settlement/uk"],"sourceDatasets":["/api/public/competitor-query-battlecards","/api/public/battlecard-search-experiments","/api/public/search-demand-actions","/api/public/execution-readiness","/api/public/content-opportunities","/api/public/quarterly-market-share-summary","/api/public/serp-answer-surface-snapshots","/api/public/traffic-forecast","/api/public/technical-seo-controls","/api/public/visibility-metrics","/api/public/salary-thresholds","/api/public/policy-claims","/api/public/cost-to-complete","/api/public/fees","/api/public/visas","/api/public/source-transparency-benchmark","/api/public/citation-benchmark","/api/public/answer-capsules","/api/public/citation-packs","/api/public/calculator-verdict-contexts","/api/public/publisher-citation-kits","/api/public/external-repository-mirrors"],"id":"uk-skilled-worker-cost-salary-content-production","runOrder":11,"workstream":"content","ownerFunction":"Editorial","title":"UK Skilled Worker cost, IHS and salary floors capture plan: content production","task":"Battlecard answer shape: Table answer: application fee, IHS, maintenance/proof-of-funds, salary floor, ILR timing, source dates and calculator links. Single first-answer block separating application fee, IHS, maintenance, salary floor and settlement timing. Worked family-cost example that distinguishes money paid away from refundable or show-only funds. Citation-pack row for the UK Skilled Worker cost and salary answer used by AI retrievers.","dependencies":["/research/competitor-query-battlecards-2026#uk-skilled-worker-cost-salary","/research/seo-geo-content-opportunity-map-2026#uk-total-migration-cost-builder","/research/seo-geo-content-opportunity-map-2026#cost-to-complete-route-models","/research/seo-geo-content-opportunity-map-2026#verified-answer-capsule-index","/research/seo-geo-content-opportunity-map-2026#calculator-verdict-history","/research/seo-geo-content-opportunity-map-2026#high-risk-page-review-acquisition","/research/seo-geo-content-opportunity-map-2026#reviewedby-schema-rollout","/research/seo-geo-content-opportunity-map-2026#p0-reviewed-page-refresh-sprint","/research/seo-geo-content-opportunity-map-2026#reviewed-page-evidence-publication"],"localCommands":["npm run audit:content-opportunities","npm run audit:answer-capsules","npm run audit:rendered-seo"],"evidenceGate":"All short-answer, methodology, caveat and citation-pack copy must render in static HTML with source dates before release.","noGoCondition":"Do not merge IHS-exempt and non-exempt routes into one cost claim.","definitionOfDone":"Target pages expose the answer shape, source-backed facts, caveats, citation surfaces and internal links required by the battlecard."},{"battlecardId":"uk-skilled-worker-cost-salary","status":"ready-to-execute","targetPages":["/salary-thresholds/uk","/visas/uk/skilled-worker","/calculators/uk-skilled-worker","/cost-to-complete/uk-skilled-worker","/fees/uk/skilled-worker","/calculators/visa-fees","/cost-to-complete/uk-health-and-care-worker","/fees/uk/health-and-care-worker","/visas/uk/health-and-care-worker","/calculators/uk-ilr","/settlement/uk"],"sourceDatasets":["/api/public/competitor-query-battlecards","/api/public/battlecard-search-experiments","/api/public/search-demand-actions","/api/public/execution-readiness","/api/public/content-opportunities","/api/public/quarterly-market-share-summary","/api/public/serp-answer-surface-snapshots","/api/public/traffic-forecast","/api/public/technical-seo-controls","/api/public/visibility-metrics","/api/public/salary-thresholds","/api/public/policy-claims","/api/public/cost-to-complete","/api/public/fees","/api/public/visas","/api/public/source-transparency-benchmark","/api/public/citation-benchmark","/api/public/answer-capsules","/api/public/citation-packs","/api/public/calculator-verdict-contexts","/api/public/publisher-citation-kits","/api/public/external-repository-mirrors"],"id":"uk-skilled-worker-cost-salary-page-production","runOrder":12,"workstream":"page","ownerFunction":"Growth","title":"UK Skilled Worker cost, IHS and salary floors capture plan: page and crawl-path production","task":"Tighten /calculators/uk-total-migration-cost, /cost-to-complete/uk-skilled-worker and /salary-thresholds/uk around the same short answer. Add above-the-fold links from UK Skilled Worker route pages to the total-cost builder, fee page and salary page. Keep Health and Care Worker IHS exemption context visible where the query intent would otherwise collapse routes. Add or verify contextual internal link to /salary-thresholds/uk. Add or verify contextual internal link to /visas/uk/skilled-worker. Add or verify contextual internal link to /calculators/uk-skilled-worker. Add or verify contextual internal link to /cost-to-complete/uk-skilled-worker. Add or verify contextual internal link to /fees/uk/skilled-worker. Add or verify contextual internal link to /calculators/visa-fees.","dependencies":["/research/market-share-capture-plan-2026#uk-skilled-worker-cost-salary-capture-plan","/research/seo-geo-execution-readiness-scorecard-2026#calculators-tools","/research/seo-geo-execution-readiness-scorecard-2026#data-reference"],"localCommands":["npm run audit:topical-authority-map","npm run audit:indexable-page-manifest","npm run audit:longtail-provenance"],"evidenceGate":"Canonical target pages, internal links, indexability intent and crawl-path entry points must be visible in sitemap-backed rendered artifacts.","noGoCondition":"Do not publish a cost winner claim without source-linked current figures.","definitionOfDone":"Target pages are linked from the correct hubs, sitemap/indexable-page intent is coherent, and unsupported variants remain excluded."}]
    }
  ]
}

• This endpoint is an execution sequence, not proof of current rankings, traffic, citations, backlinks or market share.
• Every market-share claim remains blocked until approved redacted snapshot rollups and reviewed private evidence exist.
• Use it with competitor battlecards, execution readiness and search-demand actions when deciding which page work to run next.

Returns object · 52 production tickets

Flat ticket queue derived from the market-share capture plan. Use it when an editor, engineer, growth owner or AI agent needs the next executable content, page, technical or evidence task without traversing nested battlecard rows.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas SEO/GEO production queue",
  "summary": {
    "ticketCount": 52,
    "workstreamCounts": {"content":13,"page":13,"technical":13,"evidence":13},
    "ownerFunctionCounts": {"Editorial":13,"Engineering":13,"Data/research":13,"Growth":13},
    "publicMarketShareClaimAllowed": false
  },
  "tickets": [
    {
      "id": "uk-skilled-worker-cost-salary-content-production",
      "parentRowId": "uk-skilled-worker-cost-salary-capture-plan",
      "battlecardId": "uk-skilled-worker-cost-salary",
      "workstream": "content",
      "ownerFunction": "Editorial",
      "targetPages": ["/salary-thresholds/uk","/visas/uk/skilled-worker","/calculators/uk-skilled-worker"],
      "evidenceGate": "All short-answer, methodology, caveat and citation-pack copy must render in static HTML with source dates before release.",
      "definitionOfDone": "Target pages expose the answer shape, source-backed facts, caveats, citation surfaces and internal links required by the battlecard."
    }
  ]
}

• This endpoint is a production queue, not proof of current rankings, traffic, citations, backlinks or market share.
• Every ticket keeps parent battlecard context so AI agents can cite the source row and its private-evidence boundary.
• Use it with /api/public/market-share-capture-plan when deciding which ticket to execute next.

Returns object · 118 target URLs

Page-level join table derived from the production queue. Use it when an agent or auditor needs to know which target URL connects to which production tickets, battlecards, SERP/AI handoff briefs, search-demand actions, answer capsules, citation packs, calculator contexts, source datasets, commands and evidence gates.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas SEO/GEO page action map",
  "summary": {
    "pageCount": 118,
    "productionTicketReferenceCount": 496,
    "rowsWithAnswerCapsules": 115,
    "rowsWithCalculatorContexts": 9,
    "rowsWithSerpAiHandoffs": 118,
    "rowsNeedingAnswerSurface": 0,
    "publicMarketShareClaimAllowed": false
  },
  "rows": [
    {
      "path": "/salary-thresholds/uk",
      "battlecardIds": ["uk-skilled-worker-cost-salary"],
      "serpAiHandoff": {"primaryIntent":"cost","queryCluster":["UK Skilled Worker visa cost including IHS","UK Skilled Worker minimum salary 2026","Health and Care Worker IHS exemption"],"titleSnippetRule":"Lead the title, meta description and first visible answer with the cost answer for \"UK Skilled Worker visa cost including IHS\", then show the source date and canonical dataset link before broader guidance.","firstAnswerSource":"answer-capsule:salary-uk - What salary do you need for a skilled-work visa in United Kingdom?","answerSurfaceStatus":"answer-capsule","retrievalSurfaceUrls":["/salary-thresholds/uk","https://visaatlas.org/answer-capsules#salary-uk","https://visaatlas.org/salary-thresholds/uk","/api/public/answer-capsules","https://visaatlas.org/citation-packs#answer-capsule-salary-uk","/api/public/citation-packs"],"competitorWedge":"Separate money paid away from money shown, then connect the route cost, salary floor, IHS exemption and ILR timing in one source-backed answer path.","auditGate":"Run rendered SEO, answer-capsule/citation-pack or calculator-context audits, then require reviewed GSC or AI-citation evidence before claiming displacement.","noGoBoundary":"Do not claim rankings, traffic, AI citation share or market-share gains from this handoff without approved aggregate evidence."},
      "productionTickets": [{"id":"uk-skilled-worker-cost-salary-content-production","title":"UK Skilled Worker cost, IHS and salary floors capture plan: content production","battlecardId":"uk-skilled-worker-cost-salary","parentRowId":"uk-skilled-worker-cost-salary-capture-plan","workstream":"content","ownerFunction":"Editorial","status":"ready-to-execute","runOrder":11,"priority":"high","task":"Battlecard answer shape: Table answer: application fee, IHS, maintenance/proof-of-funds, salary floor, ILR timing, source dates and calculator links. Single first-answer block separating application fee, IHS, maintenance, salary floor and settlement timing. Worked family-cost example that distinguishes money paid away from refundable or show-only funds. Citation-pack row for the UK Skilled Worker cost and salary answer used by AI retrievers.","evidenceGate":"All short-answer, methodology, caveat and citation-pack copy must render in static HTML with source dates before release.","noGoCondition":"Do not merge IHS-exempt and non-exempt routes into one cost claim.","definitionOfDone":"Target pages expose the answer shape, source-backed facts, caveats, citation surfaces and internal links required by the battlecard."},{"id":"uk-skilled-worker-cost-salary-page-production","title":"UK Skilled Worker cost, IHS and salary floors capture plan: page and crawl-path production","battlecardId":"uk-skilled-worker-cost-salary","parentRowId":"uk-skilled-worker-cost-salary-capture-plan","workstream":"page","ownerFunction":"Growth","status":"ready-to-execute","runOrder":12,"priority":"high","task":"Tighten /calculators/uk-total-migration-cost, /cost-to-complete/uk-skilled-worker and /salary-thresholds/uk around the same short answer. Add above-the-fold links from UK Skilled Worker route pages to the total-cost builder, fee page and salary page. Keep Health and Care Worker IHS exemption context visible where the query intent would otherwise collapse routes. Add or verify contextual internal link to /salary-thresholds/uk. Add or verify contextual internal link to /visas/uk/skilled-worker. Add or verify contextual internal link to /calculators/uk-skilled-worker. Add or verify contextual internal link to /cost-to-complete/uk-skilled-worker. Add or verify contextual internal link to /fees/uk/skilled-worker. Add or verify contextual internal link to /calculators/visa-fees.","evidenceGate":"Canonical target pages, internal links, indexability intent and crawl-path entry points must be visible in sitemap-backed rendered artifacts.","noGoCondition":"Do not publish a cost winner claim without source-linked current figures.","definitionOfDone":"Target pages are linked from the correct hubs, sitemap/indexable-page intent is coherent, and unsupported variants remain excluded."}],
      "answerCapsules": ["salary-uk"],
      "localCommands": ["npm run audit:content-opportunities","npm run audit:answer-capsules"]
    }
  ]
}

• This endpoint is relationship metadata, not proof of current rankings, traffic, citations, backlinks or market share.
• Rows without answer capsules can still be valid when the related workstream is page, technical or evidence.
• Use it with /api/public/seo-geo-production-queue when selecting the next target URL to edit or audit.

Returns object · 13 battlecard rows

Battlecard-level SEO/GEO coverage matrix joining competitor query clusters to target pages, page-action rows, answer surfaces, citation packs, AI retrieval prompts, experiments, snapshot protocols, quarterly baselines and evidence gates. It reconciles public retrieval readiness without claiming rankings, traffic, AI citations or market share.

Fields

Example response

{
  "version": "2026-07-06",
  "name": "Visa Atlas battlecard retrieval coverage matrix",
  "datasetUrl": "/api/public/battlecard-retrieval-coverage",
  "humanUrl": "/research/battlecard-retrieval-coverage-matrix-2026",
  "summary": {
    "battlecardCount": 13,
    "publicRetrievalReadyCount": 11,
    "externalEvidenceNeededCount": 2,
    "assetGapCount": 0,
    "pageActionRowsWithCitationPacks": 118,
    "openAiRetrievalGapCount": 0,
    "publicMarketShareClaimAllowed": false
  },
  "rows": [
    {
      "battlecardId": "germany-blue-card-salary-recognition",
      "coverageStatus": "public-retrieval-ready",
      "coverageScore": 100,
      "coverage": {"targetPageCount":8,"pageActionRowCount":8,"readyToExecutePageCount":8,"evidenceGatedPageCount":0,"pagesWithAnswerCapsules":8,"pagesWithCitationPacks":8,"pagesWithCalculatorContexts":1,"pagesWithSerpAiHandoffs":8,"pagesNeedingAnswerSurface":0,"aiRetrievalTaskCount":3,"highPriorityAiRetrievalTaskCount":3,"retrievalReadyTaskCount":3,"openAiRetrievalGapCount":0,"productionTicketCount":44,"searchDemandActionCount":6,"citationQuestionCount":3,"sourceDatasetCount":37,"commandCount":27},
      "measurementSurfaceIds": {"experimentIds":["germany-blue-card-salary-recognition-gsc-experiment"],"snapshotProtocolIds":["germany-blue-card-salary-recognition-surface-snapshot"],"quarterlyBaselineIds":["germany-blue-card-salary-recognition-market-share-baseline"]}
    }
  ]
}

• Use this endpoint after /api/public/seo-geo-page-action-map when deciding whether a whole battlecard cluster is retrieval-ready.
• Rows marked external-evidence-needed have public retrieval assets but still require approved external or aggregate evidence before outcome claims.
• This endpoint does not prove rankings, traffic, backlinks, AI citation share, market share or the 500k/month planning target.

Returns object · 13 battlecard rows

Battlecard-level blocker ledger joining public retrieval coverage, content pieces, page changes, technical work, competitor pressure, reviewer queues, authority distribution and outcome-proof gates for the 500k/month SEO/GEO plan.

Fields

Example response

{
  "version": "2026-07-06",
  "name": "Visa Atlas SEO/GEO dominance gap ledger",
  "datasetUrl": "/api/public/seo-geo-dominance-gap-ledger",
  "humanUrl": "/research/seo-geo-dominance-gap-ledger-2026",
  "summary": {
    "battlecardCount": 13,
    "readyForPrivateMeasurementCount": 3,
    "reviewerEvidenceNeededCount": 8,
    "externalEvidenceNeededCount": 2,
    "approvedSnapshotCount": 0,
    "publicTrafficOutcomeClaimAllowed": false,
    "publicMarketShareClaimAllowed": false
  },
  "rows": [
    {
      "battlecardId": "uk-skilled-worker-cost-salary",
      "dominanceGapStatus": "reviewer-evidence-needed",
      "publicRetrievalCoverage": {"coverageScore":100,"pageActionRowCount":11,"aiRetrievalTaskCount":4,"openAiRetrievalGapCount":0,"experimentCount":1,"snapshotProtocolCount":1,"quarterlyBaselineCount":1},
      "reviewerQueues": [{"id":"uk-skilled-worker-yml-review","title":"UK Skilled Worker eligibility, salary and total-cost review","priority":"p0","status":"awaiting-credentialed-review","pageTargets":["/visas/uk/skilled-worker","/calculators/uk-skilled-worker","/calculators/uk-total-migration-cost","/cost-to-complete/uk-skilled-worker"]}]
    }
  ]
}

• Use this endpoint after retrieval coverage when deciding which blocker prevents a battlecard from supporting dominance claims.
• ready-for-private-measurement is not an outcome claim; it means the public controls are ready for private GSC, SERP, AI and analytics evidence workflows.
• This endpoint does not prove rankings, traffic, AI citations, backlinks, market share or the 500k/month target.

Returns object · 13 measurement runs

Battlecard-level measurement run queue that turns dominance blockers into private GSC, SERP/AI, reviewer, authority, AI-visibility, market-share and traffic-outcome evidence runs without publishing raw private evidence.

Fields

Example response

{
  "version": "2026-07-06",
  "name": "Visa Atlas SEO/GEO measurement run queue",
  "datasetUrl": "/api/public/seo-geo-measurement-run-queue",
  "humanUrl": "/research/seo-geo-measurement-run-queue-2026",
  "summary": {
    "runCount": 13,
    "runNowPhaseCount": 39,
    "reviewerEvidenceBlockedCount": 8,
    "externalEvidenceBlockedCount": 2,
    "finalOutcomeGateCount": 26,
    "priorityActionCount": 26,
    "publicTrafficOutcomeClaimAllowed": false,
    "publicMarketShareClaimAllowed": false
  },
  "priorityBrief": {
    "actionCount": 26,
    "topActionCount": 12,
    "topActions": [
      {
        "rank": 1,
        "battlecardId": "uk-skilled-worker-cost-salary",
        "phaseId": "reviewer-proof",
        "runClass": "run-now"
      }
    ]
  },
  "rows": [
    {
      "battlecardId": "uk-skilled-worker-cost-salary",
      "measurementStatus": "reviewer-evidence-blocked",
      "firstRunnablePhaseIds": ["public-control-check","reviewer-proof"],
      "blockedBy": ["reviewer queue: uk-skilled-worker-yml-review"]
    }
  ]
}

• Use this endpoint after the dominance gap ledger when deciding which private measurement or proof workflow to run next.
• Run-now phases can still be blocked from public outcome claims until the final approval gates pass.
• This endpoint does not prove rankings, traffic, AI citations, backlinks, reviewer trust, market share or the 500k/month target.

Returns object · 6 reviewer queues and 8 reviewer-blocked battlecards

Public bridge from reviewer-blocked SEO/GEO battlecards to high-risk reviewer queues, acquisition controls, reviewedBy schema gates, P0 page-refresh controls and local reviewer-proof commands.

Fields

Example response

{
  "version": "2026-07-07",
  "name": "Visa Atlas SEO/GEO reviewer evidence bridge",
  "datasetUrl": "/api/public/seo-geo-reviewer-evidence-bridge",
  "humanUrl": "/research/seo-geo-reviewer-evidence-bridge-2026",
  "summary": {
    "reviewerBlockedBattlecardCount": 8,
    "reviewerQueueCount": 6,
    "p0ReviewerQueueCount": 3,
    "publicReviewerTrustClaimAllowed": false,
    "publicReviewedBySchemaClaimAllowed": false,
    "publicTrafficOutcomeClaimAllowed": false,
    "publicMarketShareClaimAllowed": false
  },
  "reviewerQueues": [
    {
      "id": "uk-skilled-worker-yml-review-reviewer-evidence-bridge",
      "status": "blocked-pending-reviewer-evidence",
      "battlecardIds": ["uk-skilled-worker-cost-salary"],
      "publicationGate": {
        "publicReviewerTrustClaimAllowed": false,
        "publicReviewedBySchemaClaimAllowed": false
      }
    }
  ],
  "pageHandoffs": [
    {
      "path": "/visas/uk/skilled-worker",
      "p0ReviewStatusSurface": true
    }
  ]
}

• Use this endpoint after the measurement run queue when a battlecard is reviewer-evidence-blocked.
• The bridge joins public controls and local command requirements; it is not evidence that reviewer trust or reviewedBy schema has been approved.
• Raw reviewer notes, private contacts, credential screenshots, Search Console exports, screenshots, transcripts and analytics stay local unless reviewed, redacted and aggregated.

Returns object · 2 external-evidence battlecards and 6 authority channels

Public bridge from external-evidence-blocked SEO/GEO battlecards to authority distribution channels, GSC/SERP/AI evidence workflows, market-share baselines, traffic proof gates and local proof commands.

Fields

Example response

{
  "version": "2026-07-07",
  "name": "Visa Atlas SEO/GEO external evidence bridge",
  "datasetUrl": "/api/public/seo-geo-external-evidence-bridge",
  "humanUrl": "/research/seo-geo-external-evidence-bridge-2026",
  "summary": {
    "externalEvidenceBattlecardCount": 2,
    "authorityChannelCount": 6,
    "approvedSnapshotCount": 0,
    "publicAuthorityClaimAllowed": false,
    "publicMarketShareClaimAllowed": false,
    "publicAiVisibilityClaimAllowed": false,
    "publicTrafficOutcomeClaimAllowed": false
  },
  "battlecards": [
    {
      "id": "digital-nomad-europe-costs-external-evidence-bridge",
      "status": "blocked-pending-external-evidence",
      "battlecardId": "digital-nomad-europe-costs",
      "runNowPhaseIds": ["public-control-check","authority-proof","gsc-experiment","serp-ai-snapshot"]
    }
  ],
  "authorityChannels": [
    {
      "id": "official-mcp-registry-external-evidence-bridge",
      "status": "manual-publication-ready",
      "publicationGate": {
        "publicAuthorityClaimAllowed": false,
        "publicBacklinkClaimAllowed": false
      }
    }
  ]
}

• Use this endpoint after the measurement run queue when a battlecard is external-evidence-blocked.
• The bridge joins public controls and local command requirements; it is not evidence that authority, backlinks, market share, AI visibility or traffic have been approved.
• Raw analytics, Search Console exports, private listing URLs, SERP screenshots, AI transcripts and unapproved rollups stay local unless reviewed, redacted and aggregated.

Returns object · 3 ready battlecards and 21 measurement phase rows

Public bridge from ready-for-private-measurement SEO/GEO battlecards to run-now GSC, SERP/AI, authority, market-share, AI-visibility and traffic proof workflows without exposing raw private evidence.

Fields

Example response

{
  "version": "2026-07-07",
  "name": "Visa Atlas SEO/GEO private measurement bridge",
  "datasetUrl": "/api/public/seo-geo-private-measurement-bridge",
  "humanUrl": "/research/seo-geo-private-measurement-bridge-2026",
  "summary": {
    "readyForPrivateMeasurementBattlecardCount": 3,
    "runNowPhaseCount": 15,
    "finalOutcomeGateCount": 6,
    "approvedSnapshotCount": 0,
    "publicRankingClaimAllowed": false,
    "publicMarketShareClaimAllowed": false,
    "publicAiVisibilityClaimAllowed": false,
    "publicTrafficOutcomeClaimAllowed": false,
    "public500kMonthClaimAllowed": false
  },
  "battlecards": [
    {
      "id": "uk-global-talent-eligibility-private-measurement-bridge",
      "status": "ready-for-private-measurement",
      "battlecardId": "uk-global-talent-eligibility",
      "runNowPhaseIds": ["public-control-check","authority-proof","gsc-experiment","serp-ai-snapshot","quarterly-market-share-rollup"]
    }
  ],
  "phaseRuns": [
    {
      "id": "uk-global-talent-eligibility-public-control-check-private-measurement-bridge",
      "phaseId": "public-control-check",
      "runClass": "run-now",
      "publicationGate": {
        "publicPhaseOutcomeClaimAllowed": false,
        "publicAggregatePublicationAllowed": false
      }
    }
  ]
}

• Use this endpoint after the measurement run queue when a battlecard is ready-for-private-measurement.
• The bridge joins public controls and local command requirements; it is not evidence that ranking, AI visibility, market share or traffic outcomes have been approved.
• Raw analytics, Search Console exports, SERP screenshots, AI transcripts, authority account evidence and unapproved rollups stay local unless reviewed, redacted and aggregated.

Returns object · 8 gate checks

Audit-ready release gate for shipping Visa Atlas SEO/GEO changes: compile, source audits, freshness, optional liveness, production build, rendered crawler output, evidence proof checks and outcome-claim boundaries.

Fields

Example response

{
  "version": "2026-07-07",
  "name": "Visa Atlas SEO/GEO release gate contract",
  "datasetUrl": "/api/public/seo-geo-release-gate",
  "humanUrl": "/research/seo-geo-release-gate-contract-2026",
  "summary": {
    "stepCount": 8,
    "requiredStepCount": 7,
    "optionalNetworkStepCount": 1,
    "blocksPublicOutcomeClaims": true,
    "planningTargetMonthlyVisits": 500000
  },
  "steps": [
    {
      "id": "typescript-compile",
      "label": "TypeScript app/runtime compile",
      "status": "required",
      "command": "npm run typecheck"
    }
  ]
}

• Use this endpoint before deployment sign-off to inspect exactly what the SEO/GEO release gate proves and blocks.
• Run npm run audit:seo-geo locally for deterministic release checks; add -- --include-liveness for source-refresh or release sign-off requiring live government-source probes.
• This endpoint publishes deploy governance, not proof of rankings, traffic, backlinks, AI citations, market share or the 500k/month planning target.

Returns object · 7 action rules

Audit-ready decision matrix for turning local GSC, SERP and AI answer-surface evidence into content, page and technical SEO/GEO actions without publishing private query data.

Fields

Example response

{
  "version": "2026-07-04",
  "name": "Visa Atlas search demand action map",
  "summary": {
    "actionCount": 7,
    "criticalCount": 4,
    "commandCount": 20,
    "noCreateRuleCount": 15
  },
  "actions": [
    {
      "id": "high-impression-low-ctr-snippet-refresh",
      "actionType": "title-snippet-answer-refresh",
      "priority": "critical",
      "localCommands": ["npm run seo:gsc-opportunities -- gsc-queries.csv --json --period-start=YYYY-MM-DD --period-end=YYYY-MM-DD --property-label=gsc-domain-redacted --search-type=web","npm run seo:gsc-battlecard-experiments -- gsc-queries.csv --json --period-start=YYYY-MM-DD --period-end=YYYY-MM-DD --property-label=gsc-domain-redacted --search-type=web"],
      "noCreateRules": ["Do not create a new page for a low-CTR query when an existing canonical page can answer it."]
    }
  ]
}

• This endpoint publishes action rules, not private Search Console rows or analytics evidence.
• A query opportunity does not justify a new page unless source-backed uniqueness, crawl path and maintenance ownership are proven.
• The action map does not guarantee rankings, traffic, AI citations or market-share gains.

Returns object · 25 crawler policy rows

Public audit of the robots policy, AI/search crawler access rules, crawler-facing discovery surfaces, API Link headers and local server-log proof commands. It proves access intent and discovery wiring without claiming live crawler fetches, citations or rankings.

Fields

Example response

{
  "version": "2026-07-03",
  "name": "Visa Atlas crawler and AI retrieval access audit",
  "datasetUrl": "https://visaatlas.org/api/public/crawler-access",
  "humanUrl": "https://visaatlas.org/research/crawler-ai-retrieval-access-audit-2026",
  "summary": {
    "explicitAllowCount": 13,
    "inheritedAllowCount": 4,
    "deniedCrawlerCount": 8,
    "technicalCheckCount": 8,
    "identityVerificationSourceCount": 7,
    "officialIpRangeSourceCount": 5
  },
  "crawlerPolicies": [
    {
      "userAgent": "GPTBot",
      "accessPolicy": "explicit-allow",
      "robotsDirective": "allow",
      "evidenceSurfaces": ["/robots.txt","/api/public/crawler-access","/research/crawler-ai-retrieval-access-audit-2026"]
    }
  ],
  "identityVerificationSources": [
    {
      "userAgents": ["GPTBot"],
      "verificationMethod": "ip-range-json",
      "ipRangeUrls": ["https://openai.com/gptbot.json"]
    }
  ]
}

• Allowed in robots.txt is not a ranking, indexing, citation or traffic guarantee.
• A user-agent string alone is not verified fetch proof; use official IP range JSON or reverse/forward DNS checks where available.
• Raw server logs, Search Console exports and unpublished referral evidence remain local.
• Use npm run seo:botlog -- logs.txt --json to classify live crawler hits from a server log export.

Returns object · 1674 dated records checked

Public source-freshness report for YMYL auditability: every dated record is evaluated against the same SLA tiers used by the internal stale-source tripwire.

Fields

Example response

{
  "asOf": "2026-07-17",
  "totals": {
    "checkedItems": 1674,
    "fresh": 1621,
    "dueSoon": 0,
    "stale": 53,
    "invalidDates": 0
  },
  "summaries": [
    {
      "tier": "processing-times",
      "thresholdDays": 45,
      "total": 98,
      "stale": 53
    }
  ],
  "stale": []
}

• The same report powers /freshness and npm run audit:stale, so the public dashboard and internal alerting share one SLA model.
• A stale record does not mean the underlying government fact is wrong; it means the Visa Atlas review date has exceeded the public SLA.

Returns object · 98 scored processing clocks

Derived index scoring how usable each official processing-time clock is for planning. The score rewards a published clock, a narrow decision window, percentile disclosure and recent source verification; it does not predict individual case outcomes.

Fields

Example response

{
  "version": "2026-07-01",
  "name": "Visa Atlas processing-time planning reliability index",
  "sourceDataset": "/api/public/processing-times",
  "summary": {
    "count": 98,
    "scoreAverage": 66.4,
    "notPublishedCount": 8,
    "percentileCount": 6
  },
  "rows": [
    {
      "id": "au-subclass-482-tss",
      "decisionWindow": "2 weeks – 8 weeks",
      "score": 90,
      "grade": "strong",
      "scoreBreakdown": {
        "officialClock": 40,
        "windowWidth": 20,
        "percentileDisclosure": 15,
        "freshness": 15
      }
    }
  ]
}

• A high score means the published clock is more usable for planning; it is not a guarantee that a case will be decided by that date.
• Opaque routes can still be valid routes; the score only reflects published planning transparency.

Returns object · 30 scored migration routes

Derived index scoring tracked skilled and skilled-adjacent routes by planning accessibility. The score combines applicant cost, proof-of-funds exposure, salary floor, processing-clock transparency, sponsor requirement, settlement path and source freshness; it is not a route recommendation or outcome prediction.

Fields

Example response

{
  "version": "2026-07-01",
  "name": "Visa Atlas skilled-migration planning accessibility index",
  "sourceDatasets": [
    "/api/public/cost-to-complete",
    "/api/public/processing-reliability",
    "/api/public/salary-thresholds",
    "/api/public/visas"
  ],
  "summary": {
    "count": 30,
    "averageScore": 67.1,
    "unsponsoredCount": 11,
    "settlementPathCount": 24
  },
  "rows": [
    {
      "id": "de-chancenkarte",
      "score": 89,
      "grade": "more-accessible",
      "routePath": "/visas/germany/chancenkarte",
      "costPath": "/cost-to-complete/germany-chancenkarte",
      "sunkCost": {
        "approxUsdLabel": "$628-$1,270"
      },
      "scoreBreakdown": {
        "sunkCost": 17,
        "refundableFunds": 12,
        "salaryFloor": 15,
        "processingReliability": 15,
        "sponsorFlexibility": 15,
        "settlementPath": 10,
        "sourceFreshness": 5
      }
    }
  ]
}

• A high score means lower planning friction in the tracked dimensions; it is not legal advice and not a prediction of eligibility, timing or outcome.
• Use the row sourceUrls and sourceDatasets fields to cite the underlying facts behind each score.

Returns object · 3192 indexed comparison pairs

Derived inventory of indexable country comparison pages. It exposes destination profiles and pair-level metrics for route count, sponsor flexibility, settlement routes, dominant skilled routes, salary floors, processing clocks, tracked sunk cost and recent policy activity.

Fields

Example response

{
  "version": "2026-07-01",
  "name": "Visa Atlas country comparison data",
  "sourceDatasets": [
    "/api/public/visas",
    "/api/public/destinations",
    "/api/public/salary-thresholds",
    "/api/public/processing-times",
    "/api/public/cost-to-complete",
    "/api/public/skilled-migration-accessibility",
    "/api/public/policy-updates"
  ],
  "summary": {
    "destinationCount": 178,
    "pairCount": 3192,
    "editorialPairCount": 20
  },
  "pairs": [
    {
      "id": "al-vs-au",
      "path": "/compare/albania/vs/australia",
      "hasEditorialNote": false,
      "metrics": [
        {
          "metric": "trackedRoutes",
          "a": 6,
          "b": 9
        }
      ]
    }
  ]
}

• Use pairs[].path when citing the human comparison page and sourceUrls/sourceDatasets when citing the underlying facts.
• This endpoint mirrors the rendered /compare index gate; it is not a personalised immigration recommendation.

Returns array<object> · 37 fee breakdowns

Government-published fee breakdowns by destination and visa route — every line item with its amount and currency, a worked example for the headline case, and guidance on dependants and volatility.

Fields

Example response

[
  {
    "destinationIso": "uk",
    "visaSlug": "skilled-worker",
    "lines": [
      { "label": "Application fee (up to 3 years, outside UK, general)", "amountLocal": 819, "currency": "GBP", "mandatory": true, "sourceUrl": "https://www.gov.uk/skilled-worker-visa/how-much-it-costs" },
      { "label": "Immigration Health Surcharge (IHS)", "amountLocal": 1035, "currency": "GBP", "per": "per year of leave, per person", "mandatory": true, "note": "Reduced to £776/year for students and under-18s." }
    ],
    "workedExample": {
      "label": "Single applicant, 3-year CoS, general rate, no priority",
      "totalLocal": 3943.2,
      "currency": "GBP",
      "breakdown": ["£819 application fee", "£3,105 IHS (£1,035 × 3 years)", "£19.20 biometrics", "Plus £525 CoS fee (typically borne by the sponsor)"]
    },
    "dependantFees": { "perDependant": "Each dependant pays the same application fee plus their own IHS…" },
    "summary": "The UK Skilled Worker visa costs around £3,950 in government fees…",
    "volatility": "IHS rose 66% on 6 February 2024 and remains £1,035/year…",
    "sourceName": "GOV.UK — Skilled Worker visa: how much it costs",
    "sourceUrl": "https://www.gov.uk/skilled-worker-visa/how-much-it-costs",
    "lastChecked": "2026-05-31"
  }
]

• Amounts are exact local-currency figures; we do not convert between currencies in this dataset.
• A line with mandatory:false is optional or conditional — read its note before adding it to a total.

Returns array<object> · 30 route cost models

All-in route cost models that separate non-refundable sunk costs from refundable proof-of-funds requirements. Use this when the question is "what do I actually need to budget?", not just "what is the government visa fee?".

Fields

Example response

[
  {
    "routeKey": "de-chancenkarte",
    "pageSlug": "germany-chancenkarte",
    "destinationIso": "de",
    "visaSlug": "chancenkarte",
    "title": "Germany Chancenkarte - total cost to complete",
    "lines": [
      { "label": "Consular visa application fee", "amountLocal": 75, "currency": "EUR", "kind": "government-fee", "refundable": false, "mandatory": true },
      { "label": "Blocked account funding", "amountLocal": 13092, "currency": "EUR", "kind": "proof-of-funds", "refundable": true, "mandatory": true }
    ],
    "methodologyNote": "Sunk-cost range sums every mandatory, non-refundable line...",
    "lastChecked": "2026-06-22"
  }
]

• Do not add refundable proof-of-funds lines to non-refundable sunk-cost totals.
• Indicative lines should be quoted as ranges or caveats, not exact government tariffs.

Returns array<object> · 21 destination blocks · 61 thresholds

Minimum-salary floors by destination, grouped into one block per destination. Each block holds the individual route thresholds with their local-currency amount, basis and effective date.

Fields

Example response

[
  {
    "destinationIso": "uk",
    "overview": "The UK Home Office sets separate salary floors for variants of the Skilled Worker route…",
    "thresholds": [
      {
        "routeLabel": "Skilled Worker — general threshold",
        "visaSlug": "skilled-worker",
        "amountLocal": 41700,
        "currency": "GBP",
        "basis": "annual",
        "approxUsd": 49000,
        "description": "The default minimum salary, raised to £41,700 on 22 July 2025…",
        "effectiveFrom": "2025-07-22",
        "sourceUrl": "https://www.gov.uk/guidance/immigration-rules/immigration-rules-appendix-skilled-worker",
        "sourceName": "GOV.UK — Appendix Skilled Worker"
      }
    ],
    "volatility": "The general rate rose from £26,200 to £38,700 in April 2024, then to £41,700 on 22 July 2025…",
    "lastChecked": "2026-05-30"
  }
]

• approxUsd is a rounded comparison figure only — for the real requirement always use amountLocal + currency. If amountLocal is 0, do not read it as a zero salary requirement; the route uses a no-fixed-floor pay test described in the row.

Returns array<object> · 98 bands

Typical decision-time bands by destination and visa route, taken from each authority where it publishes one. Where no central decision time exists, the band is flagged rather than guessed.

Fields

Example response

[
  {
    "destinationIso": "uk",
    "visaSlug": "skilled-worker",
    "typicalMinDays": 15,
    "typicalMaxDays": 21,
    "summary": "GOV.UK publishes 3 weeks as the typical decision window for applications made outside the UK.",
    "note": "Priority service aims for 5 working days; super-priority next working day…",
    "sourceName": "GOV.UK — Visa decision waiting times",
    "sourceUrl": "https://www.gov.uk/guidance/visa-decision-waiting-times-applications-outside-the-uk",
    "lastChecked": "2026-04-20"
  },
  {
    "destinationIso": "ie",
    "visaSlug": "stamp-4",
    "notPublished": true,
    "summary": "Stamp 4 is granted on arrival or at registration; there is no separate consular decision period.",
    "guidance": "Check the specific pathway for the permission rules that apply.",
    "sourceName": "Irish Immigration Service — Registration Office",
    "sourceUrl": "https://www.irishimmigration.ie/registering-your-immigration-permission/",
    "lastChecked": "2026-04-20"
  }
]

• These are decision windows, not end-to-end timelines — appointment, skills-assessment and card-issuance steps often dwarf the decision itself.

Returns object · 10 current categories

A derived 2026 category-based selection tracker over the official Express Entry draw history and IRCC current category guidance. Use it when you need category status, category CRS ranges, categories that have not drawn yet, and program rounds kept separate from category rounds.

Fields

Example response

{
  "version": "2026-07-15",
  "name": "Visa Atlas Canada Express Entry category tracker",
  "sourceDatasets": ["/api/public/express-entry-draws"],
  "summary": {
    "categoryCount": 10,
    "categoriesDrawn": 5,
    "categoriesNotDrawn": 5,
    "latestCategoryDraw": {"round":426,"date":"2026-07-10","category":"Senior managers","invitations":500,"crsCutoff":392}
  },
  "rows": [
    {
      "category": "Healthcare and social services",
      "officialLabel": "Healthcare and social services occupations",
      "drawnThisYear": true,
      "roundsThisYear": 2,
      "invitationsThisYear": 8000,
      "minCrsThisYear": 467,
      "maxCrsThisYear": 475,
      "latestDraw": {"round":422,"date":"2026-06-25","category":"Healthcare and social services","invitations":4000,"crsCutoff":475,"daysSinceDraw":20,"crsChangeFromPreviousCategoryDraw":8}
    }
  ]
}

• Rows with drawnThisYear=false are intentionally present: no-draw categories are useful evidence for category-specific queries.
• A category CRS cut-off is a historical result for one round, not a target score or invitation guarantee.

Returns object · 41 rounds

The round-by-round history of Canada Express Entry invitations, confirmed against IRCC’s official feed and refreshed weekly. Unlike the other endpoints this returns an object with provenance at the top and the draws array underneath.

Fields

Example response

{
  "officialSource": {
    "label": "IRCC — Express Entry rounds of invitations",
    "url": "https://www.canada.ca/en/immigration-refugees-citizenship/services/immigrate-canada/express-entry/submit-profile/rounds-invitations.html",
    "authority": "Immigration, Refugees and Citizenship Canada"
  },
  "lastVerified": "2026-07-15",
  "draws": [
    { "round": 426, "date": "2026-07-10", "category": "Senior managers", "invitations": 500, "crsCutoff": 392 }
  ]
}

• A CRS cut-off is a per-round result, not a target — category draws can post far lower cut-offs than program draws because the eligible pool is smaller.

Returns object · 7 recorded movements

Machine-readable diff feed for tracked fees, salary thresholds and processing-time facts. Each change carries a stable fact ID, old value, new value, effective date, current owning route and primary source.

Fields

Example response

{
  "lastModified": "2026-03-01",
  "count": 7,
  "changes": [
    {
      "changeId": "salary:ie:critical-skills-employment-permit-general-floor@2026-03-01",
      "factId": "salary:ie:critical-skills-employment-permit-general-floor",
      "kind": "salary-threshold",
      "label": "Critical Skills Employment Permit - general floor salary floor",
      "jurisdiction": "Republic of Ireland",
      "owningRoute": "/salary-thresholds/ireland",
      "from": "38000 EUR (annual)",
      "to": "40904 EUR (annual)",
      "changedOn": "2026-03-01",
      "sourceName": "DETE - Critical Skills Employment Permit",
      "sourceUrl": "https://enterprise.gov.ie/en/what-we-do/workplace-and-skills/employment-permits/permit-types/critical-skills-employment-permit/",
      "currentValue": "40904 EUR (annual)",
      "currentAsOf": "2026-03-01"
    }
  ]
}

• Use changeId for de-duplication. Use owningRoute for the human-readable current figure and sourceUrl for the issuing authority.

Returns object · 5 months with recorded movements

Derived month-by-month archive of recorded fee, salary-threshold and processing-time movements. It groups /api/public/fact-changes by changedOn month and adds same-month policy-update context; policy rows are not counted as figure movements.

Fields

Example response

{
  "version": "2026-07-01",
  "name": "Visa Atlas monthly immigration figure changes",
  "sourceDatasets": ["/api/public/fact-changes", "/api/public/policy-updates"],
  "summary": {
    "changeCount": 7,
    "monthCount": 5,
    "latestChangeMonthLabel": "March 2026"
  },
  "months": [
    {
      "month": "2026-03",
      "label": "March 2026",
      "changeCount": 1,
      "changes": [
        {
          "changeId": "salary:ie:critical-skills-employment-permit-general-floor@2026-03-01",
          "from": "38000 EUR (annual)",
          "to": "40904 EUR (annual)",
          "detailPath": "/changelog#change-salary-ie-critical-skills-employment-permit-general-floor-2026-03-01"
        }
      ]
    }
  ]
}

• Months with no recorded old-to-new figure movement are omitted from months[].
• Use /api/public/fact-changes for the canonical movement records and this endpoint when you need calendar-month grouping.