Dow Jones Developer Platform

Dow Jones Newswires Real-Time API

Search Dow Jones Newswires real-time content with DJN taxonomy expressions and retrieve the linked articles by Dow Jones Resource Name. The same endpoints serve the standard Real-Time licence and the Real-Time for GenAI licence, the latter with a controlled delay. Published as OpenAPI 3.0.1 with a POST search operation, a single-article retrieval operation, and a companion search-realtime content resource.

GitHub OpenAPI

Operations 1

POST /content/realtime/search

Documentation

📖
Documentation
https://developer.dowjones.com/documents/site-docs-newswires_apis-dow_jones_newswires_real_time_api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/openapi/dow-jones-developer-platform-newswires-real-time-api-openapi.yml
⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/openapi/dow-jones-developer-platform-newswires-content-api-openapi.yml
⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/openapi/dow-jones-developer-platform-company-news-radar-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/overlays/dow-jones-developer-platform-newswires-real-time-api-overlay.yaml
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/overlays/dow-jones-developer-platform-newswires-content-api-overlay.yaml
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/overlays/dow-jones-developer-platform-company-news-radar-api-overlay.yaml
🔗
AgentSkill
https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/skills/dow-jones-newswires-realtime-search.md

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/newswires-real-time-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.

GitHub Google LinkedIn

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

OpenAPI Specification

dow-jones-developer-platform-newswires-real-time-api-openapi.yml Raw ↑ 
openapi: 3.0.1
info:
  version: 2.0.0
  title: Dow Jones Newswires Real-time API
  description: You can use this API to perform a search of the real-time system, using a Rest Request that provides  the same functionality as the PerformContentSearch of the Search SOAP service.
tags:
- name: Content Search
  description: Performs a full search of the PIB search system.
servers:
- url: https://api.dowjones.com/
paths:
  /content/realtime/search:
    post:
      consumes: application/vnd.dowjones.dna.content.v_1.0+json
      tags:
      - Content Search
      responses:
        '200':
          description: Successful operation
          content:
            application/vnd.dowjones.dna.content.v_1.0+json:
              schema:
                $ref: '#/components/schemas/articlesResponse'
        '400':
          description: Bad Request - Incorrect Parameters
          content:
            application/vnd.dowjones.dna.content.v_1.0+json:
              schema:
                $ref: '#/components/schemas/error'
        '401':
          description: Unauthorized
          content:
            application/vnd.dowjones.dna.content.v_1.0+json:
              schema:
                $ref: '#/components/schemas/error'
        '404':
          description: Not Found - No resource found for the request
          content:
            application/vnd.dowjones.dna.content.v_1.0+json:
              schema:
                $ref: '#/components/schemas/error'
        5XX:
          description: Internal Server Error - Server encountered an unexpected condition
          content:
            application/vnd.dowjones.dna.content.v_1.0+json:
              schema:
                $ref: '#/components/schemas/error'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/performContentSearchRequest'
      security:
      - bearerAuth: []
