{
  "openapi": "3.0.1",
  "info": {
    "title": "Fiverr Scraper — Gigs, Sellers & Prices API",
    "description": "Scrape Fiverr gigs by search, category or seller — no API key, no login. Extract titles, prices, packages, delivery times, ratings, reviews, seller level, country and badges. Export freelance-marketplace data to JSON, CSV or Excel for market research and lead generation.",
    "version": "1.0",
    "x-build-id": "NIBrHaT3tcg4msbTU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/logiover~fiverr-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-logiover-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/logiover~fiverr-scraper/runs": {
      "post": {
        "operationId": "runs-sync-logiover-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/logiover~fiverr-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-logiover-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "category",
              "seller",
              "gigDetail"
            ],
            "type": "string",
            "description": "Which Fiverr endpoint to scrape.\n\n• **search** — search gigs by keyword and paginate (~48 gigs/page → thousands). Highest volume.\n• **category** — list gigs under a Fiverr category / subcategory slug, or a pasted category URL.\n• **seller** — full profile + all public gigs of one seller username.\n• **gigDetail** — deep detail for one or more gig URLs: 3-tier packages, description, FAQ, tags, gallery and seller stats.",
            "default": "search"
          },
          "query": {
            "title": "Search query",
            "type": "string",
            "description": "Keyword for **search** mode — a service, skill or niche (e.g. `logo design`, `wordpress`, `voice over`, `video editing`). Fiverr caps a single query at ~380 gigs; for more, add several terms in **Search queries** below. Empty input browses popular services."
          },
          "queries": {
            "title": "Search queries (multi, high volume)",
            "type": "array",
            "description": "Optional list of keywords to scrape in one run (results de-duplicated by gig ID). A single Fiverr query tops out around ~380 gigs, so use several complementary terms to collect thousands. Overrides/extends the single query above.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "category": {
            "title": "Category slug",
            "type": "string",
            "description": "Fiverr category slug for **category** mode, e.g. `graphics-design`, `programming-tech`, `digital-marketing`, `writing-translation`, `video-animation`, `music-audio`, `business`, `data`, `ai-services`. Taken from a Fiverr category URL: fiverr.com/categories/**graphics-design**."
          },
          "subcategory": {
            "title": "Subcategory slug (optional)",
            "type": "string",
            "description": "Optional subcategory slug under the category, e.g. `creative-logo-design`, `website-development`, `social-media-marketing`. From fiverr.com/categories/graphics-design/**creative-logo-design**."
          },
          "categoryUrl": {
            "title": "Category URL (optional)",
            "type": "string",
            "description": "Alternatively, paste a full Fiverr category or search URL and the scraper will paginate it directly. Overrides the category/subcategory slugs above."
          },
          "seller": {
            "title": "Seller username or profile URL",
            "type": "string",
            "description": "For **seller** mode — a Fiverr username (e.g. `martinkokes`) or a full profile URL (`https://www.fiverr.com/martinkokes`). Returns the seller's profile stats plus every public gig."
          },
          "gigUrl": {
            "title": "Gig URL",
            "type": "string",
            "description": "A single Fiverr gig URL for **gigDetail** mode, e.g. `https://www.fiverr.com/username/gig-slug`. For many gigs at once, use the batch field below."
          },
          "gigUrls": {
            "title": "Gig URLs (batch)",
            "type": "array",
            "description": "Array of Fiverr gig URLs for batch **gigDetail** lookups. Paste gig links (one per line).",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "best_selling",
              "newest",
              "rating"
            ],
            "type": "string",
            "description": "Result ordering for search / category modes.",
            "default": "relevance"
          },
          "sellerLevel": {
            "title": "Seller level",
            "enum": [
              "new_seller",
              "level_one",
              "level_two",
              "top_rated_seller",
              "pro"
            ],
            "type": "string",
            "description": "Only include gigs from sellers of this level (search / category)."
          },
          "priceBucket": {
            "title": "Price range (USD)",
            "enum": [
              "under_50",
              "50_100",
              "100_500",
              "500_1000",
              "over_1000"
            ],
            "type": "string",
            "description": "Filter gigs by starting price bucket (search / category)."
          },
          "deliveryTime": {
            "title": "Delivery time",
            "enum": [
              "24h",
              "3days",
              "7days"
            ],
            "type": "string",
            "description": "Only gigs that deliver within this timeframe (search / category)."
          },
          "proOnly": {
            "title": "Fiverr Pro only",
            "type": "boolean",
            "description": "When enabled, restrict search / category results to vetted Fiverr Pro gigs.",
            "default": false
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Upper bound on rows returned. For search / category this drives pagination (~48 per page). For seller it caps the seller's gig list. Default 200.",
            "default": 2368
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Leave as is. Every page is tried on Apify datacenter IPs first and the Actor switches to Residential automatically when Fiverr refuses them, so you get the same data at the lowest proxy cost. Pick a Residential country here only if you need one; your own proxy URLs are used exactly as given.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}