Endpoint Examples

/postings

List individual postings that match a set of filters.

POST /postings

Get data for individual postings that match your requested filters. Note that not all fields are present for all postings, and some may be null or "Unknown". The url field is only available for currently active postings, and the destination website is not guaranteed to be secure or functional.

Note that the score field is based on posting relevance to your query. Many fields have a single value per posting so relevance scores will be the same for all postings that match those filters. Score variance occurs when a filter is provided that can match a subset of the values in a particular field, filters such as keyword and skills provide such functionality. Only the first 200 values per filter will be used for relevance scoring.

To request more postings please contact us here.

Query Parameters

NameTypeDescription
noc_versionenum

Specify NOC taxonomy version to use.
This parameter is optional.
Default: ca_noc2021

Must be one of: ca_noc2021

company_versionenum

Specify company taxonomy version to use.
This parameter is optional.
Default: emsi_company

Must be one of: emsi_company

area_versionenum

Specify area taxonomy version to use.
This parameter is optional.
Default: ca_area_sgc2016

Must be one of: ca_area_sgc2016, ca_area_sgc2021

area_ca_versionenum

Specify area taxonomy version to use.
This parameter is optional.
Default: 2021.0.0

Must be one of: 2021.0.0, 2016.0.0

new_taxonomy_versionsenum

Use new taxonomy versions.
This parameter is optional.

Must be one of: true, false

lot_versionenum

Specify LOT taxonomy version to use.
This parameter is optional.
Default: 7

Must be one of: 6, 7

naics_versionenumSpecify NAICS taxonomy version to use.
This parameter is optional.
Default: naics_std_2017
Must be one of: naics_std_2017, naics_std_2022
naics_standard_versionenum

Specify NAICS taxonomy version to use.
This parameter is optional.
Default: 2017.0.1

Must be one of: 2017.0.1, 2022.0.0

Request Body

{
  "filter": {
    "when": {
      "start": "2019-01",
      "end": "2020-04",
      "type": "active"
    },
    "city_name": [
      "Vancouver"
    ],
    "keywords": {
      "query": "work/life balance",
      "type": "and"
    }
  },
  "fields": [
    "id",
    "posted",
    "expired",
    "body",
    "city_name",
    "company_name",
    "title_raw",
    "url",
    "active_urls",
    "score"
  ],
  "order": [
    "score"
  ],
  "limit": 2
}

Code Examples

curl --request POST \
  --url https://api.lightcast.io/ca-jpa/postings \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "filter": { "when": { "start": "2019-01", "end": "2020-04", "type": "active" }, "city_name": [ "Vancouver" ], "keywords": { "query": "work/life balance", "type": "and" } }, "fields": [ "id", "posted", "expired", "body", "city_name", "company_name", "title_raw", "url", "active_urls", "score" ], "order": [ "score" ], "limit": 2 }'

Response Examples

