{"openapi":"3.0.3","info":{"title":"Pigu API (ReefAPI)","version":"0.1.0","description":"Pigu API — Baltic and Finnish marketplace (pigu.lt, 220.lv, kaup24.ee, hobbyhall.fi): EUR prices for everyone and for Pigu PLUS members, every seller's offer, delivery dates and fees, specs Call POST /pigu/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/pigu-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"Pigu API documentation","url":"https://reefapi.com/docs/pigu"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"pigu","description":"Pigu API — Baltic and Finnish marketplace (pigu.lt, 220.lv, kaup24.ee, hobbyhall.fi): EUR prices for everyone and for Pigu PLUS members, every seller's offer, delivery dates and fees, specs"}],"paths":{"/pigu/v1/search":{"post":{"operationId":"pigu_search","summary":"Keyword search in one Pigu Group shop (country lt/lv/ee/fi)","description":"Keyword search in one Pigu Group shop (country lt/lv/ee/fi). Each row: product id and modification id (pass both to `product`), title, brand, URL, image, price in EUR that everyone pays, Pigu PLUS member price when the shop shows one, monthly instalment from, rating and review count, seller id and supply type (1P = sold by the shop, 3P = marketplace seller), delivery promise, promotion labels, sponsored flag, category id (feeds `category`). Plus the shop's own total and page count. Page on with `next_cursor`: it keeps every page in page 1's result set and drops rows already returned. One of `query` or `cursor` is required.","tags":["pigu"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","example":"lego technic","description":"Search words, as typed in the shop's search box (any language the shop indexes; the local language gives the most rows). Required unless `cursor` is given."},"country":{"type":"string","enum":["lt","lv","ee","fi"],"default":"lt","example":"lt","description":"Which shop: lt = pigu.lt (Lithuania), lv = 220.lv (Latvia), ee = kaup24.ee (Estonia), fi = hobbyhall.fi (Finland). Prices are EUR in all four."},"min_price":{"type":"number","minimum":0,"example":200,"description":"Lowest price in EUR. The shop applies the range to the LOWEST payable price, which is the member price when the row has one, so a row's `price` (for everyone) can be above `max_price` (measured: 200-400 returned rows with `price` up to 487 and `member_price` in range)."},"max_price":{"type":"number","minimum":0,"example":400,"description":"Highest price in EUR (same rule as `min_price`)."},"sort":{"type":"string","enum":["best_selling","price_asc","price_desc","delivery","rating"],"default":"best_selling","example":"price_asc","description":"best_selling (the shop's default), price_asc, price_desc, delivery (fastest delivery first) or rating. Price sorts order by the lowest payable price."},"page":{"type":"integer","minimum":1,"maximum":500,"default":1,"example":1,"description":"Result page, starting at 1 (59-60 rows per page, measured)."},"result_set":{"type":"string","enum":["algolia","classic","landing"],"example":"algolia","description":"The shop answers a keyword from one of two result sets, picked per request (lego technic: 451 or 261 hits). Pass the `result_set` of page 1 when asking for later pages; the engine asks again until the shop answers from that set (up to 3 times). `next_cursor` does this for you."},"cursor":{"type":"string","description":"`next_cursor` from the previous search answer. Carries the query, country, filters, sort, next page, page 1's result set and the product ids already returned; rows returned on earlier pages are dropped and counted in `duplicates_dropped`. Use it alone."}}},"example":{"query":"lego technic","country":"lt"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/pigu/v1/category":{"post":{"operationId":"pigu_category","summary":"One category listing of a Pigu Group shop, by the category id a search row carries in `category_id` (or the id in a shop category URL's listing)","description":"One category listing of a Pigu Group shop, by the category id a search row carries in `category_id` (or the id in a shop category URL's listing). Same row fields as `search`, plus the category title and the shop's own product count.","tags":["pigu"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category_id":{"type":"string","example":"85","description":"Numeric category id, e.g. 85 = mobile phones on pigu.lt. Ids are per shop: take them from a search row of the same country."},"country":{"type":"string","enum":["lt","lv","ee","fi"],"default":"lt","example":"lt","description":"Which shop: lt = pigu.lt (Lithuania), lv = 220.lv (Latvia), ee = kaup24.ee (Estonia), fi = hobbyhall.fi (Finland). Prices are EUR in all four."},"sort":{"type":"string","enum":["best_selling","price_asc","price_desc","delivery","rating"],"default":"best_selling","example":"price_asc","description":"best_selling (the shop's default), price_asc, price_desc, delivery (fastest delivery first) or rating. Price sorts order by the lowest payable price."},"page":{"type":"integer","minimum":1,"maximum":500,"default":1,"example":1,"description":"Result page, starting at 1 (59-60 rows per page, measured)."}},"required":["category_id"]},"example":{"category_id":"85","country":"lt"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":3}},"/pigu/v1/product":{"post":{"operationId":"pigu_product","summary":"One product of a Pigu Group shop by its product id AND modification id (both are on every search/category row)","description":"One product of a Pigu Group shop by its product id AND modification id (both are on every search/category row). Returns the main offer's price for everyone and member price, main seller with rating, every seller's offer with both prices, rating count and delivery date, the delivery options with date and fee, specification table, description, images.","tags":["pigu"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_id":{"type":"string","example":"79734775","description":"Product id exactly as a search row returns it (also the `id=` number of the product URL)."},"modification_id":{"type":"string","example":"101444835","description":"Modification id from the same search row. A modification that belongs to another product answers NOT_FOUND."},"country":{"type":"string","enum":["lt","lv","ee","fi"],"default":"lt","example":"lt","description":"Which shop: lt = pigu.lt (Lithuania), lv = 220.lv (Latvia), ee = kaup24.ee (Estonia), fi = hobbyhall.fi (Finland). Prices are EUR in all four."}},"required":["product_id","modification_id"]},"example":{"product_id":"79734775","modification_id":"101444835","country":"lt"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}