Mercor Job Search API

Collect Mercor job listings with flexible search inputs and structured output ready for automation. Use listing URLs, keyword queries, or location filters to pull high-quality job data at scale. This actor is designed for reliable recurring runs and easy integration with your workflows.

Features

• URL and keyword support — Run by listing URL, explore URL, keyword, or combined filters
• Location-aware filtering — Match jobs by listing location and eligibility locations
• Pagination controls — Limit extraction using results_wanted and max_pages
• Clean output records — Removes null-only fields and returns compact, useful data
• Automation-ready dataset — Structured records suitable for exports, pipelines, and monitoring

Use Cases

Talent Market Monitoring

Track newly posted opportunities and compensation ranges to understand hiring demand across domains.

Job Intelligence Pipelines

Feed listing data into BI tools, dashboards, and internal job intelligence systems for recurring analysis.

Lead and Opportunity Discovery

Collect relevant listings by keyword and location to build targeted candidate or client outreach workflows.

Compensation Benchmarking

Analyze pay ranges and commitment types to benchmark market rates for specific role categories.

---

Input Parameters

Parameter	Type	Required	Default	Description
url	String	No	"https://work.mercor.com/explore"	Mercor URL context (explore page or listing URL)
keyword	String	No	"software engineer"	Keyword filter for listing title and description
location	String	No	"Remote"	Location filter for listing and eligibility locations
results_wanted	Integer	No	20	Maximum number of listings to return
max_pages	Integer	No	1	Maximum virtual pages to process (50 listings per page)
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional Apify proxy settings

---

Output Data

Each dataset item contains listing data such as:

Field	Type	Description
listingId	String	Unique listing identifier
title	String	Listing title
description	String	Full listing description
location	String	Listing location
commitment	String	Commitment type
payRateFrequency	String	Compensation frequency
rateMin	Number	Minimum rate
rateMax	Number	Maximum rate
postedAt	String	Posted timestamp
listingUrl	String	Public listing URL
sourceUrl	String	Source endpoint used in run
page	Number	Virtual page number used in this run
extractedAt	String	Extraction timestamp

Additional non-null listing fields are preserved automatically.

---

Usage Examples

Explore Listings by Keyword

{
    "url": "https://work.mercor.com/explore",
    "keyword": "machine learning",
    "location": "Remote",
    "results_wanted": 20,
    "max_pages": 1
}

Fetch by Specific Listing URL Context

{
    "url": "https://work.mercor.com/jobs/list_AAABnhmh9Uy1iThTmQhBnbMS",
    "results_wanted": 5,
    "max_pages": 1
}

Larger Monitoring Pull

{
    "keyword": "software engineer",
    "location": "United States",
    "results_wanted": 100,
    "max_pages": 3,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
}

---

Sample Output

{
    "listingId": "list_AAABnhmh9Uy1iThTmQhBnbMS",
    "title": "AI Power User",
    "description": "Role overview and responsibilities...",
    "commitment": "hourly",
    "referralAmount": 340,
    "rateMin": 85,
    "rateMax": 85,
    "location": "Remote",
    "payRateFrequency": "hourly",
    "postedAt": "2026-05-12T00:41:45",
    "listingDomain": "Miscellaneous",
    "listingUrl": "https://work.mercor.com/jobs/list_AAABnhmh9Uy1iThTmQhBnbMS",
    "sourceUrl": "https://aws.api.mercor.com/work/listings-explore-page",
    "page": 1,
    "extractedAt": "2026-05-12T15:00:00.000Z"
}

---

Tips for Best Results

Start with Small Runs

Use results_wanted: 20 and max_pages: 1 to validate filters quickly, then scale up.

Prefer Specific Keywords

Focused keywords reduce noise and improve relevance of returned listings.

Use Location Filters Carefully

Try broader location terms first (for example Remote, United States) before narrowing.

Schedule for Monitoring

Use recurring schedules to capture fresh listings and track posting trends over time.

---

Integrations

Connect your dataset with:

• Google Sheets — Build shareable hiring trackers
• Airtable — Create searchable listing databases
• Make — Automate downstream processing
• Zapier — Trigger workflows from new runs
• Webhooks — Push records to custom systems

Export Formats

• JSON — Programmatic integrations
• CSV — Spreadsheet workflows
• Excel — Business reporting
• XML — Legacy system exchange

---

Frequently Asked Questions

Can I run with only a keyword?

Yes. The actor runs with keyword-only input and returns matching listings.

Can I run with only a URL?

Yes. The actor accepts explore URLs and listing URLs as run context.

What if no data is returned?

Try a broader keyword or remove strict location filtering, then run again.

Does this support large result sets?

Yes. Increase results_wanted and max_pages gradually based on your needs.

Are null-only fields included in output?

No. Null-only fields are removed so the dataset stays cleaner and more useful.

---

Support

For issues or feature requests, contact support through the Apify Console.

Resources

• Apify Documentation
• API Reference
• Scheduling Runs

---

Legal Notice

This actor is designed for legitimate data collection purposes. Users are responsible for ensuring compliance with website terms of service and applicable laws. Use collected data responsibly.