Attach Youtube Video - Salla Merchants APIs

This endpoint allows you to add unlimited videos to a specific product by passing the product as a path parameter.

Alert

Videos must be added as Youtube links.

You can only add one video per request.

Scopes

products.read_write- Products Read & Write

curl --location --request POST 'https://api.salla.dev/admin/v2/products//video' \ --header 'Content-Type: application/json' \ --data-raw '{ "video_url": "https://www.youtube.com/watch?v=dmqWuUeA5Ug", "default": true, "alt": "things from Google" }'

{ "status": 201, "success": true, "data": { "id": 1749963998, "image": { "original": { "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/maxresdefault.jpg", "width": 1920, "height": 1080 }, "standard_resolution": { "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/sddefault.jpg", "width": 640, "height": 480 }, "low_resolution": { "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/mqdefault.jpg", "width": 320, "height": 180 }, "thumbnail": { "url": "http://img.youtube.com/vi/dmqWuUeA5Ug/default.jpg", "width": 120, "height": 90 } }, "default": true, "alt_seo": "Introducing a few new helpful things from Google", "video_url": "https://www.youtube.com/watch?v=dmqWuUeA5Ug", "type": "video" } }

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Path Params

product

integer

required

Unique identification number assigned to a product. List of products IDs can be found here.

Body Params application/json

video_url

string

required

A web address that links to a specific video file or content on the interne. | required

default

boolean

optional

Set the video thumbnail image as default for product.

alt

string

optional

Alternative description for the video thumbnail image to enhance SEO.

Examples

Responses

🟢201Attached Successfully

application/json

Body

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (ProductImagesVideos)

optional

number

required

A unique identifier associated with the product image.

Example:

1908361139

image

object

required

sort

number

required

Sort order

Example:

default

boolean

required

Whether or not the image the default picture

Default:

false

alt_seo

string | null

required

Alternative SEO text for the image

video_url

string

required

Video web address.

type

string

required

Attachment type

Example:

image

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized