Craigler

Search API for craigslist

SYNOPSIS:

I couldn’t decide which API I liked best, so you have two choices.

Craigler.search(:motorcycles, :in => [:utah, :nevada, :arizona], :for => 'Boulevard M50') do |item|
  puts item.title
  puts item.url
  puts item.time
end

Craigler.find('Boulevard M50', :in => :california, :only => :motorcycles) do |item|
  puts item.title
  puts item.url
  puts item.time
end

You can also create a search object to fetch the results later. When no location or category is given Craigler searches :all_for_sale_or_wanted :in => :anywhere

search = Craigler::Search.new('Yamaha')
search.results()

Note that additional calls to search.results() will always return the same result set unless refresh is forced

search.results(:refresh => true)

See Craigler::Search for a list of all available options

Supported Categories

:all_for_sale_or_wanted, :art_and_crafts, :auto_parts, :baby_and_kid_stuff, :barter, :bicycles, :boats, :books, :business, :cars_and_trucks, :clothing, :collectibles, :community, :computers_and_tech, :electronics, :event, :farm_and_garden, :free_stuff, :furniture, :games_and_toys, :garage_sales, :general, :gigs, :household, :housing, :items_wanted, :jewelry, :jobs, :materials, :media, :motorcycles, :musical_instruments, :personals, :photo_and_video, :recreational_vehicles, :resume, :services_offered, :sporting_goods, :tickets, :tools

Supported Locations

States

:alaska, :arizona, :arkansas, :california, :colorado, :connecticut, :delaware, :dc, :florida, :georgia, :hawaii, :idaho, :illinois, :indiana, :iowa, :kansas, :kentucky, :louisiana, :maine, :maryland, :mass, :michigan, :minnesota, :mississippi, :missouri, :montana, :nebraska, :nevada, :n_hampshire, :new_jersey, :new_mexico, :new_york, :n_carolina, :north_dakota, :ohio, :oklahoma, :oregon, :pennsylvania, :rhode_island, :s_carolina, :south_dakota, :tennessee, :texas, :utah, :vermont, :virginia, :washington, :west_virginia :wisconsin, :wyoming

Cities

Alabama

:auburn,:bham,:columbusga,:dothan,:shoals,:gadsden,:huntsville,:mobile,:montgomery,:tuscaloosa,

Alaska

:anchorage,

Arizona

:flagstaff,:mohave,:phoenix,:prescott,:sierravista,:tucson,:yuma,

Arkansas

:fayar,:fortsmith,:jonesboro,:littlerock,:memphis,:texarkana,

California

:sfbay,:bakersfield,:chico,:fresno,:goldcountry,:humboldt,:imperial,:inlandempire, :losangeles,:mendocino,:merced,:modesto,:monterey,:orangecounty,:palmsprings,:redding, :reno,:sacramento,:sandiego,:slo,:santabarbara,:stockton,:ventura,:visalia,:yubasutter,

Colorado

:boulder,:cosprings,:denver,:fortcollins,:pueblo,:rockies,:westslope,

Connecticut

:newlondon,:hartford,:newhaven,:nwct,

Delaware

:delaware,

Dc

:washingtondc,

Florida

:daytona,:keys,:fortmyers,:gainesville,:jacksonville,:lakeland,:ocala,:orlando, :panamacity,:pensacola,:sarasota,:miami,:spacecoast,:staugustine,:tallahassee,:tampa,:treasure,

Georgia

:athensga,:atlanta,:augusta,:brunswick,:columbusga,:macon,:savannah,:valdosta,

Hawaii

:honolulu,

Idaho

:boise,:eastidaho,:pullman,:spokane,:twinfalls,

Illinois

:bn,:carbondale,:chambana,:chicago,:decatur,:peoria,:quadcities,:rockford,:springfieldil,:stlouis,

Indiana

:bloomington,:evansville,:fortwayne,:indianapolis,:tippecanoe,:muncie,:southbend,:terrahaute,

Iowa

