Browse documentation

API reference

Blog & content

Read published editorial content: posts with pagination and full-text search, categories, tags, authors, featured posts, and the blog landing configuration.

Feature requirement: the project must have the blog feature enabled, or these endpoints return 404.

Only posts with a published status and a past published_at are returned.
GET …/blog/search accepts a q query parameter.

GET/api/v1/storefront/projects/{project_slug}/blog

Get Blog

Parameters
Name	Type	In	Description
project_slug	string	path	Required.

Response 200 · PublicBlogSettingsRead
Field	Type		Description
project_id	string	required	—
title	string	required	—
description	string (nullable)	optional	—
seo	SeoRead	required	Nested SEO metadata for API read responses.

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/authors/{author_slug}

Get Author

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
author_slug	string	path	Required.

Response 200 · PublicAuthorRead
Field	Type		Description
id	string	required	—
display_name	string	required	—
slug	string	required	—
bio	string (nullable)	optional	—
title	string (nullable)	optional	—
avatar_file	FileOut (nullable)	optional	—
social_links	object	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/authors/{author_slug}" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/authors/{author_slug}/posts

List Author Posts

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
author_slug	string	path	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicPostSummary[]
Field	Type		Description
id	string	required	—
title	string	required	—
slug	string	required	—
excerpt	string (nullable)	optional	—
is_featured	boolean	required	—
published_at	string<date-time> (nullable)	optional	—
category	EntitySummary (nullable)	optional	—
featured_image_file	FileOut (nullable)	optional	—
authors	PublicAuthorRead[]	optional	—
tags	EntitySummary[]	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/authors/{author_slug}/posts" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/categories

List Categories

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicCategoryRead[]
Field	Type		Description
id	string	required	—
name	string	required	—
slug	string	required	—
description	string (nullable)	optional	—
seo	SeoRead	required	Nested SEO metadata for API read responses.

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/categories" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/categories/{category_slug}/posts

List Category Posts

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
category_slug	string	path	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicPostSummary[]
Field	Type		Description
id	string	required	—
title	string	required	—
slug	string	required	—
excerpt	string (nullable)	optional	—
is_featured	boolean	required	—
published_at	string<date-time> (nullable)	optional	—
category	EntitySummary (nullable)	optional	—
featured_image_file	FileOut (nullable)	optional	—
authors	PublicAuthorRead[]	optional	—
tags	EntitySummary[]	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/categories/{category_slug}/posts" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/featured-posts

List Featured Posts

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicPostSummary[]
Field	Type		Description
id	string	required	—
title	string	required	—
slug	string	required	—
excerpt	string (nullable)	optional	—
is_featured	boolean	required	—
published_at	string<date-time> (nullable)	optional	—
category	EntitySummary (nullable)	optional	—
featured_image_file	FileOut (nullable)	optional	—
authors	PublicAuthorRead[]	optional	—
tags	EntitySummary[]	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/featured-posts" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/posts

List Posts

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicPostSummary[]
Field	Type		Description
id	string	required	—
title	string	required	—
slug	string	required	—
excerpt	string (nullable)	optional	—
is_featured	boolean	required	—
published_at	string<date-time> (nullable)	optional	—
category	EntitySummary (nullable)	optional	—
featured_image_file	FileOut (nullable)	optional	—
authors	PublicAuthorRead[]	optional	—
tags	EntitySummary[]	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/posts" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/posts/{post_slug}

Get Post

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
post_slug	string	path	Required.

Response 200 · PublicPostDetail
Field	Type		Description
id	string	required	—
title	string	required	—
slug	string	required	—
excerpt	string (nullable)	optional	—
is_featured	boolean	required	—
published_at	string<date-time> (nullable)	optional	—
category	EntitySummary (nullable)	optional	—
featured_image_file	FileOut (nullable)	optional	—
authors	PublicAuthorRead[]	optional	—
tags	EntitySummary[]	optional	—
content_html	string	required	—
seo	SeoRead	required	Nested SEO metadata for API read responses.
gallery	PublicPostGalleryItem[]	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/posts/{post_slug}" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/search

Search Posts

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
q	string	query	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicPostSummary[]
Field	Type		Description
id	string	required	—
title	string	required	—
slug	string	required	—
excerpt	string (nullable)	optional	—
is_featured	boolean	required	—
published_at	string<date-time> (nullable)	optional	—
category	EntitySummary (nullable)	optional	—
featured_image_file	FileOut (nullable)	optional	—
authors	PublicAuthorRead[]	optional	—
tags	EntitySummary[]	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/search" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/tags

List Tags

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicTagRead[]
Field	Type		Description
id	string	required	—
name	string	required	—
slug	string	required	—
description	string (nullable)	optional	—
seo	SeoRead	required	Nested SEO metadata for API read responses.

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/tags" \
  -H "X-Project-Key: wt_pk_your_key"

GET/api/v1/storefront/projects/{project_slug}/blog/tags/{tag_slug}/posts

List Tag Posts

Parameters
Name	Type	In	Description
project_slug	string	path	Required.
tag_slug	string	path	Required.
page	integer	query	Optional. Page number (1-based)
page_size	integer	query	Optional. Number of items per page

Response 200 (list) · PublicPostSummary[]
Field	Type		Description
id	string	required	—
title	string	required	—
slug	string	required	—
excerpt	string (nullable)	optional	—
is_featured	boolean	required	—
published_at	string<date-time> (nullable)	optional	—
category	EntitySummary (nullable)	optional	—
featured_image_file	FileOut (nullable)	optional	—
authors	PublicAuthorRead[]	optional	—
tags	EntitySummary[]	optional	—

Example request

curl "https://api.webtools.ng/api/v1/storefront/projects/your-project/blog/tags/{tag_slug}/posts" \
  -H "X-Project-Key: wt_pk_your_key"

← All resource groups