components:
  schemas:
    performContentSearchRequest:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type: string
              default: Search
            type:
              type: string
              enum:
              - content
            attributes:
              type: object
              properties:
                query:
                  type: object
                  properties:
                    content_collection:
                      type: array
                      items:
                        type: string
                        enum:
                        - Publications
                        - Blogs
                        - Internal
                        - NewsSites
                        - Pictures
                        - WebSites
                        - Summary
                      description: Content types
                    search_string:
                      type: array
                      items:
                        type: object
                        properties:
                          mode:
                            description: Search string mode
                            type: string
                            enum:
                            - Unified
                          scope:
                            type: string
                            enum:
                            - Author
                            - Industry
                            - Language
                            - NewsSubject
                            - Organization
                            - People
                            - PublicationDate
                            - PublicationMonth
                            - PublicationWeek
                            - PublicationYear
                            - Region
                            - Source
                            description: Search string mode
                          value:
                            type: string
                            description: Search string value
                      description: Search string
                    boost_string:
                      type: array
                      items:
                        type: object
                        properties:
                          mode:
                            description: Search boost string mode
                            type: string
                            enum:
                            - Unified
                          scope:
                            type: string
                            enum:
                            - Author
                            - Industry
                            - Language
                            - NewsSubject
                            - Organization
                            - People
                            - PublicationDate
                            - PublicationMonth
                            - PublicationWeek
                            - PublicationYear
                            - Region
                            - Source
                            description: Search boost string mode
                          value:
                            type: string
                            description: Search boost string value
                          boost:
                            type: string
                            enum:
                            - Up
                            - Down
                      description: Search boosting
                    date:
                      type: object
                      description: The publication date of headlines. If this value is not supplied, the most current headlines are returned
                      oneOf:
                      - $ref: '#/components/schemas/performContentSearchDateDaysRange'
                      - $ref: '#/components/schemas/performContentSearchDateCustom'
                    original_doc_id_filter:
                      type: array
                      description: List of original document ids/accession numbers
                      items:
                        type: string
                        description: Accession number of an article
                similarity_filter:
                  type: object
                  properties:
                    is_sort_by:
                      type: boolean
                      default: false
                      description: Is sorting by
                    document_vector:
                      type: string
                      description: Document vector
                    type:
                      type: string
                      enum:
                      - Find
                      - Refine
                      - Exclude
                    article_id:
                      type: string
                      description: Article Id
                    is_exclude_original:
                      type: boolean
                      default: false
                      description: Is exclude original
                  description: Similarity filter
                linguistics:
                  type: object
                  properties:
                    query_language:
                      type: string
                    is_lemmatization_on:
                      type: boolean
                      default: false
                      description: Is lemmatization on
                formatting:
                  type: object
                  properties:
                    snippet_type:
                      description: Headline snippet type
                      type: string
                      enum:
                      - Contextual
                      - Fixed
                      - None
                    markup_type:
                      description: Headline markup type
                      type: string
                      enum:
                      - None
                      - Highlight
                      - All
                    sort_order:
                      description: The order in which the results must be sorted
                      type: string
                      enum:
                      - PublicationDateChronological
                      - -PublicationDateChronological
                      - Relevance
                      - RelevanceMediumFreshness
                      - RelevanceHighFreshness
                      - ArrivalTime
                      - FreshnessDateChronological
                      - -FreshnessDateChronological
                      - BestDateChronological
                      - -BestDateChronological
                      - FIFO
                      - LIFO
                      example: -PublicationDateChronological
                    is_return_rich_article_id:
                      type: boolean
                      default: false
                      description: Request the return of the rich article id (alternate id) both in the id and alternate_id fields.
                navigation:
                  type: object
                  properties:
                    is_return_collection_count:
                      type: boolean
                      default: false
                      description: Return collection counts
                    content_collection_count:
                      type: array
                      items:
                        type: string
                        enum:
                        - Publications
                        - Blogs
                        - Internal
                        - NewsSites
                        - Pictures
                        - WebSites
                        - Summary
                      description: Content collection to get count
                    is_return_headline_coding:
                      type: boolean
                      default: false
                      description: Return headline coding
                    is_return_djn_headline_coding:
                      type: boolean
                      default: false
                      description: Is Return DJN headline coding
                    keyword_navigators:
                      type: object
                      properties:
                        is_return_keywords:
                          type: boolean
                          default: false
                          description: Return keywords
                        max_keywords:
                          type: integer
                          description: Max keywords
                    code_navigators:
                      type: object
                      properties:
                        mode:
                          description: Code navigator mode
                          type: string
                          enum:
                          - None
                          - Folder
                          - All
                        sub_type:
                          type: string
                          description: subtype of the navigator we need to filter. Valid only for region navigator, with values city, state, country, snr
                          enum:
                          - City
                          - State
                          - Country
                          - SNR
                        min_buckets:
                          type: integer
                          description: Minimum number of code navigators
                        max_buckets:
                          type: integer
                          description: Maximum number of code navigators
                        custom_navigator:
                          type: array
                          items:
                            type: object
                            properties:
                              navigator_type:
                                type: array
                                items:
                                  type: string
                                  enum:
                                  - Author
                                  - ClippingTime
                                  - Company
                                  - CompanyAbout
                                  - CompanyAboutAssociateLineage
                                  - CompanyOccurrence
                                  - Industry
                                  - IndustryAbout
                                  - IndustryLowLevel
                                  - IndustryTopLevel
                                  - Language
                                  - OrganizationType
                                  - Person
                                  - Region
                                  - RegionAbout
                                  - RegionCity
                                  - RegionCountry
                                  - RegionLowLevel
                                  - RegionOccurrence
                                  - RegionState
                                  - RegionTopLevel
                                  - Subject
                                  - SubjectAbout
                                  - SubjectLowLevel
                                  - SubjectTopLevel
                                  - Source
                                  - SourceFamily
                                description: Custom code navigator type to retrieve
                              sub_type:
                                type: string
                                description: subtype of the navigator we need to filter. Valid only for region navigator, with values city, state, country, snr
                                enum:
                                - City
                                - State
                                - Country
                                - SNR
                              min_buckets:
                                type: integer
                                description: Minimum number of custom code navigators
                              max_buckets:
                                type: integer
                                description: Maximum number of custom code navigators
                    time_navigators:
                      type: array
                      items:
                        type: object
                        properties:
                          mode:
                            description: Time navigator mode
                            type: string
                            enum:
                            - None
                            - PublicationDate
                            - PublicationYear
                            - PublicationMonth
                            - PublicationWeek
                            - AutoDetect
                            - All
                          min_buckets:
                            type: integer
                            description: Minimum number of time navigators
                          max_buckets:
                            type: integer
                            description: Maximum number of time navigators
                descriptor:
                  type: object
                  properties:
                    mode:
                      description: Descriptor mode
                      type: string
                      enum:
                      - None
                      - Company
                      - All
                    language:
                      type: string
                      description: Descriptor language
                page_offset:
                  type: integer
                  description: The starting index of the set of records to return
                  example: 0
                page_limit:
                  type: integer
                  description: The number of records to return
                  example: 5
              required:
              - query
          required:
          - attributes
      required:
      - data
    performContentSearchDateCustom:
      type: object
      properties:
        custom:
          type: object
          properties:
            from:
              type: string
              format: date
              description: Custom from date
              example: '2021-04-15'
            to:
              type: string
              format: date
              description: Custom to date
              example: '2021-04-15'
          required:
          - from
          - to
      additionalProperties: false
    performContentSearchDateDaysRange:
      type: object
      properties:
        days_range:
          description: Date range
          type: string
          enum:
          - LastDay
          - LastWeek
          - LastMonth
          - Last3Months
          - Last6Months
          - LastYear
          - Last2Years
          - Last5Years
          - AllDates
      additionalProperties: false
    articleResponse:
      type: object
      description: Single article response
      properties:
        links:
          $ref: '#/components/schemas/topLevelLinks'
        meta:
          $ref: '#/components/schemas/topLevelMeta'
        data:
          $ref: '#/components/schemas/contentData'
        included:
          $ref: '#/components/schemas/includedResources'
    articlesResponse:
      type: object
      description: Multiple articles response
      properties:
        links:
          $ref: '#/components/schemas/topLevelLinks'
        meta:
          $ref: '#/components/schemas/topLevelMeta'
        data:
          type: array
          items:
            $ref: '#/components/schemas/contentData'
        included:
          $ref: '#/components/schemas/includedResources'
    contentAttributes:
      type: object
      properties:
        art:
          $ref: '#/components/schemas/contentItem'
        associations:
          $ref: '#/components/schemas/associations'
        authors:
          type: array
          items:
            $ref: '#/components/schemas/author'
        best_date:
          type: string
          format: date
        best_time:
          type: string
          format: date-time
        body:
          type: array
          items:
            anyOf:
            - $ref: '#/components/schemas/paragraphItem'
            - $ref: '#/components/schemas/tableItem'
            - $ref: '#/components/schemas/headingItem'
            - $ref: '#/components/schemas/imageItem'
            - $ref: '#/components/schemas/datelineItem'
            - $ref: '#/components/schemas/taglineItem'
            - $ref: '#/components/schemas/insetItem'
            - $ref: '#/components/schemas/listItem'
            - $ref: '#/components/schemas/blockquoteItem'
            - $ref: '#/components/schemas/binaryItem'
        byline:
          $ref: '#/components/schemas/contentItem'
        column_name:
          type: string
        contact:
          $ref: '#/components/schemas/contentItem'
        content_collection:
          type: string
        content_status:
          type: string
        content_type:
          $ref: '#/components/schemas/contentType'
        copyright:
          $ref: '#/components/schemas/contentItem'
        corrections:
          type: array
          items:
            $ref: '#/components/schemas/paragraphItem'
        credit:
          $ref: '#/components/schemas/contentItem'
        content_resources:
          type: array
          description: Complex objects that are referenced inline in the content are referred to here
          items:
            description: ' removed untill fixed #/AssociatedResources'
        dist_publish_date:
          type: string
          format: date
        dist_publish_time:
          type: string
          format: date-time
        headline:
          $ref: '#/components/schemas/headline'
        live_date:
          type: string
          format: date
        live_time:
          type: string
          format: date-time
        load_date:
          type: string
          format: date
        load_time:
          type: string
          format: date-time
        modification_date:
          type: string
          format: date
        modification_time:
          type: string
          format: date-time
        notes:
          $ref: '#/components/schemas/contentItem'
        page:
          type: string
        publication_date:
          type: string
          format: date
        publication_time:
          type: string
          format: date-time
        publisher:
          type: object
          properties:
            code:
              type: string
            name:
              type: string
            group_code:
              type: string
            group_name:
              type: string
        section_name:
          $ref: '#/components/schemas/contentItem'
        seo_id:
          type: string
        snippet:
          $ref: '#/components/schemas/contentItem'
        summary:
          type: object
          properties:
            body:
              type: array
              items:
                anyOf:
                - $ref: '#/components/schemas/paragraphItem'
                - $ref: '#/components/schemas/headingItem'
                - $ref: '#/components/schemas/imageItem'
                - $ref: '#/components/schemas/datelineItem'
                - $ref: '#/components/schemas/taglineItem'
                - $ref: '#/components/schemas/insetItem'
                - $ref: '#/components/schemas/listItem'
                - $ref: '#/components/schemas/blockquoteItem'
            byline:
              $ref: '#/components/schemas/contentItem'
            destination_type:
              type: string
            headline:
              $ref: '#/components/schemas/headline'
            pages:
              type: array
              items:
                type: string
            related_links:
              type: array
              items:
                $ref: '#/components/schemas/linkItem'
            variant:
              type: string
        upstream_origin:
          type: string
        upstream_origin_id:
          type: string
        volume:
          type: string
    contentData:
      type: object
      properties:
        type:
          type: string
          enum:
          - content
        id:
          type: string
        links:
          $ref: '#/components/schemas/resourceLinks'
        meta:
          $ref: '#/components/schemas/resourceMeta'
        attributes:
          anyOf:
          - $ref: '#/components/schemas/contentAttributes'
          - $ref: '#/components/schemas/errors'
        relationships:
          $ref: '#/components/schemas/relatedResources'
    associations:
      type: object
      properties:
        root_id:
          type: string
        parent_id:
          type: string
        parent_id_ref:
          type: string
    author:
      type: object
      properties:
        full_name:
          type: string
        topic_id:
          type: string
    binaryItem:
      type: object
      properties:
        type:
          type: string
          enum:
          - Binary
        ref:
          type: string
        content_encoding:
          type: string
        media_type:
          type: string
          enum:
          - PDF
          - HTML
        value:
          type: string
    blockquoteItem:
      allOf:
      - $ref: '#/components/schemas/contentItem'
      - properties:
          type:
            type: string
            enum:
            - Blockquote
    breakItem:
      type: object
      allOf:
      - $ref: '#/components/schemas/contentItem'
      - properties:
          type:
            type: string
            enum:
            - Break
    codeSet:
      type: object
      properties:
        type:
          type: string
          enum:
          - Author
          - Organization
          - Industry
          - NewsSubject
          - People
          - Region
          - InformationProviderCodes
          - InformationProviderDescriptors
          - MarketSector
          - Products
          - Government
        id:
          type: string
          enum:
          - au
          - co
          - in
          - ns
          - pe
          - re
          - ipc
          - ipd
          - ms
          - pr
          - gv
        codes:
          type: array
          items:
            type: object
            properties:
              chartingsymbol:
                type: string
              code:
                type: string
              code_scheme:
                type: string
                enum:
                - DJID
                - Ticker
                - DUNS
                - ISIN
                - DJN
              descriptor:
                type: string
              symbol:
                type: string
              significance:
                type: string
                enum:
                - About
                - Significant
                - Mention
                - Lineage
                - Relevance
                - Association
    contentItem:
      anyOf:
      - $ref: '#/components/schemas/textItem'
      - type: object
        properties:
          content:
            $ref: '#/components/schemas/contentItems'
    contentItems:
      type: array
      items:
        anyOf:
        - $ref: '#/components/schemas/textItem'
        - $ref: '#/components/schemas/linkItem'
        - $ref: '#/components/schemas/entityItem'
        - $ref: '#/components/schemas/emphasisItem'
        - $ref: '#/components/schemas/tableItem'
        - $ref: '#/components/schemas/breakItem'
        - $ref: '#/components/schemas/imageItem'
    contentType:
      type: string
      enum:
      - Article
      - Audio
      - Board
      - Blog
      - HTML
      - PDF
      - Picture
      - Video
      - Webpage
    datelineItem:
      type: object
      allOf:
      - $ref: '#/components/schemas/contentItem'
      - properties:
          type:
            type: string
            enum:
            - Dateline
          format:
            type: string
    entityItem:
      type: object
      allOf:
      - $ref: '#/components/schemas/contentItem'
      - properties:
          type:
            type: string
            enum:
            - Entity
          background_info:
            type: string
          code:
            type: string
          code_scheme:
            type: string
            enum:
            - DJID
            - WSJCode
            - DJN
          entity_type:
            type: string
            enum:
            - Organization
            - People
          ref:
            type: string
          significance:
            type: string
          ticker:
            type: string
    emphasisItem:
      type: object
      allOf:
      - $ref: '#/components/schemas/contentItem'
      - properties:
          type:
            type: string
            enum:
            - Emphasis
          emphasis_type:
            type: string
            enum:
            - Bold
            - Highlight
            - Italic
            - Strikethrough
            - Superscript
            - Subscript
            - Underline
    error:
      required:
      - code
      - status
      - title
      type: object
      properties:
        code:
          type: string
          description: Error code
        title:
          type: string
          description: error class summary message
        status:
          type: string
          description: HTTP status code
        detail:
          type: string
          description: error detail about this instance of error
        meta:
          $ref: '#/components/schemas/errorMeta'
    errorMeta:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
    errors:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/error'
    headline:
      type: object
      properties:
        flashline:
          $ref: '#/components/schemas/contentItem'
        main:
          $ref: '#/components/schemas/contentItem'
        deck:
          $ref: '#/components/schemas/contentItem'
    headlinesResponse:
      type: object
      description: Search headlines response
      properties:
        meta:
          $ref: '#/components/schemas/headlinesTopLevelMeta'
        links:
          $ref: '#/components/schemas/headlinesTopLevelLinks'
        data:
          type: array
          items:
            $ref: '#/components/schemas/contentData'
        included:
          type: array
          items:
            anyOf:
            - $ref: '#/components/schemas/includedResource'
            - $ref: '#/components/schemas/contentData'
    headlinesTopLevelLinks:
      type: object
      properties:
        first:
          type: string
        last:
          type: string
        next:
          type: string
        prev:
          type: string
        self:
          type: string
    headlinesTopLevelMeta:
      type: object
      properties:
        collection_info:
          type: object
          description: ''
          properties:
            id:
              type: string
            name:
              type: string
        count:
          type: integer
          description: Records returned
        discovery:
          type: object
          properties:
            content_collection:
              type: array
              description: Content collection discovery
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: Content collection type
                    enum:
                    - Publications
                    - Blogs
                    - Internal
                    - NewsSites
                    - Pictures
                    - WebSites
                    - Summary
                  hit_count:
                    type: number
                    description: Hit count
                  ref:
                    type: string
                    description: Link URL
            codes:
              type: array
              description: Source discovery
              items:
                type: object
                properties:
                  type:
                    type: string
                    description: Code type
                    enum:
                    - Author
                    - ClippingTime
                    - Company
                    - CompanyAbout
                    - CompanyAboutAssociateLineage
                    - CompanyOccurrence
                    - ContentCollectionType
                    - Industry
                    - IndustryAbout
                    - IndustryLowLevel
                    - IndustryTopLevel
                    - Language
                    - OrganizationType
                    - Person
                    - Region
                    - RegionAbout
                    - RegionCity
                    - RegionCountry
                    - RegionLowLevel
                    - RegionOccurrence
                    - RegionState
                    - RegionTopLevel
                    - Subject
                    - SubjectAbout
                    - SubjectLowLevel
                    - SubjectTopLevel
                    - Source
                    - SourceFamily
                  code:
                    type: string
                    description: Code
                  code_data:
                    type: array
                    description: Keyword discovery
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Code
                        description:
                          type: string
                          description: Code description
                        hit_count:
                          type: number
                          description: Hit count
                        ref:
                          type: string
                          description: Link URL
                        type:
                          type: string
                          description: type of code
            keywords:
              type: array
              description: Keyword discovery
              items:
                type: object
                properties:
                  name:
                    type: string
                    description: Code
                  weight:
                    type: nu

# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dow-jones-developer-platform/refs/heads/main/openapi/dow-jones-developer-platform-newswires-real-time-api-openapi.yml