GET request

Table of contents


Description

ZennoPoster allows using HTTP requests when working with different websites. You can receive data with GET requests, for example, request search results by request in a search system, download files, parse data, work with API of web services and applications. Performing actions without a browser can significantly reduce the load on computer resources.


How to add an action to a project?

Via the context menu Add ActionHTTPGET request

Or use smart search .


What is it used for?

  • Working templates without a browser

  • A quick way to get data from the site

  • Download files

  • Working with the service API


How to work with an action: Main tab

URL

The address of the site to which the request will be sent, you can use a variable.

Referer

The Referer request header contains the URL of the original page from which the current page was navigated. The Referer header allows the server to find out where the link to the requested page came from.
Variable macros can be used.

Encoding

The encoding in which the request will be sent.

Timeout

The maximum time to wait for a response from the site in seconds. When the set time is reached, the action will be completed with an error and will exit on the red thread.
Variable macros can be used.

Load

Content only

Only the response body will be saved to the variable

{ "args": {}, "headers": { "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9", "Accept-Encoding": "gzip, deflate", "Accept-Language": "en-US,en;q=0.8", "Host": "httpbin.org", "Referer": "https://google.com", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.141 Safari/537.36", "X-Amzn-Trace-Id": "Root=1-26erb44t-465basaw0z2qwbji492yh5t3" }, "origin": "1.2.3.4", "url": "https://httpbin.org/get" }

Headers only

Only response headers will be saved

HTTP/1.1 200 OK Date: Sat, 23 May 2020 01:56:45 GMT Content-Type: application/json Content-Length: 613 Connection: keep-alive Server: gunicorn/19.9.0 Access-Control-Allow-Origin: * Access-Control-Allow-Credentials: true

Headers and content

Both the response header and its body will be saved to the variable. They will be separated by two blank lines.

HTTP/1.1 200 OK Date: Sat, 23 May 2020 01:56:45 GMT Content-Type: application/json Content-Length: 613 Connection: keep-alive Server: gunicorn/19.9.0 Access-Control-Allow-Origin: * Access-Control-Allow-Credentials: true { "args": {}, "headers": { "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9", "Accept-Encoding": "gzip, deflate", "Accept-Language": "en-US,en;q=0.8", "Host": "httpbin.org", "Referer": "https://google.com", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.141 Safari/537.36", "X-Amzn-Trace-Id": "Root=1-26erb44t-465basaw0z2qwbji492yh5t3" }, "origin": "1.2.3.4", "url": "https://httpbin.org/get" }

As a file

This mode is worth choosing if you are trying to download a file using a request.

The path to the downloaded file will be saved to the variable.

By default, files are downloaded to the Trash folder in the ZennoPoster installed directory. The path to it may look like this - C: \ Program Files \ ZennoLab \ RU \ ZennoPoster Pro V7 \ 7.4.0.0 \ Progs \ Trash \ googlelogo_color_92x30dp.png

You can change this path in the settings, globally for all projects. Or by using an action during template execution.

As file + headers

The variable will save the response headers and the path to the downloaded file.

Put in variable

Here you need to select (or create a new) variable into which the query result will be saved.


How to work with an action: More Tab

Redirect

Set redirection - if the response to the request contains a redirect code (eg response 301, 302), Zennoposter will use the Location header to go to the next page. The numbers indicate the maximum number of clicks: 0 - stay on the original page, 5 - the number of clicks to the final url.

Use original URL

Disable url encoding from the "Main" tab in urlencode.
Example:

Original url: https://ru.wikipedia.org/wiki/Greeting

Default: https://ru.wikipedia.org/wiki/%D0%9F%D1%80%D0%B8%D0%B2%D0%B5%D1%82%D1%81%D1%82%D0%B2%D0%B8%D0%B5

Headers

Use default

Default headers will be substituted into the request. This is how they look (for the example of a request to https://httpbin.org/get, the Host header will change depending on the URL in the request)

Host: httpbin.org
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101 Firefox/45.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Encoding: gzip, deflate
Accept-Language: en-US,en;q=0.5

Current profile

The titles from the current project profile will be substituted.

Load from profile

You must select a file or specify a variable containing the path to the profile from which the headers for the request will be loaded.

User settings

Allows you to specify each request header parameter yourself.

Request headers

The first is always (!) the string User-Agent! And only then all the other headers.

You can specify ready-made cookies or from a variable.

Format: name=value, several are separated by; (semicolon). Example:

user=1992103;session=f79fcadd847b80f9df78ba4fb276c867;id=889

Starting from version 7.1.6.0 (5.45.0.0) this input field is displayed only if the Use Cookie Container setting is disabled (described below).

Use Cookie Container

Cookie Container allows you to synchronize cookies both with the browser and between individual requests, without the need for manual parsing and substitution.

 Example

The project works with the site using requests, but you need to be authorized to work. Let's imagine that the authorization process is very complicated, so that it can be repeated on requests, therefore, to enter the site, we use the browser mode.

Then we turn off the browser and start working with the site using requests. By enabling the Use Cookie Container setting, cookies will be automatically synchronized between the browser and requests, you do not need to do anything manually - cookies will be substituted automatically. And if, during one of the requests, the site returns a new value for one or more cookies, these new values ​​will be automatically synchronized. And when executing the next request (or when opening the site through the built-in browser), the updated value will be used.

Example of User Settings

Using profile variables for headers and manual cookie substitution.


How to work with an action: Proxy Tab


Creating Actions from Traffic Monitor Requests

Added in ZennoPoster 7.1.5.0 (5.44.0.0)

A ready-made HTTP request can be created directly from the Traffic Window.

  1. Hover the cursor over the required query and right-click to call the context menu.

  2. Click Create Action from Request.

A fully filled HTTP request action appears on the project canvas.


Do not use a browser

If you work exclusively with the help of requests, then you can turn off the browser, thereby saving computer resources; you can do this either in the project settings or using the Browser Settings action.


HTTP-Request transfer method

ZennoPoster has two methods of working with requests - third-party development (standard method, Chilkat library) and our own (alternative method). If something does not work for you when working with HTTP requests using the standard method, then try switching to an alternative method.

You can change the method of sending requests in the program settings (globally for all projects) or in the settings of a specific project.


Usage example

Find out the current ip address from which the project is running.
To do this, just make a GET request at https://api.ipify.org/, and in the Proxy tab, select the Current proxy of the project.


Useful links