README

Amazon for omnisense/omnitrade, through the Creators API - which replaced the Product Advertising API 5 on 2026-05-15 -: a product by its ASIN or its page, a search, and the affiliate link carrying the Associates partner tag.

$gateway = (new AmazonGatewayFactory($http))->create(['partner_tag' => 'mysite-21']);   // $http: the application's HTTP client; none given, the factory makes its own

No framework needed: the package requires omnisense/omnitrade and symfony/http-client. In a Symfony application, the same through the bundle's configuration:

omnitrade:
    gateways:
        amazon:
            factory: amazon
            options:
                client_id: '%env(AMAZON_CREATORS_CLIENT_ID)%'
                client_secret: '%env(AMAZON_CREATORS_CLIENT_SECRET)%'
                partner_tag: '%env(AMAZON_CREATORS_PARTNER_TAG)%'   # mysite-21
                marketplace: www.amazon.fr
                credential_version: '3.2'    # 3.1 North America, 3.2 Europe, 3.3 Far East

$amazon = $registry->get('amazon');
$amazon->affiliateLink('https://www.amazon.fr/Jollein/dp/B0C1234567/ref=sr_1_3');   // https://www.amazon.fr/dp/B0C1234567?tag=mysite-21
$amazon->fetchProduct('B0C1234567');                 // getItems
$amazon->fetchProducts(query: 'tour de lit');        // searchItems, 10 items at most

Without credentials only affiliateLink() is offered (supports(FetchProduct::class) is false): the tag alone writes the link, and the API is opened by Amazon only to accounts with qualified sales. Nothing is bought here: no API lets a site buy for someone.

See the manual, docs/index.md (options, behaviour, errors, what is verified), and docs/creators-api.md for what each read sends and maps. Amazon's programme requires the mention "En tant que Partenaire Amazon, je réalise un bénéfice sur les achats remplissant les conditions requises" near the links, and prices shown with the time they were read (at most 24 hours old).

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by Amazon (Amazon.com, Inc. and its affiliates). It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with the Amazon Associates Program's terms (Associates Program Operating Agreement), for obtaining whatever they require (an account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.