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.

USA - East
USA - West
Europe (7)
Europe - West
United Kingdom
South Africa
Mainland China
South Korea
Chrome Stable
Chrome Beta
Chrome Dev
Firefox Stable
Firefox ESR
Firefox Beta
Microsoft Edge
Core Web Vitals
Technical Page
Page-Level Metrics
Speed Index
Lighthouse Summary
Optimization Checks/Grades
Request-Level Metrics
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.
USA (12)
Europe (7)
Asia Pacific (13)
Mainland China
South Africa
Middle East (2)
Chrome Stable
Chrome Beta
Chrome Dev
Firefox Stable
Firefox ESR
Firefox Beta
Microsoft Edge
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
const WebPageTest = require('webpagetest');
const wpt = new WebPageTest('', '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.
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
for 1200 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


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.