Endpoints
Search News
Description
This endpoint performs a Google News search using the provided query and optional parameters. It returns information about news articles matching the search criteria.
Endpoint
Headers
- Content-Type:
application/json
- Authorization: Bearer
<API_KEY>
(required)
Request Body
Responses
Success (200)
Returns the search results from Google News.
- Content-Type: application/json
- X-RateLimit-Limit: The rate limit for the user.
- X-RateLimit-Remaining: The remaining number of requests for the user.
Bad Request (400)
Returned if the request is invalid.
Unauthorized (401)
Returned if the API key is invalid or missing.
Internal Server Error (500)
Returned if there’s an error during the search process.
Example Request
Notes
- This endpoint uses 3 credits per page of results.
- The
country
parameter should be a two-letter country code (e.g., “US” for United States). - The
location
parameter can be used to focus the search on a specific area. You can find a list of supported locations at GET:/api/v1/google-locations
- The
language
parameter can be used to specify the desired language for the search results. - Usage is recorded with detailed parameters for each request.
- Events may be logged for analytics purposes if enabled.
Rate Limiting
Rate limit headers (X-RateLimit-Limit
and X-RateLimit-Remaining
) are included in the response to indicate the user’s current rate limit status.