{
  "openapi": "3.0.1",
  "info": {
    "title": "Pincali Scraper",
    "description": "[💰 $1.0 / 1K] Extract Mexican real estate listings from Pincali — homes, land, and commercial for sale, rent, pre-construction, and foreclosure. Get price, beds, baths, area, amenities, description, GPS, agent contact, and photos.",
    "version": "1.0",
    "x-build-id": "KC4uRFflWTGWABt0g"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~pincali-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-pincali-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/solidcode~pincali-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-pincali-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/solidcode~pincali-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-pincali-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": {
          "startUrls": {
            "title": "Pincali URLs",
            "type": "array",
            "description": "Paste one or more Pincali URLs — either search-result pages (e.g. https://www.pincali.com/inmuebles/casas-en-venta-en-merida-yucatan) or individual property pages (e.g. https://www.pincali.com/inmueble/casa-...). The scraper reads every filter straight from each search URL, so the Search Filters below are ignored for these. Use this when you already built a search on the site.",
            "items": {
              "type": "string"
            }
          },
          "operation": {
            "title": "Operation",
            "enum": [
              "venta",
              "renta",
              "desarrollo",
              "remate"
            ],
            "type": "string",
            "description": "Whether to find properties for sale, for rent, in pre-construction (development), or in foreclosure. Only applies when you build a search below (not when pasting URLs)."
          },
          "propertyTypes": {
            "title": "Property Types",
            "uniqueItems": true,
            "type": "array",
            "description": "Which kinds of property to include. Leave empty to include all types.",
            "items": {
              "type": "string",
              "enum": [
                "casa",
                "casa-en-condominio",
                "departamento",
                "villa",
                "quinta",
                "rancho",
                "terreno",
                "oficina",
                "local-comercial",
                "local-en-centro-comercial",
                "edificio",
                "bodega-comercial",
                "terreno-comercial",
                "bodega-industrial",
                "nave-industrial",
                "terreno-industrial"
              ],
              "enumTitles": [
                "House (Casa)",
                "Condo house (Casa en condominio)",
                "Apartment (Departamento)",
                "Villa",
                "Country house (Quinta)",
                "Ranch (Rancho)",
                "Land / lot (Terreno)",
                "Office (Oficina)",
                "Retail / shop (Local comercial)",
                "Mall unit (Local en centro comercial)",
                "Building (Edificio)",
                "Commercial warehouse (Bodega comercial)",
                "Commercial land (Terreno comercial)",
                "Industrial warehouse (Bodega industrial)",
                "Industrial plant (Nave industrial)",
                "Industrial land (Terreno industrial)"
              ]
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Where to search. Enter a Mexican city or municipality — for example 'Merida Yucatan', 'Monterrey Nuevo Leon', 'Guadalajara Jalisco', or a Mexico City borough like 'Miguel Hidalgo Ciudad de Mexico'. Include the state for best results. Each location is searched separately. Leave empty to search all of Mexico, or when you are pasting URLs above.",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum Price (MXN)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings at or above this price, in Mexican pesos. Leave empty for no minimum."
          },
          "maxPrice": {
            "title": "Maximum Price (MXN)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings at or below this price, in Mexican pesos. Leave empty for no maximum."
          },
          "minBedrooms": {
            "title": "Minimum Bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with at least this many bedrooms. Leave empty for any."
          },
          "minBathrooms": {
            "title": "Minimum Bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with at least this many bathrooms. Leave empty for any."
          },
          "minArea": {
            "title": "Minimum Construction Area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with at least this much construction area, in square meters. Leave empty for no minimum."
          },
          "maxArea": {
            "title": "Maximum Construction Area (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with at most this much construction area, in square meters. Leave empty for no maximum."
          },
          "sort": {
            "title": "Sort Order",
            "enum": [
              "newest",
              "oldest",
              "price_desc",
              "price_asc"
            ],
            "type": "string",
            "description": "Order in which to collect listings. Only applies when you build a search below (not when pasting URLs). Newest and Oldest are applied reliably. Price ordering is requested from Pincali but the site may return results in its default order depending on your filters — for a guaranteed price-bounded set, use the Minimum/Maximum Price filters above."
          },
          "scrapeDetails": {
            "title": "Scrape Full Details",
            "type": "boolean",
            "description": "Follow each listing to its property page to collect full data: complete description, the whole photo gallery, all amenities and features, map coordinates, and the agent and agency names. Turn off for a faster, lighter run that returns only the summary fields shown in search results.",
            "default": true
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings to collect across all URLs and searches. Set to 0 for as many as possible (up to a built-in safety cap of 10,000). Tip: start with 10-50 to test, then increase.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}