Propellum Job Wrapping API

1. Overview

Propellum Job Wrapping API enables job boards and partner platforms to ingest, normalize, synchronize, and distribute jobs from employer career sites, ATS platforms, and structured feeds.

Supported Integration Methods

XML / CSV Feed Ingestion
JSON API Ingestion
Career Site Job Wrapping
Delta Update Synchronization

2. Integration Architecture

Input Layer

Source Sites / ATS / Feeds

Processing Layer

Propellum Wrapping Engine

Parsing + Mapping + Validation

Delivery Layer

API / Feed Delivery

Final Destination

Partner Job Board

Core Functions

Job extraction
Schema normalization
Duplicate detection
Apply link validation
Scheduled refreshes

3. Standard Job Schema

Field	Required	Description
job_id	Yes	Unique identifier
title	Yes	Job title
description	Yes	Full job content
location	Yes	Job location
company	Yes	Employer name
apply_url	Yes	Application destination
posted_date	Yes	Posting date

Optional Fields

Salary
Skills
Category
Employment Type

4. Supported Input Methods

Feed Import

Supports XML, CSV and structured feeds.

Sample XML Feed

<job>
  <title>Software Engineer</title>
  <location>Remote</location>
</job>

API Import

POST /v1/jobs/import

Sample JSON Payload

{
  "job_id": "12345",
  "title": "Software Engineer",
  "location": "Remote",
  "description": "..."
}

5. Synchronization

Refresh Models

Real-time Fastest
Intraday Every 4h
Daily Standard

Supported Updates

New jobs
Modified jobs
Expired jobs
Removed jobs

Delta Sync

Only changed records may be transmitted.

6. API Endpoints

GET /v1/jobs

Retrieve Jobs

List all active jobs with optional filtering.

Query Parameters

keywordstring - Search in title/description
locationstring - Filter by geographic area

GET /v1/jobs/{companyName}

Retrieve Jobs for a company

Fetch all listings associated with a specific employer.

7. Taxonomy & Normalization

Propellum's AI-driven normalization engine ensures your data is clean, searchable, and structured:

Job title mapping

Skills extraction

Location standardization

Category classification

Optional custom taxonomy mapping supported for specialized industries.

8. Apply Routing

Configure how job seekers engage with your listings across multiple delivery models:

Redirect Apply

Seamlessly transition users to the employer's original applicant tracking system.

Hosted Apply

A white-labeled application experience fully optimized by Propellum.

Custom Apply Routing

Deep-link directly into your platform's local application flow.

9. Error Handling

Code	Description
400	Invalid Request - Required fields missing or ill-formed
401	Unauthorized - API key missing or invalid
404	Not Found - Resource does not exist
500	Server Error - Internal Propellum error

Data Validation Checks

Duplicate detection logic
Automated Feed QA protocols
Broken link monitoring (24/7)

10. Implementation Process

1

Discovery

2

Mapping

3

Validation

4

Launch

Fast-Track Implementation Our specialized team ensures a typical launch within 3–10 business days.

11. Security

Secure feed transfer

AES-256 encryption

API authentication

OAuth2 / Shared Secrets

Access controls

Granular IP Whitelisting

Protected delivery

SSL/TLS 1.3 enforced

12. Support & Success

Engineering Excellence

Integrate with Confidence

Our integration engineers work as an extension of your technical team to ensure a seamless, high-performance data pipeline.

support@propellum.com

Included Services

Mapping assistance
Feed troubleshooting
Technical onboarding

Sample Job Payload

{
  "job_id": "12345",
  "title": "Software Engineer",
  "company": "Example Inc",
  "location": "Remote",
  "apply_url": "https://example.com/apply"
}