Skip to main content

Step 1: Make Your First API Call

Let’s retrieve all articles in your workspace using a GET request:
curl -X GET "https://{your-subdomain}.neetokb.com/api/external/v1/articles" \
  -H 'X-Api-Key: your-api-key' \
  -H 'Content-Type: application/json'
Replace your-subdomain with your actual workspace subdomain and your-api-key with your generated API key.

Step 2: Understanding the Response

A successful response will look like this JSON format:
{
  "articles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "slug": "getting-started",
      "title": "Getting Started Guide",
      "state": "published",
      "unique_views_count": 123,
      "category": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Tutorials"
      }
    }
  ],
  "pagination": {
    "total_records": 123,
    "total_pages": 5,
    "current_page_number": 1,
    "page_size": 30
  }
}

Next Steps

Now that you’ve made your first API call, you can:

Explore API Reference

Browse all available endpoints and their detailed documentation.

Pagination

Understand how to paginate through API responses efficiently.

HTTP response codes

Learn what different response codes mean and how to handle them.