Search API
Search for radio stations and genres globally.
Global Search
Perform a comprehensive search across stations and genres.
Endpoint: GET /api/v1/search
Authentication: Required
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query (min 2 chars) |
stations_limit | int | No | Max stations to return (1-50) |
categories_limit | int | No | Max categories to return (1-20) |
genre_id | int | No | Filter by genre ID |
country_id | int | No | Filter by country ID |
country | string | No | Filter by country name |
Response
{
"success": true,
"message": "Search results retrieved successfully",
"data": {
"stations": [ { ...RadioResource } ],
"categories": [ { ...GenreObject } ],
"countries": [],
"suggestions": []
}
}Search Suggestions
Get autocomplete suggestions for a query.
Endpoint: GET /api/v1/search/suggestions
Authentication: Required
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Partial query string |
limit | int | No | Max suggestions (default 8) |
Response
{
"success": true,
"message": "Suggestions retrieved successfully",
"data": [
"Pop music",
"Pop hits",
"Popular radio"
]
}Trending Searches
Get popular search terms.
Endpoint: GET /api/v1/search/trending
Authentication: Required
Response
{
"success": true,
"message": "Trending searches retrieved successfully",
"data": [
"News",
"Jazz",
"Top 40"
]
}