{ "openapi": "3.0.1", "info": { "title": "Fiverr Gig & Seller Sitemap Directory Scraper", "description": "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.", "version": "1.0", "x-build-id": "ioz3XdgkePJ4Ysh8m" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vexaloom-labs~fiverr-gig-and-seller-sitemap-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vexaloom-labs-fiverr-gig-and-seller-sitemap-directory-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/vexaloom-labs~fiverr-gig-and-seller-sitemap-directory-scraper/runs": { "post": { "operationId": "runs-sync-vexaloom-labs-fiverr-gig-and-seller-sitemap-directory-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/vexaloom-labs~fiverr-gig-and-seller-sitemap-directory-scraper/run-sync": { "post": { "operationId": "run-sync-vexaloom-labs-fiverr-gig-and-seller-sitemap-directory-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": [ "search", "gigDetails", "sellerProfiles", "sitemapDirectory", "discoverGigs", "discoverSellers", "discoverCategories", "discoverTags", "discoverLogoMakerIdeas", "discoverAndFetchDetails" ], "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.", "default": "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.", "default": [], "items": { "type": "string" } }, "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.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "Fiverr search or category URL." } } }, "default": [] }, "gigUrls": { "title": "Gig URLs", "type": "array", "description": "Full Fiverr gig URLs to fetch, e.g. `https://www.fiverr.com/username/gig-slug` (mode=gigDetails).", "default": [], "items": { "type": "string" } }, "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).", "default": [], "items": { "type": "string" } }, "sitemapType": { "title": "Sitemap type", "enum": [ "gigs", "sellers", "categories", "tags", "logomakerIdeas" ], "type": "string", "description": "Which Fiverr sitemap directory to list (mode=sitemapDirectory).", "default": "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.", "default": "" }, "maxShards": { "title": "Sitemap shards to scan", "minimum": 1, "maximum": 7, "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.", "default": 1 }, "categoryLevel": { "title": "Category level filter", "enum": [ "", "category", "subCategory", "nestedSubCategory" ], "type": "string", "description": "Only keep category entries at this level (mode=sitemapDirectory, sitemapType=categories).", "default": "" }, "ideaType": { "title": "Logo Maker idea type", "enum": [ "", "tag", "industry", "monogram", "brandValue", "style", "symbolType" ], "type": "string", "description": "Only keep Logo Maker entries of this type (mode=sitemapDirectory, sitemapType=logomakerIdeas).", "default": "" }, "category": { "title": "Top-level category", "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 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.", "default": "" }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "best_selling", "price_low_to_high", "price_high_to_low", "newest" ], "type": "string", "description": "Sort live search results (mode=search).", "default": "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.", "default": [], "items": { "type": "string" } }, "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`.", "default": [], "items": { "type": "string" } }, "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`.", "default": [], "items": { "type": "string" } }, "deliveryTime": { "title": "Delivery time", "enum": [ "any", "1", "3", "7" ], "type": "string", "description": "Keep only gigs with this delivery speed (mode=search).", "default": "any" }, "proOnly": { "title": "Fiverr Pro only", "type": "boolean", "description": "Keep only Fiverr Pro gigs (mode=search).", "default": false }, "onlineOnly": { "title": "Online sellers only", "type": "boolean", "description": "Keep only sellers who are online now (mode=search).", "default": false }, "agencyOnly": { "title": "Agencies only", "type": "boolean", "description": "Keep only agency-run gigs (mode=search).", "default": false }, "hourlyOnly": { "title": "Hourly gigs only", "type": "boolean", "description": "Keep only gigs that offer an hourly rate (mode=search).", "default": 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.", "default": [], "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only keep gigs or sellers with an average rating at or above this value (0-5)." }, "minReviews": { "title": "Minimum review count", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only keep gigs or sellers with at least this many reviews." }, "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)." }, "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)." }, "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 }, "includePackages": { "title": "Include package breakdown", "type": "boolean", "description": "Include package pricing, delivery, revisions, features and paid extras on gig details.", "default": true }, "includeFaq": { "title": "Include FAQ", "type": "boolean", "description": "Include the gig's public FAQ list when present.", "default": true }, "includeSellerGigs": { "title": "Include seller gigs", "type": "boolean", "description": "Include the seller's gig list on seller profile records.", "default": true }, "includeSellerReviews": { "title": "Include seller reviews", "type": "boolean", "description": "Include the seller's latest reviews and rating breakdown on seller profile records.", "default": 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 }, "maxPagesPerQuery": { "title": "Max pages per search", "minimum": 1, "maximum": 21, "type": "integer", "description": "Maximum result pages to read per search query or URL. Fiverr may stop earlier; this is an upper bound.", "default": 21 }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }