Main product photo upload

Accepted formats: JPG, PNG, GIF.

Restrictions:

  • •
    Size no less than 1280×720 px.
  • •
    Sum of the height and width is no more than 14,000 pixels.
  • •
    File size is no more than 50 MB.
  • •
    Aspect ratio is at least 1:20.

Getting the address

To get the address to upload a photo of a collection, call the photos.getMarketAlbumUploadServer method.

Request

Shell
curl 'https://api.vk.ru/method/photos.getMarketAlbumUploadServer' \ -F 'access_token=vk1.a.WLR8Mw9LSzb5_TucZMoGsEMUXg3WLhpL7hOO29l7oTTSN8APMYTtbndugdcQGVfUe3DlmiBdTvw3R-FormClSDmxCGrlZ0cmfnaKeBscp1TbKs2M3Y9BE5f4lgZwsP3kwEoj-u-SCb9Kk9k9SAQ1MKNljA3jH53w1u2fMTVQ9DspxlzHurs7PuAidjH1_PsUJDRpyCbslvIekpeLYVAa9w' \ -F 'group_id=218252175' \ -F 'v=5.131'

Response

JSON
{ "response":{ "upload_url":"https:\/\/pu.vk.com\/c855312\/ss2189\/upload.php?_query=eyJhY3QiOiJtYXJrZXRfYWxidW0iLCJnaWQiOjIxODI1MjE3NSwiYWlkIjotNTMsImFwaV91cGxvYWQiOjEsImFwaV93cmFwIjp7InNlcnZlciI6OTk5LCJwaG90byI6IntyZXN1bHR9IiwiZ2lkIjoyMTgyNTIxNzUsImhhc2giOiI5MmMyZDgxMzE3NzgzODMyMTM3NTBjZDYwM2I4N2EzZSJ9LCJtaWQiOjc0Mzc4NDQ3NCwic2VydmVyIjo4NTUzMTIsIl9vcmlnaW4iOiJodHRwczpcL1wvYXBpLnZrLmNvbSIsIl9zaWciOiIxYTUwZTc1OWUzOGUxMjdmOTU2MmFjZDlhNTYyNDNhZCJ9" } }

Sending files

Request

To send files, use:

  • •
    The upload_url address from the Getting the address section.
  • •
    The POST HTTP verb.
  • •
    The file field.
  • •
    The multipart/form-data HTTP format.
Shell
curl -F 'file=@<FULL_PATH_TO_PHOTO>' '<UPLOAD_URL>'

Note. To send a valid request, remove the escape character (\) from the upload_url parameter.

Request example:

Shell
curl -F 'file=@/Users/persik/Downloads/image1.png' \ 'https://pu.vk.com/c855312/ss2189/upload.php?_query=eyJhY3QiOiJtYXJrZXRfYWxidW0iLCJnaWQiOjIxODI1MjE3NSwiYWlkIjotNTMsImFwaV91cGxvYWQiOjEsImFwaV93cmFwIjp7InNlcnZlciI6OTk5LCJwaG90byI6IntyZXN1bHR9IiwiZ2lkIjoyMTgyNTIxNzUsImhhc2giOiI5MmMyZDgxMzE3NzgzODMyMTM3NTBjZDYwM2I4N2EzZSJ9LCJtaWQiOjc0Mzc4NDQ3NCwic2VydmVyIjo4NTUzMTIsIl9vcmlnaW4iOiJodHRwczpcL1wvYXBpLnZrLmNvbSIsIl9zaWciOiIxYTUwZTc1OWUzOGUxMjdmOTU2MmFjZDlhNTYyNDNhZCJ9'

Response

After a successful upload, the server will return a JSON object:

Field
Type
Description
server
integer
ID of the server to which the photo was uploaded.
photo
string
Information about the uploaded photo.
gid
integer
ID of the community with the product collection of the uploaded photo.
hash
string
Photo hash.

Response example:

