{"id":31524,"date":"2018-04-21T15:47:47","date_gmt":"2018-04-21T15:47:47","guid":{"rendered":"https:\/\/ampscript.guide\/httpget\/"},"modified":"2021-04-06T00:58:41","modified_gmt":"2021-04-06T00:58:41","slug":"httpget","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/httpget\/","title":{"rendered":"HTTPGet"},"content":{"rendered":"

HTTPGet<\/h2>\n

This function retrieves, or ‘gets’ content from a defined publicly accessible URL.<\/p>\n

Arguments<\/h3>\n

HTTPGet(1,2,3,4)<\/code><\/p>\n\n\n\n\n\n\n\n\n
Ordinal<\/th>\nType<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nString<\/td>\nTrue<\/td>\nURL used to retrieve content<\/td>\n<\/tr>\n
2<\/td>\nString<\/td>\nFalse<\/td>\nWhether the process continues on an error. A value of true<\/code> ignores errors in the process. It defaults to false<\/code> if not specified.<\/td>\n<\/tr>\n
3<\/td>\nString<\/td>\nFalse<\/td>\nDefines whether the function allows empty content. A value of 0<\/code> permits empty content. A value of 1<\/code> returns an error. A value of 2<\/code> skips sending an email to the Subscriber (if the function is used in an email).<\/td>\n<\/tr>\n
4<\/td>\nString<\/td>\nFalse<\/td>\nOutputs the function status. A value of 0<\/code> indicates the status is successful, -1<\/code> indicates a 404 error (URL not found), -2<\/code> indicates an HTTP request error (the server did not return a 2xx status code) and -3<\/code> indicates empty content.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

NOTE: The function only works with HTTP content on TCP\/IP port 80 and HTTPS on port 443. Basic access authentication in URLs is not supported (for example, https:\/\/username:password@https:\/\/domain.com<\/code>).<\/p>\n<\/blockquote>\n

Example 1<\/h3>\n

The following example retrieves HTML content from an external URL and displays it in an email, web page or message.<\/p>\n

%%[\n\nvar @getRequest\nset @getRequest = TreatAsContent(HTTPGet(\"https:\/\/httpbin.org\/html\"))\n\n]%%\n%%=v(@getRequest)=%%<\/code><\/pre>\n
Output<\/h4>\n
The request will return HTML content from the source URL.<\/p>\n
<!DOCTYPE html>\n<html>\n  <head>\n  <\/head>\n  <body>\n      <h1>Herman Melville - Moby-Dick<\/h1>\n      <div>\n        <p>\n          Availing himself of the mild, summer-cool weather that now reigned in these latitudes, and in preparation for the peculiarly active pursuits shortly to be anticipated, Perth, the begrimed, blistered old blacksmith, had not removed his portable forge to the hold again, after concluding his contributory work for Ahab's leg...\n        <\/p>\n      <\/div>\n  <\/body>\n<\/html><\/code><\/pre>\n
Example 2<\/h3>\n
\n\n\n\t\n\t
\n\n\t\t\n\t\t