{ "openapi": "3.0.1", "info": { "title": "Thegioididong Scraper - Products, Prices, Specs & Reviews", "description": "Scrape thegioididong.com products with full specifications, current & original price, discount, brand, category, variants, image gallery, description, customer rating and reviews. Search by keyword with brand, price, rating and sort filters, or paste product / category / search URLs.", "version": "1.0", "x-build-id": "AIuY5GMFN0vtODluO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~thegioididong-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-thegioididong-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/abotapi~thegioididong-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-thegioididong-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/abotapi~thegioididong-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-thegioididong-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose 'search' to use keywords, or 'url' to scrape specific product, category or search URLs you paste below.", "default": "search" }, "queries": { "title": "Search keywords", "type": "array", "description": "One or more keywords to search, for example 'iphone 15', 'laptop gaming' or 'tai nghe bluetooth'. Each keyword is searched separately. If you leave this empty or omit it, the keyword 'iphone 15' is searched. To browse a whole category instead, switch to URL mode and paste its link (for example https://www.thegioididong.com/dtdd).", "default": [ "iphone 15" ], "items": { "type": "string" } }, "specialsOnly": { "title": "Flash sale deals only", "type": "boolean", "description": "Browse the site's permanent Flash Sale hub instead of a keyword search. Every returned product carries a genuine original/'was' price, discount amount and percentage. Ignores 'Search keywords' when on. To browse a seasonal brand promo page instead (for example a specific brand's clearance page), switch to URL mode and paste its link.", "default": false }, "urls": { "title": "Thế Giới Di Động URLs", "type": "array", "description": "Product, category, search or promo-page URLs to scrape, for example https://www.thegioididong.com/dtdd/iphone-15, https://www.thegioididong.com/dtdd, https://www.thegioididong.com/flashsale (the Flash Sale deals hub) or a brand promo page like https://www.thegioididong.com/khuyen-mai-aukey. Multiple URLs supported.", "default": [ "https://www.thegioididong.com/dtdd", "https://www.thegioididong.com/dtdd/iphone-15", "https://www.thegioididong.com/tim-kiem?key=iphone%2015", "https://www.thegioididong.com/tim-kiem?key=tai%20nghe", "https://www.thegioididong.com/flashsale", "https://www.thegioididong.com/khuyen-mai-aukey", "https://www.thegioididong.com/dtdd?page=2", "https://www.thegioididong.com/laptop?g=laptop-gaming", "https://www.thegioididong.com/dtdd-apple-iphone", "https://thegioididong.com/dtdd", "https://www.thegioididong.com/dtdd-apple-iphone-15-series" ], "items": { "type": "string" } }, "brand": { "title": "Brand", "type": "string", "description": "Optional. Keep only products whose brand contains this text, for example 'Apple', 'Samsung' or 'Xiaomi'." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "ratingDesc", "reviewsDesc", "nameAsc" ], "type": "string", "description": "Ordering applied to whatever set of results was collected, whether from a keyword search or a pasted URL. This only reorders the results — it does not filter or change which items are included.", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Optional. Only keep products priced at or above this amount (VND)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Optional. Only keep products priced at or below this amount (VND)." }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Only keep products with an average customer rating at or above this value (1 to 5). Needs product details enabled." }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Add full specifications, variants, image gallery, brand, category, description and aggregate rating for each product. Adds one request per product.", "default": true }, "fetchReviews": { "title": "Fetch customer reviews", "type": "boolean", "description": "Also collect the customer reviews of each product (review text, author, date, star rating); entries without a star rating are skipped. The first 10 come with the product page and further ones are read 10 at a time, up to Max reviews per product, so large caps take extra requests per product.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Cap on reviews collected per product when 'Fetch customer reviews' is on. 0 or empty uses the default of 20, and values above 100 are treated as 100 (so 0 does not mean all reviews). Every started block of 10 delivered reviews adds one detail-enrichment unit.", "default": 20 }, "maxItems": { "title": "Max products", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of products to return across the whole run. Use 0 for no limit (the input accepts up to 100000).", "default": 20 }, "maxPages": { "title": "Max listing pages", "minimum": 0, "type": "integer", "description": "Safety cap on category / search listing pages fetched per query (each page holds about 20 products). 0 means the built-in limit of 20 pages per query. The run also stops at Max products or when a listing is exhausted.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy with residential access in Vietnam is required for reliable results and correct local pricing and stock. The run rotates fresh exits automatically. On the free plan, coverage may be limited and some runs may return no results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "VN" } }, "resumeFromRunId": { "title": "Resume from a previous run (delta)", "type": "string", "description": "Optional. ID of a previous run of this actor (or a dataset ID). Products already in that dataset are skipped, so this run returns only NEW products (a delta). Combine both runs' datasets for the full set. Max products then counts only the new products. For recurring daily or weekly monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental mode (recurring monitoring)", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. The first run returns all matching products as NEW. Later runs compare every product against the last run (price, original price and discount, promo gift and installment offer, variants with their price and stock, specifications, brand, category and description) and return only NEW, UPDATED and REAPPEARED products, with an UPDATED row's changedFields naming exactly what moved. The average rating, rating count, rating breakdown, reviews, image URLs, the search mode tag, the card badge label, the search keyword (searchQuery) and the category id (categoryId, which can depend on the page a product was found on) are never compared, since they change on their own with no real product change. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those products returned (and billed). State is kept separately for each search, URL and filter setup; use State key to name or deliberately share a monitoring campaign.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to derive a key automatically from the search, URL and filter settings; different setups then never mix state." }, "emitUnchanged": { "title": "Emit unchanged products (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return products that have not changed since the last run, marked UNCHANGED. This returns and bills extra rows you already have, so leave it off unless you want the full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired products (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return products that were present in a previous run but are no longer found, marked EXPIRED. Only produced after a complete scan of the tracked search or URLs: never when Max products or Max listing pages capped it, when a filter (brand, price, rating) narrowed it, when a pasted URL starts past page 1, for a single product URL, or when any request failed. This returns and bills extra rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Optional. Field names to exclude from UPDATED change detection, in addition to the built-in handling (rating, rating count, rating breakdown, reviews, image URLs, search mode, card label, search keyword and category id already never trigger a false UPDATED). Use this if another top-level field in your setup turns out to be noisy. The field stays in the output.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write/digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }