Search components

GET

https://api.modulards.com/api/public/v1/components/search

GET

/api/public/v1/components/search

curl https://api.modulards.com/api/public/v1/components/search \
     -H "Authorization: Bearer <token>"

200200 - Components found on wordpress.org

{
  "data": [
    {
      "attributes": {
        "active_installs": 5000000,
        "author": "Automattic",
        "download_link": "https://downloads.wordpress.org/plugin/woocommerce.8.10.1.zip",
        "last_updated": "2026-09-10T00:00:00.000000Z",
        "name": "WooCommerce",
        "rating": 90,
        "requires_php": "7.4",
        "requires_wp": "6.6",
        "slug": "woocommerce",
        "tested_wp": "6.8.1",
        "version": "8.10.1"
      },
      "id": "woocommerce",
      "type": "wordpress-repository-items"
    },
    {
      "attributes": {
        "active_installs": 300000,
        "author": "WooCommerce",
        "download_link": "https://downloads.wordpress.org/plugin/woocommerce-shipping.2.9.0.zip",
        "last_updated": "2026-08-22T00:00:00.000000Z",
        "name": "WooCommerce Shipping & Tax",
        "rating": 82,
        "requires_php": "7.4",
        "requires_wp": "6.4",
        "slug": "woocommerce-shipping",
        "tested_wp": "6.8.1",
        "version": "2.9.0"
      },
      "id": "woocommerce-shipping",
      "type": "wordpress-repository-items"
    }
  ],
  "jsonapi": {
    "version": "1.1"
  },
  "links": {
    "first": "{{base_url}}/api/public/v1/components/search?page%5Bnumber%5D=1",
    "last": "{{base_url}}/api/public/v1/components/search?page%5Bnumber%5D=1",
    "next": null,
    "prev": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "active": false,
        "label": "&laquo; Previous",
        "url": null
      },
      {
        "active": true,
        "label": "1",
        "url": "{{base_url}}/api/public/v1/components/search?page%5Bnumber%5D=1"
      },
      {
        "active": false,
        "label": "Next &raquo;",
        "url": null
      }
    ],
    "path": "{{base_url}}/api/public/v1/components/search",
    "per_page": 15,
    "to": 2,
    "total": 2
  }
}

Searches wordpress.org for a plugin or theme by name. It looks at the public repository, not at what is installed on your websites (use “List components” or “List site items” for that), and gives you the exact slug that “Install a component on websites” needs.

Errors

422: type is missing or not plugin or theme, s is missing for a plugin search or is shorter than 2 or longer than 100 characters, or a page value is out of range.
502: wordpress.org cannot be reached. Retry in a moment.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Query parameters

typestringOptional

What to search: plugin or theme. Required.

sstringOptional

Search text, 2 to 100 characters. Required for a plugin search; optional for a theme search, which then browses the popular themes.

page[number]stringOptional

Page to return, starting at 1. Default 1.

page[size]stringOptional

Number of results per page, 1 to 50. Default 15.

Response

200 - Components found on wordpress.org

datalist of objectsOptional

jsonapiobjectOptional

linksobjectOptional

metaobjectOptional