Jobinja APIjobinja.ir ↗
Search and retrieve job postings from Jobinja.ir. Filter by keyword, category, and location in Persian. Returns job title, company, contract type, and more.
What is the Jobinja API?
The Jobinja.ir API provides access to Iran's largest job board through 1 endpoint that returns up to 20 paginated job listings per request. The search_jobs endpoint exposes 7 fields per listing — including job ID, title, company name, location, contract type, posting age, and company logo URL — and supports filtering by keyword, Persian job category, and Persian city name.
curl -X GET 'https://api.parse.bot/scraper/41e8627b-ec73-4956-b420-202f9ede5370/search_jobs?page=1&keyword=python' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace jobinja-ir-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Jobinja job search SDK — browse Iran's job board."""
from parse_apis.jobinja_ir_api import Jobinja, InputFormatInvalid
client = Jobinja()
# Search for Python jobs, cap total results to 5.
for job in client.jobs.search(keyword="python", limit=5):
print(job.title, "|", job.company, "|", job.location)
# Drill into one result from a broader search.
hit = client.jobs.search(keyword="designer", limit=1).first()
if hit is not None:
print(f"\nFirst designer job: {hit.title}")
print(f" Company: {hit.company}")
print(f" Contract: {hit.contract_type}")
print(f" Posted: {hit.posted}")
print(f" URL: {hit.url}")
# Filter by location — handle invalid input gracefully.
try:
for job in client.jobs.search(location="تهران", limit=3):
print(job.title, "-", job.contract_type)
except InputFormatInvalid as e:
print(f"Invalid search input: {e.message}")
print("\nexercised: jobs.search (keyword / location filters, limit, .first())")
Search job posts on Jobinja. Returns paginated results (20 per page) sorted by newest. Supports filtering by keyword, job category, and location. Each result includes job ID, title, company, location, contract type, posting age, and company logo URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (20 results per page). |
| keyword | string | Search keyword for job title, skill, or company name (e.g. 'python', 'designer'). Omitting returns all jobs. |
| category | string | Job category filter in Persian (e.g. 'وب، برنامهنویسی و نرمافزار'). Omitting returns all categories. |
| location | string | Location filter in Persian (e.g. 'تهران'). Omitting returns all locations. |
{
"type": "object",
"fields": {
"jobs": "array of job post objects",
"page": "integer current page number",
"total": "integer total number of matching jobs"
},
"sample": {
"data": {
"jobs": [
{
"url": "https://jobinja.ir/companies/payampardaz/jobs/tp3B/...",
"title": "برنامهنویس پایتون (Python/Django-اصفهان)",
"job_id": "tp3B",
"posted": "امروز",
"company": "دانش بنیان مهندسی ارتباطی پیام پرداز | Payam Pardaz",
"location": "اصفهان، اصفهان",
"logo_url": "https://thumb2.jobinjacdn.com/.../main.jpg",
"contract_type": "قرارداد تماموقت"
}
],
"page": 1,
"total": 284
},
"status": "success"
}
}About the Jobinja API
What the API Returns
The search_jobs endpoint queries Jobinja.ir's job listings and returns a paginated array of job post objects. Each object in the jobs array includes a job ID, job title, company name, location, contract type, posting age, and a company logo URL. The response also includes the current page number and a total count of matching jobs across all pages.
Filtering and Pagination
Results are sorted by newest first and paginated at 20 results per page. Use the page parameter to walk through result sets. The keyword parameter accepts job titles, skills, or company names in either Persian or English (e.g., python, designer). The category parameter accepts Persian category strings such as وب، برنامهنویسی و نرمافزار, and the location parameter accepts Persian city names such as تهران. All three filters are optional and can be combined — omitting any filter returns results across all values for that dimension.
Coverage and Scope
Jobinja.ir is a Persian-language platform focused on the Iranian job market. The data returned reflects publicly visible job listings. Fields like application count, full job description body, required skills lists, salary range, and employer contact details are not included in the current response shape. The total field lets you calculate how many pages exist for a given query without fetching them all.
The Jobinja API is a managed, monitored endpoint for jobinja.ir — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jobinja.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 jobinja.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?+
- Aggregate Iranian tech job listings filtered by the software development category and Tehran location.
- Monitor new postings for a specific company by searching the
keywordparameter with the company name. - Build a job alert tool that polls
search_jobsfor a given keyword and surfaces listings by posting age. - Analyze contract type distribution across job categories on the Iranian market using the
contract typefield. - Track how many total jobs (
totalfield) exist for a given skill keyword over time as a market signal. - Populate a localized job board that re-presents Jobinja listings to Persian-speaking users in a custom UI.
- Compare job availability across Iranian cities by querying the same keyword with different
locationvalues.
| 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 Jobinja.ir have an official developer API?+
What does the `search_jobs` endpoint actually return for each listing?+
Do the category and location filters need to be in Persian?+
category and location parameters expect Persian-language strings. For example, use تهران for Tehran and وب، برنامهنویسی و نرمافزار for the web and software category. The keyword parameter, however, can accept Latin-script terms like python or designer.Does the API return the full job description or salary information?+
Can I retrieve job listings from cities outside Tehran?+
location parameter accepts any Persian city name available on Jobinja. Omitting the parameter returns listings from all locations. If a specific city returns zero results, it may indicate no active listings for that query rather than a coverage gap.