{ "openapi": "3.0.1", "info": { "title": "Fiverr Full-Site Gig Scraper - Search & Categories", "description": "Collect current Fiverr gig listings across the full site catalog or by search query. Export prices, seller signals, ratings, and listing URLs for sourcing and competitor research.", "version": "0.3", "x-build-id": "lQ2Mf5l8wSFdFAjIl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~fiverr-programming-tech-gigs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-fiverr-programming-tech-gigs-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/lentic_clockss~fiverr-programming-tech-gigs-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-fiverr-programming-tech-gigs-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/lentic_clockss~fiverr-programming-tech-gigs-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-fiverr-programming-tech-gigs-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": { "searchQuery": { "title": "Site-wide search keyword", "maxLength": 200, "type": "string", "description": "Optional free-text query for the Fiverr search box (site-wide). When set, categories/subcategories are ignored. Leave empty to crawl category listing pages instead. Console Test uses a single high-success keyword.", "default": "logo design" }, "categories": { "title": "Top-level categories (optional)", "type": "array", "description": "Optional Fiverr top-level verticals, for example graphics-design, online-marketing, programming-tech, writing-translation, video-animation, music-audio, business, lifestyle, data, photography. Leave empty for all top-level verticals in the site catalog. Alias: digital-marketing → online-marketing.", "default": [], "items": { "type": "string" } }, "subcategories": { "title": "Listing paths (optional)", "type": "array", "description": "Optional listing paths. Prefer full paths like graphics-design/logo-design or programming-tech/website-development. Bare leaves (for example website-development) are resolved when unique. Leave empty to collect all listing types under the selected categories (full site when categories is also empty).", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max results per query, path, or URL", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Most rows for each search query, listing path, or gig URL/path. Default 70; larger numbers are collected in parts of 70. Gigs, optional reviews, sellers, and inventory rows count together. The whole run stops at your maximum total charge. Set 0 for the legacy paid-plan safety cap of 5,000. Free Apify plan: up to 200 rows per run and 10 runs of this Actor.", "default": 70 }, "sellerLimit": { "title": "Phase-2 seller profiles (optional)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Maximum unique seller profile pages to enrich after gig collection. Default 0 disables seller enrichment.", "default": 0 }, "includeReviews": { "title": "Include review rows", "type": "boolean", "description": "When enabled for gig detail inputs, reviews are emitted as separate billed rows. All gig, review, seller, and inventory rows share maxItems.", "default": false }, "sellerFailureLimit": { "title": "Seller failure limit", "minimum": 1, "maximum": 50, "type": "integer", "description": "Stop Phase 2 after this many seller fetch/parse failures. Default 5.", "default": 5 }, "phase2BudgetSeconds": { "title": "Phase-2 time budget (seconds)", "minimum": 30, "maximum": 900, "type": "integer", "description": "Maximum wall-clock seconds for seller enrichment. Default 240.", "default": 240 }, "workerBaseUrl": { "title": "Worker base URL (optional)", "type": "string", "description": "Optional worker endpoint. Production runs use the fiverr-com control-plane broker configured by WORKER_BASE_URL.", "default": "" }, "gigPaths": { "title": "Gig detail paths (optional)", "type": "array", "description": "Optional gig detail pages to fetch the full gig_page_perseus blob (45 top-level fields: packages/reviews/description/gallery/faq/tags/portfolio/seller). Accept username/gig-slug paths or full fiverr.com gig URLs. When set, listing/search inputs are ignored.", "default": [], "items": { "type": "string" } }, "sitemap": { "title": "Sitemap inventory mode (optional)", "type": "string", "description": "Enumerate the official Fiverr sitemaps into a canonical URL inventory. One of categories|gigs|users|tags|logomaker|all. gigs = ~131K gig detail URLs (7 shards), users = ~300K seller URLs (6 shards), categories = 961 taxonomy URLs, tags = ~100K /gigs/{tag} tag landing pages (index -> 2 shards), logomaker = ~1033 /logo-maker/* pages. Emits sitemap_* inventory rows (no full detail fetch).", "default": "" }, "inventoryLimit": { "title": "Inventory row cap (optional)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Cap sitemap inventory rows emitted per run. 0 = all enumerated URLs (can be large).", "default": 0 }, "maxPages": { "title": "Pages per listing/search (optional)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Walk ?page=N pagination on listing/search/facet surfaces (SSR returns ~48 items/page; page=2 is robots-legal, page=3+ verified live). Default 1 = only the first page.", "default": 1 }, "startPage": { "title": "Start page (optional)", "minimum": 1, "maximum": 20, "type": "integer", "description": "First ?page=N to fetch when paginating (resume from a later page). Default 1.", "default": 1 }, "sitemapSinceTs": { "title": "Sitemap incremental since timestamp (optional)", "type": "string", "description": "Optional ISO-8601 date/datetime cutoff. When set with sitemap mode, only sitemap entries whose is after this timestamp are emitted (incremental inventory refresh). Entries with no lastmod are kept. Example: 2026-10-01 or 2026-10-01T00:00:00Z.", "default": "" }, "mintCanary": { "title": "Session health check (mint canary)", "type": "boolean", "description": "Run a mint→replay health probe instead of collecting data: bakes a session cookie on a weak surface then replays it on a detail surface, reporting bake/consume latency and success in diagnostics.mintCanary. Emits zero data rows.", "default": false }, "sitemapShardState": { "title": "Sitemap shard validators (optional)", "type": "object", "description": "Optional conditional-GET validators returned by a previous sitemap run as diagnostics.sitemapShardState ({shardUrl: {etag, lastModified}}). Pass it back on the next run to skip re-downloading unchanged shards (304).", "default": {} } } }, "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 } } } } } } } } } }