Skip to main content
POST
/
v1
/
media
Media Download
curl --request POST \
  --url https://sdk.nimbleway.com/v1/media \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/product-image.jpg",
  "country": "US",
  "locale": "en-US",
  "expected_mime_types": [
    "image/*"
  ]
}
'
"<string>"

Documentation Index

Fetch the complete documentation index at: https://docs.nimbleway.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
url
string<uri>
required

URL of the media file to download

Example:

"https://example.com/image.jpg"

​
country
string
default:US

Country used to access the target URL, use ISO Alpha-2 Codes

Required string length: 2
Example:

"US"

​
locale
string

LCID standard locale used for the URL request. Alternatively, user can use 'auto' for automatic locale based on geo-location

Example:

"en-US"

​
expected_mime_types
string[]

Allowed MIME types (supports wildcards like image/*)

Example:
["image/*", "video/mp4"]

Response

Successful Response

The response is of type file.