XAP Download URL API V0

Guidance and examples for accessing the XAP Download URL API V0

This Download URL API allows a user to request a secure, one-use URL to download a requested version of a Static Data Download file.

Endpoint

Method	Endpoint
GET	https://apim.expedia.com/feed/downloadUrl

Required Headers

Key:	Expedia API key
Authorization:	Expedia API Authorization String
Accept:	application/vnd.exp-lodging.v1+json
Partner-Transaction-Id:	Partner TransactionID String

Next Steps

Use returned URL to download requested data file.

Example Request and Response

Static File Download URL request

https://apim.expedia.com/feed/downloadUrl?locale=cs-CZ&type=Summary

Static File Download URL response

{
    "downloadUrl": "https://ews-generated-feeds-prod-p.s3.us-west-2.amazonaws.com/hotels/common/summary/expedia-lodging-summary-cs_cz-all.zip?X-Amz-Security-Token=xxxxxxxxxxx"
}

Error Codes

Common Error Codes

HTTP Status Code	Error Code	Error Response	Cause
400	104	Error occurred generating Pre-signed URL for the feed file generated.	The reason is the requested file is not in our support list, although this API has validation for these query parameters, there is still some combination of the query parameters we don't support for the time being, e.g. ?type=summary&locale=ar-SA&filter=VR , at the present, we only support locale is en-US when the filter is VR.
400	402	Invalid Type provided.	The type parameter is out of our support list of the type. The type list of what we support: summary listings locations descriptions amenities images policies vacationrental reviews vendorlogos destination
400	10010	Invalid Locale provided.	The locale parameter is out of our support list of the locale. Note: System will ignore the locale parameter when type is vendorlogo, because this kind of files has no locale concept. The locale list for we support: The support locale list
400	10012	Invalid Brand provided.	The brand can be null or empty then its value will be All. Its value only can be one of Expedia, Hotels, Vrbo, and All if it's not null and empty.
401	None	Unauthorized or Invalid authentication credentials.	Unauthorized or Invalid authentication credentials.
403	None	You cannot consume this service.	Cannot consume this service.
403	10030	File not found for the requested parameters.	The requested parameter combination does not have a corresponding file to download.
404	None	no Route matched with those values.	No Route matched.
429	None	API rate limit exceeded.	API rate limit exceeded. If you need to adjust it, pelase refer to the following to create a request: https://expediamanagement.zendesk.com/hc/en-us/articles/115015994888
503	None	name resolution failed.	Service unavailable.
500	500	An error has occurred while processing the request.	There is a server-side issue that has resulted in a failure.

Here, you can explore the endpoint definitions for this API, then go to the API Explorer to try out all the XAP endpoints, download OpenAPI specs, or download our Postman collections. Testing with one or all of these options will give you an understanding of how the examples and schema definitions compare to the actual output.