Gorgia APIgorgia.ge ↗
Search for home improvement and electronics products on gorgia.ge and retrieve detailed information like prices, specifications, and availability for items sold by this Georgian retailer. Easily browse thousands of products across categories to compare options and find what you need.
curl -X GET 'https://api.parse.bot/scraper/ae981b03-783b-4b3a-aaf4-b00413afb6fb/search_products?page=1&query=KUMTEL&sort_by=price&category=teqnika&items_per_page=24' \ -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 gorgia-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: gorgia_ge_api SDK — bounded, re-runnable; every call capped."""
from parse_apis.gorgia_ge_api import Gorgia, ProductNotFound
client = Gorgia()
# Browse products in a category
for product in client.product_summaries.search(category="teqnika", limit=3):
print(product.title, product.price, product.currency)
# Search by keyword and drill into details
item = client.product_summaries.search(query="KUMTEL", limit=1).first()
if item:
try:
full = item.details()
print(full.title, full.sku, full.price)
if full.features:
for key, val in list(full.features.items())[:3]:
print(f" {key}: {val}")
except ProductNotFound as e:
print(f"product gone: {e.product_url}")
print("exercised: product_summaries.search, ProductSummary.details")
Search or browse products by query or category. Returns paginated product listings with price, availability, and image data. When category is provided without query, lists all products in that category. When query is provided, performs full-text search across product names, codes, and descriptions. Results are auto-iterated by page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| query | string | Free-text search query matching product names, codes, and descriptions. When omitted, lists products from the specified category. |
| sort_by | string | Sort order for results. When omitted, uses category default sorting. |
| category | string | Category URL slug (e.g. 'teqnika', 'aveji', 'santeqnika', 'klimaturi-teqnika', 'mshenebloba', 'remonti', 'ganateba', 'bagi', 'sabavshvo', 'xelsawyoebi', 'ikeas-produqcia', 'sayofacxovrebo', 'cxovelebis-movla'). Used when query is omitted. |
| items_per_page | integer | Number of products per page. Supported values: 24, 48, 96, 192. |
{
"type": "object",
"fields": {
"page": "current page number",
"products": "array of product summaries with id, title, url, image, price, old_price, stock status",
"total_pages": "total number of pages available",
"items_per_page": "number of items per page",
"total_products": "total product count (null when unavailable)"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"url": "https://gorgia.ge/ka/teqnika/samzareulos-wvrili-teqnika/samzareulos-saswori/სამზარეულოს-სასწორი-kumtel-hks-11/",
"price": 9.99,
"title": "სამზარეულოს სასწორი KUMTEL HKS-11",
"currency": "GEL",
"in_stock": true,
"image_url": "https://gorgia.ge/images/ab__webp/thumbnails/176/176/detailed/78/BM-00220344_jpg.webp",
"old_price": 59,
"product_id": "129171"
}
],
"total_pages": 25,
"items_per_page": 24,
"total_products": null
},
"status": "success"
}
}About the Gorgia API
The Gorgia API on Parse exposes 2 endpoints for the publicly available data on gorgia.ge. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.