Skip to content

Search Content

POSThttps://rebuyengine.com/api/v1/smart-search/content

Returns a list of content (articles, blog posts) based on the given POST parameters. Use this endpoint to search and retrieve store content independently from product search.

Headers

Rebuy-Api-Key · string · required
Your Rebuy public API key

Body Parameters

genericSearchTerm · string
A search term to match against content titles, body text, and other indexed fields
fieldsTemplate · string
Controls which fields are returned in the response. Use full to return all available fields
filters · object
Specifies the filtering criteria for the content query
filters.content_type · string
The type of content to return (e.g., article)
noContent · boolean
When set to true, excludes content body from the response. Defaults to false
sortField · string
The field to sort results by (e.g., published_at)
sortOrder · string
Sort order: asc or desc
pageSize · integer
The number of content results to be returned per page
currentPage · integer
The current page number of content results to be retrieved

Response Fields

content · array of objects

Each content object contains the following fields:

Field Type Description
blogHandle string The URL-friendly handle of the blog
blogId integer The Shopify blog ID
blogTitle string The name of the blog the article belongs to
bodySummary string A summary of the content body
createdAt string The creation date in ISO 8601 format
gid string The Shopify global ID (e.g., gid://shopify/Article/123)
handle string The URL-friendly handle for the content
id string The composite identifier (shopId:shopifyId)
indexedAt string The date the content was last indexed in ISO 8601 format
isPublished boolean Whether the content is currently published
publishedAt string The publish date in ISO 8601 format
shopId integer The Rebuy shop ID
shopifyId integer The Shopify article ID
tags array of strings Tags associated with the content
title string The title of the article or blog post
type string The content type (e.g., article)
updatedAt string The date the content was last updated in ISO 8601 format

Code Example

fetch("https://rebuyengine.com/api/v1/smart-search/content", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Rebuy-Api-Key": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    genericSearchTerm: "toys",
    fieldsTemplate: "full",
    filters: {
      content_type: "article"
    },
    noContent: false,
    sortField: "published_at",
    sortOrder: "asc",
    pageSize: 50,
    currentPage: 1
  })
})
  .then(response => response.json())
  .then(data => console.log(data));

Response Examples

200 OK

{
  "successful": true,
  "data": {
    "content": [
      {
        "blogHandle": "news",
        "blogId": 105987572005,
        "blogTitle": "News",
        "bodySummary": "",
        "createdAt": "2026-01-22T22:12:07Z",
        "gid": "gid://shopify/Article/689285792037",
        "handle": "level-up-your-playtime-why-every-ben-10-fan-needs-these-awesome-new-gadgets-and-figures",
        "id": "15777:689285792037",
        "indexedAt": "2026-02-19T19:13:37+00:00",
        "isPublished": true,
        "publishedAt": "2026-01-22T22:12:07Z",
        "shopId": 15777,
        "shopifyId": 689285792037,
        "tags": [
          "10",
          "ben"
        ],
        "title": "Level Up Your Playtime: Why Every Ben 10 Fan Needs These Awesome New Gadgets and Figures",
        "type": "article",
        "updatedAt": "2026-01-22T22:12:07Z"
      }
    ],
    "page_info": [],
    "search_metadata": []
  },
  "status": 200,
  "errorMessage": null
}
See something that needs updating? Suggest an edit