Skip to main content
Currents API logo
  • Category: news & lifestyle
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 5
  • Triggers: 0
  • Slug: CURRENTS_API
  • Version: 20261101_00

Tools

Slug: CURRENTS_API_ACTIVITIES_LISTTool to retrieve the latest news articles from Currents News API. Use when you need a real-time feed of recent articles.

Input Parameters

string
Filter news by language (e.g., ‘en’, ‘es’, ‘fr’). Defaults to English if omitted.
integer
Number of articles per page (1-300). Defaults to 30 if omitted.
integer
Page number for pagination (1-180). Defaults to 1 if omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENTS_API_ACTIVITIES_WATCHRequest 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

object
required
Notification channel configuration including webhook URL, channel ID, and optional parameters
string
required
User identifier: use ‘all’ for all domain users, or specify a user’s primary email address or unique user ID
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENTS_API_ENTITY_USAGE_REPORTS_GETRetrieve 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENTS_API_USERS_LISTList 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CURRENTS_API_USER_USAGE_REPORT_GETRetrieve 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not