Browse and search marketplace stores

Search and filter stores in the Partle marketplace. No authentication required.

Perfect for AI assistants to help users find stores, get location information,
or browse available retailers. Supports text search, tag filtering, and
**location-based search** to find stores near a given coordinate.

**Use Cases:**
- "Show me electronics stores" → `?q=electronics`
- "Find stores near Madrid" → `?lat=40.42&lon=-3.70&radius_km=15`
- "Hardware stores near me" → `?q=hardware&lat=41.38&lon=2.17`

**Rate Limit:** 100 requests per hour per IP

get/v1/public/stores

Request

Base URL: http://localhost:8000
URL: http://localhost:8000/v1/public/stores
Auth: none declared

Query parameters

qstring nullable

Search term for store name, address, or website (e.g., 'Bauhaus', 'Barcelona')

tagsstring nullable

Filter by tags, comma-separated (e.g., 'electronics,hardware')

latnumber nullable

Latitude for location-based search (e.g., 40.42 for Madrid)

lonnumber nullable

Longitude for location-based search (e.g., -3.70 for Madrid)

radius_kmnumber nullable

Search radius in kilometers (default: 25, e.g., 10 for nearby only)

limitinteger

Number of stores to return (1-50, default: 20)

offsetinteger

Number of stores to skip for pagination (default: 0)

Response

List of stores matching the search criteria

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.