{"id":3732,"library":"parallel-web","title":"Parallel Python SDK","description":"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.","status":"active","version":"0.4.2","language":"en","source_language":"en","source_url":"https://github.com/parallel-web/parallel-sdk-python","tags":["api-client","web-scraping","ai-automation","data-extraction","search"],"install":[{"cmd":"pip install parallel-web","lang":"bash","label":"Install latest version"}],"dependencies":[],"imports":[{"symbol":"Parallel","correct":"from parallel import Parallel"}],"quickstart":{"code":"import os\nfrom parallel import Parallel\n\n# Ensure PARALLEL_API_KEY is set in your environment variables\napi_key = os.environ.get('PARALLEL_API_KEY', '')\n\nif not api_key:\n    print(\"Error: PARALLEL_API_KEY environment variable not set.\")\nelse:\n    try:\n        client = Parallel(api_key=api_key)\n        response = client.search.run(query=\"latest news in AI\")\n        print(response.json())\n    except Exception as e:\n        print(f\"An error occurred: {e}\")","lang":"python","description":"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."},"warnings":[{"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.","message":"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.","severity":"breaking","affected_versions":"0.3.0"},{"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.","message":"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.","severity":"gotcha","affected_versions":"0.3.2 onwards"},{"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.","message":"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.","severity":"gotcha","affected_versions":"0.4.0 onwards"},{"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.","message":"Early versions of the library (prior to `v0.3.4`) may experience compatibility issues with Python 3.14.","severity":"gotcha","affected_versions":"<0.3.4"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}