Recursos

Los más vendidos de Amazon

La misma lista de «Sugeridos» del panel: productos de Amazon con buena venta que Automeli ya filtró para Mercado Libre. Sirve para elegir qué publicar; el asin de cada producto es el sku que se manda a POST /v2/products.

Listar los más vendidos

GET/v2/bestsellers

scopeproducts:read

RequestGET /bestsellers

curl "https://api.automeli.com/api/v2/bestsellers?price_max=40&rating_min=4.5&limit=50" \
     -H "X-API-Key: automeli_live_..."

200Response

Página de productos por score (0-100). price en la unidad mayor de currency. already_published: real = ya publicado en su cuenta real, queued = en cola en un job activo hacia la cuenta real, test = publicado o en cola en prueba, null = no lo tiene.

{
  "data": [
    {
      "asin": "B0CGRTY4ZK",
      "title": "Spring Chef Stainless Steel 8 Magnetic Measuring Spoons Set, Winter Frost",
      "brand": "Spring Chef",
      "image_url": "https://images-na.ssl-images-amazon.com/images/I/81u32Lpa4nL._SL300_.jpg",
      "amazon_url": "https://www.amazon.com/dp/B0CGRTY4ZK",
      "price": 9.95,
      "currency": "USD",
      "weight_grams": 230,
      "weight_lb": 0.51,
      "bsr_rank": 99,
      "monthly_sold": 1000,
      "rating": 4.9,
      "review_count": 50076,
      "offer_count_new": 1,
      "category": { "id": 1055398, "name": "Home & Kitchen" },
      "score": 98,
      "publisher_count": 0,
      "already_published": null
    }
  ],
  "next_cursor": "eyJsYXN0X3ZhbCI6OTgsImFzX29mIjoiMjAyNi0xMC0xOVQwNzoxMDowMS4wMDBaIiwibGFzdF9pZCI6IkIwQ0dSVFk0WksiLCJmaWx0ZXJzX2hhc2giOiIzYTFmOWMyZCJ9",
  "has_more": true,
  "count": 1,
  "source": "us",
  "amazon_site": "amazon.com",
  "currency": "USD",
  "data_as_of": "2026-10-19T07:10:01.000Z",
  "source_fallback": false
}

El orden es fijo, por score (0 a 100) de mayor a menor, y se pagina con cursor. En el panel la misma lista sale mezclada al azar en cada consulta, así que el orden no coincide. La lista se recalcula una vez al día (data_as_of): si eso pasa mientras pagina, la siguiente página responde 409 E_CURSOR_STALE y hay que empezar de nuevo sin cursor.

Lo que la cuenta ya tiene no se quita de la lista: cada producto trae already_published con real (publicado en la cuenta real), queued (en cola en un job activo hacia la cuenta real), test (publicado o en cola en prueba) o null (no lo tiene). Si aparece en más de uno, se informa en ese orden. publisher_count dice cuántas cuentas de Automeli ya lo publican en el país de Mercado Libre de la suya; con publisher_count_max se descartan los más repetidos.

Es lectura: no gasta créditos ni la cuota diaria de Sugeridos del panel, y responde lo mismo con una key live o test. Un filtro que casi no coincide con ningún producto (por ejemplo monthly_sold_min muy alto) puede tardar unos segundos; si pasa del tope responde 503 E_PRODUCT_LIST_TIMEOUT y conviene aflojar el filtro.

Errores posibles de este endpoint (4)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_PRODUCT_INVALID_PARAM

Parámetro de query o path inválido (fecha, UUID, estado fuera de rango). Sólo v2; en v1 estos casos devuelven E_PRODUCT_INVALID_BODY

422

E_CURSOR_STALE

Sólo v2 (GET /bestsellers): la lista se recalculó desde que empezó a paginar. Pida de nuevo la primera página, sin cursor

409

E_PRODUCT_LIST_TIMEOUT

Sólo v2 (GET /products): la consulta superó su tope de tiempo. Trae Retry-After: 30; reintente una sola vez y, si se repite, quite sort_by, use un término más general o busque por sku o listing_id exactos

503

Categorías

Las categorías raíz de Amazon de la lista, con cuántos productos tiene cada una. El id es el valor de category_id en GET /v2/bestsellers.

GET/v2/bestsellers/categories