Parallel Python SDK

0.4.2 · active · verified Sat Apr 11

The official Python library for interacting with the Parallel API. It provides programmatic access to Parallel's web data extraction and search capabilities. The library maintains an active development pace with frequent updates, typically on a monthly or bi-monthly schedule, reflecting continuous API enhancements.

Warnings

breaking Version `0.3.0` contains a critical bug in parameter handling and should not be used. It can lead to incorrect API requests or unexpected errors.
Fix: Upgrade to `v0.3.1` or a newer version (e.g., `pip install --upgrade parallel-web`) or downgrade to `v0.2.2` if necessary.
gotcha The library frequently updates to support beta API endpoints (e.g., `/v1beta/search`, `/v1beta/extract`). While default beta headers are often handled, the behavior and stability of these endpoints may change rapidly. Features like `search` and `extract` have seen multiple beta iterations.
Fix: Always consult the official Parallel API documentation (outside the SDK) when relying on beta features for production use to understand their stability guarantees and potential breaking changes.
gotcha The nomenclature for `findAll` methods was updated in `v0.4.0`. If your application uses `findAll` pattern methods, they may need to be adjusted or renamed to align with the new API structure.
Fix: Review the changelog or official documentation for `v0.4.0` for specific details on how `findAll` related methods have changed and update your code accordingly.
gotcha Early versions of the library (prior to `v0.3.4`) may experience compatibility issues with Python 3.14.
Fix: Ensure you are using `parallel-web` version `0.3.4` or newer if developing with Python 3.14 or later. For older Python versions, this is not an issue.

Install

pip install parallel-web Install latest version

Imports

Parallel
```
from parallel import Parallel
```

Quickstart

Initializes the Parallel client and performs a simple search query, printing the JSON response. Your `PARALLEL_API_KEY` must be set as an environment variable.

import os
from parallel import Parallel

# Ensure PARALLEL_API_KEY is set in your environment variables
api_key = os.environ.get('PARALLEL_API_KEY', '')

if not api_key:
    print("Error: PARALLEL_API_KEY environment variable not set.")
else:
    try:
        client = Parallel(api_key=api_key)
        response = client.search.run(query="latest news in AI")
        print(response.json())
    except Exception as e:
        print(f"An error occurred: {e}")

view raw JSON →