# Fiverr Gig Search API Documentation

Scrappa's `GET /api/fiverr/search` returns public gigs from Fiverr's search page.

## Input

`query`, `category`, `seller_level` and `page` are sent to Fiverr's public search. `price` (maximum USD) and `delivery` (maximum days) filter the returned page locally; they do not change the upstream window. `seller_level` accepts `level_1`, `level_2` and `top_rated`, and matches live `Level One`, `Level Two` and `Top Rated` sellers. Every listed filter is applied before a row is returned. Page N never carries page 1 data. When a local filter is active, `pagination.total` is null and `has_more` still describes the unfiltered upstream window, so a narrow filter can keep only one row while more result pages exist. Prices are quoted in USD. Fiverr publishes a canonical USD amount in the search island. That amount stays the same when the page shows another display currency, so the returned price is the canonical USD value and the display currency is ignored.

## What you get

`data.gigs[]` has `id`, `title`, `url`, `seller` (`name`, `level`, `country`), `price` (`amount`, `currency`), `rating`, `reviews`, `delivery_days` and a full-size `image` URL. `data.pagination` has `page`, `total` and `has_more`, and `data.currency` names the currency. Prices, ratings and review counts are numbers. Fields Fiverr does not publish stay `null`.

## Credits

A successful request costs **1 credit**. Errors and blocks cost nothing. The response shows the charge in `meta.credits_charged`.

- **Documentation:** [https://scrappa.co/docs/fiverr-api/fiverr_search](https://scrappa.co/docs/fiverr-api/fiverr_search)
- **API group:** Fiverr API
- **Endpoint:** `GET https://scrappa.co/api/fiverr/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Keywords for the gig search. |
| `category` | string | No | Fiverr category slug. |
| `price` | number | No | Maximum price in USD. |
| `delivery` | integer | No | Maximum delivery time in days. |
| `seller_level` | string | No | level_1, level_2 or top_rated. |
| `page` | integer | No | Page number, starting at 1. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/fiverr/search?query=logo+design&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "gigs": [
            {
                "id": "seller_user/modern-logo-design",
                "title": "I will design a modern logo",
                "url": "https://www.fiverr.com/seller_user/modern-logo-design",
                "seller": {
                    "name": "seller_user",
                    "level": "Level 2",
                    "country": "US"
                },
                "price": {
                    "amount": 45,
                    "currency": "USD"
                },
                "rating": 4.9,
                "reviews": 320,
                "delivery_days": 3,
                "image": "https://fiverr-res.cloudinary.com/images/t_main1/q_auto/f_auto/v1/-modern-logo.png"
            }
        ],
        "pagination": {
            "page": 1,
            "total": 12000,
            "has_more": true
        },
        "currency": "USD"
    },
    "meta": {
        "endpoint_family": "fiverr.search",
        "billable": true,
        "credits_charged": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing, unknown or unusable. Only page 1 of reviews is public. Non-billable. |
| 503 | Upstream Unavailable | Fiverr blocked the request or could not be reached. Non-billable. Clients are never rate limited. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