{
  "data": {
    "limit": 2,
    "page": 1,
    "pages_available": 5,
    "postings": [
      {
        "body": "<!--id: 49b521d75d2c48678827df5385f5e87f-->Sales Associate Integral Retail Recruitment Inc. Vancouver, BC Job summary + <h5>Salary :</h5> To be discussed + <span class=\"jpa-keyword-highlight\">Work</span> schedule : Full time + Job status : Permanent + <span class=\"jpa-keyword-highlight\">Work</span> shift : Day , Evening , Weekend Description <h5>SALES - VANCOUVER</h5> Full-Time Sales Consultant - Fashion What you'll need to <span class=\"jpa-keyword-highlight\">work</span> for this phenomenal brand? + 2-5 years of sales/customer service experience in high-end service environments + Fashionable, Passion for styling clients + Experience building clientele base + Passion to interreact and have fun with people in a professional, client-focused environment This role will challenge you to provide the best customer service and assist management in running the store successfully. <span class=\"jpa-keyword-highlight\">Work</span> for this phenomenal retailer, and expand your career. If you have a passion for fashion, styling people, sales and delivering a wonderful client experience this might be your ideal job! What's in it for you? + Outstanding Base Salary of $14-17/HR + Commission + Hefty Product Discounts + A <span class=\"jpa-keyword-highlight\">work</span> environment that encourages <span class=\"jpa-keyword-highlight\">work</span>/<span class=\"jpa-keyword-highlight\">life</span> <span class=\"jpa-keyword-highlight\">balance</span> and career growth Requirements Level of education High school Diploma Completed <span class=\"jpa-keyword-highlight\">Work</span> experience (years) 3-5 years Written languages <h5>En :</h5> Intermediate Spoken languages <h5>En :</h5> Intermediate Benefits + Commitment to <span class=\"jpa-keyword-highlight\">work</span>-<span class=\"jpa-keyword-highlight\">life</span> <span class=\"jpa-keyword-highlight\">balance</span> + Commitment to <span class=\"jpa-keyword-highlight\">work</span>-<span class=\"jpa-keyword-highlight\">life</span> <span class=\"jpa-keyword-highlight\">balance</span> + Competitive salary + Competitive salary + On-going training + On-going training Upload your resume",
        "city_name": "Vancouver",
        "company_name": "Integral Development Corp.",
        "expired": "2019-03-05",
        "id": "49b521d75d2c48678827df5385f5e87f",
        "posted": "2019-02-05",
        "score": 8.185217,
        "title_raw": "Sales Associate",
        "url": []
      },
      {
        "body": "<!--id: cb3a99b91c344e46ae36885d51e478d4-->Accounts Receivable Administrator Swim Recruiting Location Vancouver, BC Details Full Time 15 hours ago Great opportunity for an accounting professional who already has AR experience and who is eager to gain new accounting knowledge with a large and reputable organization. Excellent Vancouver company with a great corporate culture and solid <span class=\"jpa-keyword-highlight\">work</span>/<span class=\"jpa-keyword-highlight\">life</span> <span class=\"jpa-keyword-highlight\">balance</span>. Role is open to CPA students. Who- the <h5>Company:</h5> Our client is a reputable and very well-managed technology company with close to 1000 employees. It's a company that promotes an innovative, passionate, and values-based <span class=\"jpa-keyword-highlight\">work</span> culture, as well as good <span class=\"jpa-keyword-highlight\">work</span>-<span class=\"jpa-keyword-highlight\">life</span> <span class=\"jpa-keyword-highlight\">balance</span>. What- the <h5>Opportunity:</h5> Our client is seeking a new Accounts Receivable Administrator who will process AR transactions, analyze reconciliations, support financial reporting, calculate and submit invoices, maintain the AR sub ledger, and also support month-end/quarter-end/year-end within the accounting team. The A/R Administrator will also cross-train in A/P and other functions so they can act as a back-up and so they can to their accounting knowledge. Who- the <h5>Candidate:</h5> We are looking for up & coming accounting professionals who are self-motivated and able to <span class=\"jpa-keyword-highlight\">work</span> successfully in a collaborative team environment. At least 2 years recent and relevant experience related to Accounts Receivable. Long-term pursuit of CPA designation is an asset but not required (company will support CPA studies). Responsibilities will vary, and we are looking for people who are adaptable and versatile. A process-improvement mindset and the willingness to problem solve are key in this role! Candidates will be great communicators who are also self-motivated and organized. <h5>Where:</h5> Vancouver, BC. <h5>How Much:</h5> Base salary commensurate with experience, plus benefits, a performance-based bonus, and good <span class=\"jpa-keyword-highlight\">work</span>/<span class=\"jpa-keyword-highlight\">life</span> <span class=\"jpa-keyword-highlight\">balance</span>. Please discuss further with Swim.",
        "city_name": "Vancouver",
        "company_name": "Our Co Inc",
        "expired": "2020-04-10",
        "id": "cb3a99b91c344e46ae36885d51e478d4",
        "posted": "2020-01-31",
        "score": 8.038073,
        "title_raw": "Accounts Receivable Administrator",
        "url": []
      }
    ],
    "unique_postings": 6795,
    "viewable_postings": 6795
  }
}
//Your request wasn't valid (bad parameter names or values).

{
  "errors": [
    {
      "status": 400,
      "title": "Malformed Request",
      "detail": "Expected array"
    }
  ]
}
//Your request wasn't unauthorized.

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized Request",
      "detail": "You are not authorized to access this resource."
    }
  ]
}
//Your request wasn't valid (bad keyword expression).

{
  "errors": [
    {
      "status": 422,
      "title": "Invalid request content",
      "detail": "Invalid keyword search expression syntax:\n\t\"general merchandise\" OR \"apparel\" OR \"grocery\" OR\n\t                                                  ^"
    }
  ]
}

GET /postings/\{postingId}

Get a single posting by its id.

URL Parameters

NameTypeDescription
postingIdstring

Job posting id.

Example: 39460583579

Query Parameters

NameTypeDescription
noc_versionenum

Specify NOC taxonomy version to use.
This parameter is optional.
Default: ca_noc2021

Must be one of: ca_noc2021

company_versionenum

Specify company taxonomy version to use.
This parameter is optional.
Default: emsi_company

Must be one of: emsi_company

area_versionenumSpecify area taxonomy version to use.
This parameter is optional.
Default: ca_area_sgc2016
Must be one of: ca_area_sgc2016, ca_area_sgc2021
area_ca_versionenum

Specify area taxonomy version to use.
This parameter is optional.
Default: 2021.0.0

