occ.com.mx APIwww.occ.com.mx ↗
Search OCC.com.mx job listings by keyword and location. Get paginated results with salaries, companies, and full job details including skills and benefits.
curl -X GET 'https://api.parse.bot/scraper/bb43db95-21fc-4220-8ad2-36cabe249211/search_jobs?page=1&keyword=contador' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job listings by keyword and optionally filter by location. Returns a paginated list of jobs with basic information including title, company, salary, location, and posted date. Each page contains up to 22 results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| limit | integer | Maximum number of results to return per page (max 22) |
| keywordrequired | string | Job search keyword (e.g., 'desarrollador', 'contador', 'ingeniero') |
| location | string | Location filter as URL slug (e.g., 'ciudad-de-mexico', 'monterrey', 'guadalajara'). Leave empty for all locations. |
{
"type": "object",
"fields": {
"jobs": "array of job objects with offer_id, title, salary, company, location, posted_date",
"page": "integer - current page number",
"total_pages": "integer - total pages available",
"total_results": "integer - total matching jobs",
"results_on_page": "integer - number of results on this page"
},
"sample": {
"data": {
"jobs": [
{
"title": "Contador",
"salary": "Sueldo no mostrado por la empresa",
"company": "Empresa confidencial",
"location": "Mérida, Yucatán",
"offer_id": "21095369",
"posted_date": "Hoy"
}
],
"page": 1,
"total_pages": 103,
"total_results": 2252,
"results_on_page": 22
},
"status": "success"
}
}About the occ.com.mx API
The OCC.com.mx API gives developers access to Mexico's largest job board through 2 endpoints. Use search_jobs to query listings by keyword and location, receiving paginated results with titles, salaries, companies, and posting dates. Use get_job_details to retrieve full listing data — including salary range, required skills, benefits, city, state, and job category — for any offer ID returned by a search.
Search Jobs
The search_jobs endpoint accepts a required keyword parameter (e.g., desarrollador, contador, ingeniero) and an optional location slug (e.g., ciudad-de-mexico, monterrey, guadalajara). Results are paginated at up to 22 listings per page. The response includes total_results, total_pages, and results_on_page for building pagination controls, plus a jobs array with per-listing fields: offer_id, title, salary, company, location, and posted_date. Omitting location returns results across all of Mexico.
Job Details
The get_job_details endpoint takes an offer_id from any search_jobs result and returns a detailed record. The salary object exposes min, max (both integers or null), and a human-readable text representation. Additional fields include skills (array of required skill strings), benefits (array of offered benefit strings), category, city, state, location, and the canonical url for the listing on OCC.com.mx.
Coverage and Scope
All listings are sourced from occ.com.mx, which focuses on the Mexican labor market. Location filtering uses URL slugs matching OCC's regional taxonomy, so values like guadalajara or monterrey should match the site's conventions. Salary fields may be null when a listing does not publish compensation data.
- Aggregate Mexican job market data by keyword to analyze demand for specific roles such as
ingeniero de softwareorcontador - Build a salary intelligence tool by collecting
salary.minandsalary.maxfields across categories and locations - Power a job alert service that polls
search_jobsfor newposted_datevalues matching user-defined keywords - Populate a curated job board focused on Mexico, pulling full descriptions and
benefitsfromget_job_details - Analyze skill requirements across industries by extracting
skillsarrays from multiple job detail responses - Track hiring activity by city or state using the
locationfilter andtotal_resultscounts over time - Build a recruiting pipeline tool that matches candidate profiles against required
skillsandbenefitsfields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OCC.com.mx have an official developer API?+
What does `search_jobs` return and how do I filter by location?+
jobs array with up to 22 entries per page, each containing offer_id, title, salary, company, location, and posted_date, plus pagination metadata (total_results, total_pages, results_on_page). Pass a location slug such as ciudad-de-mexico or monterrey to the location parameter to filter geographically. Omitting it returns results nationwide.What happens when a listing doesn't include salary information?+
salary object returned by get_job_details includes min and max as integers or null. When a company does not publish compensation, both fields will be null and the text field will reflect whatever placeholder or omission the original listing shows.Does the API support searching by company name or filtering by job category?+
search_jobs endpoint filters by keyword and location only. Category is returned as a field in get_job_details results but is not an input filter. You can fork this API on Parse and revise it to add category or company-name filtering as additional parameters.