Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

Email Marketing

Knowledge

getList ArticlesgetGet ArticlepostCreate ArticleputUpdate ArticledelDelete ArticlegetGet Public ArticlegetGet Public Articles By IDsgetGet Related ArticlesgetSearch ArticlesgetInstant Search ArticlespostAdd Article ReactionpostIncrement Article Views

Support

Projects

Articles

Get Public Articles By IDs

Fetches several published articles in one call, for rendering a curated or recommended set without a request per article. Unknown or non-public IDs are skipped, so the response can be shorter than the list you sent and the order is not guaranteed to match.

GET
/knowledge/articles/by-ids

Authorization

Authorization
AuthorizationBearer <token>

In: header

Query Parameters

helpCenterIdrequiredstring

ID of the help center publishing the articles.

idsrequiredarray<string>

IDs of the articles to fetch.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/knowledge/articles/by-ids?helpCenterId=string&ids=string"
[
  {
    "id": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "projectId": "string",
    "type": "public",
    "title": "string",
    "slug": "string",
    "description": "string",
    "body": "string",
    "url": "string",
    "state": "draft",
    "order": -9007199254740991,
    "collectionId": "string",
    "authorId": "string",
    "views": -9007199254740991,
    "conversions": -9007199254740991,
    "happyReactions": -9007199254740991,
    "neutralReactions": -9007199254740991,
    "sadReactions": -9007199254740991,
    "author": {
      "id": "string",
      "image": "string",
      "name": "string"
    },
    "collection": {
      "helpCenterId": "string",
      "name": "string"
    }
  }
]
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Get Public Article

Fetches a published article by its URL slug: the reader-facing lookup behind a help-center page. Public and unauthenticated. Drafts and internal articles are never returned; anything not publicly visible comes back as `null`.

Get Related Articles

Suggests further reading for an article, for a "related articles" block at the foot of a help-center page. Relatedness is text similarity: the source article's title and description are matched against other articles in the same help center. Only published public articles are considered on both sides, so an unpublished or internal source article returns an empty list rather than an error. Defaults to 5 results.