Fiverr Gig & Seller Sitemap Directory Scraper: MCP config, n8n workflow and API

{
  "mode": "sitemapDirectory",
  "searchQueries": [
    "logo design"
  ],
  "sitemapType": "gigs",
  "searchKeyword": "logo",
  "maxShards": 1,
  "sortBy": "relevance",
  "deliveryTime": "any",
  "proOnly": false,
  "onlineOnly": false,
  "agencyOnly": false,
  "hourlyOnly": false,
  "includeGigDetails": false,
  "includePackages": true,
  "includeFaq": true,
  "includeSellerGigs": true,
  "includeSellerReviews": true,
  "includeMarketSummary": false,
  "maxPagesPerQuery": 1,
  "maxItems": 3
}

---
name: fiverr-gig-and-seller-sitemap-directory-scraper
description: "Fiverr gig search results, full gig details, seller profiles, and sitemap directory records with pricing, packages, ratings, reviews, seller levels and taxonomy data. Runs the Apify Actor vexaloom-labs/fiverr-gig-and-seller-sitemap-directory-scraper. Use when the user needs Fiverr data with fields such as recordType, title, gigUrl, sellerUsername, sellerLevel, category and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "vexaloom-labs/fiverr-gig-and-seller-sitemap-directory-scraper"
  store-url: "https://apify.com/vexaloom-labs/fiverr-gig-and-seller-sitemap-directory-scraper"
---

# Fiverr Gig & Seller Sitemap Directory Scraper

Use this skill to fetch Fiverr data with the Apify Actor `vexaloom-labs/fiverr-gig-and-seller-sitemap-directory-scraper` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | string, required | What to run. `search` searches Fiverr by keyword or browses search/category URLs. `gigDetails` fetches full details for gig URLs. `sellerProfiles` fetches seller profiles. `sitemapDirectory` lists entries from Fiverr's public sitemaps. |
| `searchQueries` | array | Keywords to search on Fiverr (mode=search), e.g. `logo design` or `voice over`. One search is run per query. |
| `searchUrls` | array | Fiverr search or category URLs to browse (mode=search), e.g. `https://www.fiverr.com/search/gigs?query=logo%20design` or a `/categories/...` URL. Filters already in the URL are preserved. |
| `gigUrls` | array | Full Fiverr gig URLs to fetch, e.g. `https://www.fiverr.com/username/gig-slug` (mode=gigDetails). |
| `sellerUrls` | array | Fiverr seller usernames or profile URLs, e.g. `michael7878` or `https://www.fiverr.com/michael7878` (mode=sellerProfiles). |
| `sitemapType` | one of `gigs`, `sellers`, `categories`, `tags`, `logomakerIdeas` | Which Fiverr sitemap directory to list (mode=sitemapDirectory). |
| `searchKeyword` | string | Only keep sitemap entries whose URL or slug contains this keyword (mode=sitemapDirectory). Also filters gig titles in detail and search modes when set. Case-insensitive. Leave empty for no filtering. |
| `maxShards` | integer | Number of sitemap shard files to scan for gigs (up to 7), sellers (up to 6) or tags (up to 2). Values above the available shard count are capped. |
| `categoryLevel` | one of `category`, `subCategory`, `nestedSubCategory` | Only keep category entries at this level (mode=sitemapDirectory, sitemapType=categories). |
| `ideaType` | one of `tag`, `industry`, `monogram`, `brandValue`, `style`, `symbolType` | Only keep Logo Maker entries of this type (mode=sitemapDirectory, sitemapType=logomakerIdeas). |
| `category` | string | Only keep results in this Fiverr category. Applies to category directory entries, and to gig details and enriched search results when the page reports that category slug. Leave empty for all categories. |
| `sortBy` | one of `relevance`, `best_selling`, `price_low_to_high`, `price_high_to_low`, `newest` | Sort live search results (mode=search). |
| `sellerLevels` | array | Keep only these seller levels (mode=search). Values: `top_rated_seller`, `level_two_seller`, `level_one_seller`, `na` (new seller). Leave empty for all levels. |
| `sellerLanguages` | array | Keep only sellers who speak these languages (mode=search), using ISO codes such as `en`, `es`, `de`, `fr`, `hi`, `ur`. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "sitemapDirectory",
  "searchQueries": [
    "logo design"
  ],
  "sitemapType": "gigs",
  "searchKeyword": "logo",
  "maxShards": 1,
  "sortBy": "relevance",
  "deliveryTime": "any",
  "proOnly": false,
  "onlineOnly": false,
  "agencyOnly": false,
  "hourlyOnly": false,
  "includeGigDetails": false,
  "includePackages": true,
  "includeFaq": true,
  "includeSellerGigs": true,
  "includeSellerReviews": true,
  "includeMarketSummary": false,
  "maxPagesPerQuery": 1,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/vexaloom-labs~fiverr-gig-and-seller-sitemap-directory-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/vexaloom-labs~fiverr-gig-and-seller-sitemap-directory-scraper/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `recordType`, `title`, `gigUrl`, `sellerUsername`, `sellerLevel`, `category`, `subCategory`, `priceMin`, `priceMax`, `currency`, `rating`, `reviewsCount`, `sellerCountryCode`, `sourceUrl`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.