Job Feed Specifications & ATS API Documentation
Technical guide for ATS developers, job board publishers, and engineering partners syndicating international job postings to VISA HR GLOBAL (https://visahr.in).
Download our reference XML, JSON, and RSS templates to test feed validation before publishing:
1 XML Feed Specification
Our XML parser adheres to standard job board schemas. We support custom root tags (e.g. <jobs>, <source>) and item elements (<job>, <position>).
<?xml version="1.0" encoding="UTF-8"?>
<source>
<publisher>Global Career Network</publisher>
<publisherurl>https://example.com</publisherurl>
<lastBuildDate>2026-03-30T10:00:00Z</lastBuildDate>
<job>
<title><![CDATA[Senior Structural Engineer (Offshore)]]></title>
<date>2026-03-30T09:30:00Z</date>
<referencenumber>JOB-UAE-2026-01</referencenumber>
<url><![CDATA[https://example.com/apply/job-uae-01]]></url>
<company><![CDATA[Al-Futtaim Engineering]]></company>
<city>Dubai</city>
<country>United Arab Emirates</country>
<description><![CDATA[<p>Looking for experienced offshore structural engineer...</p>]]></description>
<salary><![CDATA[AED 22,000 - 28,000 / month]]></salary>
<category>Engineering & Technical</category>
<visasponsorship>1</visasponsorship>
<accommodation>1</accommodation>
<transportation>1</transportation>
<airticket>Annual round-trip air ticket provided</airticket>
</job>
</source>
2 JSON Feed Specification
JSON feeds may provide an array at the root or under an object key like jobs, data, or vacancies.
{
"publisher": "Gulf Careers ATS",
"generated_at": "2026-03-30T10:00:00Z",
"jobs": [
{
"id": "GC-8831",
"title": "Hospital Registered Nurse (ICU)",
"company": "King Faisal Specialist Hospital",
"country": "Saudi Arabia",
"city": "Riyadh",
"employment_type": "full_time",
"salary": "SAR 14,000 - 18,000",
"description": "Registered nurses needed with min 3 years ICU experience. Full Saudi employment visa sponsored.",
"application_url": "https://example.com/jobs/gc-8831?utm_source=visahr",
"visa_sponsorship": true,
"benefits": {
"accommodation": true,
"flight_allowance": true,
"medical_insurance": true
}
}
]
}
3 Schema.org JobPosting JSON-LD Ingestion
If your career site renders Google-compliant JobPosting structured data, Visa HR Global can discover and parse listings directly from your accessible HTML web pages:
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "JobPosting",
"title": "Cloud DevOps Engineer (Terraform / AWS)",
"description": "<p>Lead international cloud migrations in Frankfurt, Germany...</p>",
"datePosted": "2026-03-25",
"validThrough": "2026-06-30",
"employmentType": "FULL_TIME",
"hiringOrganization": {
"@type": "Organization",
"name": "FinTech Global AG",
"sameAs": "https://example.de"
},
"jobLocation": {
"@type": "Place",
"address": {
"@type": "PostalAddress",
"addressLocality": "Frankfurt",
"addressCountry": "DE"
}
},
"baseSalary": {
"@type": "MonetaryAmount",
"currency": "EUR",
"value": {
"@type": "QuantitativeValue",
"minValue": 75000,
"maxValue": 90000,
"unitText": "YEAR"
}
}
}
</script>
4 Inbound ATS REST APIs & Webhooks
Authorized partners can syndicate vacancies, execute bulk ingestions, update live postings, and receive event callbacks via our high-speed RESTful gateway.
X-ATS-Key: <API_KEY> or Authorization: Bearer <TOKEN>application/json (UTF-8 encoded){
"title": "Lead Piping & Pipeline Commissioning Engineer",
"company_name": "Aramco Overseas Contractor",
"source_job_id": "ATS-KSA-9081",
"country": "Saudi Arabia",
"city": "Dammam",
"category": "Engineering & Construction",
"salary_min": 18000,
"salary_max": 24000,
"salary_currency": "SAR",
"employment_type": "full_time",
"visa_sponsorship": true,
"application_url": "https://partner-ats.com/apply/ksa-9081",
"description": "Commissioning offshore gas pipelines and sour service processing units..."
}
{
"jobs": [
{ "title": "Civil Structural Lead", "company": "Petrofac", "country": "UAE", "application_url": "https://..." },
{ "title": "ICU Senior Nurse", "company": "Cleveland Clinic Abu Dhabi", "country": "UAE", "application_url": "https://..." }
]
}
Update salary, description, title, or visa attributes of an existing posting in-place.
Close and immediately expire a filled or cancelled vacancy across Visa HR Global.
5 Outbound Job Access APIs
Syndication partners and authorized mobile applications can retrieve active published jobs programmatically:
country=UAEcategory=engineeringvisa_sponsorship=1search=pipeper_page=50page=15 Canonical Field Mapping Reference
The Visa HR Global Field Mapping Engine automatically normalizes various common publisher field names to our internal canonical schema:
| Canonical Field | Allowed Publisher Aliases | Type | Description |
|---|---|---|---|
| title | title, job_title, position, role | String (100) | Clear job position headline |
| company | company, employer, company_name, hiringOrganization | String (150) | Hiring employer or agency name |
| description | description, job_description, details, body | HTML / Text | Sanitized job responsibilities and requirements |
| country | country, country_name, jobLocation, nation | String / ISO-2 | Resolved against our global countries registry |
| city | city, location, addressLocality | String (100) | Destination employment city |
| apply_url | url, apply_url, link, application_url | URL | Target application URL for candidate redirect |
| visa_sponsorship | visa, visa_sponsorship, visa_sponsored | Boolean / 1,0 | Highlights job to Indian overseas jobseekers |
Visa HR Global Outbound Job Feeds
Partner aggregators may also ingest our machine-readable public outbound job feeds: