{ "openapi": "3.0.1", "info": { "title": "Fiverr Scraper — Gigs, Prices, Sellers & Reviews", "description": "Scrape Fiverr gigs from keyword search, category, seller and gig URLs: price, packages, rating, reviews count, seller level and country, plus optional gig details and reviews.", "version": "0.1", "x-build-id": "Kx2AkEixgTmsDhQtl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~fiverr-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-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/tortuga~fiverr-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-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/tortuga~fiverr-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on Fiverr, one per line (e.g. 'logo design', 'wordpress', 'voice over'). Each term is paginated automatically (48 gigs per page).", "items": { "type": "string" } }, "startUrls": { "title": "Fiverr URLs", "type": "array", "description": "Fiverr pages to scrape: search results (https://www.fiverr.com/search/gigs?query=seo), subcategory pages (https://www.fiverr.com/categories/graphics-design/creative-logo-design), filtered URLs copied from the site, gig pages (https://www.fiverr.com//) or seller profiles (https://www.fiverr.com/, gives all of the seller's gigs). Top-level category hubs have no gig list; use a subcategory.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max gigs", "minimum": 1, "type": "integer", "description": "Stop after this many gigs (across all search terms and URLs). Keeps cost predictable.", "default": 100 }, "minPrice": { "title": "Budget: min price (USD)", "minimum": 0, "type": "integer", "description": "Only gigs whose starting price is at least this many US dollars (Fiverr's Budget filter). Applied to search terms and to search/category URLs." }, "maxPrice": { "title": "Budget: max price (USD)", "minimum": 1, "type": "integer", "description": "Only gigs whose starting price is at most this many US dollars (Fiverr's Budget filter)." }, "deliveryTime": { "title": "Delivery time", "enum": [ "1", "3", "7" ], "type": "string", "description": "Only gigs that deliver within this time (Fiverr's Delivery time filter)." }, "sellerLevels": { "title": "Seller level", "type": "array", "description": "Only gigs from sellers with one of these levels (Fiverr's Seller level filter).", "items": { "type": "string", "enum": [ "top_rated_seller", "level_two_seller", "level_one_seller", "na" ], "enumTitles": [ "Top Rated Seller", "Level 2", "Level 1", "New Seller" ] } }, "proOnly": { "title": "Pro services only", "type": "boolean", "description": "Only Fiverr Pro (vetted) gigs." }, "onlineOnly": { "title": "Sellers online now", "type": "boolean", "description": "Only gigs whose seller is online at the time of the run." }, "sellerCountries": { "title": "Seller countries", "type": "array", "description": "Only sellers located in these countries, as two-letter ISO codes (US, GB, DE, IN, PK ...).", "items": { "type": "string" } }, "sellerLanguages": { "title": "Seller languages", "type": "array", "description": "Only sellers who speak one of these languages, as two-letter codes (en, de, es, fr, ar ...).", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "best_selling", "newest", "price_asc", "price_desc" ], "type": "string", "description": "Order of the results. Leave empty for Fiverr's default (Relevance on search, Best selling on category pages)." }, "includeGigDetails": { "title": "Open each gig page", "type": "boolean", "description": "Fetch every gig's page for the full package table (Basic/Standard/Premium: price, delivery days, revisions, features), paid extras, description, FAQ, tags, full gallery, orders in queue, star breakdown, 5 top reviews and the seller profile (member since, last delivery, response time, languages, skills). One extra request per gig, charged as a `detail` event. Gig URLs always open the gig page.", "default": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Nest the gig's buyer reviews inside each gig: rating, text, date, reviewer username and country, order price range and duration, repeat buyer, seller response. Fiverr serves 5 reviews per request; each review saved is charged as a `review` event.", "default": false }, "maxReviewsPerGig": { "title": "Max reviews per gig", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper limit of nested reviews per gig when Include reviews is on.", "default": 20 }, "reviewsSort": { "title": "Reviews order", "enum": [ "recent", "relevant" ], "type": "string", "description": "Newest first, or Fiverr's 'Most relevant' order. 'Only reviews newer than' always uses newest first.", "default": "recent" }, "reviewsNewerThan": { "title": "Only reviews newer than", "type": "string", "description": "Only reviews newer than: a date (YYYY-MM-DD) or a period such as '7 days' or '24 hours'. Reviews are read newest first and paging stops once a whole page is older. Turns on Include reviews." }, "onlyNewOrChanged": { "title": "Only new or changed items", "type": "boolean", "description": "Remember what earlier runs of this search returned and output only new items or items whose price/status changed. Use with a Schedule; unchanged items are not charged. Compared: starting price, rating and review count (a new review raises the count). With this on, Max gigs is the number of gigs checked each run, and gig pages / reviews are only requested for new or changed gigs.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Fiverr is protected by PerimeterX (HUMAN). Apify's Unblocker proxy group is the default because it is the only route that stays reliable for gig pages and the reviews endpoint. Unblocker costs about $0.0015 per request, billed to your account: one request per 48 gigs of search/category results, one per gig page, one per 5 reviews. Datacenter proxy (free on paid plans) works for small search runs until Fiverr starts blocking its IPs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }