{ "openapi": "3.0.1", "info": { "title": "Craigslist Rentals Scraper: Apartments & Rooms", "description": "🏠 Scrape US Craigslist apartments, rooms and sublets for rental research and listing feeds. Filter by city, subarea, rent and amenities. Export rents, bedrooms, bathrooms, descriptions, photo URLs and public contacts to JSON or CSV. Schedule runs and skip previously collected ads.", "version": "0.1", "x-build-id": "j6GJ6aBPMdMz1gr8V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arjun_code~craigslist-rentals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arjun_code-craigslist-rentals-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/arjun_code~craigslist-rentals-scraper/runs": { "post": { "operationId": "runs-sync-arjun_code-craigslist-rentals-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/arjun_code~craigslist-rentals-scraper/run-sync": { "post": { "operationId": "run-sync-arjun_code-craigslist-rentals-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": { "rentalCategory": { "title": "🏠 Rental category", "enum": [ "apa", "roo", "sub" ], "type": "string", "description": "Choose one rental category for guided searches. Default: apartments / housing for rent. Rooms and sublets have their own filters. Search and listing URLs keep their own category.", "default": "apa" }, "cities": { "title": "📍 US cities / regions", "type": "array", "description": "Select one or more US Craigslist markets. Default: New York. Used only when both Subareas and Rental URLs are empty.", "items": { "type": "string", "enumSuggestedValues": [ "abilene", "akroncanton", "albanyga", "albany", "albuquerque", "altoona", "amarillo", "ames", "anchorage", "annarbor", "annapolis", "appleton", "asheville", "ashtabula", "athensga", "athensohio", "atlanta", "auburn", "augusta", "austin", "bakersfield", "baltimore", "batonrouge", "battlecreek", "beaumont", "bellingham", "bemidji", "bend", "billings", "binghamton", "bham", "bismarck", "bloomington", "bn", "boise", "boone", "boston", "boulder", "bgky", "bozeman", "brainerd", "brownsville", "brunswick", "buffalo", "butte", "capecod", "catskills", "cedarrapids", "cenla", "centralmich", "cnj", "chambana", "charleston", "charlestonwv", "charlotte", "charlottesville", "chattanooga", "chautauqua", "chicago", "chico", "chillicothe", "cincinnati", "clarksville", "cleveland", "clovis", "collegestation", "cosprings", "columbiamo", "columbia", "columbusga", "columbus", "cookeville", "corpuschristi", "corvallis", "chambersburg", "dallas", "danville", "dayton", "daytona", "decatur", "nacogdoches", "delrio", "delaware", "denver", "desmoines", "detroit", "dothan", "dubuque", "duluth", "eastidaho", "eastoregon", "eastco", "newlondon", "eastky", "montana", "eastnc", "martinsburg", "easternshore", "eauclaire", "elpaso", "elko", "elmira", "erie", "eugene", "evansville", "fairbanks", "fargo", "farmington", "fayar", "fayetteville", "fingerlakes", "flagstaff", "flint", "shoals", "florencesc", "keys", "fortcollins", "fortdodge", "fortsmith", "fortwayne", "frederick", "fredericksburg", "fresno", "fortmyers", "gadsden", "gainesville", "galveston", "glensfalls", "goldcountry", "grandforks", "grandisland", "grandrapids", "greatfalls", "greenbay", "greensboro", "greenville", "gulfport", "hanford", "harrisburg", "harrisonburg", "hartford", "hattiesburg", "honolulu", "cfl", "helena", "hickory", "rockies", "hiltonhead", "holland", "houma", "houston", "hudsonvalley", "humboldt", "huntington", "huntsville", "imperial", "indianapolis", "inlandempire", "iowacity", "ithaca", "jxn", "jackson", "jacksontn", "jacksonville", "onslow", "janesville", "jerseyshore", "jonesboro", "joplin", "kalamazoo", "kalispell", "kansascity", "kenai", "kpr", "racine", "killeen", "kirksville", "klamath", "knoxville", "kokomo", "lacrosse", "lasalle", "tippecanoe", "lafayette", "lakecharles", "loz", "lakeland", "lancaster", "lansing", "laredo", "lascruces", "lasvegas", "lawrence", "lawton", "allentown", "lewiston", "lexington", "limaohio", "lincoln", "littlerock", "logan", "longisland", "losangeles", "louisville", "lubbock", "lynchburg", "macon", "madison", "maine", "ksu", "mankato", "mansfield", "masoncity", "mattoon", "mcallen", "meadville", "medford", "memphis", "mendocino", "merced", "meridian", "milwaukee", "minneapolis", "missoula", "mobile", "modesto", "mohave", "monroe", "monroemi", "monterey", "montgomery", "morgantown", "moseslake", "muncie", "muskegon", "myrtlebeach", "nashville", "nh", "newhaven", "neworleans", "blacksburg", "newyork", "norfolk", "lakecity", "nd", "newjersey", "northmiss", "northplatte", "nesd", "nmi", "wheeling", "northernwi", "nwct", "nwga", "nwks", "enid", "ocala", "odessa", "ogden", "okaloosa", "oklahomacity", "olympic", "omaha", "oneonta", "orangecounty", "oregoncoast", "orlando", "outerbanks", "owensboro", "palmsprings", "panamacity", "parkersburg", "pensacola", "peoria", "philadelphia", "phoenix", "csd", "pittsburgh", "plattsburgh", "poconos", "porthuron", "portland", "potsdam", "prescott", "provo", "pueblo", "pullman", "quadcities", "raleigh", "rapidcity", "reading", "redding", "reno", "providence", "richmondin", "richmond", "roanoke", "rmn", "rochester", "rockford", "roseburg", "roswell", "sacramento", "saginaw", "salem", "salina", "saltlakecity", "sanangelo", "sanantonio", "sandiego", "slo", "sanmarcos", "sandusky", "santabarbara", "santafe", "santamaria", "sarasota", "savannah", "scottsbluff", "scranton", "seattle", "sfbay", "sheboygan", "showlow", "shreveport", "sierravista", "siouxcity", "siouxfalls", "siskiyou", "skagit", "southbend", "southcoast", "sd", "miami", "southjersey", "juneau", "ottumwa", "seks", "semo", "carbondale", "smd", "swv", "swks", "swmi", "marshall", "natchez", "bigbend", "swva", "spacecoast", "spokane", "springfieldil", "springfield", "staugustine", "stcloud", "stgeorge", "stjoseph", "stlouis", "pennstate", "statesboro", "stillwater", "stockton", "susanville", "syracuse", "tallahassee", "tampa", "terrehaute", "texarkana", "texoma", "thumb", "toledo", "topeka", "treasure", "tricities", "tucson", "tulsa", "tuscaloosa", "tuscarawas", "twinfalls", "twintiers", "easttexas", "up", "utica", "valdosta", "ventura", "vermont", "victoriatx", "visalia", "waco", "washingtondc", "waterloo", "watertown", "wausau", "wenatchee", "wv", "quincy", "westky", "westmd", "westernmass", "westslope", "wichitafalls", "wichita", "williamsport", "wilmington", "winchester", "winstonsalem", "worcester", "wyoming", "yakima", "york", "youngstown", "yubasutter", "yuma", "zanesville" ], "enumTitles": [ "Abilene, TX (abilene)", "Akron / Canton, OH (akroncanton)", "Albany, GA (albanyga)", "Albany, NY (albany)", "Albuquerque, NM (albuquerque)", "Altoona-Johnstown, PA (altoona)", "Amarillo, TX (amarillo)", "Ames, IA (ames)", "Anchorage / Mat-Su, AK (anchorage)", "Ann Arbor, MI (annarbor)", "Annapolis, MD (annapolis)", "Appleton-Oshkosh-FDL, WI (appleton)", "Asheville, NC (asheville)", "Ashtabula, OH (ashtabula)", "Athens, GA (athensga)", "Athens, OH (athensohio)", "Atlanta, GA (atlanta)", "Auburn, AL (auburn)", "Augusta, GA (augusta)", "Austin, TX (austin)", "Bakersfield, CA (bakersfield)", "Baltimore, MD (baltimore)", "Baton Rouge, LA (batonrouge)", "Battle Creek, MI (battlecreek)", "Beaumont / Port Arthur, TX (beaumont)", "Bellingham, WA (bellingham)", "Bemidji, MN (bemidji)", "Bend, OR (bend)", "Billings, MT (billings)", "Binghamton, NY (binghamton)", "Birmingham, AL (bham)", "Bismarck, ND (bismarck)", "Bloomington, IN (bloomington)", "Bloomington-Normal, IL (bn)", "Boise, ID (boise)", "Boone, NC (boone)", "Boston, MA (boston)", "Boulder, CO (boulder)", "Bowling Green, KY (bgky)", "Bozeman, MT (bozeman)", "Brainerd, MN (brainerd)", "Brownsville, TX (brownsville)", "Brunswick, GA (brunswick)", "Buffalo, NY (buffalo)", "Butte, MT (butte)", "Cape Cod / Islands, MA (capecod)", "Catskills, NY (catskills)", "Cedar Rapids, IA (cedarrapids)", "Central Louisiana, LA (cenla)", "Central Michigan, MI (centralmich)", "Central NJ, NJ (cnj)", "Champaign Urbana, IL (chambana)", "Charleston, SC (charleston)", "Charleston, WV (charlestonwv)", "Charlotte, NC (charlotte)", "Charlottesville, VA (charlottesville)", "Chattanooga, TN (chattanooga)", "Chautauqua, NY (chautauqua)", "Chicago, IL (chicago)", "Chico, CA (chico)", "Chillicothe, OH (chillicothe)", "Cincinnati, OH (cincinnati)", "Clarksville, TN (clarksville)", "Cleveland, OH (cleveland)", "Clovis / Portales, NM (clovis)", "College Station, TX (collegestation)", "Colorado Springs, CO (cosprings)", "Columbia / Jeff City, MO (columbiamo)", "Columbia, SC (columbia)", "Columbus, GA (columbusga)", "Columbus, OH (columbus)", "Cookeville, TN (cookeville)", "Corpus Christi, TX (corpuschristi)", "Corvallis/Albany, OR (corvallis)", "Cumberland Valley, PA (chambersburg)", "Dallas / Fort Worth, TX (dallas)", "Danville, VA (danville)", "Dayton / Springfield, OH (dayton)", "Daytona Beach, FL (daytona)", "Decatur, IL (decatur)", "Deep East Texas, TX (nacogdoches)", "Del Rio / Eagle Pass, TX (delrio)", "Delaware, DE (delaware)", "Denver, CO (denver)", "Des Moines, IA (desmoines)", "Detroit Metro, MI (detroit)", "Dothan, AL (dothan)", "Dubuque, IA (dubuque)", "Duluth / Superior, MN (duluth)", "East Idaho, ID (eastidaho)", "East Oregon, OR (eastoregon)", "Eastern CO, CO (eastco)", "Eastern CT, CT (newlondon)", "Eastern Kentucky, KY (eastky)", "Eastern Montana, MT (montana)", "Eastern NC, NC (eastnc)", "Eastern Panhandle, WV (martinsburg)", "Eastern Shore, MD (easternshore)", "Eau Claire, WI (eauclaire)", "El Paso, TX (elpaso)", "Elko, NV (elko)", "Elmira-Corning, NY (elmira)", "Erie, PA (erie)", "Eugene, OR (eugene)", "Evansville, IN (evansville)", "Fairbanks, AK (fairbanks)", "Fargo / Moorhead, ND (fargo)", "Farmington, NM (farmington)", "Fayetteville, AR (fayar)", "Fayetteville, NC (fayetteville)", "Finger Lakes, NY (fingerlakes)", "Flagstaff / Sedona, AZ (flagstaff)", "Flint, MI (flint)", "Florence / Muscle Shoals, AL (shoals)", "Florence, SC (florencesc)", "Florida Keys, FL (keys)", "Fort Collins / North CO, CO (fortcollins)", "Fort Dodge, IA (fortdodge)", "Fort Smith, AR (fortsmith)", "Fort Wayne, IN (fortwayne)", "Frederick, MD (frederick)", "Fredericksburg, VA (fredericksburg)", "Fresno / Madera, CA (fresno)", "Ft Myers / SW Florida, FL (fortmyers)", "Gadsden-Anniston, AL (gadsden)", "Gainesville, FL (gainesville)", "Galveston, TX (galveston)", "Glens Falls, NY (glensfalls)", "Gold Country, CA (goldcountry)", "Grand Forks, ND (grandforks)", "Grand Island, NE (grandisland)", "Grand Rapids, MI (grandrapids)", "Great Falls, MT (greatfalls)", "Green Bay, WI (greenbay)", "Greensboro, NC (greensboro)", "Greenville / Upstate, SC (greenville)", "Gulfport / Biloxi, MS (gulfport)", "Hanford-Corcoran, CA (hanford)", "Harrisburg, PA (harrisburg)", "Harrisonburg, VA (harrisonburg)", "Hartford, CT (hartford)", "Hattiesburg, MS (hattiesburg)", "Hawaii, HI (honolulu)", "Heartland Florida, FL (cfl)", "Helena, MT (helena)", "Hickory / Lenoir, NC (hickory)", "High Rockies, CO (rockies)", "Hilton Head, SC (hiltonhead)", "Holland, MI (holland)", "Houma, LA (houma)", "Houston, TX (houston)", "Hudson Valley, NY (hudsonvalley)", "Humboldt County, CA (humboldt)", "Huntington-Ashland, WV (huntington)", "Huntsville / Decatur, AL (huntsville)", "Imperial County, CA (imperial)", "Indianapolis, IN (indianapolis)", "Inland Empire, CA (inlandempire)", "Iowa City, IA (iowacity)", "Ithaca, NY (ithaca)", "Jackson, MI (jxn)", "Jackson, MS (jackson)", "Jackson, TN (jacksontn)", "Jacksonville, FL (jacksonville)", "Jacksonville, NC (onslow)", "Janesville, WI (janesville)", "Jersey Shore, NJ (jerseyshore)", "Jonesboro, AR (jonesboro)", "Joplin, MO (joplin)", "Kalamazoo, MI (kalamazoo)", "Kalispell, MT (kalispell)", "Kansas City, MO (kansascity)", "Kenai Peninsula, AK (kenai)", "Kennewick-Pasco-Richland, WA (kpr)", "Kenosha-Racine, WI (racine)", "Killeen / Temple / Ft Hood, TX (killeen)", "Kirksville, MO (kirksville)", "Klamath Falls, OR (klamath)", "Knoxville, TN (knoxville)", "Kokomo, IN (kokomo)", "La Crosse, WI (lacrosse)", "La Salle Co, IL (lasalle)", "Lafayette / West Lafayette, IN (tippecanoe)", "Lafayette, LA (lafayette)", "Lake Charles, LA (lakecharles)", "Lake Of The Ozarks, MO (loz)", "Lakeland, FL (lakeland)", "Lancaster, PA (lancaster)", "Lansing, MI (lansing)", "Laredo, TX (laredo)", "Las Cruces, NM (lascruces)", "Las Vegas, NV (lasvegas)", "Lawrence, KS (lawrence)", "Lawton, OK (lawton)", "Lehigh Valley, PA (allentown)", "Lewiston / Clarkston, ID (lewiston)", "Lexington, KY (lexington)", "Lima / Findlay, OH (limaohio)", "Lincoln, NE (lincoln)", "Little Rock, AR (littlerock)", "Logan, UT (logan)", "Long Island, NY (longisland)", "Los Angeles, CA (losangeles)", "Louisville, KY (louisville)", "Lubbock, TX (lubbock)", "Lynchburg, VA (lynchburg)", "Macon / Warner Robins, GA (macon)", "Madison, WI (madison)", "Maine, ME (maine)", "Manhattan, KS (ksu)", "Mankato, MN (mankato)", "Mansfield, OH (mansfield)", "Mason City, IA (masoncity)", "Mattoon-Charleston, IL (mattoon)", "Mcallen / Edinburg, TX (mcallen)", "Meadville, PA (meadville)", "Medford-Ashland, OR (medford)", "Memphis, TN (memphis)", "Mendocino County, CA (mendocino)", "Merced, CA (merced)", "Meridian, MS (meridian)", "Milwaukee, WI (milwaukee)", "Minneapolis / St Paul, MN (minneapolis)", "Missoula, MT (missoula)", "Mobile, AL (mobile)", "Modesto, CA (modesto)", "Mohave County, AZ (mohave)", "Monroe, LA (monroe)", "Monroe, MI (monroemi)", "Monterey Bay, CA (monterey)", "Montgomery, AL (montgomery)", "Morgantown, WV (morgantown)", "Moses Lake, WA (moseslake)", "Muncie / Anderson, IN (muncie)", "Muskegon, MI (muskegon)", "Myrtle Beach, SC (myrtlebeach)", "Nashville, TN (nashville)", "New Hampshire, NH (nh)", "New Haven, CT (newhaven)", "New Orleans, LA (neworleans)", "New River Valley, VA (blacksburg)", "New York City, NY (newyork)", "Norfolk / Hampton Roads, VA (norfolk)", "North Central FL, FL (lakecity)", "North Dakota, ND (nd)", "North Jersey, NJ (newjersey)", "North Mississippi, MS (northmiss)", "North Platte, NE (northplatte)", "Northeast SD, SD (nesd)", "Northern Michigan, MI (nmi)", "Northern Panhandle, WV (wheeling)", "Northern WI, WI (northernwi)", "Northwest CT, CT (nwct)", "Northwest GA, GA (nwga)", "Northwest KS, KS (nwks)", "Northwest OK, OK (enid)", "Ocala, FL (ocala)", "Odessa / Midland, TX (odessa)", "Ogden-Clearfield, UT (ogden)", "Okaloosa / Walton, FL (okaloosa)", "Oklahoma City, OK (oklahomacity)", "Olympic Peninsula, WA (olympic)", "Omaha / Council Bluffs, NE (omaha)", "Oneonta, NY (oneonta)", "Orange County, CA (orangecounty)", "Oregon Coast, OR (oregoncoast)", "Orlando, FL (orlando)", "Outer Banks, NC (outerbanks)", "Owensboro, KY (owensboro)", "Palm Springs, CA (palmsprings)", "Panama City, FL (panamacity)", "Parkersburg-Marietta, WV (parkersburg)", "Pensacola, FL (pensacola)", "Peoria, IL (peoria)", "Philadelphia, PA (philadelphia)", "Phoenix, AZ (phoenix)", "Pierre / Central SD, SD (csd)", "Pittsburgh, PA (pittsburgh)", "Plattsburgh-Adirondacks, NY (plattsburgh)", "Poconos, PA (poconos)", "Port Huron, MI (porthuron)", "Portland, OR (portland)", "Potsdam-Canton-Massena, NY (potsdam)", "Prescott, AZ (prescott)", "Provo / Orem, UT (provo)", "Pueblo, CO (pueblo)", "Pullman / Moscow, WA (pullman)", "Quad Cities, IA/IL, IA (quadcities)", "Raleigh / Durham / CH, NC (raleigh)", "Rapid City / West SD, SD (rapidcity)", "Reading, PA (reading)", "Redding, CA (redding)", "Reno / Tahoe, NV (reno)", "Rhode Island, RI (providence)", "Richmond, IN (richmondin)", "Richmond, VA (richmond)", "Roanoke, VA (roanoke)", "Rochester, MN (rmn)", "Rochester, NY (rochester)", "Rockford, IL (rockford)", "Roseburg, OR (roseburg)", "Roswell / Carlsbad, NM (roswell)", "Sacramento, CA (sacramento)", "Saginaw-Midland-Baycity, MI (saginaw)", "Salem, OR (salem)", "Salina, KS (salina)", "Salt Lake City, UT (saltlakecity)", "San Angelo, TX (sanangelo)", "San Antonio, TX (sanantonio)", "San Diego, CA (sandiego)", "San Luis Obispo, CA (slo)", "San Marcos, TX (sanmarcos)", "Sandusky, OH (sandusky)", "Santa Barbara, CA (santabarbara)", "Santa Fe / Taos, NM (santafe)", "Santa Maria, CA (santamaria)", "Sarasota-Bradenton, FL (sarasota)", "Savannah / Hinesville, GA (savannah)", "Scottsbluff / Panhandle, NE (scottsbluff)", "Scranton / Wilkes-Barre, PA (scranton)", "Seattle-Tacoma, WA (seattle)", "SF Bay Area, CA (sfbay)", "Sheboygan, WI (sheboygan)", "Show Low, AZ (showlow)", "Shreveport, LA (shreveport)", "Sierra Vista, AZ (sierravista)", "Sioux City, IA (siouxcity)", "Sioux Falls / SE SD, SD (siouxfalls)", "Siskiyou County, CA (siskiyou)", "Skagit / Island / SJI, WA (skagit)", "South Bend / Michiana, IN (southbend)", "South Coast, MA (southcoast)", "South Dakota, SD (sd)", "South Florida, FL (miami)", "South Jersey, NJ (southjersey)", "Southeast Alaska, AK (juneau)", "Southeast IA, IA (ottumwa)", "Southeast KS, KS (seks)", "Southeast Missouri, MO (semo)", "Southern Illinois, IL (carbondale)", "Southern Maryland, MD (smd)", "Southern WV, WV (swv)", "Southwest KS, KS (swks)", "Southwest Michigan, MI (swmi)", "Southwest MN, MN (marshall)", "Southwest MS, MS (natchez)", "Southwest TX, TX (bigbend)", "Southwest VA, VA (swva)", "Space Coast, FL (spacecoast)", "Spokane / Coeur D'alene, WA (spokane)", "Springfield, IL (springfieldil)", "Springfield, MO (springfield)", "St Augustine, FL (staugustine)", "St Cloud, MN (stcloud)", "St George, UT (stgeorge)", "St Joseph, MO (stjoseph)", "St Louis, MO (stlouis)", "State College, PA (pennstate)", "Statesboro, GA (statesboro)", "Stillwater, OK (stillwater)", "Stockton, CA (stockton)", "Susanville, CA (susanville)", "Syracuse, NY (syracuse)", "Tallahassee, FL (tallahassee)", "Tampa Bay Area, FL (tampa)", "Terre Haute, IN (terrehaute)", "Texarkana, AR (texarkana)", "Texoma, TX (texoma)", "The Thumb, MI (thumb)", "Toledo, OH (toledo)", "Topeka, KS (topeka)", "Treasure Coast, FL (treasure)", "Tri-Cities, TN (tricities)", "Tucson, AZ (tucson)", "Tulsa, OK (tulsa)", "Tuscaloosa, AL (tuscaloosa)", "Tuscarawas Co, OH (tuscarawas)", "Twin Falls, ID (twinfalls)", "Twin Tiers NY/PA, NY (twintiers)", "Tyler / East TX, TX (easttexas)", "Upper Peninsula, MI (up)", "Utica-Rome-Oneida, NY (utica)", "Valdosta, GA (valdosta)", "Ventura County, CA (ventura)", "Vermont, VT (vermont)", "Victoria, TX (victoriatx)", "Visalia-Tulare, CA (visalia)", "Waco, TX (waco)", "Washington, DC (washingtondc)", "Waterloo / Cedar Falls, IA (waterloo)", "Watertown, NY (watertown)", "Wausau, WI (wausau)", "Wenatchee, WA (wenatchee)", "West Virginia (Old), WV (wv)", "Western IL, IL (quincy)", "Western KY, KY (westky)", "Western Maryland, MD (westmd)", "Western Massachusetts, MA (westernmass)", "Western Slope, CO (westslope)", "Wichita Falls, TX (wichitafalls)", "Wichita, KS (wichita)", "Williamsport, PA (williamsport)", "Wilmington, NC (wilmington)", "Winchester, VA (winchester)", "Winston-Salem, NC (winstonsalem)", "Worcester / Central MA, MA (worcester)", "Wyoming, WY (wyoming)", "Yakima, WA (yakima)", "York, PA (york)", "Youngstown, OH (youngstown)", "Yuba-Sutter, CA (yubasutter)", "Yuma, AZ (yuma)", "Zanesville / Cambridge, OH (zanesville)" ] }, "default": [ "newyork" ] }, "subareas": { "title": "📌 Subareas (optional; replaces cities)", "type": "array", "description": "Choose specific areas, such as New York / Brooklyn or Los Angeles / Westside-Southbay. Selected subareas replace the Cities list. Leave empty to search whole cities. 💡 Rental URLs take priority over both.", "items": { "type": "string", "enum": [ "atlanta/atl", "atlanta/eat", "atlanta/nat", "atlanta/sat", "atlanta/wat", "boston/gbs", "boston/bmw", "boston/nos", "boston/nwb", "boston/sob", "chicago/chc", "chicago/nch", "chicago/nwi", "chicago/nwc", "chicago/sox", "chicago/wcl", "dallas/dal", "dallas/ftw", "dallas/mdf", "dallas/ndf", "dallas/sdf", "detroit/mcb", "detroit/okl", "detroit/wyn", "fortmyers/chl", "fortmyers/col", "fortmyers/lee", "honolulu/big", "honolulu/kau", "honolulu/mau", "honolulu/mol", "honolulu/oah", "losangeles/ant", "losangeles/lac", "losangeles/lgb", "losangeles/sfv", "losangeles/sgv", "losangeles/wst", "minneapolis/ank", "minneapolis/csw", "minneapolis/dak", "minneapolis/hnp", "minneapolis/ram", "minneapolis/wsh", "newyork/brx", "newyork/brk", "newyork/fct", "newyork/lgi", "newyork/mnh", "newyork/jsy", "newyork/que", "newyork/stn", "newyork/wch", "phoenix/cph", "phoenix/evl", "phoenix/nph", "phoenix/wvl", "portland/clc", "portland/clk", "portland/grg", "portland/mlt", "portland/nco", "portland/wsc", "portland/yam", "sandiego/csd", "sandiego/esd", "sandiego/nsd", "sandiego/ssd", "seattle/est", "seattle/kit", "seattle/oly", "seattle/see", "seattle/sno", "seattle/skc", "seattle/tac", "sfbay/sfc", "sfbay/eby", "sfbay/nby", "sfbay/pen", "sfbay/scz", "sfbay/sby", "miami/brw", "miami/mdc", "miami/pbc", "tampa/hdo", "tampa/hil", "tampa/psc", "tampa/pnl", "washingtondc/doc", "washingtondc/mld", "washingtondc/nva" ], "enumTitles": [ "atlanta, GA / city of atlanta", "atlanta, GA / otp east", "atlanta, GA / otp north", "atlanta, GA / otp south", "atlanta, GA / otp west", "boston / boston/cambridge/brookline", "boston / metro west", "boston / north shore", "boston / northwest/merrimack", "boston / south shore", "chicago / city of chicago", "chicago / north chicagoland", "chicago / northwest indiana", "chicago / northwest suburbs", "chicago / south chicagoland", "chicago / west chicagoland", "dallas / fort worth / dallas", "dallas / fort worth / fort worth", "dallas / fort worth / mid cities", "dallas / fort worth / north DFW", "dallas / fort worth / south DFW", "detroit metro / macomb county", "detroit metro / oakland county", "detroit metro / wayne county", "ft myers / SW florida / charlotte county", "ft myers / SW florida / collier county", "ft myers / SW florida / lee county", "hawaii / big island", "hawaii / kauai", "hawaii / maui", "hawaii / molokai", "hawaii / oahu", "los angeles / antelope valley", "los angeles / central LA 213/323", "los angeles / long beach / 562", "los angeles / san fernando valley", "los angeles / san gabriel valley", "los angeles / westside-southbay-310", "minneapolis / st paul / anoka/chisago/isanti", "minneapolis / st paul / carver/sherburne/wright", "minneapolis / st paul / dakota / scott", "minneapolis / st paul / hennepin county", "minneapolis / st paul / ramsey county", "minneapolis / st paul / washington co / WI", "new york city / bronx", "new york city / brooklyn", "new york city / fairfield co, CT", "new york city / long island", "new york city / manhattan", "new york city / new jersey", "new york city / queens", "new york city / staten island", "new york city / westchester", "phoenix, AZ / central/south phx", "phoenix, AZ / east valley", "phoenix, AZ / phx north", "phoenix, AZ / west valley", "portland, OR / clackamas county", "portland, OR / clark/cowlitz WA", "portland, OR / columbia gorge", "portland, OR / multnomah county", "portland, OR / north coast", "portland, OR / washington county", "portland, OR / yamhill co", "san diego / city of san diego", "san diego / east san diego county", "san diego / north san diego county", "san diego / south san diego county", "seattle-tacoma / eastside", "seattle-tacoma / kitsap / west puget", "seattle-tacoma / olympia / thurston", "seattle-tacoma / seattle", "seattle-tacoma / snohomish county", "seattle-tacoma / south king co", "seattle-tacoma / tacoma / pierce", "SF bay area / city of san francisco", "SF bay area / east bay area", "SF bay area / north bay / marin", "SF bay area / peninsula", "SF bay area / santa cruz co", "SF bay area / south bay area", "south florida / broward county", "south florida / miami / dade county", "south florida / palm beach county", "tampa bay area / hernando co", "tampa bay area / hillsborough co", "tampa bay area / pasco co", "tampa bay area / pinellas co", "washington, DC / district of columbia", "washington, DC / maryland", "washington, DC / northern virginia" ] } }, "searchTerm": { "title": "🔎 Search keywords (optional)", "type": "string", "description": "Search titles and descriptions, just like the main Craigslist search box. Try furnished studio or near subway. Leave blank to collect all ads that match your other filters." }, "searchTitlesOnly": { "title": "Search titles only", "type": "boolean", "description": "Apply keywords to titles only. Has an effect only when Search keywords is filled.", "default": false }, "sort": { "title": "↕️ Sort each search by", "enum": [ "date", "dateoldest", "priceasc", "pricedsc", "dist", "rel", "upcoming" ], "type": "string", "description": "Order results within each city, subarea or URL. Multiple searches are interleaved, not globally sorted. Use Relevance with search keywords. Upcoming follows advertised dates/open houses, not move-in availability. Nearest uses the ZIP or city center and, if omitted, a 60-mile radius.", "default": "date" }, "rentPeriods": { "title": "📅 Rental periods (default: monthly only)", "type": "array", "description": "Default: monthly. Add daily or weekly for short-term offers, or clear all selections for any period. 💡 Rent keeps its advertised period; daily and weekly prices are not converted to monthly amounts.", "items": { "type": "string", "enum": [ "monthly", "weekly", "daily" ], "enumTitles": [ "Monthly", "Weekly", "Daily" ] }, "default": [ "monthly" ] }, "maxItems": { "title": "📊 Maximum rental ads — total", "minimum": 1, "type": "integer", "description": "Your main quantity setting: the maximum number of unique rental ads to save across all selected cities, subareas or URLs. Fewer ads may match your search. Exact bathroom filtering happens before this limit; notice rows do not count.", "default": 50 }, "includeDetails": { "title": "📝 Include rental details and public contacts", "type": "boolean", "description": "Default: on. Include descriptions, photo URLs, bathrooms, rental periods, amenities and contacts visible in the public ad. Turn off for search fields only. 💡 Individual listing URLs and decimal bathroom filters always collect details.", "default": true }, "startUrls": { "title": "Rental search or listing URLs (optional)", "type": "array", "description": "Paste apa (apartments), roo (rooms) or sub (sublets) search URLs, /search/area/ URLs, or individual rental ads. 💡 URLs replace guided locations, category and filters, including the default monthly rent filter. Quantity limits, detail collection and repeat-run settings still apply. Use userData.label to name an input.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "minRent": { "title": "Minimum advertised rent", "minimum": 0, "type": "integer", "description": "Minimum USD amount for the selected rental periods. Leave blank for no lower bound." }, "maxRent": { "title": "Maximum advertised rent", "minimum": 0, "type": "integer", "description": "Maximum USD amount for the selected rental periods. Daily and weekly prices are not monthly equivalents." }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Whole bedrooms. Use 0 for studios; leave blank for no lower bound." }, "maxBedrooms": { "title": "Maximum bedrooms", "minimum": 0, "type": "integer", "description": "Use 0 to limit results to studios. Leave blank for no upper bound." }, "minBathrooms": { "title": "Minimum bathrooms", "minimum": 0, "type": "number", "description": "Supports half baths such as 1.5. Decimal values require details and can increase request count." }, "maxBathrooms": { "title": "Maximum bathrooms", "minimum": 0, "type": "number", "description": "Supports half baths. Set both bathroom bounds to 1.5 for exactly 1.5 baths." }, "minArea": { "title": "Minimum floor area (sq ft)", "minimum": 0, "type": "integer", "description": "Advertised floor area in square feet. Leave blank for no lower bound." }, "maxArea": { "title": "Maximum floor area (sq ft)", "minimum": 0, "type": "integer", "description": "Advertised floor area in square feet. Leave blank for no upper bound." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Choose one or more options. Options within this field are OR; different filter fields are combined with AND. Empty means any.", "items": { "type": "string", "enum": [ "apartment", "condo", "cottage_cabin", "duplex", "flat", "house", "in_law", "loft", "townhouse", "manufactured", "assisted_living", "land" ], "enumTitles": [ "Apartment", "Condo", "Cottage / cabin", "Duplex", "Flat", "House", "In-law", "Loft", "Townhouse", "Manufactured", "Assisted living", "Land" ] } }, "laundryTypes": { "title": "Laundry", "type": "array", "description": "Choose one or more options. Options within this field are OR; different filter fields are combined with AND. Empty means any.", "items": { "type": "string", "enum": [ "in_unit", "in_building", "on_site", "hookups", "none" ], "enumTitles": [ "Washer/dryer in unit", "Laundry in building", "Laundry on site", "Washer/dryer hookups", "No laundry on site" ] } }, "parkingTypes": { "title": "Parking", "type": "array", "description": "Choose one or more options. Options within this field are OR; different filter fields are combined with AND. Empty means any.", "items": { "type": "string", "enum": [ "carport", "attached_garage", "detached_garage", "off_street", "street", "valet", "none" ], "enumTitles": [ "Carport", "Attached garage", "Detached garage", "Off-street parking", "Street parking", "Valet", "No parking" ] } }, "privateRoom": { "title": "Private room (rooms / sublets only)", "type": "boolean", "description": "Require a private room in Rooms & shares or Sublets & temporary. Off means no restriction, not shared rooms only. This filter is not offered for Apartments / housing for rent.", "default": false }, "privateBath": { "title": "Private bathroom (rooms / sublets only)", "type": "boolean", "description": "Require a private bathroom in Rooms & shares or Sublets & temporary. Off means no restriction. This describes private versus shared use, not the number of bathrooms.", "default": false }, "catsAllowed": { "title": "Cats allowed", "type": "boolean", "description": "Require ads marked “cats allowed” by the poster. Off means no restriction; it does not mean the amenity is absent.", "default": false }, "dogsAllowed": { "title": "Dogs allowed", "type": "boolean", "description": "Require ads marked “dogs allowed” by the poster. Off means no restriction; it does not mean the amenity is absent.", "default": false }, "furnished": { "title": "Furnished", "type": "boolean", "description": "Require ads marked “furnished” by the poster. Off means no restriction; it does not mean the amenity is absent.", "default": false }, "noSmoking": { "title": "No smoking", "type": "boolean", "description": "Require ads marked “no smoking” by the poster. Off means no restriction; it does not mean the amenity is absent.", "default": false }, "wheelchairAccessible": { "title": "Wheelchair accessible", "type": "boolean", "description": "Require ads marked “wheelchair accessible” by the poster. Off means no restriction; it does not mean the amenity is absent.", "default": false }, "airConditioning": { "title": "Air conditioning", "type": "boolean", "description": "Require ads marked “air conditioning” by the poster. Off means no restriction; it does not mean the amenity is absent.", "default": false }, "evCharging": { "title": "EV charging", "type": "boolean", "description": "Require ads marked “ev charging” by the poster. Off means no restriction; it does not mean the amenity is absent.", "default": false }, "noApplicationFee": { "title": "No application fee (apartments only)", "type": "boolean", "description": "Require ads marked “no application fee” by the poster. Off means no restriction; it does not mean the amenity is absent. Available for apartments (apa) only; clear this option when collecting rooms or sublets.", "default": false }, "noBrokerFee": { "title": "No broker fee (apartments only)", "type": "boolean", "description": "Require ads marked “no broker fee” by the poster. Off means no restriction; it does not mean the amenity is absent. Available for apartments (apa) only; clear this option when collecting rooms or sublets.", "default": false }, "availability": { "title": "Advertised availability", "enum": [ "any", "within_30_days", "beyond_30_days" ], "type": "string", "description": "Use Craigslist’s within/beyond 30-day availability filter. The posted move-in date may be missing or outdated. This does not verify that a unit is still available.", "default": "any" }, "postalCode": { "title": "US ZIP code (optional)", "pattern": "^$|^[0-9]{5}$", "type": "string", "description": "Center all guided searches on this ZIP. For independent locations use separate rental URLs. Without a radius, ZIP searches use 60 miles." }, "radiusMiles": { "title": "Search radius (miles, optional)", "minimum": 0.1, "type": "number", "description": "Use a radius around the ZIP code or selected city center, with any sort order. Empty means no explicit radius except ZIP/nearest-first searches, which use 60 miles." }, "openHouseDate": { "title": "Open house date (optional)", "type": "string", "description": "Select one advertised open-house date (YYYY-MM-DD). Available for apartments and sublets; not rooms. This is different from the move-in availability filter. Leave blank for any open-house date." }, "hasImage": { "title": "Only ads with photos", "type": "boolean", "description": "Require at least one source photo.", "default": false }, "postedToday": { "title": "Posted today", "type": "boolean", "description": "Use Craigslist’s posted-today filter for each search.", "default": false }, "showDuplicates": { "title": "Show Craigslist duplicate ads", "type": "boolean", "description": "Default: off, keep the newest ad in each duplicate group identified by Craigslist. On includes each distinct posting ID. Reposts or separate ads for one property can still be separate records.", "default": false }, "includeNearby": { "title": "Include nearby-area suggestions", "type": "boolean", "description": "Include nearby-area suggestions returned by Craigslist. ZIP/radius searches already use their requested circle and can cross region boundaries.", "default": false }, "maxItemsPerSearch": { "title": "Maximum ads per city, subarea or URL (optional)", "minimum": 1, "type": "integer", "description": "Leave blank for no additional cap. For example, set 10 to collect up to 10 ads from each city, subarea or URL. The Maximum rental ads — total setting still limits the combined output." }, "newOnly": { "title": "Skip posting IDs collected in earlier runs", "type": "boolean", "description": "Collect posting IDs not delivered by earlier runs of the same search. Only successfully saved ads enter the history. 💡 Price or description edits on the same ID are skipped; a repost with a new ID counts as new.", "default": false }, "watchName": { "title": "Monitoring history name (optional)", "type": "string", "description": "Optional name for a separate monitoring history. Reuse it with the same searches to continue collecting unseen posting IDs. Without a name, each saved Task has its own history. Run only one collection at a time for the same history." } } }, "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 } } } } } } } } } }