{ "openapi": "3.0.1", "info": { "title": "Argenprop Scraper - Real Estate Listings in Argentina", "description": "Scrape argenprop.com, Argentina's real estate portal: sale, rent and vacation listings with prices in pesos and dollars, address, rooms, areas, expenses, photos and agency, plus new developments with their units, agencies and a sitemap index. Export JSON, CSV, Excel, XML.", "version": "0.1", "x-build-id": "aEyVB8KcYVvhI3SYf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/recordsdata~argenprop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-recordsdata-argenprop-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~argenprop-scraper/runs": { "post": { "operationId": "runs-sync-recordsdata-argenprop-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~argenprop-scraper/run-sync": { "post": { "operationId": "run-sync-recordsdata-argenprop-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": { "operation": { "title": "Operation", "enum": [ "sale", "rent", "vacation" ], "type": "string", "description": "Whether to look for properties for sale, for rent (long term) or for temporary rent (vacation).", "default": "sale" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "One or more property types. Argenprop publishes at most two types per search page, so more than two types are read as several searches.", "items": { "type": "string", "enum": [ "apartment", "house", "ph", "land", "retail", "farm", "parking", "business", "warehouse", "hotel", "special-business", "office", "country-house" ], "enumTitles": [ "Apartment", "House", "PH (house-type apartment)", "Land", "Shop / commercial premises", "Farm / field", "Parking space", "Business for sale", "Warehouse", "Hotel", "Special business", "Office", "Country house (quinta)" ] }, "default": [ "apartment" ] }, "locations": { "title": "Locations", "type": "array", "description": "Neighborhoods, cities or provinces as they appear on argenprop.com, for example palermo, belgrano, capital-federal, rosario, mar-del-plata or san-isidro. Accents and spaces are fine (\"Nuñez\" becomes nunez). Leave empty to search the whole country.", "default": [ "palermo" ], "items": { "type": "string" } }, "currency": { "title": "Price currency", "enum": [ "USD", "ARS" ], "type": "string", "description": "Currency of Min price and Max price. Listings are priced in US dollars or Argentine pesos.", "default": "USD" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Lowest price in the chosen currency. Leave empty or 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Highest price in the chosen currency. Leave empty or 0 for no maximum.", "default": 0 }, "bedrooms": { "title": "Bedrooms", "enum": [ "any", "1", "2", "3", "4", "5+" ], "type": "string", "description": "Exact number of bedrooms (5+ means five or more).", "default": "any" }, "rooms": { "title": "Rooms (ambientes)", "enum": [ "any", "1", "2", "3", "4", "5+" ], "type": "string", "description": "Number of rooms the Argentine way: 1 is a studio (monoambiente), 2 is two rooms, and so on.", "default": "any" }, "bathrooms": { "title": "Bathrooms", "enum": [ "any", "1", "2", "3", "4", "5" ], "type": "string", "description": "Minimum number of bathrooms.", "default": "any" }, "garages": { "title": "Parking spaces", "enum": [ "any", "0", "1", "2", "3", "4" ], "type": "string", "description": "Minimum number of parking spaces (0 means no parking). This filter reads each listing page, which is billed as a listing detail.", "default": "any" }, "minArea": { "title": "Min covered area (m²)", "minimum": 0, "type": "integer", "description": "Smallest covered area in square meters. Leave empty or 0 for no minimum.", "default": 0 }, "maxArea": { "title": "Max covered area (m²)", "minimum": 0, "type": "integer", "description": "Largest covered area in square meters. Leave empty or 0 for no maximum.", "default": 0 }, "antiquity": { "title": "Age of the building", "enum": [ "any", "new", "5", "10", "20", "30", "over30" ], "type": "string", "description": "Maximum age of the property.", "default": "any" }, "sellerType": { "title": "Seller type", "enum": [ "any", "agency", "owner" ], "type": "string", "description": "Only agency listings or only listings published directly by the owner. Owner contact data is never collected.", "default": "any" }, "disposition": { "title": "Orientation in the building", "enum": [ "any", "front", "back", "interior", "side" ], "type": "string", "description": "Whether the unit faces the street (front), the back, the inner courtyard or the side. This filter reads each listing page, which is billed as a listing detail.", "default": "any" }, "amenities": { "title": "Amenities", "type": "array", "description": "Keep only listings that have all the selected amenities. This filter reads each listing page, which is billed as a listing detail.", "items": { "type": "string", "enum": [ "elevator", "pool", "grill", "solarium", "gym", "pet-friendly", "mortgage", "furnished", "professional", "accepts-swap", "accessible", "air-conditioning", "jacuzzi", "safe" ], "enumTitles": [ "Elevator", "Swimming pool", "Grill (parrilla)", "Solarium", "Gym", "Pets allowed", "Mortgage eligible", "Furnished", "Suitable for professional use", "Accepts swap", "Accessible (reduced mobility)", "Air conditioning", "Jacuzzi", "Safe" ] }, "default": [] }, "sort": { "title": "Order", "enum": [ "relevance", "price-asc" ], "type": "string", "description": "Relevance is the site's default ranking. Price ascending lists the cheapest first and makes searches with more than 60 results reachable by slicing on price.", "default": "relevance" }, "fetchDetails": { "title": "Open each listing page", "type": "boolean", "description": "Adds coordinates, full description, amenities, room types, orientation, view, building data, expenses, reference code, video and the exact neighborhood tree. Billed as one listing-detail event per listing.", "default": false }, "fetchAllPhotos": { "title": "Collect all photos", "type": "boolean", "description": "Returns every photo of the listing in full size instead of the first eight shown in search results. Billed as one listing-photos event per listing that returns more photos.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "argenprop.com links: a search page (https://www.argenprop.com/departamentos/venta/palermo), a listing page, an agency page, an agency search (https://www.argenprop.com/inmobiliarias?Nombre=lopez), a new development (https://www.argenprop.com/emprendimientos/...) or a sitemap file. Search pages return up to 60 listings (three pages); links with extra filters in the address return the first page.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingIds": { "title": "Listing ids", "type": "array", "description": "Numeric listing ids (the number at the end of a listing URL, for example 18799423) or full listing URLs. Each one returns the complete listing, billed as a listing plus a listing detail.", "default": [], "items": { "type": "string" } }, "agencies": { "title": "Agencies", "type": "array", "description": "Real estate agencies by name or by address slug (for example \"lopez castromil\" or \"lopez-castromil-propiedades\"). Each agency returns one agency record with address, opening hours and number of active listings.", "default": [], "items": { "type": "string" } }, "includeAgencyListings": { "title": "Also return each agency's listings", "type": "boolean", "description": "For every agency found, also return its listings for the chosen Operation (up to 60 per agency). Agency pages are not rate limited, so this is the fastest way to get many listings.", "default": false }, "includeProjectUnits": { "title": "Also return units of new developments", "type": "boolean", "description": "For new developments (emprendimientos) given as links or read from the sitemap, also return one record per available unit with price, area and orientation. Billed as one project-unit event per unit.", "default": false }, "sitemapSection": { "title": "Read a sitemap section", "enum": [ "none", "ficha-venta-caba", "ficha-venta-gba-norte", "ficha-venta-gba-oeste", "ficha-venta-gba-sur", "ficha-alquiler-caba", "ficha-alquiler-gba-norte", "ficha-alquiler-gba-oeste", "ficha-alquiler-gba-sur", "ficha-cordoba", "ficha-santa-fe", "ficha-cuyo", "ficha-costa-atlantica", "ficha-resto-baires", "ficha-otros-argentina", "ficha-uruguay", "ficha-otros-exterior", "inmobiliarias", "emprendimientos" ], "type": "string", "description": "Bulk channel that is not rate limited. The listing sections return one lightweight index record per listing (id, link, type, operation, last update) with no page reads; turn on Open each listing page to get full records. 'Agencies' returns every registered agency and 'New developments' every development.", "default": "none" }, "sitemapUrlContains": { "title": "Sitemap: URL contains", "type": "string", "description": "Keep only sitemap entries whose address contains this text, for example palermo or 3-ambientes. Leave empty for all.", "default": "" }, "sitemapUpdatedAfter": { "title": "Sitemap: updated after", "type": "string", "description": "Keep only sitemap entries updated on or after this date (YYYY-MM-DD). Leave empty for all.", "default": "" }, "onlyNew": { "title": "Only new or changed records", "type": "boolean", "description": "Skip records an earlier run of this exact search already delivered (a price change counts as new). Max Items then limits how many records are scanned per run.", "default": false }, "stateKey": { "title": "Monitor name", "type": "string", "description": "Optional label to keep several monitors of the same search apart.", "default": "" }, "resetSeen": { "title": "Reset monitor memory", "type": "boolean", "description": "Forget everything this search delivered before and start the monitor again from this run.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of records to return (listings, agencies, developments and units all count). Free plans are limited to 10.", "default": 20 }, "maxScanSeconds": { "title": "Max scan seconds", "minimum": 20, "maximum": 7200, "type": "integer", "description": "Time budget of the run. Argenprop rate limits listing and search pages per connection, so long runs pause and resume; when the budget is reached the run stops and keeps what it found. Agency pages, photos and sitemaps are not affected.", "default": 900 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Used only as a fallback: the actor connects directly and switches to fresh Apify datacenter addresses when argenprop.com rate limits the direct connection.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }