Do not hardcode these values in your frontend code. WhatsApp may add new categories (e.g., "Gaming" or "Science") in the future. Best Practice: Fetch this list once on app load and populate your "Filter by Topic" dropdown dynamically.

Common categories include: ENTERTAINMENT SPORTS LIFESTYLE BUSINESS NEWS ORGANIZATIONS

Get Channel Categories

Retrieve available channel categories for searching.

GET

https://api.wawp.net/v2/channels/search/categories?access_token=123456789&instance_id=123456789

Authentication Required

Test /v2/channels/search/categories endpoint

Supports

GET

No query parameters required

This endpoint doesn't expect data in the URL.

Best practices

Cache this list; categories rarely change.
Display these categories in your UI to help users filter searches.

Filter Keys: Channel Categories

The /v2/channels/search/categories endpoint returns the official list of topic filters supported by the WhatsApp directory.

🎯 Implementation Strategy

Dynamic Dropdowns

Do not hardcode these values in your frontend code. WhatsApp may add new categories (e.g., "Gaming" or "Science") in the future.

Best Practice: Fetch this list once on app load and populate your "Filter by Topic" dropdown dynamically.

Standard Values

Common categories include:

ENTERTAINMENT
SPORTS
LIFESTYLE
BUSINESS
NEWS
ORGANIZATIONS

Request Parameters

Configure the parameters required to interact with this endpoint. All query and body arguments are listed below with their details.

URL Parameters

Passed in the URL query string

	`string`		Your unique WhatsApp Instance ID Example:
	`string`		Your API Access Token Example:

Request Samples

Use these ready-to-go code snippets to integrate our API into your project quickly and efficiently. Choose your preferred language and library.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/channels/search/categories";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10  method: "GET",
11  headers: { "Content-Type": "application/json" },
12  
13})
14  .then(async (response) => {
15    if (response.ok) {
16      const data = await response.json();
17      console.log("Success:", data);
18      return data;
19    }
20    
21    // Error Handling
22    if (response.status === 401) {
23      console.error("Error 401: Unauthorized - Invalid or Missing Access Token");
24    }
25    if (response.status === 500) {
26      console.error("Error 500: Internal Server Error - Unexpected Failure");
27    }
28
29    const errorText = await response.text();
30    console.error(`Error ${response.status}: ${errorText}`);
31  })
32  .catch((error) => console.error("Network Error:", error));

Interactive SamplesUTF-8

Ln 32, Col 1javascript

Expected Responses

Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.

Categories retrieved successfully

application/json

string *

Example

{
"0": "Entertainment",
"1": "News",
"2": "Technology"
}

Unauthorized - Invalid or Missing Access Token

Internal Server Error - Unexpected Failure