Must be one of: 2021.0.0, 2016.0.0

new_taxonomy_versionsenum

Use new taxonomy versions.
This parameter is optional.

Must be one of: true, false

lot_versionenum

Specify LOT taxonomy version to use.
This parameter is optional.
Default: 7

Must be one of: 6, 7

naics_versionenum

Specify NAICS taxonomy version to use.
This parameter is optional.
Default: naics_std_2017

Must be one of: naics_std_2017, naics_std_2022

naics_standard_versionenum

Specify NAICS taxonomy version to use.
This parameter is optional.
Default: 2017.0.1

Must be one of: 2017.0.1, 2022.0.0

Code Examples

curl --request GET \
  --url https://api.lightcast.io/ca-jpa/postings/51813774 \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Response Examples

{
  "data": {
    "body": "<!--id: 49b521d75d2c48678827df5385f5e87f--> Sales Associate Integral Retail Recruitment Inc. Vancouver, BC Job summary + <h5>Salary :</h5> To be discussed + Work schedule : Full time + Job status : Permanent + Work shift : Day , Evening , Weekend Description <h5>SALES - VANCOUVER</h5> Full-Time Sales Consultant - Fashion What you'll need to work for this phenomenal brand? + 2-5 years of sales/customer service experience in high-end service environments + Fashionable, Passion for styling clients + Experience building clientele base + Passion to interreact and have fun with people in a professional, client-focused environment This role will challenge you to provide the best customer service and assist management in running the store successfully. Work for this phenomenal retailer, and expand your career. If you have a passion for fashion, styling people, sales and delivering a wonderful client experience this might be your ideal job! What's in it for you? + Outstanding Base Salary of $14-17/HR + Commission + Hefty Product Discounts + A work environment that encourages work/life balance and career growth Requirements Level of education High school Diploma Completed Work experience (years) 3-5 years Written languages <h5>En :</h5> Intermediate Spoken languages <h5>En :</h5> Intermediate Benefits + Commitment to work-life balance + Commitment to work-life balance + Competitive salary + Competitive salary + On-going training + On-going training Upload your resume",
    "cd": "5915",
    "cd_name": "Greater Vancouver",
    "city": "VmFuY291dmVy",
    "city_name": "Vancouver",
    "cma": "59933",
    "cma_name": "Vancouver",
    "company": "NC5dfa9e8f-c524-4d8b-acfe-ebe88ba453d2",
    "company_is_staffing": false,
    "company_name": "Integral Development Corp.",
    "company_raw": "Integral Retail Recruitment Inc.",
    "csd": "5915022",
    "csd_name": "Vancouver",
    "duplicates": 0,
    "duration": 28,
    "edulevels": [
      0
    ],
    "edulevels_name": [
      "High school or GED"
    ],
    "employment_type": 1,
    "employment_type_name": "Full-time (> 32 hours)",
    "expired": "2019-03-05",
    "id": "49b521d75d2c48678827df5385f5e87f",
    "is_internship": false,
    "location": {
      "lat": 49.28273010253906,
      "lon": -123.120735168457
    },
    "max_years_experience": 5,
    "min_years_experience": 2,
    "naics2": "51",
    "naics2_name": "Information",
    "naics3": "511",
    "naics3_name": "Publishing Industries (except Internet)",
    "naics4": "5112",
    "naics4_name": "Software Publishers",
    "naics5": "51121",
    "naics5_name": "Software Publishers",
    "naics6": "511210",
    "naics6_name": "Software Publishers",
    "noc1": "6",
    "noc1_name": "Sales and service occupations",
    "noc2": "64",
    "noc2_name": "Sales representatives and salespersons - wholesale and retail trade",
    "noc3": "642",
    "noc3_name": "Retail salespersons",
    "noc4": "6421",
    "noc4_name": "Retail salespersons",
    "posted": "2019-02-05",
    "province": "59",
    "province_name": "British Columbia",
    "salary": 32240,
    "score": 1,
    "skills": [
      "KS121Z26S4VJLQ1WXN21",
      "KS1218W78FGVPVP2KXPX",
      "KS123X777H5WFNXQ6BPM"
    ],
    "skills_name": [
      "Customer Service",
      "Management",
      "Sales"
    ],
    "sources": [
      "jobillico.com"
    ],
    "title": "ET80ACB6F6DCD02C9E",
    "title_name": "Sales Associates",
    "title_raw": "Sales Associate",
    "url": [],
    "active_urls": []
  }
}
//Your request wasn't unauthorized.

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized Request",
      "detail": "You are not authorized to access this resource."
    }
  ]
}
//The facet you requested wasn't found.

{
  "errors": [
    {
      "status": 404,
      "title": "URL not found",
      "detail": "Unrecognized facet 'foo'"
    }
  ]
}