This is a convenience wrapper for the GTmetrix API 2.0.

I whipped up a small library to talk to GTmetrix via R. There's some basic sanity checking baked in, but obviously this is still work in progress and there are (potentially critical) bugs. Feel free to check it out, though. If you need help, take a look at the manuals. A good point to start is ?start_test.

If you have feedback and/or points for improvement, feel free to open an issue / PR here on Github. I would love to hear from you!



# Install and load library.

Start test (and get results)

Minimal example #1

# Returns the final report (after checking for completion roughly every 3 seconds). 
result <- start_test("", "[API_KEY]")

This will start a test and wait for the report to be generated, returning the result as data.frame. Optionally, you can just simply return the test ID and other meta data via the parameter wait_for_completion = FALSE.

Minimal example #2

# Returns just the test ID and some meta data. Does not wait for report completion.
result <- start_test("", "[API_KEY]", wait_for_completion = FALSE)

Optional parameters

Other optional parameters are: location, browser, report, retention, httpauth_username, httpauth_password, adblock, cookies, video, stop_onload, throttle, allow_url, block_url, dns, simulate_device, user_agent, browser_width, browser_height, browser_dppx, browser_rotate.

Please consult the manual via ?start_test or the GTmetrix API documentation for further information.


# Show available locations
# Get location details
get_location_details(location_id = 1, "[API_KEY]")


# Show available browsers
# Get browser details
get_browser_details(browser_id = 3, [API_KEY]")

Tests / Reports

# Get specific test
get_test("[TEST_ID]", "[API_KEY]")
# Get specific report
get_report("[REPORT_ID]", "[API_KEY]")
# Get all tests


# Get account status and available credits

Try the rgtmx package in your browser

Any scripts or data that you put into this service are public.

rgtmx documentation built on Nov. 12, 2021, 1:08 a.m.