Schema
The schema defines all the fields that exist within a block directory item record. Any response from these endpoints can be expected to contain the fields below unless the `_filter` query parameter is used or the schema field only appears in a specific context.
name
|
The block name, in namespace/block-name format.
JSON data type: string Context: |
title
|
The block title, in human readable format.
JSON data type: string Context: |
description
|
A short description of the block, in human readable format.
JSON data type: string Context: |
id
|
The block slug.
JSON data type: string Context: |
rating
|
The star rating of the block.
JSON data type: number Context: |
rating_count
|
The number of ratings.
JSON data type: integer Context: |
active_installs
|
The number sites that have activated this block.
JSON data type: integer Context: |
author_block_rating
|
The average rating of blocks published by the same author.
JSON data type: number Context: |
author_block_count
|
The number of blocks published by the same author.
JSON data type: integer Context: |
author
|
The WordPress.org username of the block author.
JSON data type: string Context: |
icon
|
The block icon.
JSON data type: string, Context: |
last_updated
|
The date when the block was last updated.
JSON data type: string, Context: |
humanized_updated
|
The date when the block was last updated, in fuzzy human readable format.
JSON data type: string Context: |
List Block Directory Items
Query this endpoint to retrieve a collection of block directory items. The response you receive can be controlled and filtered using the URL query parameters below.
Definition
GET /wp/v2/block-directory/search
Example Request
$ curl https://example.com/wp-json/wp/v2/block-directory/search
Arguments
context
|
Scope under which the request is made; determines fields present in response.
Default: One of: |
page
|
Current page of the collection.
Default: |
per_page
|
Maximum number of items to be returned in result set.
Default: |
term
|
Limit result set to blocks matching the search term.
Required: 1 |