Skip to main content
Job Import allows you to build your job market data by pasting job posting URLs. AI automatically extracts job information including title, employer name, salary range, locations, and O*NET occupation codes.

​
What Job Import Does

When you paste a job posting URL, Mapademics:
  1. Downloads the job posting content
  2. Uses AI to extract job information
  3. Identifies the job title, employer, salary, locations, and occupation codes
  4. Matches extracted data with existing employers
  5. Lets you review and edit the information before importing
  6. Optionally extracts skills immediately after import

​
When to Use Job Import

Job Import is ideal when you:
  • Have publicly accessible job posting URLs
  • Want to build job market intelligence data
  • Are analyzing specific employers or industries
  • Need to demonstrate career alignment for your programs
  • Want to identify relevant occupations for curriculum mapping
  • Are researching salary and employment trends

​
How Job Import Works

​
Step 1: Access Job Import

Navigate to Data Import > Job Import in Mapademics.

​
Step 2: Paste Job Posting URLs

In the URL input field, paste one or more job posting URLs. You can:
  • Paste a single URL and press Enter
  • Paste multiple URLs separated by line breaks
  • Paste URLs one at a time
Each URL creates a new entry in the import list.
You can paste multiple URLs at once - just separate them with line breaks (press Enter between each URL).

​
Step 3: AI Extraction (Automatic)

When you add a URL, Mapademics automatically:
  1. Downloads the content from the job posting page
  2. Analyzes the posting using AI
  3. Extracts job information and metadata
You’ll see a progress indicator while the AI processes each posting. This typically takes 5-15 seconds per job.

​
Step 4: Review Extracted Information

After AI extraction completes, each entry shows: Job Information:
  • Job Title: Extracted position title
  • Employer Name: Company or organization name
  • Salary Range: Extracted salary information (if available)
  • Locations: City and state(s) where the job is located
  • O*NET Codes: Standard Occupational Classification codes
Entity Matching Status: The system automatically checks if the extracted employer already exists:
  • Green checkmark: Matched with existing employer in your database
  • Blue badge: Matched with another URL in this import batch
  • No indicator: Will create new employer during import

​
Step 5: Edit Information (If Needed)

Click on any field to edit it:
  • Job title
  • Employer name
  • Salary range
  • Locations
  • O*NET occupation codes
Job title is a required field. You cannot import an entry without a job title.

​
Step 6: Handle Locations

The system detects and validates locations from the job posting: Detected Locations:
  • Shown as tags/chips
  • Validated against US cities database
  • Can be added or removed
Adding Locations:
  1. Click in the locations field
  2. Start typing a city name
  3. Select from the dropdown of matching cities
Removing Locations:
  • Click the X on any location tag to remove it
Location data helps with geographic analysis and regional job market insights.

​
Step 7: Review O*NET Codes

O*NET (Occupational Information Network) codes are automatically detected when possible: What are O*NET Codes?
  • Standard codes used by the US Department of Labor
  • Classify occupations by type of work
  • Enable skills mapping and career pathway analysis
Managing O*NET Codes:
  • System suggests codes based on job title and description
  • You can add additional codes manually
  • You can remove suggested codes if incorrect
  • Multiple codes can be assigned to one job
Accurate O*NET codes improve skills mapping accuracy and enable better career pathway analysis.

​
Step 8: Match With Existing Data

For each entry, you can manually select existing employers: Employer Matching:
  • Click Select Existing Employer to choose from existing employers
  • This links the new job to an existing employer instead of creating a new one
Override Auto-Matching: If the system auto-matched incorrectly, click Create New to override and create a new employer instead.
Auto-matching helps prevent duplicate employers. Review the matches and override if the system matched incorrectly.

​
Step 9: Review Import Summary

At the top of the page, you’ll see a summary showing:
  • Total entries
  • Ready to import (green checkmarks)
  • Needs attention (errors or missing required fields)
  • Duplicates that will be skipped
The Import button shows how many items will be imported.

​
Step 10: Execute Import

Click the Import button to proceed. You’ll see a dialog with options: Extract Skills Immediately (checkbox):
  • When checked: Creates background jobs to extract skills from all imported job postings immediately
  • When unchecked: Imports the jobs but doesn’t start skills extraction (you can do this later)
