Search publishers
curl --request GET \
--url https://api.bonai.io/news/search/publishers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.bonai.io/news/search/publishers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bonai.io/news/search/publishers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bonai.io/news/search/publishers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}curl --request GET \
--url https://api.bonai.io/news/search/publishers \
--header 'Authorization: Bearer <token>'{
"metadata": {
"id": "<string>",
"took_ms": 123,
"timestamp": "2023-11-07T05:31:56Z"
},
"parameters": {},
"publishers": [
{
"title": "<string>",
"name": "<string>",
"url": "<string>",
"language": "<string>",
"category": "<string>",
"description": "<string>",
"logo": "<string>",
"favicon": "<string>",
"links": [
{
"type": "<string>",
"url": "<string>",
"username": "<string>"
}
]
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}API Reference
Search publishers
Search for news publishers with various filters
GET
/
search
/
publishers
Search publishers
curl --request GET \
--url https://api.bonai.io/news/search/publishers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.bonai.io/news/search/publishers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bonai.io/news/search/publishers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bonai.io/news/search/publishers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}curl --request GET \
--url https://api.bonai.io/news/search/publishers \
--header 'Authorization: Bearer <token>'{
"metadata": {
"id": "<string>",
"took_ms": 123,
"timestamp": "2023-11-07T05:31:56Z"
},
"parameters": {},
"publishers": [
{
"title": "<string>",
"name": "<string>",
"url": "<string>",
"language": "<string>",
"category": "<string>",
"description": "<string>",
"logo": "<string>",
"favicon": "<string>",
"links": [
{
"type": "<string>",
"url": "<string>",
"username": "<string>"
}
]
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}{
"success": false,
"code": 123,
"message": "<string>",
"fields": [
{
"name": "<string>",
"type": "<string>",
"description": "<string>"
}
]
}Authorizations
Your Bonai API key, sent as Authorization: Bearer <key>. The api-key and x-api-key headers are also accepted.
Headers
API version to consume. Defaults to the latest version (2026-08-01).
Available options:
2026-08-01, 2024-01-01, 2022-01-01 Query Parameters
Search query string
Minimum string length:
1Publisher category
Country code
Language code
Number of results
Required range:
1 <= x <= 100Sort order
Response
Successful response
The query parameters used for this request
Hide child attributes
Hide child attributes
Defaults to "General" when unknown
Was this page helpful?