# Fiverr Scraper (`crawlerbros/fiverr-scraper`) Actor Discover Fiverr gig URLs from Fiverr's own public sitemap and fetch full gig details (title, packages, seller, category, rating, price, images) by URL - no login, no cookies, no paid proxy required. - **URL**: https://apify.com/crawlerbros/fiverr-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Developer tools, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Fiverr Scraper Discover Fiverr gig URLs and seller profile URLs from Fiverr's own public sitemaps, and fetch full gig detail records (title, description, category path, pricing packages, rating breakdown, seller card, images, FAQ) — no login, no cookies, no API key, no paid proxy. ### Data Source / Scope **The escalation ladder actually walked, with evidence:** 1. Direct fetch to Fiverr's search/category/homepage routes -> `HTTP 403` (PerimeterX behind Cloudflare, response header `fvrr-bl-route-id: px`). Confirmed with both plain `httpx` and `curl_cffi` `chrome131` TLS impersonation. **No live-search mode is offered** — that route cannot be reached reliably from datacenter infrastructure. Re-verified 2026-07-25: `https://www.fiverr.com/categories/graphics-design` (top-level category browse), `https://www.fiverr.com/categories/graphics-design/creative-logo-design` (sub-category browse), and `https://www.fiverr.com/gigs/` (tag-search results, e.g. `/gigs/logo-design`) all also returned `HTTP 403` on first request — category/tag browse pages sit behind the same PerimeterX challenge as search, so no `byCategory`/`byTag` browse mode is offered either. 2. `https://www.fiverr.com/robots.txt` -> `HTTP 200`, publicly accessible, lists Fiverr's own gig/user/category/tag XML sitemaps. Not behind the PerimeterX challenge. 3. `https://www.fiverr.com/sitemap_gigs.xml.gz` -> sitemap index -> 7 gzip shard files, each listing ~40,000 real, live gig URLs (refreshed daily) plus a preview image per gig. **Confirmed 100% reliable from Apify cloud** (verified run: shard fetch + parse of 43,592 gig URLs completed in ~2s, zero errors). This is the actor's **primary, default mode** (`discoverGigs`). 3b. `https://www.fiverr.com/sitemap_users.xml.gz` -> sitemap index -> 6 gzip shard files, each listing ~50,000 real seller profile URLs (refreshed daily), each with a profile-photo image and Fiverr's internal numeric `user_id`. Same sitemap-host path as (3), same zero-cost Tier-1 reliability (re-verified 2026-07-25: `HTTP 200`, 50,000 parsed entries per shard, zero errors). Exposed as the new **`discoverSellers` mode**. 3c. `https://www.fiverr.com/sitemap_categories.xml.gz` -> a single flat gzip file (no shards), 957 real category/sub-category/nested-sub-category URLs (re-verified 2026-07-26: `HTTP 200`, same zero-anti-bot sitemap-host path as (3)/(3b)): 12 top-level categories (each carrying a numeric `category_id` in its `android-app://` alternate link), 299 sub-categories (each carrying a numeric `sub_category_id`), and 645 nested sub-categories (slug-only at that depth — no id embedded in this sitemap, matching the `nestedSubCategorySlug` a gig's own hydration blob exposes). This is a **listing-only** mode exactly like `discoverGigs`/`discoverSellers` above — it never fetches the category *browse* pages themselves (those remain blocked, see step 1 and "Rejected candidates"), it only parses the sitemap's own URL + numeric-id metadata. Exposed as the new **`discoverCategories` mode**, giving full taxonomy coverage (with real internal IDs) beyond the 12 hardcoded top-level slugs the `category` filter previously offered. 3d. `https://www.fiverr.com/sitemap_tags.xml.gz` -> sitemap index -> 2 gzip shard files, each listing ~50,000 real Fiverr search-tag slugs (`https://www.fiverr.com/gigs/`), refreshed daily (re-verified 2026-07-26: `HTTP 200`, same zero-anti-bot sitemap-host path as (3)/(3b)/(3c), 50,000/50,000 URLs in shard 1 matched the tag-URL pattern). Same **listing-only** contract as the modes above — the tag *search* pages themselves stay blocked (see step 1), only the sitemap's own slug listing is parsed. Exposed as the new **`discoverTags` mode**, giving a browsable/keyword-filterable index into Fiverr's own curated search-tag vocabulary that feeds the `searchKeyword` filter on the other modes. 4. Individual gig detail pages (`https://www.fiverr.com//`) embed real `schema.org` JSON-LD (`Product`, `BreadcrumbList`, `FAQPage`) plus a React-hydration JSON blob (`#perseus-initial-props`) with package/pricing-tier, category-taxonomy, seller-card, and rating-breakdown detail (undocumented shape, best-effort only — see `src/helpers.py` module docstring). **These pages are blocked categorically** — re-verified 2026-07-25 with a fresh 20-URL sample spanning 8 categories (logo design, video editing, voiceover, sound design, virtual assistant, certification consulting, mixing/mastering), fetched both from this project's research machine (plain HTTP, no proxy) and previously from live Apify cloud runs (run ID `V2mMXnxnbgHz0rRbM`, 20/20 attempts `403`, both direct and via 12+ freshly-rotated Apify **AUTO**-group proxy sessions). All 20 URLs in the fresh sample returned `HTTP 403` immediately, with no signal that category, URL depth, or seller tier predicts success — the block is uniform. **Seller profile pages (`https://www.fiverr.com/`) were also tested fresh against the same 20-URL sample's usernames and are equally blocked — all 20/20 returned `HTTP 403` immediately** (see "Rejected candidates" below); this rules out a `sellerProfile` detail-fetch mode. A Google-Translate mirror fetch (`*.translate.goog`) was also tried per the anti-bot decision tree's "third-party mirror" escalation step and returned the same PerimeterX challenge body relayed through Google's fetch, so it does not bypass the block either. This points to a hard block of hosting/cloud/automated-tool traffic (both Apify's own egress and its AUTO datacenter proxy pool, and this project's own research connection) rather than a simple per-IP rate limit. Per this project's zero-cost policy, residential proxies are not an option (they bill per-GB against the free-plan credit), so this is the reliability ceiling for gig-detail fetching from Apify cloud. 5. To audit the full field surface of a successfully-fetched gig page despite the live block, 3 real Fiverr gig pages (different categories: Music & Audio/Mastering, Business/Virtual-Assistant, Music & Audio/Voice-Over) were pulled from `web.archive.org`'s historical snapshots (2024-07 to 2024-10 captures) and their JSON-LD + `perseus-initial-props` blobs audited byte-for-byte. This confirmed: (a) the JSON-LD `Product`/ `BreadcrumbList`/`FAQPage` shape already implemented is complete — no further JSON-LD fields exist; (b) the `perseus-initial-props` blob's `general` section additionally carries `categoryId`/`categorySlug`/ `subCategoryId`/`subCategorySlug`/`nestedSubCategoryId`/ `nestedSubCategorySlug`/`isPro`/`gigStatus` (previously only `gigId` was extracted); (c) a `seller` + `overview.seller` section carries `sellerLevel`, `isVerified`, `completedOrdersCount`, `displayName`, `languages`, `countryCode`, and `profilePhoto` — consistently present across all 3 samples; (d) a `reviews` section carries a real 1-5 star `breakdown` (count per star) and `star_summary` (communication/recommend/ service sub-ratings) — also consistently present; (e) **a real bug**: the package `duration` field is in **hours**, not days as the previous extraction assumed — confirmed because each sample's adjacent SEO `deliveryTime` string (e.g. `"1 day"`/`"2 days"`) exactly matches `duration / 24` (24h -> "1 day", 48h -> "2 days") across all 3 samples in 3 different categories. This has been fixed (see `extract_packages` in `src/helpers.py`) and is no longer mislabeling e.g. a 1-day mastering package as a "24 day" one. **Practical consequence:** `discoverGigs` and `discoverSellers` (sitemap-only, no per-gig/per-seller fetch) are fully reliable and zero-cost. `discoverAndFetchDetails` and `gigDetails` still attempt the fetch (direct-first, AUTO-proxy escalation on `403`, circuit breaker after sustained failure) in case Fiverr's PerimeterX IP-reputation list changes over time, but customers should expect these two modes to frequently return 0 detail records when run from Apify cloud — this is disclosed here rather than silently shipping a broken default. The parsing logic itself (JSON-LD + embedded state -> full record, including the expanded category/seller/rating fields above) is implemented, unit-tested against realistic fixtures modeled on the real captured Fiverr gig pages, and verified end-to-end whenever a page is actually reachable. **Rejected candidates (investigated, not added):** - **`sellerProfile` detail-fetch mode** — rejected. Tested a fresh sample of 20 seller profile URLs (`https://www.fiverr.com/`, one per sampled gig, spanning 8 categories): **20/20 returned `HTTP 403` immediately**, identical to the gig-detail-page block. Seller profile pages sit behind the same PerimeterX challenge as gig pages, not a separate/lighter one — there is no reliability gap to exploit here. - **`byCategory` / `byTag` browse-and-fetch mode** — rejected. The category browse pages (`/categories/[/][/]`) and tag search-result pages (`/gigs/`, from `sitemap_tags.xml.gz`'s 2 shards / 50,000 tag slugs each) are behind the same PerimeterX challenge as `/search` — confirmed `HTTP 403` on direct fetch for 3 category-depth samples and 2 tag samples, re-verified 2026-07-26. **However**, `sitemap_categories.xml.gz` itself (the taxonomy *listing*, not the browse pages it points to) is reliably listable exactly like the gig/user sitemaps — this is now exposed as the **`discoverCategories` mode** (see step 3c above), and `sitemap_tags.xml.gz` (the tag-slug *listing*) is likewise exposed as the **`discoverTags` mode** (see below) — a prior pass rejected `discoverTags` reasoning it added "no new information beyond what a user could already type into `searchKeyword`", but that undersells it the same way a `discoverCategories`-less design would undersell category discovery: a caller can't type a real, high-traffic Fiverr search-tag slug they don't already know exists. `discoverTags` turns the ~100,000-slug tag sitemap into a browsable/keyword-filterable list (with a human-readable `tagName`) that feeds directly into the `searchKeyword` filter on the other modes — re-verified live 2026-07-26: 50,000/50,000 URLs in shard 1 matched the `/gigs/` tag pattern, zero anti-bot risk (sitemap host only, same as gigs/users/categories). - **`sitemap_logomaker_tags.xml.gz`** — re-inspected 2026-07-26 (previously marked "out of scope" for not being gig/seller data — that undersold it the same way `discoverTags` was initially undersold): a flat 1,033-entry `` listing Fiverr's own curated Logo Maker inspiration taxonomy — ~1,014 real `/logo-maker/ideas//` entries across 6 taxonomies (`tag` 730, `industry` 238, `monograms` 26, `brand-values` 9, `style` 6, `symbol-type` 5), each with a real example-logo image + caption. Now exposed as the **`discoverLogoMakerIdeas` mode**. The idea pages themselves (`/logo-maker/ideas/tag/`) are behind the same PerimeterX challenge as every other non-sitemap page (confirmed `HTTP 403` live, 2026-07-26) — listing-only, same pattern as `discoverTags`. **Out of scope, explicitly:** live keyword search against Fiverr's own search endpoint, category/tag browse pages (see "Rejected candidates"), seller profile detail data beyond what the sitemap lists (username, photo, numeric ID — see "Rejected candidates" for why detail-page seller stats aren't independently fetchable), buyer-only data (order history, messages), and anything requiring a logged-in session. ### What this actor does - **7 modes:** - `discoverGigs` (default, reliable) — lists gig URLs from the sitemap only (fast, no per-gig fetch, zero anti-bot risk). - `discoverSellers` (reliable) — lists seller/freelancer profile URLs from Fiverr's own seller sitemap (fast, no per-seller fetch, zero anti-bot risk). - `discoverCategories` (reliable) — lists Fiverr's full category / sub-category / nested-sub-category taxonomy (~950 entries, with real internal numeric IDs for the top 2 levels) from Fiverr's own category sitemap (fast, no per-page fetch, zero anti-bot risk). - `discoverTags` (reliable) — lists Fiverr's own curated search-tag vocabulary (~100,000 real slugs, 2 sitemap shards) from Fiverr's own tag sitemap (fast, no per-page fetch, zero anti-bot risk) — use it to find real keywords for the `searchKeyword` filter on the other modes. - `discoverLogoMakerIdeas` (reliable) — lists Fiverr's Logo Maker inspiration taxonomy (~1,000 entries: tag / industry / style / symbol-type / brand-values logo ideas, each with a real example image) from Fiverr's own Logo Maker ideas sitemap (fast, no per-page fetch, zero anti-bot risk). - `discoverAndFetchDetails` (best-effort) — walks the sitemap and fetches full detail for each discovered gig, up to `maxItems`. - `gigDetails` (best-effort) — fetches full detail for a list of gig URLs you already have. - **Keyword filter** — substring match against the sitemap-derived gig slug, seller username, or tag slug (and, once fetched, the gig title). - **Post-fetch filters** — minimum rating, minimum review count, minimum / maximum starting price (USD), top-level category. - **Category path** — full breadcrumb (category / sub-category / nested sub-category) with names + URLs, straight from Fiverr's own structured data, plus exact machine-matchable `categorySlug`/`subCategorySlug`/ `nestedSubCategorySlug`/`categoryId` fields (used by the `category` filter). - **Seller card** — best-effort seller level, verification status, completed order count, display name, spoken languages, country, and profile photo. - **Rating breakdown** — best-effort per-star review counts (1★–5★) plus communication/recommend/service sub-ratings. - **Package breakdown** — best-effort per-tier pricing (title, price, delivery days, revisions) when Fiverr discloses it on the page; omitted (never fabricated) when it isn't parseable. - **Empty fields are always omitted** — no nulls, no sentinel values. ### Output — discovered gig URL (`recordType: "gigUrl"`) | Field | Description | |---|---| | `gigUrl` | Canonical gig page URL | | `gigId` | Fiverr's internal numeric gig ID, parsed straight from the sitemap's `android-app://` alternate link (always present — no detail fetch required) | | `sellerUsername` | Fiverr username, parsed from the URL | | `sellerProfileUrl` | `https://www.fiverr.com/` | | `gigSlug` | URL slug | | `imageUrl` | First preview image from the sitemap | | `imageUrls[]` | Full image gallery from the sitemap (often more than one) | | `imageCaption` | Caption for the first preview image | | `previewVideo` | `{thumbnailUrl, title, description, playerUrl, category}` — present for gigs with a video preview (~48% of gigs); `playerUrl`/`thumbnailUrl` are directly fetchable, no auth | | `hasVideoPreview` | `true` when `previewVideo` is present | | `sourceSitemapShard` | Which of the 7 gig-sitemap shard files this came from | | `recordType`, `scrapedAt` | | ### Output — discovered seller profile (`recordType: "sellerProfile"`) | Field | Description | |---|---| | `sellerUsername` | Fiverr username | | `sellerProfileUrl` | `https://www.fiverr.com/` | | `sellerId` | Fiverr's internal numeric seller/user ID | | `sellerProfilePhotoUrl` | Profile photo from the sitemap | | `sourceSitemapShard` | Which of the 6 seller-sitemap shard files this came from | | `recordType`, `scrapedAt` | | ### Output — category taxonomy (`recordType: "category"`) | Field | Description | |---|---| | `categoryUrl` | `https://www.fiverr.com/categories/[/][/]` | | `categoryLevel` | `category` / `subCategory` / `nestedSubCategory` | | `name` | Human-readable name, title-cased from the URL slug | | `categorySlug` | Top-level category slug (always present) | | `subCategorySlug` | Present at `subCategory`/`nestedSubCategory` level | | `nestedSubCategorySlug` | Present at `nestedSubCategory` level only | | `categoryId` | Fiverr's internal numeric ID — present at `category` level only | | `subCategoryId` | Fiverr's internal numeric ID — present at `subCategory` level only | | `recordType`, `scrapedAt` | | ### Output — search tag (`recordType: "tag"`) | Field | Description | |---|---| | `tagSlug` | Fiverr's own search-tag slug, e.g. `logo-design` | | `tagName` | Human-readable name, title-cased from the slug | | `tagSearchUrl` | `https://www.fiverr.com/gigs/` (Fiverr's tag search-result page — informational; not fetched by this actor) | | `sourceSitemapShard` | Which of the 2 tag-sitemap shard files this came from | | `recordType`, `scrapedAt` | | ### Output — Logo Maker idea (`recordType: "logoMakerIdea"`) | Field | Description | |---|---| | `ideaSlug` | Logo Maker idea slug, e.g. `zoo`, `kids` | | `ideaType` | `tag` / `industry` / `brandValue` / `style` / `symbolType` | | `ideaName` | Human-readable name, title-cased from the slug | | `ideaUrl` | `https://www.fiverr.com/logo-maker/ideas//` | | `imageUrl` | Example logo image for this idea | | `imageCaption` | Caption for the example image | | `recordType`, `scrapedAt` | | ### Output — gig detail (`recordType: "gigDetail"`) | Field | Description | |---|---| | `sourceUrl` | Canonical gig URL | | `sellerUsername`, `sellerProfileUrl`, `gigSlug` | Parsed from the URL | | `gigId` | Fiverr's internal gig ID (when the page's hydration blob is parseable) | | `gigStatus` | e.g. `approved` | | `title`, `description` | From `Product` JSON-LD (`description` is a short auto-generated SEO summary) | | `fullDescription` | Full seller-written gig description (plain text, stripped of HTML), from the page's own hydration state — materially longer/richer than `description` | | `imageUrl` | Main gig image | | `rating` | 0–5, from `Product.aggregateRating` | | `reviewsCount` | | | `gigCollectedCount` | How many buyers have saved/wishlisted this gig — a popularity signal distinct from `reviewsCount` | | `priceMin`, `priceMax`, `currency` | From `Product.offers` (`AggregateOffer`) | | `packagesCount` | Number of pricing packages Fiverr reports | | `availability` | e.g. `InStock` | | `category`, `categoryUrl` | Top-level category, from the page breadcrumb | | `subCategory`, `subCategoryUrl` | | | `nestedSubCategory`, `nestedSubCategoryUrl` | Present when the gig has a 3rd breadcrumb level | | `categoryPath` | Human-readable `"Category > SubCategory > NestedSubCategory"` | | `categoryId`, `subCategoryId`, `nestedSubCategoryId` | Fiverr's internal numeric taxonomy IDs | | `categorySlug`, `subCategorySlug`, `nestedSubCategorySlug` | Exact slugs matching `sitemap_categories.xml.gz` / `/categories/` URLs; used by the `category` input filter | | `isPro` | Whether this is a Fiverr Pro gig | | `acceptsCustomOrders` | Whether the seller accepts buyer-initiated custom offers on this gig | | `sellerLevel` | e.g. `LEVEL_TRS` (Top Rated Seller), `LEVEL_TWO`, `LEVEL_ONE` | | `sellerIsVerified` | Seller identity-verification status | | `sellerCompletedOrders` | Total completed order count | | `sellerIsHighlyResponsive` | Whether Fiverr flags the seller as highly responsive to buyer messages | | `sellerSkills[]` | `{name, level}` — seller's structured skill tags (e.g. `{"name": "Audio mixing", "level": "PRO"}`) | | `sellerOverallRating`, `sellerOverallReviewsCount` | Seller-wide rating/review count across **all** of the seller's gigs — distinct from the per-gig `rating`/`reviewsCount` above | | `sellerDisplayName` | Seller's public display name | | `sellerLanguages[]` | Spoken-language codes (e.g. `["EN", "HI"]`) | | `sellerCountryCode` | ISO country code | | `sellerProfilePhotoUrl` | Seller's profile photo | | `ratingBreakdown[]` | `{stars, count}` per star value (1–5) | | `communicationRating`, `recommendRating`, `serviceRating` | 0–5 sub-ratings | | `packages[]` | `{tier, title, description, priceUsd, deliveryDays, revisions, extraFastDeliveryPriceUsd, extraFastDeliveryDays}` — best-effort, omitted if not parseable. `extraFastDelivery*` fields appear only when faster delivery is a paid upsell on that tier (omitted when already bundled in) | | `minDeliveryDays` | Fastest package's delivery time, in days | | `gigExtras[]` | `{name, description, priceUsd, extraDeliveryDays}` — buyer-facing paid add-ons (e.g. "More Stems", "24 Bit Wave"), deduped across package tiers | | `faq[]` | `{question, answer}` — from the page's JSON-LD FAQPage block, falling back to the hydration state's own FAQ section (identical content) when JSON-LD is absent | | `gigTags[]` | Fiverr's own per-gig search-tag assignment (e.g. `["hip hop", "mixing", "mastering"]`) | | `gigGallery[]` | `{slideType, title, mediaUrl, thumbnailUrl, videoUrl, audioUrl, isWorkSample}` — the gig's full media gallery (intro video, audio samples, work images), best-effort | | `sellerOtherGigIds[]` | Other real gig IDs by the same seller | | `sellerPortfolioProjects[]` | `{title, imageUrl}` — real portfolio project samples the seller has attached to this gig category | | `sellerPortfolioProjectsCount` | Total portfolio project count reported by Fiverr | | `relatedServiceTypes[]` | `{serviceTypeName, serviceSlug, startPriceUsd}` — Fiverr's own "other service types in this sub-category" cross-sell widget (e.g. a Mixing gig surfaces the Mastering service type with its real starting price) | | `relatedSubCategoryName` | Sub-category name the related service types belong to | | `recordType`, `scrapedAt` | | ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | select | `discoverGigs` | `discoverGigs` / `discoverSellers` / `discoverCategories` / `discoverTags` / `discoverLogoMakerIdeas` / `discoverAndFetchDetails` / `gigDetails` | | `searchKeyword` | string | – | Substring filter against gig slug/seller username/category URL/tag slug/logo-idea slug/title | | `gigUrls` | array | `[]` | Gig URLs (mode=`gigDetails`) | | `maxShards` | int | `1` | How many gig-sitemap (max 7), seller-sitemap (max 6), or tag-sitemap (max 2) shard files to scan | | `categoryLevel` | select | – | Taxonomy level filter (mode=`discoverCategories`): `category` / `subCategory` / `nestedSubCategory` | | `ideaType` | select | – | Logo Maker idea taxonomy filter (mode=`discoverLogoMakerIdeas`): `tag` / `industry` / `brandValue` / `style` / `symbolType` | | `minRating` | number | – | Minimum rating (0–5), applied after fetching detail | | `minReviews` | int | – | Minimum review count | | `minPriceUsd` / `maxPriceUsd` | number | – | Starting-price range (USD) | | `category` | select | – | Top-level category slug filter (e.g. `music-audio`) — applied after fetching detail, or directly against `discoverCategories`' own taxonomy listing | | `includePackages` | bool | `true` | Include per-package pricing breakdown | | `includeFaq` | bool | `true` | Include FAQ list | | `maxItems` | int | `20` | Hard cap on emitted records (1–500) | #### Example: discover + fetch logo-design gigs ```json { "mode": "discoverAndFetchDetails", "searchKeyword": "logo", "maxShards": 2, "maxItems": 20 } ```` #### Example: fetch details for specific gig URLs ```json { "mode": "gigDetails", "gigUrls": [ "https://www.fiverr.com/michael7878/master-your-song-in-1-day" ] } ``` #### Example: discover sellers matching a keyword ```json { "mode": "discoverSellers", "searchKeyword": "design", "maxShards": 2, "maxItems": 20 } ``` #### Example: full category taxonomy tree ```json { "mode": "discoverCategories", "maxItems": 500 } ``` #### Example: sub-categories of one top-level category ```json { "mode": "discoverCategories", "category": "music-audio", "categoryLevel": "subCategory", "maxItems": 100 } ``` #### Example: discover real search-tag keywords for "tax" gigs ```json { "mode": "discoverTags", "searchKeyword": "tax", "maxShards": 2, "maxItems": 100 } ``` ### Reliability notes - No login, no cookies, no API key, no paid/residential proxy — runs on the Apify free plan. - Sitemap fetches (robots.txt, sitemap index, shard files — gig or seller) are not behind the PerimeterX challenge and are reliably Tier-1 (plain HTTP, no proxy). - Individual gig-detail fetches use direct HTTP first and escalate to a free Apify **AUTO**-group proxy session only on `403`, with exponential backoff on `429`/`5xx` and a circuit breaker that stops escalating after sustained failure so a run never hangs indefinitely on a single blocked stretch. - Because gig pages sit behind a request-velocity-sensitive anti-bot wall, per-run gig-detail yield can vary run to run; `discoverGigs` and `discoverSellers` modes (sitemap only, no per-page fetch) are unaffected and always reliable. ### Use cases - **Freelance marketplace research** — bulk-list live Fiverr gig and seller URLs by category or keyword to size a niche before entering it. - **Lead generation for agencies** — discover seller profiles in a given category (e.g. `video-animation`) as an outreach or partnership list. - **Pricing intelligence** — pull `priceMin`/`priceMax`/`packages[]` from successfully-fetched gig details to benchmark competitor pricing. - **SEO / keyword research** — use `discoverTags` to find Fiverr's own curated, high-traffic search-tag vocabulary for a niche. - **Taxonomy / catalog mapping** — use `discoverCategories` to get Fiverr's full category tree with real internal numeric IDs. - **Logo/brand design inspiration tools** — use `discoverLogoMakerIdeas` to power a mood-board or naming tool with Fiverr's own curated idea taxonomy. ### FAQ **Is this affiliated with Fiverr?** No. This is an independent third-party actor that reads Fiverr's own public sitemap files and, best-effort, individual gig pages. It is not affiliated with, endorsed by, or supported by Fiverr International Ltd. **Why do `discoverAndFetchDetails` and `gigDetails` sometimes return 0 detail records?** Fiverr's individual gig and seller-profile pages are protected by PerimeterX, which has been confirmed (via repeated live cloud runs, most recently 2026-07-26) to block every tested Apify source IP, direct and proxied alike. The actor still attempts the fetch with automatic retries and proxy escalation in case that changes, but you should treat these two modes as best-effort. `discoverGigs`, `discoverSellers`, `discoverCategories`, `discoverTags`, and `discoverLogoMakerIdeas` are unaffected — they read sitemap files only and are 100% reliable. **Why is there no live keyword-search mode?** Fiverr's own search, category-browse, and tag-browse pages return `HTTP 403` to automated traffic before any results ever render — there's no reliable way to query them from Apify infrastructure. The `searchKeyword` filter is a substring match against sitemap-derived slugs/usernames/titles instead, and `discoverTags` gives you Fiverr's own real tag vocabulary to search with. **Why are some `gigDetail` fields missing on a given record?** Every detail field is parsed best-effort from the gig page's own structured data (JSON-LD + hydration state). Fields that aren't present or parseable on a given page are omitted — never filled with a placeholder or guessed value. **What does `maxShards` control, and why start at 1?** Fiverr splits each sitemap into multiple gzip shard files (7 for gigs, 6 for sellers, 2 for tags). Each shard holds tens of thousands of URLs, so a single shard is usually enough to satisfy `maxItems`; raising `maxShards` widens the pool scanned before the keyword filter and `maxItems` cap are applied, at the cost of more download/parse time. **How fresh is the sitemap data?** Fiverr regenerates its sitemap files daily, so gig/seller/category/tag listings reflect Fiverr's live catalog as of the most recent regeneration. **Are `categoryId` / `subCategoryId` / `nestedSubCategoryId` always present?** `categoryId` and `subCategoryId` are present whenever Fiverr's sitemap or gig page exposes them (always for `discoverCategories` at those two levels; best-effort for `gigDetail`). `nestedSubCategoryId` is not embedded in Fiverr's own category sitemap, so `discoverCategories` nested-level records carry a slug only — `gigDetail` records can still surface it when the gig page's own hydration state includes it. **Does this actor require login, cookies, or a paid proxy?** No. Every mode runs with plain HTTP requests and, only on `403` during detail fetches, a free Apify `AUTO`-group datacenter proxy session — no residential proxy, no cookies, no API key. # Actor input Schema ## `mode` (type: `string`): What to run. `discoverGigs` (recommended, 100% reliable, zero-cost) lists real gig URLs straight from Fiverr's own sitemap. `discoverSellers` (also 100% reliable, zero-cost) lists real seller/freelancer profile URLs straight from Fiverr's own seller sitemap. `discoverCategories` (also 100% reliable, zero-cost) lists Fiverr's full category/sub-category/nested-sub-category taxonomy (~950 entries with numeric category IDs) straight from Fiverr's own category sitemap. `discoverTags` (also 100% reliable, zero-cost) lists Fiverr's own curated search-tag vocabulary (~100,000 real tag slugs, e.g. `logo-design`, `wordpress-website`) straight from Fiverr's own tag sitemap — use it to discover real, high-traffic keywords for the `searchKeyword` filter on the other modes. `discoverLogoMakerIdeas` (also 100% reliable, zero-cost) lists Fiverr's Logo Maker inspiration taxonomy (~1,000 entries: tag/industry/style/symbol-type/brand-values logo ideas, each with a real example image) straight from Fiverr's own Logo Maker ideas sitemap. `discoverAndFetchDetails` additionally fetches full details per gig, but Fiverr's gig detail pages are behind PerimeterX and have been confirmed (via live cloud runs, re-verified 2026-07-25) to block ALL tested source IPs, direct and proxied alike — this mode is best-effort and may return 0 detail records. `gigDetails` fetches full details for a list of gig URLs you already have (same best-effort caveat). See README 'Data Source / Scope' for the full evidence. ## `searchKeyword` (type: `string`): Only keep gigs/sellers/categories/tags/logo-ideas whose URL slug (or, once fetched, gig title) contains this keyword. Case-insensitive. Leave empty for no filtering. Note: this is a substring match against Fiverr's sitemap-derived gig slugs, seller usernames, category URLs, tag slugs, or logo-idea slugs, not a live Fiverr search (Fiverr's own search endpoint is blocked to automated traffic). Tip: run mode=discoverTags first to find real Fiverr search-tag slugs to use here. ## `gigUrls` (type: `array`): Full Fiverr gig URLs to fetch details for, e.g. `https://www.fiverr.com/username/gig-slug`. Required for mode=gigDetails. ## `maxShards` (type: `integer`): Fiverr splits its gig sitemap into 7 gzip shard files (~40,000 gig URLs each), its seller sitemap into 6 gzip shard files (~50,000 seller URLs each), and its tag sitemap into 2 gzip shard files (~50,000 tag slugs each), all refreshed daily. Higher values scan more of the catalog but take longer to download/parse. Used by discoverGigs / discoverAndFetchDetails (gig shards, max 7), discoverSellers (seller shards, max 6), and discoverTags (tag shards, max 2) — values above the available shard count are simply capped. ## `categoryLevel` (type: `string`): Only keep entries at this level of the category taxonomy. Leave empty to list all 3 levels together. ## `ideaType` (type: `string`): Only keep Logo Maker idea entries of this taxonomy type. Leave empty to list all types together. ## `category` (type: `string`): Only keep gigs in this top-level Fiverr category. Matched against the gig's own `categorySlug` — for mode=discoverAndFetchDetails/gigDetails this is extracted from the fetched gig page and skipped (passed through) for gigs where that field couldn't be parsed; for mode=discoverCategories it filters the taxonomy listing to just this top-level category's own tree. Leave empty for no filtering. ## `minRating` (type: `number`): Only keep gigs with an average rating at or above this value (0-5). Only applies once gig details are fetched (mode=gigDetails / discoverAndFetchDetails). ## `minReviews` (type: `integer`): Only keep gigs with at least this many reviews. Only applies once gig details are fetched. ## `minPriceUsd` (type: `number`): Only keep gigs whose lowest package price is at or above this amount (USD). Only applies once gig details are fetched. ## `maxPriceUsd` (type: `number`): Only keep gigs whose lowest package price is at or below this amount (USD). Only applies once gig details are fetched. ## `includePackages` (type: `boolean`): Include the per-package (Basic/Standard/Premium or custom tier) pricing breakdown when Fiverr discloses it on the gig page. ## `includeFaq` (type: `boolean`): Include the gig's public FAQ question/answer list when present on the page. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "discoverGigs", "searchKeyword": "logo", "gigUrls": [], "maxShards": 1, "categoryLevel": "", "ideaType": "", "category": "", "includePackages": true, "includeFaq": true, "maxItems": 20 } ``` # Actor output Schema ## `gigs` (type: `string`): Dataset containing all discovered gig URLs, discovered seller profile URLs, discovered category taxonomy entries, and/or fetched gig detail records. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "discoverGigs", "searchKeyword": "logo", "gigUrls": [], "maxShards": 1, "categoryLevel": "", "ideaType": "", "category": "", "includePackages": true, "includeFaq": true, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/fiverr-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "discoverGigs", "searchKeyword": "logo", "gigUrls": [], "maxShards": 1, "categoryLevel": "", "ideaType": "", "category": "", "includePackages": True, "includeFaq": True, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/fiverr-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "discoverGigs", "searchKeyword": "logo", "gigUrls": [], "maxShards": 1, "categoryLevel": "", "ideaType": "", "category": "", "includePackages": true, "includeFaq": true, "maxItems": 20 }' | apify call crawlerbros/fiverr-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/fiverr-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Fiverr Scraper", "description": "Discover Fiverr gig URLs from Fiverr's own public sitemap and fetch full gig details (title, packages, seller, category, rating, price, images) by URL - no login, no cookies, no paid proxy required.", "version": "1.0", "x-build-id": "jlXvJko3ffxUfRTjX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~fiverr-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-fiverr-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~fiverr-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-fiverr-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~fiverr-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-fiverr-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "discoverGigs", "discoverSellers", "discoverCategories", "discoverTags", "discoverLogoMakerIdeas", "discoverAndFetchDetails", "gigDetails" ], "type": "string", "description": "What to run. `discoverGigs` (recommended, 100% reliable, zero-cost) lists real gig URLs straight from Fiverr's own sitemap. `discoverSellers` (also 100% reliable, zero-cost) lists real seller/freelancer profile URLs straight from Fiverr's own seller sitemap. `discoverCategories` (also 100% reliable, zero-cost) lists Fiverr's full category/sub-category/nested-sub-category taxonomy (~950 entries with numeric category IDs) straight from Fiverr's own category sitemap. `discoverTags` (also 100% reliable, zero-cost) lists Fiverr's own curated search-tag vocabulary (~100,000 real tag slugs, e.g. `logo-design`, `wordpress-website`) straight from Fiverr's own tag sitemap — use it to discover real, high-traffic keywords for the `searchKeyword` filter on the other modes. `discoverLogoMakerIdeas` (also 100% reliable, zero-cost) lists Fiverr's Logo Maker inspiration taxonomy (~1,000 entries: tag/industry/style/symbol-type/brand-values logo ideas, each with a real example image) straight from Fiverr's own Logo Maker ideas sitemap. `discoverAndFetchDetails` additionally fetches full details per gig, but Fiverr's gig detail pages are behind PerimeterX and have been confirmed (via live cloud runs, re-verified 2026-07-25) to block ALL tested source IPs, direct and proxied alike — this mode is best-effort and may return 0 detail records. `gigDetails` fetches full details for a list of gig URLs you already have (same best-effort caveat). See README 'Data Source / Scope' for the full evidence.", "default": "discoverGigs" }, "searchKeyword": { "title": "Keyword filter (mode=discoverGigs / discoverSellers / discoverCategories / discoverTags / discoverLogoMakerIdeas / discoverAndFetchDetails)", "type": "string", "description": "Only keep gigs/sellers/categories/tags/logo-ideas whose URL slug (or, once fetched, gig title) contains this keyword. Case-insensitive. Leave empty for no filtering. Note: this is a substring match against Fiverr's sitemap-derived gig slugs, seller usernames, category URLs, tag slugs, or logo-idea slugs, not a live Fiverr search (Fiverr's own search endpoint is blocked to automated traffic). Tip: run mode=discoverTags first to find real Fiverr search-tag slugs to use here.", "default": "" }, "gigUrls": { "title": "Gig URLs (mode=gigDetails)", "type": "array", "description": "Full Fiverr gig URLs to fetch details for, e.g. `https://www.fiverr.com/username/gig-slug`. Required for mode=gigDetails.", "default": [], "items": { "type": "string" } }, "maxShards": { "title": "Sitemap shards to scan", "minimum": 1, "maximum": 7, "type": "integer", "description": "Fiverr splits its gig sitemap into 7 gzip shard files (~40,000 gig URLs each), its seller sitemap into 6 gzip shard files (~50,000 seller URLs each), and its tag sitemap into 2 gzip shard files (~50,000 tag slugs each), all refreshed daily. Higher values scan more of the catalog but take longer to download/parse. Used by discoverGigs / discoverAndFetchDetails (gig shards, max 7), discoverSellers (seller shards, max 6), and discoverTags (tag shards, max 2) — values above the available shard count are simply capped.", "default": 1 }, "categoryLevel": { "title": "Category taxonomy level filter (mode=discoverCategories)", "enum": [ "", "category", "subCategory", "nestedSubCategory" ], "type": "string", "description": "Only keep entries at this level of the category taxonomy. Leave empty to list all 3 levels together.", "default": "" }, "ideaType": { "title": "Logo Maker idea taxonomy filter (mode=discoverLogoMakerIdeas)", "enum": [ "", "tag", "industry", "brandValue", "style", "symbolType" ], "type": "string", "description": "Only keep Logo Maker idea entries of this taxonomy type. Leave empty to list all types together.", "default": "" }, "category": { "title": "Category filter (mode=discoverAndFetchDetails / gigDetails / discoverCategories)", "enum": [ "", "graphics-design", "online-marketing", "writing-translation", "video-animation", "music-audio", "programming-tech", "data", "business", "lifestyle", "photography", "finance", "end-to-end-projects" ], "type": "string", "description": "Only keep gigs in this top-level Fiverr category. Matched against the gig's own `categorySlug` — for mode=discoverAndFetchDetails/gigDetails this is extracted from the fetched gig page and skipped (passed through) for gigs where that field couldn't be parsed; for mode=discoverCategories it filters the taxonomy listing to just this top-level category's own tree. Leave empty for no filtering.", "default": "" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only keep gigs with an average rating at or above this value (0-5). Only applies once gig details are fetched (mode=gigDetails / discoverAndFetchDetails)." }, "minReviews": { "title": "Minimum review count", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only keep gigs with at least this many reviews. Only applies once gig details are fetched." }, "minPriceUsd": { "title": "Minimum starting price (USD)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Only keep gigs whose lowest package price is at or above this amount (USD). Only applies once gig details are fetched." }, "maxPriceUsd": { "title": "Maximum starting price (USD)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Only keep gigs whose lowest package price is at or below this amount (USD). Only applies once gig details are fetched." }, "includePackages": { "title": "Include package/pricing-tier breakdown", "type": "boolean", "description": "Include the per-package (Basic/Standard/Premium or custom tier) pricing breakdown when Fiverr discloses it on the gig page.", "default": true }, "includeFaq": { "title": "Include FAQ section", "type": "boolean", "description": "Include the gig's public FAQ question/answer list when present on the page.", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```