Click Confirm Import to start the import process.
The import typically completes in a few seconds. If you chose to extract skills, background jobs will continue processing for several minutes.

​
Step 11: View Results

After import completes, you’ll see a success summary showing:
  • Jobs Created: Number of new job postings added
  • Employers Created: Number of new employer records added
  • Background Jobs Started: Number of skills extraction jobs (if requested)
You can:
  • Click View Background Jobs to monitor skills extraction progress
  • Click Start New Import to import more jobs
  • Click View Jobs to see your imported jobs

​
What Gets Detected

​
From Job Posting Content

The AI extraction identifies: Job Details:
  • Job title (e.g., “Senior Software Engineer”)
  • Company/employer name
  • Job ID or reference number (if available)
Compensation:
  • Salary range (e.g., “80,000−80,000 - 100,000”)
  • Pay period (annual, hourly)
  • Bonus or commission information (if mentioned)
Location Information:
  • City and state
  • Multiple locations if listed
  • Remote/hybrid work indicators
Occupation Classification:
  • O*NET SOC codes based on job title and description
  • Industry classifications
  • Job level (entry, mid, senior)
Job Description:
  • Full description text
  • Required qualifications
  • Preferred qualifications
  • Responsibilities

​
Data Quality

High Confidence Extraction:
  • Clear job titles
  • Explicit employer names
  • Standard salary formats
  • Common US city names
  • Well-structured job postings
May Require Editing:
  • Unconventional job titles
  • Subsidiary or division names
  • International locations
  • Non-standard salary formats
  • Multiple positions in one posting
Always review the extracted information before importing, especially employer names and locations.

​
Matching Existing Data

​
How Matching Works

Employer Matching: The system looks for existing employers with:
  • Exact same employer name (case-insensitive)
  • Similar names (fuzzy matching)

​
Match Indicators

Database Match (Green):
  • Employer exists in your Mapademics database
  • Will be linked to the existing employer record
  • No new employer will be created
Local Match (Blue):
  • Another URL in this import batch has the same employer
  • Both will be linked together upon import
  • Only one employer will be created
No Match (Create New):
  • No matching employer found
  • Will create a new employer during import

​
Manual Selection

You can override auto-matching by manually selecting employers:
  1. Click Select Existing Employer
  2. Search for the correct employer in the dropdown
  3. Select the matching employer
  4. The entry will now link to your selected employer
To revert manual selection:
  • Click Clear Selection to let the system auto-match again

​
Batch Import

​
Importing Multiple Job Postings

You can paste multiple URLs at once:
  1. Copy all job posting URLs to your clipboard
  2. Paste them into the URL field (each URL on a new line)
  3. Press Enter or Tab
The system will process all URLs simultaneously, showing progress for each.

​
Managing Multiple Entries

For each entry in the list, you can:
  • Edit: Click any field to modify it
  • Remove: Click the X button to delete the entry
  • Reprocess: If extraction failed, you can re-enter the URL
Job Import is designed for targeted job market research. For very large datasets (100+ jobs), consider other data sources or APIs.

​
Duplicate Detection

​
URL Duplicates

The system tracks job posting URLs to prevent duplicates:
  • Checks both the provided URL and any redirect URLs
  • If a job was already imported from the same URL, you’ll see a warning
  • You can choose to import anyway (creates a new job record) or skip

​
Employer Duplicates

If multiple jobs are from the same employer:
  • They’re automatically linked to the same employer record
  • Only one employer is created
  • All jobs show under that employer

​
Supported Formats

​
URL Types That Work

Major Job Boards: 
https://www.indeed.com/viewjob?jk=abc123
https://www.linkedin.com/jobs/view/1234567890
https://www.glassdoor.com/job-listing/software-engineer-company-JV_ABC123
Company Career Pages: 
https://careers.company.com/jobs/12345
https://jobs.university.edu/postings/67890
Government Job Sites: 
https://www.usajobs.gov/job/123456789
Recruiting Platforms:
  • Workday postings
  • Greenhouse postings
  • Lever postings
  • Other applicant tracking systems

​
Job Posting Format Requirements

Best Results:
  • Standard job posting format
  • Clear job title
  • Company name prominently displayed
  • Structured description with sections
  • Salary information included
  • Location clearly stated
