# Fiverr Search

## Overview

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

## Description

Search Fiverr gigs using a direct search URL and receive paginated listings with seller information, gig titles, images, and seller levels.

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

## Example Response

### Search for website development gigs

```json
{
  "results": [
    {
      "id": 396045309,
      "type": "promoted_gigs",
      "title": "build a wordpress website with unlimited revisions",
      "images": [
        "https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/396045309/original/67ef8fbbbc1e8e64581059c07b4bf314ebd9f88f.png"
      ],
      "gig_url": "https://www.fiverr.com/baptiste_le_b/build-a-wordpress-website-with-unlimited-revisions",
      "position": 0,
      "seller_id": 183755788,
      "seller_name": "baptiste_le_b",
      "seller_image": "https://fiverr-res.cloudinary.com/t_profile_thumb,q_auto,f_auto/attachments/profile/photo/a766b04276bcb7460b1154fa16a9c02c-1837557881743234687.314392/16FFDDA9-C673-44AC-8563-F95713D92A1E",
      "seller_level": "level_one_seller"
    },
    {
      "id": 309994815,
      "type": "fiverr_choice",
      "title": "do wordpress website development, design or redesign wordpress blog",
      "images": [
        "https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/309994815/original/ff1b400db41b15ae7628eb28b8729d0eb83e0eb6.png"
      ],
      "gig_url": "https://www.fiverr.com/woow_web/design-woocommerce-website-wordpress-ecommerce-website-or-online-store",
      "position": 4,
      "seller_id": 136598296,
      "seller_name": "woow_web",
      "seller_image": "https://fiverr-res.cloudinary.com/t_profile_thumb,q_auto,f_auto/attachments/profile/photo/55e0d23f56c7d328f88611e7a5a03930-1722231743932/2b7efd68-95ec-40e3-b8a8-1a2b4e7eac26.png",
      "seller_level": "level_two_seller"
    }
  ],
  "pagination": {
    "next": 2,
    "total": 52533,
    "current": 1,
    "other_pages": [
      2,
      3,
      4,
      5
    ],
    "total_pages": 1095,
    "has_next_page": true
  }
}
```

## Documentation

## Overview
The Fiverr Search endpoint returns paginated gig listings from a Fiverr search URL, with seller details, gig titles, and positioning data.

## Quickstart
```
GET https://api.piloterr.com/v2/fiverr/search?query=https://www.fiverr.com/search/gigs?query=website+development
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Fiverr gig search URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].title` | string | Gig title |
| `results[].seller_name` | string | Seller username |
| `results[].seller_level` | string | Seller level |
| `results[].type` | string | Listing type |
| `pagination.total` | number | Total results |

## Notes
- Append `&page=N` to the URL for pagination.
- Filter by delivery time, seller level, or budget in the URL.

## Main use cases
- Discover top freelancers for a given service category
- Monitor Fiverr keyword rankings for market research
- Build procurement automation for evaluating freelancers at scale
- Enrich internal service directories with live Fiverr data