Mouser Python API

Setup

Requirements

• Tested with Python 3.8+
• Dependencies: typer and requests packages

Mouser API Keys

Mouser provides two separate API keys:

• one for the cart and orders
• one for part searches.

Go to Mouser's API hub to request the keys.

To store the keys, two options:

• create two environmental variables MOUSER_ORDER_API_KEY and MOUSER_PART_API_KEY with the respective values of each key
• create a file named mouser_api_keys.yaml with the order API key on the first line and the part API key on a second line.

⚠️ Using the mouser_api_keys.yaml file method, make sure to run mouser commands in the same folder!

The keys will be automatically loaded for each API request.

Install

Pip

pip install mouser

UV (Recommended for Development)

1. Install uv: pip install uv
2. Create virtual environment: uv venv
3. Activate the virtual environment: source .venv/bin/activate (Linux/Mac) or .venv\Scripts\activate (Windows)
4. Install the package: uv pip install -e .

To install with development dependencies:

uv pip install -e ".[dev]"

Run

Pip

mouser

Manually

python mouser_cli.py

UV

# After activating the virtual environment
mouser

Usage

This command line tool reflects the usage from Mouser's API structure documented here.
The first positional argument is the category of the request: cart (for MouserCart), order, history (for MouserOrderHistory) and search (for SearchAPI). The second argument is the type of operation from the list of operations for each category.

Run mouser --help for more information about the usage.

Examples

The examples below assume this package was installed using Pip (for more options, see above)

Part Number Search

mouser search partnumber --number XXX

Export order to CSV

mouser order get --number XXX --export