Mercado Libre(メルカドリブレ)が公表している画像要件の下限は500×500pxですが、この数字には注意が必要です。ちょうど500pxの画像は問題なくアップロードでき、警告も出ませんが、画像の幅が800pxを超えないとズーム機能が有効にならないため、知らないうちにズームなしの商品ページになってしまいます。APIのレスポンスにはこの点についての案内は一切ありません。隣の出品者よりコンバージョンが低いのに、その理由に気づけないままになります。
本記事では、Mercado Libreの公式セラー向けドキュメントおよび開発者向けドキュメントに基づき、Mercado Libre 画像要件を整理します。プラットフォーム全体で定められているルール、カテゴリごとに委ねられている部分、そして越境ECセラーがつまずきやすいポイントを扱います。
一目でわかるMercado Libre 画像要件
| 項目 | 要件 | 出典 |
|---|---|---|
| 最小サイズ | 500 × 500 px(「M」バージョン) | 画像の取り扱い |
| 最大サイズ | 1,920 × 1,920 px(「F」バージョン) | 画像の取り扱い |
| それ以上の画像 | 自動的にFバージョンへ縮小 | 画像の取り扱い |
| それ以下の画像 | そのまま維持——プラットフォームは拡大しません | 画像の取り扱い |
| ズーム機能の有効化条件 | 画像の幅が800pxを超える場合、ロールオーバーでズームウィジェットが有効になります | 画像の取り扱い |
| ファイルサイズ上限 | 1枚あたり最大10MB | 画像の取り扱い |
| 形式 | JPG、JPEG、PNG | 画像の取り扱い |
| 色空間 | CMYKよりRGBが強く推奨されます | 画像の取り扱い |
| 商品あたりの画像枚数 | プラットフォーム全体ではなくカテゴリごとに上限が設定されます | 画像の取り扱い / CBT画像FAQ |
| バリエーション画像 | 同じカテゴリの上限にカウントされます | CBT画像FAQ |
| アップロード前の検証 | サイズを確認し余分な背景をトリミングするスマートクロップ検証エンドポイントがあります | 画像の取り扱い |
実務的に落とし込むと:**長辺が1,200〜1,920pxの正方形画像を、RGB・JPG形式・10MB以内で撮影・書き出しします。**この範囲であればズーム閾値を上回り、リサイズの上限を下回り、フォーマット要件もすべて満たせます。
買い手がズームできるかを決めるMercado Libre 画像要件:800px
Mercado Libreの開発者ドキュメントには明確にこう書かれています。幅が800ピクセルを超える画像では、買い手がロールオーバーで拡大して見られるようズームウィジェットが有効になり、アパレルカテゴリでは特に推奨されるとされています。
この一文が持つ売上への影響は、他の仕様項目をすべて合わせたよりも大きいものです。ズーム機能があれば、買い手は質問せずに縫製、仕上げ、印字されたサイズ、素材の質感を確認できます。ズームのない商品ページでは、こうした確認事項がすべて「質問」欄に流れるか、あるいは返品前提の購入につながってしまいます。
重要な違いは次の3つです。
- 500px はプラットフォームが「受け付ける」サイズです。
- 800px はプラットフォームが買い手に拡大鏡を提供するために必要なサイズです。
- 1,920px は上限で、これを超えるとファイルはどのみちリサイズされます。
「これが要件だから」という理由だけで500pxで撮影するのは、このマーケットプレイスで最もよくある自滅的なミスです。ペナルティの通知も、出品品質のフラグも、拒否もありません。ただズーム機能が一度も表示されないだけです。
画像枚数の上限はカテゴリ単位、バリエーション画像もカウントされます
ここが越境ECセラーにとって、再現しにくいエラーの発生源になっています。
商品あたりの画像枚数の上限は、プラットフォーム全体で統一された数字ではなく、カテゴリごとに設定されます。そしてMercado Libre自身の越境貿易FAQによれば、画像はバリエーションとルートのpictures配列の両方からカウントされます。そのため両方に画像を設定すると、アップロードしたギャラリー自体は小さく見えても、実質的な合計枚数がカテゴリの上限を超えることがあります。エラーメッセージは「カテゴリ…の商品は画像X枚を超えることはできません」といった内容で、一見バグのように見えますが、そうではありません。
| 症状 | 実際の原因 | 対処法 |
|---|---|---|
| アップロード枚数が少ないのに「X枚を超える」と表示される | ルートの画像とすべてのバリエーションの画像が合算されている | 公開前に実質的な合計画像数を数える。画像は必要な箇所だけに設定する |
| 以前は問題なかった商品ページが更新に失敗し始めた | そのカテゴリの画像上限が引き下げられた | 現在のカテゴリ制約に照らして公開中の商品ページを再検証する。ギャラリーを減らすか、バリエーションの多い商品を複数の商品ページに分割する |
| 画像を変更していないバリエーション更新で画像上限エラーが出る | バリエーションの部分更新によって他のバリエーションが暗黙的に削除され、新しい構成で制約が再計算された | バリエーション更新は完全な置き換えとして扱う:現在のバリエーションを読み込み、メモリ上で変更し、配列全体をPUTで送り直す |
運用上のルールとしては、公開処理の中に「実質的な合計画像数」をカウントする仕組みを組み込み、API呼び出し前に最も厳しいカテゴリ上限に照らしてチェックすることです。こうしたマーケットプレイスごとの違いがあるため、1つのエクスポート設定をそのままどこでも使い回すのは難しく、同様のパターンはTemu商品画像の要件にも見られます。
拒否ではなく評価が下がるだけ:出品品質は写真をどう見るか
Mercado Libreは出品品質をスコア化し、セラーに公開しています。従来の/health APIは廃止が進んでおり、代わりに/performanceが使われるようになっています。こちらはスコア、レベル、そして未対応のアクションを返します。
レベル名はサイトごとに異なります。CBTではBasic、Standard、Professional、アルゼンチンサイトではBásica、Estándar、Profesional、ブラジルサイトではBásica、Satisfatória、Profissionalと表記されます。
写真はこのスコアの中で独立した評価項目になっており、そのルールの一つに最低画像枚数のチェックがあります。画像が少なすぎる商品ページは「対応待ち」としてマークされ、閲覧数を増やすために画像を追加するよう案内が表示されます。つまり、技術的には要件を満たしているギャラリーであっても、露出が下がることがあります。要件を満たすことは最低限のラインにすぎず、実際の掲載順位を左右するのはこのスコアです。
サイズ表:多くの輸出セラーが見落としがちな要件
アパレル系のドメインでは、Mercado Libreはサイズ表を表の画像ではなく、構造化されたオブジェクトとして扱います。この違いによって、これまでJPEG形式のサイズ表を5枚目の画像として登録してきたセラーがつまずくことになります。
ドキュメントが要求している内容は次の通りです。
- サイズ表はSPECIFIC(セラーが作成)またはBRAND(ブランドが事前に設定)のいずれかです。
- サイズ表は
SIZE_GRID_ID属性で商品に紐付けられ、各バリエーションは対応する行を指すSIZE_GRID_ROW_IDを持つ必要があります。行IDがなければサイズ表を紐付けることはできません。 - サイズ表の名前は一意である必要があり、60文字までという上限があります。また各サイトで翻訳し直すのではなく、サイト間で共通利用されます。
- サイズ表の性別は、商品の性別と一致している必要があります。
- 商品を作成するユーザーは、そのサイズ表を作成したユーザーと同一である必要があります。
- これらのドメインでは商品作成時に、タイトル(最大60文字)、カテゴリ、価格、コンディション、画像、販売条件に加えて、
PACKAGE_WEIGHT、PACKAGE_LENGTH、PACKAGE_WIDTH、PACKAGE_HEIGHTといった梱包サイズの情報も必要になります。
公式が示している目的ははっきりしていて、これを単なる形式的な手続きだと考えている人には特に伝える価値があります。サイズ表が存在する理由は、買い手が正しいサイズを選べるようにし、交換やクレームを減らすためです。構造化されたサイズ表は機械可読で、絞り込みが可能で、買い手が選択する場面で表示されます。表の画像ではこの3つのどれも実現できません。
サイズ表がまだセンチメートルのみ、あるいは米国サイズのみの場合、換算にまつわる落とし穴は国際サイズ換算表で詳しく解説しています。サイズ違いが1注文あたりどれくらいのコストになるかは、返品コスト計算ツールで確認できます。
商品ページがブロックされたり弱くなったりする主な原因
| 原因 | 何が起きるか | 予防策 |
|---|---|---|
| 画像がちょうど500px | アップロードは通るが、ズームなし、警告もなし | 1,200〜1,920pxで書き出す |
| 画像が1,920pxを超える | 自動的にリサイズされる | 上限ちょうどのサイズで書き出し、超えないようにする |
| CMYKファイル | マーケットプレイス上で色味が変わる | 書き出し前にRGBへ変換する |
| ファイルが10MB超 | アップロードが拒否される | 圧縮する。このサイズ帯であればJPG品質80〜90で十分 |
| ルート画像とバリエーション画像が合算される | カテゴリ上限エラー | 公開前に実質的な合計枚数を数える |
| バリエーションの部分更新 | 暗黙の削除、上限の再計算、エラー | 常にバリエーション配列全体をPUTする |
| サイズ表がJPEG画像 | サイズが構造化されておらず、交換が増える | SPECIFICまたはBRANDのサイズ表を作成し、各バリエーションの行を紐付ける |
| 画像枚数が少なすぎる | 出品品質が下がり、露出も下がる | /performanceで画像の評価項目を確認する |
最初に対応すべきこと
ゼロから始めるのではなく、既存のカタログを見直す場合は、この順序で進めることをおすすめします。最初の項目に取り組むだけで、残りの項目に対する投資分も回収できます。
- **800pxを超えるサイズですべての画像を書き出し直します。**一括処理で済み、カタログ全体のズーム機能に即座に効果が出ます。
- 公開中の商品ページごとに実質的な合計画像数をカウントし、現在のカテゴリ上限と照らし合わせます。あと1回の更新でエラーになりそうなものから優先的に修正します。
- アパレル系ドメインのすべての商品ページで、JPEGのサイズ表を構造化サイズ表に変換します。
- **SKUごとに寸法画像を1枚追加します。**サイズ表ではなく、実測した幅・奥行き・高さ、必要に応じて梱包サイズを商品自体に描き込んだ画像です。これは買い手が本来なら質問していたはずの内容にあらかじめ答える画像であり、多くのカタログで完全に欠けている種類の画像でもあります。
4つ目の項目には現実的に3つの方法があります。1つはSKUごとにデザイナーへ依頼する方法で、精度は高いものの規模拡大には向きません。2つ目は一般的な写真編集ソフトで矢印を手描きする方法で、画像を別サイズで書き出し直した瞬間にズレが生じ、ラベルが何もない場所を指すようになってしまいます。3つ目は、そのために作られたソフトウェアを使う方法です。画像内の製品の実際の輪郭に寸法線をスナップさせ、どのサイズにリサイズしても実測値をその線に固定したまま、各マーケットプレイスが求めるサイズで同じ注釈付き画像を書き出せます。ここでAI画像生成ツールとの違いが重要になります。生成ツールは実際に計測されていない、それらしく見える数字を作り出してしまい、マーケットプレイス上ではそれは近道ではなく返品リスクになります。寸法画像を商品ページだけでなく見積書やカタログにも使う場合、再利用できるレイアウトについては仕様書のシナリオで扱っています。
Mercado Libre商品ページのアップロード前チェックリスト
- すべての画像の長辺が1,200〜1,920pxの範囲内
- 色空間がCMYKではなくRGBであることを確認
- 各ファイルが10MB以内、形式はJPG/JPEG/PNGのみ
- ルート画像と全バリエーション画像の合計をカウントし、カテゴリ上限内であることを確認
- バリエーション更新は部分更新ではなく、常に配列全体を送信
- そのカテゴリ専用のヘルプ記事でカテゴリ別の写真ルールを確認済み
- 構造化サイズ表を作成し、各バリエーションを対応する行に紐付け済み
- サイズ表の性別が商品の性別と一致していること、サイズ表を商品公開と同じユーザーが作成していること
- 梱包の重量、長さ、幅、高さを入力済み
- タイトルが60文字以内
- 少なくとも1枚は実測した製品寸法を含む画像がある
- 公開前ではなく公開後に
/performanceで出品品質を確認する
FAQ(よくある質問)
Mercado Libreの商品写真はどのくらいのサイズにすべきですか?
長辺が1,200〜1,920pxの範囲が目安です。公式ドキュメント上の最小サイズは500×500px、受け付け可能な最大サイズは1,920×1,920pxですが、ズームウィジェットを有効にするには画像の幅が800pxを超えている必要があり、1,920pxを超える画像はどのみちリサイズされます。正方形、RGB、10MB以内が条件です。
Mercado Libreの商品ページには何枚まで写真をアップロードできますか?
統一された枚数はなく、上限はカテゴリごとに設定されます。自分のカテゴリの上限を確認してください。また、バリエーションに設定した画像はメインギャラリーの画像と同じ上限にカウントされる点にも注意が必要です。
4枚しか画像をアップロードしていないのに、Mercado Libreが画像上限を超えていると表示するのはなぜですか?
バリエーションの画像もカウントされるためです。ルート配列と各バリエーションの両方に画像を設定している場合、実質的な合計はその合算になります。メインギャラリーに4枚、6つのバリエーションそれぞれに2枚の画像がある商品は、実際には4枚ではなく16枚を送信していることになります。
Mercado Libreはサイズ表を必須としていますか?
アパレル系のドメインでは必須で、画像ではなく構造化されたサイズ表である必要があります。商品にはSIZE_GRID_IDで紐付けられ、各バリエーションにはSIZE_GRID_ROW_IDが必要です。サイズ表の性別は商品の性別と一致している必要があり、サイズ表はその商品を公開するユーザーと同じユーザーが作成していなければなりません。
他のマーケットプレイスですでに使っている画像を使い回せますか?
撮影した写真自体は流用できることが多いですが、書き出し設定はそのまま使えないことがほとんどです。マーケットプレイスごとに最小サイズ、最大サイズ、ズーム閾値、ファイルサイズ上限、カテゴリ別の枚数ルールが異なるため、安全な方法は撮影ごとに高品質なマスター画像を1つ保持し、出荷先ごとに書き出しプリセットを用意することです。1つのフォルダの画像をそのまま全マーケットプレイスに使い回すのは避けるべきです。