JSON
{ "server":999, "photo":"eyJwaG90byI6IntcInBob3RvXCI6XCJkOGRjYTQ0MzI0OnlcIixcInNpemVzXCI6W10sXCJraWRcIjpcIjYzMzM5YmNlOWFhNzExMGIxMTg3MDlkMjA4ZjRmNjA1XCIsXCJkZWJ1Z1wiOlwieHl5XCIsXCJzaXplczJcIjpbW1wic1wiLFwiY2Q3ZTkyMzhjMmM5ODY3NWQwOTgzOTY5YjEwOTdmNzczOTNkZTM5NjQ5YzIwNGEwZTkyMDI0ZGVcIixcIi0zMDYwNjg5MzU4OTc4MTM0MzU5XCIsMTQ1LDk2XSxbXCJtXCIsXCJlOWFjNGFhZjdjYzBmNmZhMjAwYzEwZmU2Mjk2YWI3NDA5YTcxMjBjNDY5ZTdjZTNlNzE0MWZjMFwiLFwiMTYyODA2MjA2NzIyNzAxNTgyXCIsMjkwLDE5M10sW1wieFwiLFwiMzgxMGJjZGNhZTBiM2ExOTdiNWU4MzdjN2Q2ZWMzN2YwN2JjNDA5N2FhYzY2ZTA3NzliMTNiNmJcIixcIjQ4MDY1MDA5ODEzMDA4NjMzNDRcIiw1ODAsMzg2XSxbXCJ5XCIsXCJmNjc3N2I1ZmIxZTJjZDI1ODNkNjgzOWFmY2NhNThhMWRiZTdmYTkzYTM5NDI4YjcxNDg3ZDMzZFwiLFwiNDE0NTAyNTY5NjgyNjc2NzE4NlwiLDk2Miw2NDBdXSxcInVybHNcIjpbXSxcInVybHMyXCI6W1wielg2U09NTEpoblhRbURscHNRbF9kems5NDVaSndnU2c2U0FrM2dcXFwvcVU1S2hqNF9odFUuanBnXCIsXCI2YXhLcjN6QTl2b2dEQkQtWXBhcmRBbW5FZ3hHbm56ajV4UWZ3QVxcXC9Ebm52NW1GblFnSS5qcGdcIixcIk9CQzgzSzRMT2hsN1hvTjhmVzdEZndlOFFKZXF4bTRIZWJFN2F3XFxcL2NDRUJNeTBmdEVJLmpwZ1wiLFwiOW5kN1g3SGl6U1dEMW9PYV9NcFlvZHZuLXBPamxDaTNGSWZUUFFcXFwvVXJjNTlPZ1doamsuanBnXCJdfSIsImJ3YWN0IjoibWFya2V0X2FsYnVtIiwic2VydmVyIjo4NTUzMTIsIm1pZCI6NzQzNzg0NDc0LCJfc2lnIjoiZjJiMzg4MzAyOTJkZThlOGJkOTZlNjI2ZjJlZmMzNTIifQ", "gid":218252175, "hash":"92c2d8131778383213750cd603b87a3e" }

Saving the results

To save the main photo, call the photos.saveMarketAlbumPhoto method with the parameters you received in the previous step.

Note. At this step, the photo will be saved to the system album. To post it, follow the instructions of the Posting the photo step.

Request

Shell
curl 'https://api.vk.ru/method/photos.saveMarketAlbumPhoto' \ -F 'access_token=vk1.a.WLR8Mw9LSzb5_TucZMoGsEMUXg3WLhpL7hOO29l7oTTSN8APMYTtbndugdcQGVfUe3DlmiBdTvw3R-FormClSDmxCGrlZ0cmfnaKeBscp1TbKs2M3Y9BE5f4lgZwsP3kwEoj-u-SCb9Kk9k9SAQ1MKNljA3jH53w1u2fMTVQ9DspxlzHurs7PuAidjH1_PsUJDRpyCbslvIekpeLYVAa9w' \ -F 'photo=eyJwaG90byI6IntcInBob3RvXCI6XCJkOGRjYTQ0MzI0OnlcIixcInNpemVzXCI6W10sXCJraWRcIjpcIjYzMzM5YmNlOWFhNzExMGIxMTg3MDlkMjA4ZjRmNjA1XCIsXCJkZWJ1Z1wiOlwieHl5XCIsXCJzaXplczJcIjpbW1wic1wiLFwiY2Q3ZTkyMzhjMmM5ODY3NWQwOTgzOTY5YjEwOTdmNzczOTNkZTM5NjQ5YzIwNGEwZTkyMDI0ZGVcIixcIi0zMDYwNjg5MzU4OTc4MTM0MzU5XCIsMTQ1LDk2XSxbXCJtXCIsXCJlOWFjNGFhZjdjYzBmNmZhMjAwYzEwZmU2Mjk2YWI3NDA5YTcxMjBjNDY5ZTdjZTNlNzE0MWZjMFwiLFwiMTYyODA2MjA2NzIyNzAxNTgyXCIsMjkwLDE5M10sW1wieFwiLFwiMzgxMGJjZGNhZTBiM2ExOTdiNWU4MzdjN2Q2ZWMzN2YwN2JjNDA5N2FhYzY2ZTA3NzliMTNiNmJcIixcIjQ4MDY1MDA5ODEzMDA4NjMzNDRcIiw1ODAsMzg2XSxbXCJ5XCIsXCJmNjc3N2I1ZmIxZTJjZDI1ODNkNjgzOWFmY2NhNThhMWRiZTdmYTkzYTM5NDI4YjcxNDg3ZDMzZFwiLFwiNDE0NTAyNTY5NjgyNjc2NzE4NlwiLDk2Miw2NDBdXSxcInVybHNcIjpbXSxcInVybHMyXCI6W1wielg2U09NTEpoblhRbURscHNRbF9kems5NDVaSndnU2c2U0FrM2dcXFwvcVU1S2hqNF9odFUuanBnXCIsXCI2YXhLcjN6QTl2b2dEQkQtWXBhcmRBbW5FZ3hHbm56ajV4UWZ3QVxcXC9Ebm52NW1GblFnSS5qcGdcIixcIk9CQzgzSzRMT2hsN1hvTjhmVzdEZndlOFFKZXF4bTRIZWJFN2F3XFxcL2NDRUJNeTBmdEVJLmpwZ1wiLFwiOW5kN1g3SGl6U1dEMW9PYV9NcFlvZHZuLXBPamxDaTNGSWZUUFFcXFwvVXJjNTlPZ1doamsuanBnXCJdfSIsImJ3YWN0IjoibWFya2V0X2FsYnVtIiwic2VydmVyIjo4NTUzMTIsIm1pZCI6NzQzNzg0NDc0LCJfc2lnIjoiZjJiMzg4MzAyOTJkZThlOGJkOTZlNjI2ZjJlZmMzNTIifQ' \ -F 'group_id=218252175' \ -F 'server=999' \ -F 'hash=92c2d8131778383213750cd603b87a3e' \ -F 'v=5.131'

