Mercari

App · 20 actions

Read Mercari Shops products, orders, transactions and inquiries; update products and stock, and message buyers. Requires a Japanese Mercari Shops API account.

Actions

ActionWhat it does
Get inquiryGet inquiry from Mercari Shops.
Get orderGet order from Mercari Shops.
Get order transactionGet order transaction from Mercari Shops.
Get productGet product from Mercari Shops.
Get shipping configurationGet shipping configuration from Mercari Shops.
Get shopGet shop from Mercari Shops.
List inquiriesList inquiries from Mercari Shops.
List inquiry messagesList inquiry messages from Mercari Shops.
List order cancellationsList order cancellations from Mercari Shops.
List order shippingsList order shippings from Mercari Shops.
List order transactionsList order transactions from Mercari Shops.
List ordersList orders from Mercari Shops.
List product brandsList product brands from Mercari Shops.
List product categoriesList product categories from Mercari Shops.
List productsList products from Mercari Shops.
List shipping configurationsList shipping configurations from Mercari Shops.
List statesList states from Mercari Shops.
Send order messageSend a message to the buyer on an order transaction.
Update productChange a product’s name, description, price or visibility; other fields stay as they are.
Update stockSet a variant’s absolute stock quantity using its variant ID or shop SKU.

Get inquiry

Get inquiry from Mercari Shops.

Inputs

IdidtextRequired
Id.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "inquiry": {
      "firstOpenedAt": "example",
      "id": "example",
      "lastActivityAt": "example",
      "status": "example"
    }
  }
}

Get order

Get order from Mercari Shops.

Inputs

IdidtextRequired
Id.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "order": {
      "createdAt": "example",
      "id": "example",
      "paidAt": "example",
      "status": "example",
      "totalPrice": 1,
      "updatedAt": "example"
    }
  }
}

Get order transaction

Get order transaction from Mercari Shops.

Inputs

IdidtextRequired
Id.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "orderTransaction": {
      "createdAt": "example",
      "id": "example",
      "paidAt": "example",
      "status": "example",
      "totalPrice": 1,
      "updatedAt": "example"
    }
  }
}

Get product

Get product from Mercari Shops.

Inputs

IdidtextRequired
Id.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "product": {
      "createdAt": "example",
      "description": "example",
      "id": "example",
      "name": "example",
      "price": 1,
      "status": "example",
      "updatedAt": "example",
      "variants": []
    }
  }
}

Get shipping configuration

Get shipping configuration from Mercari Shops.

Inputs

IdidtextRequired
Id.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "productShippingConfiguration": {
      "createdAt": "example",
      "displayId": "example",
      "id": "example",
      "title": "example",
      "type": "example",
      "updatedAt": "example"
    }
  }
}

Get shop

Get shop from Mercari Shops.

Inputs

None.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "shop": {
      "createdAt": "example",
      "description": "example",
      "id": "example",
      "name": "example",
      "shopStatus": "example"
    }
  }
}

List inquiries

List inquiries from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "inquiries": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List inquiry messages

List inquiry messages from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.
Inquiry IDinquiryIdtextRequired
Inquiry ID.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "inquiryMessages": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List order cancellations

List order cancellations from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.
Order transaction IDorderTransactionIdtextRequired
Order transaction ID.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "orderCancellations": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List order shippings

List order shippings from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.
Order transaction IDorderTransactionIdtext
Order transaction ID.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "orderShippings": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List order transactions

List order transactions from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.
Ordered date gteorderedDateGtedate and time
Ordered date gte.
Ordered date ltorderedDateLtdate and time
Ordered date lt.
Updated date gteupdatedDateGtedate and time
Updated date gte.
Updated date ltupdatedDateLtdate and time
Updated date lt.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "orderTransactions": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List orders

List orders from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.
Keywordkeywordtext
Keyword.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "orders": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List product brands

List product brands from Mercari Shops.

Inputs

None.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "productBrands": []
  }
}

List product categories

List product categories from Mercari Shops.

Inputs

None.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "productCategories": []
  }
}

List products

List products from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.
Keywordkeywordtext
Keyword.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "products": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List shipping configurations

List shipping configurations from Mercari Shops.

Inputs

Firstfirstnumber
First.From 1 to 100.
Afteraftertext
After.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "productShippingConfigurations": {
      "edges": [],
      "pageInfo": {
        "endCursor": "example",
        "hasNextPage": false
      }
    }
  }
}

List states

List states from Mercari Shops.

Inputs

None.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "states": []
  }
}

Send order message

Send a message to the buyer on an order transaction.

Inputs

Order transaction IDorder_transaction_idtextRequired
The order transaction ID from List order transactions.
MessagemessagetextRequired
The message to send to the buyer.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "addOrderTransactionMessage": {
      "orderTransaction": {
        "id": "example",
        "messages": []
      }
    }
  }
}

Update product

Change a product’s name, description, price or visibility; other fields stay as they are.

Inputs

Productproduct_idtextRequired
The product to update.
Namenametext
A new product name.
Descriptiondescriptiontext
A new product description.
Price (JPY)pricenumber
The price in Japanese yen.From 300 to 9999999.
Visibilitystatustext
Choose Published to make the product public or Private to hide it.One of: OPENED (Published), UNOPENED (Private).

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "updateProduct": {
      "product": {
        "createdAt": "example",
        "description": "example",
        "id": "example",
        "name": "example",
        "price": 1,
        "status": "example",
        "updatedAt": "example",
        "variants": []
      }
    }
  }
}

Update stock

Set a variant’s absolute stock quantity using its variant ID or shop SKU.

Inputs

Variant IDvariant_idtext
The variant ID from Get product. Fill this or Shop SKU.
Shop SKUsku_codetext
Your unique shop SKU. Fill this or Variant ID.
Stock quantitystock_quantitynumberRequired
The new total quantity, rather than an amount to add.At least 0.

Outputs

dataobject
Mercari response data.
Example output
{
  "data": {
    "updateProductVariant": {
      "productVariant": {
        "id": "example",
        "name": "example",
        "skuCode": "example",
        "stockQuantity": 1
      }
    }
  }
}

On this page