# Upwork Search

## Overview

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

## Description

Effortlessly extract detailed freelance painter profiles from Upwork for recruitment, market analysis, and more with our Upwork Search API.

## 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "query": "painter",
  "results": [
    {
      "name": "John Doe",
      "title": "Freelance Painter",
      "location": "San Francisco, United States",
      "description": "Experienced painter with over 15 years in the industry, specializing in residential and commercial projects.",
      "hourly_rate": "$25/hr",
      "profile_link": "https://www.upwork.com/freelancers/johndoe",
      "experience_level": "Expert",
      "job_success_score": "90%"
    },
    {
      "name": "Jane Smith",
      "title": "Professional Artist and Painter",
      "location": "Chicago, United States",
      "description": "Creative artist with a passion for painting, offering a unique blend of technical skill and creative vision.",
      "hourly_rate": "$30/hr",
      "profile_link": "https://www.upwork.com/freelancers/janesmith",
      "experience_level": "Intermediate",
      "job_success_score": "88%"
    },
    {
      "name": "Alice Johnson",
      "title": "Painter and Illustrator",
      "location": "New York, United States",
      "description": "Aspiring painter and illustrator with a fresh approach to artistic expression, eager to take on new challenges.",
      "hourly_rate": "$20/hr",
      "profile_link": "https://www.upwork.com/freelancers/alicejohnson",
      "experience_level": "Beginner",
      "job_success_score": "75%"
    }
  ],
  "total_results": 3
}
```

## Documentation

## Overview
Effortlessly extract detailed freelance painter profiles from Upwork for recruitment, market analysis, and more with our Upwork Search API.

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

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

## Main use cases
- Integrate Upwork Search 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