メルカリAPIは個人でも利用できるのかを公式情報から解説。メルカリShops APIの料金、商品検索の範囲、アクセストークンと固定IPの設定、PythonによるGraphQL接続例、APIが使えない場合の代替方法とOctoparseの適用条件まで比較します。
メルカリAPIとは、メルカリShopsの商品・在庫・注文などを外部システムから管理するためのGraphQL APIです。普通の個人ユーザーがメルカリ全体の商品を検索するための公式公開APIではありません。 「Personal API Access Token」という名称も、個人向けAPIを意味するものではなく、契約済みショップを識別する認証情報です。
個人が商品検索や価格調査をしたい場合は、まずメルカリ公式の検索・検索条件保存機能を使うのが基本です。法人または個人事業主が自分のショップ業務を自動化する場合はメルカリShops API、許可されたWebデータを表形式で整理したい場合はスクレイピングツールというように、目的と利用権限から方法を選びます。
本記事では、メルカリAPIを個人で使えるかどうかと、事業者向けAPIを分けて説明すると同時に、専門的なスクレイピングツールでメルカリデータを抽出する方法についても詳しく紹介します。
結論として、通常のメルカリアカウントを持つ個人が、全出品をキーワード検索して取得できる公式APIは確認できません。現在公開されているのは主にメルカリShopsの運営業務を自動化するAPIです。
したがって、メルカリAPIを個人が試す目的が「市場にある商品を横断検索すること」であれば、メルカリShops APIを設定しても解決しません。ショップ運営者が自分の業務データを連携する場合に初めて候補になります。
普通の購入者・個人出品者向けには、アプリやWebサイトの検索機能が提供されています。検索条件を保存すると、条件に合う新着商品の通知も受け取れます。しかし、外部プログラムからメルカリ全体の商品を検索するための一般公開された開発者APIとは異なります。
メルカリShopsは法人と個人事業主向けのサービスです。ただし、ショップを開設すれば無条件でPublic APIを自由に利用できるという意味ではありません。API利用契約、権限、許可IP、アクセストークンなど、メルカリ側が定める条件を満たす必要があります。
いいえ。公式ドキュメントのPersonal API Access Tokenは、どのショップがリクエストしたかを識別する店別トークンです。「Personal」という単語だけを見て、普通の個人ユーザー向けAPIキーだと判断しないよう注意してください。
メルカリShops API は、ショップ運営のバックオフィス処理を自動化するGraphQL APIです。自社の在庫管理システムや受注管理システムとの連携に向いています。
自ショップの商品は商品IDやSKUなど、公式スキーマが提供する条件で照会できます。一方、「スニーカー」「カメラ」のようなキーワードで通常のメルカリ全体から他者の商品を取得する公開商品検索APIではありません。検索URLのパラメータやブラウザ内部通信も、公式に外部開発者へ提供されたAPIとは区別する必要があります。
公式リファレンスでは、APIリクエスト単位の従量料金表は確認できません。ただし、これを「誰でも完全無料」と表現するのは不正確です。API利用契約、メルカリShopsの販売手数料、外部の在庫・受注管理サービス料金は分けて確認してください。
メルカリAPIを個人事業主が検討する場合も同様です。API単体の料金だけではなく、ショップ運営と連携システムを含めた総コストで判断します。
料金とRate Limitは改定される可能性があります。導入判断時には公式ドキュメント、利用契約、連携先の見積もりを同じ日付で確認します。
メルカリShops APIを使うには、契約とネットワーク設定を先に整えます。アクセストークンだけを用意しても、未申請IPからのリクエストは404になる場合があります。
トークンをソースコード、共有スプレッドシート、公開Gitリポジトリへ直接書かないでください。また、APIには正しいUser-Agentが必要です。権限を最小限にし、漏えい時に無効化・再発行できる運用を決めます。
メルカリは公式のPython SDKや言語別サンプルライブラリを提供していないため、GraphQLリクエストを自社で実装します。以下は、契約済みショップが自分のショップ情報を照会する最小構成です。
非公式ライブラリを使う場合は、内部仕様の変更で突然動かなくなる可能性、保守状況、認証情報の扱いを確認します。「Pythonで呼べる」ことと「メルカリが外部利用を許諾した公式APIである」ことは同義ではありません。
メルカリAPIを個人がPythonから利用したいという検索需要の中には、公式Shops APIと非公式の商品取得コードが混在しています。コードを実行する前に、対象APIの提供者、許諾範囲、取得対象を確認してください。
一方、正式なシステム連携ではAPIの構造化データ、認証、Webhook、変更履歴が大きな利点です。目的を満たす公式APIがあるのに、無理にWebページから取得する必要はありません。
一般の商品検索APIがない場合でも、目的によって代替方法は異なります。個人の購入目的なら公式検索、ショップ運営なら公式API、許諾を得た市場調査なら自作処理やデータ収集ツールを比較します。
メルカリスクレイピング を検討する場合も、「公開表示されているから自由に取得できる」とは判断できません。技術方式より先に、規約、権利、アクセス頻度、取得後の用途を確認します。
メルカリAPIを使いたい」という方でも、実際の目的が 商品名・価格・URL・商品状態などを一覧で取得し、価格調査や商品リサーチに活用すること であれば、必ずしもAPIにこだわる必要はありません。
メルカリShops APIは、自ショップの商品・在庫・注文管理には便利ですが、一般のメルカリ商品を検索して市場調査するためのAPIではありません。また、利用には契約条件の確認や固定IP、アクセストークン、GraphQLの実装などが必要です。
こうした場合の選択肢の一つが、 ノーコードWebスクレイピングツールの Octoparse です。
Octoparseには メルカリ向けの専用テンプレート が用意されており、「キーワードから商品一覧を取得したい」「商品URLから詳細情報をまとめたい」といった目的に合わせてテンプレートを選択できます。URLや検索条件を入力して実行するだけなので、一からPythonコードやスクレイピングフローを作成する必要はありません。
商品名・価格・URL・カテゴリー・商品状態・画像などの情報をまとめて取得し、CSVやExcelなどへ整理できるため、 中古相場の調査、競合商品の比較、価格分析、商品リサーチ といった用途にも活用できます。
また、定期的に価格や出品状況を確認したい場合は、対応プランのクラウド実行やスケジュール収集を利用できます。PCを常時起動しておく必要がなく、毎回同じ検索と転記作業を繰り返す手間を減らせます。
さらにOctoparseは MCP にも対応しています。ChatGPTやClaudeなどのAIから、
「メルカリで中古iPhoneの商品データを取得して、価格帯ごとに整理して」といった自然言語で指示し、 データ収集 → 整理 → 比較 → 要約・分析 までを一つのワークフローにつなげることもできます。
社内システムや既存の業務フローと連携したい場合はOctoparse OpenAPIも利用できるため、まずはノーコードで収集を始め、必要に応じてAIやAPIを使った自動化へ拡張できます。
ただし、Octoparseは対象データの利用許諾を与えるサービスではありません。メルカリの利用規約や権利、アクセス方法、取得後の利用目的を確認したうえで利用してください。
Octoparseにはメルカリ 向けの専門テンプレートがあります。商品URLを入力し、商品名、価格、在庫状況、カテゴリー、状態、配送、画像、説明などを同じ列へ整理する設計です。
https://www.octoparse.jp/template/mercari-url-based-product-listing-scraper
https://www.octoparse.jp/template/mercari-keyword-product-listings-scraper
https://www.octoparse.jp/template/mercari-product-detail-URL-scraper-cloud
Octoparseのアカウントを作成し、デスクトップアプリへログインします。Freeプランから始める場合、クレジットカードなしで基本的なローカル抽出を試せます。
ホーム画面のテンプレート検索欄へ「メルカリ」と入力します。目的に合わせるテンプレートを選択します。
選択したテンプレートの入力欄へ、各フィールドを入力します。
入力内容を確認して「実行」をクリックします。ローカル収集に対応するタスクなら自分のPCで実行でき、少量の検証に向きます。クラウド収集に対応するテンプレートでは、Octoparseのサーバー上で処理でき、PCを閉じても大規模収集や定期実行を続けられます。
取得したデータを確認し、問題がなければデータをエクスポートできます。
競合情報も営業リストも、ウェブデータをそのままExcel・CSV・Google Sheetsに出力
コード不要、誰でも今日から。クリック操作だけで必要な項目を自動抽出
Google Maps・食べログ・iタウンページ向けテンプレートで、リード獲得をすぐに開始
クラウドで毎日・毎週自動実行。大量取得でも安定して、競合動向を常に把握
MCP対応でAIエージェントと連携。収集データをAIに渡して分析・活用まで一気通貫
クレジットカード不要で無料スタート。世界600万人以上が選んだ信頼のツール
Webスクレイピングという技術が一律に違法というわけではありませんが、対象サービスの利用規約、著作権、個人情報、アクセス方法、取得後の利用によって判断が変わります。メルカリの商品データを扱う場合は、少なくとも次の点を確認します。
robots.txtに許可の記載がないことは、自動取得や二次利用の許諾を意味しません。判断が難しい商用・大規模案件では、実行前にメルカリへの確認や法務・専門家への相談を行ってください。本記事は一般的な技術情報であり、個別案件への法的助言ではありません。
普通の個人ユーザー向けに、全商品を検索できる公式公開APIは確認できません。メルカリShops APIは契約済みショップ向けで、法人や個人事業主などが利用条件を確認して導入します。
はい、可能です。たとえば OctoparseのMCP 機能を使えば、ChatGPTやClaudeなどのAIと接続し、自然言語で指示するだけでメルカリの商品データ収集を実行できます。
たとえば「メルカリで特定キーワードの商品を取得して、商品名・価格・URLを一覧化して」とAIに指示すると、Octoparse側でデータ収集を行い、その後AIで価格比較、重複整理、要約、分析まで続けることができます。メルカリ向けの専用テンプレートも利用できるため、PythonコードやAPI設定を一から用意する必要がありません。
そのため、AI単体でWebページを読むというより、AI＋Octoparseを組み合わせて、収集から分析までを一連のワークフローとして実行する使い方が実用的です。
メルカリShops APIで自ショップの商品を照会できますが、一般のメルカリ全体から他者の商品をキーワード検索する公式公開APIではありません。
利用条件を満たすショップは、PythonのrequestsなどからGraphQL APIへ接続できます。公式Python SDKはないため、認証、Query、ページング、エラー処理を自社で実装します。
非公式APIやライブラリはメルカリの公開開発者APIではありません。利用規約、データの取得元、認証情報、保守状況、料金、二次利用条件を確認し、公式APIと混同しないでください。
いいえ。Octoparse（オクトパース・オクトパス）はデータ抽出を設定するツールであり、対象データの利用許諾を与えるサービスではありません。対象ページ、取得方法、利用目的について規約と権利を確認し、制限の回避を前提にしないでください。
この記事では、 メルカリAPIは個人でも使えるかとその代替ツール について詳しく紹介しました。メルカリAPIを個人で使いたいと考えたとき、最初に確認すべきなのはAPIキーの取得方法ではなく、目的に合う公式APIが存在するかです。一般の商品検索向け公式APIは確認できず、メルカリShops APIは契約済みショップの商品・在庫・注文管理を主目的としています。
つまり、メルカリAPIを個人が利用できるかという問いへの答えは、「普通の個人向け商品検索APIはない。個人事業主としてショップを運営し、所定の条件を満たす場合はShops APIを検討できる」です。
個人が商品を探すなら公式検索と検索条件保存、ショップ業務を自動化するなら公式API、許可されたWebデータをノーコードで整理するなら Octoparse というように使い分けます。API、Python、スクレイピングのどれを選ぶ場合も、取得できるかだけでなく、取得してよいか、何に利用してよいかまで確認することが継続運用の前提です。