Upwork 0.0.0-dev.3

Upwork

C# SDK for the Upwork GraphQL API. The first supported surface is marketplace job search for freelancer workflows.

Features

• Public marketplace job search
• Authenticated marketplace job search with cursor paging, sort attributes, and typed filter builders
• Marketplace job content lookup by job ID
• Proposal metadata lookup and vendor proposal list/detail workflows for freelancers and agencies
• Proposal attachment upload-link and file-confirmation mutation helpers
• Constants for marketplace job types, durations, workloads, experience levels, proposal statuses, and proposal sort fields
• OAuth token exchange helpers for authorization-code, refresh-token, and enterprise client-credentials flows
• Raw GraphQL execution escape hatch for fields that are not yet wrapped
• Source-generated JSON serialization for trimming and NativeAOT compatibility

Usage

using Upwork;

using var client = new UpworkClient(accessToken);

var jobs = await client.SearchMarketplaceJobPostingsAsync(
    UpworkMarketplaceJobFilters.Keywords("dotnet graphql", first: 10) with
    {
        VerifiedPaymentOnly = true,
    },
    sortAttributes:
    [
        new UpworkMarketplaceJobPostingSearchSort(
            UpworkMarketplaceJobPostingSearchSortFields.Recency),
    ]);

For public marketplace search, use SearchPublicMarketplaceJobPostingsAsync with UpworkPublicMarketplaceJobFilter. For freelancer proposal workflows, use GetProposalMetadataAsync, SearchVendorProposalsAsync, and GetVendorProposalAsync. Upwork's public GraphQL docs currently expose proposal attachment helper mutations, but not a vendor proposal submit/update mutation.

Public Marketplace Job Search

Search public marketplace jobs with the Upwork GraphQL API.

using var client = new UpworkClient(accessToken);

// Search current public marketplace jobs.
var response = await client.SearchPublicMarketplaceJobPostingsAsync(
    UpworkPublicMarketplaceJobFilters.Keywords("dotnet graphql", pageSize: 10) with
    {
        JobType = UpworkJobTypes.Fixed,
        VerifiedPaymentOnly = true,
    });

Authenticated Marketplace Job Search

Search marketplace jobs from an authenticated freelancer workflow.

using var client = new UpworkClient(accessToken);

// Search marketplace jobs with cursor pagination and recency sorting.
var response = await client.SearchMarketplaceJobPostingsAsync(
    UpworkMarketplaceJobFilters.Keywords("dotnet graphql", first: 10) with
    {
        VerifiedPaymentOnly = true,
    },
    sortAttributes:
    [
        new UpworkMarketplaceJobPostingSearchSort(
            UpworkMarketplaceJobPostingSearchSortFields.Recency),
    ]);

Marketplace Job Content

Fetch full marketplace job content after finding a job ID from search.

using var client = new UpworkClient(accessToken);

// Find a job, then fetch its content by ID.
var search = await client.SearchMarketplaceJobPostingsAsync(
    new UpworkMarketplaceJobFilter
    {
        SearchExpression = "dotnet",
        Pagination = new UpworkCursorPagination(first: 1),
    });

var firstJob = search.Edges?.FirstOrDefault()?.Node;

var job = await client.GetMarketplaceJobPostingAsync(firstJob.Id!);

Proposal Metadata

Read proposal metadata for freelancer proposal workflows.

using var client = new UpworkClient(accessToken);

// Fetch proposal reference metadata, including engagement durations and decline reasons.
var metadata = await client.GetProposalMetadataAsync(UpworkReasonTypes.ProposalDecline);

Vendor Proposal Search

List vendor proposals for a freelancer or agency account.

using var client = new UpworkClient(accessToken);

// List accepted vendor proposals with cursor pagination.
var response = await client.SearchVendorProposalsAsync(
    UpworkVendorProposalFilters.ByStatus(UpworkProposalStatuses.Accepted),
    pagination: new UpworkCursorPagination(first: 10));

Vendor Proposal Details

Read a vendor proposal after finding it in the freelancer proposal list.

using var client = new UpworkClient(accessToken);

// Find one accepted proposal and then load its detail record.
var response = await client.SearchVendorProposalsAsync(
    UpworkVendorProposalFilters.ByStatus(UpworkProposalStatuses.Accepted),
    pagination: new UpworkCursorPagination(first: 1));

var proposalId = response.Edges?
    .Select(edge => edge.Node?.Id)
    .FirstOrDefault(id => id is { Length: > 0 });

if (proposalId is not { Length: > 0 })
{
    throw new AssertInconclusiveException("No accepted vendor proposals were returned for this account.");
}

var proposal = await client.GetVendorProposalAsync(proposalId);

Support

Priority place for bugs: https://github.com/tryAGI/Upwork/issues
Priority place for ideas and general questions: https://github.com/tryAGI/Upwork/discussions