NAME

WebService::OurWorldInData::Catalog

SYNOPSIS

my $catalog = WebService::OurWorldInData::Catalog->new;

my $results = $chart->find( 'covid' ); # get charts for covid
my @topics  = $chart->get_topics;

DESCRIPTION

Pretends to search Our World in Data for data charts like the python api find.

Methods

find

Returns an array ref of charts matching the argument to find. You can give it a string or a regex as in

$results = $chart->find( qr/covid|death/ );

An empty call to find will return all the charts it knows about.

$all_results = $chart->find;

Our World in Data holds the data on 14,368 charts across 123 topics as of July 2025. Because they haven't opened up their Catalog API yet, I've had to scrape their web page for results. This means that the find method is not dynamic, up-to-date or anywhere near complete.

There are currently 3659 charts known by this module, so you've got a 1 in 4 chance of finding what you're looking for.

get_topics

This will return a list of topics that I've scraped so far. There are only 29 of the 123 known as of July 2025, but it should give you a start.

SEE ALSO