Skip to main content
GET
/
api
/
marketplace
/
knowledge-bases
List Knowledge Bases
curl --request GET \
  --url https://api.example.com/api/marketplace/knowledge-bases
{
  "items": [
    {
      "id": "<string>",
      "title": "<string>",
      "publisher": "<string>",
      "summary": "<string>",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "subscribersCount": 123,
      "queryVolume": 123,
      "updatedAt": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "pageSize": 123,
  "totalPages": 123
}

​
Endpoint

GET https://api.ardie.ai/api/marketplace/knowledge-bases
This endpoint is publicly accessible and does not require authentication.

​
Query Parameters

​
query
string
Search term to filter knowledge bases by title, description, or publisher.
​
category
string
Filter by category. Options: education, policy, health, research, legal
​
tags
string[]
Filter by one or more tags.
​
sort
string
default:"popular"
Sort order. Options: popular, new, updated
​
page
integer
default:"1"
Page number for pagination.
​
pageSize
integer
default:"12"
Number of results per page (max 50).

​
Example Request

curl "https://api.ardie.ai/api/marketplace/knowledge-bases?query=education&category=education&sort=popular&page=1&pageSize=12"

​
Response

​
items
array
List of knowledge base objects.
​
total
integer
Total number of matching knowledge bases.
​
page
integer
Current page number.
​
pageSize
integer
Number of results per page.
​
totalPages
integer
Total number of pages available.

​
Example Response

{
  "items": [
    {
      "id": "kb_edu_123",
      "title": "K-12 Curriculum Standards",
      "publisher": "Education Standards Board",
      "summary": "Comprehensive curriculum standards for K-12 education across all subjects.",
      "category": "education",
      "tags": ["curriculum", "k-12", "standards"],
      "subscribersCount": 245,
      "queryVolume": 15420,
      "updatedAt": "2024-01-15T10:30:00Z"
    },
    {
      "id": "kb_edu_456",
      "title": "Higher Education Research",
      "publisher": "Academic Research Institute",
      "summary": "Research papers and studies on higher education pedagogy.",
      "category": "education",
      "tags": ["higher-ed", "research", "pedagogy"],
      "subscribersCount": 89,
      "queryVolume": 4230,
      "updatedAt": "2024-01-10T14:20:00Z"
    }
  ],
  "total": 24,
  "page": 1,
  "pageSize": 12,
  "totalPages": 2
}

​
Next Steps

Query a Knowledge Base

Once you’ve found a knowledge base, learn how to query it.