Realtor Agents Scraper

1{
2  "openapi": "3.0.1",
3  "info": {
4    "version": "0.2",
5    "x-build-id": "hJfORNvDPf0OxoVoM"
6  },
7  "servers": [
8    {
9      "url": "https://api.apify.com/v2"
10    }
11  ],
12  "paths": {
13    "/acts/jupri~realtor-agents/run-sync-get-dataset-items": {
14      "post": {
15        "operationId": "run-sync-get-dataset-items-jupri-realtor-agents",
16        "x-openai-isConsequential": false,
17        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
18        "tags": [
19          "Run Actor"
20        ],
21        "requestBody": {
22          "required": true,
23          "content": {
24            "application/json": {
25              "schema": {
26                "$ref": "#/components/schemas/inputSchema"
27              }
28            }
29          }
30        },
31        "parameters": [
32          {
33            "name": "token",
34            "in": "query",
35            "required": true,
36            "schema": {
37              "type": "string"
38            },
39            "description": "Enter your Apify token here"
40          }
41        ],
42        "responses": {
43          "200": {
44            "description": "OK"
45          }
46        }
47      }
48    },
49    "/acts/jupri~realtor-agents/runs": {
50      "post": {
51        "operationId": "runs-sync-jupri-realtor-agents",
52        "x-openai-isConsequential": false,
53        "summary": "Executes an Actor and returns information about the initiated run in response.",
54        "tags": [
55          "Run Actor"
56        ],
57        "requestBody": {
58          "required": true,
59          "content": {
60            "application/json": {
61              "schema": {
62                "$ref": "#/components/schemas/inputSchema"
63              }
64            }
65          }
66        },
67        "parameters": [
68          {
69            "name": "token",
70            "in": "query",
71            "required": true,
72            "schema": {
73              "type": "string"
74            },
75            "description": "Enter your Apify token here"
76          }
77        ],
78        "responses": {
79          "200": {
80            "description": "OK",
81            "content": {
82              "application/json": {
83                "schema": {
84                  "$ref": "#/components/schemas/runsResponseSchema"
85                }
86              }
87            }
88          }
89        }
90      }
91    },
92    "/acts/jupri~realtor-agents/run-sync": {
93      "post": {
94        "operationId": "run-sync-jupri-realtor-agents",
95        "x-openai-isConsequential": false,
96        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
97        "tags": [
98          "Run Actor"
99        ],
100        "requestBody": {
101          "required": true,
102          "content": {
103            "application/json": {
104              "schema": {
105                "$ref": "#/components/schemas/inputSchema"
106              }
107            }
108          }
109        },
110        "parameters": [
111          {
112            "name": "token",
113            "in": "query",
114            "required": true,
115            "schema": {
116              "type": "string"
117            },
118            "description": "Enter your Apify token here"
119          }
120        ],
121        "responses": {
122          "200": {
123            "description": "OK"
124          }
125        }
126      }
127    }
128  },
129  "components": {
130    "schemas": {
131      "inputSchema": {
132        "type": "object",
133        "required": [
134          "location"
135        ],
136        "properties": {
137          "location": {
138            "title": "Location",
139            "type": "string",
140            "description": "City, state or zip-code"
141          },
142          "name": {
143            "title": "Agent Name",
144            "type": "string",
145            "description": ""
146          },
147          "limit": {
148            "title": "Limit",
149            "type": "integer",
150            "description": "Limit results"
151          },
152          "sort": {
153            "title": "Sort",
154            "enum": [
155              "recent",
156              "rating",
157              "recommended",
158              "sale",
159              "sold"
160            ],
161            "type": "string",
162            "description": "Sorting"
163          },
164          "search_type": {
165            "title": "Type",
166            "enum": [
167              "agent",
168              "team",
169              "company"
170            ],
171            "type": "string",
172            "description": "Agent type"
173          },
174          "photo": {
175            "title": "Enable",
176            "type": "boolean",
177            "description": "Only search agents with photo"
178          },
179          "agent_type": {
180            "title": "Worked with",
181            "enum": [
182              "buyer",
183              "seller"
184            ],
185            "type": "string",
186            "description": ""
187          },
188          "languages": {
189            "title": "Languages",
190            "type": "array",
191            "description": "",
192            "items": {
193              "type": "string",
194              "enum": [
195                "asl",
196                "afrikaans",
197                "albanian",
198                "arabic",
199                "armenian",
200                "bengali",
201                "bosnian",
202                "bulgarian",
203                "chinese",
204                "croatian",
205                "czech",
206                "danish",
207                "dutch",
208                "estonian",
209                "farsi",
210                "filipino",
211                "finnish",
212                "french",
213                "gaelic",
214                "georgian",
215                "german",
216                "greek",
217                "hawaiian",
218                "hebrew",
219                "hindi",
220                "hungarian",
221                "indonesian",
222                "italian",
223                "japanese",
224                "korean",
225                "lao",
226                "latvian",
227                "lithuanian",
228                "malay",
229                "mandarin",
230                "nepali",
231                "norwegian",
232                "polish",
233                "portuguese",
234                "punjabi",
235                "romanian",
236                "russian",
237                "serbian",
238                "sindhi",
239                "singhalese",
240                "slovenian",
241                "spanish",
242                "swahili",
243                "swedish",
244                "tagalog",
245                "taiwanese",
246                "thai",
247                "turkish",
248                "ukrainian",
249                "urdu",
250                "vietnamese",
251                "yugoslavian"
252              ],
253              "enumTitles": [
254                "ASL (American Sign Language)",
255                "Afrikaans",
256                "Albanian",
257                "Arabic",
258                "Armenian",
259                "Bengali",
260                "Bosnian",
261                "Bulgarian",
262                "Chinese",
263                "Croatian",
264                "Czech",
265                "Danish",
266                "Dutch",
267                "Estonian",
268                "Farsi",
269                "Filipino",
270                "Finnish",
271                "French",
272                "Gaelic",
273                "Georgian",
274                "German",
275                "Greek",
276                "Hawaiian",
277                "Hebrew",
278                "Hindi",
279                "Hungarian",
280                "Indonesian",
281                "Italian",
282                "Japanese",
283                "Korean",
284                "Lao",
285                "Latvian",
286                "Lithuanian",
287                "Malay",
288                "Mandarin",
289                "Nepali",
290                "Norwegian",
291                "Polish",
292                "Portuguese",
293                "Punjabi",
294                "Romanian",
295                "Russian",
296                "Serbian",
297                "Sindhi",
298                "Singhalese",
299                "Slovenian",
300                "Spanish",
301                "Swahili",
302                "Swedish",
303                "Tagalog",
304                "Taiwanese",
305                "Thai",
306                "Turkish",
307                "Ukrainian",
308                "Urdu",
309                "Vietnamese",
310                "Yugoslavian"
311              ]
312            }
313          },
314          "designations": {
315            "title": "Certificates",
316            "type": "array",
317            "description": "",
318            "items": {
319              "type": "string",
320              "enum": [
321                "abr",
322                "ahwd",
323                "alc",
324                "bpor",
325                "c2ex",
326                "ccim",
327                "cips",
328                "cpm",
329                "crb",
330                "cre",
331                "crets",
332                "crs",
333                "e-pro",
334                "gaa",
335                "grn",
336                "gri",
337                "mrp",
338                "pmn",
339                "psa",
340                "raa",
341                "rene",
342                "rsps",
343                "sfr",
344                "sior",
345                "sres",
346                "srs"
347              ],
348              "enumTitles": [
349                "ABR - Accredited Buyer's Representative",
350                "AHWD - At Home With Diversity",
351                "ALC - Accredited Land Consultant",
352                "BPOR - Broker Price Opinion Resource",
353                "C2EX - Commitment to Excellence Endorsed",
354                "CCIM - Certified Commercial Investment Member",
355                "CIPS - Certified International Property Specialist",
356                "CPM - Certified Property Manager",
357                "CRB - Certified Real Estate Brokerage",
358                "CRE - Counselor of Real Estate",
359                "CRETS - Certified Real Estate Team Specialist",
360                "CRS - Certified Residential Specialist",
361                "e-PRO - NAR's e-PRO®",
362                "GAA - General Accredited Appraiser",
363                "GRN - CNAR Green Designee",
364                "GRI - Graduate, REALTOR® Institute",
365                "MRP - Military Relocation Professional",
366                "PMN - Performance Management Network",
367                "PSA - Pricing Strategy Advisor",
368                "RAA - Residential Accredited Appraiser",
369                "RENE - Real Estate Negotiation Expert",
370                "RSPS - Resort & Second Home Property Specialist",
371                "SFR - Short Sales & Foreclosure Resource (SFR)",
372                "SIOR - Society of Industrial and Office REALTORS®",
373                "SRES - Seniors Real Estate Specialist",
374                "SRS - Seller Representative Specialist"
375              ]
376            }
377          },
378          "min_rating": {
379            "title": "Rating",
380            "enum": [
381              "",
382              "1",
383              "2",
384              "3",
385              "4",
386              "5"
387            ],
388            "type": "string",
389            "description": "Minimum rating"
390          },
391          "min_recommended": {
392            "title": "Recomendation",
393            "enum": [
394              "",
395              "1",
396              "5",
397              "10"
398            ],
399            "type": "string",
400            "description": "Minimum recomendation"
401          },
402          "min_price": {
403            "title": "Price Range",
404            "type": "integer",
405            "description": ""
406          },
407          "max_price": {
408            "title": "",
409            "type": "integer",
410            "description": ""
411          },
412          "dev_proxy_config": {
413            "title": "🌐 PROXY NETWORKING",
414            "type": "object",
415            "description": "💡 <b>Supported protocol:</b><br><br><b>HTTP(S), SOCKS5</b><br><code>{http|socks5}://{user:pass}@{hostname|ip-address}:port</code><br><br><b>Example</b>: <code>socks5://example.com:9000</code>"
416          },
417          "dev_custom_headers": {
418            "title": "📜 HTTP HEADERS",
419            "type": "array",
420            "description": "💡 Additional HTTP Headers",
421            "items": {
422              "type": "object",
423              "required": [
424                "key",
425                "value"
426              ],
427              "properties": {
428                "key": {
429                  "type": "string",
430                  "title": "Key"
431                },
432                "value": {
433                  "type": "string",
434                  "title": "Value"
435                }
436              }
437            }
438          },
439          "dev_custom_cookies": {
440            "title": "🍰 HTTP COOKIES",
441            "type": "array",
442            "description": "💡 Additional HTTP Cookies",
443            "items": {
444              "type": "object",
445              "required": [
446                "key",
447                "value"
448              ],
449              "properties": {
450                "key": {
451                  "type": "string",
452                  "title": "Key"
453                },
454                "value": {
455                  "type": "string",
456                  "title": "Value"
457                }
458              }
459            }
460          },
461          "dev_transform_fields": {
462            "title": "♻️ CUSTOM FIELD",
463            "type": "array",
464            "description": "💡 <b>Transform the resulting output. Select only needed fields.</b><br><br>For nested object use <b>DOT</b>. For example: <pre>address.streetAddress</pre><br>For nested array use <b>NUMBER</b> <i>(index of array element starting from index=0)</i>. For example: <pre>images.0.url</pre>",
465            "items": {
466              "type": "object",
467              "required": [
468                "key",
469                "value"
470              ],
471              "properties": {
472                "key": {
473                  "type": "string",
474                  "title": "Key"
475                },
476                "value": {
477                  "type": "string",
478                  "title": "Value"
479                }
480              }
481            }
482          },
483          "dev_dataset_name": {
484            "title": "📁 CUSTOM STORAGE",
485            "type": "string",
486            "description": "💡 <b>Save results into custom named Dataset, use mask to customize dataset name</b><br><br><code>{ACTOR} = actor name<br>{DATE} = date (YYYYMMDD)<br>{TIME} = time (HHMMSS)</code><br><br>This masks can be used to autogenerate Dataset Name.<br><br>example: <i><code>data-{DATE}</code></i><br>Depending on today date the dataset name will be: <code>data-20230603</code><i><br><br>default: <code>data-{ACTOR}-{DATE}-{TIME}</code></i>"
487          },
488          "dev_dataset_clear": {
489            "title": "Clear Storage",
490            "type": "boolean",
491            "description": "Clear Dataset before insert/update."
492          },
493          "dev_no_strip": {
494            "title": "Disable data cleansing",
495            "type": "boolean",
496            "description": "💡 Keep/Save empty values <i><code>(NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)</code></i>"
497          }
498        }
499      },
500      "runsResponseSchema": {
501        "type": "object",
502        "properties": {
503          "data": {
504            "type": "object",
505            "properties": {
506              "id": {
507                "type": "string"
508              },
509              "actId": {
510                "type": "string"
511              },
512              "userId": {
513                "type": "string"
514              },
515              "startedAt": {
516                "type": "string",
517                "format": "date-time",
518                "example": "2025-01-08T00:00:00.000Z"
519              },
520              "finishedAt": {
521                "type": "string",
522                "format": "date-time",
523                "example": "2025-01-08T00:00:00.000Z"
524              },
525              "status": {
526                "type": "string",
527                "example": "READY"
528              },
529              "meta": {
530                "type": "object",
531                "properties": {
532                  "origin": {
533                    "type": "string",
534                    "example": "API"
535                  },
536                  "userAgent": {
537                    "type": "string"
538                  }
539                }
540              },
541              "stats": {
542                "type": "object",
543                "properties": {
544                  "inputBodyLen": {
545                    "type": "integer",
546                    "example": 2000
547                  },
548                  "rebootCount": {
549                    "type": "integer",
550                    "example": 0
551                  },
552                  "restartCount": {
553                    "type": "integer",
554                    "example": 0
555                  },
556                  "resurrectCount": {
557                    "type": "integer",
558                    "example": 0
559                  },
560                  "computeUnits": {
561                    "type": "integer",
562                    "example": 0
563                  }
564                }
565              },
566              "options": {
567                "type": "object",
568                "properties": {
569                  "build": {
570                    "type": "string",
571                    "example": "latest"
572                  },
573                  "timeoutSecs": {
574                    "type": "integer",
575                    "example": 300
576                  },
577                  "memoryMbytes": {
578                    "type": "integer",
579                    "example": 1024
580                  },
581                  "diskMbytes": {
582                    "type": "integer",
583                    "example": 2048
584                  }
585                }
586              },
587              "buildId": {
588                "type": "string"
589              },
590              "defaultKeyValueStoreId": {
591                "type": "string"
592              },
593              "defaultDatasetId": {
594                "type": "string"
595              },
596              "defaultRequestQueueId": {
597                "type": "string"
598              },
599              "buildNumber": {
600                "type": "string",
601                "example": "1.0.0"
602              },
603              "containerUrl": {
604                "type": "string"
605              },
606              "usage": {
607                "type": "object",
608                "properties": {
609                  "ACTOR_COMPUTE_UNITS": {
610                    "type": "integer",
611                    "example": 0
612                  },
613                  "DATASET_READS": {
614                    "type": "integer",
615                    "example": 0
616                  },
617                  "DATASET_WRITES": {
618                    "type": "integer",
619                    "example": 0
620                  },
621                  "KEY_VALUE_STORE_READS": {
622                    "type": "integer",
623                    "example": 0
624                  },
625                  "KEY_VALUE_STORE_WRITES": {
626                    "type": "integer",
627                    "example": 1
628                  },
629                  "KEY_VALUE_STORE_LISTS": {
630                    "type": "integer",
631                    "example": 0
632                  },
633                  "REQUEST_QUEUE_READS": {
634                    "type": "integer",
635                    "example": 0
636                  },
637                  "REQUEST_QUEUE_WRITES": {
638                    "type": "integer",
639                    "example": 0
640                  },
641                  "DATA_TRANSFER_INTERNAL_GBYTES": {
642                    "type": "integer",
643                    "example": 0
644                  },
645                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
646                    "type": "integer",
647                    "example": 0
648                  },
649                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
650                    "type": "integer",
651                    "example": 0
652                  },
653                  "PROXY_SERPS": {
654                    "type": "integer",
655                    "example": 0
656                  }
657                }
658              },
659              "usageTotalUsd": {
660                "type": "number",
661                "example": 0.00005
662              },
663              "usageUsd": {
664                "type": "object",
665                "properties": {
666                  "ACTOR_COMPUTE_UNITS": {
667                    "type": "integer",
668                    "example": 0
669                  },
670                  "DATASET_READS": {
671                    "type": "integer",
672                    "example": 0
673                  },
674                  "DATASET_WRITES": {
675                    "type": "integer",
676                    "example": 0
677                  },
678                  "KEY_VALUE_STORE_READS": {
679                    "type": "integer",
680                    "example": 0
681                  },
682                  "KEY_VALUE_STORE_WRITES": {
683                    "type": "number",
684                    "example": 0.00005
685                  },
686                  "KEY_VALUE_STORE_LISTS": {
687                    "type": "integer",
688                    "example": 0
689                  },
690                  "REQUEST_QUEUE_READS": {
691                    "type": "integer",
692                    "example": 0
693                  },
694                  "REQUEST_QUEUE_WRITES": {
695                    "type": "integer",
696                    "example": 0
697                  },
698                  "DATA_TRANSFER_INTERNAL_GBYTES": {
699                    "type": "integer",
700                    "example": 0
701                  },
702                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
703                    "type": "integer",
704                    "example": 0
705                  },
706                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
707                    "type": "integer",
708                    "example": 0
709                  },
710                  "PROXY_SERPS": {
711                    "type": "integer",
712                    "example": 0
713                  }
714                }
715              }
716            }
717          }
718        }
719      }
720    }
721  }
722}