Cómo obtener y configurar la API de Amazon Afiliados (PA API)

Wasabi Team
Wasabi Team

Muchos afiliados obtienen los datos de producto de la mal llamada API de Amazon afiliados, que realmente se llama API de Product Advertising de Amazon (PA API).

Para poder disfrutar de esta API, primero tienes que obtener las credenciales. Una vez las tengas, podrás usarlas en tantos sitios como quieras.

Cómo obtener la API de Amazon Afiliados

Regístrate en el programa de Afiliados de Amazon (si no lo has hecho ya).

Date de alta como usuario de Product Advertising API visitando la URL correspondiente.

IdiomaProduct Advertising API URL
Brasilhttp://associados.amazon.com.br/gp/associates/apply/main.html
Canadáhttps://associates.amazon.ca/gp/flex/advertising/api/sign-in.html
Chinahttps://associates.amazon.cn/gp/advertising/api/detail/main.html
Franciahttps://partenaires.amazon.fr/gp/flex/advertising/api/sign-in.html
Alemaniahttps://partnernet.amazon.de/gp/flex/advertising/api/sign-in.html
Indiahttps://affiliate-program.amazon.in/
Italiahttps://programma-affiliazione.amazon.it/gp/advertising/api/detail/main.html
Japónhttps://affiliate-program.amazon.com/gp/flex/advertising/api/sign-in-jp.html
Méxicohttps://afiliados.amazon.com.mx/gp/advertising/api/detail/main.html
Españahttps://afiliados.amazon.es/gp/flex/advertising/api/sign-in.html
Reino Unidohttps://affiliate-program.amazon.co.uk/
Estados Unidoshttps://affiliate-program.amazon.com/gp/flex/advertising/api/sign-in.html

Visita https://afiliados.amazon.es/ (o la URL del idioma en el que te hayas registrado)

Haz clic en el menú Herramientas → Product Advertising API

API de Amazon Afiliados

Haz clic en el botón de » Gestionar credenciales«.

En la ventana emergente, haz clic en » Continue to Security Credentials«.

PA API

Expande la pestaña de » Claves de acceso (ID de clave de acceso y clave de acceso secreta)» del acordeón.

Aquí podrás ver las claves que ya has creado o podrás crear una nueva pulsando en el botón de » Crear una clave de acceso«.

En la ventana emergente de » Crear una clave de acceso«, haz clic en «Mostrar la clave de acceso» y anota la «ID de clave de acceso» y la «Clave de acceso secreta«, ya que son los datos que Wasabi requerirá para poder conectar con la API de Product Advertising de Amazon. Recomendamos también pulsar «Descargar archivo de claves» para hacer una copia de seguridad de las claves (recuerda guardarlas en un lugar seguro).

Las nuevas claves de API empezaran a funcionar pasadas 48 horas desde su creación. Si las intentas usar antes, podrás conectar, pero no podrás obtener datos de productos.

Nota: recuerda que el máximo de claves activas es de 2, pero puedes usarlas en tantos sitios web como quieras. Recomendamos anotar las claves cuando se crean, así si las necesitas en un futuro, no tendrás que desactivar una clave para poder crear una nueva, ya que podrás reutilizar la antigua.

Cómo configurar la API de Amazon (PA API) en Wasabi Theme

Para configurar Wasabi con el API de Amazon, debes seguir los siguientes pasos:

En el menú de WordPress, haz clic en Wasabi → Integración de afiliados

Haz clic en Ajustes de Amazon

Rellena los siguientes datos:

  • API Key: corresponde a la «ID de clave de acceso» obtenido en el paso anterior.
  • API secret: corresponde a la «Clave de acceso secreta» obtenida en el paso anterior.
  • Associate Tag: es el «ID de seguimiento» creado en el panel de afiliados de Amazon (https://afiliados.amazon.es/home/account/tag/manage).
  • País: es el país donde se buscarán los productos y al que se enlazará desde los enlaces de afiliados generados.
  • Tiempo de expiración de la caché: tiempo (en segundos) que se guardarán en caché las peticiones a la API de Amazon. Con este ajuste aumentamos la velocidad de carga del sitio y reducimos el número de peticiones a la API de Amazon, ajustalo con el valor que mejor se adecue a tu caso, aunque el valor por defecto (86400) suele servir en la mayoría de la ocasiones.
  • Una vez hayas completado todos los datos, pulsa el botón azul de «Publicar» para guardar los cambios.

Errores de conexión con la API de Amazon

Si aparecen errores de conexión a la hora de conectar Wasabi con la API de Amazon, casi siempre se debe a alguno de estos problemas:

⚠️ Siempre aparece «Sin stock», «No hay datos disponibles en la API» o un aviso indicando que se podrían estar aplicando restricciones de uso de la API

Amazon pone unas restricciones iniciales en el uso de la API, no permite «casi» usarla si la cuenta no tiene ventas. Es posible que se estén aplicando limitaciones de uso por este motivo.

Decimos «casi» porque si la cuenta es nueva y no hay ventas, puedes usar más o menos la API pero, si la cuenta es antigua y no genera ventas, directamente, aunque puedas conectar con la API, no te permite obtener información de productos.

Échale un vistazo a la documentación oficial de la API de Amazon, que dice: si no vendes nada en un plazo de 30 días, no puedes obtener ningún dato de la API (aunque te puedas conectar a ella). Por eso tienes que preguntarte: ¿Tengo un mínimo de ingresos por afiliación en esa cuenta de Amazon?

Puedes hacer tú mismo la prueba en:

AWS Paapi5 API scratchpad

Si se aplican restricciones, debería aparecer TooManyRequests.

⚠️ La configuración del proveedor no es válida

Este error puede aparecer por varios motivos:

  • El API Key o el API Secret no son correctos o están desactivados.
  • El Associate Tag no existe o pertenece a otra cuenta diferente a la que se ha usado para dar de alta las claves API.
  • El país configurado en Wasabi no corresponde al país de la cuenta de afiliados.

Soluciones:

  • Revisa que no haya ningún espacio en blanco al inicio o al final de la API Key, API Secret o Associate Tag. Es un error muy común cuando se hace copia pega.
  • ¿Las API Key/Secret son correctas?
  • ¿Las API Key/Secret están activas? Puedes revisar su estado aquí.
  • ¿El Associate Tag es correcto?
  • ¿El Associate Tag está registrado con la misma cuenta con la que está registrado el API Key?
  • ¿El país configurado en Wasabi es el mismo con el que se ha dado de alta el Associate Tag?
  • ¿El servidor de tu página web cumple los requisitos técnicos requeridos por Wasabi? PHP 7.2 o superior con las extensiones mbstring, dom, json, libxml, curl e iconv habilitadas y actualizadas.
  • Si la clave API es muy antigua, es posible que ya no funcione con la nueva conexión con la API. Prueba a crear una nueva API Key/Secret.

Puedes validar tú mismo si la configuración es correcta en:

⚠️ Acabas de crear la API Key pero no funciona

Si acabas de crear la API key, tendrás que esperar hasta 72 horas antes de empezar a utilizarla.

Además, según la documentación oficial de Amazon, el límite de uso inicial permitido por día es de 8640 solicitudes y el límite para cada cuenta se basará en el rendimiento de los ingresos de la API de su producto durante los últimos 30 días.

Sigue leyendo en: