ProZ.com global directory of translation services
The translation workplace
Ideas

GET: /job-postings

Get a collection of job postings that match a set of criteria.

Parameters

Search criteria (all are optional):
  • type: (string) One or more job posting types, separated by commas. Ex. translation,potential.
    Valid values: translation (translation, editing, or proofreading), interpret (interpreting), or potential (recruiting translators without an immediate job to offer).
  • status: (string) One or more jobs statuses, separated by commas. Ex. open,closed.
    Valid values: open or closed
  • language_pairs: (language pair codes) One or more language pair codes, separated by commas. Ex. eng_spa,eng_fra. Use the special value mine to show jobs in the authenticated user's language pairs.
  • fields: (string) Limit job list results to any one of:
    • A general discipline ID specified as: disc_gen_{numeric ID}, ex. disc_gen_3.
    • A specific discipline ID specfied as: disc_spec_{numeric ID}, ex. disc_spec_77.
    • The string my_disc_gens for all generic disciplines added to the authenticated user's profile.
    • The string my_disc_specs for all specific disciplines added to the authenticated user's profile.
  • software: (software IDs) One or more software IDs, separated by commas. Ex. 1,16,56.
  • q: (string) A search query string.
  • i_can_quote: (boolean) If true, only return job postings for which the user is eligible to submit a quote, according to the job poster's preferences and the user's profile settings. Note that this might include job postings on which the user is not currently eligible to quote, but will be eligible after some period of time (ex. jobs accessible only to ProZ.com members for the first 12 hours).
  • min_job_id: (integer) The lowest job_id to include in results. Useful for querying only for newly-added job postings. Otherwise, job posting results are limited to the past 14 days by default (this parameter overrides that default behavior).
  • include_discarded: (boolean) If true, any job postings that user has previously discarded will be included in returned results. Only relevant for authenticated users.
  • confidentiality: (string) Confidentiality level assigned to a particular job posting. One of these valid values: any, high,medium,low,not_specified.
  • personal: (string) Personal filter. One of these valid values: all, my_jobs, my_quotes, my_flagged_posters.
    • all - get all jobs postings
    • my_jobs - get own job postings
    • my_quotes - get the jobs postings where I submitted a quote
    • my_flagged_posters - get the jobs postings submitted by my flagged posters
  • ids: (string) One or more job posting IDs, separated by commas. Ex. 4507358,4507373.
Options:
  • page: The result page to return, for pagination. Default: 1.
  • per_page: The maximum number of job postings to return in this request. Default: 50. Max: 100.

Example request

curl -H "Authorization: Bearer {OAUTH2_ACCESS_TOKEN}" https://api.proz.com/v2/job-postings?language_pairs=mine

Response

Returns a collection of job postings in the following format:

{
    "_links": {
        "self": {
            "href": "https://api.proz.com/v2/job-postings?language_pairs=mine"
        },
        "next": {
            "href": "https://api.proz.com/v2/job-postings?language_pairs=mine&page=2"
        },
        "prev": {
            "href": null
        }
    },
    "data": [
{
    "id": 739492,
    "web_url": "http://www.proz.com/job/739492",
    "type": "potential",
    "summary": "Russian>German Legal Translation",
    "description": "Geotext Translations is currently recruiting Russian>German linguists for a large Legal translation project.\r\n\r\nWe are looking for linguists specialized in legal translation who are available immediately for a long-term freelance collaboration.\r\n\r\nA test may be required.\r\n\r\nIf you are interested in collaborating, please send your CV and most competitive rates to [email protected]",
    "status": "open",
    "time_posted": "2013-02-15T17:44:07+00:00",
    "time_expires": "2013-02-20T22:00:00+00:00",
    "delivery_deadline": null,
    "language_pairs": [
      "rus_deu"
    ],
    "volume_amount": 0,
    "volume_unit": "word",
    "disc_spec_id": 77,
    "disc_other": "",
    "language_service_ids": [
      1,
      2
    ],
    "contact_method": "email",
    "contact_info": {
      "user_id": 964006,
      "type": "company",
      "email": "",
      "show_email": false,
      "full_name": "",
      "show_full_name": false,
      "job_title": "Recruitment Coordinator",
      "company": "Geotext Translations",
      "url": "http://www.geotext.com",
      "show_url": true,
      "address": "259 W. 30th St. 17th Fl.",
      "show_address": true,
      "city": "New York",
      "show_city": true,
      "region": "New York",
      "show_region": true,
      "postal_code": "10001",
      "show_postal_code": true,
      "country": "us",
      "show_country": true,
      "phone": "",
      "show_phone": false,
      "fax": "",
      "show_fax": false
    },
    "software_ids": [],
    "offered_rate": null,
    "payment_notes": "",
    "blueboard_name": "Geotext Translations, Inc.",
    "blueboard_avg_lwa": 5,
    "blueboard_link": "https://api.proz.com/v2/blueboard/3856",
    "provider_requirements": {
        "proz_members_only": true,
        "members_only_until": null,
        "language_pairs": [ "rus_deu" ],
        "language_pair_importance": "required",
        "disc_gen_ids": [ 1 ],
        "disc_gen_importance": "required",
        "disc_spec_ids": [ 77 ],
        "disc_spec_importance": "preferred",
        "credentials": null,
        "native_language": "deu",
        "native_language_importance": "required",
        "software": [],
        "software_importance": null,
        "country": "us",
        "country_importance": "preferred",
        "account_type": "freelancers",
        "account_type_importance": "required",
        "additional_requirements": "Must have at least 10 years of experience."
    },
    "confidentiality": "high",
    "text_excerpt": "",
    "text_excerpt_require_translation": false,
    "_links": {
      "self": {
        "href": "https://api.proz.com/v2/job-postings/739492"
      }
    }
}
    ]
}