# Introducing the Mobile-Friendly Test API

> [!IMPORTANT]
> It's been a while since we published this blog post. Some of the information may be outdated (for example, some images may be missing, and some links may not work anymore). As of December 2023, the Mobile-Friendly Test and API [have been retired](https://developers.google.com/search/blog/2023/04/page-experience-in-search#search-console-reports).

Tuesday, January 31, 2017


With so many users on mobile devices, having a mobile-friendly web is important to us all. The
[Mobile-Friendly Test](https://search.google.com/test/mobile-friendly)
is a great way to check individual pages manually. We're happy to announce that this test is now
available via API as well.


The
[Mobile-Friendly Test API](https://developers.google.com/webmaster-tools/search-console-api)
lets you test URLs using automated tools. For example, you could use it to monitor important pages
in your website in order to prevent accidental regressions in templates that you use. The
[API method](https://developers.google.com/webmaster-tools/search-console-api/reference/rest/v1/urlTestingTools.mobileFriendlyTest/run)
runs all tests, and returns the same information - including a list of the blocked URLs - as the
manual test. The documentation includes simple samples to help get you started quickly.
![](https://developers.google.com/static/search/blog/images/import/26374334ddd97424a137974fef057931.png)


We hope this API makes it easier to check your pages for mobile-friendliness and to get any such
issues resolved faster. We'd love to hear how you use the API---you can post in our
[forum](https://support.google.com/webmasters/go/community), and you
can link to any code or implementation that you've set up! As always, if you have any questions,
you can drop by our
[webmaster help forum](https://support.google.com/webmasters/go/community).


Posted by
[John Mueller](https://twitter.com/johnmu),
Webmaster Trends Analyst, Google Switzerland