{"name":"WordPress.org Plugin Search API","description":"Plugins from the WordPress.org plugin directory, with name, description, rating and rating count, downloads, version, last update and link, filtered by search text and community or commercial plugins.","api_id":"generated_82899f7d2939c4f2059149d0","slug":"wordpress-org-plugin-search-api","source":{"name":"WordPress.org","domain":"wordpress.org","url":"https://wordpress.org/"},"category":"public_data","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-15","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-14T18:46:08.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_82899f7d2939c4f2059149d0_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"9ae5a496701bf4d62b196ecbddf238833229191f3c82edbe2e7fff9407cccf08","method":"POST","path":"/v1/catalog/public/apis/generated_82899f7d2939c4f2059149d0/endpoints/generated_82899f7d2939c4f2059149d0_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_82899f7d2939c4f2059149d0/endpoints/generated_82899f7d2939c4f2059149d0_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"enrich_records":{"type":"boolean","default":true,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."},"search":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]+$","description":"Optional. Text sent to the site's own search form; its result pages are read and revalidated like the collection. Omit to read the whole collection."},{"type":"array","minItems":1,"items":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]+$","description":"Optional. Text sent to the site's own search form; its result pages are read and revalidated like the collection. Omit to read the whole collection."}}],"description":"Optional. Text sent to the site's own search form; its result pages are read and revalidated like the collection. Omit to read the whole collection. Supply an array to union distinct results from each source search, in query order."},"plugin_business_model":{"x-enum-labels":["Community","Commercial"],"x-value-status":["verified","verified"],"description":"Optional. One observed value of the site's own filter; the pasted page is read with only this value changed and revalidated like the collection. Omit for the pasted page.","x-source-key":"plugin_business_model","type":"string","enum":["community","commercial"]}},"required":[],"additionalProperties":false,"allOf":[{"not":{"required":["search"],"properties":{"search":{"type":"array"}}}}]},"output_schema":{"type":"object","additionalProperties":true,"required":["title","url"],"properties":{"description":{"type":"string"},"image_url":{"type":"string"},"rating":{"type":"number"},"rating_count":{"type":"integer"},"title":{"type":"string"},"title_template":{"type":["string"]},"url":{"type":"string","format":"uri"},"application_category":{"type":"string"},"currency":{"type":"string"},"detail_rating":{"type":"string"},"download_count":{"type":"string"},"download_url":{"type":"string"},"last_modified":{"type":"string"},"operating_system":{"type":"string"},"price":{"type":"string"},"provided_blocks":{"type":"string"},"review_count":{"type":"string"},"software_version":{"type":"string"},"icon_url":{"type":"string"},"banner_url":{"type":"string"},"typed_detail_rating":{"type":"number","minimum":0,"description":"Reviewed numeric reading of detail_rating; source value is preserved.","maximum":5},"typed_download_count":{"type":"integer","minimum":0,"description":"Reviewed numeric reading of download_count; source value is preserved."},"typed_rating":{"type":"number","minimum":0,"description":"Reviewed numeric reading of rating; source value is preserved.","maximum":5},"typed_review_count":{"type":"integer","minimum":0,"description":"Reviewed numeric reading of review_count; source value is preserved."}}},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-14T18:46:08.740Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"application_category":"Plugin","banner_url":"https://ps.w.org/headline-analyzer/assets/banner-772x250.jpg?rev=2738144","currency":"USD","description":"Headline Studio WordPress plugin allows you to easily analyze & improve your headlines as you create content in WordPress","detail_rating":"4.3","download_count":"36696","download_url":"https://downloads.wordpress.org/plugin/headline-analyzer.1.3.8.zip","icon_url":"https://ps.w.org/headline-analyzer/assets/icon-256x256.jpg?rev=2738144","image_url":"https://ps.w.org/headline-analyzer/assets/icon-256x256.jpg?rev=2738144","last_modified":"2026-11-13T16:46:31+00:00","operating_system":"WordPress","price":"0.00","provided_blocks":"This plugin provides 1 block.","rating":4.5,"rating_count":14,"review_count":"14","software_version":"1.3.8","title":"Headline Analyzer","title_template":"%s out of 5 stars","url":"https://wordpress.org/plugins/headline-analyzer/","typed_detail_rating":4.3,"typed_download_count":36696,"typed_review_count":14},{"application_category":"Plugin","banner_url":"https://ps.w.org/wpo-tweaks/assets/banner-1544x500.jpg?rev=3568326","currency":"USD","description":"Page cache, browser cache, defer JS, critical CSS, lazy load and WordPress cleanup. Speed up your site and disable the bloat you do not need.","detail_rating":"5","download_count":"200945","download_url":"https://downloads.wordpress.org/plugin/wpo-tweaks.3.7.3.zip","icon_url":"https://ps.w.org/wpo-tweaks/assets/icon-256x256.jpg?rev=3567304","image_url":"https://ps.w.org/wpo-tweaks/assets/icon-256x256.jpg?rev=3567304","last_modified":"2026-11-02T17:39:30+00:00","operating_system":"WordPress","price":"0.00","rating":5,"rating_count":39,"review_count":"39","software_version":"3.7.3","title":"DietPress","title_template":"%s out of 5 stars","url":"https://wordpress.org/plugins/wpo-tweaks/","typed_detail_rating":5,"typed_download_count":200945,"typed_review_count":39}]}],"request_example":{"body":{"input":{"plugin_business_model":"community"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_82899f7d2939c4f2059149d0/endpoints/generated_82899f7d2939c4f2059149d0_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"plugin_business_model\": \"community\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_82899f7d2939c4f2059149d0/endpoints/generated_82899f7d2939c4f2059149d0_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/wordpress-org-plugin-search-api/","markdown":"https://cleanedweb.com/catalog/wordpress-org-plugin-search-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_82899f7d2939c4f2059149d0/endpoints/generated_82899f7d2939c4f2059149d0_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/wordpress-org-plugin-search-api/","markdown":"https://cleanedweb.com/catalog/wordpress-org-plugin-search-api/index.md","contract":"https://cleanedweb.com/catalog/wordpress-org-plugin-search-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
