Factiva Content API

The Factiva content workflow surface: full-text and metadata search across the Factiva archive, reference resolution and binary retrieval, alerts, newsletter editions and NewsPlus collections, plus specialised people, organization, consumer, portfolio and emerging-market search resources. Published as Swagger 2.0 with 16 operations against host api.dowjones.com and base path /content.

Operations 16

GET /alerts/{id}
GET /refs/{ref}
GET /refs
GET /refs/{ref}/redirect
GET /refs/{ref}/binary
GET /newsletter/editions/{id} #
GET /newsplus/collections/{code} #
GET /search #
POST /search #
GET /search/refs #
GET /search/realtime #
GET /search/people/{code} #
GET /search/organization/{code} #
GET /search/consumer #
POST /search/portfolio Search for content based on portfolio companies
POST /search/emerging Search for the most relevant emerging topics in the last hours #

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/factiva-content-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

dow-jones-developer-platform-factiva-content-api-openapi.yml Raw ↑
swagger: '2.0'
info:
  title: Content API
  version: 1.0.0
paths:
  /alerts/{id}:
    get:
      security:
      - Bearer: []
      tags:
      - Content
      consumes: []
      produces:
      - application/json
      - text/json
      parameters:
      - name: id
        in: path
        description: Alert Id
        required: true
        type: string
      - name: snippet_type
        in: query
        description: Snippet Type
        required: false
        type: string
        enum:
        - Fixed
        - Contextual
      - name: is_preview
        in: query
        description: Is_Preview
        required: false
        type: string
        enum:
        - true
        - false
      - name: sort
        in: query
        description: Sort
        required: false
        type: string
      - name: filter.view_type
        in: query
        description: View Type
        required: false
        type: string
        enum:
        - New
        - All
      - name: filter.content_categories
        in: query
        required: false
        type: array
        items:
          type: string
        enum:
        - Publications
        - WebSites
        - Boards
        - Blogs
        collectionFormat: multi
      - name: page[context]
        in: query
        description: Context
        required: false
        type: string
      - name: page[offset]
        in: query
        description: Offset
        required: false
        type: integer
      - name: page[limit]
        in: query
        description: Limit
        required: false
        type: integer
      - name: deduplication_level
        in: query
        description: Gets or sets the deduplication level
        required: false
        type: string
        enum:
        - 'Off'
        - Similar
        - VirtuallyIdentical
      responses:
        '200':
          description: OK
          schema:
            type: object
            properties:
              links:
                type: object
                properties:
                  self:
                    type: string
                    description: Link to self
                  prev:
                    type: string
                    description: Link to previous set of records
                  next:
                    type: string
                    description: Link to next set of records
                  first:
                    type: string
                    description: Link to first set of records
                  last:
                    type: string
                    description: Link to last set of records
              meta:
                type: object
                properties:
                  keywords:
                    type: array
                    description: Free form, unstructured tags / keywords
                    items:
                      type: string
                  count:
                    type: integer
                    description: Records returned
                  total_count:
                    type: integer
                    description: Records returned
                  offset:
                    type: object
                    properties:
                      first:
                        type: integer
                      last:
                        type: integer
                      prev:
                        type: integer
                      next:
                        type: integer
                  discovery:
                    description: Discovery data
                    type: object
                    properties:
                      codes:
                        type: array
                        description: Source discovery
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              description: Code type
                              enum:
                              - company
                              - industry
                              - region
                              - subject
                              - person
                              - source
                            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
                      time:
                        type: object
                        description: Time discovery
                        properties:
                          type:
                            type: string
                          time_data:
                            type: array
                            description: Time data
                            items:
                              type: object
                              properties:
                                time_value:
                                  type: string
                                  description: Time value
                                hit_count:
                                  type: number
                                  description: Hit count
                                ref:
                                  type: string
                                  description: Link URL
                      keywords:
                        type: array
                        description: Keyword discovery
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                              description: Code
                            weight:
                              type: number
                              description: Weight
                            ref:
                              type: string
                              description: Link URL
                      category:
                        type: array
                        description: Category discovery
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              description: Category type
                              enum:
                              - publications
                              - news_sites
                              - audio
                              - multimedia
                              - pictures
                              - video
                              - websites
                              - summaries
                            hit_count:
                              type: number
                              description: Hit count
                            ref:
                              type: string
                              description: Link URL
                  duplicate_headlines:
                    type: array
                    items:
                      type: object
                      properties:
                        headline_count:
                          type: integer
                          description: Headline count
                        headline_refs:
                          type: array
                          description: Headline references
                          items:
                            type: object
                            properties:
                              index:
                                type: integer
                                description: Index
                              ref:
                                type: string
                                description: Reference
                              duplicates:
                                type: array
                                description: Duplicates
                                items:
                                  type: object
                                  properties:
                                    duplicate_count:
                                      type: integer
                                      description: Duplicate count
                                    duplicate_ref:
                                      type: array
                                      description: Duplicate headline
                                      items:
                                        type: object
                                        properties:
                                          index:
                                            type: integer
                                            description: Index
                                          ref:
                                            type: string
                                            description: Reference
                    description: Duplicate headlines
                  search_info:
                    type: object
                    description: ''
                    properties:
                      canonical_query:
                        type: string
                      highlight_text:
                        type: string
                      search_context:
                        type: string
                  collection_info:
                    type: object
                    description: ''
                    properties:
                      id:
                        type: string
                      name:
                        type: string
              data:
                type: array
                items:
                  type: object
                  properties:
                    type:
                      type: string
                      description: Denotes type of resource
                    id:
                      type: string
                      description: Unique ID for article in CAPI
                    attributes:
                      type: object
                      properties:
                        authors:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: Author ID
                              first_name:
                                type: string
                                description: Authors first name
                              last_name:
                                type: string
                                description: Authors last name
                              full_name:
                                type: string
                                description: Authors full display name
                              avatar:
                                type: object
                                properties:
                                  type:
                                    type: string
                                    enum:
                                    - Photo
                                    - VideoStill
                                    - Logo
                                    description: Denotes type of image
                                  caption:
                                    type: array
                                    items:
                                      type: object
                                      enum:
                                      - Paragraph
                                      - TextItem
                                      - LinkItem
                                      - EntityItem
                                    description: Image caption items
                                  credit:
                                    type: string
                                  size:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        type:
                                          type: string
                                          enum:
                                          - FingerNail
                                          - ThumbNail
                                          - DisplayPicture
                                          - BigPicture
                                          - PrintPicture
                                          - A
                                          - AM
                                          - BR
                                          - C
                                          - D
                                          - E
                                          - ER
                                          - F
                                          - FR
                                          - G
                                          - GR
                                          - J
                                          - M
                                          - P
                                          - TOP
                                          - Z120
                                          description: Image type
                                        id_ref:
                                          type: string
                                        is_responsive:
                                          type: boolean
                                        slug:
                                          type: string
                                          description: ' ??????'
                                        height:
                                          type: integer
                                        width:
                                          type: integer
                                        bytes:
                                          type: integer
                                        reference:
                                          type: string
                                          description: Archive image reference
                                        image_type:
                                          type: string
                                          description: 'impage type `tnail`, `dispix`, `fnail` '
                                        mime_type:
                                          type: string
                                          description: MIME type
                                        sub_type:
                                          type: string
                                        uri:
                                          type: string
                                          description: Image URL
                          description: List of authors
                        bitly_url:
                          type: string
                          description: ??????? (WSJ)
                        byline:
                          type: object
                          properties:
                            content:
                              type: array
                              items:
                              - type: object
                                properties:
                                  type:
                                    type: string
                                    default: TextItem
                                  essential:
                                    type: boolean
                                    description: Denotes if item must be included
                                  content:
                                    type: object
                                    properties:
                                      type:
                                        type: string
                                        enum:
                                        - Plain
                                        - Bold
                                        - Italic
                                        - Highlighted
                                        - Preformatted
                                        description: Denotes type of text
                                      text:
                                        type: string
                                        description: Text string
                          description: A byline typically contains at least an authors name and can contain additional identifying information and a publication date.
                        categories:
                          type: array
                          items:
                            type: string
                          description: ''
                        content_status:
                          type: string
                          description: ??????? (WSJ)
                        copyright:
                          type: object
                          properties:
                            content:
                              type: array
                              items:
                              - type: object
                                properties:
                                  type:
                                    type: string
                                    default: TextItem
                                  essential:
                                    type: boolean
                                    description: Denotes if item must be included
                                  content:
                                    type: object
                                    properties:
                                      type:
                                        type: string
                                        enum:
                                        - Plain
                                        - Bold
                                        - Italic
                                        - Highlighted
                                        - Preformatted
                                        description: Denotes type of text
                                      text:
                                        type: string
                                        description: Text string
                        display_name:
                          type: string
                          description: ??????? (WSJ)
                        headline:
                          type: object
                          properties:
                            flashline:
                              type: array
                              items:
                                type: object
                                properties:
                                  variant:
                                    type: string
                                    enum:
                                    - Full
                                    - Truncated
                                    description: Flashline variation
                                  content:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        type:
                                          type: string
                                          default: Paragraph
                                        essential:
                                          type: boolean
                                          description: Denotes if item must be included
                                        display:
                                          type: string
                                          enum:
                                          - Preformatted
                                          - Plain
                                          description: ' Display type'
                                        field_id:
                                          type: string
                                          description: Field id
                                        content:
                                          type: array
                                          items:
                                          - type: object
                                            properties:
                                              type:
                                                type: string
                                                default: TextItem
                                              essential:
                                                type: boolean
                                                description: Denotes if item must be included
                                              content:
                                                type: object
                                                properties:
                                                  type:
                                                    type: string
                                                    enum:
                                                    - Plain
                                                    - Bold
                                                    - Italic
                                                    - Highlighted
                                                    - Preformatted
                                                    description: Denotes type of text
                                                  text:
                                                    type: string
                                                    description: Text string
                                          - type: object
                                            properties:
                                              type:
                                                type: string
                                                default: ImageItem
                                              essential:
                                                type: boolean
                                                description: Denotes if item must be included
                                              content:
                                                type: object
                                                properties:
                                                  type:
                                                    type: string
                                                    enum:
                                                    - Photo
                                                    - VideoStill
                                                    - Logo
                                                    description: Denotes type of image
                                                  caption:
                                                    type: array
                                                    items:
                                                      type: object
                                                      enum:
                                                      - Paragraph
                                                      - TextItem
                                                      - LinkItem
                                                      - EntityItem
                                                    description: Image caption items
                                                  credit:
                                                    type: string
                                                  size:
                                                    type: array
                                                    items:
                                                      type: object
                                                      properties:
                                                        type:
                                                          type: string
                                                          enum:
                                                          - FingerNail
                                                          - ThumbNail
                                                          - DisplayPicture
                                                          - BigPicture
                                                          - PrintPicture
                                                          - A
                                                          - AM
                                                          - BR
                                                          - C
                                                          - D
                                                          - E
                                                          - ER
                                                          - F
                                                          - FR
                                                          - G
                                                          - GR
                                                          - J
                                                          - M
                                                          - P
                                                          - TOP
                                                          - Z120
                                                          description: Image type
                                                        id_ref:
                                                          type: string
                                                        is_responsive:
                                                          type: boolean
                                                        slug:
                                                          type: string
                                                          description: ' ??????'
                                                        height:
                                                          type: integer
                                                        width:
                                                          type: integer
                                                        bytes:
                                                          type: integer
                                                        reference:
                                                          type: string
                                                          description: Archive image reference
                                                        image_type:
                                                          type: string
                                                          description: 'impage type `tnail`, `dispix`, `fnail` '
                                                        mime_type:
                                                          type: string
                                                          description: MIME type
                                                        sub_type:
                                                          type: string
                                                        uri:
                                                          type: string
                                                          description: Image URL
                                          - type: object
                                            properties:
                                              type:
                                                type: string
                                                default: LinkItem
                                              essential:
                                                type: boolean
                                                description: Denotes if item must be included
                                              content:
                                                type: object
                                                properties:
                                                  type:
                                                    type: string
                                                    enum:
                                                    - File
                                                    - Article
                                                    - Blog
                                                    - Image
                                                    - Email
                                                    description: Denotes link type
                                                  uri:
                                                    type: string
                                                    description: Link URL
                                                  external:
                                                    type: boolean
                                                    description: Denotes whether link points to external source
                                                  content:
                                                    type: array
                                                    items:
                                                    - type: object
                                                      properties:
                                                        type:
                                                          type: string
                                                          default: TextItem
                                                        essential:
                                                          type: boolean
                                                          description: Denotes if item must be included
                                                        content:
                                                          type: object
                                                          properties:
                                                            type:
                                                              type: string
                                                              enum:
                                                              - Plain
                                                              - Bold
                                                              - Italic
                                                              - Highlighted
                                                              - Preformatted
                                                              description: Denotes type of text
                                                            text:
                                                              type: string
                                                              description: Text string
                                          - type: object
                                            properties:
                                              type:
                                                type: string
                                                default: EntityItem
                                              essential:
                                                type: boolean
                                                description: Denotes if item must be included
                                              content:
                                                type: object
                                                properties:
                                                  type:
                                                    type: string
                         

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