{
"openapi": "3.0.1",
"info": {
"title": "PAP.fr Scraper 🇫🇷 Téléphone Propriétaire · Particulier FSBO",
"description": "Annonces PAP.fr de particulier à particulier, sans agence : téléphone du propriétaire et adresse en option. Prix, surface, €/m², photos. Pige immo, prospection, agents IA (API + MCP). Scrape owner-direct FSBO listings from PAP.fr: private-seller phone, address, price, surface. No agencies, no fees.",
"version": "0.1",
"x-build-id": "eBr7gxaqC80W6ghkR"
},
"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,
"maxItems": 20,
"type": "array",
"description": "One or more pap.fr search-result URLs (up to 20 per run — that is as many as one run can walk to depth). 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",
"maxItems": 50,
"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": 4000,
"type": "integer",
"description": "Stop after this many listings across all search URLs. The ceiling is what one run can actually deliver inside its time limit — asking for more than the run has time for now ends the run cleanly with a status message instead of being cut off.",
"default": 500
},
"maxPagesPerUrl": {
"title": "Max result pages per search URL",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How deep to follow each search URL's pagination. PAP shows about 40 ads per page, so 20 pages is roughly 800 ads per URL — and past its last real page PAP repeats content, which the actor detects and stops on anyway.",
"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
}
}
}
}
}
}
}
}
}
}