# GuatemalaDigital Scraper (`aboo.script/guatemaladigital-scraper`) Actor

⚡ Fast GuatemalaDigital scraper. No login, no API key. Get Guatemala products by keyword, category, clearance or product URL: GTQ prices, discounts, stock, delivery dates, installments, variants, ASINs and images. Perfect for price monitoring and market research.

- **URL**: https://apify.com/aboo.script/guatemaladigital-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## GuatemalaDigital Scraper

![GuatemalaDigital Scraper](https://i.ibb.co/20hbxF6G/guatemaladigital-banner.png)

**GuatemalaDigital Scraper** extracts product listings from [GuatemalaDigital](https://guatemaladigital.com/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a GuatemalaDigital category or search URL, or type a few keywords, and get the title, price in quetzales, normal price and discount, stock, delivery date, installments, variants, and images for every product. No account or login required.

### Introduction

[GuatemalaDigital](https://guatemaladigital.com/) is one of the largest online stores in Guatemala, selling electronics, home goods, fashion, toys and much more, including millions of imported products with local delivery and prices in quetzales (GTQ). Its catalog is a valuable source for price research on the Guatemalan and Central American market.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from GuatemalaDigital?

- 🏷️ Product title (Spanish and English when available), product ID and Amazon ASIN
- 💲 Price, normal price, discount percentage and currency (GTQ)
- 📦 Stock status, quantity available, delivery text and estimated delivery date
- 💳 Monthly installment amounts from 1 to 18 months
- 🎨 Color and product variants (size, color, other options) with their links
- 🗂️ Category name, category ID and category URL
- 📝 Product features and manufacturer description as plain text
- 🖼️ Main image, all images and product video link
- 🛒 Frequently bought together and related products with prices
- 🔥 Pre-order, deal of the day and service flags

### Use Cases

- 📈 **Market research**: track prices and discounts across categories in Guatemala.
- 🕵️ **Competitor monitoring**: compare your prices with GuatemalaDigital for the same products or ASINs.
- 🚚 **Import and logistics analysis**: see which products are in stock locally and how long imported items take to arrive.
- 🗂️ **Database building**: create your own searchable catalog of Guatemalan e-commerce products.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape GuatemalaDigital step by step

1. Paste one or more GuatemalaDigital URLs into **Start URLs**, or type keywords into **Search queries**.
2. Set **Maximum number of results** to how many products you want per URL or per query.
3. Click **Start** and wait for the run to finish.
4. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: GuatemalaDigital URLs to scrape. Supported pages: main category pages (for example `https://guatemaladigital.com/Audifonos/Categoria/PG/7`), subcategory pages (`.../Categoria/12396`), search pages (`https://guatemaladigital.com/Busqueda/laptop`), the clearance page (`https://guatemaladigital.com/Liquidacion`) and single product pages (`https://guatemaladigital.com/Producto/5092748`).
- **Search queries**: keywords to search on GuatemalaDigital, one per line, in Spanish or English. Each query is scraped separately.
- **Maximum number of results**: how many products to collect for each start URL or search query. Set 0 for no limit.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape a category from GuatemalaDigital:

```json
{
  "startUrls": [{ "url": "https://guatemaladigital.com/Audifonos/Categoria/PG/7" }],
  "maxResults": 5
}
```

Search by keywords:

```json
{
  "searchQueries": ["laptop"],
  "maxResults": 5
}
```

### Output

Each product is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://guatemaladigital.com/Producto/B0C3HCD34R",
  "id": "23719453",
  "asin": "B0C3HCD34R",
  "title": "soundcore by Anker Q20i Hybrid Active Noise Cancelling Headphones, Black",
  "titleEnglish": "soundcore by Anker Q20i Hybrid Active Noise Cancelling Headphones, Wireless Over-Ear Bluetooth, 40H Long ANC Playtime, Hi-Res Audio, Big Bass, Customize via an App, Transparency Mode, Ideal for Travel (Color: BLACK)",
  "category": "Audífonos - Supraaurales (Over-Ear)",
  "categoryId": "4797",
  "categoryUrl": "https://guatemaladigital.com/Categoria/4797",
  "price": 459,
  "originalPrice": null,
  "discountPercent": null,
  "currency": "GTQ",
  "inStock": false,
  "stockQuantity": 0,
  "deliveryText": "Entrega: 11/06/2026",
  "estimatedDeliveryDate": "2026-11-06",
  "isPreOrder": false,
  "isDailyDeal": false,
  "isService": false,
  "color": "Black",
  "description": "Cancelación activa de ruido híbrida: 2 micrófonos internos y 2 externos funcionan en conjunto para detectar el ruido externo y reducirlo de manera efectiva hast...",
  "manufacturerDescription": "Gildan Unisex-adult Fleece Hoodie Sweatshirt, Style G18500, Multipack...",
  "image": "https://m.media-amazon.com/images/I/71XBzSvq-NL._AC_SL1500_._SX600_.jpg",
  "images": [
    "https://m.media-amazon.com/images/I/71XBzSvq-NL._AC_SL1500_._SX600_.jpg",
    "https://m.media-amazon.com/images/I/71+0sYGRReL._AC_SL1500_._SX600_.jpg"
  ],
  "videoUrl": null,
  "installments": [
    { "months": 1, "monthlyAmount": 482 },
    { "months": 2, "monthlyAmount": 244 },
    { "months": 3, "monthlyAmount": 164 }
  ],
  "variants": [
    {
      "type": "size",
      "name": "Standard",
      "asin": "B0HJQTBNHV",
      "url": "https://guatemaladigital.com/Producto/B0HJQTBNHV"
    },
    {
      "type": "size",
      "name": "Standard Headphones Only",
      "asin": "B0C3HCD34R",
      "url": "https://guatemaladigital.com/Producto/B0C3HCD34R"
    }
  ],
  "frequentlyBoughtTogether": [
    {
      "id": "28355584",
      "url": "https://guatemaladigital.com/Producto/28355584",
      "title": "Case for Soundcore/JBL/Sony/JLab/BERIBES/KVIDIO Headphones Black",
      "price": 159,
      "image": "https://m.media-amazon.com/images/I/71ZF7j2vYYL._AC_SL1500_._AA320_.jpg",
      "deliveryText": "Entrega: 10/30/2026"
    }
  ],
  "relatedProducts": [
    {
      "id": "14289301",
      "url": "https://guatemaladigital.com/Producto/14289301",
      "title": "Nakano Bluetooth Headphones,The Quintessential Quintuplets Headphone with Build-in Mic,Foldable Over Ear Wireless Headphones,Hi-Fi Stereo for Cosplay (Blue)",
      "price": 329,
      "image": "https://m.media-amazon.com/images/I/61XR15bvz2L._AC_SL1423_._AA320_.jpg",
      "deliveryText": "Entrega inmediata"
    }
  ]
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Supported pages are categories, subcategories, search, clearance and product pages. Other URLs (help pages, cart, account pages) are skipped with a warning.
- Search results include the products GuatemalaDigital can order for you on demand, mixed with local stock, just like on the website.
- `inStock` is true only for products available for immediate delivery. Imported products show an estimated delivery date instead.
- Prices are in Guatemalan quetzales (GTQ). `originalPrice` and `discountPercent` are filled only when the website shows a normal price above the current price.
- GuatemalaDigital does not show brands, ratings, reviews or seller names, so they are not part of the output.
- Texts keep the website language (mostly Spanish, some product titles in English).
- The website has no price or sort filters on category and search pages, so results follow the website order.

### Why use the GuatemalaDigital Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- ⚡ **Fast and light**: no proxy needed for normal runs.
- 🧹 **Clean data**: prices are real numbers, dates use one standard format, and text is free of HTML.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of products.

#### Do I need a GuatemalaDigital account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh prices automatically.

#### Why are some fields empty?

Some products simply do not show every piece of information, such as a video or a normal price. When a field is not available on the website, it is returned as `null`.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs and search queries. If you need other inputs, such as clearance price ranges, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [GuatemalaDigital](https://guatemaladigital.com/)

# Actor input Schema

## `startUrls` (type: `array`):

GuatemalaDigital category (e.g. https://guatemaladigital.com/Audifonos/Categoria/PG/7), subcategory (.../Categoria/12396), search (/Busqueda/laptop), clearance (/Liquidacion) or product (/Producto/5092748) URLs.

## `searchQueries` (type: `array`):

Keywords to search on GuatemalaDigital (Spanish or English). Each query is scraped separately.

## `maxResults` (type: `integer`):

Maximum number of products to scrape per start URL or search query. Set 0 for no limit.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://guatemaladigital.com/Audifonos/Categoria/PG/7"
    }
  ],
  "searchQueries": [
    "laptop"
  ],
  "maxResults": 5
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://guatemaladigital.com/Audifonos/Categoria/PG/7"
        }
    ],
    "searchQueries": [
        "laptop"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/guatemaladigital-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://guatemaladigital.com/Audifonos/Categoria/PG/7" }],
    "searchQueries": ["laptop"],
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/guatemaladigital-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://guatemaladigital.com/Audifonos/Categoria/PG/7"
    }
  ],
  "searchQueries": [
    "laptop"
  ]
}' |
apify call aboo.script/guatemaladigital-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/guatemaladigital-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/zVIFDcmPbCJoBWFJd/builds/gM0S3pG1xLvQ14DH6/openapi.json
