BTW API Access (30-day free trial)

Authentication

BTW API endpoints require authentication, which you can do with a free trial API key. This key works across both APIs and should be included in the Authorization header of your requests.

For ongoing access to our API or to inquire about a custom endpoint, email us at support@btw.co.

Authorization: Bearer YourApiKey
Get API Key

Endpoints

GET https://btw.co/api/trends/feed sample response

Returns the current top 10 trending stories.

Required Headers
Authorization: Bearer YourApiKey
Optional Headers
Accept: application/json
POST https://btw.co/api/trends/search sample response

Returns current and historically trending stories based on the free-text search input.

Request Body (JSON)
{ "Query": "Weather anomolies in California" }
Alternately, the query parameter can be specified as part of the query string.
GET https://btw.co/api/trends/search?query=Weather anomolies in California
Required Headers
Authorization: Bearer YourApiKey
Optional Headers
Content-Type: application/json
Accept: application/json