Jobvision APIjobvision.ir ↗
Search and retrieve job postings from Jobvision.ir, Iran's largest job board. Get titles, salaries, locations, work types, and company info via one API.
What is the Jobvision API?
The Jobvision.ir API provides access to Iran's largest job board through a single list_jobs endpoint that returns paginated job postings with up to 8 structured fields per listing, including job title, company details, salary range, location, work type, seniority level, and job categories. You can query by keyword in Persian or English, or omit the keyword to retrieve all available listings sorted by relevance.
curl -X GET 'https://api.parse.bot/scraper/b99f8df0-7a93-45ee-badc-56494249fa3a/list_jobs?keyword=python' \ -H 'X-API-Key: $PARSE_API_KEY'
Search and list job postings on Jobvision.ir. Returns paginated results sorted by relevance. Each job includes title, company info, location, salary range, work type, seniority level, and job categories. When no keyword is provided, returns all available jobs sorted by relevance. Pagination is controlled by page and page_size parameters.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). |
| keyword | string | Job title or company name search query (e.g. 'python', 'حسابدار'). Omitting returns all jobs. |
| page_size | integer | Number of results per page, between 1 and 50. |
{
"type": "object",
"fields": {
"jobs": "array of job objects with id, title, company info, location, salary, work type, categories",
"page_size": "integer, results per page",
"total_count": "integer, total number of matching jobs",
"current_page": "integer, current page number"
},
"sample": {
"data": {
"jobs": [
{
"id": 1478785,
"city": "تهران",
"title": "برنامه نویس پایتون",
"industry": "فناوری اطلاعات / نرم افزار و سخت افزار",
"province": "تهران",
"is_remote": false,
"is_urgent": true,
"work_type": "Full Time",
"company_id": 6268,
"salary_max": null,
"salary_min": null,
"salary_text": null,
"company_name": "شرکت نمادایران",
"is_internship": false,
"job_categories": [
"توسعه نرم افزار و برنامه نویسی"
],
"activation_date": "2026-08-09T17:17:54Z",
"company_name_en": "Namaad Iran Co",
"seniority_level": "Specialist"
}
],
"page_size": 3,
"total_count": 749,
"current_page": 1
},
"status": "success"
}
}About the Jobvision API
What the API Returns
The list_jobs endpoint returns an array of job objects from Jobvision.ir. Each object includes a job id, title, company information, location, salary range, work_type (e.g. full-time, part-time, remote), seniority_level, and one or more categories. The response envelope also provides total_count (total matching jobs), current_page, and page_size so you can build pagination logic straightforwardly.
Filtering and Pagination
The keyword parameter accepts either Latin characters (e.g. python, manager) or Persian text (e.g. حسابدار, مهندس نرمافزار), making it suitable for querying across both fields and company names. The page parameter is 1-indexed, and page_size accepts values between 1 and 50. Omitting keyword returns the full job index sorted by relevance, which is useful for bulk collection or market-survey tasks.
Coverage Notes
Jobvision.ir focuses on the Iranian job market, so listing volume, company names, and location data are Iran-centric. Salary ranges are typically expressed in Iranian Rials or Tomans. Job categories reflect the site's own taxonomy and may include fields like IT, finance, engineering, and marketing. Freshness depends on when listings are published and updated on the source site.
The Jobvision API is a managed, monitored endpoint for jobvision.ir — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jobvision.ir changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official jobvision.ir API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new software engineering roles in Tehran by querying
list_jobswithkeyword=pythondaily. - Aggregate salary range data across job categories to benchmark compensation in the Iranian tech market.
- Track hiring activity for a specific company by searching its name as the
keywordparameter. - Build a Persian-language job alert system using
keywordsearches with paginated polling. - Analyze seniority level distribution across job categories to study workforce demand trends in Iran.
- Populate a job board or career platform targeting Iranian professionals with live Jobvision listings.
- Research remote work availability in Iran by filtering
work_typefields from bulklist_jobsresults.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Jobvision.ir have an official developer API?+
What does the `list_jobs` endpoint return for each job?+
id, title, company info, location, salary range, work_type, seniority_level, and one or more job categories. The response also includes total_count, current_page, and page_size for pagination.Can I retrieve full job description text through this API?+
list_jobs endpoint returns structured summary fields — title, company, location, salary, work type, seniority, and categories — but does not include the full job description body. You can fork this API on Parse and revise it to add a detail endpoint that returns the full posting text.Does the API support filtering by location, work type, or seniority level directly?+
keyword, page, and page_size as inputs. Location, work type, and seniority level are returned in each job object but are not available as direct filter parameters. You can fork the API on Parse and revise it to add those filter parameters.How does pagination work in the `list_jobs` endpoint?+
page parameter. Set page_size between 1 and 50 to control how many results are returned per call. The total_count field in the response tells you how many total matching jobs exist, so you can calculate how many pages to iterate through.