{
  "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": "ZtDSgmv2Y5hhxveU4"
  },
  "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 (for the searches below)",
            "enum": [
              "com.ar",
              "com.co",
              "com.pe",
              "com.sv",
              "com.gt",
              "com.ni",
              "com.pa",
              "com.ec",
              "cl"
            ],
            "type": "string",
            "description": "Which Paginas Amarillas country site your searches run on. Pasted directory links ignore this and use their own country. Example: Colombia.",
            "default": "com.ar"
          },
          "searches": {
            "title": "Searches: category or category/city",
            "type": "array",
            "description": "One search per line, as \"category\" or \"category/city\". Example: empresas-constructoras or restaurantes/bogota. Each search returns phone (plus E.164), email, address, GPS and social links. Use this, the directory links below, or both.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Directory links (optional)",
            "type": "array",
            "description": "Paste links instead of typing searches. A search page gives the country, category and city; a business page (/empresas/... or /fichas/...) returns that one business. Example: https://www.paginasamarillas.com.co/b/restaurantes/bogota. Links from different countries can be mixed in one run.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerSearch": {
            "title": "Max businesses per search",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Businesses to deliver for each search or link. 15 equals the first page of the directory; raise it to go deeper (up to 1,000,000). Example: 100. Filters count only matching businesses.",
            "default": 15
          },
          "maxItems": {
            "title": "Max rows in total (0 = no limit)",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on all rows delivered in the run, businesses plus detail rows. 0 means no limit (your max charge per run still applies). Example: 50. Free plan runs are limited to 10 rows.",
            "default": 0
          },
          "onlyWithEmail": {
            "title": "Only businesses with an email",
            "type": "boolean",
            "description": "Keep only businesses that publish an email address. Best for cold-email lists.",
            "default": false
          },
          "onlyWithPhone": {
            "title": "Only businesses with a phone",
            "type": "boolean",
            "description": "Keep only businesses that publish at least one phone number.",
            "default": false
          },
          "onlyWithWebsite": {
            "title": "Only businesses with a website",
            "type": "boolean",
            "description": "Keep only businesses that publish a website.",
            "default": false
          },
          "onlyWithWhatsapp": {
            "title": "Only businesses with WhatsApp",
            "type": "boolean",
            "description": "Keep only businesses that publish a WhatsApp contact. Good for WhatsApp outreach.",
            "default": false
          },
          "premiumOnly": {
            "title": "Only paid (premium) listings",
            "type": "boolean",
            "description": "Keep only paid listings, which usually have a logo, description, images and more contact channels. Free listings are skipped.",
            "default": false
          },
          "includeDetails": {
            "title": "Add opening hours, services, keywords and rating",
            "type": "boolean",
            "description": "Opens each business page and adds a separate detail row with opening hours, services, keywords and rating. Billed per detail row (only when the page publishes at least one of them), so cost grows with the number of businesses. Off by default.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}