:ames,:cedarrapids,:desmoines,:dubuque,:iowacity,:omaha,:quadcities,:siouxcity,:waterloo,

Kansas

:kansascity,:lawrence,:ksu,:topeka,:wichita,

Kentucky

:bgky,:cincinnati,:huntington,:lexington,:louisville,:westky,

Louisiana

:batonrouge,:lafayette,:lakecharles,:monroe,:neworleans,:shreveport,

Maine

:maine,

Maryland

:annapolis,:baltimore,:easternshore,:smd,:westmd,

Mass

:boston,:capecod,:southcoast,:westernmass,:worcester,

Michigan

:annarbor,:centralmich,:detroit,:flint,:grandrapids,:jxn,:kalamazoo,:lansing, :muskegon,:nmi,:porthuron,:saginaw,:southbend,:swmi,:up,

Minnesota

:duluth,:fargo,:mankato,:minneapolis,:rmn,:stcloud,

Mississippi

:gulfport,:hattiesburg,:jackson,:memphis,:northmiss,

Missouri

:columbiamo,:joplin,:kansascity,:semo,:springfield,:stlouis,

Montana

:montana,

Nebraska

:grandisland,:lincoln,:omaha,:siouxcity,

Nevada

:lasvegas,:reno,

N hampshire

:nh,

New jersey

:cnj,:jerseyshore,:newjersey,:southjersey,

New mexico

:albuquerque,:farmington,:lascruces,:roswell,:santafe,

New york

:albany,:binghamton,:buffalo,:catskills,:chautauqua,:elmira,:hudsonvalley,:ithaca, :longisland,:newyork,:plattsburgh,:rochester,:syracuse,:utica,:watertown,

N carolina

:asheville,:boone,:charlotte,:eastnc,:fayetteville,:greensboro,:hickory,:outerbanks, :raleigh,:wilmington,:winstonsalem,

North dakota

:fargo,:nd,

Ohio

:akroncanton,:athensohio,:cincinnati,:cleveland,:columbus,:dayton,:huntington,:limaohio, :mansfield,:parkersburg,:sandusky,:toledo,:wheeling,:youngstown,

Oklahoma

:fortsmith,:lawton,:oklahomacity,:stillwater,:tulsa,

Oregon

:bend,:corvallis,:eastoregon,:eugene,:medford,:oregoncoast,:portland,:roseburg,:salem,

Pennsylvania

:altoona,:erie,:harrisburg,:lancaster,:allentown,:philadelphia,:pittsburgh,:poconos, :reading,:scranton,:pennstate,:williamsport,:york,

Rhode island

:providence,

S carolina

:charleston,:columbia,:florencesc,:greenville,:hiltonhead,:myrtlebeach,

South dakota

:sd,

Tennessee

:chattanooga,:clarksville,:jacksontn,:knoxville,:memphis,:nashville,:tricities,

Texas

:abilene,:amarillo,:austin,:beaumont,:brownsville,:collegestation,:corpuschristi,:dallas, :elpaso,:galveston,:houston,:killeen,:laredo,:lubbock,:mcallen,:odessa,:sanantonio, :sanmarcos,:texarkana,:easttexas,:victoriatx,:waco,:wichitafalls,

Utah

:logan,:ogden,:provo,:saltlakecity,:stgeorge,

Vermont

:burlington,

Virginia

:blacksburg,:charlottesville,:danville,:easternshore,:fredericksburg,:norfolk,:harrisonburg, :lynchburg,:richmond,:roanoke,

Washington

:bellingham,:kpr,:olympic,:pullman,:seattle,:skagit,:spokane,:wenatchee,:yakima,

West virginia

:charlestonwv,:huntington,:martinsburg,:morgantown,:parkersburg,:wv,:wheeling,

Wisconsin

:appleton,:duluth,:eauclaire,:greenbay,:janesville,:racine,:lacrosse,:madison, :milwaukee,:sheboygan,:wausau

Or use :in => :anywhere to search all supported locations.

REQUIREMENTS:

Hpricot

INSTALL:

sudo gem install quixoten-craigler