# Lovette Categories Spider (`getdataforme/lovette-categories-spider`) Actor Scrape comprehensive UK property listings from Lovetts.net with this Apify Actor. Extracts prices, descriptions, images, and specs for efficient market insights. Features flexible URLs, clean JSON output, error handling, and scalable performance. Perfect for real estate professionals and investors. - **URL**: https://apify.com/getdataforme/lovette-categories-spider.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** AI, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Description Scrape comprehensive UK property listings from Lovetts.net with this Apify Actor. Extracts prices, descriptions, images, and specs for efficient market insights. Features flexible URLs, clean JSON output, error handling, and scalable performance. Perfect for real estate professionals and investors. --- ## Lovette Categories Spider ### Introduction The Lovette Categories Spider is a powerful Apify Actor designed to scrape property listings from Lovetts.net, extracting detailed information about properties for sale. It automates the collection of real estate data, including prices, descriptions, images, and specifications, enabling users to gather comprehensive market insights efficiently. This tool is ideal for real estate professionals, investors, and analysts seeking reliable, structured data from a trusted UK property website. ### Features - **Comprehensive Data Extraction**: Scrapes key property details such as ID, title, price, bedrooms, bathrooms, living rooms, descriptions, URLs, main images, and photo galleries. - **Flexible URL Input**: Accepts multiple URLs for targeted scraping of specific categories or listings, with validation for proper HTTP/HTTPS formats. - **High-Reliability Output**: Produces clean, JSON-formatted data with consistent fields, ensuring easy integration into databases or analysis tools. - **Efficient Performance**: Optimized for fast scraping with minimal resource usage, handling large volumes of listings without overloading the target site. - **Error Handling**: Includes built-in mechanisms to manage network issues, timeouts, and invalid pages, with detailed logging for troubleshooting. - **Scalable and Customizable**: Supports batch processing and can be extended for custom data fields or integrations via Apify's API. - **Privacy-Compliant**: Adheres to web scraping best practices, respecting robots.txt and avoiding disruptive behavior. ### Input Parameters | Parameter | Type | Required | Description | Example | |-----------|------|----------|-------------|---------| | Urls | array | No | A list of URLs to scrape property listings from. Must be valid HTTP or HTTPS URLs. Defaults to a sample URL if not provided. | ["https://www.lovetts.net/properties-for-sale", "https://www.lovetts.net/properties-for-sale/category/houses"] | ### Example Usage #### Input JSON ```json { "Urls": [ "https://www.lovetts.net/properties-for-sale" ] } ```` #### Output JSON ```json [ { "id": "228", "title": "Albert Road, Ramsgate", "price": "£699,995", "beds": "6", "baths": "5", "living": "5", "description": "Nestled on the charming Albert Road in Ramsgate, this remarkable property presents an exceptional opportunity for investors. Spanning an impressive 667 square feet, the building is thoughtfully ", "url": "https://www.lovetts.net/properties-for-sale/property/228-albert-road-ramsgate", "main_image": "https://cdns3.estateweb.com/assets/9883/of/4/pro/33723469/main/1.jpg", "gallery": [ "https://cdns3.estateweb.com/assets/9883/of/4/pro/33723469/thumb/2.jpg", "https://cdns3.estateweb.com/assets/9883/of/4/pro/33723469/thumb/3.jpg", "https://cdns3.estateweb.com/assets/9883/of/4/pro/33723469/thumb/4.jpg" ], "status": "AVAILABLE", "order": "DESC", "actor_id": "sdjXD2IgM2B3Ak2PT", "run_id": "e0WdS2qMhBPvt5h6S" }, { "id": "53", "title": "Godwin Road, Cliftonville, Margate", "price": "Offers over £485,000", "beds": "8", "baths": "4", "living": "4", "description": "INVESTMENT OPPORTUNITY - Lovetts is thrilled to present this exceptional investment opportunity, currently generating an annual income of £30,540 with the potential to increase it effortlessly to ", "url": "https://www.lovetts.net/properties-for-sale/property/53-godwin-road-cliftonville-margate", "main_image": "https://cdns3.estateweb.com/assets/9883/of/4/pro/32093360/main/1.jpg", "gallery": [ "https://cdns3.estateweb.com/assets/9883/of/4/pro/32093360/thumb/2.jpg", "https://cdns3.estateweb.com/assets/9883/of/4/pro/32093360/thumb/3.jpg", "https://cdns3.estateweb.com/assets/9883/of/4/pro/32093360/thumb/4.jpg" ], "status": "AVAILABLE", "order": "DESC", "actor_id": "sdjXD2IgM2B3Ak2PT", "run_id": "e0WdS2qMhBPvt5h6S" }, { "id": "175", "title": "Northdown Park Road, Margate", "price": "£460,000", "beds": "3", "baths": "2", "living": "1", "description": "Lovetts are delighted to market this charming 3-bedroom terraced house, perfect for family living. Entering via a few steps, you are welcomed into a bright Hallway that leads you through the ground ", "url": "https://www.lovetts.net/properties-for-sale/property/175-northdown-park-road-margate", "main_image": "https://cdns3.estateweb.com/assets/9883/of/4/pro/33388437/main/1.jpg", "gallery": [ "https://cdns3.estateweb.com/assets/9883/of/4/pro/33388437/thumb/2.jpg", "https://cdns3.estateweb.com/assets/9883/of/4/pro/33388437/thumb/3.jpg", "https://cdns3.estateweb.com/assets/9883/of/4/pro/33388437/thumb/4.jpg" ], "status": "AVAILABLE", "order": "DESC", "actor_id": "sdjXD2IgM2B3Ak2PT", "run_id": "e0WdS2qMhBPvt5h6S" } ] ``` ### Use Cases - **Market Research and Analysis**: Gather data on property prices, features, and availability to analyze trends in the UK real estate market. - **Competitive Intelligence**: Monitor competitor listings and pricing strategies for real estate agencies. - **Price Monitoring**: Track price changes and offers over time for investment opportunities. - **Content Aggregation**: Collect property descriptions and images for real estate blogs, newsletters, or databases. - **Academic Research**: Study housing patterns, affordability, and regional property distributions. - **Business Automation**: Integrate scraped data into CRM systems or automated reporting tools for streamlined operations. ### Installation and Usage 1. Search for "Lovette Categories Spider" in the Apify Store. 2. Click "Try for free" or "Run". 3. Configure input parameters (e.g., add URLs to scrape). 4. Click "Start" to begin extraction. 5. Monitor progress in the log. 6. Export results in your preferred format (JSON, CSV, Excel). ### Output Format The output is an array of JSON objects, each representing a property listing. Key fields include: - `id`: Unique property identifier. - `title`: Property name and location. - `price`: Listed price or offer details. - `beds`, `baths`, `living`: Number of bedrooms, bathrooms, and living rooms. - `description`: Detailed property summary. - `url`: Direct link to the listing. - `main_image` and `gallery`: Image URLs for visuals. - `status`: Availability (e.g., "AVAILABLE"). - `order`: Sorting order (e.g., "DESC"). - `actor_id` and `run_id`: Metadata for tracking. Data is structured for easy parsing and integration. ### Support For custom/simplified outputs or bug reports, please contact: - Email: support@getdataforme.com - Subject line: "custom support" - Contact form: https://getdataforme.com/contact/ We're here to help you get the most out of this Actor! # Actor input Schema ## `Urls` (type: `array`): The urls for the spider. ## Actor input object example ```json { "Urls": [ "https://www.lovetts.net/properties-for-sale" ] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/lovette-categories-spider").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("getdataforme/lovette-categories-spider").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call getdataforme/lovette-categories-spider --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/lovette-categories-spider", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Lovette Categories Spider", "description": "Scrape comprehensive UK property listings from Lovetts.net with this Apify Actor. Extracts prices, descriptions, images, and specs for efficient market insights. Features flexible URLs, clean JSON output, error handling, and scalable performance. Perfect for real estate professionals and investors.", "version": "0.0", "x-build-id": "eX9ZTpLTZuMLnHSoV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~lovette-categories-spider/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-lovette-categories-spider", "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/getdataforme~lovette-categories-spider/runs": { "post": { "operationId": "runs-sync-getdataforme-lovette-categories-spider", "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/getdataforme~lovette-categories-spider/run-sync": { "post": { "operationId": "run-sync-getdataforme-lovette-categories-spider", "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": { "Urls": { "title": "Urls", "minItems": 1, "type": "array", "description": "The urls for the spider.", "default": [ "https://www.lovetts.net/properties-for-sale" ], "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 } } } } } } } } } } ```