Use Fiverr Gig & Seller Sitemap Directory Scraper with Python
List live Fiverr gigs, seller profiles, categories, search tags and Logo Maker ideas straight from Fiverr's own directories, with best-effort full gig detail by URL.
1. Choose the data you need
Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.
2. Prepare a source-based input
This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.
{
"agencyOnly": false,
"category": "",
"categoryLevel": "",
"deliveryTime": "any",
"facets": [],
"gigUrls": [],
"hourlyOnly": false,
"ideaType": "",
"includeFaq": true,
"includeGigDetails": false,
"includeMarketSummary": false,
"includePackages": true,
"includeSellerGigs": true,
"includeSellerReviews": true,
"maxItems": 3,
"maxPagesPerQuery": 1,
"maxShards": 1,
"mode": "sitemapDirectory",
"onlineOnly": false,
"proOnly": false,
"searchKeyword": "logo",
"searchQueries": [
"logo design"
],
"searchUrls": [],
"sellerCountries": [],
"sellerLanguages": [],
"sellerLevels": [],
"sellerUrls": [],
"sitemapType": "gigs",
"sortBy": "relevance"
}
Download input.example.json and save your reviewed copy as input.json.
| Field | Type | Required | Description |
|---|---|---|---|
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. Legacy mode names are accepted and mapped automatically. |
searchQueries | array | optional | Keywords to search on Fiverr (mode=search), e.g. `logo design` or `voice over`. One search is run per query. |
searchUrls | array | optional | 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 | optional | Full Fiverr gig URLs to fetch, e.g. `https://www.fiverr.com/username/gig-slug` (mode=gigDetails). |
sellerUrls | array | optional | Fiverr seller usernames or profile URLs, e.g. `michael7878` or `https://www.fiverr.com/michael7878` (mode=sellerProfiles). |
sitemapType | string | optional | Which Fiverr sitemap directory to list (mode=sitemapDirectory). |
searchKeyword | string | optional | 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 | optional | 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 | string | optional | Only keep category entries at this level (mode=sitemapDirectory, sitemapType=categories). |
ideaType | string | optional | Only keep Logo Maker entries of this type (mode=sitemapDirectory, sitemapType=logomakerIdeas). |
category | string | optional | 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 | string | optional | Sort live search results (mode=search). |
sellerLevels | array | optional | 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 | optional | Keep only sellers who speak these languages (mode=search), using ISO codes such as `en`, `es`, `de`, `fr`, `hi`, `ur`. |
sellerCountries | array | optional | Keep only sellers living in these countries (mode=search), using ISO-2 codes such as `US`, `GB`, `DE`, `PK`, `IN`. |
deliveryTime | string | optional | Keep only gigs with this delivery speed (mode=search). |
proOnly | boolean | optional | Keep only Fiverr Pro gigs (mode=search). |
onlineOnly | boolean | optional | Keep only sellers who are online now (mode=search). |
agencyOnly | boolean | optional | Keep only agency-run gigs (mode=search). |
hourlyOnly | boolean | optional | Keep only gigs that offer an hourly rate (mode=search). |
facets | array | optional | Optional category-specific filters for search, as `key:value` strings, e.g. `style:flat_minimalist` or `file_format:svg`. Unknown values are skipped with a warning. |
minRating | number | optional | Only keep gigs or sellers with an average rating at or above this value (0-5). |
minReviews | integer | optional | Only keep gigs or sellers with at least this many reviews. |
minPriceUsd | number | optional | Only keep gigs whose lowest package price is at or above this amount (USD). |
maxPriceUsd | number | optional | Only keep gigs whose lowest package price is at or below this amount (USD). |
includeGigDetails | boolean | optional | Fetch each search result's gig page for packages, reviews, FAQ and the full seller card (mode=search). Also preserves the legacy discoverAndFetchDetails path. |
includePackages | boolean | optional | Include package pricing, delivery, revisions, features and paid extras on gig details. |
includeFaq | boolean | optional | Include the gig's public FAQ list when present. |
includeSellerGigs | boolean | optional | Include the seller's gig list on seller profile records. |
includeSellerReviews | boolean | optional | Include the seller's latest reviews and rating breakdown on seller profile records. |
includeMarketSummary | boolean | optional | Emit one summary row per search query with result count, price range, seller-level mix and top seller countries. |
maxPagesPerQuery | integer | optional | Maximum result pages to read per search query or URL. Fiverr may stop earlier; this is an upper bound. |
maxItems | integer | optional | Hard cap on emitted records. |
3. Start an Actor run
Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.
Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.
import json
import os
import urllib.request
# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
actor_input = json.load(stream)
token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
"https://api.apify.com/v2/acts/yra4HTNkAQ1pjZ1g7/runs?timeout=120&maxTotalChargeUsd=0.50",
data=json.dumps(actor_input).encode("utf-8"),
headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.
4. Inspect the actual results
Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.
Fiverr gig search results, full gig details, seller profiles, and sitemap directory records with pricing, packages, ratings, reviews, seller levels and taxonomy data.
Questions before you run
Which inputs are required?
The published required fields are mode
What does this guide verify?
The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.
What if the run request times out?
Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.
Generated from source build ioz3XdgkePJ4Ysh8m and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.