Yoast SEO API Python Example With requests + pandas

Lately I’ve been checking out the Yoast SEO plug-in and their REST API. The API returns all of the SEO metadata, meta tags, schema.org data, etc. for your WordPress blog posts. Here’s a Yoast API Python example script to fetch post metadata via requests and pandas:

import pandas as pd
import requests

def fetch_metadata(post_url):
    """Returns the Yoast API response as pandas dataframe."""
    url = f'https://pythonmarketer.com/wp-json/yoast/v1/get_head?url={post_url}'
    r = requests.get(url)
    response_dict = r.json()
	metadata_df = pd.json_normalize(response_dict['json'])
	return metadata_df

url = 'https://github.com/erickbytes/Python-Marketer-Reader-Analytics/blob/master/dataset/2020_pythonmarketer.com_post_views.xlsx?raw=true.xlsx'
posts = pd.read_excel(url)
# update url domain with pandas .str accessor
posts.url = posts.url.str.replace(pat='.wordpress', repl='', regex=False)
posts['metadata'] = posts.url.apply(fetch_metadata)
metadata_df = pd.concat(list(posts['results']))
metadata_df.to_csv('Wordpress Blog Post Yoast API Metadata.csv', index=False)

What this script is doing:

  1. Read a list of my blog posts from Github into a pandas dataframe.
  2. Use pandas .apply to fetch the metadata for each post url.
  3. Deserialize + normalize the JSON response.
  4. Convert to a pandas dataframe and store in a pandas Series named ‘metadata’.
  5. Merge the series and write the metadata to a csv file.

The Payoff:

You’ll end up with blobs of JSON formatted metadata to sift through or wrangle to your liking! Check out the Yoast documentation if you’re interested in finding out more about their APIs.

New to APIs?

It’s ok if so, we all were once. Check out my guide to making HTTP requests with Python if you want to see more API examples.

SEO Strategies Flow Chart