the WebPageTest API

Build faster pages

The WebPageTest API key lets developers automate performance testing within their workflow to continuously deliver faster web pages.

Access new and in-depth performance metrics and frame-by-frame visuals of your user experience from the latest browsers, around the world.

locations
USA - East
USA - West
Canada
Brazil
Europe (7)
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Europe - West
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

United Kingdom
Ireland
France
Netherlands
Germany
Italy
Sweden
South Africa
Bahrain
Mainland China
South Korea
Japan
Taiwan
Indonesia
India
UAE
Thailand
Browsers
Chrome Stable
Chrome Beta
Chrome Dev
Firefox Stable
Firefox ESR
Firefox Beta
Microsoft Edge
Brave
Metrics
Core Web Vitals
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Technical Page
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Page-Level Metrics
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Speed Index
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Interactivity
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Lighthouse Summary
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Optimization Checks/Grades
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Request-Level Metrics
core web vitals

Core Web Vitals is really important to your SEO value. Google is counting performance again your search rankings and using these metrics to measure this.

Visual Comparison
Film Strips
Video Replay
Side-by-side Video Comparisons
Waterfall Correlation
Highlight Layout Shifts
Highlight LCP
Highlight Visual Complete
data & Test Infrastructure
Access in-depth performance metrics and page loading visuals programmatically from the latest browsers around the world.
locations
USA (12)
Canada
Brazil
Europe (7)
Asia Pacific (13)
Mainland China
South Africa
Middle East (2)
Browsers
Chrome Stable
Chrome Beta
Chrome Dev
Firefox Stable
Firefox ESR
Firefox Beta
Microsoft Edge
Brave
metrics
Lighthouse
SpeedIndex
Request-level
visual comparison
Film Strips
Video Replay
Highlight CLS
Waterfall Correlation
Developer Integrations
Plug Performance Insights Anywhere
A growing list of officially-supported and community integrations makes it easier to use the WPT API with your existing tools.
Explore integrations
1
2
3
4
5
6
7
8
9
10
const WebPageTest = require('webpagetest');
const wpt = new WebPageTest('www.webpagetest.org', 'YOUR_API_KEY');
let options = {
"firstViewOnly": true,
"runs": 1,
"location": 'Dulles:Chrome',
"connectivity": '4G',
"pollResults": 5,
"timeout": 240,
}
development workflow
Automatically run WebPageTest against code changes and set and enforce performance budgets within your existing CI/CD tool like GitHub or TravisCI.
audit & investigation
Test multiple URLs and store metrics to a preferred data store such as local JSON files, Google Sheets, BigQuery, or an in-house SQL database.
Visualization
Bring WebPageTest data to life and create insightful performance visualizations like Request Map, trending charts, and visualizations.
Platform enhancement
Give your customers insight into the performance or security benefits of your service with platform integrations.
starting at
$15/mo
for 1000 tests a month.
Get Started

With WebPageTest API, you get access to:

  Real browsers in real locations with the latest OS versions
  Test on real connection speeds
  Run page level and user journey tests, including custom scripts
  Test history for 13 months
  API integrations (Github Actions, NodeJS wrapper, etc.)
  Email support and expert documentation

For Custom Enterprise plans, Contact Us

Integrate WebPageTest
Anywhere

FAQ

How do you define a test run?  What metrics can I access with the API?

A test run on WebPageTest is defined as a single run within a test set up to measure webpage performance on a specific browser and location. For example, if you run a 5-run test with Repeat View, then that counts as 10 test runs.

You can access all the performance metrics that you would when you run a manual test on WebPageTest listed here. Including the film strip view as well as video capture. WebPageTest API also gives you additional metrics you get in JSON/XML.

What countries and browsers do you support with the WebPageTest API?

With WebPageTest API, you can test across 30 locations worldwide, including mainland China.  

WebPageTest API is always up-to-date on the current version of every browser and you can test on Chrome (stable, beta, canary), Firefox (stable, beta, ESR), Microsoft Edge (dev) and Brave.  

WebPageTest API also supports mobile emulation testing. You can test mobile content by emulating an Android browser by passing “mobile=1” as an API option.

Is there a daily/monthly limit to the tests run? How long do I have access to test results?

There is a monthly limit on the total tests you can run with the WebPageTest API, based on the subscription plan you choose. There is currently no daily limit on top of that monthly limit.

Do you provide any integrations that I can use with the API?

We currently support the following:

- WebPageTest API wrapper: NPM package that wraps WebPageTest API for NodeJS as a module and a command-line tool   
- GitHub Actions: The GitHub Action lets you automatically run tests against WebPageTest on code changes, set and enforce performance budgets, and have performance data automatically added to your pull requests to move the performance conversation directly into your existing development workflow. 
  
There are also several existing integrations built by our community members that you can try out to build on top of the WebPageTest API. Check out some of them here.

How will I be charged?

For monthly and annual subscriptions plans, your credit card will be automatically billed when you sign up and purchase the subscription, you’ll be able to access your payment history under Billing History in My Account on For Enterprise plans where you want to run more than 25000 tests per month, please contact us here.

If you are based out of the United States of America, You will be charged in US Dollars, but the exact amount you will see on your credit card statement may vary, depending on foreign exchange rates and any foreign transaction fees your bank may impose.

What payment methods do you support?

We accept payment via Credit Card (VISA, Mastercard, American Express, JCB, Maestro, Discover, Diners Club International, UnionPay). Please ensure the accuracy of your payment method and that it is properly funded to avoid any issues with payment acceptance.

We do not accept and will not ask you to provide payments with cash or a physical check.

For enterprise plans, requiring more than 25K tests per month, we offer invoicing. Contact us.

How secure is my payment?

All payments are securely processed over HTTPS and your card information never touches our servers. All payment processing is done by a level 1 PCI compliant third-party credit card processor. All details are sent over SSL, which is a 2048-bit RSA-encrypted channel. Our payment gateway also adheres to card networks’ requirements and regulations surrounding payment processing.

Can I add more users to the subscription plan?

Currently, we only support one user account to sign in and set up your account to purchase the WebPageTest API. However, you can generate up to 30 keys for multiple use cases and teams, from a single WebPageTest API account. Generate a new key by clicking on “+ API consumer”.  

We have plans to support adding multiple users and defining roles in the future.

What is the cancellation policy?

You can choose to cancel anytime during the subscription period. Once you choose to cancel, it stops the WPT API subscription from auto-renewing for the next billing cycle. You’ll continue to have access to run tests for that plan, until the end of your current billing period. When you cancel, you cancel only the subscription. You’ll continue to have access to the WebPageTest account and history of the manual tests you ran with that account. Please note all subscriptions are automatically renewed unless explicitly cancelled.