{ "openapi": "3.0.1", "info": { "title": "L'Argus Occasion Scraper", "description": "Scrape used cars from occasion.largus.fr with structured filters (make, model, region, price, fuel). Returns price, mileage, year, location, and listing URL.", "version": "0.1", "x-build-id": "MN2n52FbEgI94Grrw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dadhalfdev~largus-occasion-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dadhalfdev-largus-occasion-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/dadhalfdev~largus-occasion-scraper/runs": { "post": { "operationId": "runs-sync-dadhalfdev-largus-occasion-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/dadhalfdev~largus-occasion-scraper/run-sync": { "post": { "operationId": "run-sync-dadhalfdev-largus-occasion-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", "required": [ "max_cars" ], "properties": { "input_url": { "title": "Input URL", "type": "string", "description": "Paste an L'Argus Occasion search URL to use instead of the filters below — overrides all structured filters when set. Leave empty to use the filters below (better for AI agents)." }, "make": { "title": "Make", "enum": [ "", "ABARTH", "AC", "AIWAYS", "AIXAM", "ALFA ROMEO", "ALPINA", "ALPINE", "AMC", "APRILIA", "ASTON MARTIN", "AUDI", "AUSTIN", "AUSTIN HEALEY", "AUTOBIANCHI", "AUTRE", "BELLIER", "BENELLI", "BENTLEY", "BERTONE", "BLUECAR", "BMW", "BUGATTI", "BUICK", "BYD", "CADILLAC", "CAN-AM", "CASALINI", "CATERHAM", "CCM", "CF MOTO", "CHATENET", "CHEVROLET", "CHRYSLER", "CITROEN", "CUPRA", "DACIA", "DAEWOO", "DAF", "DAIHATSU", "DAIMLER", "DANGEL", "DATSUN", "DE TOMASO", "DODGE", "DS", "DUCATI", "E-TON", "EC CITY", "ELARIS", "ENERGICA", "EXCALIBUR", "FACEL VEGA", "FANTIC", "FERRARI", "FIAT", "FISKER", "FORD", "FOTON", "GAS GAS", "GEELY", "GENERAL MOTORS", "GENESIS", "GILERA", "GOES", "HARLEY-DAVIDSON", "HONDA", "HOTCHKISS", "HUMMER", "HUSQVARNA", "HYTRACK", "HYUNDAI", "IMF", "INDIAN", "INEOS", "INFINITI", "INNOCENTI", "ISUZU", "IVECO", "JAECOO", "JAGUAR", "JDM SIMPA", "JEEP", "JENSEN", "KAWASAKI", "KEEWAY", "KIA", "KTM", "KYMCO", "LADA", "LAMBORGHINI", "LANCIA", "LAND-ROVER", "LAVERDA", "LEAPMOTOR", "LEVC", "LEXUS", "LIGIER", "LINCOLN", "LOTUS", "LYNK&CO", "MAHINDRA", "MAN", "MARCOS", "MASERATI", "MATRA", "MAXUS", "MAZDA", "MCLAREN", "MEGA", "MERCEDES-BENZ", "MERCURY", "MG/MG MOTOR", "MICROCAR", "MINI", "MITSUBISHI", "MOBILIZE", "MORGAN", "MORRIS", "MV-AGUSTA", "NISSAN", "OLDSMOBILE", "OMODA", "OPEL", "ORCAL", "PANHARD", "PANTHER", "PEUGEOT", "PGO", "PIAGGIO", "PLYMOUTH", "POLARIS", "POLESTAR", "PONTIAC", "PORSCHE", "QUADRO", "REDE", "RENAULT", "RENAULT-TRUCKS", "ROLLS-ROYCE", "ROVER", "ROYAL ENFIELD", "SAAB", "SANTANA", "SEA DOO BOMBARDIER", "SEAT", "SEGWAY", "SERES", "SHERCO", "SILENCE", "SIMCA", "SIMPLICI", "SKODA", "SKYWORTH", "SMART", "SSANGYONG", "SUBARU", "SUNBEAM", "SUZUKI", "SYM", "TALBOT", "TESLA", "TOYOTA", "TRIUMPH", "TVR", "VENTURI", "VESPA", "VICTORY", "VOLKSWAGEN", "VOLVO", "XEV", "XPENG", "YAMAHA", "ZEEKR", "ZONTES" ], "type": "string", "description": "Car make, sourced live from L'Argus's own make facet (occasion.largus.fr/auto/, 174 brands). Leave empty (Any) to search all brands. Ignored when input_url is set.", "default": "" }, "model": { "title": "Model", "type": "string", "description": "Optional model (e.g. Clio, 208, Golf). Requires make. Ignored when input_url is set." }, "region": { "title": "Region", "enum": [ "", "Auvergne-Rhône-Alpes", "Bourgogne-Franche-Comté", "Bretagne", "Centre-Val de Loire", "Corse", "Grand Est", "Guadeloupe", "Guyane", "Hauts-de-France", "Île-de-France", "La Réunion", "Martinique", "Normandie", "Nouvelle-Aquitaine", "Occitanie", "Pays de la Loire", "Provence-Alpes-Côte d'Azur" ], "type": "string", "description": "French region filter. Empty = nationwide. Ignored when input_url is set.", "default": "" }, "department": { "title": "Department", "type": "string", "description": "Optional department name (e.g. Seine-Maritime, Hauts-de-Seine). Used with region. Ignored when input_url is set." }, "city": { "title": "City", "type": "string", "description": "Optional city name (e.g. Paris, Yerville). Used with region + department. Ignored when input_url is set." }, "state": { "title": "Condition (État)", "enum": [ "", "occasion" ], "type": "string", "description": "Vehicle condition. Site currently exposes Occasion only. Ignored when input_url is set.", "default": "" }, "price_min": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum price in euros. Ignored when input_url is set." }, "price_max": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum price in euros. Ignored when input_url is set." }, "mileage_min": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage in km. Ignored when input_url is set." }, "mileage_max": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage in km. Ignored when input_url is set." }, "energy": { "title": "Fuel / energy", "enum": [ "", "essence", "diesel", "hybride-essence", "electrique", "gpl", "gnv", "hydrogene" ], "type": "string", "description": "Fuel type filter. Ignored when input_url is set.", "default": "" }, "gearbox": { "title": "Gearbox", "enum": [ "", "automatic", "manual" ], "type": "string", "description": "Transmission filter. Ignored when input_url is set.", "default": "" }, "category": { "title": "Body category", "enum": [ "", "4x4-suv-crossover-pick-up", "berline", "break", "cabriolet", "citadine", "coupe", "monospace-mpv", "vehicule-societe-commercial", "autre" ], "type": "string", "description": "Vehicle body category. Ignored when input_url is set.", "default": "" }, "colour": { "title": "Colour", "enum": [ "", "grey", "white", "black", "blue", "red", "green", "silver", "beige", "orange", "brown", "yellow", "purple", "gold", "pink" ], "type": "string", "description": "Exterior colour filter. Ignored when input_url is set.", "default": "" }, "doors": { "title": "Doors", "enum": [ "", "2", "3", "4", "5", "6" ], "type": "string", "description": "Number of doors. Ignored when input_url is set.", "default": "" }, "seats": { "title": "Seats", "enum": [ "", "1", "2", "3", "4", "5", "6", "7" ], "type": "string", "description": "Number of seats. Ignored when input_url is set.", "default": "" }, "crit_air": { "title": "Crit'Air", "enum": [ "", "critair_0", "critair_1", "critair_2", "critair_3", "critair_4", "critair_5", "non_class" ], "type": "string", "description": "French Crit'Air sticker class. Ignored when input_url is set.", "default": "" }, "published_since": { "title": "Published since", "enum": [ "", "24h", "7d", "30d" ], "type": "string", "description": "Only ads published within this window. Ignored when input_url is set.", "default": "" }, "sort_by": { "title": "Sort by", "enum": [ "Most Recent", "Lowest Price", "Highest Price", "Lowest KM", "Highest KM", "Newest Year", "Oldest Year" ], "type": "string", "description": "How to order the results.", "default": "Most Recent" }, "max_cars": { "title": "Max cars", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum listings to return (1–2000).", "default": 50 }, "enrich_details": { "title": "Enrich with detail page", "type": "boolean", "description": "If true, open each ad page for extra specs (power, doors, colour, description, first registration).", "default": false }, "listing_urls": { "title": "Listing URLs (optional)", "type": "array", "description": "Optional direct ad URLs. If set without make/filters, only these URLs are scraped.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }