# Fiverr.com API scraper — live gig search, gig detail and public seller profiles from Fiverr in clean JSON: title, starting price, packages, delivery time, ratings, review counts, seller level and country. No login required.

> Search live Fiverr GIGS by keyword. Returns title, starting price + delivery days, package count, rating, review count, category, gig attributes (style/format/…), images, and the seller's handle, level, country, languages and rating. Paid 'promoted' gigs are dropped by default and flagged when kept.
> ReefAPI engine `fiverr` · 4 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/fiverr/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /fiverr/v1/search — 3 credits
Search live Fiverr GIGS by keyword. Returns title, starting price + delivery days, package count, rating, review count, category, gig attributes (style/format/…), images, and the seller's handle, level, country, languages and rating. Paid 'promoted' gigs are dropped by default and flagged when kept.

**Parameters:**
- `query` (string, required) — Keyword to search Fiverr gigs — e.g. 'logo design', 'python developer', 'voice over'. Fiverr has no keyword-free browse; use the `category` action to walk a category instead.
- `limit` (integer, optional, default 24) — How many gigs to return (1–96). Fiverr serves 48 per page; asking for more walks additional pages.
- `offset` (integer, optional, default 0) — Pagination offset (0–480); skip this many gigs before returning `limit`.
- `include_promoted` (boolean, optional, default false) — Fiverr injects paid 'promoted' gigs into the top of EVERY results page and repeats the same ads across pages. Default false drops them so paging returns new organic gigs; set true to keep them (each row is flagged `is_promoted`).

**Returns:** gigs[]{id, title, slug, url, is_promoted, is_pro, price{from,currency,delivery_days,package_count}, rating, reviews_count, category_id, attributes[], images[], seller{id,username,display_name,country_code,level,rating,ratings_count,languages[],url}}, total_count, returned, offset

**Example request body:**
```json
{
  "query": "logo design",
  "limit": 10
}
```

### POST /fiverr/v1/category — 3 credits
Browse a Fiverr CATEGORY without a keyword — same gig rows as `search`, taken from the category landing page. Use when you want the market for a whole sub-category (e.g. website development) rather than a search term.

**Parameters:**
- `category` (string, required) — Category path to browse, as it appears after /categories/ — e.g. 'graphics-design/creative-logo-design' or 'programming-tech/website-development'. A one-segment path ('graphics-design') redirects to its dominant sub-category.
- `limit` (integer, optional, default 24) — How many gigs to return (1–96). Fiverr serves 48 per page; asking for more walks additional pages.
- `offset` (integer, optional, default 0) — Pagination offset (0–480); skip this many gigs before returning `limit`.
- `include_promoted` (boolean, optional, default false) — Fiverr injects paid 'promoted' gigs into the top of EVERY results page and repeats the same ads across pages. Default false drops them so paging returns new organic gigs; set true to keep them (each row is flagged `is_promoted`).

**Returns:** gigs[]{…same shape as search…}, total_count, returned, offset, category

### POST /fiverr/v1/gig — 2 credits
Full detail for ONE Fiverr gig by URL or '<seller>/<slug>': description, every pricing package (title, price, delivery hours, revisions), FAQ, review summary and the most recent reviews with their order price band, plus the seller block.

**Parameters:**
- `id` (string, required) — The gig to fetch: a full Fiverr gig URL, or '<seller>/<gig-slug>'. A bare numeric gig id is NOT resolvable without the seller handle — take the `url` or `slug`+`seller.username` from a `search` row.

**Returns:** gig{id, title, url, status, category{}, sub_category{}, description, rating, reviews_count, orders_in_queue, packages[]{id,title,price,delivery_hours,revisions}, faq[], reviews_summary{}, reviews[], seller{}}

### POST /fiverr/v1/seller — 2 credits
PUBLIC business profile of a Fiverr seller by handle or profile URL: display name, headline, bio, country, timezone, join date, languages, skills, seller level, Pro/verified flags, response time, hourly rate, rating, review count and the gigs they list.

**Parameters:**
- `username` (string, required) — The seller to fetch: a Fiverr handle or profile URL. Returns the PUBLIC business profile — handle, display name, country, languages, level, ratings and listed gigs.

**Returns:** seller{id, username, display_name, headline, description, country, country_code, timezone, joined_at, languages[], avatar, is_pro, is_verified, is_on_vacation, is_highly_responsive, is_agency, level, response_time_hours, hourly_rate, rating, reviews_count, skills[], gigs[], gigs_count, url}

## More
- Try it live, no code: https://reefapi.com/playground?engine=fiverr
- Human docs page: https://reefapi.com/docs/fiverr
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt