Upwork · JSON Structure

Graphql Freelancer Profile Structure

A freelancer profile on Upwork

Type: object Properties: 11
FreelancingJobsTalentMarketplaceContractsHiring

FreelancerProfile is a JSON Structure definition published by Upwork, describing 11 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id name title description rate currency rating jobsCompleted skills country availability

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/upwork/refs/heads/main/json-structure/graphql-freelancer-profile-structure.json",
  "name": "FreelancerProfile",
  "description": "A freelancer profile on Upwork",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the freelancer",
      "example": "~abc123"
    },
    "name": {
      "type": "string",
      "description": "Full name of the freelancer",
      "example": "Jane Smith"
    },
    "title": {
      "type": "string",
      "description": "Professional title or headline",
      "example": "Senior Python Developer"
    },
    "description": {
      "type": "string",
      "description": "Profile overview/bio",
      "example": "Experienced Python developer with 8 years..."
    },
    "rate": {
      "type": "double",
      "description": "Hourly rate",
      "example": 75.0
    },
    "currency": {
      "type": "string",
      "description": "Rate currency",
      "example": "USD"
    },
    "rating": {
      "type": "double",
      "description": "Average client rating (0-5)",
      "example": 4.95
    },
    "jobsCompleted": {
      "type": "int32",
      "description": "Total number of completed jobs",
      "example": 48
    },
    "skills": {
      "type": "array",
      "description": "Skills listed on the profile",
      "items": {
        "type": "string"
      },
      "example": [
        "Python",
        "Machine Learning",
        "Data Science"
      ]
    },
    "country": {
      "type": "string",
      "description": "Country of the freelancer",
      "example": "US"
    },
    "availability": {
      "type": "string",
      "description": "Current availability status",
      "enum": [
        "full-time",
        "part-time",
        "not-available"
      ],
      "example": "full-time"
    }
  }
}