{
  "title": "Fiverr Scraper Input",
  "description": "Search Fiverr gigs and categories, fetch gig details, read seller profiles, or list entries from Fiverr's public sitemaps.",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "mode": {
      "title": "Mode",
      "type": "string",
      "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"
      ],
      "default": "sitemapDirectory",
      "prefill": "sitemapDirectory"
    },
    "searchQueries": {
      "title": "Search queries",
      "type": "array",
      "description": "Keywords to search on Fiverr (mode=search), e.g. `logo design` or `voice over`. One search is run per query.",
      "editor": "stringList",
      "default": [],
      "prefill": [
        "logo design"
      ]
    },
    "searchUrls": {
      "title": "Search or category URLs",
      "type": "array",
      "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": {
        "type": "object",
        "properties": {
          "url": {
            "title": "URL",
            "type": "string",
            "description": "Fiverr search or category URL."
          }
        }
      },
      "default": [],
      "prefill": []
    },
    "gigUrls": {
      "title": "Gig URLs",
      "type": "array",
      "description": "Full Fiverr gig URLs to fetch, e.g. `https://www.fiverr.com/username/gig-slug` (mode=gigDetails).",
      "editor": "stringList",
      "default": [],
      "prefill": []
    },
    "sellerUrls": {
      "title": "Seller usernames or URLs",
      "type": "array",
      "description": "Fiverr seller usernames or profile URLs, e.g. `michael7878` or `https://www.fiverr.com/michael7878` (mode=sellerProfiles).",
      "editor": "stringList",
      "default": [],
      "prefill": []
    },
    "sitemapType": {
      "title": "Sitemap type",
      "type": "string",
      "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"
      ],
      "default": "gigs",
      "prefill": "gigs"
    },
    "searchKeyword": {
      "title": "Keyword filter",
      "type": "string",
      "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",
      "default": "",
      "prefill": "logo"
    },
    "maxShards": {
      "title": "Sitemap shards to scan",
      "type": "integer",
      "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.",
      "minimum": 1,
      "maximum": 7,
      "default": 1,
      "prefill": 1
    },
    "categoryLevel": {
      "title": "Category level filter",
      "type": "string",
      "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"
      ],
      "default": "",
      "prefill": ""
    },
    "ideaType": {
      "title": "Logo Maker idea type",
      "type": "string",
      "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"
      ],
      "default": "",
      "prefill": ""
    },
    "category": {
      "title": "Top-level category",
      "type": "string",
      "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"
      ],
      "default": "",
      "prefill": ""
    },
    "sortBy": {
      "title": "Sort order",
      "type": "string",
      "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"
      ],
      "default": "relevance",
      "prefill": "relevance"
    },
    "sellerLevels": {
      "title": "Seller levels",
      "type": "array",
      "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",
      "default": [],
      "prefill": []
    },
    "sellerLanguages": {
      "title": "Seller languages",
      "type": "array",
      "description": "Keep only sellers who speak these languages (mode=search), using ISO codes such as `en`, `es`, `de`, `fr`, `hi`, `ur`.",
      "editor": "stringList",
      "default": [],
      "prefill": []
    },
    "sellerCountries": {
      "title": "Seller countries",
      "type": "array",
      "description": "Keep only sellers living in these countries (mode=search), using ISO-2 codes such as `US`, `GB`, `DE`, `PK`, `IN`.",
      "editor": "stringList",
      "default": [],
      "prefill": []
    },
    "deliveryTime": {
      "title": "Delivery time",
      "type": "string",
      "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"
      ],
      "default": "any",
      "prefill": "any"
    },
    "proOnly": {
      "title": "Fiverr Pro only",
      "type": "boolean",
      "description": "Keep only Fiverr Pro gigs (mode=search).",
      "default": false,
      "prefill": false
    },
    "onlineOnly": {
      "title": "Online sellers only",
      "type": "boolean",
      "description": "Keep only sellers who are online now (mode=search).",
      "default": false,
      "prefill": false
    },
    "agencyOnly": {
      "title": "Agencies only",
      "type": "boolean",
      "description": "Keep only agency-run gigs (mode=search).",
      "default": false,
      "prefill": false
    },
    "hourlyOnly": {
      "title": "Hourly gigs only",
      "type": "boolean",
      "description": "Keep only gigs that offer an hourly rate (mode=search).",
      "default": false,
      "prefill": false
    },
    "facets": {
      "title": "Category filters",
      "type": "array",
      "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",
      "default": [],
      "prefill": []
    },
    "minRating": {
      "title": "Minimum rating",
      "type": "number",
      "description": "Only keep gigs or sellers with an average rating at or above this value (0-5).",
      "minimum": 0,
      "maximum": 5
    },
    "minReviews": {
      "title": "Minimum review count",
      "type": "integer",
      "description": "Only keep gigs or sellers with at least this many reviews.",
      "minimum": 0,
      "maximum": 1000000
    },
    "minPriceUsd": {
      "title": "Minimum starting price (USD)",
      "type": "number",
      "description": "Only keep gigs whose lowest package price is at or above this amount (USD).",
      "minimum": 0,
      "maximum": 100000
    },
    "maxPriceUsd": {
      "title": "Maximum starting price (USD)",
      "type": "number",
      "description": "Only keep gigs whose lowest package price is at or below this amount (USD).",
      "minimum": 0,
      "maximum": 100000
    },
    "includeGigDetails": {
      "title": "Include gig details",
      "type": "boolean",
      "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.",
      "default": false,
      "prefill": false
    },
    "includePackages": {
      "title": "Include package breakdown",
      "type": "boolean",
      "description": "Include package pricing, delivery, revisions, features and paid extras on gig details.",
      "default": true,
      "prefill": true
    },
    "includeFaq": {
      "title": "Include FAQ",
      "type": "boolean",
      "description": "Include the gig's public FAQ list when present.",
      "default": true,
      "prefill": true
    },
    "includeSellerGigs": {
      "title": "Include seller gigs",
      "type": "boolean",
      "description": "Include the seller's gig list on seller profile records.",
      "default": true,
      "prefill": true
    },
    "includeSellerReviews": {
      "title": "Include seller reviews",
      "type": "boolean",
      "description": "Include the seller's latest reviews and rating breakdown on seller profile records.",
      "default": true,
      "prefill": true
    },
    "includeMarketSummary": {
      "title": "Include market summary",
      "type": "boolean",
      "description": "Emit one summary row per search query with result count, price range, seller-level mix and top seller countries.",
      "default": false,
      "prefill": false
    },
    "maxPagesPerQuery": {
      "title": "Max pages per search",
      "type": "integer",
      "description": "Maximum result pages to read per search query or URL. Fiverr may stop earlier; this is an upper bound.",
      "minimum": 1,
      "maximum": 21,
      "default": 21,
      "prefill": 1
    },
    "maxItems": {
      "title": "Max items",
      "type": "integer",
      "description": "Hard cap on emitted records.",
      "minimum": 1,
      "maximum": 5000,
      "default": 20,
      "prefill": 3
    }
  },
  "required": [
    "mode"
  ]
}