/doda/jobs

POST /api/doda/jobs

Price: 5 credits

Get full Doda (デューダ) job posting details by job id (or job URL): title, hiring company (name, business content, address, establishment, capital, representative, employee count, website), job category and industry breadcrumb, employment type, job content, target requirements, salary, annual income range, estimated income model, bonus/raise/incentive/probation, benefits and company perks, team structure, gender ratio and age composition, holidays (annual count, weekly pattern and the full paid/national/summer/golden-week/new-year/maternity/childcare/family-care matrix with explanations), working hours and overtime, application method and selection flow, PR highlights, editorial interview report, publishing period, work locations and image.

How to use it

Fetch a single Doda (デューダ) job posting by numeric job id (e.g. '3015172411') or a full job URL. Returns one job with title, tags (feature badges, e.g. 正社員/新着/転勤なし/5名以上採用), company (name/business_content/address/establish_year/establishment_date/capital/sales/representative/employee_count/average_age/web_url), job_category_large/medium/small, industry_large/small, employment_type, job_content_outline/job_content, target_member_outline/target_member, selection_point, salary + salary_examples + annual_income_lower/upper (in 万円) + estimated_annual_incomes, raise_description/number_of_salary_increases, bonus/number_of_bonuses, incentive, probation_period, treatment_and_welfare + company_benefits, team_structure, organization_category, gender_ratio, age_composition, retention_rate, age_limit_display, holiday + annual_holiday(+explanation) + holiday_week(+explanation) and the has_* holiday flags (paid/national/summer/golden_week/new_year/condolence/maternity/childcare/family_care) each with their *_holiday_explanation, work_time, average_overtime_hours(+explanation), application_method, selection_process + selection_flows, pr_spaces, article_summary, interview (title/text/rewarding/difficult/image), publishing_start_date/end_date, locations (address + nearest station) and image.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• job string required — Doda job as a numeric job id or a full job URL (examples: "3015172411", "https://doda.jp/DodaFront/View/JobSearchDetail/j_jid__3015172411/"; minLength: 1)

Response

• @type string (default: "DodaJob")
• id string required
• url string required
• company object nullable
  • @type string (default: "DodaJobCompany")
  • id string nullable
  • name string nullable
  • group_name string nullable
  • business_content string nullable
  • address string nullable
  • establish_year string nullable
  • establishment_date string nullable
  • capital string nullable
  • sales string nullable
  • representative string nullable
  • employee_count string nullable
  • average_age string nullable
  • average_age_explanation string nullable
  • web_url string nullable
• job_category_large string nullable
• job_category_medium string nullable
• job_category_small string nullable
• industry_large string nullable
• industry_small string nullable
• employment_type string nullable
• job_content_outline string nullable
• job_content string nullable
• target_member_outline string nullable
• target_member string nullable
• selection_point string nullable
• work_location_text string nullable
• work_time string nullable
• salary string nullable
• salary_examples array (default: [])
• annual_income_lower integer nullable
• annual_income_upper integer nullable
• estimated_annual_incomes array (default: [])
  • @type string (default: "DodaEstimatedIncome")
  • income string nullable
  • explanation string nullable
• raise_description string nullable
• number_of_salary_increases string nullable
• bonus string nullable
• number_of_bonuses string nullable
• incentive string nullable
• probation_period string nullable
• treatment_and_welfare string nullable
• company_benefits string nullable
• team_structure string nullable
• organization_category string nullable
• gender_ratio string nullable
• age_composition string nullable
• retention_rate string nullable
• age_limit_display string nullable
• holiday string nullable
• annual_holiday integer nullable
• annual_holiday_explanation string nullable
• holiday_week string nullable
• holiday_week_explanation string nullable
• has_paid_holidays boolean nullable
• paid_holidays_explanation string nullable
• has_national_holiday boolean nullable
• national_holiday_explanation string nullable
• has_summer_holiday boolean nullable
• summer_holiday_explanation string nullable
• has_golden_week_holiday boolean nullable
• golden_week_holiday_explanation string nullable
• has_new_year_holiday boolean nullable
• new_year_holiday_explanation string nullable
• has_condolence_holiday boolean nullable
• condolence_holiday_explanation string nullable
• has_maternity_holiday boolean nullable
• maternity_holiday_explanation string nullable
• has_childcare_holiday boolean nullable
• childcare_holiday_explanation string nullable
• has_family_care_holiday boolean nullable
• family_care_holiday_explanation string nullable
• average_overtime_hours string nullable
• average_overtime_hours_explanation string nullable
• application_method string nullable
• selection_process string nullable
• selection_flows array (default: [])
• pr_spaces array (default: [])
  • @type string (default: "DodaPrSpace")
  • heading string nullable
  • text string nullable
• article_summary array (default: [])
• tags array (default: [])
• interview object nullable
  • @type string (default: "DodaInterview")
  • text string nullable
  • rewarding string nullable
  • difficult string nullable
  • image string nullable
  • image_caption string nullable
• publishing_start_date string nullable
• publishing_end_date string nullable
• image string nullable
• locations array (default: [])
  • @type string (default: "DodaJobLocation")
  • address string nullable
  • station string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — Job not found (well-formed job id but the posting does not exist or has expired) Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.