{
"openapi": "3.0.1",
"info": {
"title": "PAP Scraper — Owner Listings + Phone Numbers (Particulier)",
"description": "French owner-direct listings from PAP.fr — no agencies — with the OWNER'S PHONE NUMBER & full address (opt-in detail scraping). Price, surface, rooms, €/m², DPE, photos per ad. $1/1,000 listings, near-zero start fee. For pige immobilière, lead sourcing, market analysis & AI agents (API + MCP).",
"version": "0.1",
"x-build-id": "Ka0tUYw0X4F7LBej4"
},
"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",
"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 and paste it here. All result pages are followed automatically. Example: https://www.pap.fr/annonce/vente-appartements-bordeaux-33000-g43898",
"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
},
"maxPagesPerUrl": {
"title": "Max pages per search URL",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Safety cap on pagination depth per search URL (PAP shows ~30 listings per page).",
"default": 20
}
}
},
"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
}
}
}
}
}
}
}
}
}
}