{"id":15563071,"url":"https://github.com/dkam/paapi","last_synced_at":"2025-04-12T05:50:27.454Z","repository":{"id":55640458,"uuid":"207064055","full_name":"dkam/paapi","owner":"dkam","description":"Client library for Amazon's Product Advertising API v5","archived":false,"fork":false,"pushed_at":"2024-08-22T01:09:29.000Z","size":81,"stargazers_count":20,"open_issues_count":0,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-26T01:12:46.787Z","etag":null,"topics":["aws","paa"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dkam.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-08T05:00:34.000Z","updated_at":"2025-03-20T02:44:57.000Z","dependencies_parsed_at":"2024-08-22T02:47:02.901Z","dependency_job_id":null,"html_url":"https://github.com/dkam/paapi","commit_stats":{"total_commits":89,"total_committers":6,"mean_commits":"14.833333333333334","dds":0.0561797752808989,"last_synced_commit":"9297799555b563a8267a4f87f619f49eb334569f"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkam%2Fpaapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkam%2Fpaapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkam%2Fpaapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dkam%2Fpaapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dkam","download_url":"https://codeload.github.com/dkam/paapi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248525153,"owners_count":21118616,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","paa"],"created_at":"2024-10-02T16:17:19.769Z","updated_at":"2025-04-12T05:50:27.426Z","avatar_url":"https://github.com/dkam.png","language":"Ruby","readme":"# Paapi\n\n`paapi` is a slim wrapper around [Amazon's Product Advertising API 5.0](https://webservices.amazon.com/paapi5/documentation/).\n\n[![Build Status](https://travis-ci.org/dkam/paapi.svg?branch=master)](https://travis-ci.org/dkam/paapi)\n\nIf this gem doesn't meet your needs, try the [Vacuum gem](https://github.com/hakanensari/vacuum).\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'paapi'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install paapi\n\n## Usage\n\n### Configuration\n\nThe library can be configured with an initializer. For Rails, create the file `config/initializers/paapi.rb`\n\n```ruby\nPaapi.configure do |config|\n  config.access_key = 'your-access-key'\n  config.secret_key = 'your-secret-key'\n  config.partner_tag = 'your-tag'\nend\n```\n\nConfigurable items:\n * access_key\n * secret_key\n * partner_tag\n * partner_type\n * market\n * partner_market\n * test_mode\n\nUsing the `partner_market` configuration item lets you set a hash of marketplaces and partner_tags.\n\n```ruby\nPaapi.configure do |config|\n  config.access_key = 'your-access-key'\n  config.secret_key = 'your-secret-key'\n  config.partner_market = {au: 'au_partner_tag', us: 'us_partner_tag'}\nend\n\nclient = Paapi::Client.new(market: :au)\n\nclient.partner_tag\n\u003e 'au_partner_tag'\n\nclient.market = :us\n\nclient.partner_tag\n\u003e 'us_partner_tag'\n```\n\nThe full list of market keys is `au, br, ca, fr, de, in, it, jp, mx, es, tr, ae, uk, us`\n\n### Using Paapi\n\n```ruby\nrequire 'paapi'\n\nclient = Paapi::Client.new(access_key: ENV['access_key'], secret_key: ENV['secret_key'], market: :au, partner_tag: ENV['partner_tag'])\n\ngi = client.get_items(item_ids: '1857231384')\n\nsi = client.search_items(keywords: 'Harry Potter')\n\ngv = client.get_variations(asin: 'B00422MCUS')\n```\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nIf you create a file `config.rb`, it will be loaded by `bin/console`, allowing you to configure keys and markets.\n\n```ruby\nPaapi.configure do |config|\n  config.access_key = 'access_key'\n  config.secret_key = 'secret_key'\n  config.partner_market =  {au: 'au_tag', us: 'us_tag', uk: 'uk_tag', ca: 'ca_tag_'}\nend\n```\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/dkam/paapi.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkam%2Fpaapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdkam%2Fpaapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdkam%2Fpaapi/lists"}