Skip to content

Junglescout/junglescout-python-client

Repository files navigation

Jungle Scout Python Client

The official Jungle Scout API Python Client with both sync and async support. Documentation for this client is available on Read the Docs.

See the Jungle Scout API Documentation and the Jungle Scout Postman Collection for more information about the Jungle Scout API.

Rate Limits

The current API request limit per minute is 300, and our burst limit per second is 15.

Installation

pip install junglescout-client

Usage

Here's a quick example using sync client to get keywords by ASIN:

from junglescout import ClientSync
from junglescout.models.parameters import Marketplace, ApiType, FilterOptions, Sort

API_KEY_NAME = "api_key_name"
API_KEY = "api_key"

client = ClientSync(
    api_key_name=API_KEY_NAME,
    api_key=API_KEY,
    marketplace=Marketplace.US,
    api_type=ApiType.JS
)

filter_options = FilterOptions(min_monthly_search_volume_exact=150)

keywords = client.keywords_by_asin(
    asin='B005IHSKYS',
    filter_options=filter_options,
    sort_option=Sort.MONTHLY_SEARCH_VOLUME_EXACT_MATCH
)

client.close()

See the documentation for information on the available methods and parameters.

Pydantic Models

This project defines API model objects using Pydantic. Autocomplete for model parameters during instantiation should work by default in most modern IDEs. For Jetbrains IDEs, the Pydantic plugin is required for autocomplete. See the following links for more information:

Contributing

Contributions are welcome! Please read the contributing guidelines for more information.