NataTop APInatatop.ge ↗
Access NataTop.ge's bridal and wedding product catalog via API. Retrieve product listings, variants, attributes, pricing, and stock for wedding dresses and accessories.
What is the NataTop API?
The NataTop.ge API provides access to the full bridal and wedding fashion catalog from NataTop.ge, a Georgian bridal retailer, through 2 endpoints. Use list_products to page through the catalog with filters for category, stock status, and sort order, or call get_product with a slug to retrieve complete details including multilingual names, all product images, variant-level SKUs and pricing, and structured attributes like fabric, silhouette, and neckline.
curl -X GET 'https://api.parse.bot/scraper/b9d90ad1-07b7-42ad-a649-e686588139df/list_products?page=1&category=wedding-dresses&in_stock=true&ordering=-created_at&page_size=50' \ -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 natatop-ge-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: NataTop SDK — bounded, re-runnable; every call capped."""
from parse_apis.natatop_ge_api import NataTop, Ordering, CategorySlug, ProductNotFound
client = NataTop()
# List products filtered to wedding dresses, ordered by newest first.
for item in client.product_summaries.list(category=CategorySlug.WEDDING_DRESSES, ordering=Ordering.NEWEST, limit=3):
print(item.name["en"], item.current_price, item.in_stock)
# Drill into the first product for full details (description, variants, images).
summary = client.product_summaries.list(ordering=Ordering.NEWEST, limit=1).first()
try:
product = summary.details()
print(product.name["en"], product.description["en"])
for variant in product.variants:
print(variant.sku, variant.price, variant.stock)
except ProductNotFound as e:
print("product gone:", e.slug)
print("exercised: product_summaries.list, ProductSummary.details")
Retrieve the product catalog with summary info for each item. Supports filtering by category and stock status. Results are auto-iterated across pages. Each product summary includes pricing, category, primary image, and stock status but not full details (description, variants, attributes, images) — use get_product for those.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| category | string | Filter by category slug (e.g. wedding-dresses, accessories, evening-wear, bridal-shoes). |
| in_stock | string | Filter by stock availability. Pass 'true' to show only in-stock products. |
| ordering | string | Sort order for results. Prefix with '-' for descending. |
| page_size | integer | Number of products per page. |
{
"type": "object",
"fields": {
"next": "URL of the next page or null",
"count": "total number of products matching the filter",
"previous": "URL of the previous page or null",
"products": "array of product summaries"
},
"sample": {
"data": {
"next": null,
"count": 12,
"previous": null,
"products": [
{
"id": "8bcd2019-b008-4742-9dee-fd28a5e015d0",
"name": {
"en": "Ethereal Embroidered Corset Wedding Gown with Cape",
"ka": "ნაზი კორსეტიანი საქორწინო კაბა"
},
"slug": "ethereal-embroidered-corset-wedding-gown-with-cape",
"category": {
"id": 1,
"name": {
"en": "Wedding Dresses",
"ka": "საქორწილო კაბები"
},
"slug": "wedding-dresses",
"image": "https://cdn.natatop.com/media/categories/wedding_dresses.jpg",
"order": 1,
"is_active": true
},
"in_stock": true,
"base_price": "4800.00",
"created_at": "2026-05-13T05:19:26.692946Z",
"is_on_sale": false,
"sale_price": null,
"current_price": "4800.00",
"primary_image": {
"id": 88,
"image": "https://cdn.natatop.com/media/products/2026/05/a4a6346a877d4277aaa689950d6d7a3f.png",
"order": 2,
"alt_text": {
"en": "Ethereal Embroidered Corset Wedding Gown with Cape"
},
"is_primary": false
},
"short_description": {
"en": "A fairytale wedding gown featuring a beautifully structured square-neck corset.",
"ka": "ზღაპრული საქორწინო კაბა"
}
}
]
},
"status": "success"
}
}About the NataTop API
Catalog Browsing with list_products
The list_products endpoint returns a paginated summary of products across NataTop.ge's catalog. Each response includes a count of total matching products, next and previous pagination URLs, and a products array of summaries containing the item's price, category, primary image, and stock status. You can narrow results using the category parameter (accepted slugs include wedding-dresses, accessories, evening-wear, and bridal-shoes), filter to available inventory only with in_stock=true, and control sort direction via the ordering parameter (prefix with - for descending). The page and page_size inputs let you step through large result sets.
Full Product Details with get_product
Passing a product slug from list_products results to get_product returns a complete product record. The response includes a unique id (UUID), multilingual name and description fields in English and Georgian (en/ka), the full images array, and a structured attributes array covering properties such as fabric, silhouette, neckline, and color. The variants field lists each individual SKU with its own price, stock flag, and attribute values — useful for enumerating size or color options. The base_price field gives the original price as a decimal string, and created_at provides an ISO 8601 timestamp.
Category and Attribute Coverage
The catalog spans four main categories: wedding dresses, accessories, evening wear, and bridal shoes. Product attributes vary by category but consistently include styling details relevant to bridal fashion. The category field in get_product returns the category's id, name, and slug, making it straightforward to group or cross-reference products by category in your application. Collection membership is also returned, allowing products to be grouped into curated sets.
The NataTop API is a managed, monitored endpoint for natatop.ge — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when natatop.ge 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 natatop.ge 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?+
- Sync NataTop.ge's bridal dress catalog into a local database, checking in_stock status for inventory tracking.
- Build a filtered product browser that lets users narrow by category slug (e.g. bridal-shoes or evening-wear).
- Display multilingual product names and descriptions (en/ka) for a bilingual Georgian/English storefront integration.
- Extract variant-level SKU and pricing data to compare size or color options for a given dress.
- Aggregate product attribute data (silhouette, neckline, fabric) to build faceted search or recommendation logic.
- Monitor price changes on specific slugs by polling get_product and comparing base_price over time.
- Compile a structured product feed for a wedding planning app using images, category, and attribute fields.
| 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.