perplexity-search-sdk
Python SDK for the Perplexity Search API: live web search and query-relevant page snippets. A thin Python wrapper over a compiled core built from Perplexity-internal source.
Install
pip install pplx-srch-sdk
CPython 3.12+ on Linux (x86_64, aarch64) and macOS. The import name matches:
import pplx_srch_sdk.
Quick start
Get an API key at perplexity.ai/account/api
and export it as PERPLEXITY_API_KEY.
import pplx_srch_sdk
hits = pplx_srch_sdk.search.web("rust async runtimes", limit=5)
for hit in hits:
print(hit.title, hit.url)
snippets = pplx_srch_sdk.content.snippets(
query="rust async runtimes",
urls=[hit.url for hit in hits],
)
for s in snippets:
print(s.url, s.error or (s.text or "")[:200])
An async client with the same surface is available as
pplx_srch_sdk.AsyncPplxClient.
Development
The Python wrapper (src/pplx_srch_sdk/) is maintained in this repository; PRs
welcome. bin/ holds the compiled core, delivered prebuilt by Perplexity's
internal release pipeline — never edited by hand. pip install . packs the
host platform's .so via scripts/hatch_build.py; wheels for any supported platform
build on any host with PPLX_SDK_PLATFORM=<tag> python -m build --wheel.
Apache-2.0 — see LICENSE.
1 maintainer
Release files for pplx-srch-sdk 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| pplx_srch_sdk-0.2.0-cp312-abi3-manylinux2014_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| pplx_srch_sdk-0.2.0-cp312-abi3-manylinux2014_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| pplx_srch_sdk-0.2.0-cp312-abi3-macosx_11_0_x86_64.whl | CPython 3.12 | abi3 | macOS 11.0+ x86-64 | Details |
| pplx_srch_sdk-0.2.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 12.7 MB
Release files / pplx_srch_sdk-0.2.0-cp312-abi3-manylinux2014_x86_64.whl
| Download URL | pplx_srch_sdk-0.2.0-cp312-abi3-manylinux2014_x86_64.whl |
|---|---|
| Size | 3.3 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
290a5c33b1fec16a96b65ec23e1aab66743534d88f484a0fba621069e86eb077
|
|
BLAKE2b-256 checksum How to use checksums |
37384f54e1cde7c318393bd76e2a0a728ef777b98eacbfc76b7d6e3a3ff707dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency logRelease files / pplx_srch_sdk-0.2.0-cp312-abi3-manylinux2014_aarch64.whl
| Download URL | pplx_srch_sdk-0.2.0-cp312-abi3-manylinux2014_aarch64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
3a83bcdc1255d1148cc0b7a1754c20e4a8b68a4d6efd65f1b95d7ec4cc22bd24
|
|
BLAKE2b-256 checksum How to use checksums |
6e4557a4c88e94a9a211765757a401364a5d9112467f43a54870f9513a20dd49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency logRelease files / pplx_srch_sdk-0.2.0-cp312-abi3-macosx_11_0_x86_64.whl
| Download URL | pplx_srch_sdk-0.2.0-cp312-abi3-macosx_11_0_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
f50df90ba3115d5555181f84aebada176646e9a12f0df45c57eb914fd4e08800
|
|
BLAKE2b-256 checksum How to use checksums |
c278f386a16d4a138ca41971f7510a0fa526f3e084b778b41b6c9e4954b291a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency logRelease files / pplx_srch_sdk-0.2.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | pplx_srch_sdk-0.2.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 3.0 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6ab98cfad55b65254c1e4817469f1ea51aecfc80627e95112e895fd73d55f06e
|
|
BLAKE2b-256 checksum How to use checksums |
c73d8909e37e1d129179d4ca65cd144ffe5fc06047af6f9c7762b952f1c0b94d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 12, 2026.
Transparency log
