Boygars APIboygars.com ↗
Access Boygars luxury multibrand store product catalog via API. Retrieve item listings, pricing in GEL, sizes, color variants, and stock info.
What is the Boygars API?
The Boygars API provides 2 endpoints to access the full product catalog of Boygars, a luxury multibrand fashion store based in Tbilisi, Georgia. Use list_products to retrieve all item/color combinations across the catalog — optionally filtered by gender — and get_product to pull detailed records including localized names in three languages, current GEL pricing, composition, available sizes, color variants with media URLs, and live stock status.
curl -X GET 'https://api.parse.bot/scraper/23039631-719c-4b84-a797-026ee9aea0d7/list_products?gender=women' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace boygars-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: boygars SDK — bounded, re-runnable; every call capped."""
from parse_apis.boygars_com_api import Boygars, Gender, ProductNotFound
client = Boygars()
# List women's products (item/color pairs); limit caps total items fetched.
for record in client.products.list(gender=Gender.WOMEN, limit=3):
print(record.item_id, record.color_id)
# Take one item_id and fetch its full details.
first = client.products.list(gender=Gender.MEN, limit=1).first()
try:
product = client.products.get(item_id=str(first.item_id))
print(product.name, product.price, product.composition)
except ProductNotFound as e:
print("not found:", e.item_id)
print("exercised: products.list, products.get")
Returns the full product catalog as item/color pairs. Each record carries an item_id and a color_id; multiple records may share the same item_id when that item is available in several colors. Optionally filter by gender. The response is a single page containing all matching products.
| Param | Type | Description |
|---|---|---|
| gender | string | Filter products by gender category. |
{
"type": "object",
"fields": {
"products": "array of product records with item_id and color_id",
"total_records": "total item/color pair count",
"total_unique_items": "count of distinct item IDs"
},
"sample": {
"data": {
"products": [
{
"item_id": 10390,
"color_id": 5
},
{
"item_id": 10362,
"color_id": 21
}
],
"total_records": 3100,
"total_unique_items": 2806
},
"status": "success"
}
}About the Boygars API
Catalog Browsing with list_products
The list_products endpoint returns every product in the Boygars catalog as a flat list of item/color pairs, each carrying an item_id and a color_id. Because a single garment may be available in multiple colorways, one item_id can appear in several records. The response always includes total_records (the full item/color pair count) and total_unique_items (the count of distinct items). An optional gender parameter narrows results to men's or women's offerings.
Product Details with get_product
Passing an item_id from list_products to get_product retrieves the complete product record. The response includes the product name in English, Georgian, and Russian; the price field expressed as an integer in GEL (divide by 100 for the decimal value); an article code; and structured details covering composition and features. The sex field uses a numeric code (1 for men, 2 for women). The record also exposes a lux flag indicating luxury tier, style tags, a text_id URL slug, and an enabled flag showing whether the item is currently active in the store.
Coverage and Scope
The API covers the entire Boygars catalog without pagination — list_products returns all matching records in a single response. Color variant media URLs are available through get_product, making it straightforward to display images alongside availability data. Pricing is in Georgian Lari (GEL).
The Boygars API is a managed, monitored endpoint for boygars.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when boygars.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official boygars.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price tracker for Boygars GEL-denominated luxury items using the
pricefield fromget_product. - Aggregate men's and women's catalog counts separately using the
genderfilter inlist_products. - Sync Boygars inventory into an internal product database using
enabledand stock fields fromget_product. - Display localized product names for Georgian, English, and Russian audiences using the multilingual
namefield. - Enumerate all colorways for a given item by matching
item_idrecords with distinctcolor_idvalues fromlist_products. - Generate a product feed with slugs, tags, and media URLs from
text_id,tags, and color variant URLs inget_product.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Boygars have an official developer API?+
What does the gender filter in list_products actually control?+
gender parameter limits returned item/color pairs to products tagged for that gender category. The sex field in get_product uses numeric codes: 1 for men, 2 for women. Both endpoints reflect the same gender classification used in the Boygars catalog.Does the API return customer reviews or ratings for products?+
Is the price field returned in a standard decimal format?+
price field in get_product is returned as an integer in Georgian Lari (GEL). To get the standard decimal price, multiply by 0.01. For example, a value of 45000 represents 450.00 GEL.Does the API support filtering by brand, category, or price range within list_products?+
list_products is gender. Brand, category, and price-range filtering are not exposed. You can fork the API on Parse and revise it to add those filtering parameters.