{ "openapi": "3.0.1", "info": { "title": "AA Cars UK Used Car Scraper", "description": "UK used car scraper for AA Cars (theaa.com/used-cars). Paste any search, make, model, town or dealer URL to get every car for sale with prices, mileage, specs, photos, vehicle history checks, finance prices and dealer contacts.", "version": "0.1", "x-build-id": "fPTwDHVCTqm1eb0Pq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vivid-softwares~aa-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vivid-softwares-aa-cars-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/vivid-softwares~aa-cars-scraper/runs": { "post": { "operationId": "runs-sync-vivid-softwares-aa-cars-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/vivid-softwares~aa-cars-scraper/run-sync": { "post": { "operationId": "run-sync-vivid-softwares-aa-cars-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", "properties": { "startUrls": { "title": "AA Cars URLs", "type": "array", "description": "The easiest way to use this Actor: search on theaa.com/used-cars, then paste the address here. Works with search results, make and model pages (theaa.com/used-cars/ford/fiesta), body type, fuel, gearbox and town pages, dealer pages, dealer lists by county or brand, and single car pages. Every matching car is scraped, not only the cars shown on the first page. Leave empty to use the search builder below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "makes": { "title": "Makes", "type": "array", "description": "Optional search builder, used instead of or as well as URLs. Each make is searched separately. Leave empty for all makes (when you set other filters).", "items": { "type": "string", "enum": [ "156", "101", "171", "102", "103", "104", "105", "177", "149", "165", "180", "106", "107", "108", "166", "161", "110", "151", "162", "111", "112", "113", "175", "159", "173", "114", "152", "115", "172", "155", "116", "158", "178", "117", "118", "176", "119", "120", "121", "157", "174", "122", "150", "168", "123", "167", "124", "160", "125", "126", "127", "128", "154", "129", "179", "130", "131", "170", "132", "134", "135", "136", "137", "138", "139", "140", "141", "142", "143", "163", "144", "169", "145", "146", "147", "148" ], "enumTitles": [ "Abarth", "Alfa Romeo", "Alpine", "Aston Martin", "Audi", "Bentley", "BMW", "BYD", "Cadillac", "Caterham", "Chery", "Chevrolet", "Chrysler", "Citroen", "Cupra", "Dacia", "Daihatsu", "Dodge", "DS", "Ferrari", "Fiat", "Ford", "Genesis", "Great Wall", "GWM", "Honda", "Hummer", "Hyundai", "INEOS", "Infiniti", "Isuzu", "Iveco", "Jaecoo", "Jaguar", "Jeep", "KGM", "Kia", "Lamborghini", "Land Rover", "LDV", "LEVC", "Lexus", "Lotus", "MAN", "Maserati", "Maxus", "Mazda", "McLaren", "Mercedes", "MG", "MINI", "Mitsubishi", "Morgan", "Nissan", "Omoda", "Perodua", "Peugeot", "Polestar", "Porsche", "Renault", "Rolls-Royce", "Rover", "Saab", "SEAT", "Skoda", "Smart", "Ssangyong", "Subaru", "Suzuki", "Tesla", "Toyota", "Triumph", "TVR", "Vauxhall", "Volkswagen", "Volvo" ] } }, "models": { "title": "Models", "type": "array", "description": "Each model is searched separately (you do not need to pick its make as well).", "items": { "type": "string", "enum": [ "156-104", "156-101", "156-107", "156-103", "156-106", "156-105", "101-104", "101-105", "101-107", "101-116", "101-101", "101-117", "101-115", "101-110", "101-120", "101-114", "101-112", "101-118", "101-119", "171-101", "171-102", "171-103", "102-111", "102-113", "102-101", "102-103", "102-109", "102-112", "102-110", "102-108", "102-105", "102-104", "102-106", "102-107", "103-101", "103-126", "103-103", "103-104", "103-139", "103-106", "103-140", "103-141", "103-142", "103-120", "103-143", "103-144", "103-111", "103-145", "103-146", "103-127", "103-115", "103-118", "103-136", "103-147", "103-130", "103-128", "103-137", "103-148", "103-124", "103-138", "103-117", "103-134", "103-149", "103-121", "103-150", "103-151", "103-133", "103-110", "103-152", "103-135", "103-114", "103-131", "103-129", "103-105", "103-107", "103-153", "103-154", "103-122", "103-155", "103-113", "103-156", "103-132", "103-116", "103-157", "103-158", "103-159", "103-160", "103-119", "103-161", "103-162", "104-101", "104-109", "104-103", "104-104", "104-106", "104-107", "104-108", "105-175", "105-176", "105-177", "105-178", "105-179", "105-180", "105-181", "105-182", "105-146", "105-163", "105-171", "105-172", "105-173", "105-158", "105-166", "105-159", "105-155", "105-132", "105-156", "105-133", "105-134", "105-174", "105-148", "105-164", "105-135", "105-157", "105-136", "105-145", "105-165", "105-137", "105-138", "177-105", "177-101", "177-102", "177-107", "177-103", "177-108", "177-106", "177-109", "177-104", "149-103", "165-101", "180-101", "180-102", "180-103", "106-111", "106-102", "106-110", "106-104", "106-113", "106-105", "106-106", "106-107", "106-115", "106-114", "106-109", "106-116", "107-101", "107-102", "107-109", "107-104", "107-106", "107-103", "107-110", "108-134", "108-101", "108-102", "108-119", "108-127", "108-103", "108-104", "108-105", "108-133", "108-122", "108-107", "108-132", "108-121", "108-135", "108-131", "108-108", "108-129", "108-130", "108-123", "108-125", "108-126", "108-136", "108-138", "108-137", "108-140", "108-139", "108-141", "108-124", "108-113", "108-128", "108-116", "108-118", "166-103", "166-104", "166-101", "166-102", "166-106", "166-105", "161-106", "161-102", "161-104", "161-103", "161-101", "161-107", "161-105", "110-101", "110-113", "110-109", "110-111", "151-108", "151-107", "151-106", "162-101", "162-102", "162-103", "162-106", "162-104", "162-107", "162-108", "162-109", "162-110", "111-131", "111-107", "111-109", "111-110", "111-118", "111-123", "111-114", "111-127", "111-117", "111-122", "111-126", "111-101", "111-125", "111-132", "111-129", "111-130", "111-104", "112-127", "112-121", "112-129", "112-130", "112-131", "112-128", "112-132", "112-101", "112-103", "112-109", "112-133", "112-113", "112-114", "112-122", "112-115", "112-116", "112-118", "112-119", "113-127", "113-103", "113-101", "113-128", "113-129", "113-105", "113-106", "113-109", "113-110", "113-111", "113-112", "113-113", "113-126", "113-115", "113-116", "113-134", "113-118", "113-135", "113-133", "113-120", "113-131", "113-124", "175-103", "175-104", "175-101", "175-102", "114-101", "114-102", "114-104", "114-119", "114-105", "114-124", "114-122", "114-106", "114-125", "114-120", "114-107", "114-108", "114-109", "114-110", "114-111", "114-113", "114-114", "114-115", "114-116", "114-121", "114-103", "114-123", "152-101", "115-101", "115-102", "115-103", "115-127", "115-104", "115-129", "115-106", "115-107", "115-117", "115-119", "115-116", "115-121", "115-118", "115-128", "115-125", "115-130", "115-131", "115-124", "115-120", "115-126", "115-109", "115-110", "115-112", "115-114", "115-123", "172-101", "155-101", "155-102", "155-105", "155-106", "155-104", "155-110", "155-109", "155-107", "178-102", "178-101", "117-112", "117-101", "117-111", "117-108", "117-113", "117-103", "117-104", "117-109", "117-107", "117-105", "117-114", "117-106", "117-115", "118-108", "118-101", "118-106", "118-102", "118-105", "118-107", "118-104", "176-102", "176-103", "176-104", "119-101", "119-111", "119-124", "119-120", "119-121", "119-122", "119-118", "119-119", "119-123", "119-115", "119-114", "119-105", "119-125", "119-106", "119-107", "119-109", "119-112", "119-110", "119-117", "119-116", "119-113", "119-127", "120-104", "120-105", "120-106", "121-101", "121-112", "121-113", "121-111", "121-109", "121-102", "121-108", "121-103", "121-105", "121-104", "121-107", "121-106", "121-110", "122-107", "122-112", "122-103", "122-101", "122-115", "122-113", "122-110", "122-104", "122-108", "122-109", "122-102", "122-116", "122-114", "122-105", "122-111", "150-104", "150-101", "150-105", "150-103", "150-102", "123-102", "123-108", "123-107", "123-103", "123-106", "123-110", "123-109", "123-105", "124-103", "124-104", "124-105", "124-106", "124-108", "124-119", "124-123", "124-118", "124-120", "124-121", "124-109", "124-122", "124-111", "124-125", "124-115", "160-101", "160-107", "160-105", "160-108", "160-104", "160-111", "160-110", "160-109", "125-101", "125-129", "125-128", "125-102", "125-103", "125-114", "125-123", "125-125", "125-139", "125-112", "125-113", "125-104", "125-131", "125-132", "125-133", "125-140", "125-141", "125-134", "125-120", "125-105", "125-124", "125-135", "125-136", "125-126", "125-137", "125-106", "125-107", "125-109", "125-115", "125-130", "125-111", "125-122", "125-108", "125-117", "125-119", "126-113", "126-108", "126-109", "126-114", "126-115", "126-116", "126-117", "126-118", "126-107", "126-112", "126-119", "126-110", "126-106", "126-111", "126-101", "126-102", "126-104", "127-117", "127-107", "127-111", "127-102", "127-105", "127-103", "127-112", "127-109", "127-118", "127-119", "127-108", "127-113", "127-101", "127-114", "127-110", "128-120", "128-103", "128-124", "128-110", "128-122", "128-112", "128-113", "128-115", "128-117", "129-127", "129-136", "129-104", "129-144", "129-105", "129-130", "129-138", "129-139", "129-141", "129-110", "129-112", "129-114", "129-116", "129-115", "129-133", "129-119", "129-120", "129-128", "129-121", "129-122", "129-125", "179-101", "179-104", "179-103", "179-102", "130-103", "131-103", "131-101", "131-102", "131-128", "131-127", "131-104", "131-105", "131-107", "131-126", "131-122", "131-109", "131-110", "131-119", "131-133", "131-120", "131-112", "131-131", "131-123", "131-125", "131-134", "131-135", "131-136", "131-137", "131-139", "131-140", "131-141", "131-124", "131-130", "131-129", "170-101", "170-102", "170-103", "132-112", "132-105", "132-106", "132-109", "132-110", "132-101", "132-103", "132-102", "132-111", "132-107", "132-113", "134-125", "134-121", "134-122", "134-118", "134-102", "134-111", "134-120", "134-115", "134-108", "134-126", "134-109", "134-124", "134-110", "134-127", "134-123", "134-114", "134-116", "134-119", "135-103", "135-115", "135-114", "135-111", "135-104", "135-105", "135-107", "135-112", "135-108", "135-109", "135-116", "135-113", "136-102", "136-106", "136-112", "137-103", "137-104", "138-101", "138-102", "138-113", "138-112", "138-110", "138-105", "138-107", "138-111", "138-114", "138-109", "139-107", "139-114", "139-113", "139-101", "139-112", "139-110", "139-109", "139-103", "139-116", "139-108", "139-105", "139-111", "139-104", "139-106", "140-108", "140-109", "140-110", "140-101", "140-105", "140-104", "140-107", "141-101", "141-103", "141-104", "141-107", "141-106", "142-112", "142-101", "142-102", "142-104", "142-105", "142-110", "142-106", "142-111", "142-107", "142-108", "143-118", "143-101", "143-102", "143-116", "143-120", "143-105", "143-106", "143-114", "143-107", "143-119", "143-113", "143-117", "143-109", "143-112", "143-122", "143-110", "163-103", "163-101", "163-102", "163-104", "144-140", "144-146", "144-103", "144-104", "144-106", "144-152", "144-145", "144-141", "144-107", "144-109", "144-110", "144-111", "144-112", "144-151", "144-148", "144-149", "144-138", "144-144", "144-133", "144-118", "144-120", "144-147", "144-121", "144-122", "144-123", "144-125", "144-129", "144-136", "144-142", "144-135", "144-150", "144-143", "144-131", "144-153", "144-132", "169-101", "145-102", "146-130", "146-101", "146-129", "146-124", "146-102", "146-136", "146-137", "146-103", "146-131", "146-107", "146-140", "146-134", "146-141", "146-108", "146-142", "146-135", "146-143", "146-144", "146-127", "146-109", "146-128", "146-145", "146-146", "146-115", "146-118", "146-119", "146-133", "146-123", "146-149", "147-130", "147-101", "147-129", "147-143", "147-144", "147-109", "147-110", "147-105", "147-106", "147-108", "147-140", "147-117", "147-107", "147-137", "147-133", "147-134", "147-136", "147-138", "147-111", "147-113", "147-114", "147-116", "147-125", "147-118", "147-132", "147-131", "147-135", "147-139", "147-123", "147-145", "147-119", "147-120", "147-128", "148-105", "148-116", "148-122", "148-106", "148-126", "148-127", "148-123", "148-125", "148-124", "148-107", "148-108", "148-110", "148-120", "148-111", "148-129", "148-112", "148-118", "148-130", "148-113", "148-119", "148-131", "148-121", "148-117", "148-114", "148-115" ], "enumTitles": [ "Abarth 124 Spider", "Abarth 500", "Abarth 500e", "Abarth 595", "Abarth 600e", "Abarth 695", "Alfa Romeo 147", "Alfa Romeo 156", "Alfa Romeo 159", "Alfa Romeo 4C", "Alfa Romeo Brera", "Alfa Romeo Giulia", "Alfa Romeo Giulietta", "Alfa Romeo GT", "Alfa Romeo Junior", "Alfa Romeo Mito", "Alfa Romeo Spider", "Alfa Romeo Stelvio", "Alfa Romeo Tonale", "Alpine A110", "Alpine A290", "Alpine A390", "Aston Martin DB11", "Aston Martin DB12", "Aston Martin DB7", "Aston Martin DB9", "Aston Martin DBS", "Aston Martin DBX", "Aston Martin Rapide", "Aston Martin V8", "Aston Martin Vanquish", "Aston Martin Vantage", "Aston Martin Virage", "Aston Martin Volante", "Audi 80", "Audi A1", "Audi A2", "Audi A3", "Audi A3 Cabriolet", "Audi A4", "Audi A4 Allroad", "Audi A4 Avant", "Audi A4 Cabriolet", "Audi A5", "Audi A5 Avant", "Audi A5 Cabriolet", "Audi A6", "Audi A6 Allroad", "Audi A6 Avant", "Audi A7", "Audi A8", "Audi Allroad", "Audi E-Tron", "Audi e-tron GT", "Audi Q2", "Audi Q3", "Audi Q4", "Audi Q4 e-tron", "Audi Q5", "Audi Q6 e-tron", "Audi Q7", "Audi Q8", "Audi Q8 e-tron", "Audi R8", "Audi RS Q3", "Audi RS Q8", "Audi RS3", "Audi RS4", "Audi RS4 Avant", "Audi RS5", "Audi RS6", "Audi RS7", "Audi S1", "Audi S3", "Audi S4", "Audi S4 Avant", "Audi S4 Cabriolet", "Audi S5", "Audi S5 Avant", "Audi S6", "Audi S6 Avant", "Audi S7", "Audi S8", "Audi SQ2", "Audi SQ5", "Audi SQ7", "Audi SQ8", "Audi TT", "Audi TT RS", "Audi TTS", "Bentley Arnage", "Bentley Bentayga", "Bentley Brooklands", "Bentley Continental", "Bentley Flying Spur", "Bentley Mulsanne", "Bentley Turbo", "BMW 1 Series", "BMW 2 Series", "BMW 3 Series", "BMW 4 Series", "BMW 5 Series", "BMW 6 Series", "BMW 7 Series", "BMW 8 Series", "BMW Alpina", "BMW i3", "BMW i4", "BMW i5", "BMW i7", "BMW i8", "BMW iX", "BMW M2", "BMW M235", "BMW M3", "BMW M4", "BMW M5", "BMW M6", "BMW M8", "BMW X1", "BMW X2", "BMW X3", "BMW X4", "BMW X5", "BMW X6", "BMW X7", "BMW Z3", "BMW Z4", "BYD Atto 2", "BYD Atto 3", "BYD Dolphin", "BYD Dolphin Surf", "BYD Seal", "BYD Seal 6", "BYD Seal U", "BYD Sealion 5", "BYD Sealion 7", "Cadillac Escalade", "Caterham Seven", "Chery Tiggo 7", "Chery Tiggo 8", "Chery Tiggo 9", "Chevrolet Aveo", "Chevrolet Camaro", "Chevrolet Captiva", "Chevrolet Corvette", "Chevrolet Cruze", "Chevrolet Kalos", "Chevrolet Lacetti", "Chevrolet Matiz", "Chevrolet Orlando", "Chevrolet Spark", "Chevrolet SSR", "Chevrolet Trax", "Chrysler 300c", "Chrysler Crossfire", "Chrysler Delta", "Chrysler Grand Voyager", "Chrysler PT Cruiser", "Chrysler Voyager", "Chrysler Ypsilon", "Citroen Ami", "Citroen Ax", "Citroen Berlingo", "Citroen C-Crosser", "Citroen C-Zero", "Citroen C1", "Citroen C2", "Citroen C3", "Citroen C3 Aircross", "Citroen C3 Picasso", "Citroen C4", "Citroen C4 Cactus", "Citroen C4 Picasso", "Citroen C4 SpaceTourer", "Citroen C4 X", "Citroen C5", "Citroen C5 Aircross", "Citroen C5 X", "Citroen DS3", "Citroen DS4", "Citroen DS5", "Citroen e-Berlingo", "Citroen e-C3", "Citroen e-C3 Aircross", "Citroen e-C4", "Citroen e-C4 X", "Citroen e-C5 Aircross", "Citroen Grand C4 Picasso", "Citroen Saxo", "Citroen SpaceTourer", "Citroen Xsara Picasso", "Citroen Zx", "Cupra Ateca", "Cupra Born", "Cupra Formentor", "Cupra Leon", "Cupra Tavascan", "Cupra Terramar", "Dacia Bigster", "Dacia Duster", "Dacia Jogger", "Dacia Logan MCV", "Dacia Sandero", "Dacia Sandero Stepway", "Dacia Spring", "Daihatsu Charade", "Daihatsu Materia", "Daihatsu Sirion", "Daihatsu Terios", "Dodge Challenger", "Dodge Journey", "Dodge Nitro", "DS 3", "DS 3 Cabrio", "DS 4", "DS 4 Crossback", "DS 5", "DS 7", "DS 9", "DS No4", "DS No8", "Ferrari 296", "Ferrari 360", "Ferrari 430", "Ferrari 456", "Ferrari 458", "Ferrari 488", "Ferrari 612", "Ferrari 812 SUPERFAST", "Ferrari California", "Ferrari FF", "Ferrari GTC4 LUSSO", "Ferrari Mondial", "Ferrari Portofino", "Ferrari Purosangue", "Ferrari Roma", "Ferrari SF90", "Ferrari Testarossa", "Fiat 124", "Fiat 500", "Fiat 500e", "Fiat 500L", "Fiat 500X", "Fiat 600", "Fiat 600e", "Fiat Barchetta", "Fiat Bravo", "Fiat Grande", "Fiat Grande Panda", "Fiat Panda", "Fiat Punto", "Fiat Qubo", "Fiat Scudo", "Fiat Sedici", "Fiat Stilo", "Fiat Tipo", "Ford B Max", "Ford C Max", "Ford Capri", "Ford EcoSport", "Ford Edge", "Ford Escort", "Ford Explorer", "Ford Fiesta", "Ford Focus", "Ford Fusion", "Ford Galaxy", "Ford Ka", "Ford Kuga", "Ford Mondeo", "Ford Mustang", "Ford Mustang Mach-E", "Ford Puma", "Ford Puma Gen-E", "Ford Puma ST", "Ford S-Max", "Ford Sierra", "Ford Tourneo", "Genesis G70", "Genesis G80", "Genesis GV60", "Genesis GV70", "Honda Accord", "Honda Civic", "Honda CR-V", "Honda CR-Z", "Honda CRX", "Honda eNy1", "Honda Fit", "Honda FR-V", "Honda Freed", "Honda Honda E", "Honda HR-V", "Honda Insight", "Honda Integra", "Honda Jazz", "Honda Legend", "Honda NSX", "Honda Odyssey", "Honda Prelude", "Honda S2000", "Honda Stepwagon", "Honda Type R", "Honda ZR-V", "Hummer H2", "Hyundai Accent", "Hyundai Amica", "Hyundai Atoz", "Hyundai Bayon", "Hyundai Coupe", "Hyundai Genesis", "Hyundai Getz", "Hyundai H100", "Hyundai I10", "Hyundai I20", "Hyundai I30", "Hyundai I40", "Hyundai I800", "Hyundai Inster", "Hyundai IONIQ", "Hyundai Ioniq 5", "Hyundai Ioniq 6", "Hyundai IX20", "Hyundai IX35", "Hyundai KONA", "Hyundai Matrix", "Hyundai Santa Fe", "Hyundai Terracan", "Hyundai Tucson", "Hyundai Veloster", "INEOS Grenadier", "Infiniti EX", "Infiniti FX", "Infiniti M", "Infiniti Q30", "Infiniti Q50", "Infiniti Q60", "Infiniti QX30", "Infiniti QX70", "Jaecoo 5", "Jaecoo 7", "Jaguar E-PACE", "Jaguar E-Type", "Jaguar F-Pace", "Jaguar F-Type", "Jaguar I-PACE", "Jaguar S-Type", "Jaguar X-Type", "Jaguar XE", "Jaguar XF", "Jaguar XJ", "Jaguar XJS", "Jaguar XK", "Jaguar XKR", "Jeep Avenger", "Jeep Cherokee", "Jeep Compass", "Jeep Grand Cherokee", "Jeep Patriot", "Jeep Renegade", "Jeep Wrangler", "KGM Korando", "KGM Rexton", "KGM Torres", "Kia Carens", "Kia Ceed", "Kia EV2", "Kia EV3", "Kia EV4", "Kia EV5", "Kia EV6", "Kia EV9", "Kia K4", "Kia Niro", "Kia Optima", "Kia Picanto", "Kia ProCeed", "Kia Rio", "Kia Sedona", "Kia Sorento", "Kia Soul", "Kia Sportage", "Kia Stinger", "Kia Stonic", "Kia Venga", "Kia XCeed", "Lamborghini Aventador", "Lamborghini Huracan", "Lamborghini Urus", "Land Rover Defender", "Land Rover Defender 110", "Land Rover Defender 130", "Land Rover Defender 90", "Land Rover Defender Octa", "Land Rover Discovery", "Land Rover Discovery Sport", "Land Rover Freelander", "Land Rover Freelander 2", "Land Rover Range Rover", "Land Rover Range Rover Evoque", "Land Rover Range Rover Sport", "Land Rover Range Rover Velar", "Lexus CT", "Lexus ES", "Lexus GS", "Lexus IS", "Lexus IS F", "Lexus LBX", "Lexus LC", "Lexus LS", "Lexus NX", "Lexus RC", "Lexus RX", "Lexus RX-L", "Lexus RZ", "Lexus SC", "Lexus UX", "Lotus Eletre", "Lotus Elise", "Lotus Emira", "Lotus Evora", "Lotus Exige", "Maserati 4200", "Maserati Ghibli", "Maserati GranCabrio", "Maserati Gransport", "Maserati GranTurismo", "Maserati Grecale", "Maserati Levante", "Maserati Quattroporte", "Mazda 2", "Mazda 3", "Mazda 5", "Mazda 6", "Mazda Bongo", "Mazda CX3", "Mazda CX30", "Mazda CX5", "Mazda CX60", "Mazda CX80", "Mazda Demio", "Mazda MX30", "Mazda MX5", "Mazda MX5 RF", "Mazda RX8", "McLaren 12C", "McLaren 540C", "McLaren 570", "McLaren 600LT", "McLaren 720S", "McLaren 750s", "McLaren Artura", "McLaren GT", "Mercedes A Class", "Mercedes A45 AMG", "Mercedes AMG GT", "Mercedes B Class", "Mercedes C Class", "Mercedes CL", "Mercedes CLA", "Mercedes CLC", "Mercedes CLE", "Mercedes CLK", "Mercedes CLS", "Mercedes E Class", "Mercedes EQA", "Mercedes EQB", "Mercedes EQC", "Mercedes EQE", "Mercedes EQS", "Mercedes EQV", "Mercedes G Class", "Mercedes GL Class", "Mercedes GLA", "Mercedes GLB", "Mercedes GLC", "Mercedes GLE", "Mercedes GLS", "Mercedes M Class", "Mercedes R Class", "Mercedes S Class", "Mercedes SL", "Mercedes SLC", "Mercedes SLK", "Mercedes SLS", "Mercedes V Class", "Mercedes Vaneo", "Mercedes Viano", "MG Cyberster", "MG GS", "MG HS", "MG IM5", "MG IM6", "MG MG S5", "MG MG S6", "MG MG S9", "MG MG3", "MG MG4", "MG MG4 Urban", "MG MG5", "MG MG6", "MG MGB", "MG MGF", "MG TF", "MG ZS", "MINI Aceman", "MINI Clubman", "MINI Convertible", "MINI Cooper", "MINI Cooper D", "MINI Cooper S", "MINI Countryman", "MINI Coupe", "MINI Electric Cooper", "MINI Electric Countryman", "MINI Hatch", "MINI John Cooper Works", "MINI One", "MINI Paceman", "MINI Roadster", "Mitsubishi ASX", "Mitsubishi Colt", "Mitsubishi Eclipse Cross", "Mitsubishi Lancer", "Mitsubishi Mirage", "Mitsubishi Outlander", "Mitsubishi Pajero", "Mitsubishi Shogun", "Mitsubishi Shogun Sport", "Nissan 350Z", "Nissan 370Z", "Nissan Almera", "Nissan Ariya", "Nissan Cube", "Nissan Elgrand", "Nissan GT-R", "Nissan Juke", "Nissan Leaf", "Nissan Micra", "Nissan Murano", "Nissan Note", "Nissan Pathfinder", "Nissan Patrol", "Nissan Pixo", "Nissan Primera", "Nissan Pulsar", "Nissan Qashqai", "Nissan Serena", "Nissan Skyline", "Nissan X-Trail", "Omoda 5", "Omoda 7", "Omoda 9", "Omoda E5", "Perodua Myvi", "Peugeot 1007", "Peugeot 106", "Peugeot 107", "Peugeot 108", "Peugeot 2008", "Peugeot 205", "Peugeot 206", "Peugeot 207", "Peugeot 208", "Peugeot 3008", "Peugeot 307", "Peugeot 307 CC", "Peugeot 308", "Peugeot 308 SW", "Peugeot 4007", "Peugeot 407", "Peugeot 408", "Peugeot 5008", "Peugeot 508", "Peugeot 508 SW", "Peugeot E-2008", "Peugeot E-208", "Peugeot E-3008", "Peugeot E-308", "Peugeot E-408", "Peugeot E-5008", "Peugeot RCZ", "Peugeot Rifter", "Peugeot Traveller", "Polestar 2", "Polestar 3", "Polestar 4", "Porsche 718", "Porsche 911", "Porsche 911 Turbo", "Porsche 928", "Porsche 944", "Porsche Boxster", "Porsche Cayenne", "Porsche Cayman", "Porsche Macan", "Porsche Panamera", "Porsche Taycan", "Renault 5", "Renault Arkana", "Renault Austral", "Renault Captur", "Renault Clio", "Renault Grand Scenic", "Renault Kadjar", "Renault Koleos", "Renault Megane", "Renault Megane E-Tech", "Renault Modus", "Renault Rafale", "Renault Scenic", "Renault Scenic E-Tech", "Renault Symbioz", "Renault Twingo", "Renault Wind", "Renault Zoe", "Rolls-Royce Corniche", "Rolls-Royce Cullinan", "Rolls-Royce Dawn", "Rolls-Royce Ghost", "Rolls-Royce Phantom", "Rolls-Royce Silver Cloud", "Rolls-Royce Silver Seraph", "Rolls-Royce Silver Shadow", "Rolls-Royce Silver Spirit", "Rolls-Royce Silver Spur", "Rolls-Royce Spectre", "Rolls-Royce Wraith", "Rover 200", "Rover 25", "Rover Mini", "Saab 9 3", "Saab 9 5", "SEAT Alhambra", "SEAT Altea", "SEAT Arona", "SEAT Ateca", "SEAT Exeo", "SEAT Ibiza", "SEAT Leon", "SEAT Mii", "SEAT Tarraco", "SEAT Toledo", "Skoda Citigo", "Skoda Elroq", "Skoda Enyaq", "Skoda Fabia", "Skoda Kamiq", "Skoda Karoq", "Skoda Kodiaq", "Skoda Octavia", "Skoda Octavia vRS", "Skoda Rapid", "Skoda Roomster", "Skoda Scala", "Skoda Superb", "Skoda Yeti", "Smart 1", "Smart 3", "Smart 5", "Smart City Coupe", "Smart ForFour", "Smart ForTwo", "Smart Roadster", "Ssangyong Korando", "Ssangyong Musso", "Ssangyong Rexton", "Ssangyong Tivoli", "Ssangyong Turismo", "Subaru Crosstrek", "Subaru Forester", "Subaru Impreza", "Subaru Justy", "Subaru Legacy", "Subaru Levorg", "Subaru Outback", "Subaru Solterra", "Subaru Tribeca", "Subaru XV", "Suzuki Across", "Suzuki Alto", "Suzuki Baleno", "Suzuki Celerio", "Suzuki Hustler", "Suzuki Ignis", "Suzuki Jimny", "Suzuki Kizashi", "Suzuki Liana", "Suzuki S-Cross", "Suzuki Splash", "Suzuki Swace", "Suzuki Swift", "Suzuki SX4", "Suzuki Vitara", "Suzuki Wagon R", "Tesla Model 3", "Tesla Model S", "Tesla Model X", "Tesla Model Y", "Toyota Alphard", "Toyota Aqua", "Toyota Auris", "Toyota Avensis", "Toyota AYGO", "Toyota Aygo X", "Toyota bZ4X", "Toyota C-HR", "Toyota Camry", "Toyota Celica", "Toyota Corolla", "Toyota Corolla Verso", "Toyota Estima", "Toyota FJ Cruiser", "Toyota GR 86", "Toyota GR Yaris", "Toyota GT86", "Toyota Highlander", "Toyota iQ", "Toyota Land Cruiser", "Toyota MR2", "Toyota Noah", "Toyota Picnic", "Toyota Previa", "Toyota Prius", "Toyota RAV4", "Toyota Supra", "Toyota Urban Cruiser", "Toyota Vellfire", "Toyota Verso", "Toyota Vitz", "Toyota Voxy", "Toyota Yaris", "Toyota Yaris Cross", "Toyota Yaris Verso", "Triumph Stag", "TVR Chimaera", "Vauxhall ADAM", "Vauxhall Agila", "Vauxhall Ampera", "Vauxhall Antara", "Vauxhall Astra", "Vauxhall Astra Electric", "Vauxhall Astra GTC", "Vauxhall Calibra", "Vauxhall Cascada", "Vauxhall Corsa", "Vauxhall Corsa Electric", "Vauxhall Crossland", "Vauxhall Crossland X", "Vauxhall Frontera", "Vauxhall Frontera Electric", "Vauxhall Grandland", "Vauxhall Grandland Electric", "Vauxhall Grandland X", "Vauxhall Insignia", "Vauxhall Meriva", "Vauxhall Mokka", "Vauxhall Mokka Electric", "Vauxhall Mokka X", "Vauxhall Omega", "Vauxhall Tigra", "Vauxhall Vectra", "Vauxhall VIVA", "Vauxhall Zafira", "Vauxhall Zafira Tourer", "Volkswagen Arteon", "Volkswagen Beetle", "Volkswagen CC", "Volkswagen e-Golf", "Volkswagen e-Up", "Volkswagen Eos", "Volkswagen Fox", "Volkswagen Golf", "Volkswagen Golf GTi", "Volkswagen Golf Plus", "Volkswagen Golf R", "Volkswagen Golf R32", "Volkswagen Golf TDi", "Volkswagen ID. Buzz", "Volkswagen ID.3", "Volkswagen ID.4", "Volkswagen ID.5", "Volkswagen ID.7", "Volkswagen Jetta", "Volkswagen Lupo", "Volkswagen Passat", "Volkswagen Polo", "Volkswagen Scirocco", "Volkswagen Sharan", "Volkswagen T-Cross", "Volkswagen T-Roc", "Volkswagen Taigo", "Volkswagen Tayron", "Volkswagen Tiguan", "Volkswagen Tiguan Allspace", "Volkswagen Touareg", "Volkswagen Touran", "Volkswagen Up", "Volvo 850", "Volvo C30", "Volvo C40", "Volvo C70", "Volvo EC40", "Volvo ES90", "Volvo EX30", "Volvo EX40", "Volvo EX90", "Volvo S40", "Volvo S60", "Volvo S80", "Volvo S90", "Volvo V40", "Volvo V40 Cross Country", "Volvo V50", "Volvo V60", "Volvo V60 Cross Country", "Volvo V70", "Volvo V90", "Volvo V90 Cross Country", "Volvo XC40", "Volvo XC60", "Volvo XC70", "Volvo XC90" ] } }, "minPrice": { "title": "Minimum price", "enum": [ "", "500", "1000", "2000", "3000", "4000", "5000", "6000", "7000", "8000", "9000", "10000", "12500", "15000", "17500", "20000", "25000", "30000", "35000", "40000", "50000", "60000", "75000", "100000", "150000", "250000" ], "type": "string", "description": "Lowest asking price.", "default": "" }, "maxPrice": { "title": "Maximum price", "enum": [ "", "500", "1000", "2000", "3000", "4000", "5000", "6000", "7000", "8000", "9000", "10000", "12500", "15000", "17500", "20000", "25000", "30000", "35000", "40000", "50000", "60000", "75000", "100000", "150000", "250000" ], "type": "string", "description": "Highest asking price.", "default": "" }, "minYear": { "title": "Oldest year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Registered in or after this year." }, "maxYear": { "title": "Newest year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Registered in or before this year." }, "minMileage": { "title": "Minimum mileage", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Lowest mileage in miles." }, "maxMileage": { "title": "Maximum mileage", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Highest mileage in miles." }, "fuelType": { "title": "Fuel type", "enum": [ "", "petrol", "diesel", "hybrid", "electric", "plug-in-hybrid" ], "type": "string", "description": "Only cars with this fuel type.", "default": "" }, "gearbox": { "title": "Gearbox", "enum": [ "", "automatic", "manual" ], "type": "string", "description": "Automatic or manual.", "default": "" }, "bodyType": { "title": "Body type", "enum": [ "", "112", "119", "121", "120", "124", "117", "116", "126", "114", "105", "103", "113", "129", "123", "104", "130", "122", "118", "128", "108", "127", "107", "115", "109", "110", "102", "125", "111" ], "type": "string", "description": "Only cars with this body type, as AA Cars classifies them.", "default": "" }, "colour": { "title": "Colour", "enum": [ "", "beige", "black", "blue", "bronze", "brown", "cream", "gold", "green", "grey", "maroon", "multi-coloured", "orange", "pink", "purple", "red", "silver", "turquoise", "white", "yellow" ], "type": "string", "description": "Only cars in this colour.", "default": "" }, "doors": { "title": "Doors", "enum": [ "", "2", "3", "4", "5", "6" ], "type": "string", "description": "Number of doors.", "default": "" }, "seats": { "title": "Seats", "enum": [ "", "2", "3", "4", "5", "6", "7", "8", "9", "Over" ], "type": "string", "description": "Number of seats.", "default": "" }, "minEngineSize": { "title": "Minimum engine size", "enum": [ "", "1", "1.2", "1.4", "1.6", "1.8", "2", "3", "4", "5" ], "type": "string", "description": "Smallest engine.", "default": "" }, "maxEngineSize": { "title": "Maximum engine size", "enum": [ "", "1", "1.2", "1.4", "1.6", "1.8", "2", "3", "4", "5" ], "type": "string", "description": "Largest engine.", "default": "" }, "writeOffs": { "title": "Written-off cars", "enum": [ "", "none", "s", "n" ], "type": "string", "description": "Recorded insurance write-offs (Cat S and Cat N) are included unless you choose otherwise.", "default": "" }, "aaInspectedOnly": { "title": "AA inspected only", "type": "boolean", "description": "Only cars that passed an AA vehicle inspection.", "default": false }, "manufacturerApprovedOnly": { "title": "Manufacturer approved only", "type": "boolean", "description": "Only manufacturer approved used cars.", "default": false }, "nearlyNewOnly": { "title": "Nearly new only", "type": "boolean", "description": "Only nearly new cars.", "default": false }, "financeAvailableOnly": { "title": "AA finance available only", "type": "boolean", "description": "Only cars you can buy on AA car finance (monthly prices included).", "default": false }, "keyword": { "title": "Keywords", "type": "string", "description": "Words to look for, as in the site's \"Add keywords\" box, for example \"ST-Line\" or \"panoramic roof\"." }, "postcode": { "title": "Postcode", "type": "string", "description": "Search around this UK postcode, for example SW1A 1AA or M1." }, "distance": { "title": "Distance", "enum": [ "", "10", "20", "30", "40", "50", "100", "2000" ], "type": "string", "description": "Distance from the postcode.", "default": "" }, "dealer": { "title": "Dealer", "type": "string", "description": "Only this dealer's cars: paste the dealer page URL, for example https://www.theaa.com/used-cars/dealers/vertu-ford-bromley" }, "sortBy": { "title": "Sort order", "enum": [ "", "datedesc", "dateasc", "priceasc", "pricedesc", "closest" ], "type": "string", "description": "Order of results.", "default": "" }, "maxItems": { "title": "Maximum cars", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after saving this many cars. Each saved car is one billable result.", "default": 100 }, "includeListingDetails": { "title": "Get full listing details", "type": "boolean", "description": "Opens each car's page for all photos, colour, engine size, doors, CO2, features, description, the vehicle history check, registration, finance prices and the dealer's address, phone and opening hours. Turn off for much faster runs with search-result fields only.", "default": true }, "includeDuplicates": { "title": "Include cars from previous runs", "type": "boolean", "description": "Off by default: cars you already received in an earlier run are skipped and not charged, so scheduled runs return only new stock. Turn on to get every matching car again (each is marked seen_in_previous_run).", "default": false }, "reportDelisted": { "title": "Report sold and removed cars", "type": "boolean", "description": "Remembers every car each search returns. On the next run of the same search, cars that have gone are saved to the DELISTED_LISTINGS record with the reason (sold_or_removed or no_longer_matches_search), first and last seen dates and prices, so you get days on sale and price drops. Free. Works when the whole search is read, so set Maximum cars above the search size.", "default": true }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 64, "type": "integer", "description": "Car pages loaded at once. The default is tuned for speed without straining AA Cars.", "default": 32 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy spreads requests over several IP addresses. The default was the fastest in tests.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }