Fiverr Gig & Seller Sitemap Directory Scraper

{
  "description": "Search Fiverr gigs and categories, fetch gig details, read seller profiles, or list entries from Fiverr's public sitemaps.",
  "properties": {
    "agencyOnly": {
      "default": false,
      "description": "Keep only agency-run gigs (mode=search).",
      "prefill": false,
      "title": "Agencies only",
      "type": "boolean"
    },
    "category": {
      "default": "",
      "description": "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.",
      "editor": "select",
      "enum": [
        "",
        "graphics-design",
        "online-marketing",
        "writing-translation",
        "video-animation",
        "music-audio",
        "programming-tech",
        "data",
        "business",
        "lifestyle",
        "photography",
        "finance",
        "end-to-end-projects"
      ],
      "enumTitles": [
        "(any category)",
        "Graphics & Design",
        "Digital Marketing",
        "Writing & Translation",
        "Video & Animation",
        "Music & Audio",
        "Programming & Tech",
        "Data",
        "Business",
        "Lifestyle",
        "Photography",
        "Finance",
        "End-to-End Projects"
      ],
      "prefill": "",
      "title": "Top-level category",
      "type": "string"
    },
    "categoryLevel": {
      "default": "",
      "description": "Only keep category entries at this level (mode=sitemapDirectory, sitemapType=categories).",
      "editor": "select",
      "enum": [
        "",
        "category",
        "subCategory",
        "nestedSubCategory"
      ],
      "enumTitles": [
        "(all levels)",
        "Top-level category",
        "Sub-category",
        "Nested sub-category"
      ],
      "prefill": "",
      "title": "Category level filter",
      "type": "string"
    },
    "deliveryTime": {
      "default": "any",
      "description": "Keep only gigs with this delivery speed (mode=search).",
      "editor": "select",
      "enum": [
        "any",
        "1",
        "3",
        "7"
      ],
      "enumTitles": [
        "Anytime",
        "Express 24 hours",
        "Up to 3 days",
        "Up to 7 days"
      ],
      "prefill": "any",
      "title": "Delivery time",
      "type": "string"
    },
    "facets": {
      "default": [],
      "description": "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.",
      "editor": "stringList",
      "prefill": [],
      "title": "Category filters",
      "type": "array"
    },
    "gigUrls": {
      "default": [],
      "description": "Full Fiverr gig URLs to fetch, e.g. `https://www.fiverr.com/username/gig-slug` (mode=gigDetails).",
      "editor": "stringList",
      "prefill": [],
      "title": "Gig URLs",
      "type": "array"
    },
    "hourlyOnly": {
      "default": false,
      "description": "Keep only gigs that offer an hourly rate (mode=search).",
      "prefill": false,
      "title": "Hourly gigs only",
      "type": "boolean"
    },
    "ideaType": {
      "default": "",
      "description": "Only keep Logo Maker entries of this type (mode=sitemapDirectory, sitemapType=logomakerIdeas).",
      "editor": "select",
      "enum": [
        "",
        "tag",
        "industry",
        "monogram",
        "brandValue",
        "style",
        "symbolType"
      ],
      "enumTitles": [
        "(all types)",
        "Tag",
        "Industry",
        "Monogram",
        "Brand value",
        "Style",
        "Symbol type"
      ],
      "prefill": "",
      "title": "Logo Maker idea type",
      "type": "string"
    },
    "includeFaq": {
      "default": true,
      "description": "Include the gig's public FAQ list when present.",
      "prefill": true,
      "title": "Include FAQ",
      "type": "boolean"
    },
    "includeGigDetails": {
      "default": false,
      "description": "Fetch each search result's gig page for packages, reviews, FAQ and the full seller card (mode=search). Also preserves the legacy discoverAndFetchDetails path.",
      "prefill": false,
      "title": "Include gig details",
      "type": "boolean"
    },
    "includeMarketSummary": {
      "default": false,
      "description": "Emit one summary row per search query with result count, price range, seller-level mix and top seller countries.",
      "prefill": false,
      "title": "Include market summary",
      "type": "boolean"
    },
    "includePackages": {
      "default": true,
      "description": "Include package pricing, delivery, revisions, features and paid extras on gig details.",
      "prefill": true,
      "title": "Include package breakdown",
      "type": "boolean"
    },
    "includeSellerGigs": {
      "default": true,
      "description": "Include the seller's gig list on seller profile records.",
      "prefill": true,
      "title": "Include seller gigs",
      "type": "boolean"
    },
    "includeSellerReviews": {
      "default": true,
      "description": "Include the seller's latest reviews and rating breakdown on seller profile records.",
      "prefill": true,
      "title": "Include seller reviews",
      "type": "boolean"
    },
    "maxItems": {
      "default": 20,
      "description": "Hard cap on emitted records.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max items",
      "type": "integer"
    },
    "maxPagesPerQuery": {
      "default": 21,
      "description": "Maximum result pages to read per search query or URL. Fiverr may stop earlier; this is an upper bound.",
      "maximum": 21,
      "minimum": 1,
      "prefill": 1,
      "title": "Max pages per search",
      "type": "integer"
    },
    "maxPriceUsd": {
      "description": "Only keep gigs whose lowest package price is at or below this amount (USD).",
      "maximum": 100000,
      "minimum": 0,
      "title": "Maximum starting price (USD)",
      "type": "number"
    },
    "maxShards": {
      "default": 1,
      "description": "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.",
      "maximum": 7,
      "minimum": 1,
      "prefill": 1,
      "title": "Sitemap shards to scan",
      "type": "integer"
    },
    "minPriceUsd": {
      "description": "Only keep gigs whose lowest package price is at or above this amount (USD).",
      "maximum": 100000,
      "minimum": 0,
      "title": "Minimum starting price (USD)",
      "type": "number"
    },
    "minRating": {
      "description": "Only keep gigs or sellers with an average rating at or above this value (0-5).",
      "maximum": 5,
      "minimum": 0,
      "title": "Minimum rating",
      "type": "number"
    },
    "minReviews": {
      "description": "Only keep gigs or sellers with at least this many reviews.",
      "maximum": 1000000,
      "minimum": 0,
      "title": "Minimum review count",
      "type": "integer"
    },
    "mode": {
      "default": "sitemapDirectory",
      "description": "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.",
      "editor": "select",
      "enum": [
        "search",
        "gigDetails",
        "sellerProfiles",
        "sitemapDirectory",
        "discoverGigs",
        "discoverSellers",
        "discoverCategories",
        "discoverTags",
        "discoverLogoMakerIdeas",
        "discoverAndFetchDetails"
      ],
      "enumTitles": [
        "Search gigs by keyword or category URL",
        "Fetch gig details by URL",
        "Fetch seller profiles",
        "List a Fiverr sitemap directory",
        "Legacy alias: discover gig URLs",
        "Legacy alias: discover seller URLs",
        "Legacy alias: discover categories",
        "Legacy alias: discover search tags",
        "Legacy alias: discover Logo Maker ideas",
        "Legacy alias: discover gigs and fetch details"
      ],
      "prefill": "sitemapDirectory",
      "title": "Mode",
      "type": "string"
    },
    "onlineOnly": {
      "default": false,
      "description": "Keep only sellers who are online now (mode=search).",
      "prefill": false,
      "title": "Online sellers only",
      "type": "boolean"
    },
    "proOnly": {
      "default": false,
      "description": "Keep only Fiverr Pro gigs (mode=search).",
      "prefill": false,
      "title": "Fiverr Pro only",
      "type": "boolean"
    },
    "searchKeyword": {
      "default": "",
      "description": "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.",
      "editor": "textfield",
      "prefill": "logo",
      "title": "Keyword filter",
      "type": "string"
    },
    "searchQueries": {
      "default": [],
      "description": "Keywords to search on Fiverr (mode=search), e.g. `logo design` or `voice over`. One search is run per query.",
      "editor": "stringList",
      "prefill": [
        "logo design"
      ],
      "title": "Search queries",
      "type": "array"
    },
    "searchUrls": {
      "default": [],
      "description": "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.",
      "editor": "requestListSources",
      "items": {
        "properties": {
          "url": {
            "description": "Fiverr search or category URL.",
            "title": "URL",
            "type": "string"
          }
        },
        "type": "object"
      },
      "prefill": [],
      "title": "Search or category URLs",
      "type": "array"
    },
    "sellerCountries": {
      "default": [],
      "description": "Keep only sellers living in these countries (mode=search), using ISO-2 codes such as `US`, `GB`, `DE`, `PK`, `IN`.",
      "editor": "stringList",
      "prefill": [],
      "title": "Seller countries",
      "type": "array"
    },
    "sellerLanguages": {
      "default": [],
      "description": "Keep only sellers who speak these languages (mode=search), using ISO codes such as `en`, `es`, `de`, `fr`, `hi`, `ur`.",
      "editor": "stringList",
      "prefill": [],
      "title": "Seller languages",
      "type": "array"
    },
    "sellerLevels": {
      "default": [],
      "description": "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.",
      "editor": "stringList",
      "prefill": [],
      "title": "Seller levels",
      "type": "array"
    },
    "sellerUrls": {
      "default": [],
      "description": "Fiverr seller usernames or profile URLs, e.g. `michael7878` or `https://www.fiverr.com/michael7878` (mode=sellerProfiles).",
      "editor": "stringList",
      "prefill": [],
      "title": "Seller usernames or URLs",
      "type": "array"
    },
    "sitemapType": {
      "default": "gigs",
      "description": "Which Fiverr sitemap directory to list (mode=sitemapDirectory).",
      "editor": "select",
      "enum": [
        "gigs",
        "sellers",
        "categories",
        "tags",
        "logomakerIdeas"
      ],
      "enumTitles": [
        "Gig URLs",
        "Seller profile URLs",
        "Category taxonomy",
        "Search tags",
        "Logo Maker ideas"
      ],
      "prefill": "gigs",
      "title": "Sitemap type",
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "description": "Sort live search results (mode=search).",
      "editor": "select",
      "enum": [
        "relevance",
        "best_selling",
        "price_low_to_high",
        "price_high_to_low",
        "newest"
      ],
      "enumTitles": [
        "Relevance",
        "Best selling",
        "Price: low to high",
        "Price: high to low",
        "Newest arrivals"
      ],
      "prefill": "relevance",
      "title": "Sort order",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Fiverr Scraper Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Fiverr gig search results, full gig details, seller profiles, and sitemap directory records with pricing, packages, ratings, reviews, seller levels and taxonomy data.",
  "properties": {
    "results": {
      "description": "Dataset containing Fiverr gig listings, gig details, seller profiles, directory entries and optional market summaries.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Fiverr gigs, sellers and directories",
      "type": "string"
    }
  },
  "title": "Fiverr Gig, Seller & Directory Scraper Output"
}

{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Fiverr results",
      "transformation": {
        "fields": [
          "recordType",
          "title",
          "gigUrl",
          "sellerUsername",
          "sellerLevel",
          "category",
          "subCategory",
          "priceMin",
          "priceMax",
          "currency",
          "rating",
          "reviewsCount",
          "sellerCountryCode",
          "sourceUrl"
        ]
      }
    }
  }
}