Gorgia APIgorgia.ge ↗
Access product listings, prices, availability, and specifications from gorgia.ge, Georgia's home improvement and electronics retailer, via 2 structured endpoints.
What is the Gorgia API?
The Gorgia.ge API provides structured access to product data from gorgia.ge, a Georgian retailer covering home improvement, electronics, furniture, and construction supplies, across 2 endpoints. The search_products endpoint returns paginated listings with prices, stock status, and images, while get_product_details delivers full specifications, SKU, category breadcrumbs, and discount pricing for individual items.
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
Endpoints and Data Coverage
The API exposes two endpoints. search_products accepts an optional query string for full-text search across product names and codes, or a category slug (such as teqnika, aveji, santeqnika, or klimaturi-teqnika) to browse a specific category. Results are paginated and each product summary includes id, title, url, image, price, old_price, and stock status. You can control page size with items_per_page (24, 48, 96, or 192) and order results with sort_by.
Product Detail Fields
get_product_details takes a product_url path — obtainable from search_products results — and returns a single product record. Fields include sku, title, price, old_price, currency (GEL), in_stock, image_url, categories (full breadcrumb array from top to bottom), and features, which is a key-value object covering attributes like brand, country of origin, and weight. This endpoint is the place to retrieve specification-level data that product listing summaries omit.
Pricing and Discount Data
Both endpoints expose old_price alongside price. When old_price is non-null, the product is on discount. Currency is always GEL (Georgian Lari). There is no conversion field — callers needing another currency must handle conversion externally.
Pagination and Category Browsing
search_products returns page, total_pages, and items_per_page on every response. total_products is present but may be null depending on the category or query context. Category slugs map to gorgia.ge's top-level navigation sections; subcategory slugs can also be passed to narrow results further.
The Gorgia API is a managed, monitored endpoint for gorgia.ge — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when gorgia.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 gorgia.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?+
- Monitor price drops and discount availability across electronics or furniture categories by comparing
priceandold_pricefields. - Build a product catalogue for a Georgian retail aggregator by paginating through categories using
categoryslugs anditems_per_page. - Check real-time
in_stockstatus for specific SKUs to power inventory alerting tools. - Extract
featureskey-value pairs fromget_product_detailsto compare specifications across products like climate control or construction equipment. - Populate a price comparison tool covering the Georgian market using search results including
title,price, andurl. - Track category-level assortment changes over time by paginating
search_productswith a fixedcategoryand recordingtotal_products.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does gorgia.ge provide an official developer API?+
What does `get_product_details` return beyond what `search_products` provides?+
search_products returns a summary per product: id, title, url, image, price, old_price, and stock status. get_product_details adds sku, the full categories breadcrumb array, and the features object — a key-value set of product attributes such as brand, country, and weight that are not present in listing results.Does the API return customer reviews or ratings for products?+
features field, stock status, and category data. Reviews and ratings are not included in either endpoint's response. You can fork this API on Parse and revise it to add a reviews endpoint if that data is available on the product page.What happens when `total_products` is null in `search_products` results?+
total_products can be null for certain category or query combinations where the site does not expose a total count. total_pages and page are always populated, so you can still paginate through all results even when the total item count is unavailable.Can I retrieve products from subcategories, or only top-level categories?+
category parameter in search_products accepts both top-level slugs (e.g. teqnika) and subcategory slugs (e.g. klimaturi-teqnika). Passing a more specific slug narrows results to that subcategory. If the exact slug for a subcategory is unknown, browsing the top-level category first and inspecting product url fields can help identify the correct slug pattern.