CookieRobot makes your profiles look more legit by automatically collecting cookies from your chosen websites – no manual crawling needed! In this guide, we’ll walk you through how to use it to streamline the process.

Already familiar with automation or completed some steps? Use the table of contents on the right to jump straight to what you need. Let’s go!

Step 1: set up your Postman

After installing Postman, open the Multilogin X API page:  

1. In the top-right corner, click "Run in Postman"
2. Select “Postman for <your OS>”

Your Postman Desktop will open. To import all API endpoints to your local collection:

1. In “Import collection” → select your workspace
2. Click "Import" → all endpoints will be available in folders

Sign in via Postman

Locate the User Sign in endpoint

1. Open “Collections” → expand the “Multilogin X API” folder
2. Open “Profile Access Management” folder
3. Select the POST User Sign In endpoint (What is a POST request?)

Convert your password to MD5 

 This is how to use MD5 Hash Generator to get your encrypted password:

1. Insert your Multilogin X password
2. Click “Generate”
3. Copy your MD5 encrypted password

Get your API token

1. In POST User Sign In → go to the “Body” tab
2. Fill in your e-mail and your MD5 password as “strings”
3. Send the request to sign in

4. Check the access token in the “Response” area below → copy everything inside quotation marks

Step 2: open Script Runner

Now that you're signed in and have the token, you have all access to use the Script Runner endpoint and run your CookieRobot script!

1. Go back to “Collections” →  “Multilogin X API” folder
2. Go to “Script Runner” folder
3. Open POST Start Script Runner endpoint to configure a new API request! 

4. From the “Params” tab, proceed to “Authorization”
5. Select “Bearer Token” as the Auth Type
6. In the “Token” field on the right, paste your API token previously copied 

Add the CookieRobot script

Once your token is inserted in the Authorization tab:

1. Proceed to the “Body” tab
2. Make sure that raw parameter is selected
3. Insert the sample CookieRobot request body (JSON):

{
    "script_file": "cookie_robot.py",
    "profile_ids": [
        {
            "profile_id": "profile uuid"
        },
        {
            "profile_id": "profile uuid",
            "is_headless": true
        }
    ],
    "script_params": [
        {
            "name": "websites",
            "value": ["https://youtube.com","https://google.com","https://fb.com","https://amazon.com"]
        },
        {
            "name": "randomOrder",
            "value": true
        },
        {
            "name": "fractionMode",
            "value": 0.7
        },
        {
            "name": "processCookieConsent",
            "value": true
        }
    ]
}

Step 3: customize the parameters

When launching CookieRobot, there are several customizable parameters that influence how the crawling process works. These parameters allow users to adjust settings such as the target website, crawling order, and more. By fine-tuning these options in the “script_params” section, users can optimize the script’s performance based on their specific needs.

The customizable CookieRobot parameters are highlighted with red color on the screenshot and below:

“profile_ids”

A list that contains profile IDs, structured as:

• “profile_id” – unique profile ID number (make sure to use profiles that doesn't have any pre-opened tabs).
• “is_headless”  – (optional) running in headless mode might limit the bot's interaction with certain page elements

“script_params”

 A list containing a set of customizable parameters, simply indicated by:

• “name” – the parameter name
• “value” – the assigned value (string, integer, float, JSON, etc.) 

“websites”

Want to grab cookies from multiple websites? Just list them here! Note that websites can be listed with or without the www., http:// or https://.

websites = [
  "https://aliexpress.com",
  "https://amazon.com",
  "https://ebay.com",
  "https://fiverr.com",
  "https://google.com",
  "https://reddit.com",
  "https://twitch.com",
  "https://twitter.com",
  "https://yahoo.com",
  "https://youtube.com",
  "https://en.wikipedia.org"
  ]

“randomOrder”

• Set to “true” → mix things up and visit sites randomly
• Set to  “false” → keep everything in order and visit sites as listed

“fractionMode”

Want to run just a portion of your websites, instead of all of them? Check how to use it:

1. Choose a float number between 0.0 and 1.0 to set the fraction of sites to run
2. Make sure that “randomOrder” is set to “true”

Example: if using "fractionMode"= “0.5”, it will run 50% of the list of websites in a random order

“processCookieConsent”

Many websites display an “Allow cookies” button due to privacy laws like GDPR (What is GDPR?), which requires user consent before tracking cookies.

• Set to “true” →  CookieRobot will look for and try to click the consent button automatically (Default)
• Set to “false” → it will ignore cookie pop-ups, which can be useful if:
  • You're browsing non-EU websites that don’t show cookie banners
  • You’re not concerned about GDPR compliance (e.g., using proxies outside the EU)

Step 4: run CookieRobot

Once your parameters are configured as you need:

1. Click “Send” to run the POST Start Script Runner request
2. Check the request response: Status  200 OK  means success!
3. Your CookieRobot script will launch the selected profile(s). If non-headless, you will be able to watch the crawling in real time! 🔍