---
id: cloudsearch
version: "0.0.12"
license: Apache Software License 2.0
license_treatment: permissive
maintenance: abandoned
---

# cloudsearch — cloudsearch sdk for aws cloudsearch

License: permissive · Maintenance: abandoned · Downloads: 74.0K/mo

## What it is and what it does

Cloudsearch is a thin Python wrapper around AWS CloudSearch that handles query construction and result parsing. It takes a search term, credentials, and a CloudSearch endpoint URL, then returns results either as raw dictionaries or as a pandas DataFrame via the sortedSearch() method. The wrapper supports query options like field boosting and filter queries to refine results.

The package depends on boto3 for AWS interaction and pandas for DataFrame output. It's designed for developers who want to query CloudSearch without writing low-level AWS API calls directly. However, the project has been abandoned since April 2021 and may not be compatible with current versions of its dependencies or recent CloudSearch API changes.

Use it for:

- Query an AWS CloudSearch domain and retrieve results as a pandas DataFrame for analysis or export.
- Boost specific fields in CloudSearch queries to prioritize certain attributes in search rankings.
- Apply filter queries to narrow CloudSearch results by category or other structured fields.
- Prototype or script CloudSearch interactions without writing raw boto3 CloudSearch API calls.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wrapper for AWS CloudSearch that simplifies querying and returns results as pandas DataFrames, with support for filtering and field boosting.

No. The package is abandoned (last release 2021-04-20) and offers only a thin convenience wrapper around boto3 CloudSearch calls. For new projects, call boto3's CloudSearch client directly or use a maintained alternative. For existing code already using this package, consider migrating to direct boto3 calls to avoid potential compatibility issues as dependencies and AWS APIs evolve.

## Install

pip install cloudsearch
uv add cloudsearch
poetry add cloudsearch

## Installing cloudsearch

Before you install: Low install friction with only two runtime dependencies (boto3 and pandas). However, the package is abandoned—last release was 2021-04-20, over 1942 days ago. No recent maintenance or updates.

License in practice: Licensed under Apache Software License 2.0 (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart:

pip install cloudsearch

from cloudsearch.cloudsearch import Search
searcher = Search(searchTerm='banana', key=USER, pw=PW, endpoint=searchEndpoint)
result = searcher.search(size=1000)
print(f'found {len(list(result))} results')

Requires valid AWS CloudSearch endpoint URL, credentials (key and password), and an active CloudSearch domain.

Verify before relying:

- Whether the package works with modern versions of boto3 and pandas given its 1942-day age since last release.
- Current compatibility with Python 3.9+ (package declares support only through 3.8).
- Whether AWS CloudSearch API changes since 2021 have broken the wrapper's functionality.

## Package facts

- License: Apache Software License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 74.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws cloudsearch python wrapper, cloudsearch sdk query results, pandas dataframe search results, cloudsearch filtering and boosting, aws cloudsearch client library, cloudsearch sorted results, cloudsearch query builder, aws-integration, search-client

[View on SkillFed](https://skillfed.io/packages/cloudsearch) · [View on PyPI](https://pypi.org/project/cloudsearch/)