{ "openapi": "3.0.1", "info": { "title": "Jiffy On Demand Scraper | Pro Phones & Emails", "description": "Scrape jiffyondemand.com (Jiffy On Demand) catalogs and public Pro pages in Canada and the US. Export names, phones, emails, city, service families, and HQ address. Guest pages only — no Book. CSV, Excel, or JSON.", "version": "0.1", "x-build-id": "NWEEpMKT3O5OkZ5e3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~jiffy-ondemand-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-jiffy-ondemand-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/lentic_clockss~jiffy-ondemand-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-jiffy-ondemand-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/lentic_clockss~jiffy-ondemand-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-jiffy-ondemand-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": { "searchType": { "title": "Search type", "enum": [ "catalog", "service", "pro", "regions", "privacy", "about", "home", "sitemap-pros", "families", "availability", "sitemap-services", "profiles", "reviews", "top-pros", "service-stats", "metadata" ], "type": "string", "description": "What to collect. Public catalogs, services, pros (with phone and email), rankings, reviews, service statistics and metadata. Jiffy has no public keyword search, map or job listings.", "default": "catalog" }, "region": { "title": "Region slug", "type": "string", "description": "One of the eight Jiffy cities. Empty uses Montreal for ca or Boston for us. An explicit city determines its actual market.", "default": "" }, "regionId": { "title": "Region id", "minimum": 1, "maximum": 8, "type": "integer", "description": "Optional numeric 1-8. Overrides region slug when set." }, "serviceSlug": { "title": "Service slug", "type": "string", "description": "Live /service/{slug} that is active in the chosen region. Do not smoke handyman or pest-control.", "default": "" }, "proSlug": { "title": "Pro slug", "type": "string", "description": "Live sitemap /pro/{slug}. Do not smoke a-e-roofing or aaron-bartsch.", "default": "" }, "market": { "title": "Market", "enum": [ "ca", "us" ], "type": "string", "description": "ca (default Montreal) or us (Boston/Chicago). Same host jiffyondemand.com.", "default": "ca" }, "uids": { "title": "Professional UIDs", "type": "array", "description": "Public UIDs for profiles mode, or one UID to select a reviews professional. Up to 200 per run.", "items": { "type": "string" } }, "professionalId": { "title": "Professional ID", "minimum": 1, "type": "integer", "description": "Numeric ID for reviews. Alternatively use proSlug or a UID." }, "serviceId": { "title": "Service ID", "minimum": 1, "type": "integer", "description": "Service identifier for statistics, rankings or a reviews filter." }, "regionalServiceId": { "title": "Regional service ID", "minimum": 1, "type": "integer", "description": "Required with serviceId in top-pros mode. serviceSlug resolves both IDs for your city." }, "startPage": { "title": "Start page", "minimum": 1, "maximum": 100000, "type": "integer", "description": "First reviews, ranking or gallery page. Resume with nextPage from the output.", "default": 1 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Keep this unchanged when resuming a paginated run.", "default": 20 }, "startOffset": { "title": "Start offset", "minimum": 0, "type": "integer", "description": "Ordered sitemap offset, or nextOffset within startPage when resuming reviews/rankings.", "default": 0 }, "maxRequests": { "title": "Request budget", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper bound on requests to jiffyondemand.com, retries included. If it is reached, the run returns the rows it already has and its status message says where to continue (startOffset).", "default": 3000 }, "includeReviews": { "title": "Include professional reviews", "type": "boolean", "description": "Attach reviews to pro, profiles, sitemap-pros or top-pros rows. Job locations are not business addresses.", "default": false }, "includeStats": { "title": "Include service statistics", "type": "boolean", "description": "Attach jobsRequested for the last 30 days to service/catalog rows.", "default": false }, "maxReviews": { "title": "Reviews per professional", "minimum": 1, "maximum": 200, "type": "integer", "description": "Bound for nested reviews; standalone reviews uses maxResults.", "default": 20 }, "maxGallery": { "title": "Gallery images per professional", "minimum": 1, "maximum": 500, "type": "integer", "description": "Bound for optional paginated gallery enrichment.", "default": 100 }, "enrichDetails": { "title": "Enrich details", "type": "boolean", "description": "For /pro pages, call profiles API so phones populate, plus v1 extras (jobs/rating; not phone). Default on. Catalog cards have no merchant contact.", "default": true }, "allRegions": { "title": "All eight cities", "type": "boolean", "description": "Loop region_id 1-8 for catalog / sitemap-services. Default off so empty {} stays Montreal-only.", "default": false }, "includeInactive": { "title": "Include inactive services", "type": "boolean", "description": "Include regional_services with active=false. Default off.", "default": false }, "featuredOnly": { "title": "Featured services only", "type": "boolean", "description": "Keep only regional_services.is_featured=true.", "default": false }, "seasonalOnly": { "title": "Seasonal services only", "type": "boolean", "description": "Keep only seasonal=true services.", "default": false }, "quotedOnly": { "title": "Quoted-price services only", "type": "boolean", "description": "When true, keep quoted=true. When omitted, do not filter on quoted." }, "familySlug": { "title": "Service family slug", "type": "string", "description": "Filter catalog/availability by service_families.slug or name.", "default": "" }, "familyId": { "title": "Service family id", "type": "integer", "description": "Optional numeric service_families.id filter." }, "tag": { "title": "Service tag", "type": "string", "description": "Case-insensitive match against regional_services.tags or keywords.", "default": "" }, "filterProsByRegion": { "title": "Filter pros by region", "type": "boolean", "description": "Keep sitemap-pros whose PRELOADED regionId matches the selected city. Default off (sitemap is cross-city).", "default": false }, "includeGallery": { "title": "Include gallery URLs", "type": "boolean", "description": "Fetch gallery_attachments on enrich. Default off — not a lead field.", "default": false }, "maxResults": { "title": "Max rows per input", "minimum": 1, "maximum": 200, "type": "integer", "description": "Most Dataset rows for each detail URL or profile UID, or for the single selected catalog/service/pro/review request. Default 70; larger values are collected in parts of 70. Professional and review rows count together. The whole run stops at your maximum total charge. Free Apify plan: up to 200 rows per run and 10 runs of this Actor.", "default": 70 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum reviews/ranking/gallery pages. Catalog itself has no pages. Output reports the next page and offset.", "default": 1 }, "detailUrls": { "title": "Detail URLs", "type": "array", "description": "Optional live jiffyondemand.com /pro/ or /privacy_policy URLs. Do not send /search or /jobs.", "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 }, "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 } } } } } } } } } }