{ "openapi": "3.0.1", "info": { "title": "La Centrale Market Analytics: Used-Car Prices", "description": "Used-car market data from La Centrale (lacentrale.fr): live inventory counts by make, model, fuel and region, plus price, mileage and year statistics (min, max, average, median, quartiles) for any make or model in France. No login. JSON, CSV or Excel.", "version": "1.0", "x-build-id": "Ma5hoUfdVabthaHpt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~lacentrale-market-analytics/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-lacentrale-market-analytics", "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/axlymxp~lacentrale-market-analytics/runs": { "post": { "operationId": "runs-sync-axlymxp-lacentrale-market-analytics", "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/axlymxp~lacentrale-market-analytics/run-sync": { "post": { "operationId": "run-sync-axlymxp-lacentrale-market-analytics", "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": { "analysisType": { "title": "Analysis type", "enum": [ "inventory", "priceStats" ], "type": "string", "description": "inventory = facet counts (make/model, energy, …); priceStats = price & mileage stats for a make/model.", "default": "inventory" }, "families": { "title": "Vehicle families", "enum": [ "AUTO,UTILITY", "AUTO", "UTILITY", "MOTO" ], "type": "string", "description": "Which vehicle families to include in the analysis.", "default": "AUTO,UTILITY" }, "make": { "title": "Make (brand)", "type": "string", "description": "Brand in capitals, e.g. PEUGEOT. Optional for inventory (scopes the counts), required for priceStats." }, "model": { "title": "Model", "type": "string", "description": "Model in capitals, e.g. 208. Needs a make." }, "aggregations": { "title": "Facets (inventory mode)", "type": "string", "description": "Comma-separated facets for inventory mode: MAKE_MODEL, ENERGY, REGION, GEARBOX, GOOD_DEAL_BADGE, EXTERNAL_COLOR, CUSTOMER_FAMILY_CODE.", "default": "MAKE_MODEL,ENERGY,GEARBOX,GOOD_DEAL_BADGE" }, "energies": { "title": "Energy filter (priceStats)", "enum": [ "", "ESSENCE", "DIESEL", "ELECTRIC", "HYBRID", "HYBRID_ESSENCE_ELECTRIC", "PLUGIN_HYBRID_ESSENCE_ELECTRIC", "HYBRID_DIESEL_ELECTRIC", "HYDROGEN" ], "type": "string", "description": "Optional fuel filter for priceStats mode.", "default": "" }, "sampleSize": { "title": "Sample size (priceStats)", "minimum": 10, "maximum": 1000, "type": "integer", "description": "How many live listings to sample for the statistics (10 to 1000). The sample follows La Centrale's default relevance order, so a larger sample gives a fuller picture.", "default": 200 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The actor works without a proxy. If La Centrale blocks the server IP it retries through Apify Residential proxy (France) automatically, billed to your account as proxy usage.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }