Sticky session

A sticky session preserves cookies, local and session storage between requests. To enable this feature, simply set the session query parameter to the same value between requests. session value must be a string of length between 1 and 512 characters. A session expires after 24 hours since it was last used.

tip

You can also preload localStorage with preload localStorage or set values dynamically using JS Scenario.

Example

The following example demonstrates how to enable sticky session and preserve cookies between requests to httpbin.org website /coookies endpoint. In the first request, we set cookie cookie-name to value cookie-value. In the second request, we retrieve cookies using the same session which was used in the first request, therefore, we get cookie-name=cookie-value cookie in the response.

Python

import requests
import json

session_id = "my_session"

payload1 = {
  "api_key": "[your API key]",
  "url": "https://httpbin.org/cookies",
  "cookies": json.dumps([{"name": "cookie-name", "value": "cookie-value"}]),
  "session": session_id,
}

response1 = requests.get("https://scraping.narf.ai/api/v1/", params=payload1)

payload2 = {
  "api_key": "[your API key]",
  "url": "https://httpbin.org/cookies",
  "session": session_id,
}

response2 = requests.get("https://scraping.narf.ai/api/v1/", params=payload2)
print(response2.content)

NodeJS

const axios = require("axios");

const session_id = "my_session";

const payload1 = {
  api_key: "[your API key]",
  url: "https://httpbin.org/cookies",
  cookies: JSON.stringify([{name: "cookie-name", value: "cookie-value"}]),
  session: session_id,
};

const response1 = await axios.get("https://scraping.narf.ai/api/v1/", { params: payload1 });

const payload2 = {
  api_key: "[your API key]",
  url: "https://httpbin.org/cookies",
  session: session_id,
};

const response2 = await axios.get("https://scraping.narf.ai/api/v1/", { params: payload2 });
console.log(response2.data);

cURL

curl -G --data-urlencode 'url=https://httpbin.org/cookies' \
--data-urlencode 'cookies=[{"name": "cookie-name", "value": "cookie-value"}]' \
'https://scraping.narf.ai/api/v1/?api_key=[your API key]&session=my_session'

curl -G --data-urlencode 'url=https://httpbin.org/cookies' \
'https://scraping.narf.ai/api/v1/?api_key=[your API key]&session=my_session'

In the second request, httpbin.org/cookies endpoint returns cookie cookie-name set in the first request:

{
    "cookies": {
        "cookie-name": "cookie-value"
    }
}