apidirect-io News API

Search news articles from worldwide sources with time, source, country, and language filters.

Operations 1

GET /v1/news/articles Search News Articles #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/apidirect-io:apidirect-io-news-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

apidirect-io-news-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Apidirect Io News API
  version: 1.9.1
  contact:
    name: API Direct support
    url: https://apidirect.io
    email: support@apidirect.io
  termsOfService: https://apidirect.io/terms
  x-refined-note:
  - x-guidance differs across the merged source definitions and was not carried
  x-logo:
    url: https://apidirect.io/static/A.png
    altText: API Direct
  description: 'Operations tagged News across 2 of this provider''s published API definitions: apidirect-io-openapi.json, apidirect-io-x402-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://apidirect.io
  description: Production
- description: x402 (pay per request in USDC, no API key)
  url: https://x402.apidirect.io
tags:
- name: News
  description: Search news articles from worldwide sources with time, source, country, and language filters.
paths:
  /v1/news/articles:
    get:
      tags:
      - News
      operationId: searchNews
      summary: Search News Articles
      description: 'Search for news articles from worldwide sources by keyword. Returns the article headline, URL, snippet, publication time in UTC, authors, photo and thumbnail URLs, and the source name, URL, favicon, and domain. Supports filtering by publication time, source, country, and language. The response also includes the requested limit and a count of the articles actually returned.


        **Price:** $0.008 per request. **Free tier:** 50 requests/month.'
      externalDocs:
        url: https://apidirect.io/docs/news-articles
      parameters:
      - name: query
        in: query
        required: true
        description: Search query (max 500 characters, cannot be blank)
        schema:
          type: string
          maxLength: 500
        example: artificial intelligence
      - name: limit
        in: query
        required: false
        description: Maximum number of results to return (1-100). Fewer may come back; the response count field reports how many articles were returned.
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 10
        example: 10
      - name: time_published
        in: query
        required: false
        description: 'Filter by publication time: anytime, 1h, 1d, 7d, or 1y'
        schema:
          type: string
          enum:
          - anytime
          - 1h
          - 1d
          - 7d
          - 1y
          default: anytime
        example: 1d
      - name: source
        in: query
        required: false
        description: Filter by news source domain (e.g., bbc.com, reuters.com, cnn.com)
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: 2-letter ISO 3166-1 alpha-2 country code (e.g., us, gb, de, jp). Must be exactly 2 letters.
        schema:
          type: string
          minLength: 2
          maxLength: 2
          default: us
        example: us
      - name: language
        in: query
        required: false
        description: 2-letter ISO 639-1 language code (e.g., en, es, fr, de, ja). Must be exactly 2 letters.
        schema:
          type: string
          minLength: 2
          maxLength: 2
          default: en
        example: en
      x-example-query:
        query: artificial intelligence
        limit: 10
        time_published: 1d
        country: us
        language: en
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchNewsResponse'
              example:
                articles:
                - authors: []
                  domain: singularityhub.com
                  photo_url: https://singularityhub.com/uploads/2026/04/quantum_computing_ibm-scaled.webp?auto=webp&auto=webp&optimize=high&quality=70&width=1440
                  published_datetime_utc: '2026-04-03T20:20:23.000Z'
                  snippet: With billions invested and prototypes being tested outside the lab, the quantum era is starting to take shape.
                  source_favicon_url: https://encrypted-tbn1.gstatic.com/faviconV2?url=https://singularityhub.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: SingularityHub
                  source_url: https://singularityhub.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iK0NnNVFZVWd4YzAxdlRrbExUV3AyVFJDZkF4ampCU2dLTWdZWkVvelBwQVE=-w200-h200-p-df-rw
                  title: Five Ways Quantum Technology Could Shape Everyday Life
                  url: https://singularityhub.com/2026/04/03/five-ways-quantum-technology-could-shape-everyday-life/
                - authors: []
                  domain: iiss.org
                  photo_url: https://www.iiss.org/globalassets/media-library---content--migration/images-delta/charting/middle-east/2026/04/cme-thumbnail.png
                  published_datetime_utc: '2026-04-02T08:20:05.000Z'
                  snippet: The Israel–Hamas war of May 2021 was described in the Israeli press as 'the world's first AI war', integrating a number of new artificial ...
                  source_favicon_url: https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.iiss.org&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: The International Institute for Strategic Studies
                  source_url: https://www.iiss.org
                  thumbnail_url: https://news.google.com/api/attachments/CC8iL0NnNURkRzFwVWxCSVFqRnpWMDl0VFJDZkF4ampCU2dLTWdrQkFJNmxpR2hjVHdF=-w200-h200-p-df-rw
                  title: The proliferation of AI-enabled military technology in the Middle East
                  url: https://www.iiss.org/online-analysis/charting-middle-east/2026/04/the-proliferation-of-ai-enabled-military-technology-in-the-middle-east/
                - authors:
                  - Sana Pashankar
                  domain: bloomberg.com
                  photo_url: https://assets.bwbx.io/images/users/iqjWHBFdfxIU/i4G0Mq8AsNSs/v0/-1x-1.webp
                  published_datetime_utc: '2026-04-04T20:10:04.000Z'
                  snippet: Satellite startup Impulse Space is working with Anduril Industries Inc to develop space-based interceptor technology for President Donald ...
                  source_favicon_url: https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.bloomberg.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: Bloomberg.com
                  source_url: https://www.bloomberg.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iK0NnNXZlVzlrVmtZMlowdFBVRXBRVFJERUF4aW1CU2dLTWdZSmFKQ0hwZ2c=-w200-h200-p-df-rw
                  title: Impulse Space, Anduril Building Space Technology for Golden Dome
                  url: https://www.bloomberg.com/news/articles/2026-04-04/impulse-space-anduril-building-space-technology-for-golden-dome
                - authors:
                  - Munsif Vengattil
                  domain: reuters.com
                  photo_url: https://www.reuters.com/resizer/v2/RANQDCN7NBGITMYDHT7EW33KQ4.jpg?auth=e7831e5ae75483bff1f95649d934dab25cef7a7534733270ba1525140c63fc11&width=1920&quality=80
                  published_datetime_utc: '2026-04-04T05:00:00.000Z'
                  snippet: India's studios are transforming filmmaking by using AI to slash production time, cut costs and dub movies into numerous languages.
                  source_favicon_url: https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.reuters.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: reuters.com
                  source_url: https://www.reuters.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iK0NnNTVjRFJYYzNvM1V6bHlhMVpTVFJERUF4aW1CU2dLTWdhUmNwSXNMUWM=-w200-h200-p-df-rw
                  title: AI is rewiring the world’s most prolific film industry
                  url: https://www.reuters.com/technology/ai-is-rewiring-worlds-most-prolific-film-industry-2026-04-04/
                - authors:
                  - Alexis Dominguez
                  domain: azfamily.com
                  photo_url: https://gray-kpho-prod.gtv-cdn.com/resizer/v2/7QSEZLQ33NCIBNMXDRHECTTRMY.png?auth=b143eaf03ec632ea4d09aae15b81c96913bb2b149b305623dab50320c1c43dec&width=1200&height=600&smart=true
                  published_datetime_utc: '2026-04-04T00:24:00.000Z'
                  snippet: Cold case units crack decades-old missing person case and 2023 homicide using modern tools and renewed efforts ... Cold case units in Arizona ...
                  source_favicon_url: https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.azfamily.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: AZ Family
                  source_url: https://www.azfamily.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iL0NnNU9iMVZXZDB0cExYQktXWFZpVFJDSEF4aVBCaWdLTWdrQllvclZPT2JRREFJ=-w200-h200-p-df-rw
                  title: Arizona cold cases solved with new technology, fresh investigations
                  url: https://www.azfamily.com/2026/04/04/arizona-cold-cases-solved-with-new-technology-fresh-investigations/
                - authors:
                  - Raffaele Huang
                  domain: wsj.com
                  photo_url: https://images.wsj.net/im-48180985
                  published_datetime_utc: '2026-04-03T03:00:00.000Z'
                  snippet: Chinese companies are cementing their role in the humanoid robot supply chain, providing components for motion, while the U.S. leads in AI chips ...
                  source_favicon_url: https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.wsj.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: WSJ
                  source_url: https://www.wsj.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iK0NnNTFiRzFJU1ZKTmFEZFNaa05VVFJDZkF4ampCU2dLTWdZQklJNEZtUWs=-w200-h200-p-df-rw
                  title: 'Under the Skin of America’s Humanoid Robots: Chinese Technology'
                  url: https://www.wsj.com/tech/under-the-skin-of-americas-humanoid-robots-chinese-technology-27dd4fdf?gaa_at=eafs&gaa_n=AWEtsqfPBjMTIWT3oecfzdMXydh1QOacLP-gcXd9KzhO4mwnjsu2lw2Qkuxt&gaa_ts=69d1879f&gaa_sig=yln60-nkUMFEqZwb1S9Ik5bcbPojsBKX5uMtUWFVgy1AkDagy0J2UBhZViMO1-9yX0l8ZpF_JVjG5KUSz7wfhg%3D%3D
                - authors:
                  - Clement Farabet
                  domain: blog.google
                  photo_url: https://storage.googleapis.com/gweb-uniblog-publish-prod/images/gemma-4_blog_keyword_header-dark.width-200.format-webp.webp
                  published_datetime_utc: '2026-04-02T16:14:52.000Z'
                  snippet: 'Gemma 4: our most intelligent open models to date, purpose-built for advanced reasoning and agentic workflows.'
                  source_favicon_url: https://encrypted-tbn1.gstatic.com/faviconV2?url=https://blog.google&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: blog.google
                  source_url: https://blog.google
                  thumbnail_url: https://news.google.com/api/attachments/CC8iKkNnNXplSEEzWjA1YU9UWmZjakJJVFJCd0dNZ0JLQW95QnFHa2xJeTVCZw=-w200-h200-p-df-rw
                  title: 'Gemma 4: Byte for byte, the most capable open models'
                  url: https://blog.google/innovation-and-ai/technology/developers-tools/gemma-4/
                - authors: []
                  domain: finance.yahoo.com
                  photo_url: https://s.yimg.com/ny/api/res/1.2/rZ2GdD2_iJd7CyEJdzxt1w--/YXBwaWQ9aGlnaGxhbmRlcjt3PTEyMDA7aD04MDA-/https://d29szjachogqwa.cloudfront.net/images/2026-04/bbfb5430-f57f-4f4c-9edb-043f5e18c451
                  published_datetime_utc: '2026-04-03T12:27:01.000Z'
                  snippet: The rocket and space exploration company formally kicked off its IPO process this week in a confidential filing. It is currently valued at ...
                  source_favicon_url: https://encrypted-tbn1.gstatic.com/faviconV2?url=https://finance.yahoo.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: Yahoo Finance
                  source_url: https://finance.yahoo.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iK0NnNVdXbW94YmpONVlUZDFTWHBtVFJERUF4aW1CU2dLTWdZQlFvRHZKUWs=-w200-h200-p-df-rw
                  title: 'Tech stocks today: SpaceX reportedly targets $2 trillion valuation, Microsoft invests $10 billion in Japan'
                  url: https://finance.yahoo.com/sectors/technology/article/tech-stocks-today-spacex-reportedly-targets-2-trillion-valuation-microsoft-invests-10-billion-in-japan-144220012.html
                - authors:
                  - Jason Farman
                  domain: slate.com
                  photo_url: https://compote.slate.com/images/a2e58c29-6f41-4b0f-acbd-190c31186e9b.jpeg?crop=1560%2C1040%2Cx0%2Cy0
                  published_datetime_utc: '2026-04-04T14:00:00.000Z'
                  snippet: Sign up for the Slatest to get the most insightful analysis, criticism, and advice out there, delivered to your inbox daily.
                  source_favicon_url: https://encrypted-tbn3.gstatic.com/faviconV2?url=https://slate.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: Slate
                  source_url: https://slate.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iK0NnNXVhVGRDYkVGcFp6Wk5MUzB4VFJERUF4aW1CU2dLTWdhQmRJektNUVU=-w200-h200-p-df-rw
                  title: It’s a design principle that has transformed the world and even saved lives. It’s gone way too far.
                  url: https://slate.com/technology/2026/04/usability-complexity-apple-iphone-facebook-donald-norman.html
                - authors:
                  - Andrew Kula
                  domain: komu.com
                  photo_url: https://bloximages.newyork1.vip.townnews.com/komu.com/content/tncms/assets/v3/editorial/a/a7/aa7e4502-31c0-43a1-bf56-4cf48d31b431/69cfebcac8138.preview.jpg?crop=1080%2C1080%2C420%2C0&resize=1200%2C1200&order=crop%2Cresize
                  published_datetime_utc: '2026-04-03T19:30:00.000Z'
                  snippet: Three Rock Bridge High School students won the state AI championship for creating technology that could help police departments.
                  source_favicon_url: https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.komu.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL
                  source_name: komu.com
                  source_url: https://www.komu.com
                  thumbnail_url: https://news.google.com/api/attachments/CC8iL0NnNTFiVTFxYlRCNU1GTXdVMlpEVFJDcUJCaXFCQ2dLTWdrQlFaYlZHS3JJS2dJ=-w200-h200-p-df-rw
                  title: Three Columbia students win state AI championship for technology that could help CPD
                  url: https://www.komu.com/news/midmissourinews/three-columbia-students-win-state-ai-championship-for-technology-that-could-help-cpd/article_aa7e4502-31c0-43a1-bf56-4cf48d31b431.html
                count: 10
                limit: 10
        '400':
          description: 'Bad request: missing or invalid parameters'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: 'Unauthorized: invalid or missing API key'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Free tier used up for this endpoint and no payment method on file (`payment_required`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Account blocked after a failed payment (`account_blocked`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded or too many concurrent requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: Temporary failure retrieving news data. Please retry shortly.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Service temporarily unavailable. Please retry shortly.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '504':
          description: The request timed out
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - ApiKeyAuth: []
    servers:
    - url: https://apidirect.io
      description: Production
components:
  schemas:
    Error:
      type: object
      required:
      - error
      - code
      properties:
        error:
          type: string
          description: Human-readable error message.
        code:
          type: string
          description: Machine-readable error code, such as `missing_parameter`, `invalid_parameter`, `missing_api_key`, `invalid_api_key`, `payment_required`, `account_blocked`, `not_found`, `concurrency_limit_exceeded`, `daily_limit_exceeded`, `monthly_limit_exceeded`, `upstream_rate_limit`, `upstream_error`, `upstream_timeout`, `service_unavailable`, `endpoint_suspended`, `payload_too_large` or `rate_limited`. New codes may be added.
      example:
        error: 'Missing required parameter: query'
        code: missing_parameter
    SearchNewsResponse:
      type: object
      properties:
        articles:
          type:
          - array
          - 'null'
          items:
            type:
            - object
            - 'null'
            properties:
              authors:
                type:
                - array
                - 'null'
                items:
                  type:
                  - string
                  - 'null'
              domain:
                type:
                - string
                - 'null'
              photo_url:
                type:
                - string
                - 'null'
              published_datetime_utc:
                type:
                - string
                - 'null'
              snippet:
                type:
                - string
                - 'null'
              source_favicon_url:
                type:
                - string
                - 'null'
              source_name:
                type:
                - string
                - 'null'
              source_url:
                type:
                - string
                - 'null'
              thumbnail_url:
                type:
                - string
                - 'null'
              title:
                type:
                - string
                - 'null'
              url:
                type:
                - string
                - 'null'
        count:
          type:
          - number
          - 'null'
        limit:
          type:
          - number
          - 'null'
      description: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your API key (starts with `ak_live_`), from https://apidirect.io/dashboard/keys.
externalDocs:
  description: API Direct documentation
  url: https://apidirect.io/docs
x-refined-from:
- apidirect-io-openapi.json
- apidirect-io-x402-openapi.json