> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Currents API

> Currents News API provides access to the latest news articles from various sources worldwide, supporting multiple languages and categories.

![Currents API logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/currents_api.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=4801da3b6db7955a2abca435fc887715)

* **Category:** news & lifestyle
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 5
* **Triggers:** 0
* **Slug:** `CURRENTS_API`
* **Version:** 20261101\_00

## Tools

> [accordion] List Latest News
>
> **Slug:** `CURRENTS_API_ACTIVITIES_LIST`
>
> Tool to retrieve the latest news articles from Currents News API. Use when you need a real-time feed of recent articles.
>
> #### Input Parameters
>
> **language** `string`
>
> Filter news by language (e.g., 'en', 'es', 'fr'). Defaults to English if omitted.
>
> **page\_size** `integer`
>
> Number of articles per page (1-300). Defaults to 30 if omitted.
>
> **page\_number** `integer`
>
> Page number for pagination (1-180). Defaults to 1 if omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Activities Watch
>
> **Slug:** `CURRENTS_API_ACTIVITIES_WATCH`
>
> Request a push notification channel for user activities in a supported Google Workspace application using a Google Admin Reports API base URL. A Currents News API connection does not create an activity watch.
>
> #### Input Parameters
>
> **channel** `object` *required*
>
> Notification channel configuration including webhook URL, channel ID, and optional parameters
>
> **user\_key** `string` *required*
>
> User identifier: use 'all' for all domain users, or specify a user's primary email address or unique user ID
>
> **application\_name** `string ("admin" | "calendar" | "class" | "drive" | "docs" | "gplus" | "license" | "login" | "mobile" | "token" | "meet" | "chrome" | "groups")` *required*
>
> Google Workspace application to monitor (e.g., 'admin' for admin console, 'drive' for Google Drive, 'calendar' for Google Calendar)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Entity Usage Reports
>
> **Slug:** `CURRENTS_API_ENTITY_USAGE_REPORTS_GET`
>
> Retrieve a Google Workspace entity usage report for a particular date. The supported entity type is Google+ communities; select a specific entity or all entities.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> Date of usage in ISO-8601 format (YYYY-MM-DD).
>
> **filters** `string`
>
> Comma-separated list of filters \[app]:\[param]\[operator]\[value], numeric parameters only; operators: ==, \<>, \<, \<=, >, >=.
>
> **entityKey** `string` *required*
>
> Object key to filter by; use 'all' to include all entities.
>
> **pageToken** `string`
>
> Token for fetching the next page of results.
>
> **customerId** `string`
>
> Customer ID to retrieve data for.
>
> **entityType** `string` *required*
>
> Type of entity for the report; only 'gplus\_communities' is supported.
>
> **maxResults** `integer`
>
> Maximum number of results to return per page.
>
> **parameters** `string`
>
> Comma-separated list of application parameters to include, e.g. 'gplus:numCommunitiesCreated'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users
>
> **Slug:** `CURRENTS_API_USERS_LIST`
>
> List Google Workspace users for a domain or customer using a Google Admin Directory API base URL. Supports searching, sorting, field projections and pagination; a Currents News API connection does not list Workspace users.
>
> #### Input Parameters
>
> **query** `string`
>
> Query string for searching user fields.
>
> **domain** `string`
>
> Domain name to list users from. Provide either `customer` or `domain`.
>
> **orderBy** `string ("EMAIL" | "FAMILY_NAME" | "GIVEN_NAME")`
>
> Property to sort results by.
>
> **customer** `string`
>
> Customer ID (e.g., 'my\_customer'). Provide either `customer` or `domain`.
>
> **viewType** `string ("admin_view" | "domain_public")`
>
> View type: 'admin\_view' (admin only) or 'domain\_public'.
>
> **pageToken** `string`
>
> Token for fetching the next page of results.
>
> **sortOrder** `string ("ASCENDING" | "DESCENDING")`
>
> Sort direction.
>
> **maxResults** `integer`
>
> Maximum number of results to return.
>
> **projection** `string ("BASIC" | "CUSTOM" | "FULL")`
>
> Subset of user fields to include in the response.
>
> **showDeleted** `boolean`
>
> Whether to include deleted users. Defaults to false.
>
> **customFieldMask** `string`
>
> Comma-separated schema names; required only when `projection` is 'CUSTOM'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search News Articles
>
> **Slug:** `CURRENTS_API_USER_USAGE_REPORT_GET`
>
> Retrieve news articles from Currents News API with flexible search and filtering. Use this tool to: - Search for news articles by keywords or phrases - Filter articles by language, category, country, or date range - Retrieve paginated results for large result sets - Access comprehensive news data including titles, descriptions, authors, and publication dates This tool provides access to real-time global news content for information gathering, research, monitoring, or content curation purposes.
>
> #### Input Parameters
>
> **country** `string`
>
> Filter by country code (e.g., 'US', 'GB', 'CA'). Returns news from the specified country.
>
> **category** `string`
>
> Filter by news category (e.g., 'business', 'technology', 'sports', 'entertainment', 'politics'). Use comma-separated values for multiple categories.
>
> **end\_date** `string`
>
> End date for news articles in RFC 3339 format (e.g., '2026-01-28T23:59:59Z'). Returns articles published on or before this date.
>
> **keywords** `string`
>
> Keywords or phrases to search for in news articles (e.g., 'technology', 'climate change'). Separate multiple keywords with spaces or commas.
>
> **language** `string`
>
> Filter news by language code (e.g., 'en' for English, 'es' for Spanish, 'fr' for French). Defaults to English if omitted.
>
> **page\_size** `integer`
>
> Number of articles per page (1-200). Defaults to the API's default page size if not specified.
>
> **start\_date** `string`
>
> Start date for news articles in RFC 3339 format (e.g., '2026-01-20T00:00:00Z'). Returns articles published on or after this date.
>
> **page\_number** `integer`
>
> Page number for pagination. Defaults to 1 if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
