Skip to main content
Altcraft Docs LogoAltcraft Docs Logo
User guideDeveloper guideAdmin guide
Company siteHelp center
English
  • Русский
  • English
v74
  • v74
  • v73
  • v72
Login
  • User API documentation
  • API interaction
  • Matching
  • Profiles
  • Databases
  • Resources
  • Segments
  • Suppression lists
  • Templates and fragments
  • Campaigns
  • Mailings
  • Automation scenarios
  • Loyalty Programs
  • Promo codes
  • Goals
  • Application push notifications
  • Market
    • Market objects
    • Orders
    • Products and SKU
      • Import products, SKUs and categories
      • Import SKUs and categories
      • Get products list
      • Get SKUs list
      • Delete products
      • Delete SKU
  • Analytic reports
  • SendersDev
  • External datatables queries
  • Objects
  • Miscellaneous
  • Importing the API collection in Postman
  • List of API endpoints
  • SDK
  • Market
  • Products and SKU
  • Get products list
Documentation for version v74

Get products list

Description​

Retrieves a list of products.

Request URL​

Method: POST

https://example.com/api/v1.1/market/products/list

Request parameters​

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
from_idstring"2oDantiaiPtY-b7b41276360564d4"NoThe pointer to the next page. It is taken from the previous request, or passed empty for the first one.
limitint3NoProduct list limit

Request example​

  • JSON
  • XML
{
"token": "abcdefghijklmnqrstuvwxyz",
"from_id": "0014a2feb331ace2.20200124134127",
"limit": 3
}
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<from_id>0014a2feb331ace2.20200124134127</from_id>
<limit>3</limit>
</xml>

Response example​

  • JSON
  • XML
{
"error": 0,
"error_text": "",
"result": [
{
"name": "Xiaomi 11T",
"external_id": "xiaomi_11T",
"sku": [
{
"name": "Xiaomi 11T 256ГБ",
"external_id": "xiaomi_11t_256gb",
},
{
"name": "Xiaomi 11T 128 ГБ",
"external_id": "xiaomi_11t_128gb",
}
]
},
{
"name": "Apple iPhone 13",
"external_id": "iphone_13",
"sku": [
{
"name": "Apple iPhone 13 256GB",
"external_id": "iphone_13_256gb",
},
{
"name": "Apple iPhone 13 128GB",
"external_id": "iphone_13_128gb",
}
]
},
{
"name": "Wireless headphones Xiaomi Mi True Pro",
"external_id": "xiaomi_mi_true_pro",
}
]
}
<xml>
<error>0</error>
<error_text></error_text>
<result>
<name>Xiaomi 11T</name>
<external_id>xiaomi_11T</external_id>
<sku>
<name>Xiaomi 11T 256ГБ</name>
<external_id>xiaomi_11t_256gb</external_id>
</sku>
<sku>
<name>Xiaomi 11T 128 ГБ</name>
<external_id>xiaomi_11t_128gb</external_id>
</sku>
</result>
<result>
<name>Apple iPhone 13</name>
<external_id>iphone_13</external_id>
<sku>
<name>Apple iPhone 13 256GB</name>
<external_id>iphone_13_256gb</external_id>
</sku>
<sku>
<name>Apple iPhone 13 128GB</name>
<external_id>iphone_13_128gb</external_id>
</sku>
</result>
<result>
<name>Wireless headphones Xiaomi Mi True Pro</name>
<external_id>xiaomi_mi_true_pro</external_id>
</result>
</xml>

Response parameters​

ParameterTypeDescription
errorintError code
error_textstringError text
next_from_idstringThe pointer must be passed in the next request to get another piece of data until the output of the result contains 0 lines of history.
resultarrayArray of received data on products and their SKUs
Last updated on Feb 28, 2024
Previous
Import SKUs and categories
Next
Get SKUs list
  • Description
  • Request URL
  • Request parameters
  • Request example
  • Response example
  • Response parameters
© 2015 - 2025 Altcraft, LLC. All rights reserved.