{ "openapi": "3.0.1", "info": { "title": "depreciated Liffull draft", "description": "Extract structured LIFULL HOME'S property listings with asking prices, locations, property specs, amenities, media, agency names, enrichment, and map-ready coordinates. Built for market research, comps, inventory monitoring, CRM enrichment, BI dashboards, and AI-agent workflows.", "version": "0.1", "x-build-id": "lq5RbtSUTmc2bLh6w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~homes-jp-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-homes-jp-property-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/fatihtahta~homes-jp-property-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-homes-jp-property-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/fatihtahta~homes-jp-property-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-homes-jp-property-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": { "url": { "title": "Start from a HOME'S Search or Results URL", "type": "array", "description": "Paste a public homes.co.jp search, category, or results-list URL. The input accepts multiple lines for compatibility, but this actor currently starts from the first valid HOME'S URL, so use one URL per run for predictable monitoring and refresh workflows.", "items": { "type": "string" } }, "location": { "title": "Choose a Japanese Prefecture", "enum": [ "hokkaido", "aomori", "iwate", "miyagi", "akita", "yamagata", "fukushima", "ibaraki", "tochigi", "gunma", "saitama", "chiba", "tokyo", "kanagawa", "niigata", "toyama", "ishikawa", "fukui", "yamanashi", "nagano", "gifu", "shizuoka", "aichi", "mie", "shiga", "kyoto", "osaka", "hyogo", "nara", "wakayama", "tottori", "shimane", "okayama", "hiroshima", "yamaguchi", "tokushima", "kagawa", "ehime", "kochi", "fukuoka", "saga", "nagasaki", "kumamoto", "oita", "miyazaki", "kagoshima", "okinawa" ], "type": "string", "description": "Choose one prefecture for a clear, repeatable search boundary. Leave this empty to use Tokyo. Use a supported HOME'S results URL above for a narrower city, ward, neighborhood, or station scope.", "default": "tokyo" }, "deal_type": { "title": "Choose One or More Listing Modes", "uniqueItems": true, "type": "array", "description": "Select the residential or commercial rent and sale routes to collect. Modes are processed in the order selected; the default collects residential rentals. Publication date applies to the six residential modes; the other structured filters below only affect Buy | used apartments.", "items": { "type": "string", "enum": [ "rent_residential", "buy_residential_apartment_new", "buy_residential_apartment_used", "buy_residential_house_new", "buy_residential_house_used", "buy_residential_land", "rent_commercial_store", "rent_commercial_office", "rent_commercial_land", "rent_commercial_parking", "rent_commercial_warehouse_factory", "rent_commercial_other", "buy_commercial_store", "buy_commercial_office", "buy_commercial_warehouse_factory", "buy_commercial_other" ], "enumTitles": [ "Rent | residential properties", "Buy | new apartments", "Buy | used apartments", "Buy | new houses", "Buy | used houses", "Buy | residential land", "Rent | commercial stores", "Rent | commercial offices", "Rent | commercial land", "Rent | commercial parking", "Rent | warehouses or factories", "Rent | other commercial properties", "Buy | commercial stores", "Buy | commercial offices", "Buy | warehouses or factories", "Buy | other commercial properties" ] }, "default": [ "rent_residential" ] }, "min_price": { "title": "Set the Minimum Used-Apartment Sale Price (JPY)", "minimum": 5000000, "maximum": 100000000, "type": "integer", "description": "Set the lowest asking price for Buy | used apartments. Choose a supported HOME'S threshold from ¥5,000,000 to ¥100,000,000; this value is ignored for other listing modes." }, "max_price": { "title": "Set the Maximum Used-Apartment Sale Price (JPY)", "minimum": 5000000, "maximum": 100000000, "type": "integer", "description": "Set the highest asking price for Buy | used apartments. Choose a supported HOME'S threshold from ¥5,000,000 to ¥100,000,000 and keep it greater than or equal to the minimum price." }, "min_area": { "title": "Set the Minimum Exclusive Floor Area (m²)", "minimum": 10, "maximum": 200, "type": "integer", "description": "Keep used-apartment listings at or above this exclusive floor area. Choose a supported HOME'S threshold from 10 to 200 m²; this value is ignored for other listing modes." }, "max_area": { "title": "Set the Maximum Exclusive Floor Area (m²)", "minimum": 10, "maximum": 200, "type": "integer", "description": "Keep used-apartment listings at or below this exclusive floor area. Choose a supported HOME'S threshold from 10 to 200 m² and keep it greater than or equal to the minimum area." }, "bedroom_count": { "title": "Choose Acceptable Room Layouts", "uniqueItems": true, "type": "array", "description": "Select one or more HOME'S layout categories to narrow used-apartment sale listings, such as Studio, 1LDK, or 3LDK. Leave empty to accept any layout; this filter is omitted for other listing modes.", "items": { "type": "string", "enum": [ "studio", "1k", "1dk", "1ldk", "2k", "2dk", "2ldk", "3k", "3dk", "3ldk", "4k", "4dk", "4ldk_or_more" ], "enumTitles": [ "Studio", "1K", "1DK", "1LDK", "2K", "2DK", "2LDK", "3K", "3DK", "3LDK", "4K", "4DK", "4LDK or more" ] }, "default": [] }, "distance_from_metro": { "title": "Set the Maximum Walking Time to a Station", "enum": [ "any", "within_1_minute", "within_5_minutes", "within_7_minutes", "within_10_minutes", "within_15_minutes", "within_20_minutes" ], "type": "string", "description": "Choose the longest acceptable advertised walk to the nearest station for used-apartment listings. Keep Any for no walking-time filter.", "default": "any" }, "building_max_age": { "title": "Set the Maximum Building Age", "enum": [ "any", "within_3_years", "within_5_years", "within_10_years", "within_15_years", "within_20_years", "within_25_years", "within_30_years" ], "type": "string", "description": "Limit used-apartment listings to buildings no older than the selected age. Keep Any when building age should not narrow the dataset.", "default": "any" }, "renovations": { "title": "Require Completed Renovation Categories", "uniqueItems": true, "type": "array", "description": "Select renovation work that must be indicated on used-apartment listings. Leave empty when renovation status should not narrow the search.", "items": { "type": "string", "enum": [ "full", "water_areas", "interior", "water_or_interior" ], "enumTitles": [ "Full renovation", "Water areas", "Interior", "Water areas or interior" ] }, "default": [] }, "amenities": { "title": "Require Property Features or Service Options", "uniqueItems": true, "type": "array", "description": "Select proven HOME'S features such as parking, south-facing orientation, auto-lock entry, or online consultation. All selected values refine used-apartment sale searches; leave empty for no feature requirement.", "items": { "type": "string", "enum": [ "second_floor_or_above", "parking", "south_facing", "auto_lock", "bath_reheating", "online_consultation" ], "enumTitles": [ "Second floor or above", "Parking available", "South facing", "Auto-lock entry", "Bath reheating", "Online consultation" ] }, "default": [] }, "multimedia": { "title": "Require Listing Media", "uniqueItems": true, "type": "array", "description": "Require used-apartment listings to advertise the selected media types, such as a floor plan, property images, or panorama. Leave empty when media availability should not filter results.", "items": { "type": "string", "enum": [ "floor_plan", "images", "panorama" ], "enumTitles": [ "Floor plan available", "Property images available", "Panorama available" ] }, "default": [] }, "publication_date": { "title": "Limit by Listing Publication Date", "enum": [ "any", "today", "within_3_days", "within_7_days" ], "type": "string", "description": "Choose how recently the listing information must have been published for any of the six residential listing modes. Keep Any time to include listings regardless of publication date.", "default": "any" }, "sort_by": { "title": "Choose the Listing Order", "enum": [ "recommended", "price_ascending", "price_descending", "area_descending", "newest_building", "address", "newest_listing" ], "type": "string", "description": "Choose how HOME'S orders used-apartment results before collection. Ordering affects which listings appear first when a result limit is set.", "default": "recommended" }, "keyword": { "title": "Require Words in the Listing Search", "maxLength": 80, "type": "string", "description": "Enter up to 80 characters of free text for a used-apartment search. HOME'S requires all supplied words, so use focused terms when building repeatable monitoring or downstream comparison datasets." }, "enrich_data": { "title": "Add Available Detail-Page Fields to Each Listing", "type": "boolean", "description": "Keep enabled to add available descriptions, fuller photo sets, fees, availability, agency, address details, coordinates, and amenities. Disable it for quicker validation runs when search-result data is sufficient; unsuccessful detail collection still leaves a valid standard listing.", "default": true }, "limit": { "title": "Set the Maximum Number of Listings to Save", "minimum": 1, "type": "integer", "description": "Choose the maximum number of property records to save across the run. Leave empty to continue through all listings available to the selected source scope and listing modes." }, "mcpConnectors": { "title": "MCP Delivery Connectors", "uniqueItems": true, "type": "array", "description": "Choose user-authorized MCP connectors for an optional post-run summary and workflow handoff. The delivery contains compact run totals plus available dataset, summary, report, and map links—not the full listing dataset. Leave empty to only save listings to the Apify dataset and key-value store.", "default": [] } } }, "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 } } } } } } } } } }