# Upwork Talent

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/upwork/talent` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/upwork-talent |

## Description

Extract detailed freelancer profiles from Upwork with our API. Access skills, experience, ratings, and more to enhance project success.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/upwork/talent' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "name": "John Doe",
  "title": "Freelance Painter",
  "rating": 4.8,
  "skills": [
    "painting",
    "drawing",
    "illustration",
    "graphic design"
  ],
  "reviews": [
    {
      "rating": 5,
      "comment": "Outstanding work, very satisfied!",
      "reviewer": "Jane Smith"
    },
    {
      "rating": 4,
      "comment": "Great painter, but can improve on communication.",
      "reviewer": "Mike Johnson"
    }
  ],
  "location": {
    "city": "New York",
    "country": "United States"
  },
  "overview": "Experienced painter specialized in various techniques, from traditional to modern styles. Worked with numerous clients globally to deliver high-quality art.",
  "education": [
    {
      "degree": "Bachelor of Fine Arts",
      "institution": "School of Visual Arts",
      "graduationYear": 2014
    }
  ],
  "portfolio": [
    {
      "url": "https://portfolio.example.com/modern-art-collection",
      "title": "Modern Art Collection",
      "description": "A series of modern paintings showcasing abstract and contemporary themes."
    },
    {
      "url": "https://portfolio.example.com/nature-landscapes",
      "title": "Nature Landscapes",
      "description": "A collection of landscape paintings capturing the beauty of nature."
    }
  ],
  "profileId": "~013a130a0d41eefd2a",
  "hourlyRate": 30,
  "jobSuccess": 90,
  "totalEarnings": 10000,
  "employmentHistory": [
    {
      "company": "Art Studio XYZ",
      "duration": "2015-2021",
      "position": "Lead Painter",
      "description": "Led a team of painters, executed numerous high-profile painting projects."
    }
  ]
}
```

## Documentation

## Overview
Extract detailed freelancer profiles from Upwork with our API. Access skills, experience, ratings, and more to enhance project success.

## Quickstart
```
GET https://api.piloterr.com/v2/upwork/talent?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Upwork Talent data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Upwork without maintaining scrapers
- Power internal dashboards and workflow automations with live Upwork data