Categories & Keywords

Categories & Keywords

TaskNation organizes services into a hierarchical category system. Each category has associated keywords that customers use to find professionals.

List Categories

GET /api/v2/categories
Authorization: Bearer {accessToken}

# Optional query parameters
?parent_id=0          # Top-level categories
&search=plumbing      # Text search
&limit=50             # Results per page
&offset=0             # Pagination offset

Category Structure

{
  "categories": [
    {
      "id": "100",
      "name": "Home Improvement",
      "parentID": null,
      "children": [
        { "id": "101", "name": "Plumbing", "parentID": "100" },
        { "id": "102", "name": "Electrical", "parentID": "100" },
        { "id": "103", "name": "Painting", "parentID": "100" }
      ]
    }
  ]
}

Search Keywords

GET /api/v2/keywords?search=leak&category_id=101
Authorization: Bearer {accessToken}

Response

{
  "keywords": [
    { "id": "k1", "text": "fix leaky faucet", "categoryID": "101", "volume": "high" },
    { "id": "k2", "text": "pipe leak repair", "categoryID": "101", "volume": "high" },
    { "id": "k3", "text": "water heater leak", "categoryID": "102", "volume": "medium" }
  ]
}