{
"openapi": "3.0.1",
"info": {
"title": "PAP Scraper 🇫🇷 Particuliers + Téléphone du Propriétaire",
"description": "Annonces de particuliers PAP.fr, sans agences, avec le téléphone du propriétaire et l'adresse complète en option. Prix, surface, pièces, €/m², DPE et photos pour chaque annonce, dès 1$/1000 annonces. Idéal pour la pige immobilière, la prospection et les agents IA (API + MCP).",
"version": "0.1",
"x-build-id": "pZnv3xYz8Avytgeon"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~french-real-estate-pap/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-french-real-estate-pap",
"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/tagadanar~french-real-estate-pap/runs": {
"post": {
"operationId": "runs-sync-tagadanar-french-real-estate-pap",
"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/tagadanar~french-real-estate-pap/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-french-real-estate-pap",
"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",
"required": [
"searchUrls"
],
"properties": {
"searchUrls": {
"title": "PAP search URLs",
"minItems": 1,
"type": "array",
"description": "One or more pap.fr search-result URLs. Build the search you want on pap.fr (city, sale/rental, property type, price/surface filters), then copy the page URL from your browser and paste it here — do not hand-edit the -g##### code at the end, because PAP routes on that code and ignores the city words before it, so an edited URL silently returns zero listings. All result pages are followed automatically. Example: https://www.pap.fr/annonce/vente-appartements-aix-en-provence-13-g11424",
"items": {
"type": "string"
}
},
"minPrice": {
"title": "Minimum price (€)",
"minimum": 0,
"type": "integer",
"description": "Keep only listings at or above this price."
},
"maxPrice": {
"title": "Maximum price (€)",
"minimum": 0,
"type": "integer",
"description": "Keep only listings at or below this price."
},
"minSurface": {
"title": "Minimum surface (m²)",
"minimum": 0,
"type": "integer",
"description": "Keep only listings with at least this built surface."
},
"minRooms": {
"title": "Minimum rooms",
"minimum": 0,
"type": "integer",
"description": "Keep only listings with at least this many rooms (pièces)."
},
"propertyTypes": {
"title": "Property types",
"type": "array",
"description": "Keep only these property types. Empty = all types found in the search.",
"items": {
"type": "string",
"enum": [
"Appartement",
"Maison",
"Terrain",
"Immeuble",
"Local commercial",
"Parking / Box"
],
"enumTitles": [
"Apartment",
"House",
"Land",
"Building",
"Commercial",
"Parking / Box"
]
},
"default": []
},
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Keep only listings whose description or location contains at least one of these words (e.g. terrasse, jardin, ascenseur).",
"default": [],
"items": {
"type": "string"
}
},
"scrapeDetails": {
"title": "Scrape owner phone & full address (detail pages)",
"type": "boolean",
"description": "Open each listing's page to also extract the owner's phone number, the full street address and the complete description. Slower and fetches one page per listing, but gives you direct owner contact for lead generation. Off = fast, list-only.",
"default": false
},
"maxResults": {
"title": "Max listings",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Stop after this many listings across all search URLs.",
"default": 500
}
}
},
"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
}
}
}
}
}
}
}
}
}
}