Test

Status: NEEDS-ACCOUNT

Classification: NEEDS-ACCOUNT (cloud API) Install method: npm (npm install @airtop/sdk) or pip (pip install airtop) for the SDK client Cost tier: Free tier available; paid plans for higher usage. See airtop.ai for current pricing. What is required: An account at airtop.ai and a valid API key (AIRTOP_API_KEY). The SDK is a client; all browser sessions run in Airtop's cloud.

---

SDK version check (Node.js)

After installing, verify the package is present:

node -e "const s = require('@airtop/sdk'); console.log('airtop/sdk loaded:', typeof s.AirtopClient);"

Expected output:

airtop/sdk loaded: function

This confirms the package installed correctly and the AirtopClient class is exported. No API key is required for this check.

SDK version check (Python)

python -c "import airtop; print('airtop loaded:', airtop.__version__)"

Expected output (version number will vary):

airtop loaded: 0.x.y

Live session smoke test (Node.js)

Requires a valid AIRTOP_API_KEY. Save the following as smoke.mjs:

import { AirtopClient } from '@airtop/sdk';

const client = new AirtopClient({ apiKey: process.env.AIRTOP_API_KEY });
const session = await client.sessions.create();
console.log('Session created:', session.data.id);
await client.sessions.terminate(session.data.id);
console.log('Session terminated. Smoke test passed.');

Run:

AIRTOP_API_KEY=your_key node smoke.mjs

Expected output:

Session created: <uuid>
Session terminated. Smoke test passed.

A UUID-format session ID printed on the first line confirms a real cloud browser session was created successfully. The termination line confirms the SDK round-trip completed and credits were released.

Live session smoke test (Python)

import os
from airtop import Airtop

client = Airtop(api_key=os.environ["AIRTOP_API_KEY"])
session = client.sessions.create()
print("Session created:", session.data.id)
client.sessions.terminate(session.data.id)
print("Session terminated. Smoke test passed.")

Run:

AIRTOP_API_KEY=your_key python smoke.py

Expected output:

Session created: <uuid>
Session terminated. Smoke test passed.

Failure modes

Error	Likely cause
401 Unauthorized	Invalid or missing AIRTOP_API_KEY
429 Too Many Requests	Exceeded simultaneous session limit for your tier
Session hangs without terminating	Called terminate() before checking session status; or network timeout