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.

Excluded content

Content excluded in the Smart Search admin settings (Smart Search → Settings → Excluded Content) is a global setting and is automatically filtered out of this endpoint's results, just like all other Smart Search content results.

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