Acceptable:
  • Non-standard formats (may require editing)
  • PDF job descriptions
  • Simple text postings
  • Academic position postings
May Not Work:
  • Login-required postings
  • Expired job listings
  • Image-only job descriptions
  • Heavily formatted or JavaScript-dependent pages

​
Troubleshooting

​
URL Not Accessible

Error Message: “Failed to download content from URL” Possible Causes:
  • Job posting has been removed or expired
  • URL requires login or registration
  • The site blocks automated access
  • The URL is malformed
Solutions:
  • Verify the URL in a browser
  • Try accessing in a private/incognito window
  • Check if the job posting is still active
  • Copy the URL again from the job board

​
AI Extraction Incomplete

Symptoms: Missing job title, employer name, or other information Possible Causes:
  • Non-standard job posting format
  • Information in images rather than text
  • Page structure is complex or unusual
  • Multiple jobs on one page
Solutions:
  • Manually edit the fields to fill in missing information
  • Check the original posting to verify details
  • For complex postings, enter data manually
  • Contact support if extraction consistently fails

​
Missing Required Fields

Error Message: Entry shows red error indicator Required Field:
  • Job Title
Solution:
  • Click on the field and enter the missing information
  • If the AI couldn’t extract it, look at the original posting and enter it manually

​
Location Not Recognized

Symptom: Location tag appears with a warning icon Possible Causes:
  • Non-US location
  • City name is misspelled in the job posting
  • Very small city not in the database
  • Ambiguous location (multiple cities with same name)
Solutions:
  • Remove the unrecognized location
  • Search for the correct city in the location selector
  • Add state abbreviation to disambiguate (e.g., “Springfield, IL” vs “Springfield, MA”)
  • For international locations, enter nearest major US city or mark as remote

​
O*NET Code Issues

No O*NET codes detected:
  • This is common for very specialized or new roles
  • Manually search for related occupation codes
  • Leave empty if no relevant codes exist
Wrong O*NET codes suggested:
  • Remove incorrect codes by clicking the X
  • Search for and add the correct codes manually
  • Refer to O*NET OnLine (onetonline.org) for guidance
Multiple codes seem relevant:
  • It’s okay to add multiple O*NET codes
  • Jobs often span multiple occupational categories
  • Include all relevant codes for better analysis

​
Best Practices

​
Before You Import

  1. Identify target employers - Focus on employers relevant to your programs
  2. Find current postings - Use recent job postings for accurate market data
  3. Test URLs - Verify all URLs work and don’t require login
  4. Plan your research - Decide which occupations or industries to focus on

​
During Import

  1. Review each extraction - Verify job titles and employer names
  2. Validate locations - Ensure cities are correctly identified
  3. Check O*NET codes - Verify occupation codes are appropriate
  4. Standardize employer names - Use consistent naming (e.g., “IBM” not “International Business Machines”)
  5. Remove irrelevant data - Delete entries that aren’t useful for your analysis

​
After Import

  1. Verify results - Spot-check imported jobs to ensure data quality
  2. Monitor skills extraction - If you started background jobs, watch progress
  3. Organize by employer - Review jobs grouped by employer
  4. Analyze trends - Look for common skills, salary ranges, and requirements
  5. Use in reports - Incorporate job data into your gap analysis and career pathway reports

​
Skills Extraction Tips

When to extract immediately:
  • You need job skills data for current reports
  • The job postings have detailed requirements sections
  • You have fewer than 20 jobs in the import
When to extract later:
  • You’re importing many jobs (20+)
  • You want to review job data first
  • You plan to process job postings in batches
  • You’re still building your job market dataset

​
Building Useful Job Market Data

For Program Alignment:
  • Import jobs from top employers in your region
  • Focus on entry-level positions for graduates
  • Include jobs that require your programs’ credentials
  • Track jobs by O*NET codes related to your curricula
For Career Services:
  • Import jobs students are interested in
  • Include a variety of employers and locations
  • Track salary trends for graduate outcomes
  • Focus on jobs aligned with your programs
For Curriculum Development:
  • Import jobs from industry advisory board members
  • Focus on emerging roles and technologies
  • Track skill requirements over time
  • Identify gaps between current curriculum and market needs