# Fiverr Scraper - Best Price (`arlusm/fiverr-scraper`)

Most bang for your buck

- **URL**: https://beta-securitybyobscurity.apify.com/arlusm/fiverr-scraper.md
- **Developed by:** [Artur](https://beta-securitybyobscurity.apify.com/arlusm) (community)
- **Categories:** E-commerce, Jobs
- **Stats:** 31 total users, 9 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

$14.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

## Fiverr Gig Scraper

This scraper extracts detailed information from Fiverr gig listings based on the provided Fiverr category or search URL.

### Input

#### Example Input

The scraper accepts a JSON input to define the scraping parameters, such as the URLs to scrape and additional options.

Example:

```json
{
  "startUrls": [
    {
      "url": "https://www.fiverr.com/categories/programming-tech/website-development?source=hplo_subcat_first_step&pos=1",
      "method": "GET"
    }
  ],
  "proxyCountryCode": "FR",
  "customCookies": ""
}
```

#### Fields:

- **startUrls**: An array of URLs to scrape. These URLs should be Fiverr category or search result pages.
- **proxyCountryCode** (optional): Country code for proxy usage (e.g., "US", "FR"). Defaults to "US" if not provided.
- **customCookies**: A custom cookie to use.

***

### API Call Example

## See the API tab

### Output

The scraper returns an array of gig objects, where each object contains detailed information about a Fiverr gig.

#### Example Output:

```json
[
  {
    "gigId": 371627339,
    "title": "build, rebuild website development as full stack developer, front end developer",
    "sellerName": "rank_champ",
    "sellerProfileUrl": "https://www.fiverr.com/rank_champ",
    "sellerCountry": "BD",
    "sellerLevel": "level_two_seller",
    "rating": 5,
    "reviews": 172,
    "price": 150,
    "isPro": false,
    "isFiverrChoice": false,
    "metadata": [
      {
        "type": "website_type",
        "value": [
          "business"
        ]
      },
      {
        "type": "programming_language",
        "value": [
          "html_css",
          "javascript",
          "php",
          "react",
          "tailwind_css"
        ]
      },
      {
        "type": "website_features",
        "value": [
          "marketing",
          "payment",
          "forum",
          "chat",
          "membership",
          "gallery",
          "booking",
          "dashboard",
          "landing_page",
          "blog"
        ]
      }
    ],
    "mediaAssets": [
      {
        "type": "ImageAsset",
        "url": "https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/371627339/original/f5acf84af4952823132bcc126b42dd10d5cb7f07.png"
      }
    ],
    "attachments": [],
    "sellerLanguages": [
      {
        "code": "en",
        "level": 3
      },
      {
        "code": "bn",
        "level": 4
      }
    ],
    "agency": {},
    "availability": "Offline"
  }
]

```

#### Fields:

- **title**: The title of the gig.
- **gigUrl**: Direct URL to the gig.
- **sellerName**: Name of the seller offering the gig.
- **sellerProfileUrl**: URL to the seller's Fiverr profile.
- **rating**: Average rating of the gig.
- **reviews**: Total number of reviews for the gig.
- **price**: Starting price for the gig.
- **mediaType**: Indicates whether the gig preview includes a video or image.
- **mediaUrl**: URL to the gig's media (video or image).
- **searchUrl**: The URL used for the search or category listing.

***

### Usage

1. **Configure Input**:
   - Add the Fiverr category or search URLs in the `startUrls` field.
   - Set `removeDuplicates` to `true` if you want to avoid duplicate gig entries.

2. **Run the Scraper**:
   - Use the Apify platform or API to execute the scraper.

3. **Get Results**:
   - Extract comprehensive gig data in JSON format.

***

This scraper is ideal for analyzing Fiverr categories, monitoring gig trends, and gathering data for research or business use cases.

***

# Actor input Schema

## `startUrls` (type: `array`):

Search URLs

## `proxyCountryCode` (type: `string`):

Specify the two-letter country code for remote proxies, or 'LOCAL' for a local proxy.

## `customCookies` (type: `string`):

Specify custom cookies as a single string. Example: 'key1=value1; key2=value2'

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.fiverr.com/categories/programming-tech/website-development?source=pagination&filter=rating&page=1"
    }
  ],
  "proxyCountryCode": "FR",
  "customCookies": ""
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.fiverr.com/categories/programming-tech/website-development?source=pagination&filter=rating&page=1"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("arlusm/fiverr-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "startUrls": [{ "url": "https://www.fiverr.com/categories/programming-tech/website-development?source=pagination&filter=rating&page=1" }] }

# Run the Actor and wait for it to finish
run = client.actor("arlusm/fiverr-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.fiverr.com/categories/programming-tech/website-development?source=pagination&filter=rating&page=1"
    }
  ]
}' |
apify call arlusm/fiverr-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=arlusm/fiverr-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Fiverr Scraper - Best Price",
        "description": "Most bang for your buck",
        "version": "0.0",
        "x-build-id": "I0YjhLULVGHs8uFDw"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/arlusm~fiverr-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-arlusm-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/arlusm~fiverr-scraper/runs": {
            "post": {
                "operationId": "runs-sync-arlusm-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/arlusm~fiverr-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-arlusm-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",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Search URLs",
                        "type": "array",
                        "description": "Search URLs",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "proxyCountryCode": {
                        "title": "Proxy Country Code",
                        "maxLength": 2,
                        "type": "string",
                        "description": "Specify the two-letter country code for remote proxies, or 'LOCAL' for a local proxy.",
                        "default": "FR"
                    },
                    "customCookies": {
                        "title": "Custom Cookies",
                        "type": "string",
                        "description": "Specify custom cookies as a single string. Example: 'key1=value1; key2=value2'",
                        "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
