GET request

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 engine, 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 Action → HTTP → GET 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.

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.

• Each header starts with a new line.

• You can specify static values, custom variables, or profile variables.

Cookie

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

Without proxy

The action works using the real ip of the computer \ server.

Active project proxy

The proxy installed in the project is used.

The format string

We indicate the proxy in the format (you can specify a variable):

a) With authorization - socks5://login:password@ip:port or http://login:password@ip:port
b) Without authorization - socks5://ip:port or http://ip:port
c) Without specifying the protocol (http:// will be used by default) - login:password@ip:port or ip:port

Other

Select if you need to specify detailed proxy settings. Proxy type, authorization data, address and port. Check with your service provider for information.

Variables can be used in all input fields.

If no proxy protocol is specified, then http:// will be used by default.

Creating Actions from Traffic Monitor Requests

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

1. Project settings

2. POST request

3. HTTP request

4. JSON and XML processing

5. Word processing

6. Traffic window

7. Web developer tools (DevTools)