Response

JSON
{ "response":[ { "album_id":-53, "date":1673950671, "id":457239026, "owner_id":-218252175, "sizes":[ { "height":96, "type":"s", "width":145, "url":"https:\/\/sun9-west.userapi.com\/sun9-2\/s\/v1\/if2\/UA1wwTgNPZhQEobJN1h0hVkCiZFLz3FOsnITvWfpcN2XTUy46H-HvKeWOC8wrMg63GzxvrQ8RyMX6irHudftOj2f.jpg?size=145x96&quality=96&type=none" }, { "height":193, "type":"m", "width":290, "url":"https:\/\/sun9-west.userapi.com\/sun9-2\/s\/v1\/if2\/C2SS5to1QEXJJObX-V7M0ybwP4YjAS2kAjxNbBnTB_N0y_0CHHAezXv5OKvFk3w-4h4LyJyDzM3SJy6jozVwB1KM.jpg?size=290x193&quality=96&type=none" }, { "height":386, "type":"x", "width":580, "url":"https:\/\/sun9-west.userapi.com\/sun9-2\/s\/v1\/if2\/exEyFacsDve2wtG5Vo5plkIEuze91TB-LQruxwEAqKPiEfb0GQXxeer8YM0X5Pr1n4eSK1A6geCLS1yXyxZ0qojl.jpg?size=580x386&quality=96&type=none" }, { "height":640, "type":"y", "width":962, "url":"https:\/\/sun9-west.userapi.com\/sun9-2\/s\/v1\/if2\/4CJocOe2pbHAu2vUP2UdT4Njh7c1TjgXDZVR3guLU2IQh1wJsvt_KjSjd20kbn_l1Cz9BxbGvbOHHVFYMT2eewKU.jpg?size=962x640&quality=96&type=none" } ], "text":"", "user_id":100, "has_tags":false } ] }

Posting the photo

To attach a photo to the product collection, call the market.addAlbum or market.editAlbum method. In the photo_id field, specify the photo ID.

Request

Shell
curl 'https://api.vk.ru/method/market.editAlbum' \ -F 'access_token=vk1.a.WLR8Mw9LSzb5_TucZMoGsEMUXg3WLhpL7hOO29l7oTTSN8APMYTtbndugdcQGVfUe3DlmiBdTvw3R-FormClSDmxCGrlZ0cmfnaKeBscp1TbKs2M3Y9BE5f4lgZwsP3kwEoj-u-SCb9Kk9k9SAQ1MKNljA3jH53w1u2fMTVQ9DspxlzHurs7PuAidjH1_PsUJDRpyCbslvIekpeLYVAa9w' \ -F 'owner_id=-218252175' \ -F 'album_id=1' \ -F 'title=Collection test' \ -F 'photo_id=457239026' \ -F 'v=5.131'

Response

JSON
{ "response":1 }