Is there a way to search through job postings with new Upwork GraphQL API?

Question

Since Upwork is deprecating REST API support on December 15, I've started refactoring my application to support new GraphQL API. My main REST API requests are:

Search Jobs: GET /api/profiles/v2/search/jobs.{format}
Get Job Profile: GET /api/profiles/v1/jobs/{job_key}.{format}

The problem is, GraphQL API Docs does not seem to have similar requests in "Search" directory. Only thing I can search through, on a date of writing this question, are "freelancerProfileRecords". I can indeed get information about a specific job post using it's ID - it's written in API docs, but this does not cover my needs, and makes migration from REST API frustrating.

I need to have a filter mechanism using params such as: "title", "skills", "q" and so on, like it is written in REST docs here.

Is there a workaround, or did I just miss something?

Answer 1

I'm running into the same issue. I found this online, but am still waiting on authorization for my API Key to be able to test if it works...

---

Construct the GraphQL query: Once authenticated, you can create a GraphQL query to search for jobs. Since the GraphQL API does not provide a direct way to filter jobs, you will need to fetch a list of jobs and then filter them based on your criteria in your application. Here's an example of a GraphQL query to fetch a list of jobs:

query {
  jobPostings(first: 10) {
    edges {
      node {
        id
        title
        skills
        budget {
          amount
          currency
        }
        location {
          country
          city
        }
        duration
      }
    }
  }
}

This query supposedly fetches the first 10 job postings along with their ID, title, skills, budget, location, and duration.

Answer 2

Upwork has just added such a functionality to its GraphQL API. The query with no filters that returns job ID, title, creation date and description for the 10 most recent posts is:

query {
  marketplaceJobPostings(
    marketPlaceJobFilter: { searchTerm_eq: { andTerms_all: "" } }
    searchType: USER_JOBS_SEARCH
    sortAttributes: { field: CREATE_TIME, sortOrder: DESC }
  ) {
    edges {
      node {
        id
        title
        createdDateTime
        description
      }
    }
  }
}

The filters object has been added to the docs.

Also, don't forget to request a new permission for your API key, its under GraphQL tab in your API Key details and called "Read marketplace Job Postings - Public".

UPDATE: It seems the Upwork team is actively working on their GraphQL API, as of February 9, 2024, the correct query is:

query {
  marketplaceJobPostings(
    searchType: USER_JOBS_SEARCH
    sortAttributes: { field: RECENCY }
  ) {
    edges {
      node {
        id
        title
        createdDateTime
        description
      }
    }
  }
}