> For the complete documentation index, see [llms.txt](https://dibs.gitbook.io/vortex-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dibs.gitbook.io/vortex-docs/examples/fetching-data.md).

# Fetching Data

Fetching data from the internet is relatively simple to do in Vortex. The standard library includes a module called `requests` that allows you to perform HTTP(S) actions. We'll use it to fetch some fake data from an API, parse it and write it to a file.

{% code title="fetch.vtx" overflow="wrap" %}

```rust
import io
import requests
import [parse, serialize] : json
import [join] : string
import [] : functional

const headers = {
    "Content-Type": "application/json"
}

const random_users = (count = 100) => {
    const users = requests.get(f"https://randomuser.me/api/?nat=us,au,gb,ca&results=${count}", headers).body.parse()
    return users.results
}

random_users()
.filter((user) => user.registered.age >= 18)
.sort((a, b) => a.registered.age < b.registered.age)
.map((user, index) => f"${index+1}: ${user.name.title} ${user.name.first} ${user.name.last}, ${user.registered.age} (${user.email})")
.chain((users) => users.insert(f"People (${users.length()})\n------------\n", 0))
.join("\n")
.chain((users) => io.writef("people.txt", users))

io.readf("people.txt").println()
```

{% endcode %}

First we import all the modules/functions we need.

We define our headers that we'll be sending alongside our request. We then define the function that will retrieve our users from the `randomuser` API.

This function uses `requests.get()` to retrieve the data we need, sending the headers we defined earlier with it.

We then use json to parse the body of our response, and return it.

It's important to note that calling the random\_users function will block the main thread. The requests module is not designed to be non-blocking. If you wanted it to be non-blocking, you will need to use a Future (`import [Future] : future`) to call the function in another thread.

Once we have our parsed data, we chain a few different functions to it to modify the output. The functions `chain`, `filter` and `map` are imported from the `functional` module.

We then join our strings together using the `join` function imported from `string`.

The last chain call writes the output to a file named `people.txt` using `io.writef`.

Lastly, we read the file we just created using `io.readf` and print the results to the console.

This is an example output:

{% code title="stack.vtx" overflow="wrap" %}

```rust
People (23)
------------

1: Mr Curtis Macrae, 18 (curtis.macrae@example.com)
2: Mr Kent Frazier, 18 (kent.frazier@example.com)
3: Ms Ariane Grewal, 18 (ariane.grewal@example.com)
4: Miss Justine Bouchard, 18 (justine.bouchard@example.com)
5: Miss Alexis Wilson, 19 (alexis.wilson@example.com)
6: Mr Jordan Howell, 19 (jordan.howell@example.com)
7: Mr Fernando Rodriguez, 19 (fernando.rodriguez@example.com)
8: Mrs Emma Chu, 19 (emma.chu@example.com)
9: Ms Noémie Wilson, 19 (noemie.wilson@example.com)
10: Miss Maya Stewart, 19 (maya.stewart@example.com)
11: Mrs Erin Graham, 19 (erin.graham@example.com)
12: Mr Louis Clark, 20 (louis.clark@example.com)
13: Miss Katherine Weaver, 20 (katherine.weaver@example.com)
14: Mr Seth Morris, 20 (seth.morris@example.com)
15: Ms Sylvia Bates, 20 (sylvia.bates@example.com)
16: Miss Eliza Ford, 20 (eliza.ford@example.com)
17: Mr Cameron Mccoy, 20 (cameron.mccoy@example.com)
18: Mr Zachary Williams, 21 (zachary.williams@example.com)
19: Ms Rebecca Stephens, 21 (rebecca.stephens@example.com)
20: Mr Thomas Curtis, 21 (thomas.curtis@example.com)
21: Ms Lily Miller, 21 (lily.miller@example.com)
22: Mrs Zoe Taylor, 21 (zoe.taylor@example.com)
23: Mrs Amber Carter, 21 (amber.carter@example.com)
```

{% endcode %}

Apart from fetching data, you can use requests to post, patch and delete as well. Visit the [standard modules reference guide](/vortex-docs/standard-modules/requests.md) for more information.