{
  "openapi": "3.0.1",
  "info": {
    "title": "Paginas Amarillas Scraper - LATAM Business Directory Leads",
    "description": "Scrape Paginas Amarillas business leads by category and city in Argentina, Colombia, Peru and 4 more countries. Get name, phones, email, address with GPS, website and social links. Export CSV, Excel, JSON. No login or API key. 10 leads cost $0.18 on the free tier.",
    "version": "0.1",
    "x-build-id": "gFzHpXf3q3V97HHxI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/recordsdata~paginasamarillas-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-recordsdata-paginasamarillas-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/recordsdata~paginasamarillas-scraper/runs": {
      "post": {
        "operationId": "runs-sync-recordsdata-paginasamarillas-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/recordsdata~paginasamarillas-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-recordsdata-paginasamarillas-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",
        "properties": {
          "country": {
            "title": "Country",
            "enum": [
              "com.ar",
              "com.co",
              "com.pe",
              "com.sv",
              "com.gt",
              "com.ni",
              "com.pa",
              "com.ec",
              "cl"
            ],
            "type": "string",
            "description": "Paginas Amarillas country site used for the searches below: Argentina (com.ar), Colombia (com.co), Peru (com.pe), El Salvador (com.sv), Guatemala (com.gt), Nicaragua (com.ni), Panama (com.pa), Ecuador (com.ec) or Chile (cl). Start URLs carry their own country, so one run can mix countries. Default is Argentina.",
            "default": "com.ar"
          },
          "searches": {
            "title": "Category / city searches",
            "type": "array",
            "description": "List of business searches, each as \"category\" or \"category/city\", for example \"empresas-constructoras\" or \"restaurantes/bogota\". Each search returns up to 'Max results per search' businesses with phone (plus E.164), email, address, GPS and social links. Use this or Start URLs (or both).",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Directory URLs (optional)",
            "type": "array",
            "description": "Paste directory URLs instead of typing searches. A search page such as https://www.paginasamarillas.com.co/b/restaurantes/bogota gives the country, category and city. A business page (/empresas/... or /fichas/...) returns that one business. Works on all nine country sites, so one run can mix countries.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerSearch": {
            "title": "Max results per search",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "How many businesses to deliver for each search or search URL. The default of 15 matches the first page of the directory; raise it to go as deep as the directory goes (some categories have tens of thousands of listings). Filters count only the businesses that match them.",
            "default": 15
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of rows to deliver in total (business records plus detail records). 0 means no limit; Apify max charge per run still applies. Free plan runs are limited to 10 rows.",
            "default": 0
          },
          "onlyWithEmail": {
            "title": "Only businesses with an email",
            "type": "boolean",
            "description": "Deliver (and charge for) only businesses that publish an email address. Listings without one are skipped while the search keeps going.",
            "default": false
          },
          "onlyWithPhone": {
            "title": "Only businesses with a phone",
            "type": "boolean",
            "description": "Deliver (and charge for) only businesses that publish at least one phone number.",
            "default": false
          },
          "onlyWithWebsite": {
            "title": "Only businesses with a website",
            "type": "boolean",
            "description": "Deliver (and charge for) only businesses that publish a website.",
            "default": false
          },
          "onlyWithWhatsapp": {
            "title": "Only businesses with WhatsApp",
            "type": "boolean",
            "description": "Deliver (and charge for) only businesses that publish a WhatsApp contact.",
            "default": false
          },
          "premiumOnly": {
            "title": "Only paid listings",
            "type": "boolean",
            "description": "Deliver only businesses with a paid (premium) listing, which usually carry a logo, description, images and more contact channels. Free listings are skipped.",
            "default": false
          },
          "includeDetails": {
            "title": "Include business details",
            "type": "boolean",
            "description": "When true, also opens each business page and adds a detail-record with opening hours, services, keywords and rating (a separate detail-record charge, only for businesses whose page publishes at least one of them). Default false.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}