API Direct News Articles Search

Choose this endpoint when you need to search news articles by keyword across a broad set of worldwide sources, especially when you want to filter by country, language, source domain, or recency. Prefer it over social media search endpoints when editorial/journalistic content is needed. It supports up to 100 results per call and fine-grained time filters (last hour, day, week, year, or anytime).

• Blank or missing query parameter returns an error — query is required and cannot be empty
• Invalid country code (not exactly 2 letters) returns a validation error
• Invalid language code (not exactly 2 letters) returns a validation error
• Invalid time_published value outside the allowed enum returns a validation error
• limit out of range (below 1 or above 100) returns a validation error
• Fewer articles than requested may be returned if insufficient results exist for the query
• Payment failure via x402 protocol blocks the request entirely