{ "openapi": "3.0.0", "components": { "examples": {}, "headers": {}, "parameters": {}, "requestBodies": {}, "responses": {}, "schemas": { "ApiSuccessResponse": { "properties": { "statusCode": { "type": "number", "format": "double", "description": "HTTP status code" }, "messageCode": { "type": "string", "description": "Status message code" }, "data": { "description": "Response data" } }, "required": [ "statusCode", "messageCode", "data" ], "type": "object", "additionalProperties": false }, "ApiErrorResponse": { "properties": { "statusCode": { "type": "number", "format": "double", "description": "HTTP status code" }, "messageCode": { "type": "string", "description": "Status message code" }, "message": { "type": "string", "description": "Error message" } }, "required": [ "statusCode", "messageCode", "message" ], "type": "object", "additionalProperties": false }, "ProductDetailsRequest": { "description": "Request body for fetching product details by URL", "properties": { "url": { "type": "string", "description": "Full URL of the product on Apotea website", "example": "https://www.apotea.se/a-derma-cutalgan-ultra-calming-refreshing-spray-100-ml" } }, "required": [ "url" ], "type": "object", "additionalProperties": false }, "ProductListRequest": { "description": "Request body for fetching product list by URL", "properties": { "url": { "type": "string", "description": "Full URL of the product list on Apotea website", "example": "https://www.apotea.se/ansiktsvatten?sort=name%20asc" } }, "required": [ "url" ], "type": "object", "additionalProperties": false }, "SearchProductQuery": { "description": "Query parameters for searching productes", "properties": { "keyword": { "type": "string", "description": "Search keyword\n\nThe search keyword to find products (e.g., \"vitamin\", \"skincare\", \"shampoo\").", "example": "vitamin" }, "sort_by": { "type": "string", "description": "The sort_by parameter: Sort items by various criteria:\n\n- \"rank asc\" - Popularity (most popular first)\n- \"created desc\" - News (newest first)\n- \"name asc\" - Name A-Z\n- \"name desc\" - Name Z-A\n- \"price asc\" - Lowest Price\n- \"price desc\" - Highest Price\n- \"comp_price asc\" - Lowest Compare Price\n- \"comp_price desc\" - Highest Compare Price", "example": "rank asc" }, "page": { "type": "integer", "format": "int32", "description": "Page number for pagination (starts from 1)", "example": 1, "minimum": 1 } }, "type": "object", "additionalProperties": false } }, "securitySchemes": {} }, "info": { "title": "Apotea API", "version": "1.0.0" }, "paths": { "/scrapers/api/apotea/product/get-by-url": { "post": { "operationId": "Get Product details by url", "responses": { "200": { "description": "Successfully retrieved product details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiSuccessResponse" }, "examples": { "Example 1": { "value": { "statusCode": 200, "messageCode": "OK", "data": [ { "id": "http://www.apotea.se/#242708", "name": "A-Derma Cutalgan Ultra-Calming Refreshing Spray 100 ml", "description": "

A-Derma Cutalgan Ultra-Calming Refreshing Spray är en intensivt lugnande spray för känslig hud som känns torr eller stramar pga torrhet. Cutalgan Refreshing Spray har en kylande och lugnande effekt för att lindra dessa känslor av obehag i huden. Kan användas både på vuxna och barn.

Kan användas i ansikte, kropp, hårbotten och yttre intimområden.

Testad under dermatologisk, pediatrisk och gynekologisk kontroll.

", "image": "https://media.apotea.se/product-images/XL/a-derma-cutalgan-spray-100-ml-0.jpg", "url": "https://www.apotea.se/a-derma-cutalgan-ultra-calming-refreshing-spray-100-ml", "brand": { "@type": "Brand", "name": "A-Derma" }, "offers": { "@type": "Offer", "availability": "https://schema.org/InStock", "item_condition": "https://schema.org/NewCondition", "price": 149, "price_currency": "SEK", "price_valid_until": "2026-10-23", "seller": { "@type": "Organization", "name": "www.apotea.se" } }, "comparative_price": "JämförprisJfr-pris 1 490 kr/l", "stock_info": [], "product_dosage": "Skaka flaskan och spraya 20 cm från huden. Applicera så ofta du behöver, upp till 6 ggr/dag. Sprid ut över huden vid behov. Spraya inte i ögonen. För applicering i ansiktet, spraya först i handen. För spädbarn, barn och vuxna.", "product_contents": "Aqua, Caprylic/Capric Triglyceride, Glycerin, Uncaria Tomentosa Extract, Avena Sativa Leaf/Stem Extract, Acrylates/C10-30 Alkyl Acrylate Crosspolymer, Benzoic Acid, Caprylyl Glycol, Carbomer, Propylene Glycol, Sclerotium Gum, Sodium Hydroxide", "product_facts": [ { "key": "EAN", "value": "

3282770209648

" }, { "key": "Varumärke", "value": "

A-Derma

" }, { "key": "Kategori", "value": "

Ansikte > Ansiktsvatten

" }, { "key": "Förpackningsstorlek", "value": "

100 ml

" } ], "price_history": { "labels": [ "2025-09-23", "2025-09-24", "2025-09-25", "2025-09-26", "2025-09-27", "2025-09-28", "2025-09-29", "2025-09-30", "2025-10-01", "2025-10-02", "2025-10-03", "2025-10-04", "2025-10-05", "2025-10-06", "2025-10-07", "2025-10-08", "2025-10-09", "2025-10-10", "2025-10-11", "2025-10-12", "2025-10-13", "2025-10-14", "2025-10-15", "2025-10-16", "2025-10-17", "2025-10-18", "2025-10-19", "2025-10-20", "2025-10-21", "2025-10-22" ], "prices": [ 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219, 219 ], "price_type": [ 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1 ], "lowest_chart_price": 219 } } ] } } } } } }, "400": { "description": "Bad Request - Invalid URL format", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "404": { "description": "Not Found - Product not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" }, "examples": { "Example 1": { "value": { "statusCode": 500, "messageCode": "INTERNAL_SERVER_ERROR", "message": "Failed to run robot" } } } } } } }, "description": "Get detailed product information by URL", "summary": "Get detailed product information", "tags": [ "Product" ], "security": [], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductDetailsRequest" } } } } } }, "/scrapers/api/apotea/product/listing-by-url": { "post": { "operationId": "Get Product list by url", "responses": { "200": { "description": "Successfully retrieved product information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiSuccessResponse" }, "examples": { "Example 1": { "value": { "statusCode": 200, "messageCode": "OK", "data": [ { "id": "242708", "name": "A-Derma Cutalgan Ultra-Calming Refreshing Spray 100 ml", "image": "https://media.apotea.se/product-images/MS/a-derma-cutalgan-spray-100-ml-0.jpg", "url": "https://www.apotea.se/a-derma-cutalgan-ultra-calming-refreshing-spray-100-ml", "price": "149 kr", "currency": "SEK", "sku": "343371", "from_url": "https://www.apotea.se/ansiktsvatten?sort=name%20asc" } ] } } } } } }, "400": { "description": "Bad Request - Invalid URL format", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "404": { "description": "Not Found - Product not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" }, "examples": { "Example 1": { "value": { "statusCode": 500, "messageCode": "INTERNAL_SERVER_ERROR", "message": "Failed to run robot" } } } } } } }, "description": "Get list of basic product information by URL\n\nRetrieves essential product data.\nUse this endpoint for faster queries when full details are not needed.", "summary": "Get list basic product information", "tags": [ "Product" ], "security": [], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductListRequest" } } } } } }, "/scrapers/api/apotea/product/search": { "get": { "operationId": "Search Product", "responses": { "200": { "description": "Successfully retrieved search results", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiSuccessResponse" }, "examples": { "Example 1": { "value": { "statusCode": 200, "messageCode": "OK", "data": [ { "id": "242708", "name": "A-Derma Cutalgan Ultra-Calming Refreshing Spray 100 ml", "image": "https://media.apotea.se/product-images/MS/a-derma-cutalgan-spray-100-ml-0.jpg", "url": "https://www.apotea.se/a-derma-cutalgan-ultra-calming-refreshing-spray-100-ml", "price": "149 kr", "currency": "SEK", "sku": "343371", "from_url": "https://www.apotea.se/ansiktsvatten?sort=name%20asc" } ] } } } } } }, "400": { "description": "Bad Request - Invalid search parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponse" }, "examples": { "Example 1": { "value": { "statusCode": 500, "messageCode": "INTERNAL_SERVER_ERROR", "message": "Failed to run robot" } } } } } } }, "description": "Search for products\n\nSearch products in the Apotea database using keyword and optional filters.\nSupports pagination for large result sets.", "summary": "Search productes with filters", "tags": [ "Product" ], "security": [], "parameters": [ { "description": "Search keyword\n\nThe search keyword to find products (e.g., \"vitamin\", \"skincare\", \"shampoo\").", "in": "query", "name": "keyword", "required": false, "schema": { "type": "string" }, "example": "vitamin" }, { "description": "The sort_by parameter: Sort items by various criteria:\n\n- \"rank asc\" - Popularity (most popular first)\n- \"created desc\" - News (newest first)\n- \"name asc\" - Name A-Z\n- \"name desc\" - Name Z-A\n- \"price asc\" - Lowest Price\n- \"price desc\" - Highest Price\n- \"comp_price asc\" - Lowest Compare Price\n- \"comp_price desc\" - Highest Compare Price", "in": "query", "name": "sort_by", "required": false, "schema": { "type": "string" }, "example": "rank asc" }, { "description": "Page number for pagination (starts from 1)", "in": "query", "name": "page", "required": false, "schema": { "format": "int32", "type": "integer", "minimum": 1 }, "example": 1 } ] } } }, "servers": [ { "url": "/undefined" } ] }