Algorithm: Based on the phone number's region and general popularity. Use Case: The default "Discovery" feed for a new user.

Algorithm: Strictly ranked by subscriber count (highest to lowest). Use Case: Finding the "Giants" of the platform.

Algorithm: Recently created channels that are gaining traction. Use Case: Finding emerging creators. ---

You can combine a View with a Country Code. Example: view=POPULAR + countries=EG (Egypt) Result: Returns the most followed channels specifically within Egypt, rather than global celebrities. ---

Channels Control

Search Channels by View

Search for channels based on views like RECOMMENDED.

GET

https://api.wawp.net/v2/channels/search/view?access_token=123456789&categories=ENTERTAINMENT&countries=US&instance_id=123456789&limit=10&startCursor=value&view=RECOMMENDED

Authentication Required

Test /v2/channels/search/view endpoint

Supports

GET

No query parameters required

This endpoint doesn't expect data in the URL.

Visuals

Optimized for rendering search result cards.

Badges

Includes verification badge status in the response.

Best practices

Always display the Verified badge if present to build trust.
Show the follower count to indicate popularity.

Discovering Trends: Search by View

The /v2/channels/search/view endpoint allows you to tap into WhatsApp's curated lists. Instead of searching for a specific keyword, you are asking: "What is popular right now?"

🔭 Available Views

The view parameter controls the ranking algorithm:

1. RECOMMENDED

Algorithm: Based on the phone number's region and general popularity.
Use Case: The default "Discovery" feed for a new user.

2. POPULAR

Algorithm: Strictly ranked by subscriber count (highest to lowest).
Use Case: Finding the "Giants" of the platform.

3. NEW

Algorithm: Recently created channels that are gaining traction.
Use Case: Finding emerging creators.

🌍 Geo-Targeting

You can combine a View with a Country Code.

Example: view=POPULAR + countries=EG (Egypt)
Result: Returns the most followed channels specifically within Egypt, rather than global celebrities.

💡 Implementation Tip

If you are building a "Channel Browser" in your app:

Tab 1 (Trending): Call view=RECOMMENDED.
Tab 2 (Top Charts): Call view=POPULAR.
Tab 3 (Local): Call view=POPULAR + country={User's Country}.

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:
	`string`		The view to search by (e.g. RECOMMENDED, POPULAR, NEW) Example:
	`array[string]`		Filter by countries (comma separated). e.g. EG,US,SA Example:
	`array[string]`		Filter by categories. e.g. ENTERTAINMENT,SPORTS Example:
	`number`		Maximum number of results Example:
	`string`		Cursor for pagination. Leave as empty string for the first page.

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/view";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789",
6  "view": "RECOMMENDED",
7  "countries": "US",
8  "categories": "ENTERTAINMENT",
9  "limit": "10",
10  "startCursor": ""
11}).toString();
12
13
14fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
15  method: "GET",
16  headers: { "Content-Type": "application/json" },
17  
18})
19  .then(async (response) => {
20    if (response.ok) {
21      const data = await response.json();
22      console.log("Success:", data);
23      return data;
24    }
25    
26    // Error Handling
27    if (response.status === 401) {
28      console.error("Error 401: Unauthorized - Invalid or Missing Access Token");
29    }
30    if (response.status === 500) {
31      console.error("Error 500: Internal Server Error - Unexpected Failure");
32    }
33
34    const errorText = await response.text();
35    console.error(`Error ${response.status}: ${errorText}`);
36  })
37  .catch((error) => console.error("Network Error:", error));

Interactive SamplesUTF-8

Ln 37, 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.

Channels retrieved successfully

application/json

array *

string *

Example

{
"channels": {
  },
"nextCursor": "cursor_456"
}

Unauthorized - Invalid or Missing Access Token

Internal Server Error - Unexpected Failure