# WordPress Directory API > The official WordPress.org plugin and theme directory as an API — the registry behind the ~40% of the web that runs on WordPress. Look up any plugin or theme by its slug for its name, version, author, user rating and rating count, active-install count and total downloads, the WordPress and PHP versions it requires, last-updated date, homepage, support URL and direct download link; and search the directory by keyword (plugins or themes), with results ranked by active installs. Covers the 60,000+ free plugins and 13,000+ themes on WordPress.org, from WooCommerce, Yoast SEO and Elementor to Contact Form 7 and Jetpack. Live from the official api.wordpress.org. Ideal for WordPress dashboards and site managers, plugin/theme catalogs, compatibility and update tooling, and the WordPress developer ecosystem. Open data from WordPress.org. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/wordpress-api/..." ``` ## Pricing - **Free** (Free) — 3,640 calls/Mo, 2 req/s - **Starter** ($4/Mo) — 49,000 calls/Mo, 8 req/s - **Pro** ($13/Mo) — 240,000 calls/Mo, 20 req/s - **Mega** ($35/Mo) — 1,210,000 calls/Mo, 50 req/s ## Endpoints ### WordPress #### `GET /v1/plugin` — Plugin metadata **Parameters:** - `slug` (query, required, string) — Plugin slug, e.g. woocommerce Example: `woocommerce` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wordpress-api/v1/plugin?slug=woocommerce" ``` **Response:** ```json { "data": { "plugin": { "name": "WooCommerce", "slug": "woocommerce", "tags": [ "ecommerce", "online store", "sell online", "shop", "shopping cart" ], "added": "2011-09-27", "author": "Automattic", "rating": 90, "version": "10.8.1", "homepage": "https://woocommerce.com/", "tested_wp": "7.0", "downloaded": null, "wp_org_url": "https://wordpress.org/plugins/woocommerce/", "num_ratings": 4797, "requires_wp": "6.9", "support_url": "https://wordpress.org/support/plugin/woocommerce/", "last_updated": "2026-05-27 5:54pm GMT", "requires_php": "7.4", "download_link": "https://downloads.wordpress.org/plugin/woocommerce.10.8.1.zip", "author_profile": "https://profiles.wordpress.org/automattic/", "active_installs": 7000000, "short_description": null } }, "meta": { "timestamp": "2026-05-31T14:16:34.168Z", "request_id": "0d4ecab4-a8a2-4b2c-ac50-52e29ec540ce" }, "status": "ok", "message": "Plugin retrieved", "success": true } ``` #### `GET /v1/search` — Search the directory **Parameters:** - `q` (query, required, string) — Search term Example: `seo` - `type` (query, optional, string) — plugin | theme (default plugin) - `limit` (query, optional, string) — Results (1-100, default 20) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wordpress-api/v1/search?q=seo" ``` **Response:** ```json { "data": { "type": "plugin", "count": 20, "query": "seo", "total": 6265, "results": [ { "name": "Yoast SEO Advanced SEO with real-time guidance and built-in AI", "slug": "wordpress-seo", "type": "plugin", "author": "Yoast", "rating": 96, "version": "27.7", "wp_org_url": "https://wordpress.org/plugins/wordpress-seo/", "active_installs": 10000000, "short_description": "Improve your SEO with real-time feedback, schema, and clear guidance. Upgrade for AI tools, Google Docs integration, and 24/7 support, no hidden fees." }, { "name": "LiteSpeed Cache", "slug": "litespeed-cache", "type": "plugin", "author": "LiteSpeed Technologies", "rating": 96, "version": "7.8.1", "wp_org_url": "https://wordpress.org/plugins/litespeed-cache/", "active_installs": 7000000, "short_description": "All-in-one unbeatable acceleration & PageSpeed improvement: caching, image/CSS/JS optimization..." }, { "name": "WooCommerce", "slug": "woocommerce", "type": "plugin", "author": "Automattic", "rating": 90, "version": "10.8.1", …(truncated, see openapi.json for full schema) ``` #### `GET /v1/theme` — Theme metadata **Parameters:** - `slug` (query, required, string) — Theme slug, e.g. twentytwentyfour Example: `twentytwentyfour` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wordpress-api/v1/theme?slug=twentytwentyfour" ``` **Response:** ```json { "data": { "theme": { "name": "Twenty Twenty-Four", "slug": "twentytwentyfour", "author": "WordPress.org", "rating": 76, "version": "1.5", "homepage": "https://wordpress.org/themes/twentytwentyfour/", "downloaded": 7256309, "wp_org_url": "https://wordpress.org/themes/twentytwentyfour/", "num_ratings": 38, "preview_url": "https://wp-themes.com/twentytwentyfour/", "requires_wp": "6.4", "last_updated": "2026-05-20", "requires_php": "7.0", "download_link": "https://downloads.wordpress.org/theme/twentytwentyfour.1.5.zip", "screenshot_url": "//ts.w.org/wp-content/themes/twentytwentyfour/screenshot.png?ver=1.5", "active_installs": null } }, "meta": { "timestamp": "2026-05-31T14:16:35.490Z", "request_id": "f38d7c7a-5287-459b-85c2-7fd379e9ba90" }, "status": "ok", "message": "Theme retrieved", "success": true } ``` ### Meta #### `GET /v1/meta` — Source & options **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wordpress-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Live WordPress.org directory data. /v1/plugin = plugin metadata (version, author, rating, active installs, WP/PHP requirements, download link); /v1/theme = theme metadata; /v1/search = search the directory (type=plugin default, or type=theme), sorted by active installs.", "source": "WordPress.org — the official WordPress plugin & theme directory", "endpoints": [ "/v1/plugin", "/v1/theme", "/v1/search", "/v1/meta" ] }, "meta": { "timestamp": "2026-05-31T14:16:35.561Z", "request_id": "54f0704f-574b-4289-9365-4918da9aa902" }, "status": "ok", "message": "Meta retrieved", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/wordpress-api OpenAPI spec: https://www.oanor.com/api/wordpress-api/openapi.json