Media Domain

Media Domain

Multi-provider media search across 6 free/open APIs.

Commands

Search

magmascript media search "pixel art"                    # all providers
magmascript media search "album cover" --source pexels  # specific provider
magmascript media search "statue" --type image          # filter by type
magmascript media search "landscape" --orientation horizontal  # filter by orientation
magmascript media search "art" --page 2 --per-page 12   # pagination

Providers

magmascript media providers                             # list all providers

Single Result

magmascript media image 12345 --source met_museum       # get by ID

Providers

Provider	Key needed	Types	Rate limit
Openverse	No	image, audio, video	~5 req/sec
Pexels	Free	image, video	200/hr
Pixabay	Free	image, video	100/min
Met Museum	No	image	generous
Smithsonian	No	image	40/hr (DEMO_KEY)
Internet Archive	No	image, audio, video	generous

Configuration

Pexels and Pixabay require free API keys:

• Pexels: https://www.pexels.com/api/
• Pixabay: https://pixabay.com/api/docs/

Set via config file:

[media]
pexels_key = "your-key"
pixabay_key = "your-key"

Or env vars:

export MAGMA_PEXELS_KEY="your-key"
export MAGMA_PIXABAY_KEY="your-key"

Output Formats

magmascript media search "art" --table    # default table
magmascript media search "art" --json     # JSON output