/baitoru/jobs

POST /api/baitoru/jobs

Price: 5 credits

Get one part-time or casual job posting from baitoru (バイトル): title, employer and store, employment types, posting dates, duties, occupations, work and interview locations with stations and coordinates, pay text and range, hours, shifts, holidays, workplace atmosphere scales, requirements, benefits, how to apply, photos, videos and the employer profile; an ended posting answers with is_expired true

How to use it

Job ids come from baitoru/jobs/search or baitoru/companies/jobs. An ended posting returns only its id, url and is_expired true; company_id opens the employer on baitoru/companies.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• job string required — baitoru job id or job URL (examples: "164764094", "https://www.baitoru.com/jobdetail/164764094"; minLength: 1)

Response

• @type string (default: "BaitoruJob")
• id string required
• url string required
• is_expired boolean required
• title_note string nullable
• company_id string nullable
• company_name string nullable
• store_name string nullable
• employment_types array (default: [])
• published_at integer nullable
• updated_at integer nullable
• expires_at integer nullable
• job_number string nullable
• description string nullable
• occupations array (default: [])
• occupations_text string nullable
• place_catch string nullable
• work_location object nullable
  • @type string (default: "BaitoruPlace")
  • name string nullable
  • place_name string nullable
  • prefecture string nullable
  • city string nullable
  • address string nullable
  • note string nullable
  • station_note string nullable
  • stations array (default: [])
    • @type string (default: "BaitoruStation")
    • line string nullable
    • station string nullable
    • access_method string nullable
    • access_time string nullable
  • latitude number nullable
  • longitude number nullable
  • tags array (default: [])
• interview_location object nullable
  • @type string (default: "BaitoruPlace")
  • name string nullable
  • place_name string nullable
  • prefecture string nullable
  • city string nullable
  • address string nullable
  • note string nullable
  • station_note string nullable
  • stations array (default: [])
    • @type string (default: "BaitoruStation")
    • line string nullable
    • station string nullable
    • access_method string nullable
    • access_time string nullable
  • latitude number nullable
  • longitude number nullable
  • tags array (default: [])
• salary_text string nullable
• salary_note string nullable
• salary_tags array (default: [])
• fixed_overtime array (default: [])
• salary_min number nullable
• salary_max number nullable
• salary_unit string nullable
• salary_currency string nullable
• transportation_allowance string nullable
• transportation_note string nullable
• happy_bonus_amount string nullable
• happy_bonus_condition string nullable
• treatment_tags array (default: [])
• work_time string nullable
• working_time_tags array (default: [])
• working_time_text string nullable
• working_days_text string nullable
• holiday_tags array (default: [])
• holidays array (default: [])
• holiday_note string nullable
• work_period string nullable
• work_period_text string nullable
• work_start_date string nullable
• age_groups array (default: [])
• workplace_scales array (default: [])
  • @type string (default: "BaitoruScale")
  • name string required
  • value integer nullable
  • left_label string nullable
  • right_label string nullable
• workplace_note string nullable
• editor_message string nullable
• appeal_title string nullable
• appeal_text string nullable
• experience_tags array (default: [])
• experience_text string nullable
• benefit_tags array (default: [])
• benefits_text string nullable
• regular_employment object nullable
  • @type string (default: "BaitoruRegularEmployment")
  • description string nullable
  • has_track_record boolean nullable
  • track_record string nullable
  • wanted_profile string nullable
  • terms string nullable
• feature_groups array (default: [])
  • @type string (default: "BaitoruFeatureGroup")
  • name string nullable
  • features array (default: [])
• application_method string nullable
• application_contact_name string nullable
• application_manager string nullable
• application_phone_hours string nullable
• application_phone_note string nullable
• phone_number string nullable
• reception_hours string nullable
• reception_note string nullable
• can_apply_on_web boolean nullable
• can_easy_apply boolean nullable
• is_external_application boolean nullable
• external_application_url string nullable
• is_outsourcing boolean nullable
• is_baitoru_next boolean nullable
• application_level integer nullable
• work_trial object nullable
  • @type string (default: "BaitoruVisit")
  • duration string nullable
  • description string nullable
  • is_paid boolean nullable
  • pay string nullable
• office_tour object nullable
  • @type string (default: "BaitoruVisit")
  • duration string nullable
  • description string nullable
  • is_paid boolean nullable
  • pay string nullable
• images array (default: [])
  • @type string (default: "BaitoruImage")
  • url string required
  • caption string nullable
• uniform_images array (default: [])
  • @type string (default: "BaitoruImage")
  • url string required
  • caption string nullable
• videos array (default: [])
  • @type string (default: "BaitoruVideo")
  • id string nullable
  • url string nullable
  • thumbnail string nullable
  • description string nullable
• baitoru_next_job_count integer nullable
• baitoru_pro_job_count integer nullable
• company object nullable
  • @type string (default: "BaitoruJobCompany")
  • id string nullable
  • url string nullable
  • name string nullable
  • image string nullable
  • images array (default: [])
    • @type string (default: "BaitoruImage")
    • url string required
    • caption string nullable
  • catchphrase string nullable
  • appeal string nullable
  • reports array (default: [])
    • @type string (default: "BaitoruReport")
    • content string nullable
  • address string nullable
  • phone string nullable
  • fax string nullable
  • established string nullable
  • capital string nullable
  • sales string nullable
  • is_listed boolean nullable
  • representative string nullable
  • employees string nullable
  • dispatch_license_number string nullable
  • recruitment_license_number string nullable
  • service_area string nullable
  • offices_count integer nullable
  • offices string nullable
  • application_process string nullable
  • welfare_tags array (default: [])
  • welfare string nullable
  • comment string nullable
  • business string nullable
  • website string nullable

Errors

• 422 — job is not a baitoru job id or URL 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 — No baitoru job posting under that id 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.