Wordpress Org Themes Scraper

WordPress.org Themes Scraper — Theme Search, Ratings, and Version Details

Overview

WordPress.org Themes Scraper collects publicly available theme information from the WordPress.org themes directory. Search by keyword, browse popular, new, or recently updated themes, and retrieve details for specific theme slugs.

The collected records are organized into a structured dataset that can be exported as JSON, CSV, or Excel for research, comparison, and catalog monitoring.

Features

• Theme Search: Find themes using one or more keywords.
• Theme Browsing: Browse popular, new, or updated themes.
• Theme Details: Retrieve information about specific themes by slug.
• Version Information: Collect published versions and minimum WordPress and PHP requirements.
• Ratings and Reviews: Examine available rating scores and rating counts.
• Author Details: Collect available theme author information.
• Commercial Indicators: Review commercial and community theme flags.
• Duplicate Filtering: Skip duplicate theme slugs.
• Structured Exports: Prepare theme records for spreadsheet analysis and reporting.

Use Cases

• Theme Research: Compare themes matching a particular niche or keyword.
• Catalog Monitoring: Collect snapshots of popular, new, or recently updated themes.
• Theme Comparison: Review versions, ratings, and compatibility requirements.
• Directory Research: Examine available author details and commercial indicators.
• Quality Review: Identify themes with missing ratings or incomplete metadata.
• Scheduled Inventories: Compare exports from separate runs to identify changes over time.

Input Parameters

Parameter	Type	Default	Description
searchQueries	Array	["blog"]	Keywords used to search for themes.
browse	String	Empty	Optional browsing category: popular, new, or updated.
themeSlugs	Array	[]	Exact theme slugs for collecting detailed information.
maxItems	Integer	100	Maximum number of theme records to collect. Minimum: 1; maximum: 1000.

Example Input

{
  "searchQueries": ["blog"],
  "browse": "",
  "themeSlugs": ["astra"],
  "maxItems": 100
}

What Data Does This Actor Extract?

Each collected theme is stored as a dataset record. Available fields depend on the theme and the collection mode.

Extracted Data Fields

Field	Type	Description
name	String	Theme name.
slug	String	Theme slug used to identify and deduplicate themes.
version	String	Published theme version.
author	Object	Available author information, such as login name and display name.
rating	Integer	Theme rating score when available.
num_ratings	Integer	Number of ratings received.
themeDescription	String	Public theme summary.
requires	String	Minimum required WordPress version.
requires_php	String	Minimum required PHP version.
is_commercial	Boolean	Indicates whether the theme is marked as commercial.
external_support_url	Boolean	Indicates whether external support is available.
is_community	Boolean	Indicates whether the theme is marked as a community theme.
mode	String	Collection mode: search, browse, or detail.
scraped_at	String	Timestamp when the record was collected.

Example Output

The following is an illustrative dataset record. Values and available fields vary by theme.

{
  "name": "Beyond Blog",
  "slug": "beyond-blog",
  "version": "1.0.1",
  "author": {
    "user_nicename": "ascendoor",
    "display_name": "Ascendoor",
    "author": "Ascendoor"
  },
  "rating": 0,
  "num_ratings": 0,
  "themeDescription": "A stylish and modern theme designed for personal and professional bloggers.",
  "requires": "5.0",
  "requires_php": "8.0",
  "is_commercial": false,
  "external_support_url": false,
  "is_community": false,
  "mode": "search",
  "scraped_at": "2026-10-12T00:00:00+00:00"
}

Collection Modes

• search — Collects themes matching the configured search keywords.
• browse — Collects themes from the selected popular, new, or updated category.
• detail — Collects detailed information for specified theme slugs.

Working with Your Dataset

When collection finishes, review the dataset and export the results in your preferred format:

• JSON: For structured data processing.
• CSV: For spreadsheet analysis and catalog comparisons.
• Excel: For reviewing theme information in a workbook.

You can compare exports from different runs to track version changes, changes in ratings, and newly discovered themes.

Important Notes

• You can combine keyword searches, browsing, and specific theme slugs in one run.
• The maximum configured collection size is 1000 theme records per run.
• Duplicate theme slugs are skipped.
• Some themes may have missing ratings, descriptions, or other optional information.
• The scraped_at field represents when the record was collected, not the theme's last modification time.
• This is an independent data collection tool and not an official WordPress.org product.

FAQ

Can I search for multiple theme keywords?

Yes. Add multiple keywords to searchQueries.

Can I collect a specific theme?

Yes. Add its slug to themeSlugs.

Can I browse popular or recently published themes?

Yes. Set browse to popular, new, or updated.

Can I collect theme compatibility information?

Yes. The available records can include minimum WordPress and PHP version requirements.

Can I export the results to Excel?

Yes. The dataset can be exported as Excel, CSV, or JSON.

Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, sponsored by, or officially associated with WordPress.org or its maintainers. Users are responsible for ensuring that their collection and use of data comply with applicable laws and relevant terms.

Is Web Scraping Legal?

Collecting information that is already public is generally legal. Scraping is not the same thing as hacking, and there is no single law that bans it. The limits are the usual ones: do not break into accounts, do not take private or confidential data, and be careful with personal data and copyrighted works. A site's terms can also restrict how you access it. Facts such as a public name, price, or rating are not the same thing as republishing someone's article or photo.

This actor collects information from public pages. It does not log in and it does not bypass access controls.

For a longer explanation, see Apify's article Is web scraping legal?.