# Currents API

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

- **Category:** news & lifestyle
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `CURRENTS_API`
- **Version:** 20260211_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Filter news by language (e.g., 'en', 'es', 'fr'). Defaults to English if omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Activities Watch

**Slug:** `CURRENTS_API_ACTIVITIES_WATCH`

Start a push notification channel to watch user activities for Google Workspace applications. This action sets up a webhook to receive real-time notifications when activities occur in Google Workspace apps (admin, calendar, drive, docs, gmail, meet, etc.). Prerequisites: - Valid webhook URL that can receive POST notifications - OAuth credentials with appropriate scopes for the target application - For production use, requires Google Admin Reports API access Use this when you need to monitor user activities in real-time rather than polling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel` | object | Yes | Notification channel configuration including webhook URL, channel ID, and optional parameters |
| `user_key` | string | Yes | 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") | Yes | Google Workspace application to monitor (e.g., 'admin' for admin console, 'drive' for Google Drive, 'calendar' for Google Calendar) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Entity Usage Reports

**Slug:** `CURRENTS_API_ENTITY_USAGE_REPORTS_GET`

Tool to retrieve usage statistics for a specific Google Workspace entity. Use when you need to analyze entity usage on a particular date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date of usage in ISO-8601 format (YYYY-MM-DD). |
| `filters` | string | No | Comma-separated list of filters [app]:[param][operator][value], numeric parameters only; operators: ==, <>, <, <=, >, >=. |
| `entityKey` | string | Yes | Object key to filter by; use 'all' to include all entities. |
| `pageToken` | string | No | Token for fetching the next page of results. |
| `customerId` | string | No | Customer ID to retrieve data for. |
| `entityType` | string | Yes | Type of entity for the report; only 'gplus_communities' is supported. |
| `maxResults` | integer | No | Maximum number of results to return per page. |
| `parameters` | string | No | Comma-separated list of application parameters to include, e.g. 'gplus:numCommunitiesCreated'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Users

**Slug:** `CURRENTS_API_USERS_LIST`

Tool to list users in a Google Workspace domain. Note: - When the provided base_url points to Currents News API (api.currentsapi.services), this action will gracefully fall back to listing latest news articles to ensure a valid response, since the Currents News API does not expose a users endpoint. - When the base_url points to Google Admin Directory API, it will list users from the domain/customer specified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Query string for searching user fields. |
| `domain` | string | No | Domain name to list users from. Provide either `customer` or `domain`. |
| `orderBy` | string ("EMAIL" | "FAMILY_NAME" | "GIVEN_NAME") | No | Property to sort results by. |
| `customer` | string | No | Customer ID (e.g., 'my_customer'). Provide either `customer` or `domain`. |
| `viewType` | string ("admin_view" | "domain_public") | No | View type: 'admin_view' (admin only) or 'domain_public'. |
| `pageToken` | string | No | Token for fetching the next page of results. |
| `sortOrder` | string ("ASCENDING" | "DESCENDING") | No | Sort direction. |
| `maxResults` | integer | No | Maximum number of results to return. |
| `projection` | string ("BASIC" | "CUSTOM" | "FULL") | No | Subset of user fields to include in the response. |
| `showDeleted` | boolean | No | Whether to include deleted users. Defaults to false. |
| `customFieldMask` | string | No | Comma-separated schema names; required only when `projection` is 'CUSTOM'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `country` | string | No | Filter by country code (e.g., 'US', 'GB', 'CA'). Returns news from the specified country. |
| `category` | string | No | Filter by news category (e.g., 'business', 'technology', 'sports', 'entertainment', 'politics'). Use comma-separated values for multiple categories. |
| `end_date` | string | No | 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 | No | Keywords or phrases to search for in news articles (e.g., 'technology', 'climate change'). Separate multiple keywords with spaces or commas. |
| `language` | string | No | Filter news by language code (e.g., 'en' for English, 'es' for Spanish, 'fr' for French). Defaults to English if omitted. |
| `page_size` | integer | No | Number of articles per page (1-200). Defaults to the API's default page size if not specified. |
| `start_date` | string | No | 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 | No | Page number for pagination. Defaults to 1 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |