API and MCP

GET /api/v1/plugin/{slug}

Current state for one plugin. Optionally include daily snapshots and install-band milestones.

Parameters

• slug path, required WordPress.org plugin slug (e.g. contact-form-7).
• history query, optional Set to 1 or true to include snapshots and milestones.
• days query, optional History window when history=1. Default 365, max 1500.

Example request

curl "https://plugins.wpmayor.com/api/v1/plugin/contact-form-7" \
  -H "Authorization: Bearer pp_live_your_key_here"

Example response

{
  "plugin": {
    "slug": "contact-form-7",
    "name": "Contact Form 7",
    "author": "Takayuki Miyoshi",
    "category": "forms",
    "active_installs": 5000000,
    "downloaded": 380000000,
    "downloads_30d": 1200000,
    "momentum_ratio": 1.02,
    "rating": 84,
    "num_ratings": 2100,
    "adjusted_stars": 4.2,
    "support_threads": 40,
    "support_threads_resolved": 28,
    "version": "6.0",
    "requires": "6.0",
    "tested": "6.7",
    "requires_php": "7.4",
    "last_updated": "2026-01-15 12:00:00",
    "added": "2007-09-01",
    "health_overall": 88,
    "health_grade": "A",
    "integrity": "clean",
    "closed_date": null,
    "icon": "https://...",
    "last_crawled": "2026-07-18T08:00:00.000Z",
    "url": "https://plugins.wpmayor.com/plugin/contact-form-7",
    "wporg_url": "https://wordpress.org/plugins/contact-form-7/"
  },
  "generated_at": "2026-07-18T12:00:00.000Z"
}

GET /api/v1/plugins

Current state for up to 50 plugins in one call. Missing slugs return { slug, found: false }.

Parameters

• slugs query, required Comma-separated plugin slugs (max 50).

Example request

curl "https://plugins.wpmayor.com/api/v1/plugins?slugs=contact-form-7,woocommerce" \
  -H "Authorization: Bearer pp_live_your_key_here"

Example response

{
  "generated_at": "2026-07-18T12:00:00.000Z",
  "plugins": [
    {
      "slug": "contact-form-7",
      "name": "Contact Form 7",
      "active_installs": 5000000,
      "health_grade": "A",
      "url": "https://plugins.wpmayor.com/plugin/contact-form-7"
    },
    {
      "slug": "woocommerce",
      "name": "WooCommerce",
      "active_installs": 5000000,
      "health_grade": "A",
      "url": "https://plugins.wpmayor.com/plugin/woocommerce"
    }
  ]
}

GET /api/v1/search

Plugins whose name or slug matches a term. Full serializePlugin objects.

Parameters

• q query, required Search term (min 2 characters).
• limit query, optional Max results. Default 20, max 50.

Example request

curl "https://plugins.wpmayor.com/api/v1/search?q=rss&limit=10" \
  -H "Authorization: Bearer pp_live_your_key_here"

Example response

{
  "query": "rss",
  "count": 10,
  "plugins": [
    {
      "slug": "wp-rss-aggregator",
      "name": "WP RSS Aggregator",
      "active_installs": 40000,
      "rating": 90,
      "health_grade": "A",
      "url": "https://plugins.wpmayor.com/plugin/wp-rss-aggregator"
    }
  ]
}

search_plugins

Search the index by name or slug. Returns matching plugins with installs, ratings, and categories.

Params

query (string, required), limit (number, default 10, max 25)

Returns

{ query, count, plugins: [{ slug, name, active_installs, rating, num_ratings, category }] }

get_plugin

Full snapshot: installs, downloads, ratings, health, integrity, plus an estimated install band.

Params

slug (string, required)

Returns

{ plugin: serializePlugin, install_estimate, generated_at }

plugin_history

Daily history: installs, downloads, rating, directory rank, health, plus milestone band crossings.

Params

slug (string, required), days (number, default 365, max 1500)

Returns

{ slug, days, snapshots: [{ date, active_installs, downloaded, rating, rank_position, health_overall }], milestones }

ranking_optimization

How well a listing is tuned for wp.org search on factors the owner controls. Overall 0-100, factor breakdown, top fix.

Params

slug (string, required)

Returns

{ slug, overall, factors: [{ key, label, score, weight, hint }], topFix }

closure_risk

Maintenance and integrity risk signals that often precede a wp.org closure. Score 0-100 with level low/elevated/high.

Params

slug (string, required)

Returns

{ slug, score, level, factors, integrity }

competitors

Closest rival plugins, ranked by shared wp.org tags then install reach.

Params

slug (string, required), limit (number, default 6, max 20)

Returns

{ slug, count, competitors: [{ slug, name, active_installs, health_grade, health_overall, adjusted_stars, shared_tags }] }

latest_news

Recent release notes and news from the best source (blog RSS, GitHub releases, or wp.org changelog).

Params

slug (string, required), limit (number, default 6, max 25)

Returns

{ slug, count, items: [{ title, url, version, summary, published, source }] }