# NAME WebService::DMM - DMM webservice module # SYNOPSIS use WebService::DMM; use Config::Pit; my $config = pit_get('dmm.co.jp', require => { affiliate_id => 'DMM affiliate ID', api_id => 'DMM API ID', }); my $dmm = WebService::DMM->new( affiliate_id => $config->{affiliate_id}, api_id => $config->{api_id}, ); my $response = $dmm->search( %params ); die "Failed to request" unless $response->is_success; for my $item (@{$response->items}) { .... } # DESCRIPTION WebService::DMM is DMM webservice module. DMM[http://www.dmm.com](http://www.dmm.com) is Japanese shopping site. # INTERFACES ## Class Methods ### `WebService::DMM->new(%args) :WebService::DMM` Create and return a new WebService::DMM instance with _%args_. _%args_ must have following parameter: - affiliate\_id Affiliate ID of DMM. Postfix of affliate\_id should be 900-999. - api\_id API ID of DMM. Register your account in DMM and you can get API ID. ## Instance Method ### $dmm->search(%param) _%params_ mandatory parameters are: - operation :Str = "ItemList" - version :Str = "2.00" Version should be '1.00' or '2.00'. - timestamp :Str = current time Time format should be 'Year-Month-Day Hour:Minute:Second' (strftime format is '%Y-%m-%d %T') - site :Str Site, 'DMM.co.jp' or 'DMM.com'. _%param_ optional parameters are: - hits :Int = 20 Number of items - offset :Int = 1 Number of page - sort :Str = "rank" Type of sort, 'rank', '+price', '-price', 'date', 'review'. - service :Str See "SERVICE AND FLOOR" section - floor :Str See "SERVICE AND FLOOR" section - keyword :Str Search keyword. You can use DMM search keyword style. Keyword should be string(not byte sequence). # SERVICE AND FLOOR DMM.com services are: - lod akb48, ske48 - digital bandai, anime, video, idol, cinema, fight - monthly toei, animate, shochikugeino, idol, cinepara, dgc, fleague - digital\_book comic, novel, magazine, photo, audio, movie - pcsoft pcgame, pcsoft - mono dvd, cd, book, game, hobby, kaden, houseware, gourmet - rental rental\_dvd, ppr\_dvd, rental\_cd, ppr\_cd, set\_dvd, set\_cd, comic - nandemo fashion\_ladies, fashion\_mems, rental\_iroiro DMM.co.jp services are: - digital videoa, videoc, nikkatsu, anime, photo - monthly shirouto, nikkatsu, paradisetv, animech, dream, avstation, playgirl, alice, crystal, hmp, waap, momotarobb, moodyz, prestige, jukujo, sod, mania, s1, kmp - ppm video, videoc - pcgame pcgame - doujin doujin - book book - mono dvd, good, anime, pcgame, book, doujin - rental rental\_dvd, ppr\_dvd, set\_dvd # CUSTOMIZE USER AGENT You can specify your own instance of [Furl](http://search.cpan.org/perldoc?Furl) to set $WebService::DMM::UserAgent. $WebService::DMM::UserAgent = Furl->new( your_own_paramter ); # EXAMPLES There are many examples in the "eg/" directory in this distribution. # AUTHOR Syohei YOSHIDA # COPYRIGHT Copyright 2013 - Syohei YOSHIDA # LICENSE This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. # SEE ALSO Official Guide [https://affiliate.dmm.com/api/guide/](https://affiliate.dmm.com/api/guide/)